create-egregore 0.19.3 → 0.19.6

package/runtime/pi/.codex/skills/project/SKILL.md

@@ -0,0 +1,41 @@
+---
+name: project
+description: 'Fallback Codex adapter for the Egregore project workflow.'
+---
+
+<!-- generated-by: bin/codex-sync-skills.sh -->
+
+# Egregore project Adapter
+
+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.
+
+## Structured UX parity
+
+This workflow has a Claude skill with user-visible structured output. After
+reading `.claude/skills/project/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/project/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.

package/runtime/pi/.codex/skills/pull/SKILL.md

@@ -0,0 +1,25 @@
+---
+name: pull
+description: 'Fallback Codex adapter for the Egregore pull workflow.'
+---
+
+<!-- generated-by: bin/codex-sync-skills.sh -->
+
+# Egregore pull Adapter
+
+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.
+
+1. Read `.claude/skills/pull/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.

package/runtime/pi/.codex/skills/push/SKILL.md

@@ -0,0 +1,25 @@
+---
+name: push
+description: 'Fallback Codex adapter for the Egregore push workflow.'
+---
+
+<!-- generated-by: bin/codex-sync-skills.sh -->
+
+# Egregore push Adapter
+
+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.
+
+1. Read `.claude/skills/push/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.

package/runtime/pi/.codex/skills/quest/SKILL.md

@@ -0,0 +1,77 @@
+---
+name: quest
+description: Manage Egregore quests from Codex when the user invokes /quest or $quest, or asks to manage quests, using memory-first files and optional connected-mode graph updates.
+---
+
+# Egregore Quest
+
+Native Codex Egregore skill. Quests are shared, open-ended explorations stored
+under `memory/quests/`.
+
+## Flow
+
+1. Run `bin/agent.sh sync`.
+2. Detect mode from `egregore.json` `mode`, defaulting to `connected`.
+3. Dispatch from the user request:
+   - no argument: list active and paused quests from `memory/quests/*.md`.
+   - name or slug: show quest details from the markdown file.
+   - `new`: create a quest.
+   - `contribute`: append a contribution entry.
+   - `prioritize`: set `priority` to `0`, `1`, `2`, or `3`.
+   - `pause`: set `status: paused`.
+   - `complete`: set `status: completed` and record an outcome.
+4. Filesystem writes are canonical. Quest files use frontmatter:
+
+```yaml
+---
+title: Example Quest
+slug: example-quest
+status: active
+projects: []
+started: YYYY-MM-DD
+started_by: handle
+priority: 0
+completed:
+---
+```
+
+5. Update `memory/quests/index.md` after create, status changes, and priority
+   changes.
+6. Commit and push memory immediately:
+
+```bash
+git -C memory add quests
+git -C memory commit -m "quest: $SLUG $ACTION" --quiet
+git -C memory push origin main --quiet
+```
+
+7. In connected mode only, mirror changes best-effort with `bin/graph.sh` and
+   notify named people with `bin/notify.sh send`. If graph or notification
+   fails, report that the quest was saved to memory and continue.
+
+## Interaction
+
+Use structured Codex question tooling when available for new quest fields and
+status confirmations. Otherwise ask one short numbered question at a time with
+an `Other:` option.
+
+## Output
+
+Structured UX parity is required:
+
+- `/quest` list mode renders the active quest table:
+  `| Quest | Project | Artifacts | Contributors |`, followed by paused quest
+  state and entry-point hints.
+- `/quest <name>` detail mode renders the same sectioned view as Egregore:
+  title rule, status, projects, started metadata, question, threads,
+  artifacts, todos when available, contributors, and entry points.
+- Create/update routes use compact structured confirmations with the quest
+  file path and memory push state. Do not substitute a loose prose summary.
+- In local mode, omit graph/notification wording while preserving the same
+  list/detail layout.
+
+## Rules
+
+- Do not use graph or notification calls in local mode.
+- Do not let graph failure block a filesystem quest update.
+- Do not use Claude Code commands.

package/runtime/pi/.codex/skills/quest-suggest/SKILL.md

@@ -0,0 +1,25 @@
+---
+name: quest-suggest
+description: 'Fallback Codex adapter for the Egregore quest-suggest workflow.'
+---
+
+<!-- generated-by: bin/codex-sync-skills.sh -->
+
+# Egregore quest-suggest Adapter
+
+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.
+
+1. Read `.claude/skills/quest-suggest/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.

package/runtime/pi/.codex/skills/reflect/SKILL.md

@@ -0,0 +1,41 @@
+---
+name: reflect
+description: 'Fallback Codex adapter for the Egregore reflect workflow.'
+---
+
+<!-- generated-by: bin/codex-sync-skills.sh -->
+
+# Egregore reflect Adapter
+
+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.
+
+## Structured UX parity
+
+This workflow has a Claude skill with user-visible structured output. After
+reading `.claude/skills/reflect/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/reflect/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.

package/runtime/pi/.codex/skills/review-pr/SKILL.md

@@ -0,0 +1,41 @@
+---
+name: review-pr
+description: 'Fallback Codex adapter for the Egregore review-pr workflow.'
+---
+
+<!-- generated-by: bin/codex-sync-skills.sh -->
+
+# Egregore review-pr Adapter
+
+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.
+
+## Structured UX parity
+
+This workflow has a Claude skill with user-visible structured output. After
+reading `.claude/skills/review-pr/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/review-pr/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.

package/runtime/pi/.codex/skills/save/SKILL.md

@@ -0,0 +1,62 @@
+---
+name: save
+description: Save Egregore work when the user invokes /save or $save, or asks to commit, push, sync, or save current changes from a Codex Egregore session.
+---
+
+# Egregore Save
+
+Native Codex Egregore skill. This is the user-facing abstraction for the git
+and memory workflow: users should be able to say "save this" without knowing
+which branch, commit, push, pull request, or memory sync steps are required.
+
+## Flow
+
+1. Confirm this is an Egregore checkout by checking for `bin/agent.sh`.
+2. Inspect state silently:
+
+```bash
+git status --short
+git status --short memory 2>/dev/null || true
+git branch --show-current
+```
+
+3. If there are no repo or memory changes, say everything is already saved and
+   stop.
+4. Synthesize:
+   - a short topic from the work,
+   - a clear commit message,
+   - a one-line user-facing scope summary.
+5. If the scope is ambiguous or includes unrelated changes, ask for one compact
+   confirmation. Use structured Codex question tooling when available;
+   otherwise render:
+
+```text
+Save these changes?
+1. Save all
+2. Narrow scope
+Other:
+```
+
+6. Run the bridge command:
+
+```bash
+bin/agent.sh save --message "$MESSAGE" --topic "$TOPIC"
+```
+
+The bridge owns the mechanical workflow: sync memory, ensure a task branch,
+commit repo changes, push, and create or reuse a pull request when available.
+
+7. Parse the output and report only useful user information:
+   - branch name,
+   - whether a commit was created,
+   - whether push succeeded,
+   - pull request URL if present,
+   - memory sync status.
+
+## Rules
+
+- Do not ask the user to run git commands.
+- Do not expose implementation detail unless save fails.
+- If save fails, say which step failed and leave the branch/path clear.
+- Never run destructive git commands.
+- Do not use Claude Code commands.

package/runtime/pi/.codex/skills/scroll/SKILL.md

@@ -0,0 +1,168 @@
+---
+name: scroll
+description: 'Compose and tend an Egregore living paper with an explanatory face, embedded decision harvest, stable published URL, and versioned paste-back update loop. Use when the user invokes /scroll or $scroll, asks for a living paper or a spec with questions inside, presents a proposal/architecture/product/feature with open forks, or pastes a versioned scroll decisions return block.'
+---
+
+# Egregore Scroll
+
+Native Codex Egregore skill. Use only inside an Egregore checkout.
+
+A scroll is one self-contained Meridian HTML artifact with two linked views:
+the readable paper and the open decisions living inside it. Every return block
+updates the same artifact at the same stable id.
+
+Use `$view` for a static document with no pending decisions, `$harvest` for
+elicitation without a published explaining face, and a concise question for one
+small fork. A scroll requires all three legs: face, harvest, and update loop.
+
+## Structured UX parity
+
+The browser artifact is the primary output. Preserve both tabs, deep links from
+honest costs into decisions, the versioned copydock fence, stable URL, and local
+source path. Do not substitute a prose-only summary or expose raw publish output.
+
+## Route the invocation
+
+- A normal request creates version 1.
+- A pasted block matching `#<slug>-decisions:v<N>` runs the update loop.
+- If a pasted version is stale, absorb still-applicable answers and state which
+  forks moved after that version.
+
+Run inline with shell and filesystem tools. Do not invoke Claude Code commands
+or Loom delegation.
+
+## Build a new scroll
+
+1. Read the source design, relevant memory, code, and quest context in full.
+2. Derive a stable kebab-case slug of at most 50 characters. Create:
+   - surface id `ds-<date>-<slug>`;
+   - harvest id `harvest-<date>-<slug>`;
+   - a short unique `<prefix>.harvest` browser storage key.
+3. Copy `.codex/skills/scroll/assets/shell.html` into `tmp/<slug>/index.html`.
+   Keep this build source in the worktree so future turns can tend it.
+4. Inject the canonical design-system CSS at build time from
+   `packages/egregore-artifacts/lib/vendor/design-system/dist/egregore-design.css`
+   into `/*__MERIDIAN_CSS__*/`. If the packages tree is unavailable, extract the
+   same path from `egregore-artifacts@latest` rather than freezing tokens.
+5. Fill every placeholder and replace the `__FACE__` and `__HARVEST__` slot
+   comments using the grammar documented in the shell.
+
+### Write the face
+
+Create a light paper, not a transcript dump:
+
+- A paper header with kicker, title, italic subtitle, grounds, date, and
+  `Version vN — updates in place at this URL`.
+- The setting: current reality, load-bearing verified numbers, the gap, and a
+  thesis reframe.
+- Two to four genuinely different mental models that stress-test the design.
+- The machine: concrete anatomy and protocol, using layers, steps, and
+  tokenized SVG figures. Mark illustrative charts `shapes, not measurements`.
+- Consequences for product or practice.
+- Honest costs as cards. Every cost must call `goFork('<fork-id>')` and link to
+  the harvest decision that prices it.
+
+### Write the harvest
+
+Create two to four bands of decision cards. Each card needs:
+
+- a stable fork id, grounded framing, and a reference back into the face;
+- two to four real options, each with one credible advantage and disadvantage;
+- at most one starred lean, presented as a position to challenge;
+- a why textarea whose note returns with the pick.
+
+Add open prompts for material that is not a fork. Prefer questions grounded in
+the work over meta-prompts asking what to ask next. The copydock must emit:
+
+```text
+#<slug>-decisions:v<N>
+surface: <surface-id>
+harvest: <harvest-id>
+date: <date>
+
+Q1 <fork-id>: <key>  ("<label>")   | UNDECIDED
+   note: <why, verbatim>
+O1 <prompt-id>: <text | UNDECIDED>
+```
+
+## Theme and asset constraints
+
+Choose the default theme pair from the primary reader's recorded preference
+when available: `sovereign`/`bedrock`, `meridian`/`nocturne`, or
+`agronomic`/`soil`. Record a newly stated preference in that person's memory
+profile.
+
+Keep theme state on `<html data-theme>` and restore it before paint. In authored
+body content and SVGs, every theme-sensitive fill, stroke, background, border,
+and text color must use `var(--token)`. Do not emit inline hex colors. Preserve
+the shell's persisted palette picker and print/mobile behavior.
+
+Before publishing:
+
+1. Confirm no `__[A-Z_]*__` placeholders remain.
+2. Check tag balance and that every `goFork()` id has one matching
+   `data-decision` card.
+3. Grep authored content for raw hex and resolved inline palette values.
+4. Capture both `file://...` and `file://...#harvest` views and inspect them.
+5. Confirm headings use the intended display face rather than a system serif.
+
+## Publish and record
+
+Publish connected configurations to the permanent slug:
+
+```bash
+bash bin/publish-artifact.sh document tmp/<slug>/index.html --raw-html \
+  --id <slug> --title "<title>" --author "<author>" \
+  --description "<description>"
+```
+
+Verify the returned URL, open it, and report it. Every later version must reuse
+the same `--id`; never mint a new URL for an update. In local mode, publishing
+is unavailable: open the file locally and report the source path without
+suggesting configuration changes.
+
+Add the URL or local path, source location, version, and fence tag to the
+relevant quest's log/artifacts tables. If no quest is relevant, keep the source
+path as the durable record and state it.
+
+## Update loop
+
+On a returned fence:
+
+1. **Absorb.** Parse Q/O lines and notes. Write durable decisions with their
+   reasoning to `memory/knowledge/decisions/`, update the underlying spec or
+   plan, and add connected HarvestTurn records when available. `UNDECIDED` is a
+   valid answer.
+2. **Rewrite the face.** Weave settled answers and reasoning into fresh prose,
+   mark them `decided v<N> · <date>`, and update linked cost cards to accepted,
+   mitigated, or remaining residuals.
+3. **Regenerate the harvest.** Retire answered cards. Carry an undecided fork
+   once at most; after two undecided returns, reframe it or demote it to an open
+   prompt. If its note actually resolves it, absorb the note as the decision.
+   Mint new forks from newly unlocked consequences, respondent requests, and
+   new ground truth.
+4. **Show, then ask.** When abstract forks run dry or the respondent asks for
+   something concrete, place the draft under discussion directly in the
+   harvest view with in-place reaction prompts.
+5. **Version.** Bump every version marker, update the copydock, and append a
+   one-line changelog with absorbed and newly opened forks.
+6. **Republish.** Publish to the same stable id, update the quest record, open
+   the refreshed URL, and state what changed and what the new version asks.
+
+Multiple returns against one version are separate turns. Merge compatible
+answers; turn conflicting choices into a new explicit fork instead of silently
+resolving them.
+
+## Voice and telemetry
+
+Write the face as external-grade Egregore prose: declarative, precise, grounded
+in real numbers, and honest about costs. Put metaphor in visuals rather than
+labels; prefer established terms over coinages.
+
+After completion, emit telemetry best-effort:
+
+```bash
+bash bin/telemetry.sh emit "command" '{"command":"scroll"}' 2>/dev/null &
+```
+
+Never call the deprecated `egregore-handoff` CLI.

package/runtime/pi/.codex/skills/scroll/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Egregore Scroll"
+  short_description: "Compose and tend a living design paper"
+  default_prompt: "Use $scroll to turn this design into a living paper with an embedded decision harvest."