@open-product-primer/cli 2.3.0 → 2.5.1

package/dist/commands/init.js

@@ -90,6 +90,7 @@ function initCommand() {
         (0, scaffold_1.writeFile)(path.join(primerDir, 'templates', 'discovery.md'), templates_1.discoveryTemplate);
         (0, scaffold_1.writeFile)(path.join(primerDir, 'templates', 'note.md'), noteContent);
         (0, scaffold_1.writeFile)(path.join(primerDir, 'scripts', 'generate-sequence-view.js'), templates_1.sequenceViewScriptTemplate);
+        (0, scaffold_1.writeFile)(path.join(primerDir, 'scripts', 'generate-decisions-view.js'), templates_1.decisionsViewScriptTemplate);
         if (okfEnabled) {
             (0, scaffold_1.writeFile)(path.join(primerDir, 'index.md'), (0, templates_1.indexTemplate)(projectName));
         }

package/dist/commands/update.js

@@ -71,6 +71,7 @@ function updateCommand() {
         const primerDir = path.join(projectRoot, 'oprim');
         (0, scaffold_1.ensureDir)(path.join(primerDir, 'scripts'));
         (0, scaffold_1.writeFile)(path.join(primerDir, 'scripts', 'generate-sequence-view.js'), templates_1.sequenceViewScriptTemplate);
+        (0, scaffold_1.writeFile)(path.join(primerDir, 'scripts', 'generate-decisions-view.js'), templates_1.decisionsViewScriptTemplate);
         const configPath = path.join(primerDir, 'config.yaml');
         if (fs.existsSync(configPath)) {
             const existingConfig = fs.readFileSync(configPath, 'utf-8');

package/dist/lib/install-agent.js

@@ -90,8 +90,8 @@ async function promptFrameworkSelection(projectRoot) {
     return select({
         message: 'Which speccing framework does this project use?',
         choices: [
-            { name: 'OpenSpec (recommended)', value: 'openspec' },
-            { name: 'Native (oprim-authored specs, no OpenSpec required)', value: 'native' },
+            { name: 'Native (oprim-authored specs, recommended)', value: 'native' },
+            { name: 'OpenSpec', value: 'openspec' },
             { name: 'None', value: 'none' },
         ],
     });
@@ -129,7 +129,7 @@ async function promptAgentSelection(projectRoot) {
 }
 async function promptPdrSurfacing() {
     const { confirm } = await Promise.resolve().then(() => __importStar(require('@inquirer/prompts')));
-    return confirm({ message: 'Enable proactive PDR surfacing in skills? (y/N)', default: false });
+    return confirm({ message: 'Enable proactive PDR surfacing in skills? (Y/n)', default: true });
 }
 async function promptOkfFrontmatter() {
     const { confirm } = await Promise.resolve().then(() => __importStar(require('@inquirer/prompts')));

package/dist/lib/templates.d.ts

@@ -9,4 +9,5 @@ export declare const noteTemplate = "# Note: <Note title>\n\n<Capture the observ
 export declare const criteriaTemplate = "metrics:\n  - id: metric_id\n    name: \"Metric name\"\n    baseline: 0.00\n    target: 0.00\n    timeframe: \"30 days post-launch\"\n    launch_date: \"YYYY-MM-DD\"\n    source:\n      type: amplitude\n      definition:\n        event: event_name\n        aggregation: unique_users\n        denominator_event: null\n    segment: null\n";
 export declare const discoveryTemplate = "# Discovery: BET-XXX <Bet title>\n\n## Problem Framing\n- **Problem statement**: <What problem are we solving and for whom?>\n- **Evidence this is real**: <Data, support tickets, user quotes, etc.>\n- **Why it matters**: <Business or user impact if left unsolved>\n\n## User Research Signals\n- **Research conducted**: <Interviews, surveys, usability tests, etc.>\n- **Key findings**: <What did we learn?>\n- **Assumptions to validate**: <What are we still unsure about?>\n\n## Competitive Context\n- **How others solve this**: <Competitor or adjacent solutions>\n- **Our differentiation**: <Why our approach is better or different>\n- **Gaps / opportunities**: <What's underserved in the market?>\n\n## Open Questions\n- [ ] <Question 1 \u2014 what needs to be answered before committing?>\n- [ ] <Question 2>\n- [ ] <Question 3>\n";
 export declare const sequenceViewScriptTemplate = "#!/usr/bin/env node\n'use strict';\n\nconst fs = require('fs');\nconst path = require('path');\n\nconst SEQUENCE_PATH = path.join(process.cwd(), 'oprim/sequence.yaml');\nconst OUTPUT_PATH = path.join(process.cwd(), 'oprim/sequence-view.md');\nconst MAX_LABEL_LEN = 40;\n\nfunction parseSequenceYaml(text) {\n  const BUCKETS = ['now', 'next', 'later', 'backlog'];\n  const result = Object.fromEntries(BUCKETS.map(b => [b, []]));\n  let section = null, item = null, listField = null;\n\n  for (const raw of text.split('\\n')) {\n    const trimmed = raw.trim();\n    if (!trimmed || trimmed.startsWith('#')) continue;\n    const indent = raw.length - raw.trimStart().length;\n\n    if (indent === 0) {\n      const m = trimmed.match(/^(\\w+):/);\n      if (m) { section = BUCKETS.includes(m[1]) ? m[1] : null; item = null; listField = null; }\n      continue;\n    }\n\n    if (!section) continue;\n\n    if (indent === 2 && trimmed.startsWith('- ')) {\n      item = {}; result[section].push(item); listField = null;\n      const rest = trimmed.slice(2);\n      const m = rest.match(/^(\\w+):\\s*(.*)/);\n      if (m) item[m[1]] = m[2].replace(/^['\"]|['\"]$/g, '').trim();\n      continue;\n    }\n\n    if (indent === 4 && item) {\n      const m = trimmed.match(/^(\\w+):\\s*(.*)/);\n      if (!m) continue;\n      const [, key, val] = m;\n      const v = val.trim();\n      if (v === '[]') { item[key] = []; listField = null; }\n      else if (v === '') { item[key] = []; listField = key; }\n      else { item[key] = v.replace(/^['\"]|['\"]$/g, ''); listField = null; }\n      continue;\n    }\n\n    if (indent === 6 && item && listField && trimmed.startsWith('- ')) {\n      item[listField].push(trimmed.slice(2).trim());\n    }\n  }\n  return result;\n}\n\nfunction nodeId(betId) { return betId.replace(/-/g, ''); }\n\nfunction truncate(title) {\n  return title.length > MAX_LABEL_LEN ? title.slice(0, MAX_LABEL_LEN - 3) + '...' : title;\n}\n\nfunction generateMermaidBlock(seq) {\n  const lines = ['```mermaid', 'graph TD'];\n  const ACTIVE = [['now', 'Now'], ['next', 'Next'], ['later', 'Later']];\n\n  for (const [key, label] of ACTIVE) {\n    const bets = seq[key] || [];\n    if (!bets.length) continue;\n    lines.push('    subgraph ' + label);\n    for (const bet of bets) {\n      lines.push('        ' + nodeId(bet.id) + '[\"' + bet.id + ': ' + truncate(bet.title) + '\"]');\n    }\n    lines.push('    end');\n  }\n\n  for (const [key] of ACTIVE) {\n    for (const bet of (seq[key] || [])) {\n      for (const blocker of (bet.blocked_by || [])) {\n        lines.push('    ' + nodeId(bet.id) + ' --> ' + nodeId(blocker));\n      }\n    }\n  }\n\n  lines.push('```');\n  return lines.join('\\n');\n}\n\nfunction generateBacklogSection(seq) {\n  const backlog = seq.backlog || [];\n  if (!backlog.length) return '';\n  return '\\n\\n### Backlog\\n' + backlog.map(b => '- **' + b.id + '**: ' + b.title).join('\\n');\n}\n\nfunction main() {\n  const seq = parseSequenceYaml(fs.readFileSync(SEQUENCE_PATH, 'utf8'));\n  const header = [\n    '<!-- Auto-generated from oprim/sequence.yaml. Do not edit directly. -->',\n    '<!-- Regenerate by running: node oprim/scripts/generate-sequence-view.js -->',\n    '',\n    '# Sequencing Board',\n    '',\n    '',\n  ].join('\\n');\n  fs.writeFileSync(OUTPUT_PATH, header + generateMermaidBlock(seq) + generateBacklogSection(seq) + '\\n');\n  console.log('Written: oprim/sequence-view.md');\n}\n\nmain();\n";
+export declare const decisionsViewScriptTemplate = "#!/usr/bin/env node\n'use strict';\n\nconst fs = require('fs');\nconst path = require('path');\n\nconst DECISIONS_DIR = path.join(process.cwd(), 'oprim/decisions');\nconst OUTPUT_PATH = path.join(process.cwd(), 'oprim/decisions-view.md');\n\nfunction parsePdrFile(text) {\n  const idMatch = text.match(/^#\\s*(PDR-\\d+)[:\\s]*(.*)$/m);\n  const id = idMatch ? idMatch[1] : null;\n  const title = idMatch ? idMatch[2].trim() : '';\n\n  const statusMatch = text.match(/^##\\s*Status\\s*\\n(.+)$/m) || text.match(/^Status:\\s*(.+)$/m);\n  const statusLine = statusMatch ? statusMatch[1].trim() : '';\n  const supersededMatch = statusLine.match(/Superseded by (PDR-\\d+)/);\n\n  return {\n    id,\n    title,\n    status: statusLine,\n    supersededBy: supersededMatch ? supersededMatch[1] : null,\n  };\n}\n\nfunction readPdrs() {\n  if (!fs.existsSync(DECISIONS_DIR)) return [];\n  const files = fs.readdirSync(DECISIONS_DIR).filter(f => /^PDR-\\d+.*\\.md$/.test(f));\n  return files\n    .map(f => ({ file: f, ...parsePdrFile(fs.readFileSync(path.join(DECISIONS_DIR, f), 'utf8')) }))\n    .filter(pdr => pdr.id);\n}\n\nfunction generateBody(pdrs) {\n  if (pdrs.length === 0) {\n    return 'No decisions yet. Run `/oprim:pdr` to record your first product decision.\\n';\n  }\n\n  const byId = Object.fromEntries(pdrs.map(p => [p.id, p]));\n  const supersededOf = {};\n  for (const pdr of pdrs) {\n    if (pdr.supersededBy && byId[pdr.supersededBy]) {\n      (supersededOf[pdr.supersededBy] = supersededOf[pdr.supersededBy] || []).push(pdr);\n    }\n  }\n\n  const current = pdrs.filter(p => !p.supersededBy);\n  if (current.length === 0) {\n    return 'No current decisions \u2014 all recorded PDRs have been superseded.\\n';\n  }\n\n  const lines = ['## Current decisions', ''];\n  for (const pdr of current) {\n    lines.push('- **' + pdr.id + '**: ' + pdr.title);\n    for (const old of (supersededOf[pdr.id] || [])) {\n      lines.push('  - supersedes [' + old.id + '](decisions/' + old.file + '): ' + old.title);\n    }\n  }\n\n  return lines.join('\\n') + '\\n';\n}\n\nfunction main() {\n  const pdrs = readPdrs();\n  const header = [\n    '<!-- Auto-generated from oprim/decisions/. Do not edit directly. -->',\n    '<!-- Regenerate by running: node oprim/scripts/generate-decisions-view.js -->',\n    '',\n    '# Current Decisions',\n    '',\n    '',\n  ].join('\\n');\n  fs.writeFileSync(OUTPUT_PATH, header + generateBody(pdrs));\n  console.log('Written: oprim/decisions-view.md');\n}\n\nmain();\n";
 export declare const kpiReviewTemplate = "# KPI Review: BET-XXX\n\n**Review date:** YYYY-MM-DD\n**Reviewed by:** <name>\n\n| Metric | Baseline | Target | Actual | Status |\n|--------|----------|--------|--------|--------|\n| <metric name> | - | - | - | pending |\n\n## Decision quality\n<Did outcomes validate the decision? What would you do differently?>\n\n## Actions\n- [ ] Update bet-decision outcome section\n- [ ] Update affected PDRs\n- [ ] Re-sequence impacted bets\n";

package/dist/lib/templates.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.kpiReviewTemplate = exports.sequenceViewScriptTemplate = exports.discoveryTemplate = exports.criteriaTemplate = exports.noteTemplate = exports.betDecisionTemplate = exports.pdrTemplate = exports.sequenceTemplate = void 0;
+exports.kpiReviewTemplate = exports.decisionsViewScriptTemplate = exports.sequenceViewScriptTemplate = exports.discoveryTemplate = exports.criteriaTemplate = exports.noteTemplate = exports.betDecisionTemplate = exports.pdrTemplate = exports.sequenceTemplate = void 0;
 exports.configTemplate = configTemplate;
 exports.okfFrontmatter = okfFrontmatter;
 exports.noteMinimalFrontmatter = noteMinimalFrontmatter;
@@ -283,6 +283,85 @@ function main() {
   console.log('Written: oprim/sequence-view.md');
 }
 
+main();
+`;
+exports.decisionsViewScriptTemplate = `#!/usr/bin/env node
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+
+const DECISIONS_DIR = path.join(process.cwd(), 'oprim/decisions');
+const OUTPUT_PATH = path.join(process.cwd(), 'oprim/decisions-view.md');
+
+function parsePdrFile(text) {
+  const idMatch = text.match(/^#\\s*(PDR-\\d+)[:\\s]*(.*)$/m);
+  const id = idMatch ? idMatch[1] : null;
+  const title = idMatch ? idMatch[2].trim() : '';
+
+  const statusMatch = text.match(/^##\\s*Status\\s*\\n(.+)$/m) || text.match(/^Status:\\s*(.+)$/m);
+  const statusLine = statusMatch ? statusMatch[1].trim() : '';
+  const supersededMatch = statusLine.match(/Superseded by (PDR-\\d+)/);
+
+  return {
+    id,
+    title,
+    status: statusLine,
+    supersededBy: supersededMatch ? supersededMatch[1] : null,
+  };
+}
+
+function readPdrs() {
+  if (!fs.existsSync(DECISIONS_DIR)) return [];
+  const files = fs.readdirSync(DECISIONS_DIR).filter(f => /^PDR-\\d+.*\\.md$/.test(f));
+  return files
+    .map(f => ({ file: f, ...parsePdrFile(fs.readFileSync(path.join(DECISIONS_DIR, f), 'utf8')) }))
+    .filter(pdr => pdr.id);
+}
+
+function generateBody(pdrs) {
+  if (pdrs.length === 0) {
+    return 'No decisions yet. Run \`/oprim:pdr\` to record your first product decision.\\n';
+  }
+
+  const byId = Object.fromEntries(pdrs.map(p => [p.id, p]));
+  const supersededOf = {};
+  for (const pdr of pdrs) {
+    if (pdr.supersededBy && byId[pdr.supersededBy]) {
+      (supersededOf[pdr.supersededBy] = supersededOf[pdr.supersededBy] || []).push(pdr);
+    }
+  }
+
+  const current = pdrs.filter(p => !p.supersededBy);
+  if (current.length === 0) {
+    return 'No current decisions — all recorded PDRs have been superseded.\\n';
+  }
+
+  const lines = ['## Current decisions', ''];
+  for (const pdr of current) {
+    lines.push('- **' + pdr.id + '**: ' + pdr.title);
+    for (const old of (supersededOf[pdr.id] || [])) {
+      lines.push('  - supersedes [' + old.id + '](decisions/' + old.file + '): ' + old.title);
+    }
+  }
+
+  return lines.join('\\n') + '\\n';
+}
+
+function main() {
+  const pdrs = readPdrs();
+  const header = [
+    '<!-- Auto-generated from oprim/decisions/. Do not edit directly. -->',
+    '<!-- Regenerate by running: node oprim/scripts/generate-decisions-view.js -->',
+    '',
+    '# Current Decisions',
+    '',
+    '',
+  ].join('\\n');
+  fs.writeFileSync(OUTPUT_PATH, header + generateBody(pdrs));
+  console.log('Written: oprim/decisions-view.md');
+}
+
 main();
 `;
 exports.kpiReviewTemplate = `# KPI Review: BET-XXX

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

@@ -1 +1 @@
-Create a new PDR in `oprim/decisions/`. Scan for `PDR-(\d+)-` to assign next ID (zero-padded, default 001). Read `oprim/config.yaml`'s `rules.pdr` — if non-empty, apply it as additional guidance and reflect it in the generated content; if empty, behavior is unchanged. Gather: title, context, decision, alternatives, consequences, evidence, related bets/specs. Ask if superseding an existing PDR. Write `oprim/decisions/PDR-NNN-<slug>.md`. If superseding: update old PDR Status to "Superseded by PDR-NNN". Report what was created.
+Create a new PDR in `oprim/decisions/`. Scan for `PDR-(\d+)-` to assign next ID (zero-padded, default 001). Read `oprim/config.yaml`'s `rules.pdr` — if non-empty, apply it as additional guidance and reflect it in the generated content; if empty, behavior is unchanged. Gather: title, context, decision, alternatives, consequences, evidence, related bets/specs. Ask if superseding an existing PDR. Write `oprim/decisions/PDR-NNN-<slug>.md`. If superseding: update old PDR Status to "Superseded by PDR-NNN". Report what was created. Then run `node oprim/scripts/generate-decisions-view.js` from the project root to update `oprim/decisions-view.md`.

package/dist/workflows/pdr.inline.md

@@ -7,4 +7,5 @@ Create a new Product Decision Record in `oprim/decisions/`.
 3. Gather: context, decision, alternatives, consequences, evidence, related bets/specs.
 4. Ask if superseding an existing PDR.
 5. Write `oprim/decisions/PDR-NNN-<slug>.md`. If superseding, update old PDR Status.
-6. Report what was created.
+6. Report what was created.
+7. Run `node oprim/scripts/generate-decisions-view.js` from the project root to update `oprim/decisions-view.md`.

package/dist/workflows/pdr.template.md

@@ -65,3 +65,6 @@ Proposed
 Read the superseded file → replace Status value with `Superseded by PDR-NNN` → write back.
 
 ### 7. Report what was created
+
+### 8. Regenerate the decisions rollup view
+Run `node oprim/scripts/generate-decisions-view.js` from the project root to update `oprim/decisions-view.md`.

package/dist/workflows/tutorial.schema.yaml

@@ -0,0 +1,13 @@
+id: tutorial
+skillName: oprim-tutorial
+title: null
+description: Guided walkthrough of the oprim bet -> spec -> archive cycle inside the todo-app example workspace (examples/) -- creates a real "add due dates to tasks" bet, specs it, and archives it, narrating each step against the example's existing PDRs, bets, and current-truth specs
+claude:
+  skill: true
+  command: null
+cursor:
+  skill: true
+  command: null
+poolside:
+  skill: true
+inline: false

package/dist/workflows/tutorial.template.md

@@ -0,0 +1,45 @@
+---
+name: oprim-tutorial
+description: Guided walkthrough of the oprim bet -> spec -> archive cycle inside the todo-app example workspace (examples/) -- creates a real "add due dates to tasks" bet, specs it, and archives it, narrating each step against the example's existing PDRs, bets, and current-truth specs
+---
+
+Walk the user through one full oprim workflow cycle — bet → spec → archive — inside this example workspace, using a real new feature for the mock todo app: **"Add due dates to tasks."** This is not a simulation: it invokes the same `oprim-bet`, `oprim-spec`, and `oprim-archive` skills a real project uses, against this workspace's real files.
+
+**Interactive prompts:** Use the **AskUserQuestion tool** for every question you ask directly. When a step delegates to another skill via the Skill tool, that skill drives its own prompts.
+
+## Before you start
+
+Orient the user in 2-3 sentences before Step 1:
+- This workspace (`oprim/`) already has a working example: `PDR-001`/`PDR-002` record two early product decisions, `BET-001` (archived) shipped the core add/complete/delete loop, and `oprim/specs/task-management/spec.md` is that feature's current-truth spec. `BET-002` (pending) is a backlog idea for later.
+- This tutorial adds a new bet on top of that foundation — due dates — and carries it all the way through the cycle: bet decision → spec delta → archive.
+
+## Steps
+
+### 1. Create the bet
+Invoke the **`oprim-bet`** skill using the Skill tool. Suggest (but do not force) the title **"Add due dates to tasks"** if the user doesn't already have one in mind, and note that PDR-001 (flat lists) and PDR-002 (local-only storage) are the relevant prior decisions to link.
+
+After the skill finishes, confirm the new bet's ID (it will be the next available `BET-NNN` — `BET-003` if this is the first tutorial run) and its directory under `oprim/bets/pending/`.
+
+### 2. Author the spec delta
+Invoke the **`oprim-spec`** skill using the Skill tool, passing the bet ID from Step 1. When it asks for a capability name, suggest **"task-management"** — the same capability `BET-001` shipped — since due dates extend that existing surface rather than introducing a new one. When it asks whether each requirement is ADDED/MODIFIED/REMOVED, this is an ADDED requirement (due dates are new, nothing existing changes).
+
+This also scaffolds `design.md` and `tasks.md` for the bet (first `oprim-spec` invocation for a bet always does). Point the user at both files afterward.
+
+### 3. Note the pre-archive state
+Before archiving, briefly show the user what's about to change:
+- `oprim/bets/pending/BET-NNN-.../` will move to `oprim/bets/archived/`
+- The new ADDED requirement(s) will be appended to the existing `oprim/specs/task-management/spec.md` (current truth), alongside the three requirements `BET-001` already put there
+- The bet's entry will be removed from `oprim/sequence.yaml`
+
+This is the same fold `/oprim:archive` performs on any real project — nothing tutorial-specific happens here.
+
+### 4. Archive the bet
+Invoke the **`oprim-archive`** skill using the Skill tool, passing the bet ID from Step 1. Let it run its normal checks (dependents, delta overlaps, incomplete `tasks.md`) — if `tasks.md` still has unchecked items, that's expected for a fresh tutorial run; the user can confirm through the warning or check off items first.
+
+### 5. Show the result
+Report what changed, pointing at real file paths:
+- `oprim/bets/archived/BET-NNN-.../` — the completed bet, in full
+- `oprim/specs/task-management/spec.md` — now includes the due-date requirement(s) alongside `BET-001`'s original three
+- `oprim/sequence.yaml` — no longer lists `BET-NNN`
+
+Close by telling the user they just completed a full oprim cycle — the same one this tool uses on itself (see this repository's own `oprim/` workspace) — and that running it again works identically on their own project after `oprim init`.

package/package.json

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