@open-product-primer/cli 0.12.0 → 0.14.0

package/dist/commands/doctor.js

@@ -43,6 +43,7 @@ const fs = __importStar(require("fs"));
 const chalk_1 = __importDefault(require("chalk"));
 const detect_1 = require("../lib/detect");
 const measure_1 = require("../lib/measure");
+const integrity_1 = require("../lib/integrity");
 const AGENT_DIRS = {
     claude: '.claude',
     cursor: '.cursor',
@@ -204,6 +205,10 @@ function doctorCommand() {
                 });
             }
         }
+        // ── Sequence integrity checks ─────────────────────────────────────────────
+        (0, integrity_1.checkSequenceIntegrity)(projectRoot, checks);
+        // ── Skill version drift checks ────────────────────────────────────────────
+        (0, integrity_1.checkSkillVersionDrift)(projectRoot, checks);
         // ── Agent environment checks ──────────────────────────────────────────────
         const configAgents = (0, detect_1.readAgentsFromConfig)(projectRoot);
         if (configAgents !== null) {

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)', (val, prev) => [...prev, val], [])
+        .option('--agent <name>', 'AI agent to install skills for (repeatable; supported: claude, cursor, codex, gemini, poolside)', (val, prev) => [...prev, val], [])
         .action(async (opts) => {
         const projectRoot = process.cwd();
         const projectName = opts.name ?? path.basename(projectRoot);

package/dist/lib/detect.js

@@ -72,6 +72,8 @@ function detectAvailableAgents(projectRoot) {
         detected.push('codex');
     if (fs.existsSync(path.join(projectRoot, 'GEMINI.md')))
         detected.push('gemini');
+    if (fs.existsSync(path.join(projectRoot, '.poolside')))
+        detected.push('poolside');
     return detected;
 }
 function writeAgentsToConfig(agents, projectRoot) {

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

@@ -1,4 +1,4 @@
-export type Agent = 'claude' | 'cursor' | 'codex' | 'gemini';
+export type Agent = 'claude' | 'cursor' | 'codex' | 'gemini' | 'poolside';
 export declare const SUPPORTED_AGENTS: readonly Agent[];
 export declare function promptFrameworkSelection(projectRoot: string): Promise<string>;
 export declare function promptAgentSelection(projectRoot: string): Promise<string[]>;
@@ -7,8 +7,10 @@ export declare function installAgentSkills(agent: Agent, projectRoot: string, fr
 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 POOLSIDE_SKILLS: Record<string, string>;
 export declare const CURSOR_SKILLS: Record<string, string>;
 export declare const CURSOR_COMMANDS: Record<string, string>;
 export declare function writeAgentInstructionFile(filePath: string, section: string): void;
 export declare function codexInstructions(): string;
 export declare function geminiInstructions(): string;
+export declare function poolsideInstructions(): 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.CLAUDE_COMMANDS = exports.CLAUDE_SKILLS = exports.OPRIM_CONTEXT_SKILL_STEP = exports.SUPPORTED_AGENTS = void 0;
+exports.CURSOR_COMMANDS = exports.CURSOR_SKILLS = exports.POOLSIDE_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;
@@ -44,12 +44,13 @@ exports.installAgentSkills = installAgentSkills;
 exports.writeAgentInstructionFile = writeAgentInstructionFile;
 exports.codexInstructions = codexInstructions;
 exports.geminiInstructions = geminiInstructions;
+exports.poolsideInstructions = poolsideInstructions;
 const path = __importStar(require("path"));
 const fs = __importStar(require("fs"));
 const chalk_1 = __importDefault(require("chalk"));
 const scaffold_1 = require("./scaffold");
 const detect_1 = require("./detect");
-exports.SUPPORTED_AGENTS = ['claude', 'cursor', 'codex', 'gemini'];
+exports.SUPPORTED_AGENTS = ['claude', 'cursor', 'codex', 'gemini', 'poolside'];
 async function promptFrameworkSelection(projectRoot) {
     const configPath = path.join(projectRoot, '.claude', 'hooks', 'config.json');
     if (fs.existsSync(configPath)) {
@@ -87,6 +88,7 @@ async function promptAgentSelection(projectRoot) {
             { name: 'Cursor', value: 'cursor', checked: detected.includes('cursor') },
             { name: 'Codex', value: 'codex', checked: detected.includes('codex') },
             { name: 'Gemini CLI', value: 'gemini', checked: detected.includes('gemini') },
+            { name: 'Poolside', value: 'poolside', checked: detected.includes('poolside') },
         ],
     });
 }
@@ -170,6 +172,21 @@ function installAgentSkills(agent, projectRoot, framework = 'openspec', pdrSurfa
             console.log(chalk_1.default.dim('  .claude/ created — Claude Code will discover these files automatically.'));
         }
     }
+    else if (agent === 'poolside') {
+        const poolsideDir = path.join(projectRoot, '.poolside');
+        const dirCreated = !fs.existsSync(poolsideDir);
+        const skillsBase = path.join(poolsideDir, 'skills');
+        for (const [name, content] of Object.entries(exports.POOLSIDE_SKILLS)) {
+            (0, scaffold_1.writeFile)(path.join(skillsBase, name, 'SKILL.md'), content);
+            console.log(chalk_1.default.green('✓') + ` .poolside/skills/${name}/SKILL.md`);
+        }
+        const agentsFile = path.join(projectRoot, 'AGENTS.md');
+        writeAgentInstructionFile(agentsFile, poolsideInstructions());
+        console.log(chalk_1.default.green('✓') + ' AGENTS.md (oprim section written)');
+        if (dirCreated) {
+            console.log(chalk_1.default.dim('  .poolside/ created — Poolside will discover these files automatically.'));
+        }
+    }
     else if (agent === 'codex') {
         const agentsFile = path.join(projectRoot, 'AGENTS.md');
         writeAgentInstructionFile(agentsFile, codexInstructions());
@@ -280,6 +297,15 @@ exports.CLAUDE_COMMANDS = {
     'sequence.md': claudeWrapper('OPRIM: Sequence', 'Validate and update the primer sequencing board', sequenceContent()),
     'archive.md': claudeWrapper('OPRIM: Archive', 'Archive a completed bet — move it out of the active board', archiveCommandContent()),
 };
+// ─── Poolside skill playbooks ─────────────────────────────────────────────────
+exports.POOLSIDE_SKILLS = {
+    'oprim-pdr': pdrSkill(),
+    'oprim-bet': betSkill(),
+    'oprim-criteria': criteriaSkill(),
+    'oprim-review': reviewSkill(),
+    'oprim-archive': archiveSkill(),
+    'oprim-sequence': oprimSequenceSkill(),
+};
 // ─── Cursor skill playbooks ───────────────────────────────────────────────────
 exports.CURSOR_SKILLS = {
     'oprim-pdr': pdrSkill(),
@@ -1127,3 +1153,6 @@ function codexInstructions() {
 function geminiInstructions() {
     return oprimWorkflowsInline();
 }
+function poolsideInstructions() {
+    return oprimWorkflowsInline();
+}

package/dist/lib/integrity.d.ts

@@ -0,0 +1,8 @@
+export interface Check {
+    name: string;
+    pass: boolean;
+    note?: string;
+    required: boolean;
+}
+export declare function checkSequenceIntegrity(projectRoot: string, checks: Check[]): void;
+export declare function checkSkillVersionDrift(projectRoot: string, checks: Check[]): void;

package/dist/lib/integrity.js

@@ -0,0 +1,115 @@
+"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.checkSequenceIntegrity = checkSequenceIntegrity;
+exports.checkSkillVersionDrift = checkSkillVersionDrift;
+const path = __importStar(require("path"));
+const fs = __importStar(require("fs"));
+const yaml = __importStar(require("js-yaml"));
+const install_agent_1 = require("./install-agent");
+function checkSequenceIntegrity(projectRoot, checks) {
+    const sequencePath = path.join(projectRoot, 'oprim', 'sequence.yaml');
+    if (!fs.existsSync(sequencePath))
+        return;
+    let seq;
+    try {
+        seq = yaml.load(fs.readFileSync(sequencePath, 'utf-8'));
+    }
+    catch {
+        checks.push({
+            name: 'sequence: could not parse sequence.yaml',
+            pass: false,
+            note: 'Fix YAML syntax errors in oprim/sequence.yaml',
+            required: false,
+        });
+        return;
+    }
+    const lanes = [seq.now, seq.next, seq.later, seq.backlog].filter((l) => Array.isArray(l));
+    const allIds = new Set(lanes.flat().map((e) => e.id));
+    const wipLimit = seq.wip_limits?.now;
+    const nowCount = seq.now?.length ?? 0;
+    if (wipLimit !== undefined && nowCount > wipLimit) {
+        checks.push({
+            name: `sequence: WIP limit exceeded (${nowCount} active, limit ${wipLimit})`,
+            pass: false,
+            note: 'Move items out of now: to respect wip_limits.now',
+            required: false,
+        });
+    }
+    for (const lane of lanes) {
+        for (const entry of lane) {
+            for (const ref of entry.blocked_by ?? []) {
+                if (!allIds.has(ref)) {
+                    checks.push({
+                        name: `sequence: dangling blocked_by reference ${ref}`,
+                        pass: false,
+                        note: `${entry.id} references ${ref} which is not in the sequence`,
+                        required: false,
+                    });
+                }
+            }
+            for (const ref of entry.unlocks ?? []) {
+                if (!allIds.has(ref)) {
+                    checks.push({
+                        name: `sequence: dangling unlocks reference ${ref}`,
+                        pass: false,
+                        note: `${entry.id} references ${ref} which is not in the sequence`,
+                        required: false,
+                    });
+                }
+            }
+        }
+    }
+}
+function checkSkillVersionDrift(projectRoot, checks) {
+    const skillsDir = path.join(projectRoot, '.claude', 'skills');
+    if (!fs.existsSync(skillsDir))
+        return;
+    for (const [name, bundledContent] of Object.entries(install_agent_1.CLAUDE_SKILLS)) {
+        const skillPath = path.join(skillsDir, name, 'SKILL.md');
+        if (!fs.existsSync(skillPath))
+            continue;
+        const installed = fs.readFileSync(skillPath, 'utf-8');
+        const stripped = installed.replace('\n\n' + install_agent_1.OPRIM_CONTEXT_SKILL_STEP + '\n\n', '\n\n');
+        if (stripped !== bundledContent) {
+            checks.push({
+                name: `agent: Claude skill ${name} is out of date`,
+                pass: false,
+                note: "Run 'oprim update' to refresh",
+                required: false,
+            });
+        }
+    }
+}

package/package.json

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