beth-copilot 1.0.18 → 2.0.0

package/dist/__tests__/inject-skills.test.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Unit tests for .github/hooks/scripts/inject-skills.mjs
+ *
+ * Tests the SubagentStart hook that deterministically injects skill context
+ * for each agent type. Verifies correct skill mapping, output format,
+ * and graceful handling of edge cases.
+ */
+export {};
+//# sourceMappingURL=inject-skills.test.d.ts.map

package/dist/__tests__/inject-skills.test.d.ts.map

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

package/dist/__tests__/inject-skills.test.js

@@ -0,0 +1,143 @@
+/**
+ * Unit tests for .github/hooks/scripts/inject-skills.mjs
+ *
+ * Tests the SubagentStart hook that deterministically injects skill context
+ * for each agent type. Verifies correct skill mapping, output format,
+ * and graceful handling of edge cases.
+ */
+import { describe, it, expect } from 'vitest';
+import { execFileSync } from 'node:child_process';
+import { join } from 'node:path';
+const SCRIPT_PATH = join(process.cwd(), '.github/hooks/scripts/inject-skills.mjs');
+const PROJECT_ROOT = process.cwd();
+/** Helper: pipe JSON input to inject-skills.mjs and parse the JSON output */
+function runHook(input) {
+    const result = execFileSync('node', [SCRIPT_PATH], {
+        input: JSON.stringify(input),
+        encoding: 'utf8',
+        cwd: PROJECT_ROOT,
+        timeout: 10000,
+    });
+    return JSON.parse(result);
+}
+/** Helper: extract additionalContext string from hook output */
+function getContext(input) {
+    const output = runHook(input);
+    return output.hookSpecificOutput?.additionalContext ?? '';
+}
+// ─── Core behavior ─────────────────────────────────────────────────────────
+describe('inject-skills.mjs: output structure', () => {
+    it('should always set continue: true', () => {
+        const output = runHook({ agent_type: 'developer', cwd: PROJECT_ROOT });
+        expect(output.continue).toBe(true);
+    });
+    it('should include hookSpecificOutput with SubagentStart event name', () => {
+        const output = runHook({ agent_type: 'developer', cwd: PROJECT_ROOT });
+        expect(output.hookSpecificOutput).toBeDefined();
+        expect(output.hookSpecificOutput.hookEventName).toBe('SubagentStart');
+    });
+});
+// ─── UX Designer (includes ui-ux-pro-max) ──────────────────────────────────
+describe('inject-skills.mjs: ux-designer', () => {
+    const ctx = () => getContext({ agent_type: 'ux-designer', cwd: PROJECT_ROOT });
+    it('should inject web-design-guidelines into context', () => {
+        expect(ctx()).toContain('.github/skills/web-design-guidelines/SKILL.md');
+        expect(ctx()).toContain('Skills loaded into context');
+    });
+    it('should mandate readFile for framer-components', () => {
+        expect(ctx()).toContain('.github/skills/framer-components/SKILL.md');
+        expect(ctx()).toContain('Skills to load via readFile');
+    });
+    it('should mandate readFile for ui-ux-pro-max', () => {
+        expect(ctx()).toContain('.github/prompts/ui-ux-pro-max/PROMPT.md');
+    });
+    it('should include the NON-NEGOTIABLE header', () => {
+        expect(ctx()).toContain('SKILL ENFORCEMENT');
+        expect(ctx()).toContain('NON-NEGOTIABLE');
+    });
+    it('should identify the agent type in the context', () => {
+        expect(ctx()).toContain('You are `ux-designer`');
+    });
+});
+// ─── Developer ─────────────────────────────────────────────────────────────
+describe('inject-skills.mjs: developer', () => {
+    const ctx = () => getContext({ agent_type: 'developer', cwd: PROJECT_ROOT });
+    it('should inject vercel-react-best-practices SKILL.md into context', () => {
+        expect(ctx()).toContain('.github/skills/vercel-react-best-practices/SKILL.md');
+        expect(ctx()).toContain('Skills loaded into context');
+    });
+    it('should mandate readFile for shadcn-ui', () => {
+        expect(ctx()).toContain('.github/skills/shadcn-ui/SKILL.md');
+    });
+    it('should mandate readFile for vercel-react-best-practices AGENTS.md', () => {
+        expect(ctx()).toContain('.github/skills/vercel-react-best-practices/AGENTS.md');
+    });
+});
+// ─── Product Manager ───────────────────────────────────────────────────────
+describe('inject-skills.mjs: product-manager', () => {
+    const ctx = () => getContext({ agent_type: 'product-manager', cwd: PROJECT_ROOT });
+    it('should mandate readFile for prd skill', () => {
+        expect(ctx()).toContain('.github/skills/prd/SKILL.md');
+    });
+    it('should NOT have "Skills loaded into context" (no inject files)', () => {
+        expect(ctx()).not.toContain('Skills loaded into context');
+    });
+});
+// ─── Security Reviewer ─────────────────────────────────────────────────────
+describe('inject-skills.mjs: security-reviewer', () => {
+    const ctx = () => getContext({ agent_type: 'security-reviewer', cwd: PROJECT_ROOT });
+    it('should mandate readFile for security-analysis', () => {
+        expect(ctx()).toContain('.github/skills/security-analysis/SKILL.md');
+    });
+});
+// ─── Tester ────────────────────────────────────────────────────────────────
+describe('inject-skills.mjs: tester', () => {
+    const ctx = () => getContext({ agent_type: 'tester', cwd: PROJECT_ROOT });
+    it('should inject web-design-guidelines into context', () => {
+        expect(ctx()).toContain('.github/skills/web-design-guidelines/SKILL.md');
+        expect(ctx()).toContain('Skills loaded into context');
+    });
+    it('should NOT have readFile mandate (no readFile files)', () => {
+        expect(ctx()).not.toContain('Skills to load via readFile');
+    });
+});
+// ─── Researcher ────────────────────────────────────────────────────────────
+describe('inject-skills.mjs: researcher', () => {
+    const ctx = () => getContext({ agent_type: 'researcher', cwd: PROJECT_ROOT });
+    it('should inject web-search skill into context', () => {
+        expect(ctx()).toContain('.github/skills/web-search/SKILL.md');
+    });
+});
+// ─── Edge cases ────────────────────────────────────────────────────────────
+describe('inject-skills.mjs: edge cases', () => {
+    it('should pass through unknown agent types with continue: true', () => {
+        const output = runHook({ agent_type: 'unknown-agent', cwd: PROJECT_ROOT });
+        expect(output.continue).toBe(true);
+        expect(output).not.toHaveProperty('hookSpecificOutput');
+    });
+    it('should handle missing agent_type gracefully', () => {
+        const output = runHook({ cwd: PROJECT_ROOT });
+        expect(output.continue).toBe(true);
+    });
+    it('should handle malformed JSON input gracefully', () => {
+        const result = execFileSync('node', [SCRIPT_PATH], {
+            input: 'not json at all',
+            encoding: 'utf8',
+            cwd: PROJECT_ROOT,
+            timeout: 10000,
+        });
+        const output = JSON.parse(result);
+        expect(output.continue).toBe(true);
+    });
+    it('should handle empty input gracefully', () => {
+        const result = execFileSync('node', [SCRIPT_PATH], {
+            input: '',
+            encoding: 'utf8',
+            cwd: PROJECT_ROOT,
+            timeout: 10000,
+        });
+        const output = JSON.parse(result);
+        expect(output.continue).toBe(true);
+    });
+});
+//# sourceMappingURL=inject-skills.test.js.map

package/dist/__tests__/inject-skills.test.js.map

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

package/dist/__tests__/skills/disambiguation.test.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Disambiguation Tests — Known Challenge Pairs
+ *
+ * These skill pairs share semantic space and can be confused by LLM inference.
+ * Tests verify structural differences that SHOULD enable correct disambiguation.
+ *
+ * Test plan reference: docs/E2E-SKILL-TESTS.md — Known Disambiguation Challenges
+ */
+export {};
+//# sourceMappingURL=disambiguation.test.d.ts.map

package/dist/__tests__/skills/disambiguation.test.d.ts.map

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

package/dist/__tests__/skills/disambiguation.test.js

@@ -0,0 +1,192 @@
+/**
+ * Disambiguation Tests — Known Challenge Pairs
+ *
+ * These skill pairs share semantic space and can be confused by LLM inference.
+ * Tests verify structural differences that SHOULD enable correct disambiguation.
+ *
+ * Test plan reference: docs/E2E-SKILL-TESTS.md — Known Disambiguation Challenges
+ */
+import { describe, it, expect } from 'vitest';
+import { join } from 'node:path';
+import { readFileSync, existsSync } from 'node:fs';
+const PROJECT_ROOT = process.cwd();
+const SKILLS_DIR = join(PROJECT_ROOT, '.github/skills');
+/** Read a skill's SKILL.md content */
+function readSkill(skillName) {
+    const path = join(SKILLS_DIR, skillName, 'SKILL.md');
+    return readFileSync(path, 'utf8');
+}
+/** Check if a skill directory exists */
+function skillDirExists(skillName) {
+    return existsSync(join(SKILLS_DIR, skillName));
+}
+// ─── Pair 1: brainstorming vs ce:brainstorm ────────────────────────────────
+describe('Disambiguation: brainstorming vs ce:brainstorm', () => {
+    it('both skills exist', () => {
+        expect(skillDirExists('brainstorming')).toBe(true);
+        expect(skillDirExists('ce:brainstorm')).toBe(true);
+    });
+    it('brainstorming is freeform — triggers on natural language', () => {
+        const content = readSkill('brainstorming');
+        // Should trigger on conversational phrases, not slash commands
+        expect(content).toMatch(/brainstorm|think through|explore/i);
+    });
+    it('ce:brainstorm is a slash command workflow', () => {
+        const content = readSkill('ce:brainstorm');
+        // Should reference the /ce: prefix or pipeline structure
+        expect(content).toMatch(/ce:brainstorm|slash|workflow|pipeline/i);
+    });
+    it('they are distinct files with different content', () => {
+        const freeform = readSkill('brainstorming');
+        const slashCmd = readSkill('ce:brainstorm');
+        expect(freeform).not.toBe(slashCmd);
+    });
+});
+// ─── Pair 2: compound-docs vs ce:compound ──────────────────────────────────
+describe('Disambiguation: compound-docs vs ce:compound', () => {
+    it('both skills exist', () => {
+        expect(skillDirExists('compound-docs')).toBe(true);
+        expect(skillDirExists('ce:compound')).toBe(true);
+    });
+    it('compound-docs auto-detects from success phrases', () => {
+        const content = readSkill('compound-docs');
+        // Should trigger on natural completion phrases
+        expect(content).toMatch(/document|solution|worked|knowledge/i);
+    });
+    it('ce:compound is a slash command workflow', () => {
+        const content = readSkill('ce:compound');
+        expect(content).toMatch(/ce:compound|slash|workflow|compound/i);
+    });
+    it('they are distinct files with different content', () => {
+        const autoDocs = readSkill('compound-docs');
+        const slashCmd = readSkill('ce:compound');
+        expect(autoDocs).not.toBe(slashCmd);
+    });
+});
+// ─── Pair 3: ce:plan vs deepen-plan ────────────────────────────────────────
+describe('Disambiguation: ce:plan vs deepen-plan', () => {
+    it('both skills exist', () => {
+        expect(skillDirExists('ce:plan')).toBe(true);
+        expect(skillDirExists('deepen-plan')).toBe(true);
+    });
+    it('ce:plan creates plans from scratch', () => {
+        const content = readSkill('ce:plan');
+        // Should focus on creation/transformation
+        expect(content).toMatch(/plan|transform|create|structure/i);
+    });
+    it('deepen-plan enriches existing plans', () => {
+        const content = readSkill('deepen-plan');
+        // Should focus on enhancement/enrichment
+        expect(content).toMatch(/enhance|deepen|research|depth|enrich/i);
+    });
+    it('they are distinct files with different content', () => {
+        const create = readSkill('ce:plan');
+        const deepen = readSkill('deepen-plan');
+        expect(create).not.toBe(deepen);
+    });
+});
+// ─── Pair 4: ce:review vs document-review ──────────────────────────────────
+describe('Disambiguation: ce:review vs document-review', () => {
+    it('both skills exist', () => {
+        expect(skillDirExists('ce:review')).toBe(true);
+        expect(skillDirExists('document-review')).toBe(true);
+    });
+    it('ce:review focuses on code review', () => {
+        const content = readSkill('ce:review');
+        expect(content).toMatch(/code|review|multi-agent|analysis/i);
+    });
+    it('document-review focuses on markdown/document review', () => {
+        const content = readSkill('document-review');
+        expect(content).toMatch(/document|brainstorm|plan|refine/i);
+    });
+    it('they are distinct files with different content', () => {
+        const codeReview = readSkill('ce:review');
+        const docReview = readSkill('document-review');
+        expect(codeReview).not.toBe(docReview);
+    });
+});
+// ─── Pair 5: resolve_parallel vs resolve_todo_parallel vs resolve-pr-parallel
+describe('Disambiguation: resolve_parallel vs resolve_todo_parallel vs resolve-pr-parallel', () => {
+    it('all three skills exist', () => {
+        expect(skillDirExists('resolve_parallel')).toBe(true);
+        expect(skillDirExists('resolve_todo_parallel')).toBe(true);
+        expect(skillDirExists('resolve-pr-parallel')).toBe(true);
+    });
+    it('resolve_parallel targets code TODOs', () => {
+        const content = readSkill('resolve_parallel');
+        expect(content).toMatch(/TODO|FIXME|code|codebase/i);
+    });
+    it('resolve_todo_parallel targets CLI todos', () => {
+        const content = readSkill('resolve_todo_parallel');
+        expect(content).toMatch(/todo|pending|CLI|list/i);
+    });
+    it('resolve-pr-parallel targets PR review comments', () => {
+        const content = readSkill('resolve-pr-parallel');
+        expect(content).toMatch(/PR|pull request|review|comment/i);
+    });
+    it('all three are distinct files', () => {
+        const code = readSkill('resolve_parallel');
+        const todo = readSkill('resolve_todo_parallel');
+        const pr = readSkill('resolve-pr-parallel');
+        expect(code).not.toBe(todo);
+        expect(code).not.toBe(pr);
+        expect(todo).not.toBe(pr);
+    });
+});
+// ─── Pair 6: lfg vs slfg ──────────────────────────────────────────────────
+describe('Disambiguation: lfg vs slfg', () => {
+    it('both skills exist', () => {
+        expect(skillDirExists('lfg')).toBe(true);
+        expect(skillDirExists('slfg')).toBe(true);
+    });
+    it('lfg is sequential execution', () => {
+        const content = readSkill('lfg');
+        expect(content).toMatch(/sequential|execute|work plan|step/i);
+    });
+    it('slfg is swarm/parallel execution', () => {
+        const content = readSkill('slfg');
+        expect(content).toMatch(/swarm|parallel|concurrent/i);
+    });
+    it('they are distinct files with different content', () => {
+        const sequential = readSkill('lfg');
+        const parallel = readSkill('slfg');
+        expect(sequential).not.toBe(parallel);
+    });
+});
+// ─── Cross-pair integrity ──────────────────────────────────────────────────
+describe('Disambiguation: cross-pair structural integrity', () => {
+    const ALL_DISAMBIGUATION_SKILLS = [
+        'brainstorming', 'ce:brainstorm',
+        'compound-docs', 'ce:compound',
+        'ce:plan', 'deepen-plan',
+        'ce:review', 'document-review',
+        'resolve_parallel', 'resolve_todo_parallel', 'resolve-pr-parallel',
+        'lfg', 'slfg',
+    ];
+    it('none of the disambiguation skills are missing', () => {
+        for (const skill of ALL_DISAMBIGUATION_SKILLS) {
+            expect(skillDirExists(skill)).toBe(true);
+        }
+    });
+    it('all disambiguation skill files are non-empty', () => {
+        for (const skill of ALL_DISAMBIGUATION_SKILLS) {
+            const content = readSkill(skill);
+            expect(content.length).toBeGreaterThan(0);
+        }
+    });
+    it('no two skills in any pair have identical content', () => {
+        const pairs = [
+            ['brainstorming', 'ce:brainstorm'],
+            ['compound-docs', 'ce:compound'],
+            ['ce:plan', 'deepen-plan'],
+            ['ce:review', 'document-review'],
+            ['lfg', 'slfg'],
+        ];
+        for (const [a, b] of pairs) {
+            const contentA = readSkill(a);
+            const contentB = readSkill(b);
+            expect(contentA).not.toBe(contentB);
+        }
+    });
+});
+//# sourceMappingURL=disambiguation.test.js.map

package/dist/__tests__/skills/disambiguation.test.js.map

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

package/dist/__tests__/skills/hook-injection.test.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Category 1: Hook-Enforced Mandatory Skills (deterministic injection tests)
+ *
+ * These skills are deterministically injected by inject-skills.mjs.
+ * No prompt inference needed — the hook fires on agent_type alone.
+ * Tests verify hook output, not LLM behavior.
+ *
+ * Test plan reference: docs/E2E-SKILL-TESTS.md — Category 1 (tests 1–9)
+ */
+export {};
+//# sourceMappingURL=hook-injection.test.d.ts.map

package/dist/__tests__/skills/hook-injection.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-injection.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/skills/hook-injection.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/dist/__tests__/skills/hook-injection.test.js

@@ -0,0 +1,173 @@
+/**
+ * Category 1: Hook-Enforced Mandatory Skills (deterministic injection tests)
+ *
+ * These skills are deterministically injected by inject-skills.mjs.
+ * No prompt inference needed — the hook fires on agent_type alone.
+ * Tests verify hook output, not LLM behavior.
+ *
+ * Test plan reference: docs/E2E-SKILL-TESTS.md — Category 1 (tests 1–9)
+ */
+import { describe, it, expect } from 'vitest';
+import { execFileSync } from 'node:child_process';
+import { join } from 'node:path';
+import { existsSync } from 'node:fs';
+const SCRIPT_PATH = join(process.cwd(), '.github/hooks/scripts/inject-skills.mjs');
+const PROJECT_ROOT = process.cwd();
+/** Helper: pipe JSON input to inject-skills.mjs and parse the JSON output */
+function runHook(input) {
+    const result = execFileSync('node', [SCRIPT_PATH], {
+        input: JSON.stringify(input),
+        encoding: 'utf8',
+        cwd: PROJECT_ROOT,
+        timeout: 10000,
+    });
+    return JSON.parse(result);
+}
+/** Helper: extract additionalContext string from hook output */
+function getContext(agentType) {
+    const output = runHook({ agent_type: agentType, cwd: PROJECT_ROOT });
+    return output.hookSpecificOutput?.additionalContext ?? '';
+}
+const HOOK_TEST_MATRIX = [
+    {
+        id: 1,
+        skill: 'web-design-guidelines',
+        skillPath: '.github/skills/web-design-guidelines/SKILL.md',
+        agent: 'ux-designer',
+        enforcement: 'inject',
+        testPrompt: 'Review the login page for accessibility compliance',
+    },
+    {
+        id: 2,
+        skill: 'framer-components',
+        skillPath: '.github/skills/framer-components/SKILL.md',
+        agent: 'ux-designer',
+        enforcement: 'readFile',
+        testPrompt: 'Create a Framer component with property controls for a card',
+    },
+    {
+        id: 3,
+        skill: 'ui-ux-pro-max',
+        skillPath: '.github/prompts/ui-ux-pro-max/PROMPT.md',
+        agent: 'ux-designer',
+        enforcement: 'readFile',
+        testPrompt: 'Design a color palette and style guide for the dashboard',
+    },
+    {
+        id: 4,
+        skill: 'vercel-react-best-practices',
+        skillPath: '.github/skills/vercel-react-best-practices/SKILL.md',
+        agent: 'developer',
+        enforcement: 'inject',
+        testPrompt: 'Optimize the data fetching in our Next.js product page',
+    },
+    {
+        id: 5,
+        skill: 'shadcn-ui',
+        skillPath: '.github/skills/shadcn-ui/SKILL.md',
+        agent: 'developer',
+        enforcement: 'readFile',
+        testPrompt: 'Add a shadcn dialog component for the settings modal',
+    },
+    {
+        id: 6,
+        skill: 'vercel-react-best-practices/AGENTS.md',
+        skillPath: '.github/skills/vercel-react-best-practices/AGENTS.md',
+        agent: 'developer',
+        enforcement: 'readFile',
+        testPrompt: 'Refactor the server components to eliminate waterfalls',
+    },
+    {
+        id: 7,
+        skill: 'prd',
+        skillPath: '.github/skills/prd/SKILL.md',
+        agent: 'product-manager',
+        enforcement: 'readFile',
+        testPrompt: 'Create a PRD for the user notifications feature',
+    },
+    {
+        id: 8,
+        skill: 'security-analysis',
+        skillPath: '.github/skills/security-analysis/SKILL.md',
+        agent: 'security-reviewer',
+        enforcement: 'readFile',
+        testPrompt: 'Run an OWASP security review on the auth module',
+    },
+    {
+        id: 9,
+        skill: 'web-design-guidelines',
+        skillPath: '.github/skills/web-design-guidelines/SKILL.md',
+        agent: 'tester',
+        enforcement: 'inject',
+        testPrompt: 'Audit the checkout flow for WCAG 2.1 AA compliance',
+    },
+];
+// ─── Parameterized tests ───────────────────────────────────────────────────
+describe('Category 1: Hook-Enforced Mandatory Skills', () => {
+    describe.each(HOOK_TEST_MATRIX)('Test #$id: $skill → $agent ($enforcement)', ({ skillPath, agent, enforcement }) => {
+        it('skill file exists on disk', () => {
+            const fullPath = join(PROJECT_ROOT, skillPath);
+            expect(existsSync(fullPath)).toBe(true);
+        });
+        it('hook includes skill path in context', () => {
+            const ctx = getContext(agent);
+            expect(ctx).toContain(skillPath);
+        });
+        if (enforcement === 'inject') {
+            it('skill content is injected directly (not just referenced)', () => {
+                const ctx = getContext(agent);
+                expect(ctx).toContain('Skills loaded into context');
+                expect(ctx).toContain(skillPath);
+            });
+        }
+        if (enforcement === 'readFile') {
+            it('skill is listed under readFile mandate', () => {
+                const ctx = getContext(agent);
+                expect(ctx).toContain('Skills to load via readFile');
+                expect(ctx).toContain(skillPath);
+            });
+        }
+        it('context includes NON-NEGOTIABLE enforcement header', () => {
+            const ctx = getContext(agent);
+            expect(ctx).toContain('SKILL ENFORCEMENT');
+            expect(ctx).toContain('NON-NEGOTIABLE');
+        });
+        it('context identifies the correct agent type', () => {
+            const ctx = getContext(agent);
+            expect(ctx).toContain(`You are \`${agent}\``);
+        });
+    });
+    // ─── Researcher (special case — capability, not domain knowledge) ──────
+    describe('Researcher: web-search injection', () => {
+        it('injects web-search skill into researcher context', () => {
+            const ctx = getContext('researcher');
+            expect(ctx).toContain('.github/skills/web-search/SKILL.md');
+        });
+        it('researcher has no readFile mandates', () => {
+            const ctx = getContext('researcher');
+            expect(ctx).not.toContain('Skills to load via readFile');
+        });
+    });
+    // ─── Cross-agent verification ──────────────────────────────────────────
+    describe('Cross-agent isolation', () => {
+        it('developer does NOT get ux-designer skills', () => {
+            const ctx = getContext('developer');
+            expect(ctx).not.toContain('framer-components');
+            expect(ctx).not.toContain('ui-ux-pro-max');
+        });
+        it('ux-designer does NOT get developer skills', () => {
+            const ctx = getContext('ux-designer');
+            expect(ctx).not.toContain('shadcn-ui');
+            expect(ctx).not.toContain('vercel-react-best-practices/AGENTS.md');
+        });
+        it('tester does NOT get readFile mandates', () => {
+            const ctx = getContext('tester');
+            expect(ctx).not.toContain('Skills to load via readFile');
+        });
+        it('product-manager does NOT get inject skills', () => {
+            const ctx = getContext('product-manager');
+            expect(ctx).not.toContain('Skills loaded into context');
+        });
+    });
+});
+//# sourceMappingURL=hook-injection.test.js.map

package/dist/__tests__/skills/hook-injection.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-injection.test.js","sourceRoot":"","sources":["../../../src/__tests__/skills/hook-injection.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAErC,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,yCAAyC,CAAC,CAAC;AACnF,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;AAEnC,6EAA6E;AAC7E,SAAS,OAAO,CAAC,KAA8B;IAC7C,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,EAAE,CAAC,WAAW,CAAC,EAAE;QACjD,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC;QAC5B,QAAQ,EAAE,MAAM;QAChB,GAAG,EAAE,YAAY;QACjB,OAAO,EAAE,KAAK;KACf,CAAC,CAAC;IACH,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;AAC5B,CAAC;AAED,gEAAgE;AAChE,SAAS,UAAU,CAAC,SAAiB;IACnC,MAAM,MAAM,GAAG,OAAO,CAAC,EAAE,UAAU,EAAE,SAAS,EAAE,GAAG,EAAE,YAAY,EAAE,CAAQ,CAAC;IAC5E,OAAO,MAAM,CAAC,kBAAkB,EAAE,iBAAiB,IAAI,EAAE,CAAC;AAC5D,CAAC;AAaD,MAAM,gBAAgB,GAAe;IACnC;QACE,EAAE,EAAE,CAAC;QACL,KAAK,EAAE,uBAAuB;QAC9B,SAAS,EAAE,+CAA+C;QAC1D,KAAK,EAAE,aAAa;QACpB,WAAW,EAAE,QAAQ;QACrB,UAAU,EAAE,oDAAoD;KACjE;IACD;QACE,EAAE,EAAE,CAAC;QACL,KAAK,EAAE,mBAAmB;QAC1B,SAAS,EAAE,2CAA2C;QACtD,KAAK,EAAE,aAAa;QACpB,WAAW,EAAE,UAAU;QACvB,UAAU,EAAE,6DAA6D;KAC1E;IACD;QACE,EAAE,EAAE,CAAC;QACL,KAAK,EAAE,eAAe;QACtB,SAAS,EAAE,yCAAyC;QACpD,KAAK,EAAE,aAAa;QACpB,WAAW,EAAE,UAAU;QACvB,UAAU,EAAE,0DAA0D;KACvE;IACD;QACE,EAAE,EAAE,CAAC;QACL,KAAK,EAAE,6BAA6B;QACpC,SAAS,EAAE,qDAAqD;QAChE,KAAK,EAAE,WAAW;QAClB,WAAW,EAAE,QAAQ;QACrB,UAAU,EAAE,wDAAwD;KACrE;IACD;QACE,EAAE,EAAE,CAAC;QACL,KAAK,EAAE,WAAW;QAClB,SAAS,EAAE,mCAAmC;QAC9C,KAAK,EAAE,WAAW;QAClB,WAAW,EAAE,UAAU;QACvB,UAAU,EAAE,sDAAsD;KACnE;IACD;QACE,EAAE,EAAE,CAAC;QACL,KAAK,EAAE,uCAAuC;QAC9C,SAAS,EAAE,sDAAsD;QACjE,KAAK,EAAE,WAAW;QAClB,WAAW,EAAE,UAAU;QACvB,UAAU,EAAE,wDAAwD;KACrE;IACD;QACE,EAAE,EAAE,CAAC;QACL,KAAK,EAAE,KAAK;QACZ,SAAS,EAAE,6BAA6B;QACxC,KAAK,EAAE,iBAAiB;QACxB,WAAW,EAAE,UAAU;QACvB,UAAU,EAAE,iDAAiD;KAC9D;IACD;QACE,EAAE,EAAE,CAAC;QACL,KAAK,EAAE,mBAAmB;QAC1B,SAAS,EAAE,2CAA2C;QACtD,KAAK,EAAE,mBAAmB;QAC1B,WAAW,EAAE,UAAU;QACvB,UAAU,EAAE,iDAAiD;KAC9D;IACD;QACE,EAAE,EAAE,CAAC;QACL,KAAK,EAAE,uBAAuB;QAC9B,SAAS,EAAE,+CAA+C;QAC1D,KAAK,EAAE,QAAQ;QACf,WAAW,EAAE,QAAQ;QACrB,UAAU,EAAE,oDAAoD;KACjE;CACF,CAAC;AAEF,8EAA8E;AAE9E,QAAQ,CAAC,4CAA4C,EAAE,GAAG,EAAE;IAC1D,QAAQ,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAC7B,2CAA2C,EAC3C,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,WAAW,EAAE,EAAE,EAAE;QACpC,EAAE,CAAC,2BAA2B,EAAE,GAAG,EAAE;YACnC,MAAM,QAAQ,GAAG,IAAI,CAAC,YAAY,EAAE,SAAS,CAAC,CAAC;YAC/C,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1C,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;YAC7C,MAAM,GAAG,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;YAC9B,MAAM,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;QACnC,CAAC,CAAC,CAAC;QAEH,IAAI,WAAW,KAAK,QAAQ,EAAE,CAAC;YAC7B,EAAE,CAAC,0DAA0D,EAAE,GAAG,EAAE;gBAClE,MAAM,GAAG,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;gBAC9B,MAAM,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,4BAA4B,CAAC,CAAC;gBACpD,MAAM,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;YACnC,CAAC,CAAC,CAAC;QACL,CAAC;QAED,IAAI,WAAW,KAAK,UAAU,EAAE,CAAC;YAC/B,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;gBAChD,MAAM,GAAG,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;gBAC9B,MAAM,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,6BAA6B,CAAC,CAAC;gBACrD,MAAM,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;YACnC,CAAC,CAAC,CAAC;QACL,CAAC;QAED,EAAE,CAAC,oDAAoD,EAAE,GAAG,EAAE;YAC5D,MAAM,GAAG,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;YAC9B,MAAM,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,mBAAmB,CAAC,CAAC;YAC3C,MAAM,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,gBAAgB,CAAC,CAAC;QAC1C,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;YACnD,MAAM,GAAG,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;YAC9B,MAAM,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,aAAa,KAAK,IAAI,CAAC,CAAC;QAChD,CAAC,CAAC,CAAC;IACL,CAAC,CACF,CAAC;IAEF,0EAA0E;IAE1E,QAAQ,CAAC,kCAAkC,EAAE,GAAG,EAAE;QAChD,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;YAC1D,MAAM,GAAG,GAAG,UAAU,CAAC,YAAY,CAAC,CAAC;YACrC,MAAM,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,oCAAoC,CAAC,CAAC;QAC9D,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;YAC7C,MAAM,GAAG,GAAG,UAAU,CAAC,YAAY,CAAC,CAAC;YACrC,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,6BAA6B,CAAC,CAAC;QAC3D,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,0EAA0E;IAE1E,QAAQ,CAAC,uBAAuB,EAAE,GAAG,EAAE;QACrC,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;YACnD,MAAM,GAAG,GAAG,UAAU,CAAC,WAAW,CAAC,CAAC;YACpC,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,mBAAmB,CAAC,CAAC;YAC/C,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC;QAC7C,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;YACnD,MAAM,GAAG,GAAG,UAAU,CAAC,aAAa,CAAC,CAAC;YACtC,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;YACvC,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,uCAAuC,CAAC,CAAC;QACrE,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;YAC/C,MAAM,GAAG,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;YACjC,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,6BAA6B,CAAC,CAAC;QAC3D,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,4CAA4C,EAAE,GAAG,EAAE;YACpD,MAAM,GAAG,GAAG,UAAU,CAAC,iBAAiB,CAAC,CAAC;YAC1C,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,4BAA4B,CAAC,CAAC;QAC1D,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/__tests__/skills/mapping-completeness.test.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Agent-Skill Mapping Completeness Tests
+ *
+ * Verifies that the skill enforcement system is complete — no orphan skills,
+ * no missing mappings, no drift between what's on disk and what's in the hooks.
+ *
+ * What these tests catch:
+ * - New skills added to .github/skills/ but not added to the test matrix
+ * - Skills removed from disk but still referenced in inject-skills.mjs
+ * - inject-skills.mjs agent map drifting from copilot-instructions.md docs
+ * - Agent definitions (.agent.md) missing from .github/agents/
+ * - Skills with no SKILL.md file inside their directory
+ *
+ * Test plan reference: docs/E2E-SKILL-TESTS.md — "Implementation Notes"
+ */
+export {};
+//# sourceMappingURL=mapping-completeness.test.d.ts.map

package/dist/__tests__/skills/mapping-completeness.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapping-completeness.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/skills/mapping-completeness.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG"}