@productbrain/cli 0.1.0-beta.29 → 0.1.0-beta.2902

package/dist/surfaces/registry.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Surface Capability Registry — WP-310 S0 (FEAT-959), extended in WP-421 S2c (DEC-952).
+ *
+ * Static typed record of per-surface capabilities consumed by E1–E4 and the
+ * SurfaceAdapter set introduced in WP-421 S2c. The legacy `SURFACE_REGISTRY`
+ * shape is preserved verbatim for callers (handshake hook plumbing,
+ * `lib/hook-intents.ts`, existing tests).
+ *
+ * INS-740: Cursor and Copilot had confirmed double-fire risk with Claude Code hooks.
+ * Their hookEvents arrays MUST be empty in v1. Only 'claude' gets hook events by default.
+ */
+import type { SurfaceAdapter } from './adapter.js';
+export type SurfaceName = 'claude' | 'cursor' | 'copilot' | 'codex';
+export interface SurfaceCapability {
+    rulesFormat: 'markdown' | 'mdc';
+    skillsFormat: 'markdown' | 'none';
+    /** Hook events to project. Empty array = no default hook writes (INS-740 double-fire risk). */
+    hookEvents: string[];
+    /** Path to the surface's personal config file. */
+    hookFilePath: string;
+    personalConfigMechanism: 'settings_json' | 'none';
+    supportsAgentsMd: boolean;
+}
+export declare const SURFACE_REGISTRY: Record<SurfaceName, SurfaceCapability>;
+/**
+ * Per-surface adapter registry. New surface = new adapter file + line here.
+ * Adapters expose detect/paths/transform/goldens/canonicalPathFor — one canonical
+ * asset, many surface projections.
+ */
+export declare const SURFACE_ADAPTERS: Record<SurfaceName, SurfaceAdapter>;
+/** Convenience array view for iteration (e.g. detect-all). */
+export declare const SURFACE_ADAPTER_LIST: SurfaceAdapter[];
+/**
+ * Lookup the canonical authoring path for a projection path on any surface.
+ * Returns the first non-null mapping; if every adapter returns null, returns null
+ * and the caller MUST emit `surface-reverse-map-missing` telemetry via
+ * `surfaces/telemetry.ts:reportReverseMapMissing`.
+ */
+export declare function canonicalPathForAnySurface(projectionPath: string): {
+    surface: SurfaceName;
+    canonicalPath: string;
+} | null;
+/** Govern mode declared with empty surfaces[]. Hard error (handshake refuses). */
+export declare const SURFACE_GOVERN_NO_SURFACES: "govern-no-surfaces";
+/** Surface name in manifest is not registered. Advisory flag for drift report. */
+export declare const SURFACE_ADAPTER_MISSING: "surface-adapter-missing";
+/**
+ * Result of the surfaces validation for a given authority mode.
+ *
+ * - `error` is set when the configuration is invalid for the requested mode
+ *   (today: only Govern + empty surfaces). Caller should refuse to proceed.
+ * - `unregisteredSurfaces` enumerates manifest surface names that are not in
+ *   SURFACE_ADAPTERS; emit one `SURFACE_ADAPTER_MISSING` flag per entry but
+ *   do NOT fail.
+ */
+export interface SurfacesValidationResult {
+    error?: typeof SURFACE_GOVERN_NO_SURFACES;
+    unregisteredSurfaces: string[];
+    /** Subset of `manifest.surfaces` that resolve to a known SurfaceName. */
+    registeredSurfaces: SurfaceName[];
+}
+/**
+ * Validate `manifest.surfaces[]` against the requested authority mode.
+ *
+ * Govern + empty surfaces → `{ error: SURFACE_GOVERN_NO_SURFACES }`.
+ * Any other mode is permitted with any (possibly empty) surface list.
+ *
+ * Unregistered surface names are reported via `unregisteredSurfaces` so the
+ * caller can flag them in the drift report. Pure: no I/O, no Convex calls.
+ *
+ * Surface name normalization: this validator strips a leading `.` from each
+ * entry (e.g. `.cursor` → `cursor`) so manifests can declare either form.
+ * The canonical SurfaceName values in SURFACE_ADAPTERS use the bare name.
+ */
+export declare function validateSurfacesForMode(mode: 'off' | 'observe' | 'project' | 'govern', surfacesFromManifest: string[]): SurfacesValidationResult;
+//# sourceMappingURL=registry.d.ts.map

package/dist/surfaces/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/surfaces/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAMnD,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,CAAC;AAEpE,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,UAAU,GAAG,KAAK,CAAC;IAChC,YAAY,EAAE,UAAU,GAAG,MAAM,CAAC;IAClC,+FAA+F;IAC/F,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,kDAAkD;IAClD,YAAY,EAAE,MAAM,CAAC;IACrB,uBAAuB,EAAE,eAAe,GAAG,MAAM,CAAC;IAClD,gBAAgB,EAAE,OAAO,CAAC;CAC3B;AAED,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,WAAW,EAAE,iBAAiB,CAiCnE,CAAC;AAIF;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,WAAW,EAAE,cAAc,CAKhE,CAAC;AAEF,8DAA8D;AAC9D,eAAO,MAAM,oBAAoB,EAAE,cAAc,EAAoC,CAAC;AAEtF;;;;;GAKG;AACH,wBAAgB,0BAA0B,CACxC,cAAc,EAAE,MAAM,GACrB;IAAE,OAAO,EAAE,WAAW,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAMxD;AAaD,kFAAkF;AAClF,eAAO,MAAM,0BAA0B,EAAG,oBAA6B,CAAC;AAExE,kFAAkF;AAClF,eAAO,MAAM,uBAAuB,EAAG,yBAAkC,CAAC;AAE1E;;;;;;;;GAQG;AACH,MAAM,WAAW,wBAAwB;IACvC,KAAK,CAAC,EAAE,OAAO,0BAA0B,CAAC;IAC1C,oBAAoB,EAAE,MAAM,EAAE,CAAC;IAC/B,yEAAyE;IACzE,kBAAkB,EAAE,WAAW,EAAE,CAAC;CACnC;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,KAAK,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,EAC9C,oBAAoB,EAAE,MAAM,EAAE,GAC7B,wBAAwB,CAuB1B"}

package/dist/surfaces/registry.js

@@ -0,0 +1,117 @@
+import { claudeAdapter } from './adapters/claude.js';
+import { cursorAdapter } from './adapters/cursor.js';
+import { copilotAdapter } from './adapters/copilot.js';
+import { codexAdapter } from './adapters/codex.js';
+export const SURFACE_REGISTRY = {
+    claude: {
+        rulesFormat: 'markdown',
+        skillsFormat: 'markdown',
+        hookEvents: ['SessionStart', 'Stop', 'PreCompact'],
+        hookFilePath: '.claude/settings.json',
+        personalConfigMechanism: 'settings_json',
+        supportsAgentsMd: false,
+    },
+    cursor: {
+        rulesFormat: 'mdc',
+        skillsFormat: 'markdown',
+        hookEvents: [], // empty per INS-740 — no default Cursor hook writes
+        hookFilePath: '.cursor/settings.json',
+        personalConfigMechanism: 'none',
+        supportsAgentsMd: false,
+    },
+    copilot: {
+        rulesFormat: 'markdown',
+        skillsFormat: 'none',
+        hookEvents: [], // empty per INS-740
+        hookFilePath: '.github/copilot-instructions.md',
+        personalConfigMechanism: 'none',
+        supportsAgentsMd: false,
+    },
+    codex: {
+        rulesFormat: 'markdown',
+        skillsFormat: 'markdown',
+        hookEvents: [],
+        hookFilePath: 'AGENTS.md',
+        personalConfigMechanism: 'none',
+        supportsAgentsMd: true,
+    },
+};
+// ── SurfaceAdapter registry — WP-421 S2c (DEC-952) ──────────────────────────
+/**
+ * Per-surface adapter registry. New surface = new adapter file + line here.
+ * Adapters expose detect/paths/transform/goldens/canonicalPathFor — one canonical
+ * asset, many surface projections.
+ */
+export const SURFACE_ADAPTERS = {
+    claude: claudeAdapter,
+    cursor: cursorAdapter,
+    copilot: copilotAdapter,
+    codex: codexAdapter,
+};
+/** Convenience array view for iteration (e.g. detect-all). */
+export const SURFACE_ADAPTER_LIST = Object.values(SURFACE_ADAPTERS);
+/**
+ * Lookup the canonical authoring path for a projection path on any surface.
+ * Returns the first non-null mapping; if every adapter returns null, returns null
+ * and the caller MUST emit `surface-reverse-map-missing` telemetry via
+ * `surfaces/telemetry.ts:reportReverseMapMissing`.
+ */
+export function canonicalPathForAnySurface(projectionPath) {
+    for (const surface of Object.keys(SURFACE_ADAPTERS)) {
+        const result = SURFACE_ADAPTERS[surface].canonicalPathFor(projectionPath);
+        if (result)
+            return { surface, canonicalPath: result };
+    }
+    return null;
+}
+// ── WP-421 S7: mode × surfaces matrix (doneWhen #19) ─────────────────────────
+//
+// Two stable error/flag codes (consumer-stable contract):
+//   - SURFACE_GOVERN_NO_SURFACES — Govern mode requires a non-empty surfaces[].
+//     Emitted by `validateSurfacesForMode` when `materialize: govern` and no
+//     surfaces declared. CLI surfaces this as a hard error.
+//   - SURFACE_ADAPTER_MISSING — A surface name in `manifest.surfaces[]` is not
+//     registered in SURFACE_ADAPTERS. Emitted by `flagUnregisteredSurfaces` for
+//     the drift report. The handshake MUST NOT crash on this — the flag is
+//     advisory and the handshake skips the unknown surface.
+/** Govern mode declared with empty surfaces[]. Hard error (handshake refuses). */
+export const SURFACE_GOVERN_NO_SURFACES = 'govern-no-surfaces';
+/** Surface name in manifest is not registered. Advisory flag for drift report. */
+export const SURFACE_ADAPTER_MISSING = 'surface-adapter-missing';
+/**
+ * Validate `manifest.surfaces[]` against the requested authority mode.
+ *
+ * Govern + empty surfaces → `{ error: SURFACE_GOVERN_NO_SURFACES }`.
+ * Any other mode is permitted with any (possibly empty) surface list.
+ *
+ * Unregistered surface names are reported via `unregisteredSurfaces` so the
+ * caller can flag them in the drift report. Pure: no I/O, no Convex calls.
+ *
+ * Surface name normalization: this validator strips a leading `.` from each
+ * entry (e.g. `.cursor` → `cursor`) so manifests can declare either form.
+ * The canonical SurfaceName values in SURFACE_ADAPTERS use the bare name.
+ */
+export function validateSurfacesForMode(mode, surfacesFromManifest) {
+    const knownNames = new Set(Object.keys(SURFACE_ADAPTERS));
+    const registeredSurfaces = [];
+    const unregisteredSurfaces = [];
+    for (const raw of surfacesFromManifest) {
+        if (typeof raw !== 'string' || raw.length === 0)
+            continue;
+        const stripped = raw.startsWith('.') ? raw.slice(1) : raw;
+        const normalized = stripped === 'github' ? 'copilot' : stripped;
+        if (knownNames.has(normalized)) {
+            registeredSurfaces.push(normalized);
+        }
+        else {
+            unregisteredSurfaces.push(raw);
+        }
+    }
+    // Govern requires at least one registered surface. Unregistered surface names
+    // do NOT count toward this minimum (they're advisory).
+    if (mode === 'govern' && registeredSurfaces.length === 0) {
+        return { error: SURFACE_GOVERN_NO_SURFACES, unregisteredSurfaces, registeredSurfaces };
+    }
+    return { unregisteredSurfaces, registeredSurfaces };
+}
+//# sourceMappingURL=registry.js.map

package/dist/surfaces/registry.js.map

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

package/dist/surfaces/telemetry.d.ts

@@ -0,0 +1,17 @@
+export interface ReverseMapMissingEvent {
+    surface: string;
+    projectionPath: string;
+}
+/**
+ * Stable, copy-paste-able fallback message used by tampered-bucket prompts when
+ * an adapter cannot reverse-map a projection path. Centralized so every consumer
+ * surfaces the exact same instruction string.
+ */
+export declare function getReverseMapFallbackMessage(): string;
+/**
+ * Report that an adapter returned null for canonicalPathFor.
+ * Always emits a telemetry event; also writes a tagged warning to stderr so
+ * developers see it during local handshake runs.
+ */
+export declare function reportReverseMapMissing(evt: ReverseMapMissingEvent, warn?: (msg: string) => void): void;
+//# sourceMappingURL=telemetry.d.ts.map

package/dist/surfaces/telemetry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.d.ts","sourceRoot":"","sources":["../../src/surfaces/telemetry.ts"],"names":[],"mappings":"AAUA,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;CACxB;AAKD;;;;GAIG;AACH,wBAAgB,4BAA4B,IAAI,MAAM,CAErD;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CACrC,GAAG,EAAE,sBAAsB,EAC3B,IAAI,GAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAgD,GACtE,IAAI,CAQN"}

package/dist/surfaces/telemetry.js

@@ -0,0 +1,31 @@
+/**
+ * Surface telemetry — WP-421 S2c.
+ *
+ * Tagged log + PostHog event for unmapped projection paths. When a SurfaceAdapter's
+ * canonicalPathFor returns null, the consumer falls back to a generic
+ * "edit upstream in .productbrain/{skills,rules,hooks}/" message and emits
+ * `surface-reverse-map-missing` for observability.
+ */
+import { trackEvent } from '../lib/telemetry.js';
+const FALLBACK_MESSAGE = 'edit upstream in .productbrain/skills|rules|hooks/';
+/**
+ * Stable, copy-paste-able fallback message used by tampered-bucket prompts when
+ * an adapter cannot reverse-map a projection path. Centralized so every consumer
+ * surfaces the exact same instruction string.
+ */
+export function getReverseMapFallbackMessage() {
+    return FALLBACK_MESSAGE;
+}
+/**
+ * Report that an adapter returned null for canonicalPathFor.
+ * Always emits a telemetry event; also writes a tagged warning to stderr so
+ * developers see it during local handshake runs.
+ */
+export function reportReverseMapMissing(evt, warn = (msg) => process.stderr.write(msg + '\n')) {
+    trackEvent('surface-reverse-map-missing', {
+        surface: evt.surface,
+        projectionPath: evt.projectionPath,
+    });
+    warn(`[surface-reverse-map-missing] ${evt.surface} cannot reverse-map ${evt.projectionPath} — ${FALLBACK_MESSAGE}`);
+}
+//# sourceMappingURL=telemetry.js.map

package/dist/surfaces/telemetry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.js","sourceRoot":"","sources":["../../src/surfaces/telemetry.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAOjD,MAAM,gBAAgB,GACpB,oDAAoD,CAAC;AAEvD;;;;GAIG;AACH,MAAM,UAAU,4BAA4B;IAC1C,OAAO,gBAAgB,CAAC;AAC1B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,uBAAuB,CACrC,GAA2B,EAC3B,OAA8B,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,GAAG,IAAI,CAAC;IAEvE,UAAU,CAAC,6BAA6B,EAAE;QACxC,OAAO,EAAE,GAAG,CAAC,OAAO;QACpB,cAAc,EAAE,GAAG,CAAC,cAAc;KACnC,CAAC,CAAC;IACH,IAAI,CACF,iCAAiC,GAAG,CAAC,OAAO,uBAAuB,GAAG,CAAC,cAAc,MAAM,gBAAgB,EAAE,CAC9G,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,31 +1,39 @@
 {
   "name": "@productbrain/cli",
-  "version": "0.1.0-beta.29",
+  "version": "0.1.0-beta.2902",
   "description": "Product Brain — Chain knowledge and write-back CLI",
   "type": "module",
   "bin": {
     "pb": "dist/index.js"
   },
   "engines": {
-    "node": ">=18"
+    "node": ">=20"
   },
   "scripts": {
     "build": "tsc",
+    "prepare": "tsc",
     "dev": "tsc --watch",
     "typecheck": "tsc --noEmit",
     "lint": "tsc --noEmit",
     "test": "vitest run src/",
+    "codegen": "node scripts/generate-seed-commands.mjs && node scripts/generate-health-gap-kinds.mjs",
     "prepublishOnly": "npm run build",
     "publish:beta": "npm publish --tag=beta",
     "version:prerelease": "npm version prerelease --no-git-tag-version"
   },
   "dependencies": {
+    "@clack/prompts": "^0.10.0",
     "commander": "^12.0.0",
     "glob": "^11.0.0",
-    "undici": "^7.24.5"
+    "ink": "^7.0.0",
+    "ink-text-input": "^6.0.0",
+    "react": "^19.0.0",
+    "undici": "^7.28.0"
   },
   "devDependencies": {
+    "@productbrain/kernel-client": "*",
     "@types/node": "^25.3.0",
+    "@types/react": "^19.0.0",
     "typescript": "^5.0.0",
     "vitest": "^4.0.18"
   },

package/templates/method-registry.json

@@ -0,0 +1,16 @@
+{
+  "version": "1.0",
+  "generatedAt": "2026-04-18T00:00:00.000Z",
+  "methods": [
+    { "name": "session start", "usage": "pb session start", "description": "Open a tracked write session before making changes to the Chain." },
+    { "name": "session close", "usage": "pb session close", "description": "Close the current session and prompt for captures." },
+    { "name": "capture", "usage": "pb capture \"TYPE: text\"", "description": "Capture a decision (DEC), tension (TEN), insight (INS), or experiment (EXP) as a draft entry." },
+    { "name": "orient", "usage": "pb orient --task \"<task>\"", "description": "Get task-relevant governance and context before implementation." },
+    { "name": "get", "usage": "pb get <ID>", "description": "Get a full Chain entry by ID (BET, DEC, STD, BR, TEN, etc.)." },
+    { "name": "search", "usage": "pb search <query>", "description": "Search entries across the Chain." },
+    { "name": "handshake", "usage": "pb handshake", "description": "Refresh generated context files from Chain governance." },
+    { "name": "handshake --init", "usage": "pb handshake --init", "description": "Set up Claude Code integration (hooks, permissions, trust level)." },
+    { "name": "update", "usage": "pb update <ID> -f \"field=value\"", "description": "Update a Chain entry field." },
+    { "name": "context", "usage": "pb context <ID>", "description": "Get constellation context for a Chain entry." }
+  ]
+}

package/dist/generators/__tests__/surface-profiles.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=surface-profiles.test.d.ts.map

package/dist/generators/__tests__/surface-profiles.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"surface-profiles.test.d.ts","sourceRoot":"","sources":["../../../src/generators/__tests__/surface-profiles.test.ts"],"names":[],"mappings":""}

package/dist/generators/__tests__/surface-profiles.test.js

@@ -1,89 +0,0 @@
-/**
- * surface-profiles — unit tests.
- * BET-270 Slice 0: type system + registry.
- */
-import { describe, expect, it } from 'vitest';
-import { SURFACE_PROFILES, resolveSurfaceProfile } from '../surface-profiles.js';
-// ── Helper ─────────────────────────────────────────────────────────────
-function isValidProfile(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));
-}
-// ── Registry ───────────────────────────────────────────────────────────
-describe('SURFACE_PROFILES registry', () => {
-    it('defines all 4 known targets', () => {
-        expect(Object.keys(SURFACE_PROFILES).sort()).toEqual(['claude', 'codex', 'copilot', 'cursor']);
-    });
-    it.each(['claude', 'cursor', 'codex', 'copilot'])('%s profile has all required fields with correct types', (target) => {
-        expect(isValidProfile(SURFACE_PROFILES[target])).toBe(true);
-    });
-    it('claude profile has correct values', () => {
-        const p = SURFACE_PROFILES.claude;
-        expect(p.executionModel).toBe('interactive');
-        expect(p.format).toBe('multi-file');
-        expect(p.sessionModel).toBe('conversational');
-        expect(p.tokenBudget).toBe(50000);
-        expect(p.workflowStyle).toBe('orchestrated');
-    });
-    it('cursor profile has correct values', () => {
-        const p = SURFACE_PROFILES.cursor;
-        expect(p.executionModel).toBe('interactive');
-        expect(p.format).toBe('multi-file');
-        expect(p.sessionModel).toBe('conversational');
-        expect(p.tokenBudget).toBe(50000);
-        expect(p.workflowStyle).toBe('orchestrated');
-    });
-    it('codex profile has correct values', () => {
-        const p = SURFACE_PROFILES.codex;
-        expect(p.executionModel).toBe('batch');
-        expect(p.format).toBe('multi-file');
-        expect(p.sessionModel).toBe('autonomous');
-        expect(p.tokenBudget).toBe(100000);
-        expect(p.workflowStyle).toBe('direct');
-    });
-    it('copilot profile has correct values', () => {
-        const p = SURFACE_PROFILES.copilot;
-        expect(p.executionModel).toBe('passive');
-        expect(p.format).toBe('single-file');
-        expect(p.sessionModel).toBe('stateless');
-        expect(p.tokenBudget).toBe(30000);
-        expect(p.workflowStyle).toBe('guided');
-    });
-});
-// ── Resolver ──────────────────────────────────────────────────────────
-describe('resolveSurfaceProfile', () => {
-    it.each(['claude', 'cursor', 'codex', 'copilot'])('resolves known target "%s" to a valid profile', (target) => {
-        const profile = resolveSurfaceProfile(target);
-        expect(isValidProfile(profile)).toBe(true);
-    });
-    it('resolves "claude" to the claude profile', () => {
-        expect(resolveSurfaceProfile('claude')).toBe(SURFACE_PROFILES.claude);
-    });
-    it('resolves "cursor" to the cursor profile', () => {
-        expect(resolveSurfaceProfile('cursor')).toBe(SURFACE_PROFILES.cursor);
-    });
-    it('resolves "codex" to the codex profile', () => {
-        expect(resolveSurfaceProfile('codex')).toBe(SURFACE_PROFILES.codex);
-    });
-    it('resolves "copilot" to the copilot profile', () => {
-        expect(resolveSurfaceProfile('copilot')).toBe(SURFACE_PROFILES.copilot);
-    });
-    it('returns codex profile as fallback for unknown targets', () => {
-        expect(resolveSurfaceProfile('unknown-tool')).toBe(SURFACE_PROFILES.codex);
-    });
-    it('returns codex profile for empty string', () => {
-        expect(resolveSurfaceProfile('')).toBe(SURFACE_PROFILES.codex);
-    });
-    it('fallback profile is a valid profile', () => {
-        const fallback = resolveSurfaceProfile('completely-unknown-surface');
-        expect(isValidProfile(fallback)).toBe(true);
-    });
-});
-//# sourceMappingURL=surface-profiles.test.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"surface-profiles.test.js","sourceRoot":"","sources":["../../../src/generators/__tests__/surface-profiles.test.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAGjF,0EAA0E;AAE1E,SAAS,cAAc,CAAC,OAAgB;IACtC,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC1D,MAAM,CAAC,GAAG,OAAkC,CAAC;IAC7C,OAAO,CACL,CAAC,OAAO,EAAE,aAAa,EAAE,SAAS,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,cAAwB,CAAC;QACxE,CAAC,YAAY,EAAE,aAAa,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAgB,CAAC;QAC1D,CAAC,WAAW,EAAE,gBAAgB,EAAE,YAAY,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,YAAsB,CAAC;QAChF,OAAO,CAAC,CAAC,WAAW,KAAK,QAAQ;QACjC,CAAC,CAAC,WAAW,GAAG,CAAC;QACjB,CAAC,cAAc,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,aAAuB,CAAC,CACzE,CAAC;AACJ,CAAC;AAED,0EAA0E;AAE1E,QAAQ,CAAC,2BAA2B,EAAE,GAAG,EAAE;IACzC,EAAE,CAAC,6BAA6B,EAAE,GAAG,EAAE;QACrC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC;IACjG,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,CAAU,CAAC,CAAC,uDAAuD,EAAE,CAAC,MAAM,EAAE,EAAE;QAC7H,MAAM,CAAC,cAAc,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC9D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;QAC3C,MAAM,CAAC,GAAG,gBAAgB,CAAC,MAAM,CAAC;QAClC,MAAM,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAC7C,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QACpC,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QAC9C,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAClC,MAAM,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;QAC3C,MAAM,CAAC,GAAG,gBAAgB,CAAC,MAAM,CAAC;QAClC,MAAM,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAC7C,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QACpC,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QAC9C,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAClC,MAAM,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;QAC1C,MAAM,CAAC,GAAG,gBAAgB,CAAC,KAAK,CAAC;QACjC,MAAM,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACvC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QACpC,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAC1C,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACnC,MAAM,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACzC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;QAC5C,MAAM,CAAC,GAAG,gBAAgB,CAAC,OAAO,CAAC;QACnC,MAAM,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACzC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QACrC,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACzC,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAClC,MAAM,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACzC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,yEAAyE;AAEzE,QAAQ,CAAC,uBAAuB,EAAE,GAAG,EAAE;IACrC,EAAE,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC,+CAA+C,EAAE,CAAC,MAAM,EAAE,EAAE;QAC5G,MAAM,OAAO,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;QAC9C,MAAM,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yCAAyC,EAAE,GAAG,EAAE;QACjD,MAAM,CAAC,qBAAqB,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC;IACxE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yCAAyC,EAAE,GAAG,EAAE;QACjD,MAAM,CAAC,qBAAqB,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC;IACxE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;QAC/C,MAAM,CAAC,qBAAqB,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC;IACtE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;QACnD,MAAM,CAAC,qBAAqB,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAC1E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uDAAuD,EAAE,GAAG,EAAE;QAC/D,MAAM,CAAC,qBAAqB,CAAC,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC;IAC7E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;QAChD,MAAM,CAAC,qBAAqB,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC;IACjE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;QAC7C,MAAM,QAAQ,GAAG,qBAAqB,CAAC,4BAA4B,CAAC,CAAC;QACrE,MAAM,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC9C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/generators/chain-classifier.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=chain-classifier.test.d.ts.map

package/dist/generators/chain-classifier.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"chain-classifier.test.d.ts","sourceRoot":"","sources":["../../src/generators/chain-classifier.test.ts"],"names":[],"mappings":""}