@open-product-primer/cli 0.5.0 → 0.7.1

package/dist/commands/doctor.js

@@ -189,6 +189,8 @@ function doctorCommand() {
             for (const entry of betEntries) {
                 if (!entry.isDirectory())
                     continue;
+                if (entry.name === 'archived')
+                    continue;
                 const betDir = path.join(betsDir, entry.name);
                 const hasDecision = fs.existsSync(path.join(betDir, 'bet-decision.md'));
                 if (!hasDecision)

package/dist/commands/init.js

@@ -64,6 +64,7 @@ function initCommand() {
         (0, scaffold_1.ensureDir)(path.join(primerDir, 'bets'));
         (0, scaffold_1.ensureDir)(path.join(primerDir, 'reviews'));
         (0, scaffold_1.ensureDir)(path.join(primerDir, 'templates'));
+        (0, scaffold_1.ensureDir)(path.join(primerDir, 'scripts'));
         const configWritten = (0, scaffold_1.writeFileIfAbsent)(path.join(primerDir, 'config.yaml'), (0, templates_1.configTemplate)(projectName, openspec.detected, graphify.detected));
         const sequenceWritten = (0, scaffold_1.writeFileIfAbsent)(path.join(primerDir, 'sequence.yaml'), templates_1.sequenceTemplate);
         (0, scaffold_1.writeFile)(path.join(primerDir, 'templates', 'pdr.md'), templates_1.pdrTemplate);
@@ -71,6 +72,7 @@ function initCommand() {
         (0, scaffold_1.writeFile)(path.join(primerDir, 'templates', 'criteria.yaml'), templates_1.criteriaTemplate);
         (0, scaffold_1.writeFile)(path.join(primerDir, 'templates', 'kpi-review.md'), templates_1.kpiReviewTemplate);
         (0, scaffold_1.writeFile)(path.join(primerDir, 'templates', 'discovery.md'), templates_1.discoveryTemplate);
+        (0, scaffold_1.writeFile)(path.join(primerDir, 'scripts', 'generate-sequence-view.js'), templates_1.sequenceViewScriptTemplate);
         (0, scaffold_1.writeFileIfAbsent)(path.join(primerDir, 'decisions', '.gitkeep'), '');
         (0, scaffold_1.writeFileIfAbsent)(path.join(primerDir, 'bets', '.gitkeep'), '');
         (0, scaffold_1.writeFileIfAbsent)(path.join(primerDir, 'reviews', '.gitkeep'), '');
@@ -80,6 +82,7 @@ function initCommand() {
         console.log('  ' + chalk_1.default.gray('oprim/config.yaml') + ' — ' + configStatus);
         console.log('  ' + chalk_1.default.gray('oprim/sequence.yaml') + ' — ' + sequenceStatus);
         console.log('  ' + chalk_1.default.gray('oprim/templates/') + ' — refreshed');
+        console.log('  ' + chalk_1.default.gray('oprim/scripts/') + ' — refreshed');
         // ── Agent selection ───────────────────────────────────────────────────────
         let selectedAgents;
         const flaggedAgents = opts.agent;
@@ -113,12 +116,14 @@ function initCommand() {
         }
         else {
             let specFramework = 'openspec';
+            let pdrSurfacing = false;
             if (selectedAgents.includes('claude')) {
                 specFramework = await (0, install_agent_1.promptFrameworkSelection)(projectRoot);
+                pdrSurfacing = await (0, install_agent_1.promptPdrSurfacing)();
             }
             console.log('\n' + chalk_1.default.bold('Installing agent skills...'));
             for (const agent of selectedAgents) {
-                (0, install_agent_1.installAgentSkills)(agent, projectRoot, specFramework);
+                (0, install_agent_1.installAgentSkills)(agent, projectRoot, specFramework, pdrSurfacing);
             }
             console.log('\n' + chalk_1.default.green('✓') + ` Agent skills installed: ${selectedAgents.join(', ')}`);
         }

package/dist/commands/update.js

@@ -43,19 +43,26 @@ const fs = __importStar(require("fs"));
 const chalk_1 = __importDefault(require("chalk"));
 const install_agent_1 = require("../lib/install-agent");
 const detect_1 = require("../lib/detect");
+const scaffold_1 = require("../lib/scaffold");
+const templates_1 = require("../lib/templates");
 function updateCommand() {
     return new commander_1.Command('update')
         .description('Refresh /oprim:* assistant commands and skills from package templates')
         .action(async () => {
         const projectRoot = process.cwd();
         const configAgents = (0, detect_1.readAgentsFromConfig)(projectRoot);
+        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);
         if (configAgents !== null && configAgents.length > 0) {
             let specFramework = 'openspec';
+            let pdrSurfacing = false;
             if (configAgents.includes('claude')) {
                 specFramework = await (0, install_agent_1.promptFrameworkSelection)(projectRoot);
+                pdrSurfacing = await (0, install_agent_1.promptPdrSurfacing)();
             }
             for (const agent of configAgents) {
-                (0, install_agent_1.installAgentSkills)(agent, projectRoot, specFramework);
+                (0, install_agent_1.installAgentSkills)(agent, projectRoot, specFramework, pdrSurfacing);
             }
             console.log(`\nAgent skills updated: ${configAgents.join(', ')}`);
         }
@@ -64,7 +71,8 @@ function updateCommand() {
             const legacyAgents = [];
             if (fs.existsSync(path.join(projectRoot, '.claude'))) {
                 const specFramework = await (0, install_agent_1.promptFrameworkSelection)(projectRoot);
-                (0, install_agent_1.installAgentSkills)('claude', projectRoot, specFramework);
+                const pdrSurfacing = await (0, install_agent_1.promptPdrSurfacing)();
+                (0, install_agent_1.installAgentSkills)('claude', projectRoot, specFramework, pdrSurfacing);
                 legacyAgents.push('claude');
             }
             if (fs.existsSync(path.join(projectRoot, '.cursor'))) {
@@ -98,12 +106,14 @@ function updateCommand() {
             return;
         }
         let addSpecFramework = 'openspec';
+        let addPdrSurfacing = false;
         if (selected.includes('claude')) {
             addSpecFramework = await (0, install_agent_1.promptFrameworkSelection)(projectRoot);
+            addPdrSurfacing = await (0, install_agent_1.promptPdrSurfacing)();
         }
         console.log('\n' + chalk_1.default.bold('Installing agent skills...'));
         for (const agent of selected) {
-            (0, install_agent_1.installAgentSkills)(agent, projectRoot, addSpecFramework);
+            (0, install_agent_1.installAgentSkills)(agent, projectRoot, addSpecFramework, addPdrSurfacing);
         }
         const merged = Array.from(new Set([...currentAgents, ...selected]));
         (0, detect_1.writeAgentsToConfig)(merged, projectRoot);

package/dist/lib/install-agent.d.ts

@@ -2,7 +2,9 @@ export type Agent = 'claude' | 'cursor' | 'codex' | 'gemini';
 export declare const SUPPORTED_AGENTS: readonly Agent[];
 export declare function promptFrameworkSelection(projectRoot: string): Promise<string>;
 export declare function promptAgentSelection(projectRoot: string): Promise<string[]>;
-export declare function installAgentSkills(agent: Agent, projectRoot: string, framework?: string): void;
+export declare function promptPdrSurfacing(): Promise<boolean>;
+export declare function installAgentSkills(agent: Agent, projectRoot: string, framework?: string, pdrSurfacing?: boolean): void;
+export declare const OPRIM_CONTEXT_SKILL_STEP = "## Step 0: Check relevant product decisions\nInvoke the `oprim:context` skill using the Skill tool. If matching PDRs are surfaced, review them before proceeding. If no PDRs match or `oprim/decisions/` is empty, the skill exits silently \u2014 continue to Step 1 immediately.";
 export declare const CLAUDE_SKILLS: Record<string, string>;
 export declare const CLAUDE_COMMANDS: Record<string, string>;
 export declare const CURSOR_SKILLS: Record<string, string>;

package/dist/lib/install-agent.js

@@ -36,9 +36,10 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CURSOR_COMMANDS = exports.CURSOR_SKILLS = exports.CLAUDE_COMMANDS = exports.CLAUDE_SKILLS = exports.SUPPORTED_AGENTS = void 0;
+exports.CURSOR_COMMANDS = exports.CURSOR_SKILLS = exports.CLAUDE_COMMANDS = exports.CLAUDE_SKILLS = exports.OPRIM_CONTEXT_SKILL_STEP = exports.SUPPORTED_AGENTS = void 0;
 exports.promptFrameworkSelection = promptFrameworkSelection;
 exports.promptAgentSelection = promptAgentSelection;
+exports.promptPdrSurfacing = promptPdrSurfacing;
 exports.installAgentSkills = installAgentSkills;
 exports.writeAgentInstructionFile = writeAgentInstructionFile;
 exports.codexInstructions = codexInstructions;
@@ -89,15 +90,48 @@ async function promptAgentSelection(projectRoot) {
         ],
     });
 }
-function installAgentSkills(agent, projectRoot, framework = 'openspec') {
+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 });
+}
+function installAgentSkills(agent, projectRoot, framework = 'openspec', pdrSurfacing = false) {
     if (agent === 'claude') {
         const claudeDir = path.join(projectRoot, '.claude');
         const dirCreated = !fs.existsSync(claudeDir);
         const skillsBase = path.join(claudeDir, 'skills');
+        // oprim:context skill — install when opted in, remove when opted out
+        const contextSkillPath = path.join(skillsBase, 'oprim:context', 'SKILL.md');
+        if (pdrSurfacing) {
+            (0, scaffold_1.writeFile)(contextSkillPath, oprimContextSkill());
+            console.log(chalk_1.default.green('✓') + ' .claude/skills/oprim:context/SKILL.md');
+        }
+        else if (fs.existsSync(contextSkillPath)) {
+            fs.unlinkSync(contextSkillPath);
+            try {
+                fs.rmdirSync(path.dirname(contextSkillPath));
+            }
+            catch { /* not empty or already gone */ }
+            console.log(chalk_1.default.dim('  removed .claude/skills/oprim:context/SKILL.md'));
+        }
+        // oprim skills — prepend Step 0 when opted in
         for (const [name, content] of Object.entries(exports.CLAUDE_SKILLS)) {
-            (0, scaffold_1.writeFile)(path.join(skillsBase, name, 'SKILL.md'), content);
+            const skillContent = pdrSurfacing ? withContextStep(content) : content;
+            (0, scaffold_1.writeFile)(path.join(skillsBase, name, 'SKILL.md'), skillContent);
             console.log(chalk_1.default.green('✓') + ` .claude/skills/${name}/SKILL.md`);
         }
+        // openspec skills — add/remove Step 0 in-place when they exist
+        for (const name of OPENSPEC_SKILL_NAMES) {
+            const skillFilePath = path.join(skillsBase, name, 'SKILL.md');
+            if (fs.existsSync(skillFilePath)) {
+                const current = fs.readFileSync(skillFilePath, 'utf-8');
+                const updated = pdrSurfacing ? addContextStepToFile(current) : removeContextStepFromFile(current);
+                if (updated !== current) {
+                    fs.writeFileSync(skillFilePath, updated, 'utf-8');
+                    console.log(chalk_1.default.green('✓') +
+                        ` .claude/skills/${name}/SKILL.md (PDR surfacing ${pdrSurfacing ? 'enabled' : 'disabled'})`);
+                }
+            }
+        }
         const cmdsDir = path.join(claudeDir, 'commands', 'oprim');
         for (const [filename, content] of Object.entries(exports.CLAUDE_COMMANDS)) {
             (0, scaffold_1.writeFile)(path.join(cmdsDir, filename), content);
@@ -164,6 +198,73 @@ function installAgentSkills(agent, projectRoot, framework = 'openspec') {
         }
     }
 }
+// ─── PDR context surfacing ────────────────────────────────────────────────────
+const CTX_STEP_START = '<!-- oprim:context:start -->';
+const CTX_STEP_END = '<!-- oprim:context:end -->';
+exports.OPRIM_CONTEXT_SKILL_STEP = `## Step 0: Check relevant product decisions
+Invoke the \`oprim:context\` skill using the Skill tool. If matching PDRs are surfaced, review them before proceeding. If no PDRs match or \`oprim/decisions/\` is empty, the skill exits silently — continue to Step 1 immediately.`;
+// Openspec skill names whose files are managed by the openspec CLI and modified in-place by oprim
+const OPENSPEC_SKILL_NAMES = [
+    'openspec-propose',
+    'openspec-apply-change',
+    'openspec-explore',
+    'openspec-archive-change',
+];
+// Insert Step 0 into an oprim skill string (written fresh each time — no markers needed)
+function withContextStep(content) {
+    const lines = content.split('\n');
+    let closingDash = -1;
+    let dashCount = 0;
+    for (let i = 0; i < lines.length; i++) {
+        if (lines[i].trim() === '---') {
+            dashCount++;
+            if (dashCount === 2) {
+                closingDash = i;
+                break;
+            }
+        }
+    }
+    if (closingDash === -1)
+        return exports.OPRIM_CONTEXT_SKILL_STEP + '\n\n' + content;
+    const front = lines.slice(0, closingDash + 1).join('\n');
+    const body = lines.slice(closingDash + 1).join('\n').trimStart();
+    return `${front}\n\n${exports.OPRIM_CONTEXT_SKILL_STEP}\n\n${body}`;
+}
+// Idempotently add Step 0 to an openspec skill file (read-modify-write)
+function addContextStepToFile(content) {
+    if (content.includes(CTX_STEP_START))
+        return content; // already present
+    const lines = content.split('\n');
+    let closingDash = -1;
+    let dashCount = 0;
+    for (let i = 0; i < lines.length; i++) {
+        if (lines[i].trim() === '---') {
+            dashCount++;
+            if (dashCount === 2) {
+                closingDash = i;
+                break;
+            }
+        }
+    }
+    const block = `${CTX_STEP_START}\n${exports.OPRIM_CONTEXT_SKILL_STEP}\n${CTX_STEP_END}`;
+    if (closingDash === -1)
+        return block + '\n\n' + content;
+    const front = lines.slice(0, closingDash + 1).join('\n');
+    const body = lines.slice(closingDash + 1).join('\n').trimStart();
+    return `${front}\n\n${block}\n\n${body}`;
+}
+// Remove Step 0 block from an openspec skill file (read-modify-write)
+function removeContextStepFromFile(content) {
+    const s = content.indexOf(CTX_STEP_START);
+    if (s === -1)
+        return content;
+    const e = content.indexOf(CTX_STEP_END, s);
+    if (e === -1)
+        return content;
+    const before = content.slice(0, s).trimEnd();
+    const after = content.slice(e + CTX_STEP_END.length).replace(/^\n+/, '\n');
+    return before + after;
+}
 // ─── Claude skill playbooks ───────────────────────────────────────────────────
 exports.CLAUDE_SKILLS = {
     'oprim-pdr': pdrSkill(),
@@ -486,6 +587,36 @@ The bet is preserved in full at the archive location.
 \`\`\`
 `;
 }
+function oprimContextSkill() {
+    return `---
+name: oprim:context
+description: Surface relevant product decisions from oprim/decisions/ by keyword-matching against the current conversation — invoke at the start of any oprim or openspec workflow when PDR surfacing is enabled
+---
+
+Scan \`oprim/decisions/\` and surface PDRs that match keywords from the current conversation.
+
+## Steps
+
+### 1. Check for decisions
+Scan \`oprim/decisions/\` for files matching \`PDR-*.md\`. If the directory is empty or contains no PDR files, exit silently — produce no output and return immediately.
+
+### 2. Extract keywords
+From the current conversation context, extract 3–10 topic keywords: bet IDs referenced (e.g. \`BET-007\`), capability names, filenames mentioned, subject-area nouns. Focus on the most specific and distinctive terms.
+
+### 3. Match PDRs
+For each PDR file: read the filename and the first 25 lines (to capture title, status, and context). A PDR is relevant if any keyword appears in the filename, title (\`# PDR-NNN: ...\`), or body text (case-insensitive).
+
+### 4. Report or exit silently
+If one or more PDRs match:
+
+**Relevant product decisions:**
+- PDR-NNN: <title> — <Status> (\`oprim/decisions/PDR-NNN-<slug>.md\`)
+
+List each match on its own line, then return — the invoking skill continues to its next step.
+
+If no PDRs match: exit silently — produce no output.
+`;
+}
 function archiveCommandContent() {
     return `Use the Skill tool to invoke the \`oprim-archive\` skill.`;
 }
@@ -720,6 +851,7 @@ Validate the primer sequencing board and suggest rebalancing if needed.
 4. **Validate PDR preconditions** — confirm all \`requires_pdrs\` entries exist in \`oprim/decisions/\`
 5. **Report violations** — list any WIP excess, unresolved blockers, or missing PDRs
 6. **Suggest moves** — recommend bets to defer to \`next\` or \`later\` to resolve violations
+7. **Regenerate view** — run \`node oprim/scripts/generate-sequence-view.js\` from the project root to update \`oprim/sequence-view.md\`
 `;
 }
 // ─── Instruction-file helpers (Codex / Gemini CLI) ────────────────────────────
@@ -803,6 +935,17 @@ Archive a completed bet.
 4. Move directory: \`oprim/bets/BET-NNN → oprim/bets/archived/BET-NNN\`.
 5. Remove the bet entry from \`oprim/sequence.yaml\`.
 6. Report what was done.
+
+### Sequencing board (oprim-sequence)
+Validate the primer sequencing board and regenerate the visual view.
+
+1. **Read board** — load \`oprim/sequence.yaml\`
+2. **Check WIP limits** — compare \`now\` count against \`wip_limits.now\`
+3. **Validate blockers** — for each bet in \`now\`, confirm all \`blocked_by\` entries are complete or absent
+4. **Validate PDR preconditions** — confirm all \`requires_pdrs\` entries exist in \`oprim/decisions/\`
+5. **Report violations** — list any WIP excess, unresolved blockers, or missing PDRs
+6. **Suggest moves** — recommend bets to defer to \`next\` or \`later\` to resolve violations
+7. **Regenerate view** — run \`node oprim/scripts/generate-sequence-view.js\` from the project root to update \`oprim/sequence-view.md\`
 `;
 }
 function codexInstructions() {

package/dist/lib/measure.js

@@ -230,10 +230,12 @@ async function runBigQueryMetric(sqlPath) {
 }
 // ─── Criteria scanner (used by doctor) ───────────────────────────────────────
 function scanCriteriaForSourceType(projectRoot, sourceType) {
-    const betsDir = path.join(projectRoot, 'primer', 'bets');
+    const betsDir = path.join(projectRoot, 'oprim', 'bets');
     if (!fs.existsSync(betsDir))
         return false;
     for (const entry of fs.readdirSync(betsDir)) {
+        if (entry === 'archived')
+            continue;
         const criteriaPath = path.join(betsDir, entry, 'criteria.yaml');
         if (!fs.existsSync(criteriaPath))
             continue;

package/dist/lib/templates.d.ts

@@ -4,4 +4,5 @@ export declare const pdrTemplate = "# PDR-XXX: <Decision title>\n\n## Status\nPr
 export declare const betDecisionTemplate = "# Decision: BET-XXX <Bet title>\n<!-- Naming tip: verb + object [for context] \u2014 e.g. \"Improve bet naming for scannability\" not \"Naming\" -->\n\n## Status\n- Decision: Build now | Defer | Kill\n- Date: YYYY-MM-DD\n- Owner: <name>\n- Review date: YYYY-MM-DD\n\n## Why now\n- <prioritization rationale>\n\n## Alternatives considered\n- <alternative + reason>\n\n## Expected outcomes\n- <metric: baseline -> target in timeframe>\n\n## Kill criteria / rollback trigger\n- <condition and action>\n\n## Links\n- PDRs: <PDR-IDs>\n- OpenSpec change: <path once promoted>\n";
 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 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.discoveryTemplate = exports.criteriaTemplate = exports.betDecisionTemplate = exports.pdrTemplate = exports.sequenceTemplate = void 0;
+exports.kpiReviewTemplate = exports.sequenceViewScriptTemplate = exports.discoveryTemplate = exports.criteriaTemplate = exports.betDecisionTemplate = exports.pdrTemplate = exports.sequenceTemplate = void 0;
 exports.configTemplate = configTemplate;
 function configTemplate(projectName, openspecEnabled, graphifyEnabled) {
     return `version: 1
@@ -124,6 +124,114 @@ exports.discoveryTemplate = `# Discovery: BET-XXX <Bet title>
 - [ ] <Question 2>
 - [ ] <Question 3>
 `;
+exports.sequenceViewScriptTemplate = `#!/usr/bin/env node
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+
+const SEQUENCE_PATH = path.join(process.cwd(), 'oprim/sequence.yaml');
+const OUTPUT_PATH = path.join(process.cwd(), 'oprim/sequence-view.md');
+const MAX_LABEL_LEN = 40;
+
+function parseSequenceYaml(text) {
+  const BUCKETS = ['now', 'next', 'later', 'backlog'];
+  const result = Object.fromEntries(BUCKETS.map(b => [b, []]));
+  let section = null, item = null, listField = null;
+
+  for (const raw of text.split('\\n')) {
+    const trimmed = raw.trim();
+    if (!trimmed || trimmed.startsWith('#')) continue;
+    const indent = raw.length - raw.trimStart().length;
+
+    if (indent === 0) {
+      const m = trimmed.match(/^(\\w+):/);
+      if (m) { section = BUCKETS.includes(m[1]) ? m[1] : null; item = null; listField = null; }
+      continue;
+    }
+
+    if (!section) continue;
+
+    if (indent === 2 && trimmed.startsWith('- ')) {
+      item = {}; result[section].push(item); listField = null;
+      const rest = trimmed.slice(2);
+      const m = rest.match(/^(\\w+):\\s*(.*)/);
+      if (m) item[m[1]] = m[2].replace(/^['"]|['"]$/g, '').trim();
+      continue;
+    }
+
+    if (indent === 4 && item) {
+      const m = trimmed.match(/^(\\w+):\\s*(.*)/);
+      if (!m) continue;
+      const [, key, val] = m;
+      const v = val.trim();
+      if (v === '[]') { item[key] = []; listField = null; }
+      else if (v === '') { item[key] = []; listField = key; }
+      else { item[key] = v.replace(/^['"]|['"]$/g, ''); listField = null; }
+      continue;
+    }
+
+    if (indent === 6 && item && listField && trimmed.startsWith('- ')) {
+      item[listField].push(trimmed.slice(2).trim());
+    }
+  }
+  return result;
+}
+
+function nodeId(betId) { return betId.replace(/-/g, ''); }
+
+function truncate(title) {
+  return title.length > MAX_LABEL_LEN ? title.slice(0, MAX_LABEL_LEN - 3) + '...' : title;
+}
+
+function generateMermaidBlock(seq) {
+  const lines = ['\`\`\`mermaid', 'graph TD'];
+  const ACTIVE = [['now', 'Now'], ['next', 'Next'], ['later', 'Later']];
+
+  for (const [key, label] of ACTIVE) {
+    const bets = seq[key] || [];
+    if (!bets.length) continue;
+    lines.push('    subgraph ' + label);
+    for (const bet of bets) {
+      lines.push('        ' + nodeId(bet.id) + '["' + bet.id + ': ' + truncate(bet.title) + '"]');
+    }
+    lines.push('    end');
+  }
+
+  for (const [key] of ACTIVE) {
+    for (const bet of (seq[key] || [])) {
+      for (const blocker of (bet.blocked_by || [])) {
+        lines.push('    ' + nodeId(bet.id) + ' --> ' + nodeId(blocker));
+      }
+    }
+  }
+
+  lines.push('\`\`\`');
+  return lines.join('\\n');
+}
+
+function generateBacklogSection(seq) {
+  const backlog = seq.backlog || [];
+  if (!backlog.length) return '';
+  return '\\n\\n### Backlog\\n' + backlog.map(b => '- **' + b.id + '**: ' + b.title).join('\\n');
+}
+
+function main() {
+  const seq = parseSequenceYaml(fs.readFileSync(SEQUENCE_PATH, 'utf8'));
+  const header = [
+    '<!-- Auto-generated from oprim/sequence.yaml. Do not edit directly. -->',
+    '<!-- Regenerate by running: node oprim/scripts/generate-sequence-view.js -->',
+    '',
+    '# Sequencing Board',
+    '',
+    '',
+  ].join('\\n');
+  fs.writeFileSync(OUTPUT_PATH, header + generateMermaidBlock(seq) + generateBacklogSection(seq) + '\\n');
+  console.log('Written: oprim/sequence-view.md');
+}
+
+main();
+`;
 exports.kpiReviewTemplate = `# KPI Review: BET-XXX
 
 **Review date:** YYYY-MM-DD

package/package.json

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