@productbrain/cli 0.1.0-beta.108 → 0.1.0-beta.109

package/dist/surfaces/__tests__/pb-setup-passthrough.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pb-setup-passthrough.test.js","sourceRoot":"","sources":["../../../src/surfaces/__tests__/pb-setup-passthrough.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAC9C,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAC/B,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAGxD,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAC1D,mEAAmE;AACnE,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;AAChE,MAAM,cAAc,GAAG,IAAI,CAAC,SAAS,EAAE,eAAe,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC;AAEjF;;;;;GAKG;AACH,SAAS,oBAAoB;IAC3B,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC,EAAE,CAAC;QAChC,MAAM,IAAI,KAAK,CAAC,sCAAsC,cAAc,EAAE,CAAC,CAAC;IAC1E,CAAC;IACD,MAAM,GAAG,GAAG,YAAY,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;IACjD,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,6CAA6C,CAAC,CAAC;IACvE,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;IAE/D,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IACtB,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IAEtB,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;IAChD,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,wDAAwD,CAAC,CAAC;IACvF,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,oCAAoC,CAAC,CAAC;IACnE,IAAI,SAAS,EAAE,CAAC;QACd,KAAK,MAAM,IAAI,IAAI,SAAS,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YAC5C,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;YACtC,IAAI,CAAC;gBAAE,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC,CAAC;QAChE,CAAC;IACH,CAAC;IAED,OAAO;QACL,IAAI,EAAE,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,IAAI,UAAU,CAAC,CAAC,IAAI,EAAE;QAC3C,WAAW,EAAE,SAAS;YACpB,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;YACzE,CAAC,CAAC,EAAE;QACN,QAAQ;QACR,IAAI;QACJ,UAAU,EAAE,cAAc;KAC3B,CAAC;AACJ,CAAC;AAED,QAAQ,CAAC,uDAAuD,EAAE,GAAG,EAAE;IACrE,MAAM,SAAS,GAAG,oBAAoB,EAAE,CAAC;IAEzC,EAAE,CAAC,uDAAuD,EAAE,GAAG,EAAE;QAC/D,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACxC,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;QACjD,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC;IACrD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gEAAgE,EAAE,GAAG,EAAE;QACxE,MAAM,GAAG,GAAG,aAAa,CAAC,SAAS,CAAC,EAAE,SAAS,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,SAAS,EAAE,EAAE,CAAC,CAAC;QACpF,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QACjC,MAAM,IAAI,GAAG,aAAa,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC,cAAc,CAAC;QAC7F,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iHAAiH,EAAE,GAAG,EAAE;QACzH,MAAM,GAAG,GAAG,aAAa,CAAC,SAAS,CAAC,EAAE,SAAS,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,SAAS,EAAE,EAAE,CAAC,CAAC;QACpF,qEAAqE;QACrE,+DAA+D;QAC/D,oEAAoE;QACpE,oCAAoC;QACpC,MAAM,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QACtC,0DAA0D;QAC1D,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,qBAAqB,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACzD,MAAM,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,0CAA0C,CAAC,CAAC;QAClE,gEAAgE;QAChE,MAAM,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;QACpC,MAAM,IAAI,GAAG,aAAa,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC,cAAc,CAAC;QAC7F,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,kCAAkC,CAAC,CAAC;IACxD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yGAAyG,EAAE,GAAG,EAAE;QACjH,MAAM,GAAG,GAAG,YAAY,CAAC,SAAS,CAAC,EAAE,SAAS,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,SAAS,EAAE,EAAE,CAAC,CAAC;QACnF,MAAM,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QACtC,MAAM,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,0CAA0C,CAAC,CAAC;QAClE,2EAA2E;QAC3E,MAAM,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;QACpC,MAAM,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC;QACvC,MAAM,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;QACpC,MAAM,IAAI,GAAG,YAAY,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC,cAAc,CAAC;QAC5F,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;IACjD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qFAAqF,EAAE,GAAG,EAAE;QAC7F,MAAM,GAAG,GAAG,cAAc,CAAC,SAAS,CAAC,EAAE,SAAS,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,SAAS,EAAE,EAAE,CAAC,CAAC;QACrF,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACrB,uEAAuE;QACvE,MAAM,IAAI,GAAG,cAAc,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC,cAAc,CAAC;QAC9F,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,iCAAiC,CAAC,CAAC;IACvD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0HAA0H,EAAE,GAAG,EAAE;QAClI,0EAA0E;QAC1E,2EAA2E;QAC3E,2EAA2E;QAC3E,qEAAqE;QACrE,MAAM,UAAU,GAAG,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,sCAAsC,CAAC,IAAI,EAAE,CAAC;QACtF,MAAM,SAAS,GAAG,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,qCAAqC,CAAC,IAAI,EAAE,CAAC;QACpF,MAAM,CAAC,UAAU,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAC/B,MAAM,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAChC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/surfaces/__tests__/telemetry.test.d.ts

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

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

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

package/dist/surfaces/__tests__/telemetry.test.js

@@ -0,0 +1,55 @@
+/**
+ * Reverse-map telemetry fallback — WP-421 S2c.
+ * When canonicalPathFor returns null on a known surface, the consumer must
+ * emit `surface-reverse-map-missing` telemetry and surface the generic upstream
+ * message ("edit upstream in .productbrain/skills|rules|hooks/").
+ */
+import { describe, expect, it, vi, beforeEach } from 'vitest';
+const trackEventMock = vi.fn();
+vi.mock('../../lib/telemetry.js', () => ({
+    trackEvent: (...args) => trackEventMock(...args),
+}));
+import { reportReverseMapMissing, getReverseMapFallbackMessage, } from '../telemetry.js';
+import { canonicalPathForAnySurface } from '../registry.js';
+describe('reportReverseMapMissing', () => {
+    beforeEach(() => {
+        trackEventMock.mockClear();
+    });
+    it('emits surface-reverse-map-missing with surface + projectionPath', () => {
+        const warnings = [];
+        reportReverseMapMissing({ surface: 'copilot', projectionPath: '.github/copilot-instructions.md' }, (msg) => warnings.push(msg));
+        expect(trackEventMock).toHaveBeenCalledWith('surface-reverse-map-missing', {
+            surface: 'copilot',
+            projectionPath: '.github/copilot-instructions.md',
+        });
+        expect(warnings).toHaveLength(1);
+        expect(warnings[0]).toContain('[surface-reverse-map-missing]');
+        expect(warnings[0]).toContain('copilot');
+        expect(warnings[0]).toContain(getReverseMapFallbackMessage());
+    });
+    it('exposes the canonical fallback message', () => {
+        expect(getReverseMapFallbackMessage()).toContain('.productbrain/skills');
+        expect(getReverseMapFallbackMessage()).toContain('rules');
+        expect(getReverseMapFallbackMessage()).toContain('hooks');
+    });
+});
+describe('canonicalPathForAnySurface', () => {
+    it('returns the first matching adapter for a known projection path', () => {
+        const cursorMatch = canonicalPathForAnySurface('.cursor/rules/foo.mdc');
+        expect(cursorMatch).toEqual({
+            surface: 'cursor',
+            canonicalPath: '.productbrain/rules/foo.md',
+        });
+        const claudeMatch = canonicalPathForAnySurface('.claude/skills/orient.md');
+        expect(claudeMatch).toEqual({
+            surface: 'claude',
+            canonicalPath: '.productbrain/skills/orient.md',
+        });
+    });
+    it('returns null for an unknown projection path (caller emits telemetry)', () => {
+        expect(canonicalPathForAnySurface('some/unknown/path.txt')).toBeNull();
+        // Copilot's aggregate file legitimately has no reverse map → null.
+        expect(canonicalPathForAnySurface('.github/copilot-instructions.md')).toBeNull();
+    });
+});
+//# sourceMappingURL=telemetry.test.js.map

package/dist/surfaces/__tests__/telemetry.test.js.map

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

package/dist/surfaces/adapter.d.ts

@@ -0,0 +1,70 @@
+/**
+ * SurfaceAdapter — WP-421 S2c (DEC-952).
+ *
+ * One canonical asset in `.productbrain/{skills,rules,hooks}/`; per-surface adapters
+ * detect/paths/transform/goldens. New surface = adapter file + registry line.
+ *
+ * canonicalPathFor is the REVERSE map: given a projection path on a surface
+ * (e.g. `.cursor/rules/foo.mdc`), return the canonical authoring path
+ * (e.g. `.productbrain/rules/foo.md`). Returns null when the path does not
+ * belong to this adapter — callers should use the telemetry fallback in
+ * `surfaces/telemetry.ts` to emit `surface-reverse-map-missing`.
+ */
+import type { CanonicalRule, CanonicalSkill } from '../generators/portable-knowledge.js';
+/** Discriminated union covering canonical asset bodies the adapters consume. */
+export type CanonicalAssetBody = ({
+    kind: 'skill';
+} & CanonicalSkill) | ({
+    kind: 'rule';
+} & CanonicalRule);
+/** Optional Chain grounding context the transform may consult when shaping output. */
+export interface ChainGroundingContext {
+    workspaceStage?: string;
+    totalRelations?: number;
+    detectedStack?: string[];
+    /** Free-form context bag for future grounding signals — adapters MUST tolerate unknown keys. */
+    [key: string]: unknown;
+}
+export interface SurfaceAssetRef {
+    kind: 'skill' | 'rule' | 'hook';
+    basename: string;
+}
+export interface SurfacePaths {
+    /** Path relative to repoRoot where the projection is written. */
+    projectionPath: string;
+}
+export interface SurfaceAdapter {
+    /** Stable machine identity (matches SurfaceName in registry.ts). */
+    name: string;
+    /** Human-friendly display label. */
+    displayName: string;
+    /**
+     * Does this surface exist in the project? Used to decide whether to project at all.
+     * Pure: only inspects repoRoot — no network, no Chain calls.
+     */
+    detect(repoRoot: string): Promise<boolean> | boolean;
+    /** Where the projection is written for a given canonical asset. */
+    paths(asset: SurfaceAssetRef): SurfacePaths;
+    /** Take a canonical asset (+ optional grounding) and produce surface-formatted content. */
+    transform(input: {
+        canonical: CanonicalAssetBody;
+        grounding?: ChainGroundingContext;
+    }): string;
+    /**
+     * Round-trip golden fixtures: pinned (canonical, expected) pairs.
+     * Each adapter MUST define at least one. Tests assert transform(canonical) === expected.
+     */
+    goldens: SurfaceGolden[];
+    /**
+     * REVERSE map from a projection path back to the canonical authoring path
+     * in `.productbrain/`. Used by tampered-bucket prompts to point users at the
+     * upstream source. Returns null when the path is unknown to this adapter.
+     */
+    canonicalPathFor(projectionPath: string): string | null;
+}
+export interface SurfaceGolden {
+    name: string;
+    canonical: CanonicalAssetBody;
+    expected: string;
+}
+//# sourceMappingURL=adapter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../src/surfaces/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAC;AAEzF,gFAAgF;AAChF,MAAM,MAAM,kBAAkB,GAC1B,CAAC;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GAAG,cAAc,CAAC,GACpC,CAAC;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,aAAa,CAAC,CAAC;AAEvC,sFAAsF;AACtF,MAAM,WAAW,qBAAqB;IACpC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,gGAAgG;IAChG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;IAChC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,iEAAiE;IACjE,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,cAAc;IAC7B,oEAAoE;IACpE,IAAI,EAAE,MAAM,CAAC;IACb,oCAAoC;IACpC,WAAW,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;IAErD,mEAAmE;IACnE,KAAK,CAAC,KAAK,EAAE,eAAe,GAAG,YAAY,CAAC;IAE5C,2FAA2F;IAC3F,SAAS,CAAC,KAAK,EAAE;QAAE,SAAS,EAAE,kBAAkB,CAAC;QAAC,SAAS,CAAC,EAAE,qBAAqB,CAAA;KAAE,GAAG,MAAM,CAAC;IAE/F;;;OAGG;IACH,OAAO,EAAE,aAAa,EAAE,CAAC;IAEzB;;;;OAIG;IACH,gBAAgB,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;CACzD;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,kBAAkB,CAAC;IAC9B,QAAQ,EAAE,MAAM,CAAC;CAClB"}

package/dist/surfaces/adapter.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=adapter.js.map

package/dist/surfaces/adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../../src/surfaces/adapter.ts"],"names":[],"mappings":""}

package/dist/surfaces/adapters/claude.d.ts

@@ -0,0 +1,3 @@
+import type { SurfaceAdapter } from '../adapter.js';
+export declare const claudeAdapter: SurfaceAdapter;
+//# sourceMappingURL=claude.d.ts.map

package/dist/surfaces/adapters/claude.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude.d.ts","sourceRoot":"","sources":["../../../src/surfaces/adapters/claude.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAGV,cAAc,EAIf,MAAM,eAAe,CAAC;AAoDvB,eAAO,MAAM,aAAa,EAAE,cAQ3B,CAAC"}

package/dist/surfaces/adapters/claude.js

@@ -0,0 +1,67 @@
+/**
+ * Claude Code SurfaceAdapter — WP-421 S2c (DEC-952).
+ *
+ * Projects:
+ *   - rules → .claude/rules/<name>.md
+ *   - skills → .claude/skills/<name>.md (legacy skill projection; canonical lives in .productbrain/skills/)
+ *   - hooks → .claude/settings.json (handled outside the per-asset transform path)
+ */
+import { existsSync } from 'fs';
+import { join } from 'path';
+import { generateClaudeRule, } from '../../generators/portable-knowledge.js';
+function transform(input) {
+    const { canonical } = input;
+    if (canonical.kind === 'rule') {
+        return generateClaudeRule(canonical);
+    }
+    // Skills: claude rules-router has a separate generator; per-skill projection
+    // re-emits the canonical body verbatim under .claude/skills/. Keep this in
+    // sync with handshake.ts which currently writes canonical body untouched.
+    return canonical.body;
+}
+function paths(asset) {
+    switch (asset.kind) {
+        case 'rule':
+            return { projectionPath: `.claude/rules/${asset.basename}.md` };
+        case 'skill':
+            return { projectionPath: `.claude/skills/${asset.basename}.md` };
+        case 'hook':
+            return { projectionPath: '.claude/settings.json' };
+    }
+}
+const goldenRule = {
+    name: 'sample-rule',
+    description: 'Sample rule for golden test',
+    scope: undefined,
+    autoApply: true,
+    body: 'Body referencing .productbrain/rules/other.md and .productbrain/skills/x.md\n',
+    sourcePath: '/abs/.productbrain/rules/sample-rule.md',
+};
+const goldens = [
+    {
+        name: 'rule-with-canonical-path-rewrite',
+        canonical: { kind: 'rule', ...goldenRule },
+        expected: generateClaudeRule(goldenRule),
+    },
+];
+function canonicalPathFor(projectionPath) {
+    // Normalize: accept paths with or without leading "./".
+    const p = projectionPath.replace(/^\.\//, '');
+    let m = p.match(/^\.claude\/rules\/(.+)\.md$/);
+    if (m)
+        return `.productbrain/rules/${m[1]}.md`;
+    m = p.match(/^\.claude\/skills\/(.+)\.md$/);
+    if (m)
+        return `.productbrain/skills/${m[1]}.md`;
+    return null;
+}
+export const claudeAdapter = {
+    name: 'claude',
+    displayName: 'Claude Code',
+    detect: (repoRoot) => existsSync(join(repoRoot, '.claude')),
+    paths,
+    transform,
+    goldens,
+    canonicalPathFor,
+};
+//# sourceMappingURL=claude.js.map

package/dist/surfaces/adapters/claude.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude.js","sourceRoot":"","sources":["../../../src/surfaces/adapters/claude.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAChC,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EACL,kBAAkB,GACnB,MAAM,wCAAwC,CAAC;AAYhD,SAAS,SAAS,CAAC,KAA2E;IAC5F,MAAM,EAAE,SAAS,EAAE,GAAG,KAAK,CAAC;IAC5B,IAAI,SAAS,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QAC9B,OAAO,kBAAkB,CAAC,SAAS,CAAC,CAAC;IACvC,CAAC;IACD,6EAA6E;IAC7E,2EAA2E;IAC3E,0EAA0E;IAC1E,OAAO,SAAS,CAAC,IAAI,CAAC;AACxB,CAAC;AAED,SAAS,KAAK,CAAC,KAAsB;IACnC,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;QACnB,KAAK,MAAM;YACT,OAAO,EAAE,cAAc,EAAE,iBAAiB,KAAK,CAAC,QAAQ,KAAK,EAAE,CAAC;QAClE,KAAK,OAAO;YACV,OAAO,EAAE,cAAc,EAAE,kBAAkB,KAAK,CAAC,QAAQ,KAAK,EAAE,CAAC;QACnE,KAAK,MAAM;YACT,OAAO,EAAE,cAAc,EAAE,uBAAuB,EAAE,CAAC;IACvD,CAAC;AACH,CAAC;AAED,MAAM,UAAU,GAAkB;IAChC,IAAI,EAAE,aAAa;IACnB,WAAW,EAAE,6BAA6B;IAC1C,KAAK,EAAE,SAAS;IAChB,SAAS,EAAE,IAAI;IACf,IAAI,EAAE,+EAA+E;IACrF,UAAU,EAAE,yCAAyC;CACtD,CAAC;AAEF,MAAM,OAAO,GAAoB;IAC/B;QACE,IAAI,EAAE,kCAAkC;QACxC,SAAS,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,UAAU,EAAE;QAC1C,QAAQ,EAAE,kBAAkB,CAAC,UAAU,CAAC;KACzC;CACF,CAAC;AAEF,SAAS,gBAAgB,CAAC,cAAsB;IAC9C,wDAAwD;IACxD,MAAM,CAAC,GAAG,cAAc,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAC9C,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,6BAA6B,CAAC,CAAC;IAC/C,IAAI,CAAC;QAAE,OAAO,uBAAuB,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IAC/C,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,8BAA8B,CAAC,CAAC;IAC5C,IAAI,CAAC;QAAE,OAAO,wBAAwB,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IAChD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,CAAC,MAAM,aAAa,GAAmB;IAC3C,IAAI,EAAE,QAAQ;IACd,WAAW,EAAE,aAAa;IAC1B,MAAM,EAAE,CAAC,QAAgB,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;IACnE,KAAK;IACL,SAAS;IACT,OAAO;IACP,gBAAgB;CACjB,CAAC"}

package/dist/surfaces/adapters/codex.d.ts

@@ -0,0 +1,3 @@
+import type { SurfaceAdapter } from '../adapter.js';
+export declare const codexAdapter: SurfaceAdapter;
+//# sourceMappingURL=codex.d.ts.map

package/dist/surfaces/adapters/codex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex.d.ts","sourceRoot":"","sources":["../../../src/surfaces/adapters/codex.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAGV,cAAc,EAIf,MAAM,eAAe,CAAC;AA8CvB,eAAO,MAAM,YAAY,EAAE,cAS1B,CAAC"}

package/dist/surfaces/adapters/codex.js

@@ -0,0 +1,61 @@
+/**
+ * Codex SurfaceAdapter — WP-421 S2c (DEC-952).
+ *
+ * Projects:
+ *   - skills → .codex/skills/<name>.md
+ *   - rules: not projected (codex consumes AGENTS.md instead).
+ *   - hooks → AGENTS.md (handled outside per-asset transform path).
+ */
+import { existsSync } from 'fs';
+import { join } from 'path';
+import { generateCodexSkill } from '../../generators/portable-knowledge.js';
+function transform(input) {
+    const { canonical } = input;
+    if (canonical.kind === 'skill')
+        return generateCodexSkill(canonical);
+    // Rules are not projected to codex; pass body through unchanged for completeness.
+    return canonical.body;
+}
+function paths(asset) {
+    switch (asset.kind) {
+        case 'skill':
+            return { projectionPath: `.codex/skills/${asset.basename}.md` };
+        case 'rule':
+            // Codex has no per-rule projection target — return AGENTS.md for callers
+            // that need a path; handshake won't actually write rules here.
+            return { projectionPath: 'AGENTS.md' };
+        case 'hook':
+            return { projectionPath: 'AGENTS.md' };
+    }
+}
+const goldenSkill = {
+    name: 'sample-skill',
+    description: 'Sample skill for golden test',
+    triggers: ['/sample'],
+    body: 'Reference .productbrain/skills/other.md inside the body.\n',
+    sourcePath: '/abs/.productbrain/skills/sample-skill.md',
+};
+const goldens = [
+    {
+        name: 'skill-with-canonical-path-rewrite',
+        canonical: { kind: 'skill', ...goldenSkill },
+        expected: generateCodexSkill(goldenSkill),
+    },
+];
+function canonicalPathFor(projectionPath) {
+    const p = projectionPath.replace(/^\.\//, '');
+    const m = p.match(/^\.codex\/skills\/(.+)\.md$/);
+    if (m)
+        return `.productbrain/skills/${m[1]}.md`;
+    return null;
+}
+export const codexAdapter = {
+    name: 'codex',
+    displayName: 'Codex',
+    detect: (repoRoot) => existsSync(join(repoRoot, '.codex')) || existsSync(join(repoRoot, 'AGENTS.md')),
+    paths,
+    transform,
+    goldens,
+    canonicalPathFor,
+};
+//# sourceMappingURL=codex.js.map

package/dist/surfaces/adapters/codex.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex.js","sourceRoot":"","sources":["../../../src/surfaces/adapters/codex.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAChC,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,kBAAkB,EAAE,MAAM,wCAAwC,CAAC;AAW5E,SAAS,SAAS,CAAC,KAA2E;IAC5F,MAAM,EAAE,SAAS,EAAE,GAAG,KAAK,CAAC;IAC5B,IAAI,SAAS,CAAC,IAAI,KAAK,OAAO;QAAE,OAAO,kBAAkB,CAAC,SAAS,CAAC,CAAC;IACrE,kFAAkF;IAClF,OAAO,SAAS,CAAC,IAAI,CAAC;AACxB,CAAC;AAED,SAAS,KAAK,CAAC,KAAsB;IACnC,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;QACnB,KAAK,OAAO;YACV,OAAO,EAAE,cAAc,EAAE,iBAAiB,KAAK,CAAC,QAAQ,KAAK,EAAE,CAAC;QAClE,KAAK,MAAM;YACT,yEAAyE;YACzE,+DAA+D;YAC/D,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,CAAC;QACzC,KAAK,MAAM;YACT,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,CAAC;IAC3C,CAAC;AACH,CAAC;AAED,MAAM,WAAW,GAAmB;IAClC,IAAI,EAAE,cAAc;IACpB,WAAW,EAAE,8BAA8B;IAC3C,QAAQ,EAAE,CAAC,SAAS,CAAC;IACrB,IAAI,EAAE,4DAA4D;IAClE,UAAU,EAAE,2CAA2C;CACxD,CAAC;AAEF,MAAM,OAAO,GAAoB;IAC/B;QACE,IAAI,EAAE,mCAAmC;QACzC,SAAS,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,WAAW,EAAE;QAC5C,QAAQ,EAAE,kBAAkB,CAAC,WAAW,CAAC;KAC1C;CACF,CAAC;AAEF,SAAS,gBAAgB,CAAC,cAAsB;IAC9C,MAAM,CAAC,GAAG,cAAc,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAC9C,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,6BAA6B,CAAC,CAAC;IACjD,IAAI,CAAC;QAAE,OAAO,wBAAwB,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IAChD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,CAAC,MAAM,YAAY,GAAmB;IAC1C,IAAI,EAAE,OAAO;IACb,WAAW,EAAE,OAAO;IACpB,MAAM,EAAE,CAAC,QAAgB,EAAE,EAAE,CAC3B,UAAU,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;IACjF,KAAK;IACL,SAAS;IACT,OAAO;IACP,gBAAgB;CACjB,CAAC"}

package/dist/surfaces/adapters/copilot.d.ts

@@ -0,0 +1,3 @@
+import type { SurfaceAdapter } from '../adapter.js';
+export declare const copilotAdapter: SurfaceAdapter;
+//# sourceMappingURL=copilot.d.ts.map

package/dist/surfaces/adapters/copilot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"copilot.d.ts","sourceRoot":"","sources":["../../../src/surfaces/adapters/copilot.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAGV,cAAc,EAIf,MAAM,eAAe,CAAC;AA2CvB,eAAO,MAAM,cAAc,EAAE,cAS5B,CAAC"}

package/dist/surfaces/adapters/copilot.js

@@ -0,0 +1,59 @@
+/**
+ * Copilot SurfaceAdapter — WP-421 S2c (DEC-952).
+ *
+ * Copilot has only one projection target — `.github/copilot-instructions.md` — which
+ * concatenates rule summaries. Per-skill projection is unsupported.
+ *
+ * canonicalPathFor returns null for the aggregate file: there is no 1:1 reverse map
+ * (the file is generated from many sources). Consumers fall back to the generic
+ * "edit upstream in .productbrain/{skills,rules,hooks}/" message and emit
+ * `surface-reverse-map-missing` telemetry — see surfaces/telemetry.ts.
+ */
+import { existsSync } from 'fs';
+import { join } from 'path';
+function transform(input) {
+    // Copilot aggregates rule summaries inside copilot-instructions.md; the
+    // single-asset transform emits the rule's summary block. Skills are not
+    // included (matches handshake.ts behavior).
+    const { canonical } = input;
+    if (canonical.kind === 'rule') {
+        return `### ${canonical.name}\n${canonical.description}\n`;
+    }
+    return '';
+}
+function paths(_asset) {
+    return { projectionPath: '.github/copilot-instructions.md' };
+}
+const goldenRule = {
+    name: 'sample-rule',
+    description: 'Sample rule for golden test',
+    scope: undefined,
+    autoApply: true,
+    body: 'unused for copilot summary',
+    sourcePath: '/abs/.productbrain/rules/sample-rule.md',
+};
+const goldens = [
+    {
+        name: 'rule-summary-block',
+        canonical: { kind: 'rule', ...goldenRule },
+        expected: `### ${goldenRule.name}\n${goldenRule.description}\n`,
+    },
+];
+function canonicalPathFor(projectionPath) {
+    // Copilot's only target file aggregates many canonical sources — no defensible
+    // 1:1 reverse map. Return null and let consumers emit the telemetry fallback.
+    const p = projectionPath.replace(/^\.\//, '');
+    if (p === '.github/copilot-instructions.md')
+        return null;
+    return null;
+}
+export const copilotAdapter = {
+    name: 'copilot',
+    displayName: 'GitHub Copilot',
+    detect: (repoRoot) => existsSync(join(repoRoot, '.github', 'copilot-instructions.md')),
+    paths,
+    transform,
+    goldens,
+    canonicalPathFor,
+};
+//# sourceMappingURL=copilot.js.map

package/dist/surfaces/adapters/copilot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"copilot.js","sourceRoot":"","sources":["../../../src/surfaces/adapters/copilot.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAChC,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAW5B,SAAS,SAAS,CAAC,KAA2E;IAC5F,wEAAwE;IACxE,wEAAwE;IACxE,4CAA4C;IAC5C,MAAM,EAAE,SAAS,EAAE,GAAG,KAAK,CAAC;IAC5B,IAAI,SAAS,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QAC9B,OAAO,OAAO,SAAS,CAAC,IAAI,KAAK,SAAS,CAAC,WAAW,IAAI,CAAC;IAC7D,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,SAAS,KAAK,CAAC,MAAuB;IACpC,OAAO,EAAE,cAAc,EAAE,iCAAiC,EAAE,CAAC;AAC/D,CAAC;AAED,MAAM,UAAU,GAAkB;IAChC,IAAI,EAAE,aAAa;IACnB,WAAW,EAAE,6BAA6B;IAC1C,KAAK,EAAE,SAAS;IAChB,SAAS,EAAE,IAAI;IACf,IAAI,EAAE,4BAA4B;IAClC,UAAU,EAAE,yCAAyC;CACtD,CAAC;AAEF,MAAM,OAAO,GAAoB;IAC/B;QACE,IAAI,EAAE,oBAAoB;QAC1B,SAAS,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,UAAU,EAAE;QAC1C,QAAQ,EAAE,OAAO,UAAU,CAAC,IAAI,KAAK,UAAU,CAAC,WAAW,IAAI;KAChE;CACF,CAAC;AAEF,SAAS,gBAAgB,CAAC,cAAsB;IAC9C,+EAA+E;IAC/E,8EAA8E;IAC9E,MAAM,CAAC,GAAG,cAAc,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAC9C,IAAI,CAAC,KAAK,iCAAiC;QAAE,OAAO,IAAI,CAAC;IACzD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,CAAC,MAAM,cAAc,GAAmB;IAC5C,IAAI,EAAE,SAAS;IACf,WAAW,EAAE,gBAAgB;IAC7B,MAAM,EAAE,CAAC,QAAgB,EAAE,EAAE,CAC3B,UAAU,CAAC,IAAI,CAAC,QAAQ,EAAE,SAAS,EAAE,yBAAyB,CAAC,CAAC;IAClE,KAAK;IACL,SAAS;IACT,OAAO;IACP,gBAAgB;CACjB,CAAC"}

package/dist/surfaces/adapters/cursor.d.ts

@@ -0,0 +1,3 @@
+import type { SurfaceAdapter } from '../adapter.js';
+export declare const cursorAdapter: SurfaceAdapter;
+//# sourceMappingURL=cursor.d.ts.map

package/dist/surfaces/adapters/cursor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor.d.ts","sourceRoot":"","sources":["../../../src/surfaces/adapters/cursor.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAGV,cAAc,EAIf,MAAM,eAAe,CAAC;AA+DvB,eAAO,MAAM,aAAa,EAAE,cAQ3B,CAAC"}

package/dist/surfaces/adapters/cursor.js

@@ -0,0 +1,78 @@
+/**
+ * Cursor SurfaceAdapter — WP-421 S2c (DEC-952).
+ *
+ * Projects:
+ *   - rules → .cursor/rules/<name>.mdc   (note the .md → .mdc extension flip)
+ *   - skills → .cursor/skills/<name>/SKILL.md
+ *   - hooks: not supported (INS-740 — empty hookEvents)
+ */
+import { existsSync } from 'fs';
+import { join } from 'path';
+import { generateCursorRule, generateCursorSkill, } from '../../generators/portable-knowledge.js';
+function transform(input) {
+    const { canonical } = input;
+    if (canonical.kind === 'rule')
+        return generateCursorRule(canonical);
+    return generateCursorSkill(canonical);
+}
+function paths(asset) {
+    switch (asset.kind) {
+        case 'rule':
+            // .md → .mdc extension flip is the cursor-specific signature.
+            return { projectionPath: `.cursor/rules/${asset.basename}.mdc` };
+        case 'skill':
+            return { projectionPath: `.cursor/skills/${asset.basename}/SKILL.md` };
+        case 'hook':
+            // INS-740: cursor has no native hook events. Path returned for completeness;
+            // handshake never writes here by default.
+            return { projectionPath: '.cursor/settings.json' };
+    }
+}
+const goldenRule = {
+    name: 'sample-rule',
+    description: 'Sample rule for golden test',
+    scope: undefined,
+    autoApply: true,
+    body: 'Body referencing .productbrain/rules/other.md and .productbrain/skills/x.md\n',
+    sourcePath: '/abs/.productbrain/rules/sample-rule.md',
+};
+const goldenSkill = {
+    name: 'sample-skill',
+    description: 'Sample skill for golden test',
+    triggers: ['/sample'],
+    body: 'Reference .productbrain/skills/other.md inside the body.\n',
+    sourcePath: '/abs/.productbrain/skills/sample-skill.md',
+};
+const goldens = [
+    {
+        name: 'rule-mdc-frontmatter',
+        canonical: { kind: 'rule', ...goldenRule },
+        expected: generateCursorRule(goldenRule),
+    },
+    {
+        name: 'skill-trigger-injection',
+        canonical: { kind: 'skill', ...goldenSkill },
+        expected: generateCursorSkill(goldenSkill),
+    },
+];
+function canonicalPathFor(projectionPath) {
+    const p = projectionPath.replace(/^\.\//, '');
+    // Reverse the .md → .mdc extension flip on the rule projection.
+    let m = p.match(/^\.cursor\/rules\/(.+)\.mdc$/);
+    if (m)
+        return `.productbrain/rules/${m[1]}.md`;
+    m = p.match(/^\.cursor\/skills\/(.+)\/SKILL\.md$/);
+    if (m)
+        return `.productbrain/skills/${m[1]}.md`;
+    return null;
+}
+export const cursorAdapter = {
+    name: 'cursor',
+    displayName: 'Cursor',
+    detect: (repoRoot) => existsSync(join(repoRoot, '.cursor')),
+    paths,
+    transform,
+    goldens,
+    canonicalPathFor,
+};
+//# sourceMappingURL=cursor.js.map

package/dist/surfaces/adapters/cursor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor.js","sourceRoot":"","sources":["../../../src/surfaces/adapters/cursor.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAChC,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EACL,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,wCAAwC,CAAC;AAWhD,SAAS,SAAS,CAAC,KAA2E;IAC5F,MAAM,EAAE,SAAS,EAAE,GAAG,KAAK,CAAC;IAC5B,IAAI,SAAS,CAAC,IAAI,KAAK,MAAM;QAAE,OAAO,kBAAkB,CAAC,SAAS,CAAC,CAAC;IACpE,OAAO,mBAAmB,CAAC,SAAS,CAAC,CAAC;AACxC,CAAC;AAED,SAAS,KAAK,CAAC,KAAsB;IACnC,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;QACnB,KAAK,MAAM;YACT,8DAA8D;YAC9D,OAAO,EAAE,cAAc,EAAE,iBAAiB,KAAK,CAAC,QAAQ,MAAM,EAAE,CAAC;QACnE,KAAK,OAAO;YACV,OAAO,EAAE,cAAc,EAAE,kBAAkB,KAAK,CAAC,QAAQ,WAAW,EAAE,CAAC;QACzE,KAAK,MAAM;YACT,6EAA6E;YAC7E,0CAA0C;YAC1C,OAAO,EAAE,cAAc,EAAE,uBAAuB,EAAE,CAAC;IACvD,CAAC;AACH,CAAC;AAED,MAAM,UAAU,GAAkB;IAChC,IAAI,EAAE,aAAa;IACnB,WAAW,EAAE,6BAA6B;IAC1C,KAAK,EAAE,SAAS;IAChB,SAAS,EAAE,IAAI;IACf,IAAI,EAAE,+EAA+E;IACrF,UAAU,EAAE,yCAAyC;CACtD,CAAC;AAEF,MAAM,WAAW,GAAmB;IAClC,IAAI,EAAE,cAAc;IACpB,WAAW,EAAE,8BAA8B;IAC3C,QAAQ,EAAE,CAAC,SAAS,CAAC;IACrB,IAAI,EAAE,4DAA4D;IAClE,UAAU,EAAE,2CAA2C;CACxD,CAAC;AAEF,MAAM,OAAO,GAAoB;IAC/B;QACE,IAAI,EAAE,sBAAsB;QAC5B,SAAS,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,UAAU,EAAE;QAC1C,QAAQ,EAAE,kBAAkB,CAAC,UAAU,CAAC;KACzC;IACD;QACE,IAAI,EAAE,yBAAyB;QAC/B,SAAS,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,WAAW,EAAE;QAC5C,QAAQ,EAAE,mBAAmB,CAAC,WAAW,CAAC;KAC3C;CACF,CAAC;AAEF,SAAS,gBAAgB,CAAC,cAAsB;IAC9C,MAAM,CAAC,GAAG,cAAc,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAC9C,gEAAgE;IAChE,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,8BAA8B,CAAC,CAAC;IAChD,IAAI,CAAC;QAAE,OAAO,uBAAuB,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IAC/C,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,qCAAqC,CAAC,CAAC;IACnD,IAAI,CAAC;QAAE,OAAO,wBAAwB,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IAChD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,CAAC,MAAM,aAAa,GAAmB;IAC3C,IAAI,EAAE,QAAQ;IACd,WAAW,EAAE,QAAQ;IACrB,MAAM,EAAE,CAAC,QAAgB,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;IACnE,KAAK;IACL,SAAS;IACT,OAAO;IACP,gBAAgB;CACjB,CAAC"}

package/dist/surfaces/registry.d.ts

@@ -1,10 +1,15 @@
 /**
- * Surface Capability Registry — WP-310 S0 (FEAT-959)
+ * 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).
  *
- * Static typed record of per-surface capabilities consumed by E1–E4.
  * 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';
@@ -17,4 +22,55 @@ export interface SurfaceCapability {
     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

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