Skip to content

Source-backed Co-work documents

Domain bindings, headless structured-document kernel, durable change records, projection recovery, and source-dependency maintenance for Co-work documents.

Details

Source-backed Co-work documents

work_buddy.document_kernel provides a production-packaged, DOM-free worker using the same ProseMirror/Yjs schema and Markdown mapping as the browser. It supports bootstrap, projection, source Markdown application, text replacement, and opaque update validation. Build tests require a deterministic worker and verify that no dashboard public assets leak into its package.

The per-store causality database records domain bindings, authority epochs, change intents and immutable change records, projection intents/receipts/ cursors, and deterministic export/import. A prepared operation survives a process crash; a committed document head cannot exist without recoverable causality.

The Journal Running Note was the first projection-enabled pilot. Tasks are the first projection-free production domain:

  • each task owns at most one active Co-work binding;
  • task documents use projection_mode=none and never render Markdown;
  • reads, excerpts, email append, and IR consume the current Yjs head;
  • delete/restore preserves retired history and creates a successor binding;
  • local assets remain in place behind opaque, host-authorized links, with an explicit metadata recheck that never returns a path.

The Journal pilot sequence is:

  1. resolve and reserve its exact retained source;
  2. create the bound Co-work document and initial source-backed change;
  3. cut that note's authority epoch to Co-work;
  4. project the canonical head into its managed Journal section;
  5. record the reverse navigation/inspection mirror;
  6. reconcile direct editor updates and missed projections after restart.

The file-import source provider is root-confined, no-follow, UTF-8 Markdown, bounded, and exact-whole-file only. It powers divergence capture without claiming file authorship. The superseded task-note Markdown migration reused the same kernel behind per-note gates; it is now legacy-only. See tasks/native-task-system.

Requirements

  • architecture/source-foundation