Skip to content

Fogbinder is a Zotero plugin designed for those who seek nuance in their research. It illuminates contradiction, emotional tone, and unresolved ambiguity within citations—making murk not something to fear, but something to follow.

License

Notifications You must be signed in to change notification settings

hyperpolymath/fogbinder

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

22 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Fogbinder

RSR Rhodium

Fogbinder is a Zotero plugin designed for those who seek nuance in their research. It illuminates contradiction, emotional tone, and unresolved ambiguity within citations—making murk not something to fear, but something to follow.


Features

Contradiction Detection

Identify when ideas across sources clash, inviting richer analysis and thematic depth.

Mood Scoring

Annotate and filter sources based on emotional tone—melancholy, ecstatic, anxious, etc.

Mystery Clustering

Surface and tag speculative or ambiguous references that spark curiosity.

FogTrail Visualization

A network map of epistemic opacity showing how your research clouds, contradicts, and clears.


Accessibility

Fogbinder follows inclusive design principles:

  • Semantic HTML with proper aria-label and role attributes

  • Keyboard navigation and focus indicators

  • High-contrast UI elements

  • Localization support for multilingual use

Ambiguity should never mean inaccessibility.

Security

Your privacy matters. Fogbinder:

  • Sanitizes input to prevent injection

  • Never stores API keys or external data

  • Includes strict .gitignore and no tracking scripts

  • Follows open-source transparency principles

  • Uses post-quantum cryptography (Ed448, Kyber-1024, SHAKE256)

  • Git operations via SSH only

  • TLS 1.3 with strong ciphers

For detailed security information, see SECURITY.md.


Architecture

Fogbinder uses a ReScript + WASM architecture:

  • ReScript - 100% type-safe functional programming language

  • WASM modules - Performance-critical operations in Rust

  • Deno runtime - JavaScript/WASM execution (no Node.js)

  • NO TypeScript - Eliminated completely

  • NO npm - No Node.js dependencies


Installation

Prerequisites

Build from source

# Clone repository
git clone [email protected]:your-username/fogbinder.git
cd fogbinder

# Build ReScript
just build-rescript

# Build WASM modules
just build-wasm

# Build Zotero plugin
just build-plugin

# Install to Zotero
just install-zotero

Development

# Run tests
just test

# Run benchmarks
just bench

# Watch mode
just dev

# Quality checks
just quality

# Security audit
just security-audit

See DEVELOPMENT.adoc for detailed development instructions.


Usage

Basic workflow

  1. Install Fogbinder in Zotero

  2. Select sources in your library

  3. Run analysis via Fogbinder menu

  4. Explore results:

    • Contradictions highlighted

    • Mood scores displayed

    • Mystery clusters shown

    • FogTrail visualization

Advanced features

  • Custom mood categories - Define your own emotional taxonomy

  • Contradiction severity - Adjust detection sensitivity

  • Export FogTrail - SVG, JSON, or interactive HTML

  • Batch processing - Analyze entire collections


Philosophy

Fogbinder embraces epistemic humility and ordinary language philosophy:

  • Ambiguity is a feature - Not a bug to be fixed

  • Contradictions invite analysis - Not errors to be eliminated

  • Emotional tone matters - Research is human

  • Accessibility is fundamental - Software for all

  • Privacy is a right - No surveillance, no tracking

See PHILOSOPHY.adoc for philosophical foundations.


License

Fogbinder is dual-licensed - you choose:

Option 1: MIT License

Permissive license for maximum freedom.

Option 2: GNU AGPL-3.0

Network copyleft ensuring software freedom.

Palimpsest License (Philosophical Overlay)

Both licenses include the Palimpsest License as a philosophical commitment to:

  • Epistemic humility

  • Ordinary language principles

  • Code as palimpsest (layers of meaning)

  • Embracing contradiction

  • Open inquiry

  • Accessibility for all

  • Privacy and autonomy

  • Community over profit

See LICENSE_DUAL.adoc for full terms and decision guidance.


Contributing

We welcome contributions! Please read:


Documentation

Core Documentation

Technical Documentation

Security Documentation

Community

Support

Maintainers

See MAINTAINERS.adoc for current maintainers.


Acknowledgments

Fogbinder is inspired by:

  • Wittgenstein’s ordinary language philosophy

  • Research practices that value ambiguity

  • Open-source communities prioritizing accessibility and privacy

  • Post-quantum cryptography research (NIST PQC)

  • Functional programming communities (OCaml, ReScript, Rust)


Repository Standards

Fogbinder achieves RSR Rhodium (highest tier) compliance:

  • Type Safety: 100% ReScript, no TypeScript

  • Memory Safety: No manual memory management

  • Build System: No Node.js, no npm

  • Documentation: AsciiDoc format

  • Security: Post-quantum cryptography, Git SSH-only, TLS 1.3

  • Testing: Property-based testing, benchmarks, formal verification

  • Accessibility: WCAG 2.1 Level AA

  • Licensing: Dual MIT/AGPL with Palimpsest overlay

  • WASM-First: Maximum WASM, minimal JavaScript

  • Browser Future-Proofing: 25+ browser APIs supported

See RSR_RHODIUM_STANDARD_V2.adoc for full specification.


Last Updated: 2025-11-29
Version: 0.1.0
License: MIT OR AGPL-3.0 (with Palimpsest)
RSR Tier: Rhodium

About

Fogbinder is a Zotero plugin designed for those who seek nuance in their research. It illuminates contradiction, emotional tone, and unresolved ambiguity within citations—making murk not something to fear, but something to follow.

Resources

License

Contributing

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 4

  •  
  •  
  •  
  •