@open-product-primer/cli 2.7.0 → 2.9.0

package/dist/cli.js

@@ -13,6 +13,9 @@ const migrate_1 = require("./commands/migrate");
 const measure_1 = require("./commands/measure");
 const ovw_1 = require("./commands/ovw");
 const context_1 = require("./commands/context");
+const list_1 = require("./commands/list");
+const show_1 = require("./commands/show");
+const status_1 = require("./commands/status");
 const package_json_1 = __importDefault(require("../package.json"));
 const program = new commander_1.Command();
 program
@@ -27,4 +30,7 @@ program.addCommand((0, migrate_1.migrateCommand)());
 program.addCommand((0, measure_1.measureCommand)());
 program.addCommand((0, ovw_1.ovwCommand)());
 program.addCommand((0, context_1.contextCommand)());
+program.addCommand((0, list_1.listCommand)());
+program.addCommand((0, show_1.showCommand)());
+program.addCommand((0, status_1.statusCommand)());
 program.parse();

package/dist/commands/list.d.ts

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare function listCommand(): Command;

package/dist/commands/list.js

@@ -0,0 +1,54 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.listCommand = listCommand;
+const commander_1 = require("commander");
+const chalk_1 = __importDefault(require("chalk"));
+const artifacts_1 = require("../lib/artifacts");
+function printTable(label, rows, columns) {
+    console.log(chalk_1.default.bold.cyan(`\n── ${label} ──`));
+    if (rows.length === 0) {
+        console.log('  (none)');
+        return;
+    }
+    for (const row of rows) {
+        console.log(`  ${columns(row).join('  ')}`);
+    }
+}
+function listCommand() {
+    return new commander_1.Command('list')
+        .description('Enumerate oprim artifacts (bets, decisions, notes) by type')
+        .option('-b, --bets', 'list bets')
+        .option('-d, --decisions', 'list decisions (PDRs)')
+        .option('-n, --notes', 'list notes')
+        .option('--json', 'print machine-readable JSON instead of the human-readable table')
+        .action((opts) => {
+        const projectRoot = process.cwd();
+        const anyTypeRequested = !!(opts.bets || opts.decisions || opts.notes);
+        const showBets = anyTypeRequested ? !!opts.bets : true;
+        const showDecisions = !!opts.decisions;
+        const showNotes = !!opts.notes;
+        const bets = showBets ? (0, artifacts_1.listBets)(projectRoot) : undefined;
+        const decisions = showDecisions ? (0, artifacts_1.listDecisions)(projectRoot) : undefined;
+        const notes = showNotes ? (0, artifacts_1.listNotes)(projectRoot) : undefined;
+        if (opts.json) {
+            const result = {};
+            if (bets)
+                result.bets = bets;
+            if (decisions)
+                result.decisions = decisions;
+            if (notes)
+                result.notes = notes;
+            console.log(JSON.stringify(result));
+            return;
+        }
+        if (bets)
+            printTable('BETS', bets, (b) => [b.id, b.status ?? '-', b.title]);
+        if (decisions)
+            printTable('DECISIONS', decisions, (d) => [d.id, d.status ?? '-', d.title]);
+        if (notes)
+            printTable('NOTES', notes, (n) => [n.id, n.tags.join(',') || '-', n.title]);
+    });
+}

package/dist/commands/show.d.ts

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare function showCommand(): Command;

package/dist/commands/show.js

@@ -0,0 +1,138 @@
+"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;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.showCommand = showCommand;
+const commander_1 = require("commander");
+const path = __importStar(require("path"));
+const fs = __importStar(require("fs"));
+const chalk_1 = __importDefault(require("chalk"));
+const spec_delta_1 = require("../lib/spec-delta");
+const artifacts_1 = require("../lib/artifacts");
+function extractLinks(content) {
+    const match = content.match(/^##\s*Links\s*\n([\s\S]*?)(?=\n##\s|$)/m);
+    return match ? match[1].trim() : null;
+}
+function resolveBet(projectRoot, idInput) {
+    for (const sub of ['pending', 'archived']) {
+        const betsDir = path.join(projectRoot, 'oprim', 'bets', sub);
+        const resolved = (0, spec_delta_1.resolveBetDirectory)(betsDir, idInput);
+        if (!resolved)
+            continue;
+        const decisionPath = path.join(betsDir, resolved, 'bet-decision.md');
+        if (!fs.existsSync(decisionPath))
+            continue;
+        const content = fs.readFileSync(decisionPath, 'utf-8');
+        const { title, status } = (0, artifacts_1.parseBetDecision)(content);
+        return {
+            type: 'bet',
+            id: resolved.match(/^BET-\d+/)?.[0] ?? resolved,
+            path: path.relative(projectRoot, decisionPath),
+            fields: { title, status, links: extractLinks(content) },
+            content,
+        };
+    }
+    return null;
+}
+function resolveDecision(projectRoot, idInput) {
+    const filePath = (0, artifacts_1.resolvePdrPath)(projectRoot, idInput);
+    if (!filePath)
+        return null;
+    const content = fs.readFileSync(filePath, 'utf-8');
+    const { id, title, status } = (0, artifacts_1.parsePdrFile)(content);
+    if (!id)
+        return null;
+    return {
+        type: 'decision',
+        id,
+        path: path.relative(projectRoot, filePath),
+        fields: { title, status },
+        content,
+    };
+}
+function resolveNote(projectRoot, idInput) {
+    const filePath = (0, artifacts_1.resolveNotePath)(projectRoot, idInput);
+    if (!filePath)
+        return null;
+    const content = fs.readFileSync(filePath, 'utf-8');
+    const { title, tags } = (0, artifacts_1.parseNoteFrontmatter)(content);
+    const id = path.basename(filePath).match(/^(NOTE-\d+)/)?.[1] ?? idInput;
+    return {
+        type: 'note',
+        id,
+        path: path.relative(projectRoot, filePath),
+        fields: { title, tags },
+        content,
+    };
+}
+function resolveArtifact(projectRoot, idInput) {
+    const normalized = idInput.trim().toUpperCase();
+    if (normalized.startsWith('BET'))
+        return resolveBet(projectRoot, idInput);
+    if (normalized.startsWith('PDR'))
+        return resolveDecision(projectRoot, idInput);
+    if (normalized.startsWith('NOTE'))
+        return resolveNote(projectRoot, idInput);
+    return null;
+}
+function showCommand() {
+    return new commander_1.Command('show')
+        .description('Show a single oprim artifact (bet, decision, or note) resolved by ID')
+        .argument('<id>', 'artifact ID, e.g. BET-030, PDR-005, or NOTE-012')
+        .option('--json', 'print machine-readable JSON instead of the human-readable view')
+        .action((idInput, opts) => {
+        const projectRoot = process.cwd();
+        const result = resolveArtifact(projectRoot, idInput);
+        if (!result) {
+            console.error(`${idInput} was not found — checked bets, decisions, and notes.`);
+            process.exitCode = 1;
+            return;
+        }
+        if (opts.json) {
+            console.log(JSON.stringify({ type: result.type, id: result.id, path: result.path, ...result.fields, content: result.content }));
+            return;
+        }
+        console.log(chalk_1.default.bold(`${result.id}`) + chalk_1.default.dim(`  (${result.type})  ${result.path}`));
+        for (const [key, value] of Object.entries(result.fields)) {
+            if (value === null || value === undefined || value === '')
+                continue;
+            console.log(chalk_1.default.dim(`${key}:`) + ` ${Array.isArray(value) ? value.join(', ') : value}`);
+        }
+        console.log('');
+        console.log(result.content);
+    });
+}

package/dist/commands/status.d.ts

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare function statusCommand(): Command;

package/dist/commands/status.js

@@ -0,0 +1,95 @@
+"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;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.statusCommand = statusCommand;
+const commander_1 = require("commander");
+const path = __importStar(require("path"));
+const fs = __importStar(require("fs"));
+const chalk_1 = __importDefault(require("chalk"));
+const yaml = __importStar(require("js-yaml"));
+function statusCommand() {
+    return new commander_1.Command('status')
+        .description('Show sequencing board state (now/next/later/backlog) and WIP limit usage')
+        .option('--json', 'print machine-readable JSON instead of the human-readable report')
+        .action((opts) => {
+        const projectRoot = process.cwd();
+        const sequencePath = path.join(projectRoot, 'oprim', 'sequence.yaml');
+        if (!fs.existsSync(sequencePath)) {
+            console.error("No oprim/sequence.yaml found — run 'oprim init' first");
+            process.exitCode = 1;
+            return;
+        }
+        let board;
+        try {
+            board = yaml.load(fs.readFileSync(sequencePath, 'utf-8')) ?? {};
+        }
+        catch {
+            console.error('Failed to parse oprim/sequence.yaml');
+            process.exitCode = 1;
+            return;
+        }
+        const now = board.now ?? [];
+        const next = board.next ?? [];
+        const later = board.later ?? [];
+        const backlog = board.backlog ?? [];
+        if (opts.json) {
+            console.log(JSON.stringify({ wip_limits: board.wip_limits ?? {}, now, next, later, backlog }));
+            return;
+        }
+        console.log(chalk_1.default.bold('oprim status') + '\n');
+        const wipLimit = board.wip_limits?.now;
+        const wipLine = wipLimit !== undefined ? `${now.length}/${wipLimit}` : `${now.length}`;
+        console.log(chalk_1.default.dim(`WIP (now): ${wipLine}`));
+        const lanes = [
+            ['now', now],
+            ['next', next],
+            ['later', later],
+            ['backlog', backlog],
+        ];
+        for (const [label, bets] of lanes) {
+            console.log(chalk_1.default.bold.cyan(`\n── ${label.toUpperCase()} ──`));
+            if (bets.length === 0) {
+                console.log('  (empty)');
+                continue;
+            }
+            for (const bet of bets) {
+                console.log(`  ${bet.id}  ${bet.title}`);
+            }
+        }
+    });
+}

package/dist/lib/artifacts.d.ts

@@ -0,0 +1,44 @@
+export interface BetSummary {
+    id: string;
+    title: string;
+    status: string | null;
+    path: string;
+}
+export interface DecisionSummary {
+    id: string;
+    title: string;
+    status: string | null;
+    path: string;
+}
+export interface NoteSummary {
+    id: string;
+    title: string;
+    tags: string[];
+    path: string;
+}
+/** Parses a bet-decision.md body for its title and `- Decision: <status>` line. */
+export declare function parseBetDecision(content: string): {
+    title: string;
+    status: string | null;
+};
+/** Enumerates bets under oprim/bets/pending/ and oprim/bets/archived/. */
+export declare function listBets(projectRoot: string): BetSummary[];
+/** Parses a PDR file for its id, title, and status (ported from decisionsViewScriptTemplate). */
+export declare function parsePdrFile(content: string): {
+    id: string | null;
+    title: string;
+    status: string | null;
+};
+/** Enumerates decisions (PDRs) under oprim/decisions/. */
+export declare function listDecisions(projectRoot: string): DecisionSummary[];
+/** Parses a note's frontmatter (title, tags) — falls back to empty values if frontmatter is absent/unparsable. */
+export declare function parseNoteFrontmatter(content: string): {
+    title: string;
+    tags: string[];
+};
+/** Enumerates notes under oprim/notes/. */
+export declare function listNotes(projectRoot: string): NoteSummary[];
+/** Resolves a PDR ID (accepting `pdr-005`, `005`, `5`, or `PDR-005`) to its file path under oprim/decisions/. */
+export declare function resolvePdrPath(projectRoot: string, idInput: string): string | null;
+/** Resolves a note ID (accepting `note-005`, `005`, `5`, or `NOTE-005`) to its file path under oprim/notes/. */
+export declare function resolveNotePath(projectRoot: string, idInput: string): string | null;

package/dist/lib/artifacts.js

@@ -0,0 +1,163 @@
+"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.parseBetDecision = parseBetDecision;
+exports.listBets = listBets;
+exports.parsePdrFile = parsePdrFile;
+exports.listDecisions = listDecisions;
+exports.parseNoteFrontmatter = parseNoteFrontmatter;
+exports.listNotes = listNotes;
+exports.resolvePdrPath = resolvePdrPath;
+exports.resolveNotePath = resolveNotePath;
+const path = __importStar(require("path"));
+const fs = __importStar(require("fs"));
+const yaml = __importStar(require("js-yaml"));
+function extractBetId(dirName) {
+    return dirName.match(/^BET-\d+/)?.[0] ?? dirName;
+}
+/** Parses a bet-decision.md body for its title and `- Decision: <status>` line. */
+function parseBetDecision(content) {
+    const titleMatch = content.match(/^#\s*Decision:\s*BET-\d+\s+(.*)$/m);
+    const statusMatch = content.match(/^-\s*Decision:\s*(.+)$/m);
+    return {
+        title: titleMatch ? titleMatch[1].trim() : '',
+        status: statusMatch ? statusMatch[1].trim() : null,
+    };
+}
+/** Enumerates bets under oprim/bets/pending/ and oprim/bets/archived/. */
+function listBets(projectRoot) {
+    const results = [];
+    for (const sub of ['pending', 'archived']) {
+        const dir = path.join(projectRoot, 'oprim', 'bets', sub);
+        if (!fs.existsSync(dir))
+            continue;
+        const entries = fs.readdirSync(dir, { withFileTypes: true }).filter((e) => e.isDirectory());
+        for (const entry of entries) {
+            const decisionPath = path.join(dir, entry.name, 'bet-decision.md');
+            if (!fs.existsSync(decisionPath))
+                continue;
+            const content = fs.readFileSync(decisionPath, 'utf-8');
+            const { title, status } = parseBetDecision(content);
+            results.push({
+                id: extractBetId(entry.name),
+                title,
+                status,
+                path: path.relative(projectRoot, decisionPath),
+            });
+        }
+    }
+    return results;
+}
+/** Parses a PDR file for its id, title, and status (ported from decisionsViewScriptTemplate). */
+function parsePdrFile(content) {
+    const idMatch = content.match(/^#\s*(PDR-\d+)[:\s]*(.*)$/m);
+    const id = idMatch ? idMatch[1] : null;
+    const title = idMatch ? idMatch[2].trim() : '';
+    const statusMatch = content.match(/^##\s*Status\s*\n(.+)$/m) ?? content.match(/^Status:\s*(.+)$/m);
+    const status = statusMatch ? statusMatch[1].trim() : null;
+    return { id, title, status };
+}
+/** Enumerates decisions (PDRs) under oprim/decisions/. */
+function listDecisions(projectRoot) {
+    const dir = path.join(projectRoot, 'oprim', 'decisions');
+    if (!fs.existsSync(dir))
+        return [];
+    const results = [];
+    const files = fs.readdirSync(dir).filter((f) => /^PDR-\d+.*\.md$/.test(f));
+    for (const file of files) {
+        const filePath = path.join(dir, file);
+        const content = fs.readFileSync(filePath, 'utf-8');
+        const { id, title, status } = parsePdrFile(content);
+        if (!id)
+            continue;
+        results.push({ id, title, status, path: path.relative(projectRoot, filePath) });
+    }
+    return results;
+}
+/** Parses a note's frontmatter (title, tags) — falls back to empty values if frontmatter is absent/unparsable. */
+function parseNoteFrontmatter(content) {
+    const fmMatch = content.match(/^---\n([\s\S]*?)\n---/);
+    if (!fmMatch)
+        return { title: '', tags: [] };
+    try {
+        const fm = (yaml.load(fmMatch[1]) ?? {});
+        return { title: fm.title ?? '', tags: fm.tags ?? [] };
+    }
+    catch {
+        return { title: '', tags: [] };
+    }
+}
+/** Enumerates notes under oprim/notes/. */
+function listNotes(projectRoot) {
+    const dir = path.join(projectRoot, 'oprim', 'notes');
+    if (!fs.existsSync(dir))
+        return [];
+    const results = [];
+    const files = fs.readdirSync(dir).filter((f) => /^NOTE-\d+.*\.md$/.test(f));
+    for (const file of files) {
+        const idMatch = file.match(/^(NOTE-\d+)/);
+        if (!idMatch)
+            continue;
+        const filePath = path.join(dir, file);
+        const content = fs.readFileSync(filePath, 'utf-8');
+        const { title, tags } = parseNoteFrontmatter(content);
+        results.push({ id: idMatch[1], title, tags, path: path.relative(projectRoot, filePath) });
+    }
+    return results;
+}
+function normalizeArtifactId(prefix, input) {
+    const digits = input.replace(/[^0-9]/g, '');
+    return `${prefix}-${digits.padStart(3, '0')}`;
+}
+function resolveByPrefix(dir, id) {
+    if (!fs.existsSync(dir))
+        return null;
+    const files = fs.readdirSync(dir).filter((f) => f.endsWith('.md'));
+    const exact = files.find((f) => f === `${id}.md`);
+    if (exact)
+        return path.join(dir, exact);
+    const slugMatches = files.filter((f) => f.startsWith(`${id}-`));
+    if (slugMatches.length === 1)
+        return path.join(dir, slugMatches[0]);
+    return null;
+}
+/** Resolves a PDR ID (accepting `pdr-005`, `005`, `5`, or `PDR-005`) to its file path under oprim/decisions/. */
+function resolvePdrPath(projectRoot, idInput) {
+    return resolveByPrefix(path.join(projectRoot, 'oprim', 'decisions'), normalizeArtifactId('PDR', idInput));
+}
+/** Resolves a note ID (accepting `note-005`, `005`, `5`, or `NOTE-005`) to its file path under oprim/notes/. */
+function resolveNotePath(projectRoot, idInput) {
+    return resolveByPrefix(path.join(projectRoot, 'oprim', 'notes'), normalizeArtifactId('NOTE', idInput));
+}

package/dist/lib/install-agent.js

@@ -155,8 +155,8 @@ async function promptOkfFrontmatter() {
 }
 // Workflow ids installed as Claude/Poolside/Cursor skill files — see packages/cli/src/workflows/.
 // Order matches the pre-refactor CLAUDE_SKILLS/POOLSIDE_SKILLS/CURSOR_SKILLS declaration order.
-const CLAUDE_SKILL_WORKFLOW_IDS = ['pdr', 'bet', 'note', 'criteria', 'review', 'archive', 'sequence', 'context'];
-const POOLSIDE_SKILL_WORKFLOW_IDS = ['pdr', 'bet', 'note', 'criteria', 'review', 'archive', 'sequence'];
+const CLAUDE_SKILL_WORKFLOW_IDS = ['pdr', 'bet', 'note', 'criteria', 'review', 'archive', 'sequence', 'context', 'explore', 'reconcile'];
+const POOLSIDE_SKILL_WORKFLOW_IDS = ['pdr', 'bet', 'note', 'criteria', 'review', 'archive', 'sequence', 'explore', 'reconcile'];
 const CURSOR_SKILL_WORKFLOW_IDS = ['pdr', 'bet', 'note', 'criteria', 'review'];
 // Claude command wrappers (thin, invoke skill) — filename -> workflow id. Order matches the
 // pre-refactor CLAUDE_COMMANDS declaration order.
@@ -165,6 +165,8 @@ const CLAUDE_COMMAND_WORKFLOWS = [
     { filename: 'sequence.md', id: 'sequence' },
     { filename: 'archive.md', id: 'archive' },
     { filename: 'context-init.md', id: 'context' },
+    { filename: 'explore.md', id: 'explore' },
+    { filename: 'reconcile.md', id: 'reconcile' },
 ];
 // Cursor command files (full inline). Order matches the pre-refactor CURSOR_COMMANDS declaration order.
 const CURSOR_COMMAND_WORKFLOW_IDS = ['promote', 'sequence', 'pdr', 'bet', 'note', 'criteria', 'review'];

package/dist/lib/workflow-renderer.js

@@ -8,7 +8,7 @@ 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'];
+const INLINE_SECTION_ORDER = ['bet', 'note', 'criteria', 'pdr', 'review', 'archive', 'sequence', 'explore', 'reconcile'];
 function claudeWrapper(name, description, body) {
     return `---
 name: "${name}"

package/dist/workflows/explore.inline.md

@@ -0,0 +1,9 @@
+### Problem exploration (oprim-explore)
+Investigate a problem or opportunity and compare candidate framings, before any decision artifact is written. Read-only and non-committal — never writes a `bet-decision.md`.
+
+1. Ask for the problem or opportunity (a sentence or two).
+2. Surface related PDRs: scan `oprim/decisions/PDR-*.md`, extract keywords from the problem statement, list matches by filename/title/body relevance.
+3. Surface related notes: scan `oprim/notes/NOTE-*.md` the same way.
+4. Surface related bets: scan `oprim/bets/pending/` and `oprim/bets/archived/` for bet-decisions with similar titles or "Why now" content — flag archived matches explicitly, since they may mean this ground has been covered before.
+5. Ask for candidate approaches/framings (description + main tradeoff each) and present them side by side without recommending one, unless asked.
+6. Report what was surfaced and, if the user has converged on a candidate, tell them to run `/oprim:bet` to draft the decision — explore does not create the bet itself.

package/dist/workflows/explore.schema.yaml

@@ -0,0 +1,13 @@
+id: explore
+skillName: oprim-explore
+title: "OPRIM: Explore"
+description: Investigate a problem and compare candidate framings before a bet is drafted
+claude:
+  skill: true
+  command: explore.md
+cursor:
+  skill: false
+  command: null
+poolside:
+  skill: true
+inline: true

package/dist/workflows/explore.template.md

@@ -0,0 +1,54 @@
+---
+name: oprim-explore
+description: Investigate a problem and compare candidate framings before a bet is drafted
+---
+
+Investigate a problem or opportunity and compare candidate framings, before any decision artifact is written. This is oprim's think-first phase — it sits upstream of `/oprim:bet`, not in place of it.
+
+**Interactive prompts:** Use the **AskUserQuestion tool** for every question in this skill — do not write questions as plain text.
+
+## What you're doing
+
+Explore is read-only and non-committal: it never writes a `bet-decision.md`. Use it when you've noticed a problem or opportunity but haven't yet converged on what to build, or when there are multiple plausible approaches worth weighing before committing to one. Once a candidate framing is worth committing to, hand off to `/oprim:bet` to draft the decision artifact — that boundary is deliberate, so explore doesn't duplicate `oprim-bet`'s job or drift into writing decisions itself.
+
+## Steps
+
+### 1. Get the problem or opportunity
+If not provided, ask: "What problem or opportunity do you want to explore? (a sentence or two)"
+
+### 2. Surface related PDRs
+Scan `oprim/decisions/` for files matching `PDR-*.md`. If the directory is empty or missing, skip this step. Otherwise, extract 3–10 keywords from the problem statement (subject-area nouns, capability names, bet IDs). For each PDR file, read the filename and first 25 lines; a PDR is relevant if any keyword appears in its filename, title, or body (case-insensitive). List matches:
+
+**Related product decisions:**
+- PDR-NNN: <title> — <Status> (`oprim/decisions/PDR-NNN-<slug>.md`)
+
+If none match, state that plainly and continue.
+
+### 3. Surface related notes
+Scan `oprim/notes/` for files matching `NOTE-*.md`. Using the same keywords from step 2, list notes whose title or body mention them:
+
+**Related notes:**
+- NOTE-NNN: <title> (`oprim/notes/NOTE-NNN-<slug>.md`)
+
+If `oprim/notes/` is empty or missing, or nothing matches, state that plainly and continue.
+
+### 4. Surface related bets
+Scan `oprim/bets/pending/` and `oprim/bets/archived/` for `bet-decision.md` files whose title or `## Why now` section mentions the keywords from step 2. List matches, noting whether each is pending or archived:
+
+**Related bets:**
+- BET-NNN: <title> — <pending/archived> (`oprim/bets/<pending|archived>/BET-NNN.../bet-decision.md`)
+
+An archived match with a similar problem statement is worth flagging explicitly — it may mean this ground has been covered before.
+
+### 5. Gather candidate framings
+Ask: "What are the candidate approaches or framings worth comparing? (list as many as you'd like — one is fine if you already have a clear direction)"
+
+For each candidate, ask for:
+- A one-line description
+- The main tradeoff or risk (what makes this candidate weaker than the alternatives, or what's uncertain about it)
+
+### 6. Compare candidates
+Present the candidates side by side (name, description, main tradeoff). Do not recommend one over another unless asked — the point of explore is to lay out the comparison clearly, not to decide for the user.
+
+### 7. Report and hand off
+Summarize what was surfaced (PDRs, notes, bets, candidate comparison). If the user has converged on a candidate worth committing to, tell them to run `/oprim:bet` to draft the decision artifact — explore does not create one itself. If no candidate has converged yet, note that explicitly and suggest gathering more information before drafting a bet.

package/dist/workflows/reconcile.inline.md

@@ -0,0 +1,8 @@
+### Artifact reconciliation (oprim-reconcile)
+Detect and fix drift across linked oprim artifacts (PDR ↔ bet, bet ↔ review). Never batch-applies a fix — every proposed change is confirmed individually before being written.
+
+1. Scan every `bet-decision.md` under `oprim/bets/pending/` and `oprim/bets/archived/`: check each `## Links` reference (PDRs, Notes, Spec (delta), OpenSpec change) actually resolves to an existing file/path.
+2. Scan every `oprim/reviews/YYYY-MM-DD-BET-NNN-kpi.md` filename: check the referenced BET-NNN still exists in pending or archived bets.
+3. If nothing is found, report "No drift detected" and stop.
+4. Otherwise, list every drift entry, propose a specific fix per entry (e.g. remove a dangling ID from a `## Links` line), and ask "Apply this fix? (y/N)" one item at a time — apply only confirmed fixes.
+5. Report how many drift entries were found, fixed, and left unresolved.

package/dist/workflows/reconcile.schema.yaml

@@ -0,0 +1,13 @@
+id: reconcile
+skillName: oprim-reconcile
+title: "OPRIM: Reconcile"
+description: Detect and fix drift across linked oprim artifacts (PDR, bet, criteria, review)
+claude:
+  skill: true
+  command: reconcile.md
+cursor:
+  skill: false
+  command: null
+poolside:
+  skill: true
+inline: true

package/dist/workflows/reconcile.template.md

@@ -0,0 +1,51 @@
+---
+name: oprim-reconcile
+description: Detect and fix drift across linked oprim artifacts (PDR, bet, criteria, review)
+---
+
+Detect drift across linked oprim artifacts — PDR ↔ bet, bet ↔ criteria, bet ↔ review — and fix it with the user's per-item confirmation. Reconcile never batch-applies a fix; every proposed change is surfaced individually before it's written.
+
+**Interactive prompts:** Use the **AskUserQuestion tool** for every question in this skill — do not write questions as plain text.
+
+## What you're doing
+
+oprim artifacts reference each other (a bet's `## Links` section names PDRs, notes, and specs; a review's filename names the bet it reviews) but nothing currently checks those references stay valid as artifacts are renamed, moved, or archived. Reconcile is a read-then-confirm-then-write pass over that link graph — it detects drift, proposes a specific fix per item, and only writes a fix the user confirms. This is distinct from `oprim doctor`, which reports sequencing-board and skill-drift issues but never writes a fix itself.
+
+## Steps
+
+### 1. Scan bet-decision `## Links` sections
+For every `bet-decision.md` under `oprim/bets/pending/` and `oprim/bets/archived/`, read its `## Links` section and check each reference:
+- `PDRs: PDR-NNN, ...` — for each ID (skip "None"), verify a matching `oprim/decisions/PDR-NNN-*.md` exists
+- `Notes: NOTE-NNN, ...` — for each ID, verify a matching `oprim/notes/NOTE-NNN-*.md` exists
+- `Spec (delta): <path>` — verify the path exists
+- `OpenSpec change: <path>` — skip if the value is still a placeholder (e.g. "to be filled when promoted" or "None"); otherwise verify the path exists
+
+Record a drift entry for every reference that fails to resolve: which bet, which link line, which ID/path is missing.
+
+### 2. Scan review filenames against bets
+For every `oprim/reviews/YYYY-MM-DD-BET-NNN-kpi.md` file, extract `BET-NNN` and verify a matching bet directory exists in either `oprim/bets/pending/` or `oprim/bets/archived/`. Record a drift entry for any review whose bet can't be found.
+
+### 3. Scan criteria.yaml placement
+For every `oprim/bets/pending/BET-NNN.../criteria.yaml`, this is only valid while the bet is pending — it's expected to travel with the bet directory on archive, so no separate reference check is needed here. Skip this step; it exists to document why criteria.yaml isn't independently checked.
+
+### 4. Report detected drift
+If no drift was found in steps 1–2, report "No drift detected across PDR/bet/criteria/review links" and stop.
+
+Otherwise, list every drift entry found:
+
+**Detected drift:**
+- BET-NNN `## Links`: `PDRs` references PDR-XXX, which does not exist at `oprim/decisions/PDR-XXX-*.md`
+- `oprim/reviews/<file>` references BET-NNN, which does not exist in `oprim/bets/pending/` or `oprim/bets/archived/`
+
+### 5. Propose and confirm a fix, one item at a time
+For each drift entry, propose a specific fix:
+- A dangling PDR/Notes ID in a `## Links` line → propose removing that ID from the comma-separated list (or replacing the line with "None" if it was the only entry)
+- A `Spec (delta)` or `OpenSpec change` path that no longer resolves → propose removing that link line entirely
+- A review referencing a bet that no longer exists → propose no automatic fix (the bet may have been renamed rather than deleted); ask the user to identify the correct BET-NNN or confirm the review is orphaned and should be left as-is
+
+Ask: "Apply this fix? (y/N)" for each entry individually.
+- If confirmed: apply only that fix to the relevant file, then move to the next drift entry.
+- If declined: leave the artifact unchanged and move to the next drift entry.
+
+### 6. Report what was fixed
+Summarize: how many drift entries were found, how many fixes were applied, how many were declined or left for manual follow-up.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@open-product-primer/cli",
-  "version": "2.7.0",
+  "version": "2.9.0",
   "description": "Open Product Primer CLI — product decisions, sequencing, and KPI tracking for repositories",
   "keywords": [
     "product",