Skip to content

v0.6.0

Choose a tag to compare

View all tags
@Lockyc Lockyc released this 18 Jul 06:56
· 63 commits to main since this release
v0.6.0
215d209

Mycelium now ingests each repo's docgraph doc-graph during scan, so "which repo" and "what are its docs / is its doc-graph healthy" become one query against the served graph. The node shells out to docgraph graph --json per repo (read-only, best-effort — an absent binary, a bare repo, or bad output degrades to no doc-graph and never fails the scan), pins schemaVersion 1, and both summarizes and stores the result.

Doc-graph ingestion

  • Per-component docGraph digest in graph.json — a compact summary (doc count, content/metadata edge counts, island paths, and which conventional entry docs are present), carried on each Component. The queryable "is this repo's doc-graph healthy / how big" signal, kept small on purpose (island paths but not full node/edge lists).
  • Full per-repo payload served at GET /repos/<id>/docgraph.json — the complete docgraph graph --json, pushed out-of-band on the manifest and written by the hub to repos/<id>/docgraph.json. Never inlined into graph.json; there for traversal when the digest isn't enough.
  • MAP.md rot flag — a component with ≥1 doc-graph island gets a terse docs: N islands ⚠ marker; a clean doc-graph adds nothing to the map.
  • myco audit doc-rot signals — new fleet-wide doc-rot (a repo with unfindable/unplaced docs) and docgraph-version (a repo whose docgraph is newer than the pinned schemaVersion 1) findings, turning per-repo doc rot into an ecosystem-visible fact.
  • Ref caveat (v1): docgraph audits the working tree while Mycelium scans a committed ref, so a doc-graph reflects the node's checkout state — documented in schema/graph.md; a precise per-ref capture is deferred until a real divergence bites.

Docs & tooling

  • Conformed the doc graph to docgraph v3 and flipped the pre-push hook to the /v3 install path.
  • Regenerated the docgraph pre-push hook; added a just install recipe.
  • schema/graph.md, CLAUDE.md, and README.md reconciled to the built behavior — the digest shape, the /repos/<id>/docgraph.json route, the schemaVersion pin, and the ref caveat.

No breaking changes: the docGraph field is additive and omitted when a repo has no docs or no docgraph on the node.

Full Changelog: v0.5.0...v0.6.0

Assets 2
Loading