@open-product-primer/cli 2.8.0 → 2.10.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/init.js

@@ -48,7 +48,7 @@ function initCommand() {
     return new commander_1.Command('init')
         .description('Initialize oprim in the current repository')
         .option('--name <name>', 'project name (defaults to directory name)')
-        .option('--agent <name>', 'AI agent to install skills for (repeatable; supported: claude, cursor, codex, gemini, poolside, vibe, qwen, kimi)', (val, prev) => [...prev, val], [])
+        .option('--agent <name>', 'AI agent to install skills for (repeatable; supported: claude, cursor, codex, gemini, poolside, vibe, qwen, kimi, dsh)', (val, prev) => [...prev, val], [])
         .action(async (opts) => {
         const projectRoot = process.cwd();
         const projectName = opts.name ?? path.basename(projectRoot);

package/dist/commands/list.d.ts

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

package/dist/commands/list.js

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

package/dist/commands/show.d.ts

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

package/dist/commands/show.js

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

package/dist/commands/status.d.ts

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

package/dist/commands/status.js

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

package/dist/lib/artifacts.d.ts

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

package/dist/lib/artifacts.js

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

package/dist/lib/detect.js

@@ -90,6 +90,8 @@ function detectAvailableAgents(projectRoot) {
         detected.push('qwen');
     if (fs.existsSync(path.join(projectRoot, '.kimi')))
         detected.push('kimi');
+    if (fs.existsSync(path.join(projectRoot, '.dsh')))
+        detected.push('dsh');
     return detected;
 }
 function writeAgentsToConfig(agents, projectRoot) {

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

@@ -1,4 +1,4 @@
-export type Agent = 'claude' | 'cursor' | 'codex' | 'gemini' | 'poolside' | 'vibe' | 'qwen' | 'kimi';
+export type Agent = 'claude' | 'cursor' | 'codex' | 'gemini' | 'poolside' | 'vibe' | 'qwen' | 'kimi' | 'dsh';
 export declare const SUPPORTED_AGENTS: readonly Agent[];
 export declare function promptFrameworkSelection(projectRoot: string): Promise<string>;
 export declare function resolveSpecFramework(projectRoot: string): string;
@@ -13,6 +13,7 @@ export declare const POOLSIDE_SKILLS: Record<string, string>;
 export declare const VIBE_SKILLS: Record<string, string>;
 export declare const QWEN_SKILLS: Record<string, string>;
 export declare const KIMI_SKILLS: Record<string, string>;
+export declare const DSH_SKILLS: Record<string, string>;
 export declare const CURSOR_SKILLS: Record<string, string>;
 export declare const CURSOR_COMMANDS: Record<string, string>;
 export declare function specAuthoringSkill(): string;
@@ -23,3 +24,4 @@ export declare function poolsideInstructions(): string;
 export declare function vibeInstructions(): string;
 export declare function qwenInstructions(): string;
 export declare function kimiInstructions(): string;
+export declare function dshInstructions(): string;

package/dist/lib/install-agent.js

@@ -36,7 +36,7 @@ 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.KIMI_SKILLS = exports.QWEN_SKILLS = exports.VIBE_SKILLS = exports.POOLSIDE_SKILLS = exports.CLAUDE_COMMANDS = exports.CLAUDE_SKILLS = exports.OPRIM_CONTEXT_SKILL_STEP = exports.SUPPORTED_AGENTS = void 0;
+exports.CURSOR_COMMANDS = exports.CURSOR_SKILLS = exports.DSH_SKILLS = exports.KIMI_SKILLS = exports.QWEN_SKILLS = exports.VIBE_SKILLS = exports.POOLSIDE_SKILLS = exports.CLAUDE_COMMANDS = exports.CLAUDE_SKILLS = exports.OPRIM_CONTEXT_SKILL_STEP = exports.SUPPORTED_AGENTS = void 0;
 exports.promptFrameworkSelection = promptFrameworkSelection;
 exports.resolveSpecFramework = resolveSpecFramework;
 exports.promptAgentSelection = promptAgentSelection;
@@ -51,6 +51,7 @@ exports.poolsideInstructions = poolsideInstructions;
 exports.vibeInstructions = vibeInstructions;
 exports.qwenInstructions = qwenInstructions;
 exports.kimiInstructions = kimiInstructions;
+exports.dshInstructions = dshInstructions;
 const path = __importStar(require("path"));
 const fs = __importStar(require("fs"));
 const chalk_1 = __importDefault(require("chalk"));
@@ -68,6 +69,7 @@ exports.SUPPORTED_AGENTS = [
     'vibe',
     'qwen',
     'kimi',
+    'dsh',
 ];
 // oprim/config.yaml (via integrations.spec_framework) is the source of truth for the
 // selected speccing framework; .claude/hooks/config.json is checked only as a fallback for
@@ -139,6 +141,7 @@ async function promptAgentSelection(projectRoot) {
             { name: 'Mistral Vibe', value: 'vibe', checked: detected.includes('vibe') },
             { name: 'Qwen Code', value: 'qwen', checked: detected.includes('qwen') },
             { name: 'Kimi CLI', value: 'kimi', checked: detected.includes('kimi') },
+            { name: 'DeepSeek Harness', value: 'dsh', checked: detected.includes('dsh') },
         ],
     });
 }
@@ -360,6 +363,37 @@ function installAgentSkills(agent, projectRoot, framework = 'openspec', pdrSurfa
             console.log(chalk_1.default.dim('  .qwen/ created — Qwen Code will discover these files automatically.'));
         }
     }
+    else if (agent === 'dsh') {
+        const dshDir = path.join(projectRoot, '.dsh');
+        const dirCreated = !fs.existsSync(dshDir);
+        const skillsBase = path.join(dshDir, 'skills');
+        for (const id of POOLSIDE_SKILL_WORKFLOW_IDS) {
+            const schema = (0, workflow_schema_1.loadWorkflowSchema)(id, projectRoot);
+            if (!schema.dsh.skill || !schema.skillName)
+                continue;
+            (0, scaffold_1.writeFile)(path.join(skillsBase, schema.skillName, 'SKILL.md'), (0, workflow_renderer_1.renderSkillBody)(id, projectRoot));
+            console.log(chalk_1.default.green('✓') + ` .dsh/skills/${schema.skillName}/SKILL.md`);
+        }
+        const dshSpecSkillPath = path.join(skillsBase, 'oprim-spec', 'SKILL.md');
+        if (framework === 'native') {
+            (0, scaffold_1.writeFile)(dshSpecSkillPath, (0, workflow_renderer_1.renderSkillBody)('spec-authoring', projectRoot));
+            console.log(chalk_1.default.green('✓') + ' .dsh/skills/oprim-spec/SKILL.md');
+        }
+        else if (fs.existsSync(dshSpecSkillPath)) {
+            fs.unlinkSync(dshSpecSkillPath);
+            try {
+                fs.rmdirSync(path.dirname(dshSpecSkillPath));
+            }
+            catch { /* not empty or already gone */ }
+            console.log(chalk_1.default.dim('  removed .dsh/skills/oprim-spec/SKILL.md'));
+        }
+        const agentsFile = path.join(projectRoot, 'AGENTS.md');
+        writeAgentInstructionFile(agentsFile, dshInstructions());
+        console.log(chalk_1.default.green('✓') + ' AGENTS.md (oprim section written)');
+        if (dirCreated) {
+            console.log(chalk_1.default.dim('  .dsh/ created — DeepSeek Harness will discover these files automatically.'));
+        }
+    }
     else if (agent === 'kimi') {
         // Kimi CLI is a split-path install: .kimi/ is the detection signal, but skills are
         // discovered from a project-root .skills/ directory, not .kimi/skills/ — see
@@ -573,6 +607,10 @@ exports.KIMI_SKILLS = Object.fromEntries(POOLSIDE_SKILL_WORKFLOW_IDS.map((id) =>
     const schema = (0, workflow_schema_1.loadWorkflowSchema)(id);
     return [schema.skillName, (0, workflow_renderer_1.renderSkillBody)(id)];
 }));
+exports.DSH_SKILLS = Object.fromEntries(POOLSIDE_SKILL_WORKFLOW_IDS.map((id) => {
+    const schema = (0, workflow_schema_1.loadWorkflowSchema)(id);
+    return [schema.skillName, (0, workflow_renderer_1.renderSkillBody)(id)];
+}));
 exports.CURSOR_SKILLS = Object.fromEntries(CURSOR_SKILL_WORKFLOW_IDS.map((id) => {
     const schema = (0, workflow_schema_1.loadWorkflowSchema)(id);
     return [schema.skillName, (0, workflow_renderer_1.renderSkillBody)(id)];
@@ -773,3 +811,6 @@ function qwenInstructions() {
 function kimiInstructions() {
     return (0, workflow_renderer_1.renderAgentInstructions)();
 }
+function dshInstructions() {
+    return (0, workflow_renderer_1.renderAgentInstructions)();
+}

package/dist/lib/workflow-schema.d.ts

@@ -22,6 +22,9 @@ export interface WorkflowSchema {
     kimi: {
         skill: boolean;
     };
+    dsh: {
+        skill: boolean;
+    };
     inline: boolean;
     variants: string[] | null;
 }

package/dist/lib/workflow-schema.js

@@ -68,12 +68,14 @@ function parseSchema(raw, filePath) {
     const claude = requireField(obj, 'claude', filePath);
     const cursor = requireField(obj, 'cursor', filePath);
     const poolside = requireField(obj, 'poolside', filePath);
-    // vibe/qwen/kimi are optional and mirror poolside by default — see mistral-vibe-agent-support,
-    // qwen-code-agent-support, and kimi-cli-agent-support specs. This keeps existing bundled/forked
-    // schemas (none declare a `vibe:`/`qwen:`/`kimi:` key) working unchanged.
+    // vibe/qwen/kimi/dsh are optional and mirror poolside by default — see mistral-vibe-agent-support,
+    // qwen-code-agent-support, kimi-cli-agent-support, and deepseek-harness-agent-support specs. This
+    // keeps existing bundled/forked schemas (none declare a `vibe:`/`qwen:`/`kimi:`/`dsh:` key) working
+    // unchanged.
     const vibe = obj.vibe ?? poolside;
     const qwen = obj.qwen ?? poolside;
     const kimi = obj.kimi ?? poolside;
+    const dsh = obj.dsh ?? poolside;
     requireField(obj, 'inline', filePath);
     return {
         id: obj.id,
@@ -87,6 +89,7 @@ function parseSchema(raw, filePath) {
         vibe: { skill: Boolean(vibe.skill) },
         qwen: { skill: Boolean(qwen.skill) },
         kimi: { skill: Boolean(kimi.skill) },
+        dsh: { skill: Boolean(dsh.skill) },
         inline: Boolean(obj.inline),
         variants: obj.variants ?? null,
     };

package/package.json

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