@open-product-primer/cli 2.8.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/package.json

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