@open-product-primer/cli 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Eshane
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,31 @@
+# @open-product-primer/cli
+
+Global CLI for [Open Product Primer](https://github.com/eshraw/open-product-primer) — product decisions, sequencing, and KPI tracking in your repository.
+
+## Install
+
+```bash
+npm install -g @open-product-primer/cli@latest
+```
+
+## Quick start
+
+```bash
+cd your-project
+oprim init
+oprim doctor
+oprim update
+```
+
+Bin aliases: `open-product-primer`, `oprim`.
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `oprim init` | Scaffold `primer/` workspace (idempotent) |
+| `oprim update` | Refresh `/oprim:*` assistant commands and skills |
+| `oprim doctor` | Verify scaffold, integrations, and measurement env |
+| `oprim measure` | Run KPI measurement pipeline for a bet |
+
+Full documentation: [github.com/eshraw/open-product-primer](https://github.com/eshraw/open-product-primer).

package/bin/oprim.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+require('../dist/cli.js');

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,22 @@
+#!/usr/bin/env node
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+const init_1 = require("./commands/init");
+const update_1 = require("./commands/update");
+const doctor_1 = require("./commands/doctor");
+const measure_1 = require("./commands/measure");
+const package_json_1 = __importDefault(require("../package.json"));
+const program = new commander_1.Command();
+program
+    .name('open-product-primer')
+    .description('Open Product Primer — product decisions, sequencing, and KPI tracking')
+    .version(package_json_1.default.version);
+program.addCommand((0, init_1.initCommand)());
+program.addCommand((0, update_1.updateCommand)());
+program.addCommand((0, doctor_1.doctorCommand)());
+program.addCommand((0, measure_1.measureCommand)());
+program.parse();

package/dist/commands/doctor.d.ts

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

package/dist/commands/doctor.js

@@ -0,0 +1,176 @@
+"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.doctorCommand = doctorCommand;
+const commander_1 = require("commander");
+const path = __importStar(require("path"));
+const fs = __importStar(require("fs"));
+const chalk_1 = __importDefault(require("chalk"));
+const detect_1 = require("../lib/detect");
+const measure_1 = require("../lib/measure");
+const AGENT_DIRS = {
+    claude: '.claude',
+    cursor: '.cursor',
+};
+function doctorCommand() {
+    return new commander_1.Command('doctor')
+        .description('Check Open Product Primer install health and integration readiness')
+        .action(() => {
+        const projectRoot = process.cwd();
+        const checks = [];
+        const primerDir = path.join(projectRoot, 'primer');
+        for (const dir of ['primer', 'primer/decisions', 'primer/bets', 'primer/reviews', 'primer/templates']) {
+            const exists = fs.existsSync(path.join(projectRoot, dir));
+            checks.push({
+                name: `scaffold: ${dir}/`,
+                pass: exists,
+                note: exists ? undefined : "Run 'oprim init' to create",
+                required: true,
+            });
+        }
+        const configPath = path.join(primerDir, 'config.yaml');
+        const configExists = fs.existsSync(configPath);
+        checks.push({
+            name: 'config: primer/config.yaml',
+            pass: configExists,
+            note: configExists ? undefined : "Run 'oprim init' to create",
+            required: true,
+        });
+        const sequenceExists = fs.existsSync(path.join(primerDir, 'sequence.yaml'));
+        checks.push({
+            name: 'config: primer/sequence.yaml',
+            pass: sequenceExists,
+            note: sequenceExists ? undefined : "Run 'oprim init' to create",
+            required: true,
+        });
+        const openspecPresent = fs.existsSync(path.join(projectRoot, 'openspec'));
+        checks.push({
+            name: 'integration: OpenSpec',
+            pass: openspecPresent,
+            note: openspecPresent ? undefined : 'Optional — install OpenSpec to enable change linking',
+            required: false,
+        });
+        const graphifyPresent = fs.existsSync(path.join(projectRoot, 'graphify-out'));
+        checks.push({
+            name: 'integration: Graphify',
+            pass: graphifyPresent,
+            note: graphifyPresent ? undefined : 'Optional — install Graphify for traceability',
+            required: false,
+        });
+        // 7.1–7.3: criteria-aware credential checks
+        const hasAmplitudeMetrics = (0, measure_1.scanCriteriaForSourceType)(projectRoot, 'amplitude');
+        const hasBigQueryMetrics = (0, measure_1.scanCriteriaForSourceType)(projectRoot, 'bigquery');
+        const amplitudeKeySet = !!process.env['AMPLITUDE_API_KEY'];
+        const googleCredsSet = !!process.env['GOOGLE_APPLICATION_CREDENTIALS'];
+        checks.push({
+            name: 'measurement: AMPLITUDE_API_KEY',
+            pass: !hasAmplitudeMetrics || amplitudeKeySet,
+            note: hasAmplitudeMetrics && !amplitudeKeySet
+                ? 'Required for amplitude metrics — set AMPLITUDE_API_KEY to enable oprim measure'
+                : hasAmplitudeMetrics
+                    ? undefined
+                    : 'No amplitude metrics in criteria.yaml — not required',
+            required: false,
+        });
+        checks.push({
+            name: 'measurement: GOOGLE_APPLICATION_CREDENTIALS',
+            pass: !hasBigQueryMetrics || googleCredsSet,
+            note: hasBigQueryMetrics && !googleCredsSet
+                ? 'Required for bigquery metrics — set GOOGLE_APPLICATION_CREDENTIALS to enable oprim measure'
+                : hasBigQueryMetrics
+                    ? undefined
+                    : 'No bigquery metrics in criteria.yaml — not required',
+            required: false,
+        });
+        // ── Agent environment checks ──────────────────────────────────────────────
+        const configAgents = (0, detect_1.readAgentsFromConfig)(projectRoot);
+        if (configAgents !== null) {
+            // Config-declared agents: check each declared agent's directory exists
+            for (const agent of configAgents) {
+                const dir = AGENT_DIRS[agent];
+                if (!dir)
+                    continue;
+                const exists = fs.existsSync(path.join(projectRoot, dir));
+                checks.push({
+                    name: `agent: ${agent} environment (${dir}/)`,
+                    pass: exists,
+                    note: exists
+                        ? undefined
+                        : `${dir}/ directory not found — declared in config but missing`,
+                    required: false,
+                });
+            }
+        }
+        else {
+            // Legacy: check for installed commands by directory presence
+            const claudeInstalled = fs.existsSync(path.join(projectRoot, '.claude', 'commands', 'oprim'));
+            checks.push({
+                name: 'agent: Claude /oprim:* commands',
+                pass: claudeInstalled,
+                note: claudeInstalled ? undefined : "Run 'oprim update' to install",
+                required: false,
+            });
+            const cursorInstalled = fs.existsSync(path.join(projectRoot, '.cursor', 'commands', 'oprim-promote.md')) ||
+                fs.existsSync(path.join(projectRoot, '.cursor', 'commands', 'oprim-sequence.md'));
+            checks.push({
+                name: 'agent: Cursor /oprim-* commands',
+                pass: cursorInstalled,
+                note: cursorInstalled ? undefined : "Run 'oprim update' to install",
+                required: false,
+            });
+        }
+        console.log(chalk_1.default.bold('Open Product Primer') + ' — health check\n');
+        for (const check of checks) {
+            const icon = check.pass ? chalk_1.default.green('✓') : check.required ? chalk_1.default.red('✗') : chalk_1.default.yellow('○');
+            const label = check.pass ? chalk_1.default.white(check.name) : chalk_1.default.gray(check.name);
+            const note = check.note ? chalk_1.default.dim(`  (${check.note})`) : '';
+            console.log(`  ${icon} ${label}${note}`);
+        }
+        const passed = checks.filter((c) => c.pass).length;
+        const requiredFailed = checks.filter((c) => c.required && !c.pass).length;
+        console.log(`\n${passed}/${checks.length} checks passed.`);
+        if (requiredFailed === 0) {
+            console.log(chalk_1.default.green('Core setup is healthy.'));
+        }
+        else {
+            console.log(chalk_1.default.yellow(`${requiredFailed} required check(s) failed. Run `) +
+                chalk_1.default.cyan('oprim init') +
+                chalk_1.default.yellow(' to fix.'));
+        }
+    });
+}

package/dist/commands/init.d.ts

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

package/dist/commands/init.js

@@ -0,0 +1,131 @@
+"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.initCommand = initCommand;
+const commander_1 = require("commander");
+const path = __importStar(require("path"));
+const chalk_1 = __importDefault(require("chalk"));
+const detect_1 = require("../lib/detect");
+const scaffold_1 = require("../lib/scaffold");
+const install_agent_1 = require("../lib/install-agent");
+const templates_1 = require("../lib/templates");
+function initCommand() {
+    return new commander_1.Command('init')
+        .description('Initialize Open Product Primer 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], [])
+        .action(async (opts) => {
+        const projectRoot = process.cwd();
+        const projectName = opts.name ?? path.basename(projectRoot);
+        console.log(chalk_1.default.bold('Open Product Primer') + ' — initializing project workspace...\n');
+        const openspec = (0, detect_1.detectOpenSpec)(projectRoot);
+        const graphify = (0, detect_1.detectGraphify)(projectRoot);
+        if (openspec.detected)
+            console.log(chalk_1.default.green('✓') + ' OpenSpec detected');
+        if (graphify.detected)
+            console.log(chalk_1.default.green('✓') + ' Graphify detected');
+        const primerDir = path.join(projectRoot, 'primer');
+        (0, scaffold_1.ensureDir)(path.join(primerDir, 'decisions'));
+        (0, scaffold_1.ensureDir)(path.join(primerDir, 'bets'));
+        (0, scaffold_1.ensureDir)(path.join(primerDir, 'reviews'));
+        (0, scaffold_1.ensureDir)(path.join(primerDir, 'templates'));
+        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);
+        (0, scaffold_1.writeFile)(path.join(primerDir, 'templates', 'bet-decision.md'), templates_1.betDecisionTemplate);
+        (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.writeFileIfAbsent)(path.join(primerDir, 'decisions', '.gitkeep'), '');
+        (0, scaffold_1.writeFileIfAbsent)(path.join(primerDir, 'bets', '.gitkeep'), '');
+        (0, scaffold_1.writeFileIfAbsent)(path.join(primerDir, 'reviews', '.gitkeep'), '');
+        console.log('\n' + chalk_1.default.green('✓') + ' primer/ workspace created');
+        const configStatus = configWritten ? 'written' : 'preserved (already exists)';
+        const sequenceStatus = sequenceWritten ? 'written' : 'preserved (already exists)';
+        console.log('  ' + chalk_1.default.gray('primer/config.yaml') + ' — ' + configStatus);
+        console.log('  ' + chalk_1.default.gray('primer/sequence.yaml') + ' — ' + sequenceStatus);
+        console.log('  ' + chalk_1.default.gray('primer/templates/') + ' — refreshed');
+        // ── Agent selection ───────────────────────────────────────────────────────
+        let selectedAgents;
+        const flaggedAgents = opts.agent;
+        if (flaggedAgents.length > 0) {
+            const invalid = flaggedAgents.filter((a) => !install_agent_1.SUPPORTED_AGENTS.includes(a));
+            if (invalid.length > 0) {
+                console.error(chalk_1.default.red(`\nUnknown agent(s): ${invalid.join(', ')}`));
+                console.error(`Supported agents: ${install_agent_1.SUPPORTED_AGENTS.join(', ')}`);
+                process.exit(1);
+            }
+            selectedAgents = flaggedAgents;
+        }
+        else {
+            const existingAgents = (0, detect_1.readAgentsFromConfig)(projectRoot);
+            if (existingAgents !== null) {
+                selectedAgents = existingAgents;
+                if (selectedAgents.length > 0) {
+                    console.log('\n' + chalk_1.default.dim(`Re-installing for configured agents: ${selectedAgents.join(', ')}`));
+                }
+            }
+            else {
+                console.log('');
+                const { checkbox } = await Promise.resolve().then(() => __importStar(require('@inquirer/prompts')));
+                selectedAgents = await checkbox({
+                    message: 'Which AI tools should /oprim:* skills be installed for?',
+                    choices: [
+                        { name: 'Claude Code', value: 'claude' },
+                        { name: 'Cursor', value: 'cursor' },
+                    ],
+                });
+            }
+        }
+        (0, detect_1.writeAgentsToConfig)(selectedAgents, projectRoot);
+        if (selectedAgents.length === 0) {
+            console.log('\n' +
+                chalk_1.default.yellow('No agents selected.') +
+                ' Run ' +
+                chalk_1.default.cyan('oprim update') +
+                ' after configuring an AI tool to install /oprim:* skills.');
+        }
+        else {
+            console.log('\n' + chalk_1.default.bold('Installing agent skills...'));
+            for (const agent of selectedAgents) {
+                (0, install_agent_1.installAgentSkills)(agent, projectRoot);
+            }
+            console.log('\n' + chalk_1.default.green('✓') + ` Agent skills installed: ${selectedAgents.join(', ')}`);
+        }
+        console.log('\nRun ' + chalk_1.default.cyan('oprim doctor') + ' to verify your setup.');
+    });
+}

package/dist/commands/measure.d.ts

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

package/dist/commands/measure.js

@@ -0,0 +1,207 @@
+"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.measureCommand = measureCommand;
+const commander_1 = require("commander");
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const yaml = __importStar(require("js-yaml"));
+const chalk_1 = __importDefault(require("chalk"));
+const measure_1 = require("../lib/measure");
+function measureCommand() {
+    return new commander_1.Command('measure')
+        .description('Generate and run KPI measurements for a bet')
+        .argument('<bet-id>', 'BET ID (e.g. BET-042)')
+        .option('--dry-run', 'generate definition files without calling APIs')
+        .action(async (betId, opts) => {
+        const projectRoot = process.cwd();
+        const betDir = path.join(projectRoot, 'primer', 'bets', betId);
+        // 1.3 — bet directory validation
+        if (!fs.existsSync(betDir)) {
+            console.error(chalk_1.default.red(`Bet not found: primer/bets/${betId}/`));
+            console.error(`Use ${chalk_1.default.cyan('/oprim:bet')} to create the bet first.`);
+            process.exit(1);
+        }
+        // 1.4 — criteria.yaml validation
+        const criteriaPath = path.join(betDir, 'criteria.yaml');
+        if (!fs.existsSync(criteriaPath)) {
+            console.error(chalk_1.default.red(`No criteria.yaml found for ${betId}.`));
+            console.error(`Run ${chalk_1.default.cyan('/oprim:criteria ' + betId)} to create one.`);
+            process.exit(1);
+        }
+        let criteria;
+        try {
+            const raw = fs.readFileSync(criteriaPath, 'utf-8');
+            const parsed = yaml.load(raw);
+            if (!parsed?.metrics)
+                throw new Error('Missing metrics field');
+            criteria = parsed;
+        }
+        catch (err) {
+            console.error(chalk_1.default.red(`Invalid criteria.yaml: ${err.message}`));
+            process.exit(1);
+        }
+        // 2.5 — create measurements/ directory
+        const measurementsDir = path.join(betDir, 'measurements');
+        if (!fs.existsSync(measurementsDir)) {
+            fs.mkdirSync(measurementsDir, { recursive: true });
+        }
+        console.log(chalk_1.default.bold(`oprim measure ${betId}`) + '\n');
+        // 2.1–2.4 — generate definition files
+        for (const metric of criteria.metrics) {
+            if (metric.source.type === 'amplitude') {
+                const def = (0, measure_1.generateAmplitudeDefinition)(metric);
+                const outPath = path.join(measurementsDir, `amplitude-${metric.id}.json`);
+                fs.writeFileSync(outPath, JSON.stringify(def, null, 2), 'utf-8');
+                console.log(chalk_1.default.green('✓') + ` Generated amplitude-${metric.id}.json`);
+            }
+            else if (metric.source.type === 'bigquery') {
+                const sql = (0, measure_1.generateBigQuerySQL)(metric);
+                const outPath = path.join(measurementsDir, `bigquery-${metric.id}.sql`);
+                fs.writeFileSync(outPath, sql, 'utf-8');
+                console.log(chalk_1.default.green('✓') + ` Generated bigquery-${metric.id}.sql`);
+            }
+        }
+        // 2.6 — dry-run exits after generation
+        if (opts.dryRun) {
+            console.log('\n' + chalk_1.default.dim('--dry-run: skipping API execution'));
+            console.log(`\nDefinition files written to primer/bets/${betId}/measurements/`);
+            return;
+        }
+        // Execute metrics sequentially
+        console.log('\nExecuting metrics...');
+        const results = [];
+        const amplitudeKey = process.env['AMPLITUDE_API_KEY'];
+        const hasGoogleCreds = !!process.env['GOOGLE_APPLICATION_CREDENTIALS'];
+        for (const metric of criteria.metrics) {
+            if (metric.source.type === 'amplitude') {
+                results.push(await executeAmplitudeMetric(metric, measurementsDir, amplitudeKey));
+            }
+            else if (metric.source.type === 'bigquery') {
+                results.push(await executeBigQueryMetric(metric, measurementsDir, hasGoogleCreds));
+            }
+        }
+        // 5.2–5.3 — write run result (overwrites existing file for same date)
+        const runDate = new Date().toISOString().slice(0, 10);
+        (0, measure_1.writeRunResult)(betId, measurementsDir, results, runDate);
+        console.log('\n' + chalk_1.default.green('✓') + ` Run result: measurements/run-${runDate}.yaml`);
+        const hits = results.filter((r) => r.status === 'hit').length;
+        const misses = results.filter((r) => r.status === 'missed').length;
+        const pending = results.filter((r) => r.status === 'pending').length;
+        console.log(`\n  ${chalk_1.default.green(`${hits} hit`)}  ${chalk_1.default.red(`${misses} missed`)}  ${chalk_1.default.yellow(`${pending} pending`)}`);
+        console.log(`\nRun ${chalk_1.default.cyan('/oprim:review ' + betId)} to create a review.`);
+    });
+}
+// ─── Amplitude execution (3.1–3.4) ───────────────────────────────────────────
+async function executeAmplitudeMetric(metric, measurementsDir, apiKey) {
+    // 3.1 — skip if no API key
+    if (!apiKey) {
+        console.log(chalk_1.default.yellow('○') + ` ${metric.name} — skipped (AMPLITUDE_API_KEY not set)`);
+        return {
+            id: metric.id,
+            name: metric.name,
+            source: 'amplitude',
+            actual: null,
+            target: metric.target,
+            status: 'pending',
+            notes: 'AMPLITUDE_API_KEY not set — metric skipped',
+        };
+    }
+    const defPath = path.join(measurementsDir, `amplitude-${metric.id}.json`);
+    try {
+        // 3.2–3.3 — call API and extract scalar
+        const { actual, notes } = await (0, measure_1.runAmplitudeMetric)(defPath, apiKey);
+        const status = (0, measure_1.classifyStatus)(actual, metric.target);
+        const icon = status === 'hit' ? chalk_1.default.green('✓') : status === 'missed' ? chalk_1.default.red('✗') : chalk_1.default.yellow('○');
+        console.log(`${icon} ${metric.name}: actual=${actual ?? 'n/a'} target=${metric.target} (${status})`);
+        return { id: metric.id, name: metric.name, source: 'amplitude', actual, target: metric.target, status, notes };
+    }
+    catch (err) {
+        // 3.4 — non-2xx or network error: mark pending, continue
+        const notes = `Amplitude error: ${err.message}`;
+        console.log(chalk_1.default.yellow('○') + ` ${metric.name} — ${notes}`);
+        return {
+            id: metric.id,
+            name: metric.name,
+            source: 'amplitude',
+            actual: null,
+            target: metric.target,
+            status: 'pending',
+            notes,
+        };
+    }
+}
+// ─── BigQuery execution (4.1–4.4) ────────────────────────────────────────────
+async function executeBigQueryMetric(metric, measurementsDir, hasCredentials) {
+    // 4.1 — skip if no credentials
+    if (!hasCredentials) {
+        console.log(chalk_1.default.yellow('○') + ` ${metric.name} — skipped (GOOGLE_APPLICATION_CREDENTIALS not set)`);
+        return {
+            id: metric.id,
+            name: metric.name,
+            source: 'bigquery',
+            actual: null,
+            target: metric.target,
+            status: 'pending',
+            notes: 'GOOGLE_APPLICATION_CREDENTIALS not set — metric skipped',
+        };
+    }
+    const sqlPath = path.join(measurementsDir, `bigquery-${metric.id}.sql`);
+    try {
+        // 4.2–4.3 — submit job, poll, extract first-row scalar
+        const { actual, notes } = await (0, measure_1.runBigQueryMetric)(sqlPath);
+        const status = (0, measure_1.classifyStatus)(actual, metric.target);
+        const icon = status === 'hit' ? chalk_1.default.green('✓') : status === 'missed' ? chalk_1.default.red('✗') : chalk_1.default.yellow('○');
+        console.log(`${icon} ${metric.name}: actual=${actual ?? 'n/a'} target=${metric.target} (${status})`);
+        return { id: metric.id, name: metric.name, source: 'bigquery', actual, target: metric.target, status, notes };
+    }
+    catch (err) {
+        // 4.4 — job failure or zero rows: mark pending, continue
+        const notes = `BigQuery error: ${err.message}`;
+        console.log(chalk_1.default.yellow('○') + ` ${metric.name} — ${notes}`);
+        return {
+            id: metric.id,
+            name: metric.name,
+            source: 'bigquery',
+            actual: null,
+            target: metric.target,
+            status: 'pending',
+            notes,
+        };
+    }
+}

package/dist/commands/update.d.ts

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