**Bead** `3a66d5c4-b77c-48e1-9a02-a6f924b76f2f` · [canonical URI](https://redfish.acequia.io/guerin/.agents/3a66d5c4-b77c-48e1-9a02-a6f924b76f2f/) · discussion: Talk: Wiki Facet For Beads This page is the wiki facet of a [bead](https://redfish.acequia.io/guerin/.agents/); the bead is the source of truth.
## Identity - **URI:** [https://redfish.acequia.io/guerin/.agents/3a66d5c4-b77c-48e1-9a02-a6f924b76f2f/](https://redfish.acequia.io/guerin/.agents/3a66d5c4-b77c-48e1-9a02-a6f924b76f2f/) - **GUID:** `3a66d5c4-b77c-48e1-9a02-a6f924b76f2f` - **Name:** wiki-facet-for-beads - **Started:** 2026-07-09 - **Parciante:** Stephen Guerin (`redfish.acequia.io/guerin`) - **Scribe:** my-claude-vscode (CV) - **Domain claimed:** [wiki.harvardviz.live](https://wiki.harvardviz.live/) (role: operates; bidirectional claim in [domain.json](https://redfish.acequia.io/guerin/.agents/3a66d5c4-b77c-48e1-9a02-a6f924b76f2f/domain.json) ↔ [wiki-harvardviz-live](https://wiki.harvardviz.live/wiki-harvardviz-live.html); pattern in [notes/05](https://redfish.acequia.io/guerin/.agents/3a66d5c4-b77c-48e1-9a02-a6f924b76f2f/2026-07-09/notes/05-domain-claim.md))
## Motivation (why a GUID) Every bead already duck-types as file, folder, and agent. This bead adds a fourth face: the **wiki facet**. The Smallest Federated Wiki that this machine hosts at [https://wiki.harvardviz.live/](https://wiki.harvardviz.live/) becomes a rendering, browsing, discussion, and editing surface over the bead commons. A wiki page per bead, a Talk page per bead carrying its chats and notes, `wiki links` mirroring the acequia-links between beads, and empty pages as invitations where a link lands on a bead that has no page yet. The deeper motive: Ward Cunningham's federated wiki and the acequia bead commons are convergent designs (named pages vs GUID URIs, journal vs chats provenance, neighborhood vs commons). Pointing them at each other tests both. Sibling person bead: [ward-cunningham](https://redfish.acequia.io/guerin/.agents/639158e8-0801-4c2a-8277-9bf271f7bc00/).
## Mechanism (what this bead does) 1. **Surveys** the existing wiki stack on this machine (fedwiki node service, Caddy, Cloudflare tunnel) and prior beads that touched it (route reconciler bead `1057235a`). 2. **Designs** the bead-to-wiki mapping: page shape, Talk pages, cross-links, empty pages, media, and the edit-back loop (wiki edits arrive as dock deposits, never as silent writes into bead provenance). 3. **Ships** a generator, [skills/bead-wiki-facet.mjs](https://redfish.acequia.io/guerin/.agents/3a66d5c4-b77c-48e1-9a02-a6f924b76f2f/2026-07-09/skills/bead-wiki-facet.mjs), that walks `{origin}/{parciante}/.agents/` locally and emits fedwiki page JSON into `~/.wiki/pages/`, with backups before any overwrite and a provenance marker so hand-made wiki pages are never clobbered.
## Folder Layout - [about.md](https://redfish.acequia.io/guerin/.agents/3a66d5c4-b77c-48e1-9a02-a6f924b76f2f/about.md) — this file - [README.md](https://redfish.acequia.io/guerin/.agents/3a66d5c4-b77c-48e1-9a02-a6f924b76f2f/README.md) — front door - [bead-bind-startup.md](https://redfish.acequia.io/guerin/.agents/3a66d5c4-b77c-48e1-9a02-a6f924b76f2f/bead-bind-startup.md) — resume contract - `2026-07-09/notes/` — stack inventory, facet design, open questions - `2026-07-09/skills/` — the generator script - `2026-07-09/chats/` — verbatim session log - `uploads/` — inbound dock
## Session Log - **2026-07-09** — bead started. Surveyed wiki stack (fedwiki service on :3000 via NSSM, Caddy `wiki.harvardviz.live` route, Cloudflared tunnel service) and prior bead `1057235a` (agentic route-flip). Designed the wiki-facet mapping. Built and ran `bead-wiki-facet.mjs` v0.1.0; generated Bead/Talk pages plus a `Beads` index into the live wiki. Verified from external vantage. - **2026-07-09 (later still)** — Stephen: docs facet too. v0.3.0 renders every `.md` (root docs, notes, chats, md artifacts) in a gated bead as its own wiki page with provenance header and cross-links; Talk pages link them as `internal links`; 1176 pages live, verified. - **2026-07-09 (later)** — Stephen's requester-token directive. Anon-probed all 191 beads at origin (138 public, 6 account-gated, 47 unpublished); shipped v0.2.0 with the origin-enforcement gate (anonymous vantage, fail closed) and stale cleanup (100 restricted/unpublished pages removed, verified). Wrote the token-scoped exposure tiers ([notes/03](https://redfish.acequia.io/guerin/.agents/3a66d5c4-b77c-48e1-9a02-a6f924b76f2f/2026-07-09/notes/03-token-scoped-exposure.md)) and the OAuth/well-known/signing-service design ([notes/04](https://redfish.acequia.io/guerin/.agents/3a66d5c4-b77c-48e1-9a02-a6f924b76f2f/2026-07-09/notes/04-oauth-wellknown-signing.md)).
## Modus Operandi (how to interact) - Read [2026-07-09/notes/01-wiki-facet-design.md](https://redfish.acequia.io/guerin/.agents/3a66d5c4-b77c-48e1-9a02-a6f924b76f2f/2026-07-09/notes/01-wiki-facet-design.md) for the mapping. - Regenerate pages: `node 2026-07-09/skills/bead-wiki-facet.mjs` on the host machine (flags in the script header). - Deposit questions or edit proposals in [uploads/](https://redfish.acequia.io/guerin/.agents/3a66d5c4-b77c-48e1-9a02-a6f924b76f2f/uploads/).
## Capabilities - Generate fedwiki page JSON (Bead page, Talk page, Beads index) from any bead's `about.md`, `notes/`, `chats/`, and links. - Detect cross-bead references (GUIDs in prose, `names.json`) and render them as `wiki links`. - Idempotent regeneration with pre-overwrite backups (`~/.wiki/bead-facet-backups/`).
## Lifecycle Open. Next steps live in [bead-bind-startup.md](https://redfish.acequia.io/guerin/.agents/3a66d5c4-b77c-48e1-9a02-a6f924b76f2f/bead-bind-startup.md). The edit-back loop (wiki journal to uploads dock) is designed, not yet built.
## Limitations - v0.1.0 is one-way: beads render into the wiki; wiki edits do not yet flow back (design in notes/01, phase 2). - The generator runs only on the hosting machine (it writes `~/.wiki/pages/` on local disk). - Media association is by canonical URL reference, not by copying into wiki `assets/`. - Exploratory bead: it describes and poses questions; ratification of the pattern belongs to Stephen and Oscar (`4c6470f9`).
## References (bead cross-links) - Bead: Ward Cunningham · [canonical](https://redfish.acequia.io/guerin/.agents/639158e8-0801-4c2a-8277-9bf271f7bc00/)
See all: Beads