@productbrain/cli 0.1.0-beta.9 → 0.1.0-beta.9000

package/dist/generators/surface-profiles.js

@@ -0,0 +1,98 @@
+/**
+ * Surface profiles — per-target execution model descriptors.
+ * Downstream generators receive the profile for the target they're emitting to.
+ * BET-270 Slice 0: type system + registry only. Generators accept but do not yet use the profile.
+ * BET-270 Slice 4: pluggable surface registration + fallback.
+ */
+// ── Registry ───────────────────────────────────────────────────────────
+export const SURFACE_PROFILES = {
+    claude: {
+        executionModel: 'interactive',
+        format: 'multi-file',
+        sessionModel: 'conversational',
+        tokenBudget: 50000,
+        workflowStyle: 'orchestrated',
+    },
+    cursor: {
+        executionModel: 'interactive',
+        format: 'multi-file',
+        sessionModel: 'conversational',
+        tokenBudget: 50000,
+        workflowStyle: 'orchestrated',
+    },
+    codex: {
+        executionModel: 'batch',
+        format: 'multi-file',
+        sessionModel: 'autonomous',
+        tokenBudget: 100000,
+        workflowStyle: 'direct',
+    },
+    copilot: {
+        executionModel: 'passive',
+        format: 'single-file',
+        sessionModel: 'stateless',
+        tokenBudget: 30000,
+        workflowStyle: 'guided',
+    },
+};
+/** Runtime-registered surfaces. Built-ins live in SURFACE_PROFILES and cannot be overwritten. */
+const _runtimeRegistry = new Map();
+/**
+ * Reset the runtime registry. Exposed for test isolation only — do not use in production code.
+ * @internal
+ */
+export function _resetRuntimeRegistryForTesting() {
+    _runtimeRegistry.clear();
+}
+// ── Validation ────────────────────────────────────────────────────────
+/**
+ * Type guard that validates a profile object has all required fields with correct types.
+ * Returns false for missing fields or wrong-type values.
+ * Use this to validate profiles at registration time.
+ */
+export function validateSurfaceProfile(profile) {
+    if (!profile || typeof profile !== 'object')
+        return false;
+    const p = profile;
+    return (['batch', 'interactive', 'passive'].includes(p.executionModel) &&
+        ['multi-file', 'single-file'].includes(p.format) &&
+        ['stateless', 'conversational', 'autonomous'].includes(p.sessionModel) &&
+        typeof p.tokenBudget === 'number' &&
+        p.tokenBudget > 0 &&
+        ['orchestrated', 'direct', 'guided'].includes(p.workflowStyle));
+}
+// ── Registration ──────────────────────────────────────────────────────
+/**
+ * Register a new surface at runtime.
+ * Validates the profile before adding — throws if invalid.
+ * Cannot overwrite built-in surfaces (claude, cursor, codex, copilot).
+ */
+export function registerSurface(name, profile) {
+    if (name in SURFACE_PROFILES) {
+        throw new Error(`Cannot overwrite built-in surface "${name}". Built-in surfaces are immutable.`);
+    }
+    if (!validateSurfaceProfile(profile)) {
+        throw new Error(`Invalid profile for surface "${name}". Ensure all required fields are present with correct types.`);
+    }
+    _runtimeRegistry.set(name, profile);
+}
+/**
+ * Returns all registered surface names — built-ins plus any runtime-registered surfaces.
+ */
+export function getRegisteredSurfaces() {
+    return [...Object.keys(SURFACE_PROFILES), ..._runtimeRegistry.keys()];
+}
+// ── Resolver ──────────────────────────────────────────────────────────
+/**
+ * Resolve a surface profile for the given target name.
+ * Checks runtime-registered surfaces first, then built-in SURFACE_PROFILES.
+ * Falls back to the codex profile for unknown targets.
+ */
+export function resolveSurfaceProfile(target) {
+    const runtime = _runtimeRegistry.get(target);
+    if (runtime)
+        return runtime;
+    const known = SURFACE_PROFILES[target];
+    return known ?? SURFACE_PROFILES.codex;
+}
+//# sourceMappingURL=surface-profiles.js.map

package/dist/generators/surface-profiles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"surface-profiles.js","sourceRoot":"","sources":["../../src/generators/surface-profiles.ts"],"names":[],"mappings":"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"}

package/dist/handleCliError.d.ts

@@ -0,0 +1,2 @@
+export declare function handleCliError(err: unknown): never;
+//# sourceMappingURL=handleCliError.d.ts.map

package/dist/handleCliError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handleCliError.d.ts","sourceRoot":"","sources":["../src/handleCliError.ts"],"names":[],"mappings":"AAcA,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,GAAG,KAAK,CA0ClD"}

package/dist/handleCliError.js

@@ -0,0 +1,56 @@
+/**
+ * Extracted out of index.ts (not inlined) — STD-2/DEC-1724: index.ts is a grandfathered,
+ * shrink-only file. This is WP-753 V2 (TASK-203)'s offset for that file's own growth this round
+ * (two same-line-combined imports unwrapped back to one-per-specifier after the 200-char-line
+ * rule made packing them no longer viable).
+ *
+ * Global error handler — single exit point for all CLI errors. CLIError: format with code +
+ * category + guidance. CommanderError: re-throw for --help / --version (exitCode 0), format
+ * others. Regular Error: wrap as INTERNAL.
+ */
+import { CommanderError } from 'commander';
+import { isJsonMode } from './lib/runner.js';
+import { CLIError, ErrorCode } from './lib/errors.js';
+export function handleCliError(err) {
+    // Commander help/version exits with code 0 — let them through
+    if (err instanceof CommanderError && err.exitCode === 0) {
+        process.exit(0);
+    }
+    const json = isJsonMode();
+    if (err instanceof CLIError) {
+        if (json) {
+            process.stderr.write(JSON.stringify(err.toJSON()) + '\n');
+        }
+        else {
+            process.stderr.write(err.message + '\n');
+            if (err.guidance) {
+                process.stderr.write(err.guidance + '\n');
+            }
+        }
+        process.exit(1);
+    }
+    // CommanderError (bad usage, missing args, etc.)
+    if (err instanceof CommanderError) {
+        const cliErr = new CLIError(err.message, {
+            code: ErrorCode.VALIDATION_FAILED,
+            category: 'validation',
+        });
+        if (json) {
+            process.stderr.write(JSON.stringify(cliErr.toJSON()) + '\n');
+        }
+        else {
+            process.stderr.write(err.message + '\n');
+        }
+        process.exit(err.exitCode);
+    }
+    // Unknown / unstructured errors
+    const message = err instanceof Error ? err.message : String(err);
+    if (json) {
+        process.stderr.write(JSON.stringify({ error: message, code: 'INTERNAL', category: 'internal' }) + '\n');
+    }
+    else {
+        process.stderr.write(message + '\n');
+    }
+    process.exit(1);
+}
+//# sourceMappingURL=handleCliError.js.map

package/dist/handleCliError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handleCliError.js","sourceRoot":"","sources":["../src/handleCliError.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEtD,MAAM,UAAU,cAAc,CAAC,GAAY;IAC1C,8DAA8D;IAC9D,IAAI,GAAG,YAAY,cAAc,IAAI,GAAG,CAAC,QAAQ,KAAK,CAAC,EAAE,CAAC;QACzD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACjB,CAAC;IAED,MAAM,IAAI,GAAG,UAAU,EAAE,CAAC;IAE1B,IAAI,GAAG,YAAY,QAAQ,EAAE,CAAC;QAC7B,IAAI,IAAI,EAAE,CAAC;YACV,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC;QAC3D,CAAC;aAAM,CAAC;YACP,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;YACzC,IAAI,GAAG,CAAC,QAAQ,EAAE,CAAC;gBAClB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC;YAC3C,CAAC;QACF,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACjB,CAAC;IAED,iDAAiD;IACjD,IAAI,GAAG,YAAY,cAAc,EAAE,CAAC;QACnC,MAAM,MAAM,GAAG,IAAI,QAAQ,CAAC,GAAG,CAAC,OAAO,EAAE;YACxC,IAAI,EAAE,SAAS,CAAC,iBAAiB;YACjC,QAAQ,EAAE,YAAY;SACtB,CAAC,CAAC;QACH,IAAI,IAAI,EAAE,CAAC;YACV,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC;QAC9D,CAAC;aAAM,CAAC;YACP,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;QAC1C,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC5B,CAAC;IAED,gCAAgC;IAChC,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACjE,IAAI,IAAI,EAAE,CAAC;QACV,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC;IACzG,CAAC;SAAM,CAAC;QACP,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;IACtC,CAAC;IACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACjB,CAAC"}

package/dist/index.d.ts

@@ -1,8 +1,3 @@
 #!/usr/bin/env node
-/**
- * Product Brain CLI — Chain knowledge + write-back in the terminal.
- * Read: BET-108. Write: pb session + pb capture (TEN-27, INS-80).
- * BET-181 Slice 0: global --json / --pretty flags for agent-native output (DEC-299).
- */
 export {};
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;GAIG"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}