Overview
Glossary
Terms used throughout the documentation, with definitions specific to the Ekdotico context.
| Term | Definition |
|---|---|
| AGPL-3.0 | The open source license under which Ekdotico is released. Requires that derivative works hosted as a service publish their source. |
| AI contribution score | A composite score between 0.0 and 1.0 representing the proportion of a document attributable to AI assistance. Computed from keystroke ratio, paste events, AI invocations, rewrite ratio, and word velocity. |
| Amber state | The intermediate task status assigned when AI confidence in a completion is between 0.5 and 0.85 — neither auto-completed nor ignored, but flagged for student confirmation. |
| Citation chip | An inline interactive component in the editor that renders a reference such as (Author, Year) and links to the underlying Library entry. |
| CRDT | Conflict-free Replicated Data Type. The data structure underlying Yjs that enables real-time collaborative editing without locking. |
| CSL-JSON | Citation Style Language JSON. The standard format for representing reference metadata, supported by Citation.js for style rendering. |
| Delta generation | The default Research Journal update path. Rather than regenerating the full journal, Claude updates only sections affected by new activity since the last generation timestamp. |
| Ed25519 | The asymmetric signature algorithm used to sign exported documents. Short keys, fast verification, modern standard. |
| Hocuspocus | The WebSocket server that brokers Yjs document state between connected editors. |
| MoSCoW | The prioritisation taxonomy used in requirements: Must, Should, Could, Won't. |
| pgvector | A PostgreSQL extension that adds vector data types and similarity search, used for RAG over uploaded sources. |
| Promote (mini-chat) | The action that moves an ephemeral mini-chat exchange into the persistent Source Chat tab as a named branch with origin metadata. |
| Provenance signature | The Ed25519 signature embedded in every exported document, together with its full payload of contribution metadata. |
| RAG | Retrieval-Augmented Generation. The pattern of retrieving relevant text chunks from a vector store and including them in the LLM prompt to ground the response. |
| Source Chat | The persistent chat workspace within a document. Operates in two modes: My Sources (RAG over uploaded library) and Research New (open external search). |
| Tiptap | The headless rich-text editor framework, built on ProseMirror, used as the basis for the Write workspace. |
| Tracked change | The visual treatment applied to AI-inserted content in the editor, distinguishing it from human-authored prose. |
| Yjs | The CRDT library used for real-time document state synchronization. |