@open-product-primer/cli 2.0.0 → 2.2.0

package/dist/lib/validate-checks.js

@@ -0,0 +1,145 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.checkBetDefinitionOfDone = checkBetDefinitionOfDone;
+exports.checkSpecDeltaDrift = checkSpecDeltaDrift;
+exports.checkCrossBetConflicts = checkCrossBetConflicts;
+const path = __importStar(require("path"));
+const fs = __importStar(require("fs"));
+const spec_delta_1 = require("./spec-delta");
+function normalizeHeader(header) {
+    return header.trim().replace(/\s+/g, ' ').toLowerCase();
+}
+function extractBetId(dirName) {
+    const match = dirName.match(/^(BET-\d+)/);
+    return match ? match[1] : dirName;
+}
+function activeBetDirs(betsDir) {
+    if (!fs.existsSync(betsDir))
+        return [];
+    return fs
+        .readdirSync(betsDir, { withFileTypes: true })
+        .filter((e) => e.isDirectory() && e.name !== 'archived');
+}
+function isPromoted(betDecisionContent) {
+    const linksMatch = betDecisionContent.match(/## Links\n([\s\S]*?)(?=\n## |$)/);
+    const linksSection = linksMatch ? linksMatch[1] : betDecisionContent;
+    const lineMatch = linksSection.match(/^- *OpenSpec change:\s*(.*)$/m);
+    if (!lineMatch)
+        return false;
+    const value = lineMatch[1].trim().replace(/^<|>$/g, '').trim();
+    if (value === '')
+        return false;
+    if (/to be filled when promoted/i.test(value))
+        return false;
+    if (/^path once promoted$/i.test(value))
+        return false;
+    return true;
+}
+/**
+ * Flags a promoted bet (one whose bet-decision.md links a non-placeholder OpenSpec
+ * change) that has no criteria.yaml alongside it. Un-promoted bets are not checked.
+ */
+function checkBetDefinitionOfDone(projectRoot, checks) {
+    const betsDir = path.join(projectRoot, 'oprim', 'bets');
+    for (const entry of activeBetDirs(betsDir)) {
+        const betDir = path.join(betsDir, entry.name);
+        const decisionPath = path.join(betDir, 'bet-decision.md');
+        if (!fs.existsSync(decisionPath))
+            continue;
+        const content = fs.readFileSync(decisionPath, 'utf-8');
+        if (!isPromoted(content))
+            continue;
+        const hasCriteria = fs.existsSync(path.join(betDir, 'criteria.yaml'));
+        if (!hasCriteria) {
+            const betId = extractBetId(entry.name);
+            checks.push({
+                name: `bet: ${betId} promoted without criteria.yaml`,
+                pass: false,
+                note: `Add criteria.yaml to oprim/bets/${entry.name}/, or run the oprim-criteria skill`,
+                required: false,
+            });
+        }
+    }
+}
+/**
+ * Flags a MODIFIED/REMOVED requirement in an active bet's spec delta whose header no
+ * longer text-matches (whitespace-insensitive) current truth.
+ */
+function checkSpecDeltaDrift(projectRoot, checks) {
+    const betsDir = path.join(projectRoot, 'oprim', 'bets');
+    for (const entry of activeBetDirs(betsDir)) {
+        const betId = extractBetId(entry.name);
+        const specsDir = path.join(betsDir, entry.name, 'specs');
+        if (!fs.existsSync(specsDir))
+            continue;
+        const capEntries = fs.readdirSync(specsDir, { withFileTypes: true }).filter((e) => e.isDirectory());
+        for (const capEntry of capEntries) {
+            const deltaPath = path.join(specsDir, capEntry.name, 'spec.md');
+            if (!fs.existsSync(deltaPath))
+                continue;
+            const deltaContent = fs.readFileSync(deltaPath, 'utf-8');
+            const currentTruthPath = path.join(projectRoot, 'oprim', 'specs', capEntry.name, 'spec.md');
+            const currentHeaders = fs.existsSync(currentTruthPath)
+                ? (0, spec_delta_1.parseCurrentTruthHeaders)(fs.readFileSync(currentTruthPath, 'utf-8'))
+                : [];
+            for (const section of ['MODIFIED', 'REMOVED']) {
+                for (const header of (0, spec_delta_1.parseRequirementHeaders)(deltaContent, section)) {
+                    const matches = currentHeaders.some((h) => normalizeHeader(h) === normalizeHeader(header));
+                    if (!matches) {
+                        checks.push({
+                            name: `spec-delta: ${betId}'s ${section} requirement "${header}" in ${capEntry.name} no longer matches current truth`,
+                            pass: false,
+                            note: `No matching requirement header found in oprim/specs/${capEntry.name}/spec.md`,
+                            required: true,
+                        });
+                    }
+                }
+            }
+        }
+    }
+}
+/** Surfaces overlapping requirement headers across active bets' spec deltas. */
+function checkCrossBetConflicts(projectRoot, checks) {
+    const betsDir = path.join(projectRoot, 'oprim', 'bets');
+    for (const conflict of (0, spec_delta_1.findCrossBetConflicts)(betsDir)) {
+        checks.push({
+            name: `spec-delta: ${extractBetId(conflict.betA)} and ${extractBetId(conflict.betB)} both touch "${conflict.header}" in ${conflict.capability}`,
+            pass: false,
+            note: 'Overlapping requirement header between active bets — archiving one first applies last-write-wins to the other (no 3-way merge)',
+            required: true,
+        });
+    }
+}

package/dist/lib/workflow-renderer.d.ts

@@ -0,0 +1,19 @@
+/**
+ * The full workflow body — a workflow's own frontmatter (`name:`/`description:`) plus its
+ * instructional steps — used verbatim as the Claude/Cursor/Poolside SKILL.md content.
+ */
+export declare function renderSkillBody(id: string, projectRoot?: string): string;
+/**
+ * A thin Claude command wrapper that delegates to the workflow's skill via the Skill tool
+ * (archive/sequence/context), or promote's dynamic per-framework content.
+ */
+export declare function renderClaudeCommand(id: string, projectRoot?: string, framework?: string): string;
+/**
+ * A full Cursor command file: promote's dynamic per-framework content, or a condensed
+ * `<id>.cursor-command.md` body (Cursor has no Skill tool, so content is always inlined).
+ */
+export declare function renderCursorCommand(id: string, projectRoot?: string, framework?: string): string;
+/** A workflow's condensed section for the shared Codex/Gemini/Poolside inline instruction block. */
+export declare function renderInlineSection(id: string): string | null;
+/** The full `<!-- oprim:start -->`-delimited inline instruction block written into AGENTS.md/GEMINI.md. */
+export declare function renderAgentInstructions(): string;

package/dist/lib/workflow-renderer.js

@@ -0,0 +1,103 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderSkillBody = renderSkillBody;
+exports.renderClaudeCommand = renderClaudeCommand;
+exports.renderCursorCommand = renderCursorCommand;
+exports.renderInlineSection = renderInlineSection;
+exports.renderAgentInstructions = renderAgentInstructions;
+const workflow_schema_1 = require("./workflow-schema");
+// Fixed order the pre-refactor oprimWorkflowsInline() concatenated its per-workflow sections in —
+// preserved here so Codex/Gemini/Poolside output is unchanged.
+const INLINE_SECTION_ORDER = ['bet', 'note', 'criteria', 'pdr', 'review', 'archive', 'sequence'];
+function claudeWrapper(name, description, body) {
+    return `---
+name: "${name}"
+description: ${description}
+category: Workflow
+tags: [workflow, primer]
+---
+
+${description}.
+
+${body}`;
+}
+function cursorWrapper(id, description, body) {
+    return `---
+name: /${id}
+id: ${id}
+category: Workflow
+description: ${description}
+---
+
+${body}`;
+}
+function promoteVariantBody(id, schema, framework) {
+    const variants = schema.variants;
+    if (!variants)
+        throw new Error(`workflow "${id}" has no variants configured`);
+    const variantId = variants.includes(framework) ? framework : variants[0];
+    const content = (0, workflow_schema_1.loadWorkflowVariant)(`${id}.${variantId}.template.md`);
+    if (content === null) {
+        throw new Error(`Missing variant template ${id}.${variantId}.template.md for workflow "${id}"`);
+    }
+    return content;
+}
+/**
+ * The full workflow body — a workflow's own frontmatter (`name:`/`description:`) plus its
+ * instructional steps — used verbatim as the Claude/Cursor/Poolside SKILL.md content.
+ */
+function renderSkillBody(id, projectRoot) {
+    return (0, workflow_schema_1.loadWorkflowTemplate)(id, projectRoot);
+}
+/**
+ * A thin Claude command wrapper that delegates to the workflow's skill via the Skill tool
+ * (archive/sequence/context), or promote's dynamic per-framework content.
+ */
+function renderClaudeCommand(id, projectRoot, framework = 'openspec') {
+    const schema = (0, workflow_schema_1.loadWorkflowSchema)(id, projectRoot);
+    if (!schema.claude.command) {
+        throw new Error(`workflow "${id}" has no Claude command target`);
+    }
+    const body = schema.variants
+        ? promoteVariantBody(id, schema, framework)
+        : schema.skillName
+            ? `Use the Skill tool to invoke the \`${schema.skillName}\` skill.`
+            : (() => {
+                throw new Error(`workflow "${id}" Claude command has neither a skillName nor variants`);
+            })();
+    return claudeWrapper(schema.title ?? schema.id, schema.description, body);
+}
+/**
+ * A full Cursor command file: promote's dynamic per-framework content, or a condensed
+ * `<id>.cursor-command.md` body (Cursor has no Skill tool, so content is always inlined).
+ */
+function renderCursorCommand(id, projectRoot, framework = 'openspec') {
+    const schema = (0, workflow_schema_1.loadWorkflowSchema)(id, projectRoot);
+    if (!schema.cursor.command) {
+        throw new Error(`workflow "${id}" has no Cursor command target`);
+    }
+    const cursorId = schema.cursor.command.replace(/\.md$/, '');
+    const body = schema.variants
+        ? promoteVariantBody(id, schema, framework)
+        : (() => {
+            const content = (0, workflow_schema_1.loadWorkflowVariant)(`${id}.cursor-command.md`);
+            if (content === null)
+                throw new Error(`Missing ${id}.cursor-command.md for workflow "${id}"`);
+            return content;
+        })();
+    return cursorWrapper(cursorId, schema.cursorDescription ?? schema.description, body);
+}
+/** A workflow's condensed section for the shared Codex/Gemini/Poolside inline instruction block. */
+function renderInlineSection(id) {
+    return (0, workflow_schema_1.loadWorkflowVariant)(`${id}.inline.md`);
+}
+/** The full `<!-- oprim:start -->`-delimited inline instruction block written into AGENTS.md/GEMINI.md. */
+function renderAgentInstructions() {
+    const sections = INLINE_SECTION_ORDER.map((id) => {
+        const content = renderInlineSection(id);
+        if (content === null)
+            throw new Error(`Missing inline section for workflow "${id}"`);
+        return content;
+    });
+    return '\n## oprim workflows\n\n' + sections.join('\n\n') + '\n';
+}

package/dist/lib/workflow-schema.d.ts

@@ -0,0 +1,37 @@
+export interface WorkflowAgentTarget {
+    skill: boolean;
+    command: string | null;
+}
+export interface WorkflowSchema {
+    id: string;
+    skillName: string | null;
+    title: string | null;
+    description: string;
+    cursorDescription: string | null;
+    claude: WorkflowAgentTarget;
+    cursor: WorkflowAgentTarget;
+    poolside: {
+        skill: boolean;
+    };
+    inline: boolean;
+    variants: string[] | null;
+}
+/**
+ * Loads a workflow's schema.yaml, resolving a project-level
+ * `oprim/workflows/<id>.schema.yaml` override over the CLI-bundled default.
+ * Throws an actionable, file-naming error if an override exists but fails to parse
+ * or is missing required fields — never silently falls back to the bundled default.
+ */
+export declare function loadWorkflowSchema(id: string, projectRoot?: string): WorkflowSchema;
+/**
+ * Loads a workflow's template.md, resolving a project-level
+ * `oprim/workflows/<id>.template.md` override over the CLI-bundled default.
+ */
+export declare function loadWorkflowTemplate(id: string, projectRoot?: string): string;
+/**
+ * Loads a bundled, non-overridable variant file (Cursor's condensed command body, the
+ * Codex/Gemini/Poolside inline section, promote's per-framework bodies). Only
+ * `<id>.schema.yaml` and `<id>.template.md` are project-forkable — see
+ * workflow-schema-authoring spec. Returns null if the workflow has no such variant.
+ */
+export declare function loadWorkflowVariant(filename: string): string | null;

package/dist/lib/workflow-schema.js

@@ -0,0 +1,126 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadWorkflowSchema = loadWorkflowSchema;
+exports.loadWorkflowTemplate = loadWorkflowTemplate;
+exports.loadWorkflowVariant = loadWorkflowVariant;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const yaml = __importStar(require("js-yaml"));
+// Bundled workflow definitions ship inside the compiled package at dist/workflows/ (copied
+// there at build time by scripts/copy-workflow-assets.js — see package.json's "build" script).
+const BUNDLED_DIR = path.join(__dirname, '..', 'workflows');
+function overridesDir(projectRoot) {
+    return path.join(projectRoot, 'oprim', 'workflows');
+}
+function requireField(obj, field, filePath) {
+    if (!(field in obj) || obj[field] === undefined || obj[field] === null) {
+        throw new Error(`Invalid workflow schema at ${filePath}: missing required field "${field}"`);
+    }
+    return obj[field];
+}
+function parseSchema(raw, filePath) {
+    let doc;
+    try {
+        doc = yaml.load(raw);
+    }
+    catch (err) {
+        throw new Error(`Invalid workflow schema at ${filePath}: ${err.message}`);
+    }
+    if (typeof doc !== 'object' || doc === null || Array.isArray(doc)) {
+        throw new Error(`Invalid workflow schema at ${filePath}: expected a YAML mapping`);
+    }
+    const obj = doc;
+    requireField(obj, 'id', filePath);
+    requireField(obj, 'description', filePath);
+    const claude = requireField(obj, 'claude', filePath);
+    const cursor = requireField(obj, 'cursor', filePath);
+    const poolside = requireField(obj, 'poolside', filePath);
+    requireField(obj, 'inline', filePath);
+    return {
+        id: obj.id,
+        skillName: obj.skillName ?? null,
+        title: obj.title ?? null,
+        description: obj.description,
+        cursorDescription: obj.cursorDescription ?? null,
+        claude: { skill: Boolean(claude.skill), command: claude.command ?? null },
+        cursor: { skill: Boolean(cursor.skill), command: cursor.command ?? null },
+        poolside: { skill: Boolean(poolside.skill) },
+        inline: Boolean(obj.inline),
+        variants: obj.variants ?? null,
+    };
+}
+/**
+ * Loads a workflow's schema.yaml, resolving a project-level
+ * `oprim/workflows/<id>.schema.yaml` override over the CLI-bundled default.
+ * Throws an actionable, file-naming error if an override exists but fails to parse
+ * or is missing required fields — never silently falls back to the bundled default.
+ */
+function loadWorkflowSchema(id, projectRoot) {
+    if (projectRoot) {
+        const overridePath = path.join(overridesDir(projectRoot), `${id}.schema.yaml`);
+        if (fs.existsSync(overridePath)) {
+            return parseSchema(fs.readFileSync(overridePath, 'utf-8'), overridePath);
+        }
+    }
+    const bundledPath = path.join(BUNDLED_DIR, `${id}.schema.yaml`);
+    return parseSchema(fs.readFileSync(bundledPath, 'utf-8'), bundledPath);
+}
+/**
+ * Loads a workflow's template.md, resolving a project-level
+ * `oprim/workflows/<id>.template.md` override over the CLI-bundled default.
+ */
+function loadWorkflowTemplate(id, projectRoot) {
+    if (projectRoot) {
+        const overridePath = path.join(overridesDir(projectRoot), `${id}.template.md`);
+        if (fs.existsSync(overridePath)) {
+            return fs.readFileSync(overridePath, 'utf-8');
+        }
+    }
+    const bundledPath = path.join(BUNDLED_DIR, `${id}.template.md`);
+    return fs.readFileSync(bundledPath, 'utf-8');
+}
+/**
+ * Loads a bundled, non-overridable variant file (Cursor's condensed command body, the
+ * Codex/Gemini/Poolside inline section, promote's per-framework bodies). Only
+ * `<id>.schema.yaml` and `<id>.template.md` are project-forkable — see
+ * workflow-schema-authoring spec. Returns null if the workflow has no such variant.
+ */
+function loadWorkflowVariant(filename) {
+    const p = path.join(BUNDLED_DIR, filename);
+    if (!fs.existsSync(p))
+        return null;
+    return fs.readFileSync(p, 'utf-8');
+}

package/dist/workflows/archive.inline.md

@@ -0,0 +1,10 @@
+### Bet archiving (oprim-archive)
+Archive a completed bet.
+
+1. Ask for bet ID (accept bet-005, 005, 5, BET-005 — normalize to BET-NNN).
+2. Verify `oprim/bets/BET-NNN/` exists.
+3. Check `oprim/sequence.yaml` for entries where `blocked_by` or `unlocks` reference the target bet — warn if found. Also check other active bet dirs for delta specs against the same requirement (matching `### Requirement:` headers, whitespace-insensitive) — warn if an overlap is found. Ask "Archive anyway? (y/N)" if either warning fires.
+4. If `oprim/bets/BET-NNN/specs/` exists, fold each capability's `## ADDED`/`## MODIFIED`/`## REMOVED Requirements` delta into `oprim/specs/<capability>/spec.md` (matching by `### Requirement:` header; create the current-truth file if the delta is entirely ADDED) — last-write-wins on overlaps, no 3-way merge. Skip this step entirely if no `specs/` dir is present.
+5. Move directory: `oprim/bets/BET-NNN → oprim/bets/archived/BET-NNN`.
+6. Remove the bet entry from `oprim/sequence.yaml`.
+7. Report what was done.

package/dist/workflows/archive.schema.yaml

@@ -0,0 +1,13 @@
+id: archive
+skillName: oprim-archive
+title: "OPRIM: Archive"
+description: Archive a completed bet — move it out of the active board
+claude:
+  skill: true
+  command: archive.md
+cursor:
+  skill: false
+  command: null
+poolside:
+  skill: true
+inline: true

package/dist/workflows/archive.template.md

@@ -0,0 +1,106 @@
+---
+name: oprim-archive
+description: Archive a completed bet — moves it to oprim/bets/archived/, removes its sequence.yaml entry, and folds any spec deltas under its specs/ directory into oprim/specs/ current truth
+---
+
+Archive a completed bet by moving it to `oprim/bets/archived/`, removing it from `sequence.yaml`, and (if present) merging its spec deltas into current truth.
+
+**Interactive prompts:** Use the **AskUserQuestion tool** for every question in this skill — do not write questions as plain text.
+
+## Steps
+
+### 1. Get the bet ID
+
+If provided as an argument (e.g., `/oprim:archive BET-005`), use it directly.
+
+If not provided, ask: "Which bet ID would you like to archive? (e.g., BET-005)"
+
+Normalize the input: accept `bet-005`, `005`, `5`, or `BET-005` — always treat as `BET-NNN` zero-padded to 3 digits.
+
+### 2. Resolve the bet directory
+
+Look for the bet directory in `oprim/bets/` using two patterns:
+1. Exact match: `oprim/bets/BET-NNN/` (legacy non-slug format)
+2. Slug variant: any directory starting with `BET-NNN-` (e.g., `BET-NNN-<slug>/`)
+
+Use whichever pattern matches. Call this the **resolved directory name**.
+
+If multiple directories match (e.g., both `BET-NNN/` and `BET-NNN-slug/` exist):
+- Report: "Ambiguous: found multiple directories for BET-NNN: [list them]. Please archive manually."
+- Stop.
+
+If neither pattern matches:
+- Report: "Bet BET-NNN was not found in oprim/bets/. Nothing was changed."
+- Stop.
+
+### 3. Check for active dependencies and concurrent spec-delta conflicts
+
+Read `oprim/sequence.yaml`. Scan every entry across all buckets (now, next, later, backlog) for any entry whose `blocked_by` or `unlocks` list contains the target bet ID.
+
+Separately, if `oprim/bets/<resolved-dir>/specs/` exists: for each `<capability>/spec.md` delta file under it, extract every `### Requirement:` header from its `## ADDED`/`## MODIFIED`/`## REMOVED Requirements` sections. Then scan every other bet directory directly under `oprim/bets/` (excluding `archived/` and the bet being archived) for a `specs/<capability>/spec.md` file for the same capability; if one exists, extract its `### Requirement:` headers too. Flag any header that matches (whitespace-insensitive) between the archiving bet's delta and another still-active bet's delta as an **overlap**.
+
+If either sequence.yaml dependents or delta overlaps are found:
+- Show a combined warning listing each dependent entry and each overlapping requirement.
+
+  Example:
+  ```
+  ⚠ Warning: BET-005 is referenced by active bets:
+    - BET-007 (blocked_by: [BET-005])
+    - BET-008 (unlocks: [BET-005])
+  ⚠ Warning: BET-005's delta for requirement "The system SHALL ..." in capability foo overlaps with active bet BET-009's delta for the same requirement. Archiving BET-005 now applies its version to oprim/specs/foo/spec.md; if BET-009 archives later, its version will overwrite this requirement again (last-write-wins — no 3-way merge is attempted).
+  ```
+- Ask: "Archive BET-NNN anyway? (y/N)"
+  - If "n" or Enter: stop, no changes made.
+  - If "y": proceed.
+
+If neither is found: proceed without warning.
+
+### 4. Fold spec deltas into current truth
+
+If `oprim/bets/<resolved-dir>/specs/` does not exist: skip this step entirely and go to Step 5 — archive behavior is unchanged from before spec deltas existed.
+
+Otherwise, for each capability subdirectory under `oprim/bets/<resolved-dir>/specs/` containing a `spec.md`:
+
+1. Read the delta file's `## ADDED Requirements` / `## MODIFIED Requirements` / `## REMOVED Requirements` sections. Each `### Requirement:` block runs from its header through its body and any `#### Scenario:` sub-entries, up to the next `### Requirement:` or `## ` header.
+2. Read `oprim/specs/<capability>/spec.md` if it exists (current truth uses a single flat `## Requirements` section).
+   - **If it does not exist:**
+     - If the delta is entirely `## ADDED Requirements` (no MODIFIED/REMOVED sections): create `oprim/specs/<capability>/spec.md` with a `## Requirements` header and append each ADDED requirement block beneath it.
+     - If the delta contains any MODIFIED or REMOVED requirements: stop before moving anything and report an error — "cannot modify/remove requirement '<header>' in capability <capability> — no current-truth spec exists yet for this capability."
+   - **If it does exist:**
+     - **ADDED**: append the requirement block to the end of the `## Requirements` section.
+     - **MODIFIED**: find the existing `### Requirement:` block whose header text matches the delta's (whitespace-insensitive); replace that entire block (header, body, and scenarios) with the delta's version. If no match is found, treat it as ADDED instead (append) and note this in the final report.
+     - **REMOVED**: find and delete the matching block entirely. If no match is found, note this in the final report and continue — nothing to remove.
+3. Write the updated `oprim/specs/<capability>/spec.md`.
+
+This fold always overwrites the matched requirement wholesale — it never reconciles two bets' overlapping changes. If a later bet's archive touches the same requirement again, its version simply replaces this one (last-write-wins, confirmed by construction — no 3-way merge).
+
+Track which capabilities were merged (and any no-match notes) for the final report.
+
+### 5. Move the bet directory to archive
+
+Create the archive subfolder if it doesn't exist:
+```bash
+mkdir -p oprim/bets/archived
+```
+
+Move the resolved directory:
+```bash
+mv oprim/bets/<resolved-dir> oprim/bets/archived/<resolved-dir>
+```
+
+### 6. Remove the bet entry from sequence.yaml
+
+Read `oprim/sequence.yaml`, parse it, and remove the entry with `id: BET-NNN` from whichever bucket it appears in (now, next, later, or backlog). Write the updated YAML back using 2-space indentation. Do not modify any other entries.
+
+### 7. Report what was done
+
+```
+## Bet Archived
+
+**Bet:** BET-NNN
+**Archived to:** oprim/bets/archived/<resolved-dir>/
+**Removed from sequence.yaml:** ✓
+**Spec deltas merged:** <capability-1>, <capability-2> (omit this line if no specs/ directory was present)
+
+The bet is preserved in full at the archive location.
+```

package/dist/workflows/bet.cursor-command.md

@@ -0,0 +1 @@
+Create a new bet in `oprim/bets/`. First explain: "A bet is a product decision you're committing to explore — a problem worth solving, a hypothesis worth testing, or a direction worth taking. You'll name it, explain why now, and set a kill criterion." Then show: "Naming tip: verb + object [for context] — Good: 'Improve bet naming for scannability' / Bad: 'Naming'". Scan `BET-(\d+)` dirs for next ID (zero-padded, default 001). Check `oprim/sequence.yaml` exists (stop if not — advise oprim init). Read `oprim/config.yaml`'s `rules.bet` — if non-empty, apply it as additional guidance and reflect it in the generated content; if empty, behavior is unchanged. After receiving the title, validate: if fewer than 4 words OR fewer than 25 characters, warn "this title may be too vague", suggest a reformulation, and ask "Proceed anyway? (y/N)" — if "n", prompt for a revised title. Gather: decision (default Build now), owner, review date, why-now, alternatives, expected outcomes, kill criteria, PDR links. Write `oprim/bets/BET-NNN/bet-decision.md` with an inline naming tip comment in the header. Append entry to sequence.yaml backlog: `{id, title, blocked_by: [], unlocks: [], requires_pdrs: []}`. Then ask: "Do you want to scaffold a discovery.md now? (y/N)" — if "y", write `oprim/bets/BET-NNN/discovery.md` from the discovery template (sections: Problem Framing, User Research Signals, Competitive Context, Open Questions); if "n" or Enter, skip silently. Report what was created.

package/dist/workflows/bet.inline.md

@@ -0,0 +1,13 @@
+### Bet authoring (oprim-bet)
+Create a new bet in `oprim/bets/` and register it on the sequencing board.
+
+1. Show naming tip: "verb + object [for context] — e.g. 'Improve bet naming for scannability'"
+2. Ask for the bet title. Validate: fewer than 4 words OR fewer than 25 chars → warn, suggest reformulation, ask "Proceed anyway? (y/N)".
+3. Assign next BET ID: scan `oprim/bets/BET-(\d+)` dirs, max+1 zero-padded to 3 digits (default 001).
+4. Check `oprim/sequence.yaml` exists — stop if not, advise `oprim init`.
+4b. Read `oprim/config.yaml`'s `rules.bet` — if non-empty, apply it as additional guidance and reflect it in the generated content; if empty, behavior is unchanged.
+5. Gather: decision (default Build now), owner, review date (YYYY-MM-DD), why now, alternatives, expected outcomes, kill criteria, PDR links.
+6. Write `oprim/bets/BET-NNN/bet-decision.md` with all fields.
+7. Append to `oprim/sequence.yaml` backlog: `{id, title, blocked_by: [], unlocks: [], requires_pdrs: []}`.
+8. Ask: "Scaffold a discovery.md now? (y/N)" — if "y", write `oprim/bets/BET-NNN/discovery.md`.
+9. Report what was created.

package/dist/workflows/bet.schema.yaml

@@ -0,0 +1,14 @@
+id: bet
+skillName: oprim-bet
+title: null
+description: Create a new bet directory and bet-decision artifact in oprim/bets/, and add the bet to oprim/sequence.yaml backlog
+cursorDescription: Create a new bet decision and register it on the sequencing board
+claude:
+  skill: true
+  command: null
+cursor:
+  skill: true
+  command: oprim-bet.md
+poolside:
+  skill: true
+inline: true