@open-product-primer/cli 0.4.0 → 0.5.0

package/dist/lib/detect.js

@@ -68,6 +68,10 @@ function detectAvailableAgents(projectRoot) {
         detected.push('claude');
     if (fs.existsSync(path.join(projectRoot, '.cursor')))
         detected.push('cursor');
+    if (fs.existsSync(path.join(projectRoot, 'AGENTS.md')))
+        detected.push('codex');
+    if (fs.existsSync(path.join(projectRoot, 'GEMINI.md')))
+        detected.push('gemini');
     return detected;
 }
 function writeAgentsToConfig(agents, projectRoot) {

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

@@ -1,4 +1,4 @@
-export type Agent = 'claude' | 'cursor';
+export type Agent = 'claude' | 'cursor' | 'codex' | 'gemini';
 export declare const SUPPORTED_AGENTS: readonly Agent[];
 export declare function promptFrameworkSelection(projectRoot: string): Promise<string>;
 export declare function promptAgentSelection(projectRoot: string): Promise<string[]>;
@@ -7,3 +7,6 @@ export declare const CLAUDE_SKILLS: Record<string, string>;
 export declare const CLAUDE_COMMANDS: 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;

package/dist/lib/install-agent.js

@@ -40,12 +40,15 @@ exports.CURSOR_COMMANDS = exports.CURSOR_SKILLS = exports.CLAUDE_COMMANDS = expo
 exports.promptFrameworkSelection = promptFrameworkSelection;
 exports.promptAgentSelection = promptAgentSelection;
 exports.installAgentSkills = installAgentSkills;
+exports.writeAgentInstructionFile = writeAgentInstructionFile;
+exports.codexInstructions = codexInstructions;
+exports.geminiInstructions = geminiInstructions;
 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'];
+exports.SUPPORTED_AGENTS = ['claude', 'cursor', 'codex', 'gemini'];
 async function promptFrameworkSelection(projectRoot) {
     const configPath = path.join(projectRoot, '.claude', 'hooks', 'config.json');
     if (fs.existsSync(configPath)) {
@@ -81,6 +84,8 @@ async function promptAgentSelection(projectRoot) {
         choices: [
             { name: 'Claude Code', value: 'claude', checked: detected.includes('claude') },
             { 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') },
         ],
     });
 }
@@ -131,6 +136,16 @@ function installAgentSkills(agent, projectRoot, framework = 'openspec') {
             console.log(chalk_1.default.dim('  .claude/ created — Claude Code will discover these files automatically.'));
         }
     }
+    else if (agent === 'codex') {
+        const agentsFile = path.join(projectRoot, 'AGENTS.md');
+        writeAgentInstructionFile(agentsFile, codexInstructions());
+        console.log(chalk_1.default.green('✓') + ' AGENTS.md (oprim section written)');
+    }
+    else if (agent === 'gemini') {
+        const geminiFile = path.join(projectRoot, 'GEMINI.md');
+        writeAgentInstructionFile(geminiFile, geminiInstructions());
+        console.log(chalk_1.default.green('✓') + ' GEMINI.md (oprim section written)');
+    }
     else if (agent === 'cursor') {
         const cursorDir = path.join(projectRoot, '.cursor');
         const dirCreated = !fs.existsSync(cursorDir);
@@ -290,7 +305,7 @@ After receiving the title, validate: if fewer than 4 words OR fewer than 25 char
   - If "y": proceed with the original title
 
 ### 2. Assign the next BET ID
-Scan \`oprim/bets/\` for directories matching \`BET-(\\d+)$\`. Extract all integers. Assign max+1, zero-padded to 3 digits. Default \`001\` if none.
+Scan \`oprim/bets/\` for directories matching \`BET-(\\d+)\`. Extract all integers. Assign max+1, zero-padded to 3 digits. Default \`001\` if none.
 
 ### 3. Check sequence.yaml exists
 If \`oprim/sequence.yaml\` not found: report and stop — advise \`oprim init\`.
@@ -541,7 +556,7 @@ function pdrInlineContent() {
     return `Create a new PDR in \`oprim/decisions/\`. Scan for \`PDR-(\\d+)-\` to assign next ID (zero-padded, default 001). Gather: title, context, decision, alternatives, consequences, evidence, related bets/specs. Ask if superseding an existing PDR. Write \`oprim/decisions/PDR-NNN-<slug>.md\`. If superseding: update old PDR Status to "Superseded by PDR-NNN". Report what was created.`;
 }
 function betInlineContent() {
-    return `Create a new bet in \`oprim/bets/\`. Before asking for the title, show: "Naming tip: verb + object [for context] — Good: 'Improve bet naming for scannability' / Bad: 'Naming'". Scan \`BET-(\\d+)$\` dirs for next ID (zero-padded, default 001). Check \`oprim/sequence.yaml\` exists (stop if not — advise oprim init). After receiving the title, validate: if fewer than 4 words OR fewer than 25 characters, warn "this title may be too vague", suggest a reformulation, and ask "Proceed anyway? (y/N)" — if "n", prompt for a revised title. Gather: decision (default Build now), owner, review date, why-now, alternatives, expected outcomes, kill criteria, PDR links. Write \`oprim/bets/BET-NNN/bet-decision.md\` with an inline naming tip comment in the header. Append entry to sequence.yaml backlog: \`{id, title, blocked_by: [], unlocks: [], requires_pdrs: []}\`. Then ask: "Do you want to scaffold a discovery.md now? (y/N)" — if "y", write \`oprim/bets/BET-NNN/discovery.md\` from the discovery template (sections: Problem Framing, User Research Signals, Competitive Context, Open Questions); if "n" or Enter, skip silently. Report what was created.`;
+    return `Create a new bet in \`oprim/bets/\`. Before asking for the title, show: "Naming tip: verb + object [for context] — Good: 'Improve bet naming for scannability' / Bad: 'Naming'". Scan \`BET-(\\d+)\` dirs for next ID (zero-padded, default 001). Check \`oprim/sequence.yaml\` exists (stop if not — advise oprim init). After receiving the title, validate: if fewer than 4 words OR fewer than 25 characters, warn "this title may be too vague", suggest a reformulation, and ask "Proceed anyway? (y/N)" — if "n", prompt for a revised title. Gather: decision (default Build now), owner, review date, why-now, alternatives, expected outcomes, kill criteria, PDR links. Write \`oprim/bets/BET-NNN/bet-decision.md\` with an inline naming tip comment in the header. Append entry to sequence.yaml backlog: \`{id, title, blocked_by: [], unlocks: [], requires_pdrs: []}\`. Then ask: "Do you want to scaffold a discovery.md now? (y/N)" — if "y", write \`oprim/bets/BET-NNN/discovery.md\` from the discovery template (sections: Problem Framing, User Research Signals, Competitive Context, Open Questions); if "n" or Enter, skip silently. Report what was created.`;
 }
 function criteriaInlineContent() {
     return `Add metrics to \`oprim/bets/BET-NNN/criteria.yaml\`. Verify bet dir exists. Gather: metric ID, name, baseline, target, timeframe, launch date, segment. Ask source type (amplitude or bigquery). Amplitude: event, aggregation, denominator_event. BigQuery: table, metric_column, filter, aggregation, denominator_query. If file exists: append to metrics list (never overwrite). If not: create. Ask if adding more metrics. Report what was created.`;
@@ -707,3 +722,92 @@ Validate the primer sequencing board and suggest rebalancing if needed.
 6. **Suggest moves** — recommend bets to defer to \`next\` or \`later\` to resolve violations
 `;
 }
+// ─── Instruction-file helpers (Codex / Gemini CLI) ────────────────────────────
+const OPRIM_START = '<!-- oprim:start -->';
+const OPRIM_END = '<!-- oprim:end -->';
+function writeAgentInstructionFile(filePath, section) {
+    const delimited = `${OPRIM_START}\n${section}\n${OPRIM_END}`;
+    if (!fs.existsSync(filePath)) {
+        fs.writeFileSync(filePath, delimited + '\n', 'utf-8');
+        return;
+    }
+    const existing = fs.readFileSync(filePath, 'utf-8');
+    const startIdx = existing.indexOf(OPRIM_START);
+    const endIdx = existing.indexOf(OPRIM_END);
+    if (startIdx !== -1 && endIdx !== -1 && endIdx > startIdx) {
+        const before = existing.slice(0, startIdx);
+        const after = existing.slice(endIdx + OPRIM_END.length);
+        fs.writeFileSync(filePath, before + delimited + after, 'utf-8');
+    }
+    else {
+        const separator = existing.endsWith('\n') ? '\n' : '\n\n';
+        fs.writeFileSync(filePath, existing + separator + delimited + '\n', 'utf-8');
+    }
+}
+function oprimWorkflowsInline() {
+    return `
+## oprim workflows
+
+### Bet authoring (oprim-bet)
+Create a new bet in \`oprim/bets/\` and register it on the sequencing board.
+
+1. Show naming tip: "verb + object [for context] — e.g. 'Improve bet naming for scannability'"
+2. Ask for the bet title. Validate: fewer than 4 words OR fewer than 25 chars → warn, suggest reformulation, ask "Proceed anyway? (y/N)".
+3. Assign next BET ID: scan \`oprim/bets/BET-(\\d+)\` dirs, max+1 zero-padded to 3 digits (default 001).
+4. Check \`oprim/sequence.yaml\` exists — stop if not, advise \`oprim init\`.
+5. Gather: decision (default Build now), owner, review date (YYYY-MM-DD), why now, alternatives, expected outcomes, kill criteria, PDR links.
+6. Write \`oprim/bets/BET-NNN/bet-decision.md\` with all fields.
+7. Append to \`oprim/sequence.yaml\` backlog: \`{id, title, blocked_by: [], unlocks: [], requires_pdrs: []}\`.
+8. Ask: "Scaffold a discovery.md now? (y/N)" — if "y", write \`oprim/bets/BET-NNN/discovery.md\`.
+9. Report what was created.
+
+### Criteria authoring (oprim-criteria)
+Create or append to \`oprim/bets/BET-NNN/criteria.yaml\`.
+
+1. Ask which bet (e.g. BET-042). Verify dir exists.
+2. Gather: metric ID (snake_case), name, baseline, target, timeframe, launch date, segment.
+3. Ask source type (amplitude / bigquery).
+   - Amplitude: event, aggregation (unique_users/event_count/property_sum), denominator_event.
+   - BigQuery: table, metric_column, filter, aggregation, denominator_query.
+4. If file exists: append to \`metrics\` list (never overwrite). If not: create.
+5. Ask if adding more metrics.
+6. Report what was created.
+
+### PDR authoring (oprim-pdr)
+Create a new Product Decision Record in \`oprim/decisions/\`.
+
+1. Ask for decision title.
+2. Assign next PDR ID: scan \`oprim/decisions/PDR-(\\d+)-\`, max+1 zero-padded to 3 digits (default 001).
+3. Gather: context, decision, alternatives, consequences, evidence, related bets/specs.
+4. Ask if superseding an existing PDR.
+5. Write \`oprim/decisions/PDR-NNN-<slug>.md\`. If superseding, update old PDR Status.
+6. Report what was created.
+
+### KPI review (oprim-review)
+Create a KPI review artifact in \`oprim/reviews/\`.
+
+1. Ask which bet (e.g. BET-042).
+2. Read \`oprim/bets/BET-NNN/criteria.yaml\` for pre-fill. Check \`oprim/bets/BET-NNN/measurements/\` for \`run-*.yaml\` — use most recent if present.
+3. If no run result, ask for each metric's actual value.
+4. Status: actual >= target → hit; actual < target → missed; not provided → pending.
+5. Ask reviewer name and decision quality notes.
+6. Write \`oprim/reviews/YYYY-MM-DD-BET-NNN-kpi.md\`.
+7. Report what was created.
+
+### Bet archiving (oprim-archive)
+Archive a completed bet.
+
+1. Ask for bet ID (accept bet-005, 005, 5, BET-005 — normalize to BET-NNN).
+2. Verify \`oprim/bets/BET-NNN/\` exists.
+3. Check \`oprim/sequence.yaml\` for entries where \`blocked_by\` or \`unlocks\` reference the target bet — warn if found, ask "Archive anyway? (y/N)".
+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.
+`;
+}
+function codexInstructions() {
+    return oprimWorkflowsInline();
+}
+function geminiInstructions() {
+    return oprimWorkflowsInline();
+}

package/package.json

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