Skip to content

docs: post-migration audit for local-first Automerge architecture#560

Merged
rgbkrk merged 1 commit intomainfrom
docs/post-migration-audit
Mar 6, 2026
Merged

docs: post-migration audit for local-first Automerge architecture#560
rgbkrk merged 1 commit intomainfrom
docs/post-migration-audit

Conversation

@rgbkrk
Copy link
Member

@rgbkrk rgbkrk commented Mar 6, 2026

Post-migration documentation audit. Updates 12 files to reflect the local-first Automerge architecture from PRs #542#554.

Changes

AGENTS.md / CLAUDE.md:

  • New "Notebook Document Architecture (Local-First)" section — three Automerge peers, mutation/sync flows, WASM schema compatibility note
  • Key files table updated with runtimed-wasm, useAutomergeNotebook.ts, materialize-cells.ts
  • crates/notebook/src/lib.rs description updated (cell mutation commands removed)
  • Build note for runtimed-wasm (same pattern as daemon separate-binary warning)

README.md: Added runtimed-wasm to project structure.

contributing/architecture.md: Conformance table: "Mostly Conformant" → "Conformant" for Automerge and local-first editing.

contributing/build-dependencies.md: Added runtimed-wasm to all three Mermaid diagrams and key points table.

contributing/development.md: Added wasm-pack manual build note.

contributing/runtimed.md: Cross-reference to runtimed-wasm shared notebook_doc.rs.

docs/runtimed.md: Rewrote Phase 5 section (was pervasively stale — referenced deleted files, deleted events, deleted commands, wrong architecture). Fixed Known Limitations sync race section. Updated summary table.

docs/python-bindings.md + python/runtimed/README.md: Added session.save(path=None) documentation.

docs/logging.md: Fixed stale log prefixes ([notebook-sync][automerge-notebook]).

useDaemonKernel.ts: Fixed stale comment (notebook:updatedautomerge:from-daemon).

Closes the documentation gap from #540.

…e architecture

Update 12 files across AGENTS.md, README, contributing/, and docs/ to
reflect the local-first Automerge migration (PRs #542-#554):

- AGENTS.md: add Notebook Document Architecture section (WASM peers,
  mutation flow, sync flow), update key files table, add runtimed-wasm
  build note
- README.md: add runtimed-wasm to project structure
- contributing/architecture.md: conformance table now fully Conformant
- contributing/build-dependencies.md: add runtimed-wasm to all three
  Mermaid diagrams and key points table
- contributing/development.md: add wasm-pack manual build note
- contributing/runtimed.md: cross-reference runtimed-wasm shared code
- docs/runtimed.md: rewrite Phase 5 for actual local-first architecture,
  fix stale Known Limitations, update summary table
- docs/python-bindings.md + python/runtimed/README.md: add session.save()
- docs/logging.md: fix stale log prefixes
- useDaemonKernel.ts: fix stale comment (notebook:updated → automerge:from-daemon)
@rgbkrk rgbkrk enabled auto-merge (squash) March 6, 2026 08:57
@rgbkrk
Copy link
Member Author

rgbkrk commented Mar 6, 2026

One typescript file comment stopping this from getting the easy build path.

@rgbkrk rgbkrk disabled auto-merge March 6, 2026 08:58
@rgbkrk rgbkrk merged commit 0734b78 into main Mar 6, 2026
10 checks passed
@rgbkrk rgbkrk deleted the docs/post-migration-audit branch March 6, 2026 08:58
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant