Skip to content

v0.3.0 — Optional compiled graph layer + upgrade flow

Choose a tag to compare

@praneybehl praneybehl released this 25 Apr 11:09

Pages can now declare typed graph: metadata in frontmatter (predicate, source-page slug, evidence quote, confidence, status). A bundled extractor compiles every page into wiki/graph/{nodes.jsonl, edges.jsonl, graph.sqlite, graph.graphml}. Markdown stays canonical — the graph can be deleted and rebuilt at any time.

What's new

  • Optional graph layer. Typed semantic edges (founded, proposed, depends_on, …) require an explicit source and evidence quote — the extractor never invents them. Body wikilinks become low-confidence mentions edges; frontmatter sources: lists become sourced_from; source pages' raw: fields become summarizes_raw.
  • Three new scripts (require PyYAML; existing four remain stdlib-only):
    • wiki_graph_extract.py — compile pages → JSONL + SQLite + GraphML, deterministic and sorted
    • wiki_graph_lint.py — validate typed edges against wiki/graph/ontology.yaml
    • wiki_graph_query.pyneighbors, edges, path, facts queries against graph.sqlite
  • /wiki:graph <action> slash command dispatching to extract/lint/neighbors/edges/path/facts. /wiki:ingest, /wiki:lint, and /wiki:query wire the graph step in conditionally — only when wiki/graph/ontology.yaml exists.
  • /wiki:upgrade slash command + init_wiki.py --upgrade flag for wikis bootstrapped under v0.2.0. Idempotent file ops plus a walked SCHEMA.md merge — one section at a time, per-edit approval, never silent.
  • references/graph-workflow.md with full reference: ontology, frontmatter schema, when to add a typed edge vs a plain wikilink, the extract/lint/query loop, generated-artifact tracking, anti-patterns.

Upgrading

  • From an older Claude Code install: /plugin marketplace update then /plugin install llm-wiki@llm-wiki.
  • Existing wiki: run /wiki:upgrade (or python skills/llm-wiki/scripts/init_wiki.py . --upgrade from the CLI).
  • Other agents: npx skills update llm-wiki, or re-run the original npx skills add praneybehl/llm-wiki-plugin -a <agent>.
  • Pre-graph wikis remain fully valid — the graph layer is opt-in. New scripts no-op when wiki/graph/ontology.yaml is absent; existing scripts and slash commands behave identically when no page carries graph: metadata.
  • The graph scripts require PyYAML (pip install pyyaml). The existing four scripts are still stdlib-only.

Full notes: see CHANGELOG.md.