Identify when ideas across sources clash, inviting richer analysis and thematic depth.
Annotate and filter sources based on emotional tone—melancholy, ecstatic, anxious, etc.
Fogbinder follows inclusive design principles:
-
Semantic HTML with proper
aria-labeland role attributes -
Keyboard navigation and focus indicators
-
High-contrast UI elements
-
Localization support for multilingual use
Ambiguity should never mean inaccessibility.
Your privacy matters. Fogbinder:
-
Sanitizes input to prevent injection
-
Never stores API keys or external data
-
Includes strict
.gitignoreand 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.
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
See ARCHITECTURE_RESCRIPT_WASM.adoc for details.
# 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# Run tests
just test
# Run benchmarks
just bench
# Watch mode
just dev
# Quality checks
just quality
# Security audit
just security-auditSee DEVELOPMENT.adoc for detailed development instructions.
-
Install Fogbinder in Zotero
-
Select sources in your library
-
Run analysis via Fogbinder menu
-
Explore results:
-
Contradictions highlighted
-
Mood scores displayed
-
Mystery clusters shown
-
FogTrail visualization
-
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.
Fogbinder is dual-licensed - you choose:
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.
We welcome contributions! Please read:
-
CONTRIBUTING.adoc - Contribution guidelines
-
CODE_OF_CONDUCT.adoc - Community standards
-
DEVELOPMENT.adoc - Development workflow
-
ARCHITECTURE_RESCRIPT_WASM.adoc - Technical architecture
-
README.adoc (this file)
-
SECURITY.md - Security policy
-
CLAUDE.adoc - AI assistant guide
-
PHILOSOPHY.adoc - Philosophical foundations
-
TPCF.adoc - The Philosophy of Computational Fog
-
ARCHITECTURE_RESCRIPT_WASM.adoc - Architecture overview
-
API.adoc - API reference
-
DEVELOPMENT.adoc - Development guide
-
benchmarks/README.adoc - Performance benchmarks
-
formal-verification/README.adoc - Formal verification
-
security/README.adoc - Security overview
-
security/CRYPTOGRAPHY.adoc - Cryptographic specifications
-
security/GIT_SSH_CONFIG.adoc - Git SSH configuration
-
security/TLS_SSL_CONFIG.adoc - TLS/SSL configuration
-
security/BROWSER_FUTUREPROOFING.adoc - Browser feature future-proofing
-
security/AUDIT_CHECKLIST.adoc - Security audit checklist
-
Issues: GitHub Issues
-
Discussions: GitHub Discussions
-
Security: See SECURITY.md for responsible disclosure
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)
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