aaronrene / knowtation public
docs feat/note-outline-mvp #16 / 23
aaronrene · 27 days ago · May 23, 2026 · Diff

docs: plan document tree v0

Define the spec-only DocumentTree v0 contract, future metadata and label retrieval phases, MuseHub domain follow-up, and stop conditions before runtime implementation begins.

sha256:dc0d16cfbfdf8420e12e0a9e43a0c2e3c2d04c8134a696e71da6e9da7ab7406b sha
sha256:97b413e514cbfa74dc0d936f3c40be6ed53b61b73cf49630c2e306ab175425c3 parent
+69 ~17 symbols
sha256:9ecd1f5398a58b221b46fc5fdca47aad7e6e1eb9553f934b83573777981f14d2 snapshot
+69
symbols added
~17
symbols modified
0
dead code introduced
Semantic Changes 86 symbols
~ docs/DOCUMENT-TREE-V0-SPEC.md .md 69 symbols added
+ DocumentTree v0 Spec section DocumentTree v0 Spec L1–730
+ Acceptance Criteria section Acceptance Criteria L699–715
+ Caps And Truncation section Caps And Truncation L381–399
+ Error Contract section Error Contract L399–412
+ code[json]@L403 variable variable code[json]@L403 L403–406
+ Files Expected By Future Phase section Files Expected By Future Phase L628–674
+ Later Metadata And Domain Phases section Later Metadata And Domain Phases L663–674
+ Phase 1A section Phase 1A L630–635
+ Phase 1B section Phase 1B L635–641
+ Phase 1C section Phase 1C L641–649
+ Phase 1D section Phase 1D L649–655
+ Phase 1E section Phase 1E L655–663
+ Future Metadata And Label Retrieval section Future Metadata And Label Retrieval L486–520
+ Goals section Goals L52–61
+ Imports, PageIndex, And OCR import section Imports, PageIndex, And OCR L464–486
+ JSON Contract section JSON Contract L274–345
+ Explicitly Excluded Fields section Explicitly Excluded Fields L324–345
+ Field Rules section Field Rules L304–324
+ table@L306 section table@L306 L306–314
+ table@L317 section table@L317 L317–323
+ Success Shape section Success Shape L276–304
+ code[json]@L278 variable variable code[json]@L278 L278–303
+ Later-Goal Classification class section Later-Goal Classification L125–174
+ Always Separate Decisions section Always Separate Decisions L149–163
+ Permanent Guardrails section Permanent Guardrails L163–174
+ Planned Later Goals section Planned Later Goals L127–149
+ Long-Term Direction section Long-Term Direction L61–94
+ Memory, Daemon, And Discover Interaction section Memory, Daemon, And Discover Interaction L452–464
+ MuseHub Knowtation Domain Integration section MuseHub Knowtation Domain Integration L520–544
+ Non-Goals section Non-Goals L94–125
+ Proposed Phase Order section Proposed Phase Order L188–274
+ Later Phases section Later Phases L235–254
+ Phase 0: Spec section Phase 0: Spec L190–194
+ Phase 1A: Tree Builder Only section Phase 1A: Tree Builder Only L194–201
+ Phase 1B: Markdown Parser Integration section Phase 1B: Markdown Parser Integration L201–208
+ Phase 1C: CLI section Phase 1C: CLI L208–219
+ code[text]@L212 variable variable code[text]@L212 L212–215
+ Phase 1D: Self-Hosted MCP section Phase 1D: Self-Hosted MCP L219–229
+ code[text]@L223 variable variable code[text]@L223 L223–226
+ Phase 1E: Hosted MCP section Phase 1E: Hosted MCP L229–235
+ Suggested Later Phase Order section Suggested Later Phase Order L254–274
+ Recommendation section Recommendation L715–730
+ Relationship To Existing Work section Relationship To Existing Work L23–52
+ NoteOutline section NoteOutline L25–43
+ code[text]@L29 variable variable code[text]@L29 L29–32
+ code[text]@L35 variable variable code[text]@L35 L35–38
+ Scooling Bridge section Scooling Bridge L43–52
+ Scooling Interaction section Scooling Interaction L544–558
+ code[text]@L552 variable variable code[text]@L552 L552–555
+ Security Invariants section Security Invariants L412–452
+ General section General L414–430
+ Hosted MCP section Hosted MCP L438–452
+ Local CLI And Self-Hosted MCP section Local CLI And Self-Hosted MCP L430–438
+ Simple Summary section Simple Summary L3–14
+ Stop Conditions section Stop Conditions L674–699
+ Technical Summary section Technical Summary L14–23
+ Terminology section Terminology L174–188
+ table@L176 section table@L176 L176–187
+ Test Matrix section Test Matrix L558–628
+ Data Integrity section Data Integrity L595–607
+ End To End section End To End L584–589
+ Integration section Integration L573–584
+ Performance section Performance L607–613
+ Security section Security L613–628
+ Stress section Stress L589–595
+ Unit section Unit L560–573
+ Tree Construction Rules section Tree Construction Rules L345–381
+ code[markdown]@L364 variable variable code[markdown]@L364 L364–370
+ code[text]@L373 variable variable code[text]@L373 L373–380
~ docs/NOTE-OUTLINE-MVP-SPEC.md .md 14 symbols modified
~ code[json]@L211
~ code[text]@L327
~ code[text]@L333
~ code[markdown]@L310
~ code[text]@L316
~ table@L173
~ table@L183
~ code[json]@L155
~ code[markdown]@L262
~ code[text]@L228
~ code[text]@L243
~ code[text]@L432
~ Note Outline MVP Spec
~ Deferred Phases
~ docs/RETRIEVAL-AND-CLI-REFERENCE.md .md 3 symbols modified
~ Retrieval, Token Cost, and CLI Reference
~ How each feature helps the bottleneck (and token cost)
~ table@L97
Older docs: teach agents note outline retrieval sha256:97b413e514cbfa74dc0d936f3c40be6ed53b61b73cf49630c2e306ab175425c3 All commits Newer feat: add document tree builder sha256:bce6ba567d3c6b149aad21fffe44bdf9a82d27b224325ddb5942e432ff7b52b7

0 comments

No comments yet. Be the first to start the discussion.

To add a comment, use the Muse CLI: muse hub commit comment sha256:dc0d16cfbfdf8420e12e0a9e43a0c2e3c2d04c8134a696e71da6e9da7ab7406b --body "your comment"