@open-product-primer/cli 2.0.0 → 2.2.0

package/README.md

@@ -27,5 +27,11 @@ Bin aliases: `open-product-primer`, `oprim`.
 | `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 |
+| `oprim context` | Print resolved remote context content (`--source <name>` to scope to one) |
+| `oprim context init` | Declare the current project a citable remote context (`--description`); prefer the guided `/oprim:context-init` skill in Claude Code |
+| `oprim context register` | Register a remote context source (`--git <url>` or `--local <path>`, `--name`, optional `--description`) |
+| `oprim context list` | List every registered source's name, kind, and description without fully resolving any of them |
+
+A remote context is an oprim workspace bundled somewhere outside the current project's directory — a remote git repo or a local sibling directory — that this project can reference read-only. Content resolves fresh on demand (never a persistent clone you have to `git pull` yourself); `oprim context list` is the cheap way to see what's registered before pulling full content.
 
 Full documentation: [github.com/eshraw/open-product-primer](https://github.com/eshraw/open-product-primer).

package/dist/cli.js

@@ -8,9 +8,11 @@ const commander_1 = require("commander");
 const init_1 = require("./commands/init");
 const update_1 = require("./commands/update");
 const doctor_1 = require("./commands/doctor");
+const validate_1 = require("./commands/validate");
 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 package_json_1 = __importDefault(require("../package.json"));
 const program = new commander_1.Command();
 program
@@ -20,7 +22,9 @@ program
 program.addCommand((0, init_1.initCommand)());
 program.addCommand((0, update_1.updateCommand)());
 program.addCommand((0, doctor_1.doctorCommand)());
+program.addCommand((0, validate_1.validateCommand)());
 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.parse();

package/dist/commands/context.d.ts

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

package/dist/commands/context.js

@@ -0,0 +1,188 @@
+"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.contextCommand = contextCommand;
+const commander_1 = require("commander");
+const path = __importStar(require("path"));
+const chalk_1 = __importDefault(require("chalk"));
+const remote_context_1 = require("../lib/remote-context");
+const scaffold_1 = require("../lib/scaffold");
+function sourceKind(source) {
+    return (0, remote_context_1.isGitSource)(source) ? 'git' : 'path';
+}
+function initSubcommand() {
+    return new commander_1.Command('init')
+        .description('Declare the current project as a citable remote context')
+        .option('--description <text>', 'canonical description of what this context contains')
+        .action((opts) => {
+        const projectRoot = process.cwd();
+        if ((0, scaffold_1.fileExists)((0, remote_context_1.identityFilePath)(projectRoot))) {
+            console.log(chalk_1.default.yellow('A remote context identity already exists at ') + chalk_1.default.cyan('.oprim-context/context.yaml'));
+            return;
+        }
+        const name = path.basename(projectRoot);
+        (0, remote_context_1.writeIdentity)(projectRoot, { name, version: '1', description: opts.description });
+        console.log(chalk_1.default.green('✓') + ' .oprim-context/context.yaml created');
+        console.log(`  name: ${name}`);
+        if (opts.description) {
+            console.log(`  description: ${opts.description}`);
+        }
+        else {
+            console.log(chalk_1.default.yellow('  no description set') +
+                ' — other projects referencing this context via ' +
+                chalk_1.default.cyan('oprim context list') +
+                ' will see it as description-less.');
+        }
+    });
+}
+function registerSubcommand() {
+    return new commander_1.Command('register')
+        .description('Register a remote context source in the current project')
+        .option('--git <url>', 'git remote URL of the remote context')
+        .option('--local <path>', 'local filesystem path of the remote context')
+        .requiredOption('--name <name>', 'name to register this source under')
+        .option('--description <text>', 'local note about why this source was registered')
+        .action((opts) => {
+        const projectRoot = process.cwd();
+        if ((opts.git && opts.local) || (!opts.git && !opts.local)) {
+            console.error(chalk_1.default.red('Exactly one of --git or --local is required.'));
+            process.exit(1);
+        }
+        const config = (0, remote_context_1.readRemoteContextConfig)(projectRoot);
+        if ((0, remote_context_1.findSourceByName)(config, opts.name)) {
+            console.error(chalk_1.default.red(`A source named "${opts.name}" is already registered.`));
+            process.exit(1);
+        }
+        const source = opts.git
+            ? { name: opts.name, git: opts.git, description: opts.description }
+            : { name: opts.name, path: opts.local, description: opts.description };
+        config.enabled = true;
+        config.sources.push(source);
+        (0, remote_context_1.writeRemoteContextConfig)(projectRoot, config);
+        console.log(chalk_1.default.green('✓') + ` Registered "${opts.name}" (${sourceKind(source)})`);
+        const result = (0, remote_context_1.resolveIdentityOnly)(source);
+        if (result.error) {
+            console.log(chalk_1.default.yellow('  Could not confirm this source yet: ') +
+                result.error +
+                chalk_1.default.dim(' — try `oprim context list` or `oprim doctor` to retry later.'));
+            return;
+        }
+        if (result.nameMismatch) {
+            console.log(chalk_1.default.yellow(`  Warning: declared name "${result.nameMismatch.declared}" does not match resolved identity name "${result.nameMismatch.resolved}".`));
+        }
+        if (result.identity?.description) {
+            console.log(`  ${chalk_1.default.dim('description:')} ${result.identity.description}`);
+        }
+        else {
+            console.log(chalk_1.default.dim('  (no canonical description set on this source)'));
+        }
+    });
+}
+function listSubcommand() {
+    return new commander_1.Command('list')
+        .description('List every registered remote context source, without fully resolving any of them')
+        .action(() => {
+        const projectRoot = process.cwd();
+        const config = (0, remote_context_1.readRemoteContextConfig)(projectRoot);
+        if (!config.enabled || config.sources.length === 0) {
+            console.log('No remote contexts configured.');
+            return;
+        }
+        for (const source of config.sources) {
+            const kind = sourceKind(source);
+            console.log(`${chalk_1.default.bold(source.name)} ${chalk_1.default.dim(`(${kind})`)}`);
+            const result = (0, remote_context_1.resolveIdentityOnly)(source);
+            if (result.error) {
+                console.log('  ' + chalk_1.default.red(`unresolved: ${result.error}`));
+            }
+            else {
+                const desc = result.identity?.description;
+                console.log('  ' + (desc ? desc : chalk_1.default.dim('no description set')));
+                if (result.nameMismatch) {
+                    console.log(chalk_1.default.yellow(`  name mismatch: declared "${result.nameMismatch.declared}", resolved "${result.nameMismatch.resolved}"`));
+                }
+            }
+            if (source.description) {
+                console.log('  ' + chalk_1.default.dim(`local note: ${source.description}`));
+            }
+            console.log('');
+        }
+    });
+}
+function contextCommand() {
+    const cmd = new commander_1.Command('context')
+        .description('Print resolved remote context content')
+        .option('--source <name>', 'limit output to a single named source')
+        .action((opts) => {
+        const projectRoot = process.cwd();
+        const config = (0, remote_context_1.readRemoteContextConfig)(projectRoot);
+        if (!config.enabled || config.sources.length === 0) {
+            console.log('No remote contexts configured.');
+            return;
+        }
+        let sources = config.sources;
+        if (opts.source) {
+            const match = (0, remote_context_1.findSourceByName)(config, opts.source);
+            if (!match) {
+                console.error(chalk_1.default.red(`No source named "${opts.source}" is registered.`));
+                process.exit(1);
+            }
+            sources = [match];
+        }
+        for (const source of sources) {
+            console.log(chalk_1.default.bold(`═══ ${source.name} ═══`));
+            const result = (0, remote_context_1.resolveFull)(source);
+            if (result.error) {
+                console.log(chalk_1.default.red(`  unresolved: ${result.error}`));
+                continue;
+            }
+            if (result.stale) {
+                console.log(chalk_1.default.yellow('  (stale — last successful fetch could not be refreshed)'));
+            }
+            if (result.nameMismatch) {
+                console.log(chalk_1.default.yellow(`  name mismatch: declared "${result.nameMismatch.declared}", resolved "${result.nameMismatch.resolved}"`));
+            }
+            console.log((0, remote_context_1.assembleOprimWorkspaceContent)(result.workspaceRoot));
+            console.log('');
+        }
+    });
+    cmd.addCommand(initSubcommand());
+    cmd.addCommand(registerSubcommand());
+    cmd.addCommand(listSubcommand());
+    return cmd;
+}

package/dist/commands/doctor.js

@@ -44,6 +44,7 @@ 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 remote_context_1 = require("../lib/remote-context");
 const AGENT_DIRS = {
     claude: '.claude',
     cursor: '.cursor',
@@ -103,6 +104,52 @@ function checkClaudeHooks(projectRoot, checks) {
         required: false,
     });
 }
+// bet-026 — validates each configured remote_context.sources entry using the identity-only
+// fetch (cheap: single file, not a full workspace pull), plus a separate "ever fully
+// resolved" nudge that only applies to git sources (local paths have no persistent cache).
+function checkRemoteContexts(projectRoot, checks) {
+    const config = (0, remote_context_1.readRemoteContextConfig)(projectRoot);
+    if (!config.enabled || config.sources.length === 0)
+        return;
+    for (const source of config.sources) {
+        const kind = (0, remote_context_1.isGitSource)(source) ? 'git' : 'path';
+        const result = (0, remote_context_1.resolveIdentityOnly)(source);
+        if (result.error) {
+            checks.push({
+                name: `remote_context: ${source.name} (${kind})`,
+                pass: false,
+                note: `${kind === 'git' ? 'Remote unreachable' : 'Path not found'}: ${result.error} — run 'oprim context list' to retry`,
+                required: false,
+            });
+            continue;
+        }
+        if (!result.identity) {
+            checks.push({
+                name: `remote_context: ${source.name} (${kind})`,
+                pass: false,
+                note: `Missing remote context identity — ask the source project to run 'oprim context init'`,
+                required: false,
+            });
+            continue;
+        }
+        checks.push({
+            name: `remote_context: ${source.name} (${kind})`,
+            pass: true,
+            note: result.nameMismatch
+                ? `Name mismatch: declared "${result.nameMismatch.declared}", resolved "${result.nameMismatch.resolved}"`
+                : undefined,
+            required: false,
+        });
+        if ((0, remote_context_1.isGitSource)(source) && !(0, remote_context_1.hasEverFullyResolved)(source)) {
+            checks.push({
+                name: `remote_context: ${source.name} never fully resolved`,
+                pass: false,
+                note: `Run 'oprim context --source ${source.name}' to pull its content for the first time`,
+                required: false,
+            });
+        }
+    }
+}
 function doctorCommand() {
     return new commander_1.Command('doctor')
         .description('Check oprim install health and integration readiness')
@@ -209,6 +256,8 @@ function doctorCommand() {
         (0, integrity_1.checkSequenceIntegrity)(projectRoot, checks);
         // ── Skill version drift checks ────────────────────────────────────────────
         (0, integrity_1.checkSkillVersionDrift)(projectRoot, checks);
+        // ── Remote context checks ─────────────────────────────────────────────────
+        checkRemoteContexts(projectRoot, checks);
         // ── Agent environment checks ──────────────────────────────────────────────
         const configAgents = (0, detect_1.readAgentsFromConfig)(projectRoot);
         if (configAgents !== null) {

package/dist/commands/validate.d.ts

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

package/dist/commands/validate.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.validateCommand = validateCommand;
+const commander_1 = require("commander");
+const path = __importStar(require("path"));
+const fs = __importStar(require("fs"));
+const chalk_1 = __importDefault(require("chalk"));
+const integrity_1 = require("../lib/integrity");
+const validate_checks_1 = require("../lib/validate-checks");
+const spec_delta_1 = require("../lib/spec-delta");
+function runChecks(projectRoot) {
+    const checks = [];
+    (0, integrity_1.checkSequenceIntegrity)(projectRoot, checks);
+    (0, integrity_1.checkSkillVersionDrift)(projectRoot, checks);
+    (0, validate_checks_1.checkBetDefinitionOfDone)(projectRoot, checks);
+    (0, validate_checks_1.checkSpecDeltaDrift)(projectRoot, checks);
+    (0, validate_checks_1.checkCrossBetConflicts)(projectRoot, checks);
+    return checks;
+}
+function printReport(checks) {
+    console.log(chalk_1.default.bold('oprim validate') + '\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;
+    console.log(`\n${passed}/${checks.length} checks passed.`);
+}
+function runDiff(projectRoot, betIdInput) {
+    const betsDir = path.join(projectRoot, 'oprim', 'bets');
+    const resolvedDir = (0, spec_delta_1.resolveBetDirectory)(betsDir, betIdInput);
+    if (!resolvedDir) {
+        console.error(chalk_1.default.red(`Bet ${betIdInput} was not found in oprim/bets/.`));
+        process.exitCode = 1;
+        return;
+    }
+    const specsDir = path.join(betsDir, resolvedDir, 'specs');
+    if (!fs.existsSync(specsDir)) {
+        console.log(`${resolvedDir} has no spec deltas to preview.`);
+        return;
+    }
+    const capEntries = fs.readdirSync(specsDir, { withFileTypes: true }).filter((e) => e.isDirectory());
+    const capsWithDelta = capEntries.filter((e) => fs.existsSync(path.join(specsDir, e.name, 'spec.md')));
+    if (capsWithDelta.length === 0) {
+        console.log(`${resolvedDir} has no spec deltas to preview.`);
+        return;
+    }
+    for (const capEntry of capsWithDelta) {
+        const deltaContent = fs.readFileSync(path.join(specsDir, capEntry.name, 'spec.md'), 'utf-8');
+        const currentTruthPath = path.join(projectRoot, 'oprim', 'specs', capEntry.name, 'spec.md');
+        const currentTruth = fs.existsSync(currentTruthPath) ? fs.readFileSync(currentTruthPath, 'utf-8') : null;
+        console.log(chalk_1.default.bold(`═══ ${capEntry.name} ═══`));
+        try {
+            const result = (0, spec_delta_1.foldDelta)(currentTruth, deltaContent);
+            console.log(result.content);
+            for (const note of result.notes) {
+                console.log(chalk_1.default.yellow(`  note: ${note}`));
+            }
+        }
+        catch (err) {
+            console.error(chalk_1.default.red(err.message));
+            process.exitCode = 1;
+        }
+        console.log('');
+    }
+}
+function validateCommand() {
+    return new commander_1.Command('validate')
+        .description('CI-gateable validation of oprim board and spec-delta integrity')
+        .option('--json', 'print machine-readable JSON instead of the human-readable report')
+        .option('--strict', 'exit non-zero if any check fails, not only required ones')
+        .option('--diff <bet-id>', "preview a bet's spec-delta merge result without writing files")
+        .action((opts) => {
+        const projectRoot = process.cwd();
+        if (opts.diff) {
+            runDiff(projectRoot, opts.diff);
+            return;
+        }
+        const checks = runChecks(projectRoot);
+        if (opts.json) {
+            console.log(JSON.stringify({ checks }));
+        }
+        else {
+            printReport(checks);
+        }
+        const requiredFailed = checks.some((c) => c.required && !c.pass);
+        const anyFailed = checks.some((c) => !c.pass);
+        const shouldFail = opts.strict ? anyFailed : requiredFailed;
+        if (shouldFail) {
+            process.exitCode = 1;
+        }
+    });
+}

package/dist/lib/config-merge.js

@@ -7,7 +7,11 @@ exports.mergeSpecFramework = mergeSpecFramework;
 const CONFIG_SCHEMA_FIELDS = [
     { key: 'context', block: 'context: ""\n' },
     { key: 'rules', block: 'rules: {}\n' },
-    { key: 'store', block: 'store:\n  enabled: false\n' },
+    // bet-026 — supersedes the old inert `store:` key (BET-025). `store` is intentionally left
+    // out of this table going forward: a project that already has it keeps it untouched (this
+    // merge only adds missing keys, never removes existing ones), but new/updated configs only
+    // ever gain `remote_context`.
+    { key: 'remote_context', block: 'remote_context:\n  enabled: false\n  sources: []\n' },
 ];
 function existingTopLevelKeys(content) {
     const keys = new Set();