@productbrain/cli 0.1.0-beta.85 → 0.1.0-beta.86

package/dist/__tests__/personal-layer.test.js

@@ -0,0 +1,304 @@
+/**
+ * personal-layer.test.ts — unit tests for WP-310 E2: personal workspace layer.
+ *
+ * Tests:
+ * 1. readPersonalLayer() returns [] when .productbrain/.local/rules/ is absent
+ * 2. Rules from readPersonalLayer() have persist: 'local'
+ * 3. Name collision detection fires when personal rule name matches team rule name
+ * 4. shouldEmitToTarget with persist: 'local' — local rules excluded from committed adapter targets
+ * 5. isPersistLocal helper
+ */
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+import { join } from 'path';
+// vi.mock calls are hoisted — use vi.hoisted() for constants referenced inside factories.
+const { vfs, MOCK_PB_DIR } = vi.hoisted(() => ({
+    vfs: {},
+    MOCK_PB_DIR: '/tmp/pb-test/.productbrain',
+}));
+vi.mock('fs', () => ({
+    existsSync: vi.fn((path) => path in vfs || Object.keys(vfs).some((k) => k.startsWith(path + '/'))),
+    readFileSync: vi.fn((path, _enc) => {
+        if (path in vfs)
+            return vfs[path];
+        throw Object.assign(new Error(`ENOENT: no such file '${path}'`), { code: 'ENOENT' });
+    }),
+    readdirSync: vi.fn((path) => {
+        const prefix = path.endsWith('/') ? path : path + '/';
+        return Object.keys(vfs)
+            .filter((k) => k.startsWith(prefix) && !k.slice(prefix.length).includes('/'))
+            .map((k) => k.slice(prefix.length));
+    }),
+}));
+import { readPersonalLayer, readPersonalSkillsLayer, shouldEmitToTarget, isPersistLocal } from '../generators/portable-knowledge.js';
+const LOCAL_RULES_DIR = join(MOCK_PB_DIR, '.local', 'rules');
+function makeRulePath(name) {
+    return join(LOCAL_RULES_DIR, `${name}.md`);
+}
+const MINIMAL_RULE_CONTENT = `---
+name: my-rule
+description: A test rule
+autoApply: false
+---
+
+Rule body content.
+`;
+const RULE_WITH_FRONTMATTER = `---
+name: personal-git-rule
+description: Personal git workflow preferences
+autoApply: true
+---
+
+Always sign commits.
+`;
+describe('readPersonalLayer()', () => {
+    beforeEach(() => {
+        Object.keys(vfs).forEach((k) => delete vfs[k]);
+        vi.clearAllMocks();
+    });
+    it('returns [] when .productbrain/.local/rules/ directory is absent', () => {
+        // vfs is empty — no local rules directory
+        const result = readPersonalLayer(MOCK_PB_DIR);
+        expect(result).toEqual([]);
+    });
+    it('returns [] when local rules directory exists but has no .md files', () => {
+        // Add a non-md file to make the directory "exist" in vfs
+        vfs[join(LOCAL_RULES_DIR, 'not-a-rule.txt')] = 'ignored';
+        const result = readPersonalLayer(MOCK_PB_DIR);
+        expect(result).toEqual([]);
+    });
+    it('returns rules with persist: "local" from .productbrain/.local/rules/', () => {
+        vfs[makeRulePath('my-rule')] = MINIMAL_RULE_CONTENT;
+        const result = readPersonalLayer(MOCK_PB_DIR);
+        expect(result).toHaveLength(1);
+        expect(result[0].persist).toBe('local');
+    });
+    it('sets persist: "local" on every returned rule regardless of file content', () => {
+        vfs[makeRulePath('rule-a')] = RULE_WITH_FRONTMATTER;
+        vfs[makeRulePath('rule-b')] = MINIMAL_RULE_CONTENT;
+        const result = readPersonalLayer(MOCK_PB_DIR);
+        expect(result).toHaveLength(2);
+        for (const rule of result) {
+            expect(rule.persist).toBe('local');
+        }
+    });
+    it('parses frontmatter fields correctly from personal rules', () => {
+        vfs[makeRulePath('personal-git-rule')] = RULE_WITH_FRONTMATTER;
+        const result = readPersonalLayer(MOCK_PB_DIR);
+        expect(result).toHaveLength(1);
+        const rule = result[0];
+        expect(rule.name).toBe('personal-git-rule');
+        expect(rule.description).toBe('Personal git workflow preferences');
+        expect(rule.autoApply).toBe(true);
+        expect(rule.body.trim()).toBe('Always sign commits.');
+        expect(rule.persist).toBe('local');
+    });
+    it('returns rules sorted by name', () => {
+        vfs[makeRulePath('zzz-rule')] = `---\nname: zzz-rule\ndescription: Z\nautoApply: false\n---\nbody`;
+        vfs[makeRulePath('aaa-rule')] = `---\nname: aaa-rule\ndescription: A\nautoApply: false\n---\nbody`;
+        const result = readPersonalLayer(MOCK_PB_DIR);
+        expect(result[0].name).toBe('aaa-rule');
+        expect(result[1].name).toBe('zzz-rule');
+    });
+});
+describe('name collision detection (personal overrides team)', () => {
+    it('personal rule name collides with team rule name — personal rule is present in merged array', () => {
+        // Simulate the merge logic from handshake.ts
+        const teamRules = [
+            { name: 'shared-rule', description: 'Team version', autoApply: false, body: 'team body', sourcePath: '/team/shared-rule.md' },
+        ];
+        const personalRules = [
+            { name: 'shared-rule', description: 'Personal version', autoApply: true, body: 'personal body', sourcePath: '/local/shared-rule.md', persist: 'local' },
+        ];
+        // Detect collision (same logic as handshake.ts)
+        const teamRuleNames = new Set(teamRules.map((r) => r.name));
+        const collisions = [];
+        for (const pr of personalRules) {
+            if (teamRuleNames.has(pr.name)) {
+                collisions.push(pr.name);
+            }
+        }
+        // Collision was detected
+        expect(collisions).toContain('shared-rule');
+        // Merged array contains both (personal appended after team)
+        const merged = [...teamRules, ...personalRules];
+        expect(merged).toHaveLength(2);
+        const personalEntry = merged.find((r) => r.persist === 'local');
+        expect(personalEntry).toBeDefined();
+        expect(personalEntry?.name).toBe('shared-rule');
+    });
+    it('no collision when personal rule has a unique name', () => {
+        const teamRules = [
+            { name: 'team-only-rule', description: 'Team', autoApply: false, body: 'body', sourcePath: '/team/rule.md' },
+        ];
+        const personalRules = [
+            { name: 'personal-only-rule', description: 'Personal', autoApply: false, body: 'body', sourcePath: '/local/rule.md', persist: 'local' },
+        ];
+        const teamRuleNames = new Set(teamRules.map((r) => r.name));
+        const collisions = [];
+        for (const pr of personalRules) {
+            if (teamRuleNames.has(pr.name)) {
+                collisions.push(pr.name);
+            }
+        }
+        expect(collisions).toHaveLength(0);
+    });
+});
+describe('shouldEmitToTarget() with persist: "local"', () => {
+    const localRule = {
+        name: 'local-rule',
+        description: 'A local-only rule',
+        autoApply: false,
+        body: 'body',
+        sourcePath: '/local/rule.md',
+        persist: 'local',
+    };
+    const teamRule = {
+        name: 'team-rule',
+        description: 'A team rule',
+        autoApply: false,
+        body: 'body',
+        sourcePath: '/team/rule.md',
+    };
+    it('local rule: emits to "claude" target (local surface file)', () => {
+        expect(shouldEmitToTarget(localRule, 'claude')).toBe(true);
+    });
+    it('local rule: emits to "cursor" target (local surface file)', () => {
+        expect(shouldEmitToTarget(localRule, 'cursor')).toBe(true);
+    });
+    it('local rule: does NOT emit to "copilot" target (committed adapter)', () => {
+        expect(shouldEmitToTarget(localRule, 'copilot')).toBe(false);
+    });
+    it('local rule: does NOT emit to "codex" target (committed adapter)', () => {
+        expect(shouldEmitToTarget(localRule, 'codex')).toBe(false);
+    });
+    it('team rule (no persist): emits to all targets normally', () => {
+        expect(shouldEmitToTarget(teamRule, 'claude')).toBe(true);
+        expect(shouldEmitToTarget(teamRule, 'cursor')).toBe(true);
+        expect(shouldEmitToTarget(teamRule, 'copilot')).toBe(true);
+        expect(shouldEmitToTarget(teamRule, 'codex')).toBe(true);
+    });
+    it('local rule with explicit targets still blocked from committed adapter targets', () => {
+        const localRuleWithTargets = {
+            ...localRule,
+            targets: ['claude', 'cursor', 'copilot'], // explicitly includes copilot
+        };
+        // persist: 'local' wins — copilot is committed adapter, must be blocked
+        expect(shouldEmitToTarget(localRuleWithTargets, 'copilot')).toBe(false);
+        expect(shouldEmitToTarget(localRuleWithTargets, 'claude')).toBe(true);
+    });
+});
+describe('readPersonalSkillsLayer()', () => {
+    const LOCAL_SKILLS_DIR = join(MOCK_PB_DIR, '.local', 'skills');
+    function makeSkillPath(name) {
+        return join(LOCAL_SKILLS_DIR, `${name}.md`);
+    }
+    const MINIMAL_SKILL_CONTENT = `---
+name: my-skill
+description: A test skill
+triggers:
+  - do the thing
+---
+
+Skill body content.
+`;
+    beforeEach(() => {
+        Object.keys(vfs).forEach((k) => delete vfs[k]);
+        vi.clearAllMocks();
+    });
+    it('returns [] when .productbrain/.local/skills/ directory is absent', () => {
+        expect(readPersonalSkillsLayer(MOCK_PB_DIR)).toEqual([]);
+    });
+    it('returns [] when skills directory exists but has no .md files', () => {
+        vfs[join(LOCAL_SKILLS_DIR, 'not-a-skill.txt')] = 'ignored';
+        expect(readPersonalSkillsLayer(MOCK_PB_DIR)).toEqual([]);
+    });
+    it('returns skills with persist: "local" from .productbrain/.local/skills/', () => {
+        vfs[makeSkillPath('my-skill')] = MINIMAL_SKILL_CONTENT;
+        const result = readPersonalSkillsLayer(MOCK_PB_DIR);
+        expect(result).toHaveLength(1);
+        expect(result[0].persist).toBe('local');
+    });
+    it('parses frontmatter fields correctly from personal skills', () => {
+        vfs[makeSkillPath('my-skill')] = MINIMAL_SKILL_CONTENT;
+        const result = readPersonalSkillsLayer(MOCK_PB_DIR);
+        const skill = result[0];
+        expect(skill.name).toBe('my-skill');
+        expect(skill.description).toBe('A test skill');
+        expect(skill.triggers).toEqual(['do the thing']);
+        expect(skill.body.trim()).toBe('Skill body content.');
+        expect(skill.persist).toBe('local');
+    });
+    it('sets persist: "local" on every returned skill regardless of content', () => {
+        vfs[makeSkillPath('skill-a')] = MINIMAL_SKILL_CONTENT;
+        vfs[makeSkillPath('skill-b')] = `---\nname: skill-b\ndescription: B\n---\nbody`;
+        const result = readPersonalSkillsLayer(MOCK_PB_DIR);
+        expect(result).toHaveLength(2);
+        for (const s of result) {
+            expect(s.persist).toBe('local');
+        }
+    });
+    it('returns skills sorted by name', () => {
+        vfs[makeSkillPath('zzz-skill')] = `---\nname: zzz-skill\ndescription: Z\n---\nbody`;
+        vfs[makeSkillPath('aaa-skill')] = `---\nname: aaa-skill\ndescription: A\n---\nbody`;
+        const result = readPersonalSkillsLayer(MOCK_PB_DIR);
+        expect(result[0].name).toBe('aaa-skill');
+        expect(result[1].name).toBe('zzz-skill');
+    });
+});
+describe('shouldEmitToTarget() with persist: "local" on CanonicalSkill', () => {
+    const localSkill = {
+        name: 'local-skill',
+        description: 'A local-only skill',
+        triggers: ['run it'],
+        body: 'body',
+        sourcePath: '/local/skill.md',
+        persist: 'local',
+    };
+    it('local skill: emits to "claude" target', () => {
+        expect(shouldEmitToTarget(localSkill, 'claude')).toBe(true);
+    });
+    it('local skill: emits to "cursor" target', () => {
+        expect(shouldEmitToTarget(localSkill, 'cursor')).toBe(true);
+    });
+    it('local skill: does NOT emit to "copilot" target (committed adapter)', () => {
+        expect(shouldEmitToTarget(localSkill, 'copilot')).toBe(false);
+    });
+    it('local skill: does NOT emit to "codex" target (committed adapter)', () => {
+        expect(shouldEmitToTarget(localSkill, 'codex')).toBe(false);
+    });
+});
+describe('isPersistLocal()', () => {
+    it('returns true for a rule with persist: "local"', () => {
+        const rule = {
+            name: 'test',
+            description: '',
+            autoApply: false,
+            body: '',
+            sourcePath: '',
+            persist: 'local',
+        };
+        expect(isPersistLocal(rule)).toBe(true);
+    });
+    it('returns false for a rule with persist: "team"', () => {
+        const rule = {
+            name: 'test',
+            description: '',
+            autoApply: false,
+            body: '',
+            sourcePath: '',
+            persist: 'team',
+        };
+        expect(isPersistLocal(rule)).toBe(false);
+    });
+    it('returns false for a rule with no persist field', () => {
+        const rule = {
+            name: 'test',
+            description: '',
+            autoApply: false,
+            body: '',
+            sourcePath: '',
+        };
+        expect(isPersistLocal(rule)).toBe(false);
+    });
+});
+//# sourceMappingURL=personal-layer.test.js.map

package/dist/__tests__/personal-layer.test.js.map

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

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

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

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

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

package/dist/__tests__/surfaces.test.js

@@ -0,0 +1,46 @@
+/**
+ * Surface Capability Registry — unit tests.
+ * WP-310 S0 (FEAT-959): typed SURFACE_REGISTRY foundation.
+ * INS-740: Cursor and Copilot must have empty hookEvents to prevent double-fire.
+ */
+import { describe, expect, it } from 'vitest';
+import { SURFACE_REGISTRY } from '../surfaces/registry.js';
+describe('SURFACE_REGISTRY', () => {
+    it('contains all four surfaces', () => {
+        const surfaces = ['claude', 'cursor', 'copilot', 'codex'];
+        for (const surface of surfaces) {
+            expect(SURFACE_REGISTRY).toHaveProperty(surface);
+        }
+    });
+    it('claude.hookFilePath is .claude/settings.json', () => {
+        expect(SURFACE_REGISTRY.claude.hookFilePath).toBe('.claude/settings.json');
+    });
+    it('claude.hookEvents has exactly 3 events (SessionStart, Stop, PreCompact)', () => {
+        expect(SURFACE_REGISTRY.claude.hookEvents).toHaveLength(3);
+        expect(SURFACE_REGISTRY.claude.hookEvents).toContain('SessionStart');
+        expect(SURFACE_REGISTRY.claude.hookEvents).toContain('Stop');
+        expect(SURFACE_REGISTRY.claude.hookEvents).toContain('PreCompact');
+    });
+    it('cursor.hookEvents is empty (INS-740 double-fire safety)', () => {
+        expect(SURFACE_REGISTRY.cursor.hookEvents).toHaveLength(0);
+    });
+    it('copilot.hookEvents is empty (INS-740 double-fire safety)', () => {
+        expect(SURFACE_REGISTRY.copilot.hookEvents).toHaveLength(0);
+    });
+    it('codex.supportsAgentsMd is true', () => {
+        expect(SURFACE_REGISTRY.codex.supportsAgentsMd).toBe(true);
+    });
+    it('claude.supportsAgentsMd is false', () => {
+        expect(SURFACE_REGISTRY.claude.supportsAgentsMd).toBe(false);
+    });
+    it('claude.personalConfigMechanism is settings_json', () => {
+        expect(SURFACE_REGISTRY.claude.personalConfigMechanism).toBe('settings_json');
+    });
+    it('cursor.rulesFormat is mdc', () => {
+        expect(SURFACE_REGISTRY.cursor.rulesFormat).toBe('mdc');
+    });
+    it('copilot.skillsFormat is none', () => {
+        expect(SURFACE_REGISTRY.copilot.skillsFormat).toBe('none');
+    });
+});
+//# sourceMappingURL=surfaces.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"surfaces.test.js","sourceRoot":"","sources":["../../src/__tests__/surfaces.test.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAG3D,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;IAChC,EAAE,CAAC,4BAA4B,EAAE,GAAG,EAAE;QACpC,MAAM,QAAQ,GAAkB,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;QACzE,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,MAAM,CAAC,gBAAgB,CAAC,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;QACnD,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8CAA8C,EAAE,GAAG,EAAE;QACtD,MAAM,CAAC,gBAAgB,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;IAC7E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yEAAyE,EAAE,GAAG,EAAE;QACjF,MAAM,CAAC,gBAAgB,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAC3D,MAAM,CAAC,gBAAgB,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;QACrE,MAAM,CAAC,gBAAgB,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QAC7D,MAAM,CAAC,gBAAgB,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;IACrE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yDAAyD,EAAE,GAAG,EAAE;QACjE,MAAM,CAAC,gBAAgB,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAC7D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0DAA0D,EAAE,GAAG,EAAE;QAClE,MAAM,CAAC,gBAAgB,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAC9D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;QACxC,MAAM,CAAC,gBAAgB,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC7D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;QAC1C,MAAM,CAAC,gBAAgB,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC/D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iDAAiD,EAAE,GAAG,EAAE;QACzD,MAAM,CAAC,gBAAgB,CAAC,MAAM,CAAC,uBAAuB,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IAChF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2BAA2B,EAAE,GAAG,EAAE;QACnC,MAAM,CAAC,gBAAgB,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC1D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8BAA8B,EAAE,GAAG,EAAE;QACtC,MAAM,CAAC,gBAAgB,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC7D,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/commands/handshake.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"handshake.d.ts","sourceRoot":"","sources":["../../src/commands/handshake.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAsMH,wBAAsB,gBAAgB,CAAC,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAiGxG;AACD,UAAU,gBAAgB;IACxB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4FAA4F;IAC5F,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,oFAAoF;IACpF,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,qEAAqE;IACrE,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED;;;;GAIG;AACH,wBAAgB,sCAAsC,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAO9E;AAsBD,wBAAsB,YAAY,CAAC,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CAgYhF"}
+{"version":3,"file":"handshake.d.ts","sourceRoot":"","sources":["../../src/commands/handshake.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAqLH,wBAAsB,gBAAgB,CAAC,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CA2HxG;AACD,UAAU,gBAAgB;IACxB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4FAA4F;IAC5F,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,oFAAoF;IACpF,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,qEAAqE;IACrE,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED;;;;GAIG;AACH,wBAAgB,sCAAsC,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAO9E;AAsBD,wBAAsB,YAAY,CAAC,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CAubhF"}

package/dist/commands/handshake.js

@@ -8,16 +8,19 @@ import { homedir } from 'os';
 import { fileURLToPath } from 'url';
 import { getConfigOrGuide } from '../lib/config.js';
 import { select as promptSelect } from '../lib/prompts.js';
+import { composeHooksFromIntents, getHookStatusForSurface } from '../lib/hook-intents.js';
 import { kernelCall } from '../lib/client.js';
 import { detectRepo, extractWorkspaceProfile } from '../lib/repo-detect.js';
 import { generateContextMd } from '../generators/context-md.js';
 import { generateBriefingMd } from '../generators/briefing-md.js';
 import { MARKER, generateAgentsMd, generateClaudeMd, generateCursorMdc, generateCopilotMd } from '../generators/adapters.js';
-import { readCanonicalSkills, readCanonicalRules, generateCursorSkill, generateCursorRule, generateCodexSkill, generateCodexSkillIndex, generateClaudeRule, generateClaudeSkillRouter, shouldEmitToTarget, filterByLevel, validateCodexSkills, evaluateConditions, STAGE_TO_MAX_LEVEL, LEVEL_ORDER, } from '../generators/portable-knowledge.js';
+import { readCanonicalSkills, readCanonicalRules, readPersonalLayer, readPersonalSkillsLayer, generateCursorSkill, generateCursorRule, generateCodexSkill, generateCodexSkillIndex, generateClaudeRule, generateClaudeSkillRouter, shouldEmitToTarget, filterByLevel, validateCodexSkills, evaluateConditions, STAGE_TO_MAX_LEVEL, LEVEL_ORDER, } from '../generators/portable-knowledge.js';
 import { generateChainRules } from '../generators/chain-rules.js';
 import { saveHandshakeState, loadPreviousState, diffHandshakeState, formatDiff, buildCurrentState, } from '../generators/handshake-diff.js';
 import { resolveSurfaceProfile } from '../generators/surface-profiles.js';
 import { formatHandshakeReport } from '../formatters/handshake.js';
+import { readManifest, filterByAdoptionState } from '../generators/manifest.js';
+import { loadMethodRegistry } from '../lib/method-registry.js';
 import { CLIError, ErrorCode } from '../lib/errors.js';
 const LEVELS = {
     guide: {
@@ -50,9 +53,6 @@ const LEVEL_KEYS = ['guide', 'work', 'silent', 'full-trust'];
 // Hook failure contract (TEN-712): all hook commands MUST end with '2>/dev/null || true'
 // so Claude Code always starts even if pb is unavailable. Never remove this suffix.
 const INIT_PERMISSION = 'Bash(pb:*)';
-const INIT_SESSION_START_CMD = 'pb session start 2>/dev/null || true';
-const INIT_SESSION_CLOSE_CMD = 'pb session close 2>/dev/null || true';
-const INIT_PRECOMPACT_CMD = 'pb session id > /dev/null 2>&1 && echo \'{"systemMessage": "pb session active — capture decisions/tensions before compacting: pb capture \\"DEC: ...\\""}\'  || true';
 function readSettings(filePath) {
     if (!existsSync(filePath))
         return {};
@@ -64,9 +64,6 @@ function readSettings(filePath) {
         return {};
     }
 }
-function hasCommand(groups, cmd) {
-    return (groups ?? []).some((g) => g.hooks?.some((h) => h.command === cmd));
-}
 // Team write: hooks + Bash(pb:*) → .claude/settings.json (safe to commit)
 function writeTeamSettings(cwd, dryRun) {
     const claudeDir = join(cwd, '.claude');
@@ -82,26 +79,10 @@ function writeTeamSettings(cwd, dryRun) {
     }
     settings.permissions = permissions;
     const hooks = (settings.hooks ?? {});
-    if (!hasCommand(hooks.SessionStart, INIT_SESSION_START_CMD)) {
-        hooks.SessionStart = [
-            ...(hooks.SessionStart ?? []),
-            { hooks: [{ type: 'command', command: INIT_SESSION_START_CMD, statusMessage: 'Opening pb session...' }] },
-        ];
-        added.push('SessionStart → pb session start');
-    }
-    if (!hasCommand(hooks.Stop, INIT_SESSION_CLOSE_CMD)) {
-        hooks.Stop = [
-            ...(hooks.Stop ?? []),
-            { hooks: [{ type: 'command', command: INIT_SESSION_CLOSE_CMD, statusMessage: 'Closing pb session...' }] },
-        ];
-        added.push('Stop → pb session close');
-    }
-    if (!hasCommand(hooks.PreCompact, INIT_PRECOMPACT_CMD)) {
-        hooks.PreCompact = [
-            ...(hooks.PreCompact ?? []),
-            { hooks: [{ type: 'command', command: INIT_PRECOMPACT_CMD }] },
-        ];
-        added.push('PreCompact → decision capture reminder');
+    const hookAdditions = composeHooksFromIntents(['session-start', 'session-close', 'pre-compact'], hooks);
+    for (const addition of hookAdditions) {
+        hooks[addition.event] = [...(hooks[addition.event] ?? []), addition.entry];
+        added.push(addition.label);
     }
     settings.hooks = hooks;
     if (!dryRun) {
@@ -194,6 +175,31 @@ export async function runHandshakeInit(options = {}) {
     if (!dryRun)
         console.log('Reload /hooks in Claude Code (or restart) to activate.');
     console.log('Run `pb handshake --init --level <guide|work|silent|full-trust>` to change level.');
+    // Step 2b: Report multi-surface hook opt-in status (WP-310 E3b)
+    // Reads manifest.hooks.{cursor,copilot} and prints an informational note for
+    // each opted-in surface. Silence = no manifest or no hooks flags set.
+    // DEC-536: Claude-native default is already wired above; this block only fires
+    // when the user has explicitly opted in via manifest.
+    const pbDirForManifest = join(cwd, '.productbrain');
+    const initManifest = readManifest(pbDirForManifest);
+    const multiSurfaceOptIns = [];
+    if (initManifest?.hooks?.cursor)
+        multiSurfaceOptIns.push('cursor');
+    if (initManifest?.hooks?.copilot)
+        multiSurfaceOptIns.push('copilot');
+    if (multiSurfaceOptIns.length > 0) {
+        console.log('');
+        for (const surface of multiSurfaceOptIns) {
+            const status = getHookStatusForSurface(surface);
+            if (status.writable) {
+                // Future-proofing path: surface has hook events, would write files.
+                console.log(`ℹ ${surface} hooks: opted in — hooks will be written`);
+            }
+            else {
+                console.log(`ℹ ${surface} hooks: opted in — no auto-hooks (${surface} has no session events; run \`pb session start\` manually)`);
+            }
+        }
+    }
     // Step 3: Scaffold starter templates if .productbrain/rules/ is empty
     const rulesDir = join(cwd, '.productbrain', 'rules');
     const hasExistingRules = existsSync(rulesDir) && readdirSync(rulesDir).filter((f) => f.endsWith('.md')).length > 0;
@@ -382,12 +388,54 @@ export async function runHandshake(options = {}) {
             log(diffText);
         }
     }
-    // Apply level filtering with stage-gating (after read, before target filtering in write loop)
+    // 5b. Read personal layer (WP-310 E2) — machine-local rules/skills from .productbrain/.local/
+    // Returns [] when the directory is absent. All returned entries have persist: 'local'.
+    const personalRules = readPersonalLayer(pbDir);
+    if (personalRules.length > 0) {
+        // Name collision detection — warn when a personal rule overrides a team rule
+        const teamRuleNames = new Set(allRules.map((r) => r.name));
+        for (const pr of personalRules) {
+            if (teamRuleNames.has(pr.name)) {
+                logErr(`Personal rule "${pr.name}" overrides team rule (local takes precedence).`);
+            }
+        }
+        // Merge: team rules first, personal rules appended (personal takes precedence via name collision above)
+        allRules = [...allRules, ...personalRules];
+    }
+    const personalSkills = readPersonalSkillsLayer(pbDir);
+    if (personalSkills.length > 0) {
+        const teamSkillNames = new Set(allSkills.map((s) => s.name));
+        for (const ps of personalSkills) {
+            if (teamSkillNames.has(ps.name)) {
+                logErr(`Personal skill "${ps.name}" overrides team skill (local takes precedence).`);
+            }
+        }
+        allSkills.push(...personalSkills);
+    }
+    // 5c. Apply manifest-based adoption filter (WP-310 E1)
+    // readManifest returns null when manifest.yaml is absent → filterByAdoptionState is a no-op.
+    const manifest = readManifest(pbDir);
+    // 5d. Load method registry (WP-310 E4) — only when manifest is present.
+    let registrySource;
+    let registryStale;
+    if (manifest) {
+        const registryResult = await loadMethodRegistry(manifest.method_source, kernelCall).catch(() => null);
+        if (registryResult) {
+            registrySource = registryResult.source;
+            registryStale = registryResult.stale;
+        }
+    }
+    const adoptionFilteredSkills = filterByAdoptionState(allSkills, manifest);
+    const adoptionFilteredRules = filterByAdoptionState(allRules, manifest);
+    // Compute adoption counts for report (only meaningful when manifest is present)
+    const adoptedRulesCount = manifest ? adoptionFilteredRules.length : undefined;
+    const rejectedRulesCount = manifest ? allRules.length - adoptionFilteredRules.length : undefined;
+    // Apply level filtering with stage-gating (after adoption filter, before target filtering in write loop)
     // Stage caps the effective level: blank→beginner, seed→intermediate, grounded+→expert.
     // If stage caps below the requested level, log it so the user knows why items were dropped.
     const profileStage = workspaceProfile?.stage;
-    const levelFilteredSkills = filterByLevel(allSkills, level, profileStage);
-    const levelFilteredRules = filterByLevel(allRules, level, profileStage);
+    const levelFilteredSkills = filterByLevel(adoptionFilteredSkills, level, profileStage);
+    const levelFilteredRules = filterByLevel(adoptionFilteredRules, level, profileStage);
     // Log when stage gating changes the effective level
     if (profileStage) {
         const stageCap = STAGE_TO_MAX_LEVEL[profileStage];
@@ -439,6 +487,7 @@ export async function runHandshake(options = {}) {
         }
         : undefined;
     // Collect codex-targeted skills for AGENTS.md skill directory
+    // Exclude persist: 'local' rules — committed adapter files must never include local-only rules.
     const agentsCodexSkills = canonicalSkills
         .filter((s) => shouldEmitToTarget(s, 'codex'))
         .map((s) => ({
@@ -608,6 +657,12 @@ export async function runHandshake(options = {}) {
         codexWarnings: codexWarnings.length > 0 ? codexWarnings : undefined,
         chainRulesStats: chainRulesStats ?? undefined,
         chainGaps: chainGaps.length > 0 ? chainGaps : undefined,
+        adoptedCount: adoptedRulesCount,
+        rejectedCount: rejectedRulesCount,
+        personalRuleCount: personalRules.length > 0 ? personalRules.length : undefined,
+        personalSkillCount: personalSkills.length > 0 ? personalSkills.length : undefined,
+        registrySource,
+        registryStale,
     };
     if (!quiet) {
         process.stdout.write('\n');