create-egregore 0.19.23 → 0.19.25

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

@@ -1,29 +0,0 @@
----
-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 and publish steps as best-effort unless that workflow explicitly
-   says they are required.
-4. For every external notification, follow
-   `.claude/context/notification-consent.md`: plan without sending, then show
-   a separate exact Send / Edit / Cancel checkpoint. Never infer notification
-   consent from the workflow request or a batch approval.
-5. Keep local-mode behavior filesystem-first and avoid graph or notification
-   calls when `egregore.json` declares `"mode": "local"`.
-6. Never call the deprecated `egregore-handoff` CLI for Egregore project
-   handoffs.

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

@@ -1,45 +0,0 @@
----
-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 and publish steps as best-effort unless that workflow explicitly
-   says they are required.
-4. For every external notification, follow
-   `.claude/context/notification-consent.md`: plan without sending, then show
-   a separate exact Send / Edit / Cancel checkpoint. Never infer notification
-   consent from the workflow request or a batch approval.
-5. Keep local-mode behavior filesystem-first and avoid graph or notification
-   calls when `egregore.json` declares `"mode": "local"`.
-6. Never call the deprecated `egregore-handoff` CLI for Egregore project
-   handoffs.

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

@@ -1,288 +0,0 @@
----
-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 return block, 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 shell's syntax reference and the composition rules below.
-
-### Write the face
-
-Create a light paper that reads as if freshly written by someone who knows
-every absorbed decision, not a transcript with updates appended.
-
-- A paper header with kicker, title, italic subtitle, grounds, date, and
-  `Version vN — updates in place at this URL`.
-- **Setting** is mandatory: orient the reader in current reality, the question
-  or gap, and the thesis; include verified numbers when they carry the claim.
-- **Honest costs** is mandatory: name real tradeoffs, uncertainty, and
-  operational burden. A cost that an open fork can price calls
-  `goFork('<fork-id>')`; settled costs become accepted, mitigated, or residual.
-- Choose every other module by fit: evidence or claims; a concrete machine,
-  anatomy, or protocol; examples or cases; stress tests; consequences;
-  boundaries or alternatives; decision history. For each plausible optional
-  module, be able to say why it is in or out. Never include one because this
-  list names it. A stress test must be able to fail the design.
-- Use tokenized SVG figures where a visual materially helps. Mark illustrative
-  charts `shapes, not measurements`.
-
-### 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;
-- an explicit answer `mode` for new forks; omit it only when preserving a legacy
-  single fork, give every `multi` fork an integer `max`, and give every
-  `spectrum` fork exactly two `ends`;
-- two to four real options for single/multi, each with one credible advantage
-  and disadvantage; 2–5 labeled items for rank, each with the same honest
-  tradeoff pair; or 5–7 fully labeled discrete stops for spectrum;
-- at most one starred lean, presented as a position to challenge;
-- a why textarea whose note returns with the pick.
-
-An option with no credible disadvantage is propaganda. A fork is one open
-question carried across versions by its lineage; it renders as a decision card
-and returns as a `Q<n>` line. A turn is one person's answers to one version.
-Accepted means approved; absorbed means published in a new version.
-
-Read `.codex/skills/harvest/QUESTION_PALETTE.md` for the canonical
-intent-to-shape rules. A multi card uses matching `data-mode="multi"` and
-`data-max="N"` attributes; the runtime exposes checkboxes and enforces the cap.
-A spectrum card uses `data-mode="spectrum"`, matching `data-left`/`data-right`
-poles, and 5–7 native `.sstop` buttons with normalized `data-pos` values and
-non-blank `data-label` values. Do not author a slider or a selected stop.
-Untouched, an explicitly selected midpoint, and UNDECIDED are distinct.
-A rank card uses `data-mode="rank"` and a `.rank-list` of 2–5 `.rank-item`
-candidates. Each candidate has a unique `data-opt`, a non-blank `data-label`,
-one native `.rank-toggle`, and one honest `.otrade`. The runtime supports
-partial top-k, tier reordering, and ties. Use best-worst dialogue for a longer
-list.
-
-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>")
-   note: |
-      <verbatim line>
-      <blank or verbatim line>
-Q2 <fork-id>: [<key-a>, <key-b>]  ("<Label A>" + "<Label B>")
-Q3 <fork-id>: <key-b> > <key-a> = <key-c>
-Q4 <fork-id>: <position>  (<left pole>→<right pole>)
-Q5 <fork-id>: UNDECIDED
-O1 <prompt-id>: <text | UNDECIDED>
-```
-
-Emit a `Q<n>` line only after the respondent chooses an option or activates
-**Leave this open**. Omit untouched forks; Leave this open emits `UNDECIDED`,
-looks distinct from untouched state, and comes back at most once in a different
-form. Keep `n` as the fork's surface ordinal, so omissions may leave gaps. A
-non-blank why-note on an otherwise untouched fork activates Leave this open.
-Multi turns store
-`{mode:"multi", picks:[...], labels:[...]}` rather than a singular `pick`;
-the bracketed return line is comma-separated and its labels are joined with
-` + `. Leave-this-open on a multi fork stores
-`{mode:"multi", picks:["UNDECIDED"]}` with no labels. Missing fork mode remains
-`single` for backward compatibility. A chosen spectrum stop stores
-`{mode:"spectrum", position:<number>, label:"<stop label>"}`; activating it
-again clears to untouched. Leave-this-open stores
-`{mode:"spectrum", position:"UNDECIDED"}` with no label.
-Rank return lines use `>` between ordered tiers and `=` inside a tie; omitted
-items form a valid partial top-k. Rank turns store
-`{mode:"rank", ranks:[["B"],["A","C"]]}`. Leave-this-open stores
-`{mode:"rank", ranks:[["UNDECIDED"]]}`.
-Decision notes use a block scalar: indent `note: |` exactly three spaces and
-every content line exactly six spaces. Removing those six spaces must reproduce
-the NFC+LF-normalized textarea value verbatim, including blank lines and a
-trailing newline.
-
-## 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 return-block 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.
-
-## Creator gate — before any absorb
-
-The scroll record `memory/scrolls/<slug>.md` names `creator: <person-slug>` and
-optionally `trusted: [<person-slug>, …]`. A record missing `creator:` is
-backfilled from unambiguous existing attribution, otherwise ask the user once
-and write it — never silently default the gate open.
-
-Derive the paster from the session person (`.egregore-state.json`, then git
-config) — never from the return block's self-declared `respondent:` line, which
-is attribution metadata, not an authorization credential.
-
-If the paster is not the creator and not in `trusted:`, the return is **gated**:
-
-1. Append a `turn-received` event to `memory/scrolls/.events/<slug>.jsonl`
-   (create the file if absent). Event ids are append-if-absent and MUST match
-   the Claude corpus exactly — both runtimes share one event log:
-   `turn.id = respondent + '|' + base_version + '|' + date + '|' + digest`;
-   digest = FNV-1a 32-bit hex over the UTF-8 bytes of
-   `JSON.stringify([respondent, String(base_version), date, sortedAnswers,
-   sortedOpens])` where `sortedAnswers` = answers sorted by fork id, each
-   mapped to `[fork, pick-or-UNDECIDED, note-or-empty]` for single,
-   `[fork, sorted-picks-array, note-or-empty]` for multi, or
-   `[fork, ordered-rank-tiers-with-each-tie-sorted, note-or-empty]` for rank,
-   or `[fork, position-or-UNDECIDED, note-or-empty]` for spectrum (labels are excluded),
-   and `sortedOpens` = opens sorted by prompt id, each mapped to
-   `[prompt, text-or-UNDECIDED]`; every string is NFC-normalized and
-   CRLF→LF-normalized before hashing. Legacy single turn ids remain unchanged.
-   Record `submitted_by: <paster>` on the
-   event (event-log metadata only — never projected into a published ledger)
-   and `merged_into: "pending"`.
-2. Do NOT absorb: no `memory/knowledge/decisions/` writes, no spec/plan edits,
-   no face rewrite, no version bump, no republish of new content. Republishing
-   the unchanged current version to acknowledge the turn is allowed and appends
-   no version event.
-3. In connected mode, follow `.claude/context/notification-consent.md` and
-   prepare a direct notification to the creator without sending:
-   `bash bin/notify.sh plan send <creator> "<paster> answered your scroll
-   <slug> (vN): <digest> — pending your review"`. Show a separate exact Send /
-   Edit / Cancel checkpoint. In local mode, write an addressed handoff in
-   `memory/handoffs/` naming the scroll,
-   paster, base version, digest, and the dispositions below. The contributor
-   may also send the artifact link directly.
-4. Report the gated state and stop.
-
-**Creator review.** The creator disposes in chat: **accept** (absorb into the
-next version), **decline — <reason>** (mandatory nonblank note; refuse a
-decline without one), per-answer overrides (top-level disposition is the
-default, listed answers override; a turn with zero effectively accepted answers
-is a plain decline; a zero-answer turn takes the top-level disposition), or
-**synthesize** (compose one proposal from all pending turns — consensus
-decides, conflicts become new explicit forks — and publish only on creator
-approval). Every disposition appends `turn-reviewed`
-`{type, turn, disposition: accepted|declined, by, date, note?, answers?}` with
-id `review|<turn.id>` before any composition. An accepted turn stays pending
-until a version actually absorbs it. Declined turns are never absorbed, stay
-attributed in the log, and their reason travels with them. The creator's own
-returns and trusted respondents keep the immediate loop below.
-
-## Update loop
-
-On a returned block (creator or trusted paster — gated returns stop above):
-
-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. Re-evaluate every optional face module by
-   the fit rule above.
-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. Treat an answer outside the listed options as a candidate
-   option at review, never as the nearest pick.
-4. **Show, then ask.** When abstract forks run dry or the respondent asks for
-   something concrete, place only the relevant draft or excerpt in the
-   decisions view and ask grounded open prompts beside selected material. This
-   is a selective authoring move, not a standing interaction mode: never make
-   every face section reactable, add question controls to the readable face,
-   or ask generic ready/not-ready verdicts.
-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/codex/.codex/skills/scroll/agents/openai.yaml

@@ -1,4 +0,0 @@
-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."