@open-product-primer/cli 0.7.0 → 0.9.0

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;

package/dist/commands/update.js

@@ -43,12 +43,17 @@ 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;

package/dist/lib/install-agent.js

@@ -272,6 +272,7 @@ exports.CLAUDE_SKILLS = {
     'oprim-criteria': criteriaSkill(),
     'oprim-review': reviewSkill(),
     'oprim-archive': archiveSkill(),
+    'oprim-sequence': oprimSequenceSkill(),
 };
 // ─── Claude command wrappers (thin, invoke skill) ────────────────────────────
 exports.CLAUDE_COMMANDS = {
@@ -289,7 +290,7 @@ exports.CURSOR_SKILLS = {
 // ─── Cursor command files (full inline — no Skill tool in Cursor) ────────────
 exports.CURSOR_COMMANDS = {
     'oprim-promote.md': cursorWrapper('oprim-promote', 'Promote a prioritized bet to an OpenSpec change', promoteContent()),
-    'oprim-sequence.md': cursorWrapper('oprim-sequence', 'Validate and update the primer sequencing board', sequenceContent()),
+    'oprim-sequence.md': cursorWrapper('oprim-sequence', 'Validate and update the primer sequencing board', sequenceInlineContent()),
     'oprim-pdr.md': cursorWrapper('oprim-pdr', 'Create a new Product Decision Record with auto-assigned ID', pdrInlineContent()),
     'oprim-bet.md': cursorWrapper('oprim-bet', 'Create a new bet decision and register it on the sequencing board', betInlineContent()),
     'oprim-criteria.md': cursorWrapper('oprim-criteria', 'Create or append to a criteria.yaml contract for a bet', criteriaInlineContent()),
@@ -617,6 +618,95 @@ List each match on its own line, then return — the invoking skill continues to
 If no PDRs match: exit silently — produce no output.
 `;
 }
+function oprimSequenceSkill() {
+    return `---
+name: oprim-sequence
+description: Validate and update the primer sequencing board — triage mode computes board health and surfaces specific suggestions; seeded mode targets a specific context
+---
+
+Manage the primer sequencing board in \`oprim/sequence.yaml\`.
+
+## Entry modes
+
+**Triage mode** — no intention provided: reads board state, computes health, surfaces specific actionable suggestions.
+**Seeded mode** — context pre-provided (e.g. from a lifecycle hook): skips full triage and targets the most relevant move for that context.
+
+## Steps
+
+### 1. Determine mode
+
+If lifecycle context was provided as an argument or pre-seeded in the conversation (e.g. \`bet-created\`, \`bet-promoted\`, or a specific bet ID was just archived), enter **Seeded mode** — go to Step 2B.
+
+Otherwise, enter **Triage mode** — go to Step 2A.
+
+### 2A. Triage mode — compute board health
+
+Read \`oprim/sequence.yaml\`. Compute:
+
+- **WIP utilization**: count entries in \`now\` vs \`wip_limits.now\`
+- **WIP violations**: entries in \`now\` that exceed the WIP limit
+- **Blocked Now bets**: entries in \`now\` whose \`blocked_by\` list contains a bet ID still present in any active lane (now/next/later/backlog)
+- **Ready-to-pull bets**: entries in \`next\` whose \`blocked_by\` list is empty or all resolved (each blocked_by ID is absent from all active lanes)
+- **PDR gaps**: entries in any lane whose \`requires_pdrs\` list contains a PDR ID not found in \`oprim/decisions/\`
+
+Surface **ranked suggestions**, most urgent first:
+1. WIP violations → name each excess bet, suggest deferring to \`next\` or \`later\`
+2. Blocked Now bets → name the bet and its unresolved blocker, suggest deferring until blocker resolves
+3. Open Now slot (count < \`wip_limits.now\`) with a ready Next bet → name a specific bet to pull into \`now\`
+4. PDR gaps → name the bet and missing PDR, suggest creating it first
+
+Each suggestion must name the exact bet ID, current lane, target lane, and reason.
+
+If the board is healthy (no violations, no ready moves): report current WIP utilization and state the board is healthy. Offer to move something anyway if the user wants.
+
+After surfacing suggestions, ask: "Which move would you like to make?"
+
+### 2B. Seeded mode — target specific context
+
+Use the provided context to jump to the most relevant suggestion:
+
+- \`bet-created\`: A new bet just landed in backlog. Check if \`now\` has an open slot and \`next\` has a ready bet to pull. If so, suggest the specific bet to pull. Otherwise, confirm the new bet is in backlog and the board looks healthy.
+- \`bet-promoted\`: A bet was just promoted to an OpenSpec change. Verify the bet is still correctly sequenced and surface any resequencing action the promotion warrants.
+- Bet archived (e.g. "BET-011 was archived"): Check if \`now\` dropped below \`wip_limits.now\`. If so, find the most ready bet in \`next\` and suggest pulling it.
+
+If no relevant move is found for the provided context, fall back to Triage mode (Step 2A).
+
+### 3. Validate the requested move
+
+Before executing any move, verify all three constraints:
+
+**WIP limit**: Moving a bet to \`now\` must not push the count above \`wip_limits.now\`. If it would, explain the violation and suggest deferring an existing \`now\` bet first.
+
+**Blocker resolution**: Moving a bet to \`now\` requires its \`blocked_by\` list to be empty or all resolved (IDs absent from all active lanes). If unresolved, name each unresolved blocker.
+
+**PDR preconditions**: Moving a bet to \`now\` requires all \`requires_pdrs\` entries to exist as files in \`oprim/decisions/\`. If any are missing, name them and suggest creating them first.
+
+If the move is invalid: explain which constraint failed and suggest the nearest valid alternative. Do not proceed to Step 4.
+
+### 4. Preview and confirm
+
+Show the exact YAML change before writing. Name the entry that will move: its \`id\`, \`title\`, source lane, and target lane.
+
+\`\`\`
+Before:  BET-005 is in next  (now: 1/2 slots filled)
+After:   BET-005 moves to now (now: 2/2 slots filled)
+\`\`\`
+
+Ask: "Apply this change? (y/N)"
+- If "n" or Enter: stop, no changes made.
+- If "y": proceed to Step 5.
+
+### 5. Write sequence.yaml
+
+Read \`oprim/sequence.yaml\`. Remove the bet entry from its current lane. Insert it into the target lane. Write back with 2-space indentation. Do not modify any other entries.
+
+### 6. Regenerate view
+
+Run \`node oprim/scripts/generate-sequence-view.js\` from the project root to update \`oprim/sequence-view.md\`.
+
+### 7. Report what was done
+`;
+}
 function archiveCommandContent() {
     return `Use the Skill tool to invoke the \`oprim-archive\` skill.`;
 }
@@ -703,54 +793,88 @@ function hooksConfig(framework) {
     }, null, 2) + '\n');
 }
 const ON_PROMPT_SUBMIT_HOOK = `#!/usr/bin/env bash
-# UserPromptSubmit hook: detects archive slash commands and sets a pending flag.
+# UserPromptSubmit hook: detects lifecycle slash commands and sets pending flags.
 
-config_file=".claude/hooks/config.json"
-flag_file=".claude/hooks/.archive-pending"
+archive_flag=".claude/hooks/.archive-pending"
+nudge_flag=".claude/hooks/.sequence-nudge"
 
-framework="openspec"
-if [ -f "$config_file" ]; then
-  framework=$(python3 -c "import sys,json; print(json.load(open('$config_file')).get('framework','openspec'))" 2>/dev/null || echo "openspec")
-fi
+input=$(cat)
 
-prompt=$(cat | python3 -c "import sys,json; print(json.load(sys.stdin).get('prompt',''))" 2>/dev/null || true)
+# Archive co-archival detection
+if printf '%s' "$input" | grep -qE '"prompt"[[:space:]]*:[[:space:]]*"[^"]*(opsx:archive|openspec-archive-change)'; then
+  prompt=$(printf '%s' "$input" | grep -oE '"prompt"[[:space:]]*:[[:space:]]*"[^"]*"' | sed 's/.*"prompt"[[:space:]]*:[[:space:]]*"//;s/"$//')
+  arg=$(printf '%s' "$prompt" | sed 's|^[[:space:]]*/[^[:space:]]* *||' | awk '{print $1}' | sed 's|^@||' | sed 's|.*/changes/||' | sed 's|/$||' | xargs 2>/dev/null || true)
+  printf '%s' "$arg" > "$archive_flag"
+fi
 
-[ -z "$prompt" ] && exit 0
+# Bet creation detection
+if printf '%s' "$input" | grep -qE '"prompt"[[:space:]]*:[[:space:]]*"[^"]*oprim:bet'; then
+  printf 'bet-created' > "$nudge_flag"
+fi
 
-if [ "$framework" = "openspec" ]; then
-  if echo "$prompt" | grep -qE '^[[:space:]]*/(opsx:archive|openspec-archive-change)([[:space:]]|$)'; then
-    arg=$(echo "$prompt" | sed 's|^[[:space:]]*/[^[:space:]]* *||' | sed 's|^@||' | sed 's|.*/changes/||' | sed 's|/$||' | xargs 2>/dev/null || true)
-    echo "$arg" > "$flag_file"
-  fi
+# Bet promotion detection
+if printf '%s' "$input" | grep -qE '"prompt"[[:space:]]*:[[:space:]]*"[^"]*oprim:promote'; then
+  printf 'bet-promoted' > "$nudge_flag"
 fi
 `;
 const ON_STOP_HOOK = `#!/usr/bin/env bash
-# Stop hook: if an archive command was detected, find the linked bet and prompt co-archival.
-
-flag_file=".claude/hooks/.archive-pending"
-[ -f "$flag_file" ] || exit 0
+# Stop hook: archive co-archival coordination and sequencing nudges.
 
-change=$(tr -d '[:space:]' < "$flag_file")
-rm -f "$flag_file"
+archive_flag=".claude/hooks/.archive-pending"
+nudge_flag=".claude/hooks/.sequence-nudge"
 
-if [ -z "$change" ]; then
-  latest=$(ls openspec/changes/archive/ 2>/dev/null | sort -r | head -1)
-  [ -z "$latest" ] && exit 0
-  change=$(echo "$latest" | sed -E 's/^[0-9]{4}-[0-9]{2}-[0-9]{2}-//')
-fi
+# --- Archive co-archival block ---
+if [ -f "$archive_flag" ]; then
+  change=$(tr -d '[:space:]' < "$archive_flag")
+  rm -f "$archive_flag"
 
-[ -z "$change" ] && exit 0
+  if [ -z "$change" ]; then
+    latest=$(ls openspec/changes/archive/ 2>/dev/null | sort -r | head -1)
+    [ -n "$latest" ] && change=$(echo "$latest" | sed -E 's/^[0-9]{4}-[0-9]{2}-[0-9]{2}-//')
+  fi
 
-archive_dir=$(ls openspec/changes/archive/ 2>/dev/null | grep -F "$change" | sort -r | head -1)
-[ -z "$archive_dir" ] && exit 0
+  if [ -n "$change" ]; then
+    archive_dir=$(ls openspec/changes/archive/ 2>/dev/null | grep -F "$change" | sort -r | head -1)
+    if [ -n "$archive_dir" ]; then
+      proposal="openspec/changes/archive/$archive_dir/proposal.md"
+      if [ -f "$proposal" ]; then
+        bet_id=$(grep -oE 'BET-[0-9]+' "$proposal" | head -1)
+        if [ -n "$bet_id" ]; then
+          printf '{"decision":"block","reason":"The openspec change '''%s''' was just archived. Its proposal.md references %s. Please invoke \`/oprim:archive %s\` to co-archive the linked bet."}\\n' "$change" "$bet_id" "$bet_id"
+          exit 0
+        fi
+      fi
+    fi
+  fi
+fi
 
-proposal="openspec/changes/archive/$archive_dir/proposal.md"
-[ -f "$proposal" ] || exit 0
+# --- Sequencing nudge from lifecycle event ---
+if [ -f "$nudge_flag" ]; then
+  context=$(cat "$nudge_flag")
+  rm -f "$nudge_flag"
+
+  case "$context" in
+    bet-created)
+      printf '\\n💡 A new bet was added to your backlog. Run \`/oprim:sequence\` to check if it should be pulled into Now or Next.\\n'
+      ;;
+    bet-promoted)
+      printf '\\n💡 A bet was promoted to an OpenSpec change. Run \`/oprim:sequence\` to verify the board reflects this.\\n'
+      ;;
+  esac
+fi
 
-bet_id=$(grep -oE 'BET-[0-9]+' "$proposal" | head -1)
-[ -z "$bet_id" ] && exit 0
+# --- Open Now slot check ---
+if [ -f "oprim/sequence.yaml" ]; then
+  wip_limit=$(awk '/^wip_limits:/{in_wip=1} in_wip && /^  now:/{print $2; exit} /^[^ ]/{in_wip=0}' oprim/sequence.yaml 2>/dev/null)
+  now_count=$(awk '/^now:/{in_now=1; next} in_now && /^[^ ]/{in_now=0} in_now && /^  - id:/{count++} END{print count+0}' oprim/sequence.yaml 2>/dev/null)
+  next_count=$(awk '/^next:/{in_next=1; next} in_next && /^[^ ]/{in_next=0} in_next && /^  - id:/{count++} END{print count+0}' oprim/sequence.yaml 2>/dev/null)
 
-printf '{"decision":"block","reason":"The openspec change '\''%s'\'' was just archived. Its proposal.md references %s. Please invoke \`/oprim:archive %s\` to co-archive the linked bet."}\\n' "$change" "$bet_id" "$bet_id"
+  if [ -n "$wip_limit" ] && [ -n "$now_count" ] && [ -n "$next_count" ]; then
+    if [ "$now_count" -lt "$wip_limit" ] 2>/dev/null && [ "$next_count" -gt 0 ] 2>/dev/null; then
+      printf '\\n💡 Now lane has capacity (%s/%s). Run \`/oprim:sequence\` to pull something from Next.\\n' "$now_count" "$wip_limit"
+    fi
+  fi
+fi
 `;
 // Merge UserPromptSubmit + Stop hooks into .claude/settings.json without clobbering existing entries.
 // Also removes the legacy PostToolUse/Skill hook from on-skill-archive.sh if present.
@@ -810,7 +934,7 @@ function mergeClaudeSettingsHooks(claudeDir) {
     fs.writeFileSync(settingsPath, JSON.stringify(settings, null, 2) + '\n', 'utf-8');
     console.log(chalk_1.default.green('✓') + ' .claude/settings.json (UserPromptSubmit + Stop hooks registered)');
 }
-// ─── Legacy content (promote / sequence remain inline) ───────────────────────
+// ─── Legacy content (promote remains inline; sequence now delegates to skill) ─
 function promoteContent() {
     return `
 Promote a prioritized bet to an OpenSpec change and link criteria contracts.
@@ -840,6 +964,9 @@ Promote a prioritized bet to an OpenSpec change and link criteria contracts.
 `;
 }
 function sequenceContent() {
+    return `Use the Skill tool to invoke the \`oprim-sequence\` skill.`;
+}
+function sequenceInlineContent() {
     return `
 Validate the primer sequencing board and suggest rebalancing if needed.
 
@@ -851,6 +978,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) ────────────────────────────
@@ -934,6 +1062,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/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.7.0",
+  "version": "0.9.0",
   "description": "Open Product Primer CLI — product decisions, sequencing, and KPI tracking for repositories",
   "keywords": [
     "product",