@productbrain/cli 0.1.0-beta.15 → 0.1.0-beta.1522

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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"}