create-egregore 0.19.2 → 0.19.5

package/runtime/codex/.codex/skills/view/SKILL.md

@@ -1,41 +1,156 @@
 ---
 name: view
-description: 'Fallback Codex adapter for the Egregore view workflow.'
+description: 'Render Egregore data and documents as branded browser artifacts. Use when the user invokes /view or $view, asks to show something visually, open it in a browser, make a document readable or presentable, render a quest/handoff/activity/board/network, or synthesize a visual artifact from a topic.'
 ---
 
-<!-- generated-by: bin/codex-sync-skills.sh -->
+# Egregore View
 
-# Egregore view Adapter
+Native Codex Egregore skill. Use only inside an Egregore checkout.
 
-This is fallback coverage for a long-tail Egregore workflow that has not been
-ported to a hand-written Codex-native skill yet.
-
-Use the project shell and filesystem directly. Do not invoke Claude Code
-commands. Translate interactive choices to structured Codex question tooling
-when it is available; otherwise render compact numbered choices with an
-`Other:` option and wait for the user.
+Resolve a file or live Egregore surface, render it with the in-repo artifact
+tooling, open it, and report the concrete output path. Run the workflow inline;
+do not invoke Claude Code commands or delegate through Loom.
 
 ## Structured UX parity
 
-This workflow has a Claude skill with user-visible structured output. After
-reading `.claude/skills/view/SKILL.md`, reproduce the same visible UX in Codex:
-
-- Preserve TUI boxes, markdown tables, rich cards, browser artifact rendering,
-  exact confirmation blocks, and "no preamble" rules from the source skill.
-- Use the source skill's frame width, section order, labels, status footer,
-  and examples as the contract for the final response.
-- Never replace a required box/table/card/artifact view with a prose summary
-  unless the user explicitly asks for a summary.
-- When the source says to output a TUI box directly, paste that box as the
-  visible response, preferably in a `text` fenced block.
-- Never show raw JSON, raw command output, or unformatted script output when
-  the source skill requires formatted status or rendered output.
-
-1. Read `.claude/skills/view/SKILL.md` for the workflow details.
-2. Run the referenced `bin/` scripts directly from Codex.
-3. Treat graph, publish, and notify steps as best-effort unless that workflow
-   explicitly says they are required.
-4. Keep local-mode behavior filesystem-first and avoid graph or notification
-   calls when `egregore.json` declares `"mode": "local"`.
-5. Never call the deprecated `egregore-handoff` CLI for Egregore project
-   handoffs.
+The visible result is the browser artifact and a compact receipt. Preserve the
+typed artifact templates, designed document composition, exact file path, and
+stable board URL when available. Do not replace the artifact with a prose
+summary or expose raw renderer output.
+
+## Resolve the request
+
+1. Verify `bin/agent.sh` exists. If not, say this is not an Egregore checkout.
+2. Parse an optional type followed by a name:
+   - `quest` from `memory/quests/`
+   - `handoff` from `memory/handoffs/` recursively
+   - `activity`, `board`, or `network` with no source file
+   - `document` for any markdown file
+3. Treat an argument containing `/` or ending in `.md` as a direct path. Use it
+   if it exists and infer the type from its directory.
+4. With no explicit type, search in this order: quests, handoffs, knowledge.
+   Prefer exact basename matches, then case-insensitive partial matches. For
+   handoffs, prefer the newest matching dated path.
+5. If several files match, use structured Codex question tooling when
+   available; otherwise ask one concise plain-text question listing the paths.
+6. If no file matches and the input is a topic or question, synthesize a
+   temporary markdown document from relevant memory, repository files, and
+   conversation context at
+   `/tmp/egregore-artifacts/synthesized-<slug>.md`. If the input clearly names
+   a missing file, report it as missing instead of inventing a document.
+
+## Select the renderer
+
+Prefer the checked-out package so local changes are exercised and no package
+download is needed:
+
+```bash
+RENDER="npx egregore-artifacts@latest"
+if [ -f packages/egregore-artifacts/bin/cli.js ] && \
+   [ -d packages/egregore-artifacts/node_modules/react ]; then
+  RENDER="node packages/egregore-artifacts/bin/cli.js"
+fi
+```
+
+If the local package exists without dependencies, install its dependencies or
+use the `npx` fallback. Do not block a render on optional connected services.
+
+## Render typed artifacts
+
+Run the matching command:
+
+```bash
+$RENDER quest <quest-file>
+$RENDER handoff <handoff-file>
+$RENDER activity
+$RENDER board
+$RENDER network
+$RENDER document <markdown-file>
+```
+
+Use the renderer's reported HTML path rather than guessing it.
+
+For documents, walk the generative-UI synthesis graph in
+`packages/design-system/generative-ui/skill/SKILL.md`: select one id each for
+objective, audience, register, palette, and grammar from the document's
+substance, record one line of judgment for each, resolve the brief, and pass it
+with `--brief`. If that layer is unavailable, render without the brief.
+
+## Compose flagship documents
+
+Composition is the default for a multi-section strategy, briefing, explainer,
+analysis, decision document, or anything explicitly requested as composed,
+presentable, client-facing, designed, or `--compose`. Use the fast renderer for
+typed artifacts, short utility documents, `--fast`, or `--floor`.
+
+For composition:
+
+1. Read the source document in full.
+2. Copy `.codex/skills/view/assets/compose-scaffold.html` to
+   `/tmp/egregore-artifacts/composed-<slug>.html`.
+3. Fill every placeholder and walk the generative-UI graph for the manifest's
+   register, palette, grammar, and trail.
+4. Transform rather than mirror the markdown:
+   - write a two-tone claim-led hero and italic standfirst;
+   - make section headings state findings, not repeat source headings;
+   - choose components by meaning: ledger for Q/A, claims for numbers, panels
+     for options, steps for sequences, feature rows for capability/status,
+     threads for decisions, gap cards for negatives, and a readout for the
+     honest bottom line;
+   - create one anchored navigation item per composed section.
+5. Keep every theme-sensitive color as `var(--token)`. Never emit inline hex
+   colors in composed content. Preserve the scaffold's no-flash theme restore,
+   `<html data-theme>`, and light/auto/dark behavior.
+6. Verify no placeholders remain, open the HTML with the platform browser
+   opener, and report `Renderer: composed (band 5, inline)`.
+
+## Publish the stable board
+
+After `$RENDER board`, publish best-effort only when `egregore.json` declares a
+connected configuration:
+
+```bash
+_API_URL=$(jq -r '.api_url // empty' egregore.json 2>/dev/null)
+_MODE=$(jq -r '.mode // empty' egregore.json 2>/dev/null)
+if [ -n "$_API_URL" ] && [ "$_MODE" != "local" ]; then
+  ORG_NAME=$(jq -r '.org_name // .slug' egregore.json)
+  bash bin/publish-artifact.sh board memory/board/board.json \
+    --id board \
+    --title "Project Board — $ORG_NAME" \
+    --author "$ORG_NAME" \
+    --description "Latest board for $ORG_NAME" 2>/dev/null &
+fi
+```
+
+The local artifact remains the successful result if publishing fails. In local
+mode, do not call graph or notification services.
+
+## Report
+
+Return only the useful receipt after the browser opens:
+
+```text
+✓ Artifact opened in browser
+  File: /tmp/egregore-artifacts/<rendered-file>.html
+```
+
+For a connected board, append:
+
+```text
+◆ https://egregore.xyz/view/<org-slug>/board   (stable — refresh for latest)
+```
+
+Emit telemetry best-effort after completion:
+
+```bash
+bash bin/telemetry.sh emit "command" '{"command":"view"}' 2>/dev/null &
+```
+
+## Rules
+
+- Keep filesystem resolution sufficient in local mode; the graph is optional.
+- Preserve auto-linked backtick references handled by
+  `bin/publish-references.sh` when publishing markdown.
+- Never install a global renderer package as the first choice.
+- Never call the deprecated `egregore-handoff` CLI.
+- Never claim publishing succeeded unless a URL was actually returned.

package/runtime/codex/.codex/skills/view/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Egregore View"
+  short_description: "Render Egregore artifacts in the browser"
+  default_prompt: "Use $view to render this as a branded browser artifact."

package/runtime/codex/.codex/skills/view/assets/compose-scaffold.html

@@ -0,0 +1,221 @@
+<!DOCTYPE html>
+<!--
+  EGREGORE COMPOSITION SCAFFOLD — the reusable chrome + component kit for
+  band-5 composed artifacts (`$view <doc> --compose`).
+
+  How to use: copy this file, then
+    1. fill <title>, the manifest `register`/`grammar`, nav brand + links,
+       the hero (series / h1 / standfirst / chips), and the footer.
+    2. replace the <!-- COMPONENTS: … --> region with composed sections built
+       from the component kit below — do NOT mirror the markdown; transform
+       the substance into the grammar (statement titles, panels, cards, …).
+    3. every theme-sensitive color MUST be a var(--token). Never inline hex
+       in content — dark mode breaks. The kit already does this.
+  The token blocks (vellum/nocturne) + toggle JS are complete — leave them.
+-->
+<html lang="en" data-theme="vellum" data-theme-pair="meridian" data-theme-mode="auto">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<title>__TITLE__ — Egregore</title>
+<link rel="preconnect" href="https://fonts.googleapis.com">
+<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
+<link href="https://fonts.googleapis.com/css2?family=Fraunces:ital,opsz,wght@0,9..144,300..900;1,9..144,400..700&family=Hanken+Grotesk:wght@400;500;600;700&family=IBM+Plex+Mono:wght@400;500;600&display=swap" rel="stylesheet">
+<script type="application/json" id="egregore-design-manifest">{"system":"egregore-design-convention","version":"0.3.0","lineage":"meridian","pair":"meridian","mode":"auto","resolvedTheme":"vellum","target":"browser","register":"__REGISTER__","grammar":"__GRAMMAR__","composed":true}</script>
+<style>
+:root{--serif:"Fraunces",Georgia,serif;--sans:"Hanken Grotesk",system-ui,sans-serif;--mono:"IBM Plex Mono",ui-monospace,monospace;--ease:cubic-bezier(.22,.61,.36,1)}
+[data-theme="vellum"]{--paper:#eceef2;--paper-2:#e2e6ec;--card:#f8fafc;--ink:#15212e;--ink-soft:#4d5a68;--ink-faint:#8492a0;--line:#cbd4de;--line-soft:#dde3ea;--prussian:#2c4a6b;--prussian-bright:#3f74ad;--brass:#9a7521;--brass-bright:#c0962f;--teal:#1d7a6e;--rose:#a8493e;--t1:#9a7521;--t1-bg:#f3ead0;--t2:#1d7a6e;--t2-bg:#ddefea;--t3:#a8493e;--t3-bg:#f4ddd7;--contour:#bcc6d2;--shadow:0 1px 2px rgba(21,33,46,.06),0 12px 34px -18px rgba(21,33,46,.34)}
+[data-theme="nocturne"]{--paper:#0e151d;--paper-2:#131c26;--card:#18222e;--ink:#e7ecf2;--ink-soft:#aab6c2;--ink-faint:#76838f;--line:#2a3744;--line-soft:#202b36;--prussian:#5b8cc0;--prussian-bright:#7aa9d8;--brass:#d8b25a;--brass-bright:#e7c878;--teal:#3fb0a0;--rose:#d2796b;--t1:#d8b25a;--t1-bg:#2c2616;--t2:#3fb0a0;--t2-bg:#152b29;--t3:#d2796b;--t3-bg:#2c1c18;--contour:#283543;--shadow:0 1px 2px rgba(0,0,0,.4),0 18px 40px -20px rgba(0,0,0,.7)}
+[data-theme="loam"]{--paper:#f0ece2;--paper-2:#e7e1d3;--card:#faf7f0;--ink:#241d12;--ink-soft:#5c4f3a;--ink-faint:#8f8168;--line:#d3c9b4;--line-soft:#e2dac8;--prussian:#5a6b3a;--brass:#9a6b21;--teal:#3a7a5c;--rose:#a85a3e;--t1:#9a6b21;--t1-bg:#efe2c8;--t2:#3a7a5c;--t2-bg:#dcebe0;--t3:#a85a3e;--t3-bg:#f2ded4;--contour:#c8bca0;--shadow:0 1px 2px rgba(36,29,18,.06),0 12px 34px -18px rgba(36,29,18,.3)}
+
+/* ── base ── */
+*{box-sizing:border-box;margin:0;padding:0}
+html{scroll-behavior:smooth}
+body{background:var(--paper);color:var(--ink);font-family:var(--sans);font-size:16.5px;line-height:1.62;-webkit-font-smoothing:antialiased;transition:background .3s var(--ease),color .3s var(--ease)}
+a{color:var(--prussian-bright);text-decoration:none}
+.wrap{max-width:1080px;margin:0 auto;padding:0 32px}
+.col{max-width:860px}
+.contours{position:fixed;inset:0;z-index:0;pointer-events:none;opacity:.5}
+.contours path{fill:none;stroke:var(--contour);stroke-width:1}
+main{position:relative;z-index:1}
+.rule{border:none;border-top:1px solid var(--line-soft);margin:60px 0 0}
+code{font-family:var(--mono);font-size:.82em;background:var(--paper-2);border:1px solid var(--line-soft);border-radius:5px;padding:1px 6px;color:var(--prussian-bright)}
+p{color:var(--ink-soft)} p b,li b,.lede b{color:var(--ink);font-weight:600}
+
+/* ── nav (sticky section rail) ── */
+nav{position:sticky;top:0;z-index:50;display:flex;align-items:center;gap:28px;padding:13px 32px;background:color-mix(in srgb,var(--paper) 86%,transparent);backdrop-filter:blur(12px);-webkit-backdrop-filter:blur(12px);border-bottom:1px solid var(--line-soft)}
+nav .brand{font:500 .68rem/1 var(--mono);letter-spacing:2px;text-transform:uppercase;color:var(--ink-soft);white-space:nowrap}
+nav .brand b{color:var(--prussian-bright);font-weight:600}
+nav .links{display:flex;gap:20px;margin-left:auto;overflow-x:auto;scrollbar-width:none}
+nav .links::-webkit-scrollbar{display:none}
+nav .links a{font:400 .7rem/1 var(--mono);color:var(--ink-soft);white-space:nowrap;padding:4px 0;border-bottom:1px solid transparent}
+nav .links a:hover{color:var(--ink);border-bottom-color:var(--t1)}
+.toggle{flex:0 0 auto;font:500 .66rem/1 var(--mono);letter-spacing:.5px;color:var(--ink-soft);background:var(--card);border:1px solid var(--line);border-radius:20px;padding:6px 12px;cursor:pointer}
+.toggle:hover{color:var(--ink);border-color:var(--ink-faint)}
+
+/* ── hero ── */
+header.hero{padding:92px 0 60px}
+.series{display:flex;align-items:center;gap:14px;font:500 .7rem/1 var(--mono);letter-spacing:2.5px;text-transform:uppercase;color:var(--t1);margin-bottom:32px}
+.series::before{content:"";width:44px;height:1px;background:var(--t1)}
+h1{font-family:var(--serif);font-weight:420;font-size:clamp(2.6rem,5.4vw,4rem);line-height:1.06;letter-spacing:-.02em;max-width:19ch}
+h1 em{font-style:italic;font-weight:430;color:var(--prussian-bright)}
+.standfirst{font-family:var(--serif);font-style:italic;font-size:1.3rem;line-height:1.44;color:var(--ink-soft);max-width:56ch;margin:26px 0 28px}
+
+/* ── section frame ── */
+section{padding:72px 0 6px}
+.seclabel{display:flex;align-items:center;gap:10px;font:500 .72rem/1 var(--mono);letter-spacing:2.5px;text-transform:uppercase;color:var(--t1);margin-bottom:16px}
+.seclabel .n{display:inline-flex;align-items:center;justify-content:center;width:24px;height:24px;border:1px solid var(--t1);border-radius:50%;font-size:.62rem}
+h2{font-family:var(--serif);font-weight:430;font-size:clamp(1.9rem,3.4vw,2.6rem);line-height:1.12;letter-spacing:-.015em;max-width:24ch;margin-bottom:12px}
+.lede{font-size:1.05rem;color:var(--ink-soft);max-width:62ch;margin-bottom:24px}
+
+/* ── chips / pills / badges ── */
+.chips{display:flex;flex-wrap:wrap;gap:9px}
+.chip{font:500 .68rem/1 var(--mono);letter-spacing:.4px;padding:7px 13px;border-radius:20px;border:1px solid var(--line);background:var(--card);color:var(--ink-soft);white-space:nowrap}
+.chip.ok{border-color:var(--t2);color:var(--t2)} .chip.ok::before{content:"● ";font-size:.6rem}
+.chip.brass{border-color:var(--t1);color:var(--t1)} .chip.brass::before{content:"◇ ";font-size:.66rem}
+.chip.warn{border-color:var(--t3);color:var(--t3)}
+.bd{display:inline-flex;align-items:center;gap:5px;font:600 .64rem/1 var(--mono);letter-spacing:.4px;text-transform:uppercase;padding:3px 8px;border-radius:5px;white-space:nowrap}
+.bd.ok{background:var(--t2-bg);color:var(--t2)} .bd.half{background:var(--t1-bg);color:var(--t1)} .bd.no{background:var(--t3-bg);color:var(--t3)} .bd.neu{background:var(--paper-2);color:var(--ink-faint)}
+
+/* ── claim / stat cards ── */
+.claims{display:grid;grid-template-columns:repeat(3,1fr);gap:16px;margin:26px 0 8px}
+.claims.four{grid-template-columns:repeat(4,1fr)} .claims.two{grid-template-columns:1fr 1fr}
+@media(max-width:760px){.claims,.claims.four,.claims.two{grid-template-columns:1fr 1fr}}
+.claim{background:var(--card);border:1px solid var(--line-soft);border-radius:12px;padding:20px 22px;box-shadow:var(--shadow)}
+.claim .v{font-family:var(--serif);font-size:1.55rem;line-height:1.1;color:var(--t1)}
+.claim.teal .v{color:var(--t2)} .claim.rose .v{color:var(--t3)}
+.claim .l{font-size:.84rem;color:var(--ink-soft);margin-top:8px;line-height:1.5}
+
+/* ── labeled tag card ── */
+.tagcard{background:var(--card);border:1px solid var(--line-soft);border-radius:14px;padding:22px 26px;margin:14px 0;box-shadow:var(--shadow)}
+.tagcard .tag{display:inline-block;font:600 .62rem/1 var(--mono);letter-spacing:1.5px;text-transform:uppercase;color:#fff;border-radius:6px;padding:5px 9px;margin-right:12px;vertical-align:2px;background:var(--prussian)}
+.tagcard .tag.teal{background:var(--teal)} .tagcard .tag.rose{background:var(--rose)} .tagcard .tag.brass{background:var(--brass)}
+.tagcard h3{display:inline;font-family:var(--serif);font-weight:500;font-size:1.16rem}
+.tagcard p{margin-top:12px;font-size:.95rem}
+.tagcard .verdict{margin-top:12px;font:600 .74rem/1.5 var(--mono);letter-spacing:.3px}
+.tagcard .verdict.ok{color:var(--t2)} .tagcard .verdict.no{color:var(--t3)}
+
+/* ── comparison panels (2–3 up) ── */
+.panels{display:grid;grid-template-columns:1fr 1fr;gap:18px;margin:26px 0 10px}
+.panels.three{grid-template-columns:repeat(3,1fr)}
+@media(max-width:760px){.panels,.panels.three{grid-template-columns:1fr}}
+.panel{border:1px solid var(--line);border-radius:14px;overflow:hidden;background:var(--card);box-shadow:var(--shadow);display:flex;flex-direction:column}
+.panel .ph{font:600 .7rem/1 var(--mono);letter-spacing:1.5px;text-transform:uppercase;color:#fff;padding:13px 18px;background:var(--prussian)}
+.panel.b .ph{background:var(--teal)} .panel.c .ph{background:var(--ink-faint)} .panel.warn .ph{background:var(--rose)}
+.panel .pb{padding:16px 20px;font-size:.9rem;color:var(--ink-soft);flex:1}
+.panel .pb b{color:var(--ink)}
+.panel .price{font-family:var(--serif);font-size:1.3rem;color:var(--t1);margin:2px 0 10px}
+.panel ul{list-style:none;margin-top:8px} .panel li{padding:5px 0 5px 18px;position:relative;line-height:1.5}
+.panel li::before{content:"";position:absolute;left:2px;top:12px;width:5px;height:5px;border-radius:50%;background:var(--t1)}
+.panel .pr{display:grid;grid-template-columns:110px 1fr;gap:12px;padding:11px 0;border-bottom:1px solid var(--line-soft)}
+.panel .pr:last-child{border-bottom:none} .panel .pr .k{font:500 .68rem/1.4 var(--mono);color:var(--ink-faint);text-transform:uppercase;letter-spacing:.4px}
+.panel .pf{padding:12px 20px;border-top:1px solid var(--line-soft);font:500 .68rem/1.5 var(--mono);color:var(--ink-faint)}
+.verdict-band{background:var(--t2-bg);border:1px solid var(--t2);border-radius:12px;padding:16px 22px;font:500 .82rem/1.7 var(--mono);color:var(--ink)}
+.verdict-band b{color:var(--t2)}
+
+/* ── highlight callout ── */
+.hl{background:var(--t2-bg);border:1px solid var(--t2);border-radius:14px;padding:22px 26px;margin:18px 0}
+.hl.brass{background:var(--t1-bg);border-color:var(--t1)} .hl.rose{background:var(--t3-bg);border-color:var(--t3)}
+.hl .k{font:600 .66rem/1 var(--mono);letter-spacing:1.5px;text-transform:uppercase;color:var(--t2)}
+.hl.brass .k{color:var(--t1)} .hl.rose .k{color:var(--t3)}
+.hl h3{font-family:var(--serif);font-weight:500;font-size:1.3rem;margin:8px 0 10px}
+.hl p{font-size:.96rem} .hl .num{font-family:var(--serif);font-style:italic;color:var(--ink)}
+
+/* ── Q/A ledger ── */
+.ledger{margin:24px 0;border-top:1px solid var(--line)}
+.ledger .row{display:grid;grid-template-columns:230px 1fr;gap:24px;padding:16px 4px;border-bottom:1px solid var(--line-soft)}
+@media(max-width:680px){.ledger .row{grid-template-columns:1fr}}
+.ledger .q{font:500 .78rem/1.5 var(--mono);color:var(--ink-faint);padding-top:3px}
+.ledger .a{font-size:.95rem;color:var(--ink-soft)} .ledger .a b{color:var(--ink)}
+
+/* ── numbered steps ── */
+.steps{margin:24px 0;counter-reset:st}
+.step{display:grid;grid-template-columns:40px 1fr;gap:16px;padding:14px 0;border-bottom:1px solid var(--line-soft)}
+.step:last-child{border-bottom:none}
+.step .b{counter-increment:st;font-family:var(--serif);font-size:1.25rem;color:var(--t1)} .step .b::before{content:counter(st,decimal-leading-zero)}
+.step h4{font-family:var(--serif);font-weight:500;font-size:1.05rem;margin-bottom:3px} .step h4 .min{font:500 .64rem/1 var(--mono);color:var(--ink-faint);letter-spacing:.5px;margin-left:8px}
+.step p{font-size:.9rem}
+
+/* ── feature rows w/ trailing badges ── */
+.feat{display:grid;grid-template-columns:1fr auto;gap:14px 20px;align-items:baseline;padding:14px 0;border-bottom:1px solid var(--line-soft)}
+.feat:last-child{border-bottom:none} .feat .fx{font-size:.98rem;color:var(--ink-soft)} .feat .fx b{color:var(--ink);font-weight:600}
+.feat .fb{display:flex;gap:6px;flex-wrap:wrap;justify-content:flex-end}
+
+/* ── checkbox thread list (decisions) ── */
+.threads{list-style:none;margin:24px 0}
+.threads li{display:flex;gap:14px;padding:12px 0;border-bottom:1px solid var(--line-soft);font-size:.98rem;color:var(--ink-soft);align-items:baseline}
+.threads li::before{content:"";flex:0 0 auto;width:12px;height:12px;border:1.5px solid var(--t1);border-radius:3px;transform:translateY(1px)}
+.threads b{color:var(--ink)}
+
+/* ── gap / negative callout ── */
+.gap{background:var(--t3-bg);border:1px solid var(--t3);border-radius:14px;padding:22px 26px;margin:22px 0}
+.gap h3{font-family:var(--serif);font-weight:500;font-size:1.15rem;color:var(--t3);margin-bottom:12px}
+.gap ul{list-style:none} .gap li{padding:5px 0 5px 20px;position:relative;font-size:.94rem;color:var(--ink-soft)}
+.gap li::before{content:"×";position:absolute;left:2px;color:var(--t3);font-weight:600} .gap li b{color:var(--ink)}
+
+/* ── status / summary table ── */
+.sumtable{width:100%;border-collapse:collapse;margin:24px 0;font-size:.9rem}
+.sumtable th{text-align:left;font:600 .64rem/1 var(--mono);letter-spacing:.8px;text-transform:uppercase;color:var(--ink-faint);padding:0 12px 12px;border-bottom:1px solid var(--line)}
+.sumtable th.c,.sumtable td.c{text-align:center}
+.sumtable td{padding:11px 12px;border-bottom:1px solid var(--line-soft);color:var(--ink-soft);vertical-align:middle}
+.sumtable tr td:first-child{color:var(--ink);font-weight:500}
+.sumtable .tier{font:500 .64rem/1 var(--mono);text-transform:uppercase;letter-spacing:.4px;color:var(--ink-faint)}
+.dot{display:inline-block;width:18px;height:18px;line-height:18px;border-radius:50%;font-size:.72rem;font-weight:700}
+.dot.ok{background:var(--t2-bg);color:var(--t2)} .dot.half{background:var(--t1-bg);color:var(--t1)} .dot.no{background:var(--t3-bg);color:var(--t3)} .dot.neu{background:var(--paper-2);color:var(--ink-faint)}
+
+/* ── accent-left readout ── */
+.readout{background:var(--card);border:1px solid var(--line);border-left:3px solid var(--t1);border-radius:4px;padding:20px 24px;margin:28px 0;font-size:1rem;color:var(--ink-soft)}
+.readout b{color:var(--ink)}
+
+/* ── footer ── */
+footer{padding:64px 0 90px;font:400 .74rem/1.8 var(--mono);color:var(--ink-faint)}
+footer .tags{display:flex;gap:10px;flex-wrap:wrap;margin-top:12px}
+footer .tg{border:1px solid var(--line-soft);border-radius:6px;padding:3px 10px;background:var(--card)}
+</style>
+</head>
+<body>
+<svg class="contours" width="100%" height="100%" preserveAspectRatio="none" viewBox="0 0 1400 900"><path d="M-50,160 C300,90 700,240 1450,130"/><path d="M-50,440 C400,360 900,540 1450,420"/><path d="M-50,720 C350,660 800,820 1450,710"/></svg>
+<main>
+<nav>
+  <span class="brand">EGREGORE · <b>__BRAND__</b></span>
+  <div class="links"><!-- NAV: one <a href="#anchor">Short label</a> per section --></div>
+  <button class="toggle" onclick="__t()">◐ <span id="tl">nocturne</span></button>
+</nav>
+
+<div class="wrap col">
+
+<header class="hero">
+  <div class="series">__SERIES_KICKER__</div>
+  <h1>__LEAD__. <em>__ACCENT_PHRASE__</em></h1>
+  <p class="standfirst">__STANDFIRST__</p>
+  <div class="chips"><!-- CHIPS: from status/meta --></div>
+</header>
+
+<!-- COMPONENTS: compose sections here. Each section:
+     <hr class="rule"><section id="anchor">
+       <div class="seclabel"><span class="n">01</span> LABEL</div>
+       <h2>Statement title — the finding, not the raw heading.</h2>
+       … pick from the kit: .ledger .tagcard .claims .panels+.verdict-band
+       .hl .steps .feat .threads .gap .sumtable .readout …
+     </section>
+-->
+
+<footer>
+  __FOOTER_LINE__
+  <div class="tags"><span class="tg">__KIND__</span><span class="tg">__AUTHOR__</span><span class="tg">ugi · __TRAIL__</span><span class="tg">composed</span></div>
+</footer>
+
+</div>
+</main>
+<script>
+(function(){
+  var saved=localStorage.getItem('eg-theme-mode');
+  var prefersDark=window.matchMedia('(prefers-color-scheme: dark)').matches;
+  var t=saved==='dark'||(saved!=='light'&&prefersDark)?'nocturne':'vellum';
+  apply(t);
+  window.__t=function(){apply(document.documentElement.dataset.theme==='vellum'?'nocturne':'vellum',true)};
+  function apply(theme,persist){document.documentElement.dataset.theme=theme;var el=document.getElementById('tl');if(el)el.textContent=theme==='vellum'?'nocturne':'vellum';if(persist)localStorage.setItem('eg-theme-mode',theme==='nocturne'?'dark':'light')}
+})();
+</script>
+</body>
+</html>

package/runtime/codex/.codex/spec-manifest.json

@@ -77,13 +77,13 @@
     {
       "section": "Working Conventions",
       "action": "keep",
-      "sourceHash": "37a5318e9ee0",
+      "sourceHash": "2e4ec18b72a6",
       "note": "Kept verbatim."
     },
     {
       "section": "Command Awareness",
       "action": "keep",
-      "sourceHash": "d3ea48ebf938",
+      "sourceHash": "e1db878ccaee",
       "note": "Prepended the Codex command surface (skill tokens, native vs adapter split, $save abstraction); disambiguation map kept with /x -> $x token rendering. Tokens with no Codex skill (e.g. /loop, a Claude Code harness feature) are left as-is."
     },
     {
@@ -95,7 +95,7 @@
     {
       "section": "Telemetry",
       "action": "keep",
-      "sourceHash": "f8b242d0fd64",
+      "sourceHash": "f45afa2da8ac",
       "note": "Kept verbatim — bin/telemetry.sh is runtime-neutral."
     },
     {

package/runtime/codex/AGENTS.md

@@ -29,6 +29,12 @@ portable memory protocol below.
 Use the runtime-neutral bridge instead of Claude Code slash commands:
 
 ```bash
+bin/agent.sh branch --topic "auth review"
+bin/agent.sh save --message "Save: auth review" --topic "auth review"
+bin/agent.sh wrap --from alice --topic "auth review" \
+  --summary "Implemented the OAuth callback parser and documented follow-ups." \
+  --body "Open threads: review error cases and browser redirects."
+
 bin/agent.sh handoff --from alice --to bob --topic "auth review" \
   --body "Implemented the OAuth callback parser. Bob should review error cases."
 
@@ -44,6 +50,17 @@ Each command writes to the existing Git-backed `memory/` repository and pushes
 when the memory repo has an `origin` remote. Agents that cannot run shell may
 write the same markdown files directly, following `docs/AGENT-PROTOCOL.md`.
 
+## Handoffs vs Emissaries
+
+`bin/agent.sh handoff` is the runtime-neutral path for internal team
+session-handoffs: it writes to `memory/handoffs/`, updates the index, and uses
+the same `bin/handoff-run.sh` machinery as Claude Code's `/handoff`.
+
+Portable external capsules are **emissaries**, not team handoffs. Claude Code
+routes those through `/emissary`; non-Claude agents should use the
+`egregore-emissary` CLI/skill when it is installed. Do not use the deprecated
+`egregore-handoff` CLI for Egregore project `/handoff` work.
+
 ## Compatibility
 
 Claude Code users continue using `/handoff`, `/activity`, `/ask`, `/save`, and
@@ -230,7 +247,7 @@ Repos in `egregore.json` → `repos[]` are cloned as siblings (`../{repo}/`). Ea
 
 ## Working Conventions
 
-- Check `memory/knowledge/` before starting unfamiliar work
+- Check memory before starting unfamiliar work — `bash bin/search.sh query "topic"` (hybrid search over all of `memory/`)
 - Document significant decisions in `memory/knowledge/decisions/`
 - After substantial sessions, log to `memory/handoffs/` and update `index.md`
 
@@ -238,12 +255,12 @@ Repos in `egregore.json` → `repos[]` are cloned as siblings (`../{repo}/`). Ea
 
 ## Command Awareness
 
-Codex reserves leading `/` for built-ins, so Egregore workflows are **skills**, not slash commands. Invoke them with the matching `$name` skill token or from natural language intent ("show activity", "make a handoff"). Hand-written native Codex skills: `$activity`, `$handoff`, `$wrap`, `$announce`, `$harvest`, `$the-spiral`, `$dashboard`, `$deep-reflect`, `$quest`, `$invite`, `$ask`, `$save`. Every other workflow has a generated adapter skill of the same name. `$save` is the user-facing abstraction for committing, pushing, opening or reusing pull requests, and syncing memory — never make users manage the git workflow by hand.
+Codex reserves leading `/` for built-ins, so Egregore workflows are **skills**, not slash commands. Invoke them with the matching `$name` skill token or from natural language intent ("show activity", "make a handoff"). Hand-written native Codex skills: `$activity`, `$handoff`, `$wrap`, `$announce`, `$harvest`, `$the-spiral`, `$dashboard`, `$deep-reflect`, `$quest`, `$invite`, `$ask`, `$save`, `$view`, and `$scroll`. Every other workflow has a generated adapter skill of the same name. `$save` is the user-facing abstraction for committing, pushing, opening or reusing pull requests, and syncing memory — never make users manage the git workflow by hand.
 
 Invoke commands from user intent — don't wait for the slash. Each command file has a `## When to invoke` section. Load it for the full spec.
 
 **Core loop** — `$activity` `$dashboard` `$handoff` `$wrap` `$save` `$reflect` `$todo`
-**Knowledge** — `$deep-reflect` `$archive` `$note` `$add` `$meeting` `$ingest`
+**Knowledge** — `$search` `$deep-reflect` `$archive` `$note` `$add` `$meeting` `$ingest` `$scroll`
 **Identity** — `$me` (view profile or set display name)
 **Coordination** — `$ask` `$quest` `$issue` `$invite` `$delete-user` `$announce`
 **Connectors** — `$telegram-connect` (Telegram group setup)
@@ -253,6 +270,9 @@ Invoke commands from user intent — don't wait for the slash. Each command file
 
 **Disambiguation:**
 - Knowledge: `$reflect` (share-ready) · `$note` (half-baked) · `$deep-reflect` (cross-reference) · `$archive` (AI patterns)
+- Finding things — the retrieval layers: **Grep/ls** (Claude Code / Codex file ops — always available, OSS) · **`bin/graph.sh`** (indexed relevance + relationships/status — paid). Use grep proactively; the graph deepens it when connected. (Semantic `$search` is dormant — evals showed it only pays off on massive unstructured data.)
+- Finding **something you generated** (a scroll, handoff, emissary, decision, any hosted egregore.xyz link): `bash bin/artifacts.sh find <query>`. Every generative surface already records into memory — hosted artifacts self-register into `memory/artifacts/` at publish (and the record is committed+pushed, so it's findable from *any* session, not just the one that made it); handoffs land in `memory/handoffs/`, emissaries in `memory/handoffs/outbound/`, decisions/findings/patterns in `memory/knowledge/`. The finder searches **all** of them, ranks title/topic matches above passing body mentions, tags each hit by type (`[document]`/`[handoff]`/`[emissary]`/`[decision]`), and surfaces the shareable URL. Findable by **content, not just name**, across all three layers — grep-first for OSS, folding in search + graph when available. *"bring me the artifact where I laid out our GTM plan"* → this.
+- Artifacts with questions: `$scroll` (living paper + embedded harvest, updates in place) · `$view` (static render) · `$harvest` (elicitation, no published face)
 - Status: `$dashboard` (personal) · `$activity` (org-wide)
 - Ending: `$wrap` (personal closure) · `$handoff` (notes for others) · `$save` (still working)
 - Tasks: `$todo` (personal) · `$quest` (team exploration) · `$issue` (something broken)
@@ -284,6 +304,7 @@ Privacy-respecting, opt-out telemetry. After every slash command, emit fire-and-
 `bash bin/telemetry.sh emit "command" '{"command":"save"}' 2>/dev/null &`
 
 Never collected: file contents, code, env var values, conversation content.
+Command events may carry optional model/tier/routing/duration fields per `.claude/context/telemetry.md`.
 On first session (if `telemetry_noticed` not set in state file), mention the notice once, then set `telemetry_noticed: true`. Full spec: `.claude/context/telemetry.md`.
 
 ---

package/runtime/codex/bin/activity-data.sh

@@ -13,6 +13,8 @@ API_KEY=$(grep '^EGREGORE_API_KEY=' "$SCRIPT_DIR/.env" 2>/dev/null | cut -d'=' -
 ORG=$(jq -r '.org_name // "Egregore"' "$SCRIPT_DIR/egregore.json" 2>/dev/null || echo "Egregore")
 DATE=$(date '+%b %d')
 
+source "$SCRIPT_DIR/bin/lib/handoff-meta.sh" >/dev/null 2>/dev/null || true
+
 # --- Detect user ---
 GH_USER="${1:-}"
 if [ -z "$GH_USER" ]; then
@@ -159,8 +161,8 @@ PRS=$(cat "$TMPDIR/prs.json" 2>/dev/null || echo "[]")
 echo "$PRS" | jq . >/dev/null 2>&1 || PRS="[]"
 
 # Resolve PR author GitHub logins -> egregore display names. `gh pr list` returns
-# the raw github login (e.g. "fcdagdelen"); without this it leaks into activity
-# instead of the person's display name ("cem"). Map via the graph when connected;
+# the raw github login (e.g. "alice-gh"); without this it leaks into activity
+# instead of the person's display name ("Alice"). Map via the graph when connected;
 # fall back to the github profile name, then the login. Author becomes a string.
 if [ -n "$PRS" ] && [ "$PRS" != "[]" ]; then
   AUTHOR_MAP='{}'
@@ -182,8 +184,28 @@ DISK_DECISIONS=$(cat "$TMPDIR/disk_decisions.txt" 2>/dev/null || echo "")
 LOCAL_SESSIONS=$(cat "$TMPDIR/local_sessions.json" 2>/dev/null || echo '{"my_sessions":[],"team_sessions":[]}')
 echo "$LOCAL_SESSIONS" | jq . >/dev/null 2>&1 || LOCAL_SESSIONS='{"my_sessions":[],"team_sessions":[]}'
 
+handoff_metadata_map() {
+  local json="$1"
+
+  if ! declare -F eg_handoff_metadata_json >/dev/null 2>&1; then
+    echo "{}"
+    return
+  fi
+
+  printf '%s\n' "$json" | jq -r '
+    [(.handoffs_to_me[]?.filePath // empty), (.all_handoffs[]?.filePath // empty)]
+    | map(select(. != ""))
+    | unique[]
+  ' 2>/dev/null | while IFS= read -r rel; do
+    [ -z "$rel" ] && continue
+    file="$SCRIPT_DIR/memory/$rel"
+    [ -f "$file" ] || continue
+    eg_handoff_metadata_json "$file" | jq -c --arg rel "$rel" '{key:$rel, value:{author:.author, topic:.topic, date:.date}}'
+  done | jq -sc 'map({(.key): .value}) | add // {}' 2>/dev/null || echo "{}"
+}
+
 # --- Merge server response + local git/disk data ---
-jq -n \
+FINAL_JSON=$(jq -n \
   --arg org "$ORG" \
   --arg date "$DATE" \
   --slurpfile activity "$TMPDIR/activity.json" \
@@ -197,4 +219,24 @@ jq -n \
     prs: $prs,
     disk: {handoffs: $disk_handoffs, decisions: $disk_decisions},
     local_sessions: $local_sessions
-  }'
+  }')
+
+HANDOFF_META="$(handoff_metadata_map "$FINAL_JSON")"
+[ -z "$HANDOFF_META" ] && HANDOFF_META="{}"
+
+printf '%s\n' "$FINAL_JSON" | jq --argjson handoff_meta "$HANDOFF_META" '
+  def enrich_handoff_sender:
+    (.filePath // "") as $file
+    | if $file != "" and ($handoff_meta[$file] // null) != null then
+        ($handoff_meta[$file] // {}) as $meta
+        | .author = ($meta.author // .author)
+        | .from = ($meta.author // .from)
+        | .topic = (.topic // $meta.topic)
+        | .date = (.date // $meta.date)
+      else
+        .
+      end;
+
+  .handoffs_to_me = ((.handoffs_to_me // []) | map(enrich_handoff_sender))
+  | .all_handoffs = ((.all_handoffs // []) | map(enrich_handoff_sender))
+'

package/runtime/codex/bin/agent.sh

@@ -28,6 +28,8 @@ Runtime-neutral commands:
   protocol                         Print the portable agent protocol
   sync                             Pull latest shared memory
   activity [--for <person>]        Show recent handoffs and questions
+  search "query" [-n N] [--fast|--semantic]
+                                   Hybrid recall over shared memory (qmd)
   people                           List known people from memory/people
   branch --topic TEXT              Create or reuse a task branch/worktree
   save [--message TEXT]            Commit and push current repo + memory changes
@@ -165,8 +167,9 @@ Egregore portable agent protocol
 4. Use `bin/agent.sh handoff` to leave structured context for another agent.
 5. Use `bin/agent.sh ask` and `bin/agent.sh answer` for asynchronous questions.
 6. Run `bin/agent.sh activity --for <person>` to see pending work.
-7. Run `bin/agent.sh branch --topic "<what you are working on>"` before code changes when you need a task branch/worktree.
-8. Run `bin/agent.sh save` and `bin/agent.sh wrap` for portable save/wrap flows.
+7. Run `bin/agent.sh search "<query>"` to recall shared memory (decisions, handoffs, knowledge) before answering questions about past work.
+8. Run `bin/agent.sh branch --topic "<what you are working on>"` before code changes when you need a task branch/worktree.
+9. Run `bin/agent.sh save` and `bin/agent.sh wrap` for portable save/wrap flows.
 
 This protocol is runtime-neutral. Claude Code may still use .claude hooks and
 skills, while Codex or another agent can call this script directly.
@@ -653,11 +656,16 @@ cmd_answer() {
   echo "answered: memory/$rel"
 }
 
+cmd_search() {
+  bash "$SCRIPT_DIR/bin/search.sh" query "$@"
+}
+
 case "${1:-}" in
   --help|-h|help|"") usage ;;
   protocol) shift; cmd_protocol "$@" ;;
   sync) shift; cmd_sync "$@" ;;
   activity) shift; cmd_activity "$@" ;;
+  search) shift; cmd_search "$@" ;;
   people) shift; cmd_people "$@" ;;
   branch) shift; cmd_branch "$@" ;;
   save) shift; cmd_save "$@" ;;