Wiki Sync
Version 1.0
Sync the agentprivacy canon into the federated guide wiki — guide.agentprivacy.ai plus sibling subdomain sites (skill / tomes / research / atlas), served locally as ~/.wiki farm hosts. Use when projecting a canon directory into forkable wiki pages, adding a new area to the federation, re-syncing a site after a repo change, wiring cross-site links, or auditing coverage and leaks. Encodes the distribution gates G0–G7, the manifest-first G1 discipline, the per-source builders, the verification recipes, and the full registry of every area to sync (done + gaps).
Project the agentprivacy canon (many git repos) into a federated, forkable wiki: a guide hub
(guide.agentprivacy.ai) that rosters one sibling subdomain wiki per canon source. Built local-first as~/.wiki/<host>/ farm hosts; going public is just forking the host up (or DNS-mapping the farm) —localhost → the agentprivacy domain, no structural change.
Golden rule: the git repo is always the source of truth. The wiki is a projection that carries lineage.
The Librarian forks; the Archivist never copies.
The model
Guide ← the hub (build-guide-host.js): index · federation-map · distribution-gates · contribute
├─ Skill ← agentprivacy-skills-v5
├─ Tomes ← cityofmages/tomes
├─ Research ← agentprivacy-docs
├─ Atlas ← spellweb/src/data (the graph — the hyperlink backbone)
└─ library ← agentprivacy_master/public (the 5 narrative spellbooks)
Serve all hosts: "$HOME/AppData/Roaming/npm/wiki" --data ~/.wiki --port 3030 --farm
(use the ABSOLUTE wiki path — a bare wiki exits 127). Log: ~/.wiki/_farm.log.
Each host = pages/<slug> + assets/<slug>/<file> + status/owner.json ({name:"<owner>",friend:{secret:"<friend-secret — never commit the live value>"}}).
The area registry — everything to sync (NAME ALL AREAS HERE)
Status: ✅ done · ◻️ gap (public canon not yet federated) · 🔒 sealed (never federate) · ♻️ dup (never double-federate).
| Area | Source path | → Site | Builder | Status |
|---|---|---|---|---|
| Skills | agentprivacy-skills-v5/{persona,role,privacy-layer,meta,wikis} |
skill | build-all.js |
✅ 163 |
| Tome acts + cast + specs + bestiary + invitations | cityofmages/tomes/ |
tomes | build-tomes.js |
✅ 121 |
| Conjecture register + v6 papers | agentprivacy-docs/research/CONJECTURE_REGISTER_V6.md + papers/v6/* |
research | build-research.js |
✅ 94 |
| Knowledge graph (nodes+edges) | spellweb/src/data/{nodes,edges}.ts |
atlas | build-atlas.js |
✅ ~660 |
| The hub (index/map/gates/contribute) | — | guide | build-guide-host.js |
✅ |
| Ceremonies | agentprivacy-docs/ceremonies/ |
research | build-research.js (buildDocs) |
✅ 14 |
| Compendium | agentprivacy-docs/compendium/_assembled/ |
research | build-research.js (buildDocs) |
✅ 2 (PLAN.md sealed) |
| Reference | agentprivacy-docs/reference/ |
research | build-research.js (buildDocs) |
✅ 10 |
| Lineage + whitepaper papers | agentprivacy-docs/papers/{lineage,v4,v5,whitepapers} |
research | build-research.js (buildDocs) |
✅ 11 |
| Grimoire prose | agentprivacy-docs/grimoires/ |
research | build-research.js (buildDocs) |
✅ 4 |
| City blog + letters + lore | cityofmages/{blog,mageletters} + top-level public .md |
tomes | build-tomes.js (buildDocsFrom CITY) |
✅ blog 13 · letters 6 · lore 7 |
| Blockchain canon + blade prose | spellweb/dist/canon/ + root *-blade.md |
atlas | build-atlas.js (buildCanon) |
✅ canon 25 · blades 5 |
| Architecture guides | agentprivacy_master/docs/guides/ |
guide | build-guide-host.js |
✅ 9 (chronicles/plans/dupes sealed) |
| Docs deep pass — poems · specs · story-frame · research notes · about | agentprivacy-docs/{poems,specs,story,research/*.md,*.md} |
research | build-research.js (buildDocs) |
✅ poems 3 · specs 7 · story 2 · notes 18 · about 3 (story/acts ♻️=ceremonies, drafts/eml/letters/chronicle sealed) |
| Blog | agentprivacy-docs/blog/ |
research | build-research.js (forward-link summary) |
✅ 1 summary page — forward-links to live sync.soulbis.com, NOT reproduced |
| Narrative spellbooks — Story · Parallel Society · Plurality · Zero (Privacymage Grimoire) · Canon | agentprivacy_master/public/{story,society,plurality,zero,canon} |
library (NEW 6th site) | build-library.js |
✅ 146 (story 34 · society 22 · plurality 38 · zero 33 · canon 14 + 5 hubs + index; Planning_Document sealed) |
| Dual-agent harness — core (loop·trusts·ground rules·contract) + 7 seats + specialisation + 15 harness paths (the origin fleet) + workflows/runtimes + field-guide spar | ~/dual-agent-harness |
harness (NEW site) | build-harness.js |
✅ (chronicles/ · universe/ · runs/ · instance ledgers 🔒 — numbers cited from frontier.json, never paged) |
| DTG research KB — decision baseline (§-split) + explorations (now incl. X10 + X11 field-guide deployment) + lab NOTES + 2 chronicles | ~/dtgwg-cred-spec-main_mage via its own tools/build-kb.mjs (manifest-first + secrets gate; emits kb/fedwiki/) |
dtg (NEW site) | node tools/build-kb.mjs then wire-dtg-kb.js (wires slug = slugify(title); retires manifest-slug basename copies to recycle — 15 differ, incl. x11) |
✅ 92 = 78 kb + 13 trust-tasks + welcome (vendored spec 58 files NEVER projected; 2 chronicle slugs = manifested circulating, leak-scan false positives) |
| MyTerms bundle — alliance application (exec brief + application + A/C/D/E letter docs) + IEEE 7012 integration plan v2 + universe card + standards presentation brief + The Two Familiars (extensions at low altitude) | ~/myterms (docs directly; /swordsman /mage /swordsman-blade /mages-spell = EXPERIMENTS, reference-only) |
myterms (site: "The Agreement Layer" 📜 #86a9c9) | build-myterms.js (+ myterms-crosslinks.json outbound refs, link-myterms.js inbound post-pass — re-run after any host rebuild) |
✅ 11 (SEALED: IEEE 7012-2025 PDF — copyright + no-AI-ingest; chronicles; harness/ ♻️ = harness site; superseded v1 plan; stale Feb PDF renders) |
| Field Guide trust overlay — 22 pages (counter-spec rulings · question map · acceptance · proverbs · 2 dated chronicles = manifested circulating) + assets lane (whole workbench + runnable bundle) | ~/field_guide_privacymage/wiki/{pages,assets-staging} — WORKING DIR by ruling (git-less; durable substance folded to agentprivacy-docs/research/fieldguide/ — docs+maps+runtimes; built on the Mac farm as privacy.fieldguide; also served from embassy Pis as mitch.private.fish / fieldguide.pi4.private.fish) |
fieldguide (site: "The Field Guide" 🧭 #4a8c5f) | pages byte-copied (fork lineage kept) + local welcome-visitors; see ~/field_guide_privacymage/wiki/push-to-pi.mjs for the Pi lane |
✅ 23 (2026-08-17 convergence merge) |
Chronicles / plans / drafts / audits / version-history / .bak / node_modules / dist/ artifacts |
(everywhere) | — | — | 🔒 |
| Tome mirrors | agentprivacy-docs/tomes/ (80) · agentprivacy_master/docs/tomes/ (164) |
— | — | ♻️ = cityofmages/tomes |
When adding an area: append a row here first, then build it. Naming a thing in this table is step zero of syncing it.
The distribution gates (G0–G7)
Out (git → wiki): G0 source-of-truth (git upstream) · G1 classify circulating vs sealed · G2 coherence
(numbers/tiers/versions match register+grimoire) · G3 attribution (upstream/author/license; vendored credited)
· G4 projection altitude (link down to source, don't dump) · G5 hyperlink coherence (links resolve; from the
graph edges) · G6 distribution topology (right site, canonical slugs, no collisions).
Back (wiki → git): G7 fork-back — coherence + attribution + First-Person sign-off (OPEN→SIGNED); propose a diff,
never auto-commit.
The process (per area — the 8-step loop)
- Manifest (G1) — NON-OPTIONAL. Enumerate the source dir; mark every file
circulatingorsealed. The
leak and the gaps both came from skipping this. Default-seal chronicles/plans/drafts/audits/version-history. - Map. Slug + title per file; resolve cross-links (intra-site
<a class="wlink" href=".html"> </a>, cross-sitereferenceitems). - ⊥check map. Adversarially verify classification + coherence against the repo + grimoire/register.
- Generate. Run the converter → page JSONs + staged
assets/<slug>/<sourcefile>. - Hyperlink. Inject nav footer + hub rosters + cross-links.
- ⊥check build. Slug-collision + link-integrity + orphan sweep (script below) BEFORE serving.
- Serve. Write into
~/.wiki/<host>/; the farm rebuilds the sitemap on next request. - ⊥check live. Read the live wiki; confirm sitemap count, assets
200 text/markdown, links resolve, and
no sealed slug leaked (leak-scan below). For structured data (register, graph) a deterministic re-parse
beats an agent; for prose/lore use an Explore agent to map live↔repo. SIGN (chronicle) only when clean.
Conventions (do these every time)
- slug =
slugify(title)(t.replace(/\s/g,'-').replace(/[^A-Za-z0-9-]/g,'').replace(/-+/g,'-').toLowerCase()),
and choose unique, readable, self-namespacing titles so roster/footer<a class="wlink" href="title.html">title</a>links always resolve. - THE BIJECTION RULE (2026-08-03 ruling, after a fedwiki.club bug report): the page's stored slug MUST equal
FedWiki's ownasSlug(title)=t.replace(/\s/g,'-').replace(/[^A-Za-z0-9-]/g,'').toLowerCase()— downstream
code (share links,<slug>.htmlstatic export, forks) assumes title↔slug map to each other. Consequences:
titles must be ASCII-clean (no emoji —"Archer 🗡️🎯"slugs toarcher-with a trailing dash; put emoji in
the story-card heading instead), no title-vs-filename divergence (agentprivacy-guild-efficiencyfile with
title "Guild Efficiency" broke fedwiki.club link-gen).build-all.jsnow has a bijection lint that fails
the build on any violation — never push pages that fail it. Rename map for the 2026-08-03 mass fix:~/.wiki/skill-fedwiki/rename-map.json; club repair script:club-fix.js. - Cross-site links = a FedWiki
referenceitem{type:'reference', site:'<host>', slug, title, text}— NOT a
bare<a class="wlink" href=".html"> </a>(those resolve same-site only). Add a cross-site ref ONLY if the target page already exists. - Neutralise source-body
<a class="wlink" href=".html"> </a>before converting — canon prose (RPP gates etc.) uses<a class="wlink" href=".html"> </a>as content; it
collides with wikilinks. Strip to plain text, then add your own links. - Assets keep the original source filename (
assets/<slug>/01-the-single-button.md), not<slug>.md. - Attach each page's source file as a
# Assetsheading +{type:'assets', text:slug}item.
Tooling (~/.wiki/skill-fedwiki/)
skill-to-fedwiki.js—buildPage({srcPath,slug,title,navText,assetsSlug})module + frontmatter/section split.build-all.js(skills) ·build-tomes.js·build-research.js·build-atlas.js— per-source orchestrators.build-local-host.js <host>— materialize staged pages+assets into a farm host.build-guide-host.js— the hub; flip a site'sSITES[].statustoLIVE+ re-run to roster it (and emit its
cross-sitetileglyphtile +reference).link-tomes-research.js— idempotent post-pass wiring act↔conjecture cross-site links (re-run after a rebuild).add-family.js— idempotent post-pass binding all hosts into a family: injects arosteritem (categories
Hub=guide · Sister sites=the four) into every welcome-visitors, so each site rosters its sisters and can pull
the whole family into the neighbourhood. Re-run after a rebuild (welcome-visitors is regenerated).log.js <op> <detail>— append a greppable entry tolog.md(## [date] op | detail; the LLM-Wiki log).file-answer.js "<title>" [content.md]— file a good answer back into the wiki as a synthesis note
(notes/<slug>.md+ alog.js noteentry) so explorations compound (the LLM-Wiki "answers filed back" op).build-guide-extras.js— idempotent post-pass: publishlog.md→ Federation Log,notes/*.md→ The
Notes, andAUDIT.md→ Federation Audit on the guide, + a Log & Notes section on welcome-visitors.audit.js— the lint op: reads every host → page counts · broken links · leak-scan · orphans · cross-site
refs → writesAUDIT.md+ alintlog entry + a PASS/WARN table. Reads only. (Non-zero broken/leaks are
usually benign in-content<a class="wlink" href=".html"> </a>examples or false-positive candidates — the report says so; confirm before acting.)resync.js [area...]— one-command auto-sync for a research turn. Runs forkback (report contributions
first) → the chosen area builders (default: all) →link-tomes-research→add-family→audit→build-guide-extras. A research turn that touched only research =node resync.js research. Full re-sync =node resync.js.
This is the run order; resync.js encodes it.make-favicon.js— per-host colour-identity favicon flag.forkback.js <host>— the G7 gate: detect external contributions (current story diverges from thecreate
journal snapshot, or post-create journal actions exist) and print each as an[OPEN]proposal for First-Person
sign-off. Reads only — never writes to git or the wiki. Run before re-building a host (a rebuild overwrites
contributions); fold signed changes into the source repo by hand (page→repo is a lossy projection).push.js/push-assets.js— public push (action API / WebDAV) — parked; user pushes to the domain manually.
Verify recipes
# sitemap count for a host
curl -s -H "Host: <host>.localhost" http://localhost/system/sitemap.json | grep -o '"slug"' | wc -l
# link integrity (run in ~/.wiki/<host>): 0 broken expected (in-content example <a class="wlink" href=".html"> </a> are benign)
node -e 'const fs=require("fs");const S=t=>t.replace(/\s/g,"-").replace(/[^A-Za-z0-9-]/g,"").replace(/-+/g,"-").replace(/^-|-$/g,"").toLowerCase();const F=fs.readdirSync("pages"),X=new Set(F);let b=0;for(const f of F){const p=JSON.parse(fs.readFileSync("pages/"+f));for(const it of p.story){if(it.type==="reference")continue;for(const m of (it.text||"").matchAll(/\[\[([^\]]+)\]\]/g))if(!X.has(S(m[1])))b++;}}console.log("broken:",b)'
# leak scan — sealed content that slipped in (verify hits are false positives like a Chronicler persona)
curl -s -H "Host: <host>.localhost" http://localhost/system/sitemap.json | grep -oE '"slug":"[^"]+"' | grep -iE "chronicle|draft|plan|audit|candidate|presync|\.bak"
Gotchas (learned the hard way)
- Manifest-first or it bites you: firehosing a whole repo/graph leaks internal nodes (3 chronicle nodes rode
the spellweb graph into atlas — now sealed bytype:chronicle/label:/^Chronicle/). Spine-only passes
under-federate (research got 6 of ~100 docs). dist/spellweb/nodes.jsonis a stale 16-node artifact — parsesrc/data/*.ts.- Cast
sigilmay carry a parenthetical note — take the glyph only, or slugs break. - Leak-scan false positives:
chronicler(the persona),spec-vertex-naming-audit(canonical spec), "plan"
inside "plane". Always confirm a hit is real before sealing. - Browser extension is offline here — tileglyph tiles / favicon flags can't be visually verified; check the
item JSON, not the render.
Verify: agentprivacy.ai · plan ~/.claude/plans/moonlit-stirring-lagoon.md ·
coverage audit agentprivacy_master/docs/chronicles/2026-06-27_federation_coverage_audit.md
Provenance
Forkable skill page migrated from the agentprivacy skills repo (persona/agentprivacy-wiki-sync, v1.0).
Source of truth: agentprivacy-skills-v5. Fork this page to materialize a local SKILL.md via fedwiki-to-skill.
origin: 0xagentprivacy · author: Mitchell Travers
Assets
📎 wiki-syncSKILL.md