Compiled wiki¶

tools/wiki/ ships memd-wiki, a Python console script that compiles a Karpathy-style markdown wiki from live memd project state. Pages include index.md, log.md, projects/<project_id>.md, tasks/<task_id>.md, and libraries/{failures,decisions,evidence,highlights}.md, each trust-aware (displays trust_tier, requires_verification, and grounded_by links).

Install¶

Stdlib-only, Python ≥ 3.11:

pip install -e tools/wiki/
memd-wiki build
memd-wiki lint

Serve¶

memd-wiki serve [--output-dir PATH] [--host 127.0.0.1] [--port 8099]

Read-only stdlib HTTP server over a compiled tree. Binds localhost by default; pass --host 0 or --port 0 for ephemeral addresses (useful in tests and CI). SIGINT / SIGTERM shut the server down cleanly. memd-wiki serve never rebuilds the tree — run memd-wiki build first whenever memd state changes.

Portable Markdown output¶

memd-wiki writes a plain Markdown tree. The output can live in any directory: a checked-in docs folder, a static-site source tree, a shared filesystem folder, or an Obsidian vault. Set wiki.outdir in .memd/config.json or pass --output-dir:

{
  "tenant_id": "memd",
  "project_id": "memd",
  "wiki": {
    "outdir": "/path/to/markdown-memory"
  }
}

Obsidian is only one reader for that tree. The general contract is that memd remains the source of truth, and the wiki is the human-readable, searchable projection. Agents should write durable memory with memd add or structured task.* / artifact.* operations, then rebuild the wiki. Do not hand-edit generated compiler or LLM lanes; keep human-only notes under notes/.

Three ownership lanes¶

The wiki has three lanes:

Lane	Prefixes	Writer	Lint enforcement
compiler	`index.md`, `log.md`, `projects/`, `tasks/`, `libraries/`, `manifest.json`	the `memd-wiki build` compiler	strict — manifest-drift removes orphans
llm	`concepts/`, `entities/`	the compiler renders one page per `wiki_page` artifact	strict — one file per WikiPage; `concept-*` checks
human	`notes/` (opt-in)	humans, out-of-band	permissive — compiler never writes here

memd-wiki is version-aligned with the memd binary it talks to (MAJOR.MINOR must match; patch skew warns). See tools/wiki/README.md for the full install paths, .memd/config.json wiki subsection, containment guard, determinism contract, and the 5-check lint table.