docs: TODO-0106 graph model cleanup + TODO-0193 .mdx support spec - #67
Merged
Conversation
Promote the 2026-06-25 design to the spec body and remove the superseded edges.lance / mdvs graph / phased-adjacency (redb, CSR) sections; their rationale is preserved in the design-history log. Add an explicit "extracted vs declared" scope note marking declared/traceability code links as out of scope (a separate project), keeping mdvs and that concern distinct.
…workflows - 0106: nodes = files + sections (internal heading hierarchy -> structural edges + broken-heading detection in check); both Obsidian and GitHub heading notations resolve to the same section node (one canonical slugger); file/section link-type model; sections only. - 0106: semantic similarity excluded from the graph entirely (discovery-only). - 0171: reframed from a stored similarity-edge graph into semantic-assisted link-authoring workflows -- semantic proposes, the author commits explicit links; nothing semantic is stored as an edge.
…ody stripping) Co-Authored-By: Claude <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Docs-only. Three commits across the spec TODO surface.
TODO-0106 — graph model cleanup
TODO-0193 — new
.mdxsupport specSplits MDX support into two increments:
check/init/updatework with a one-line scanner change. Unlocks docs-site frontmatter linting — MDX's actual unmet pain point.import/exportlines and{expr}expressions (JSX tag markup is already dropped asEvent::Html; those leak asEvent::Text). Records the open design decisions (opt-in vs automatic, strip aggressiveness, config surface).Files
docs/spec/todos/TODO-0106.md,TODO-0171.md— graph cleanupdocs/spec/todos/TODO-0193.md— new specdocs/spec/todos/index.md— index row for 0193