@productbrain/cli 0.1.0-beta.99 → 0.1.0-beta.997

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

@@ -0,0 +1,132 @@
+/**
+ * pb-setup canonical skill — SurfaceAdapter passthrough goldens (WP-431 S4).
+ *
+ * doneWhen #1: the canonical .productbrain/skills/pb-setup.md projects through
+ * each adapter's `transform` such that the body content is preserved verbatim
+ * (no surface-specific rewriting of the body). Per DEC-997, the skill body is
+ * the universal SSOT and uses the in-body surface-routing block to drive both
+ * CLI and chat-only flows; the adapter's job is wrapping (frontmatter,
+ * marker), not rewriting the body itself.
+ *
+ * Parity assertions per adapter:
+ *   - claude:  body emitted verbatim (no wrapping). Path matches `.claude/skills/pb-setup.md`.
+ *   - cursor:  body preserved inside a Cursor SKILL.md wrapper. Path matches
+ *              `.cursor/skills/pb-setup/SKILL.md`. Triggers appear in the
+ *              wrapper's description.
+ *   - codex:   body preserved inside a Codex skill projection wrapper. Path
+ *              matches `.codex/skills/pb-setup.md`. Triggers appear in the
+ *              wrapper.
+ *   - copilot: skills not projected (skillsFormat: 'none'). Transform returns
+ *              empty string for skill kind (matches handshake.ts behavior).
+ *
+ * The test reads the canonical file from disk so a content drift in the
+ * source markdown surfaces here.
+ */
+import { describe, expect, it } from 'vitest';
+import { readFileSync, existsSync } from 'fs';
+import { join } from 'path';
+import { fileURLToPath } from 'url';
+import { dirname } from 'path';
+import { claudeAdapter } from '../adapters/claude.js';
+import { cursorAdapter } from '../adapters/cursor.js';
+import { codexAdapter } from '../adapters/codex.js';
+import { copilotAdapter } from '../adapters/copilot.js';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+// repo root: packages/cli/src/surfaces/__tests__ -> ../../../../..
+const REPO_ROOT = join(__dirname, '..', '..', '..', '..', '..');
+const CANONICAL_PATH = join(REPO_ROOT, '.productbrain', 'skills', 'pb-setup.md');
+/**
+ * Minimal frontmatter parser tuned to the pb-setup skill shape. We avoid
+ * importing the production parser to keep this test independent of internal
+ * helper drift (the goldens are about the `transform` contract, not the
+ * parser).
+ */
+function loadCanonicalPbSetup() {
+    if (!existsSync(CANONICAL_PATH)) {
+        throw new Error(`Canonical pb-setup.md not found at ${CANONICAL_PATH}`);
+    }
+    const raw = readFileSync(CANONICAL_PATH, 'utf8');
+    const match = raw.match(/^---\r?\n([\s\S]*?)\r?\n---\r?\n?([\s\S]*)$/);
+    if (!match)
+        throw new Error('pb-setup.md missing frontmatter');
+    const yaml = match[1];
+    const body = match[2];
+    const nameMatch = yaml.match(/^name:\s*(.+)$/m);
+    const descMatch = yaml.match(/description:\s*>-\s*\n((?:\s+.+\n?)+?)(?=^\w|^---|\Z)/m);
+    const triggers = [];
+    const trigBlock = yaml.match(/^triggers:\s*\n((?:\s+-\s.+\n?)+)/m);
+    if (trigBlock) {
+        for (const line of trigBlock[1].split('\n')) {
+            const m = line.match(/^\s+-\s+(.+)$/);
+            if (m)
+                triggers.push(m[1].trim().replace(/^["']|["']$/g, ''));
+        }
+    }
+    return {
+        name: (nameMatch?.[1] ?? 'pb-setup').trim(),
+        description: descMatch
+            ? descMatch[1].split('\n').map((l) => l.trim()).filter(Boolean).join(' ')
+            : '',
+        triggers,
+        body,
+        sourcePath: CANONICAL_PATH,
+    };
+}
+describe('pb-setup canonical skill — SurfaceAdapter passthrough', () => {
+    const canonical = loadCanonicalPbSetup();
+    it('canonical file exists with expected name and triggers', () => {
+        expect(canonical.name).toBe('pb-setup');
+        expect(canonical.triggers).toContain('pb setup');
+        expect(canonical.body.length).toBeGreaterThan(500);
+    });
+    it('claude adapter: body verbatim, path .claude/skills/pb-setup.md', () => {
+        const out = claudeAdapter.transform({ canonical: { kind: 'skill', ...canonical } });
+        expect(out).toBe(canonical.body);
+        const path = claudeAdapter.paths({ kind: 'skill', basename: canonical.name }).projectionPath;
+        expect(path).toBe('.claude/skills/pb-setup.md');
+    });
+    it('cursor adapter: body content preserved inside wrapper, triggers injected, path .cursor/skills/pb-setup/SKILL.md', () => {
+        const out = cursorAdapter.transform({ canonical: { kind: 'skill', ...canonical } });
+        // Body content must appear verbatim (the cursor regex does not match
+        // `.productbrain/{skills,rules,hooks}/...md` — the body has no
+        // `.productbrain/skills/<name>.md` literal references that would be
+        // rewritten, so passthrough holds).
+        expect(out).toContain(canonical.body);
+        // Cursor wraps with its own frontmatter + marker comment.
+        expect(out.startsWith('---\nname: pb-setup')).toBe(true);
+        expect(out).toContain('source: .productbrain/skills/pb-setup.md');
+        // Triggers travel into the description per Cursor's convention.
+        expect(out).toContain('"pb setup"');
+        const path = cursorAdapter.paths({ kind: 'skill', basename: canonical.name }).projectionPath;
+        expect(path).toBe('.cursor/skills/pb-setup/SKILL.md');
+    });
+    it('codex adapter: body content preserved inside wrapper, triggers attached, path .codex/skills/pb-setup.md', () => {
+        const out = codexAdapter.transform({ canonical: { kind: 'skill', ...canonical } });
+        expect(out).toContain(canonical.body);
+        expect(out).toContain('source: .productbrain/skills/pb-setup.md');
+        // Codex wraps with a `# <name>` heading, description, and a Triggers line.
+        expect(out).toContain('# pb-setup');
+        expect(out).toContain('**Triggers:**');
+        expect(out).toContain('`pb setup`');
+        const path = codexAdapter.paths({ kind: 'skill', basename: canonical.name }).projectionPath;
+        expect(path).toBe('.codex/skills/pb-setup.md');
+    });
+    it('copilot adapter: skills not projected (skillsFormat: none), transform returns empty', () => {
+        const out = copilotAdapter.transform({ canonical: { kind: 'skill', ...canonical } });
+        expect(out).toBe('');
+        // Copilot's only target file is the aggregate copilot-instructions.md.
+        const path = copilotAdapter.paths({ kind: 'skill', basename: canonical.name }).projectionPath;
+        expect(path).toBe('.github/copilot-instructions.md');
+    });
+    it('canonical body is free of `.productbrain/{skills,rules}/<name>.md` literal refs that would trigger surface path rewrites', () => {
+        // Per DEC-997, the canonical skill body should not depend on adapter path
+        // rewriting — the in-body surface-routing block carries all surface logic.
+        // Guard: if a future edit adds such a literal reference, this test catches
+        // it BEFORE the cursor/codex transform mangles it through the regex.
+        const skillsRefs = canonical.body.match(/\.productbrain\/skills\/[\w.-]+\.md/g) ?? [];
+        const rulesRefs = canonical.body.match(/\.productbrain\/rules\/[\w.-]+\.md/g) ?? [];
+        expect(skillsRefs).toEqual([]);
+        expect(rulesRefs).toEqual([]);
+    });
+});
+//# sourceMappingURL=pb-setup-passthrough.test.js.map

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

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