docs: post-v0.8.0 hygiene — drop LLO, fix positioning, sweep factual drift#367
Merged
Conversation
ROADMAP.md: - Bump current state from "April 2026, post-v0.7.0" to "May 2026, post-v0.8.0" - Lead with the v0.8.0 wire-format break + LLO v0.2.0 pairing - Tool count 16 → 17; list each tool by name so count + inventory don't drift - Add canonical views, capnp readthrough, current_root hot-swap, e2e harness, snapshot memoization to the Stable section - Reorder near-term: bundle → version check → consent-gated auto-download → CGO removal; add schema-driven read modes (mache-qzsk) go-parsing-status.md: - init() collisions: was "blocking", now resolved by engine dedupSuffix - Imports: were "not captured", now first-class via the Go schema's imports/ - Drop the "Blocking Issues for Refactoring" section — both fixed
LLO was internal jargon leaking into user-facing prose. Replace with "ley-line-open" everywhere, with a hyperlink at first mention per file and bare "ley-line-open" thereafter. Positioning fixes (PRIOR_ART + competitive-landscape): - Lead with the graph engine, not the filesystem. The filesystem is one expression layer over a graph that also ships canonical refs/defs views, content-addressable substrate identity, AST-aware write-back, structural-rule analysis, and schema inference. - Frame Mache as AI-native: NFS surface is an in-process go-nfs + billy server (not an OS export) precisely because agents already speak filesystem operations. - Equal-footing surfaces: MCP (primary) and the embedded NFS server. Factual drift swept: - Languages: 8 -> 28 (PRIOR_ART table + prose; competitive-landscape matrix) - Mount: NFS/FUSE -> NFS (FUSE was removed in v0.7.0) - Add lean-ctx to PRIOR_ART comparison table + detailed analysis + sources - ARCHITECTURE Control block row: note v0.8.0 substrate-identity change (BLAKE3 current_root replaces monotonic generation) - competitive-landscape title: March 2026 -> May 2026
There was a problem hiding this comment.
Pull request overview
Docs-only cleanup to align post-v0.8.0 messaging and facts across the project docs, including updated positioning (graph-first), current capability counts, and the “ley-line-open” naming.
Changes:
- Updates product positioning across docs to lead with the graph engine, with MCP + embedded NFS as equal expression layers.
- Sweeps factual drift (v0.8.0 status, tool count, language count, canonical views/capnp event log, hot-swap identity).
- Replaces “LLO” acronym references with “ley-line-open” and updates diagram labels accordingly.
Reviewed changes
Copilot reviewed 8 out of 8 changed files in this pull request and generated 9 comments.
Show a summary per file
| File | Description |
|---|---|
| README.md | Updates tool/dependency wording and mermaid labels to use “ley-line-open” and graph-first framing. |
| GETTING-STARTED.md | Updates references to ley-line-open and the tool capability explanation/troubleshooting text. |
| docs/ROADMAP.md | Refreshes “current state” to May 2026 post-v0.8.0 and expands stable features + near-term ordering. |
| docs/PRIOR_ART.md | Reframes intro as graph-first, updates language/mount facts, and adds lean-ctx to comparisons. |
| docs/go-parsing-status.md | Updates Go construct status claims (init() dedup, imports captured) and removes blocking-issues section. |
| docs/competitive-landscape-2026.md | Updates title/date and refreshes mache positioning + capability matrix facts. |
| docs/ARCHITECTURE.md | Renames “LLO” references to ley-line-open and updates diagrams and capability matrix wording. |
| CHANGELOG.md | Replaces remaining “LLO” mentions with “ley-line-open” in v0.8.0 notes. |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
- resolve_ref: add to GETTING-STARTED.md MCP-tool list (was 13 standalone, now correctly 14) - "the other 13 work without ley-line-open" -> "the other 14" - Grammar artifacts from the LLO -> ley-line-open sweep: "an ley-line-open-built .db" reads wrong because the article was correct for "LLO" (vowel sound) but not for "ley-line-open" (consonant sound). Reworded as "a `.db` built by ley-line-open" everywhere for consistency with the README form. - ARCHITECTURE.md sequence diagram: Mermaid participant IDs can't contain hyphens; switch identifier to `Leyline` with display label "ley-line-open (leyline parse + lsp)" via `as`. Update `Source->>` and `->>Log` to reference the new ID. - PRIOR_ART.md: "real NFS/FUSE filesystem" -> "real NFS filesystem (in-process go-nfs + billy server)" — FUSE was removed in v0.7.0; carrying the dual reference forward was drift. - ARCHITECTURE.md:242: "NFS/FUSE attribute caches" -> "NFS attribute caches" (same drift, now consistent).
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
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.
Summary
Post-v0.8.0 docs hygiene — three rounds of fixes:
Round 1: post-release factual updates
init()collisions resolved by engine dedupSuffix; imports now first-class via the Go schema'simports/; drop the "Blocking Issues for Refactoring" sectionRound 2: positioning fix
go-nfs+billyserver (not an OS export) chosen because agents already speak filesystem opsRound 3: drop "LLO" acronym
leyline lsp/leyline parse(the binary names)Other factual drift swept
Test plan
grep -r '\bLLO\b'user-facing docs → empty