A complete knowledge management system built around GDBM storage and JSONHTL format specification. Provides HTTP API access and command-line tools for document storage, retrieval, and management.
Three-tier architecture:
• Database Layer - GDBM storage with extent attribute handling
• HTTP Server - FastAPI-based REST API with dual-mode operation
• Client Interface - Command-line and Python module access
• HTTP Server (gdata_server.py) - FastAPI server with STDIN/HTTP modes
• Database Layer (gdata.py) - GDBM abstraction with JSON handling
• Notes Client (notes_client.py) - CLI and module interface
• Backup System - Archive import/export with directory structure preservation
• Test Infrastructure - Comprehensive test suites for all protocols
All documents conform to JSONHTL specification with:
• Block elements: para, heading, codeblock
• Inline elements: plain text, link, code
• Semantic markup without presentation concerns
Production deployment on port 8021 with .agent_notes.gdbm database. Test environment on port 8020 with isolated database for development and testing.
• Dual-mode operation (HTTP server and STDIN protocol)
• Hierarchical document organization with / separator
• Automatic daily backups via cron integration
• Directory-preserving archive import/export
• Comprehensive test coverage for all interfaces