@skillsmith/mcp-server 0.4.13 → 0.5.0

package/dist/tests/unit/edit-suggester.test.js

@@ -0,0 +1,356 @@
+/**
+ * @fileoverview Unit tests for SMI-4589 Wave 3 — edit-suggester core (10 cases).
+ * @module @skillsmith/mcp-server/tests/unit/edit-suggester
+ *
+ * Covers the 10 cases enumerated in
+ * `docs/internal/implementation/smi-4589-edit-suggester.md` §Tests.
+ * Apply-path tests (registry rejection + apply success/stale-before)
+ * live in `edit-applier.test.ts` to keep both files under the 500-LOC
+ * pre-commit gate.
+ *
+ * Per-template gate (ratified 2026-05-01): only `add_domain_qualifier`
+ * (4.10/5) ships in v1. Cases 2-3 assert the failing templates produce
+ * NO `RecommendedEdit` from `runEditSuggester` — they're absent from
+ * Wave 3 output entirely per plan R-4/R-8.
+ */
+import { afterEach, beforeEach, describe, expect, it } from 'vitest';
+import * as fs from 'node:fs';
+import * as os from 'node:os';
+import * as path from 'node:path';
+import { runEditSuggester } from '../../src/audit/edit-suggester.js';
+import { makeAuditResult, makeEntry, makeSemanticFlag, writeSkillMd, } from './edit-suggester.fixtures.js';
+let TEST_HOME;
+let ORIGINAL_HOME;
+beforeEach(() => {
+    TEST_HOME = fs.mkdtempSync(path.join(os.tmpdir(), 'skillsmith-edit-suggester-'));
+    ORIGINAL_HOME = process.env['HOME'];
+    process.env['HOME'] = TEST_HOME;
+});
+afterEach(() => {
+    if (ORIGINAL_HOME !== undefined) {
+        process.env['HOME'] = ORIGINAL_HOME;
+    }
+    else {
+        delete process.env['HOME'];
+    }
+    if (TEST_HOME && fs.existsSync(TEST_HOME)) {
+        fs.rmSync(TEST_HOME, { recursive: true, force: true });
+    }
+});
+describe('runEditSuggester — case 1: add_domain_qualifier fires for asymmetric tags', () => {
+    it('emits a RecommendedEdit with `for <tag> tasks` injected after the trigger verb', async () => {
+        const fileA = writeSkillMd(TEST_HOME, {
+            identifier: 'release-tools',
+            description: 'Use when deploying to production. Handles release notes.',
+            tag: 'anthropic',
+        });
+        const fileB = writeSkillMd(TEST_HOME, {
+            identifier: 'release-helper',
+            description: 'Use when deploying for the release pipeline. Handles changelogs.',
+            tag: 'community',
+        });
+        const entryA = makeEntry({
+            source_path: fileA,
+            identifier: 'release-tools',
+            description: 'Use when deploying to production. Handles release notes.',
+            tag: 'anthropic',
+        });
+        const entryB = makeEntry({
+            source_path: fileB,
+            identifier: 'release-helper',
+            description: 'Use when deploying for the release pipeline. Handles changelogs.',
+            tag: 'community',
+        });
+        const result = makeAuditResult([
+            makeSemanticFlag({ collisionId: 'coll-01', entryA, entryB, cosineScore: 0.82 }),
+        ]);
+        const edits = await runEditSuggester(result);
+        expect(edits).toHaveLength(1);
+        const edit = edits[0];
+        expect(edit.pattern).toBe('add_domain_qualifier');
+        expect(edit.category).toBe('description_overlap');
+        expect(edit.applyMode).toBe('apply_with_confirmation');
+        expect(edit.applyAction).toBe('recommended_edit');
+        expect(edit.after).toContain('for anthropic tasks');
+        expect(edit.before).not.toContain('for anthropic tasks');
+        expect(edit.otherEntry.identifier).toBe('release-helper');
+        expect(edit.collisionId).toBe('coll-01');
+        expect(edit.rationale).toContain('cosine 0.82');
+    });
+});
+describe('runEditSuggester — case 2: narrow_scope-shape collision emits NO edit (template not registered)', () => {
+    it('returns empty when no entry has a unique tag', async () => {
+        const fileA = writeSkillMd(TEST_HOME, {
+            identifier: 'deployer-a',
+            description: 'Use when deploying releases.',
+            tag: 'shared',
+        });
+        const fileB = writeSkillMd(TEST_HOME, {
+            identifier: 'deployer-b',
+            description: 'Use when deploying releases.',
+            tag: 'shared',
+        });
+        const entryA = makeEntry({
+            source_path: fileA,
+            identifier: 'deployer-a',
+            description: 'Use when deploying releases.',
+            tag: 'shared',
+        });
+        const entryB = makeEntry({
+            source_path: fileB,
+            identifier: 'deployer-b',
+            description: 'Use when deploying releases.',
+            tag: 'shared',
+        });
+        const result = makeAuditResult([
+            makeSemanticFlag({ collisionId: 'coll-narrow-shape', entryA, entryB }),
+        ]);
+        const edits = await runEditSuggester(result);
+        expect(edits).toHaveLength(0);
+    });
+});
+describe('runEditSuggester — case 3: reword_trigger_verb-shape (CLAUDE.md) emits NO edit', () => {
+    it('returns empty for claude_md_rule entries (template not registered in v1)', async () => {
+        const claudeMdPath = path.join(TEST_HOME, 'CLAUDE.md');
+        fs.writeFileSync(claudeMdPath, '## Trigger phrases\n- Use when deploying\n- Use when deploying\n', 'utf-8');
+        const entryA = {
+            kind: 'claude_md_rule',
+            source_path: claudeMdPath,
+            identifier: 'rule-a',
+            triggerSurface: ['Use when deploying'],
+            meta: { description: 'Use when deploying' },
+        };
+        const entryB = {
+            kind: 'claude_md_rule',
+            source_path: claudeMdPath,
+            identifier: 'rule-b',
+            triggerSurface: ['Use when deploying'],
+            meta: { description: 'Use when deploying' },
+        };
+        const result = makeAuditResult([
+            makeSemanticFlag({ collisionId: 'coll-claude-md', entryA, entryB }),
+        ]);
+        const edits = await runEditSuggester(result);
+        expect(edits).toHaveLength(0);
+    });
+});
+describe('runEditSuggester — case 4: flag matching no template skipped, others still produce edits', () => {
+    it('isolates per-flag dispatch — non-matching flag does not poison matching flag', async () => {
+        const fileA = writeSkillMd(TEST_HOME, {
+            identifier: 'release-tools',
+            description: 'Use when deploying to production.',
+            tag: 'anthropic',
+        });
+        const fileB = writeSkillMd(TEST_HOME, {
+            identifier: 'release-helper',
+            description: 'Use when deploying for the release pipeline.',
+            tag: 'community',
+        });
+        const entryA = makeEntry({
+            source_path: fileA,
+            identifier: 'release-tools',
+            description: 'Use when deploying to production.',
+            tag: 'anthropic',
+        });
+        const entryB = makeEntry({
+            source_path: fileB,
+            identifier: 'release-helper',
+            description: 'Use when deploying for the release pipeline.',
+            tag: 'community',
+        });
+        const entryC = makeEntry({
+            source_path: fileA,
+            identifier: 'shared-c',
+            description: 'Use when deploying releases.',
+            tag: 'shared',
+        });
+        const entryD = makeEntry({
+            source_path: fileB,
+            identifier: 'shared-d',
+            description: 'Use when deploying releases.',
+            tag: 'shared',
+        });
+        const result = makeAuditResult([
+            makeSemanticFlag({ collisionId: 'coll-match', entryA, entryB }),
+            makeSemanticFlag({ collisionId: 'coll-skip', entryA: entryC, entryB: entryD }),
+        ]);
+        const edits = await runEditSuggester(result);
+        expect(edits).toHaveLength(1);
+        expect(edits[0].collisionId).toBe('coll-match');
+    });
+});
+describe('runEditSuggester — case 5: line-range extraction matches file content byte-for-byte', () => {
+    it("`before` snippet equals fileLines.slice(start-1, end).join('\\n')", async () => {
+        const fileA = writeSkillMd(TEST_HOME, {
+            identifier: 'release-tools',
+            description: 'Use when deploying to production.',
+            tag: 'anthropic',
+        });
+        const fileB = writeSkillMd(TEST_HOME, {
+            identifier: 'release-helper',
+            description: 'Use when deploying for the release pipeline.',
+            tag: 'community',
+        });
+        const entryA = makeEntry({
+            source_path: fileA,
+            identifier: 'release-tools',
+            description: 'Use when deploying to production.',
+            tag: 'anthropic',
+        });
+        const entryB = makeEntry({
+            source_path: fileB,
+            identifier: 'release-helper',
+            description: 'Use when deploying for the release pipeline.',
+            tag: 'community',
+        });
+        const result = makeAuditResult([makeSemanticFlag({ collisionId: 'coll-byte', entryA, entryB })]);
+        const edits = await runEditSuggester(result);
+        expect(edits).toHaveLength(1);
+        const edit = edits[0];
+        const fileLines = fs.readFileSync(edit.filePath, 'utf-8').split('\n');
+        const startIdx = edit.lineRange.start - 1;
+        const endIdx = edit.lineRange.end - 1;
+        const reconstructed = fileLines.slice(startIdx, endIdx + 1).join('\n');
+        expect(edit.before).toBe(reconstructed);
+    });
+});
+describe('runEditSuggester — case 6: multiple flags on the same file produce independent edits', () => {
+    it('emits one RecommendedEdit per matching flag, stable in input order', async () => {
+        const fileA = writeSkillMd(TEST_HOME, {
+            identifier: 'release-tools',
+            description: 'Use when deploying to production.',
+            tag: 'anthropic',
+        });
+        const fileB = writeSkillMd(TEST_HOME, {
+            identifier: 'release-helper-1',
+            description: 'Use when deploying for stage one.',
+            tag: 'community',
+        });
+        const fileC = writeSkillMd(TEST_HOME, {
+            identifier: 'release-helper-2',
+            description: 'Use when deploying for stage two.',
+            tag: 'enterprise',
+        });
+        const entryA = makeEntry({
+            source_path: fileA,
+            identifier: 'release-tools',
+            description: 'Use when deploying to production.',
+            tag: 'anthropic',
+        });
+        const entryB = makeEntry({
+            source_path: fileB,
+            identifier: 'release-helper-1',
+            description: 'Use when deploying for stage one.',
+            tag: 'community',
+        });
+        const entryC = makeEntry({
+            source_path: fileC,
+            identifier: 'release-helper-2',
+            description: 'Use when deploying for stage two.',
+            tag: 'enterprise',
+        });
+        const result = makeAuditResult([
+            makeSemanticFlag({ collisionId: 'coll-multi-1', entryA, entryB }),
+            makeSemanticFlag({ collisionId: 'coll-multi-2', entryA, entryB: entryC }),
+        ]);
+        const edits = await runEditSuggester(result);
+        expect(edits.length).toBeGreaterThanOrEqual(2);
+        expect(edits[0].collisionId).toBe('coll-multi-1');
+        expect(edits[1].collisionId).toBe('coll-multi-2');
+    });
+});
+describe('runEditSuggester — case 7: applyMode is apply_with_confirmation for shipped template', () => {
+    it("returned edit's applyMode equals 'apply_with_confirmation'", async () => {
+        const fileA = writeSkillMd(TEST_HOME, {
+            identifier: 'release-tools',
+            description: 'Use when deploying to production.',
+            tag: 'anthropic',
+        });
+        const fileB = writeSkillMd(TEST_HOME, {
+            identifier: 'release-helper',
+            description: 'Use when deploying releases.',
+            tag: 'community',
+        });
+        const entryA = makeEntry({
+            source_path: fileA,
+            identifier: 'release-tools',
+            description: 'Use when deploying to production.',
+            tag: 'anthropic',
+        });
+        const entryB = makeEntry({
+            source_path: fileB,
+            identifier: 'release-helper',
+            description: 'Use when deploying releases.',
+            tag: 'community',
+        });
+        const result = makeAuditResult([makeSemanticFlag({ collisionId: 'coll-mode', entryA, entryB })]);
+        const edits = await runEditSuggester(result);
+        expect(edits).toHaveLength(1);
+        expect(edits[0].applyMode).toBe('apply_with_confirmation');
+    });
+});
+describe('runEditSuggester — case 8: otherEntry cross-references the partner', () => {
+    it('otherEntry.identifier matches the partner in the original SemanticCollisionFlag', async () => {
+        const fileA = writeSkillMd(TEST_HOME, {
+            identifier: 'tool-alpha',
+            description: 'Use when running alpha workflows.',
+            tag: 'alpha-only',
+        });
+        const fileB = writeSkillMd(TEST_HOME, {
+            identifier: 'tool-beta',
+            description: 'Use when running beta workflows.',
+            tag: 'beta-only',
+        });
+        const entryA = makeEntry({
+            source_path: fileA,
+            identifier: 'tool-alpha',
+            description: 'Use when running alpha workflows.',
+            tag: 'alpha-only',
+        });
+        const entryB = makeEntry({
+            source_path: fileB,
+            identifier: 'tool-beta',
+            description: 'Use when running beta workflows.',
+            tag: 'beta-only',
+        });
+        const result = makeAuditResult([
+            makeSemanticFlag({ collisionId: 'coll-other', entryA, entryB }),
+        ]);
+        const edits = await runEditSuggester(result);
+        expect(edits).toHaveLength(1);
+        const edit = edits[0];
+        expect(edit.otherEntry.identifier).toBe('tool-beta');
+        expect(edit.otherEntry.sourcePath).toBe(fileB);
+    });
+});
+describe('runEditSuggester — case 9: missing file produces no exception, no edit', () => {
+    it('soft-warns and skips when source_path does not exist', async () => {
+        const missingPath = path.join(TEST_HOME, 'does-not-exist', 'SKILL.md');
+        const partnerPath = path.join(TEST_HOME, 'also-missing', 'SKILL.md');
+        const entryA = makeEntry({
+            source_path: missingPath,
+            identifier: 'phantom-a',
+            description: 'Use when running phantom tasks.',
+            tag: 'phantom',
+        });
+        const entryB = makeEntry({
+            source_path: partnerPath,
+            identifier: 'phantom-b',
+            description: 'Use when running phantom tasks.',
+            tag: 'partner',
+        });
+        const result = makeAuditResult([
+            makeSemanticFlag({ collisionId: 'coll-missing', entryA, entryB }),
+        ]);
+        const edits = await runEditSuggester(result);
+        expect(edits).toHaveLength(0);
+    });
+});
+describe('runEditSuggester — case 10: empty semanticCollisions short-circuits', () => {
+    it('returns empty array with no I/O', async () => {
+        const result = makeAuditResult([]);
+        const edits = await runEditSuggester(result);
+        expect(edits).toEqual([]);
+    });
+});
+//# sourceMappingURL=edit-suggester.test.js.map

package/dist/tests/unit/edit-suggester.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"edit-suggester.test.js","sourceRoot":"","sources":["../../../tests/unit/edit-suggester.test.ts"],"names":[],"mappings":"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"}

package/dist/tests/unit/framework-adapter.test.d.ts

@@ -0,0 +1,30 @@
+/**
+ * @fileoverview Unit tests for SMI-4590 Wave 4 PR 2/6 — FrameworkAdapter
+ *               seam + claudeCodeAdapter (v1).
+ * @module @skillsmith/mcp-server/tests/unit/framework-adapter
+ *
+ * Plan: docs/internal/implementation/smi-4590-cli-mcp-framework-adapter.md §5,
+ *       §Tests §framework-adapter.test.ts.
+ *
+ * Coverage:
+ *   1. `claudeCodeAdapter.name === 'claude-code'` + `describesFiles()` non-empty.
+ *   2. `scanPaths()` returns valid `InventoryEntry[]` matching Wave 1's output.
+ *   3. `applyAction({kind:'rename', from, to})` performs a raw `fs.rename`.
+ *   4. `applyAction({kind:'inline-edit', searchMode:'literal', ...})` mutates
+ *      the file via Wave 3's applyRecommendedEdit (registered template only).
+ *   5. `applyAction({kind:'inline-edit', searchMode:'regex', ...})` throws
+ *      `namespace.adapter.unsupported_search_mode` and the file is unchanged.
+ *   6. Convenience wrapper `applyRename(entry, newName, { auditId })` runs
+ *      Wave 2's applyRename flow (backup + ledger + rename) for a command file.
+ *   7. Convenience wrapper `applyEdit(edit, { auditId })` round-trips through
+ *      `applyAction` and mutates the file.
+ *   8. Conformance: `claudeCodeAdapter` satisfies `FrameworkAdapter` (compile-
+ *      time guard via the `const adapter: FrameworkAdapter = claudeCodeAdapter`
+ *      assignment in this file).
+ *   9. Inline-edit with missing `auditId` rejects with
+ *      `namespace.adapter.missing_context`.
+ *  10. Inline-edit with non-registered `pattern` rejects with
+ *      `namespace.adapter.template_not_in_apply_registry`.
+ */
+export {};
+//# sourceMappingURL=framework-adapter.test.d.ts.map

package/dist/tests/unit/framework-adapter.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"framework-adapter.test.d.ts","sourceRoot":"","sources":["../../../tests/unit/framework-adapter.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG"}

package/dist/tests/unit/framework-adapter.test.js

@@ -0,0 +1,221 @@
+/**
+ * @fileoverview Unit tests for SMI-4590 Wave 4 PR 2/6 — FrameworkAdapter
+ *               seam + claudeCodeAdapter (v1).
+ * @module @skillsmith/mcp-server/tests/unit/framework-adapter
+ *
+ * Plan: docs/internal/implementation/smi-4590-cli-mcp-framework-adapter.md §5,
+ *       §Tests §framework-adapter.test.ts.
+ *
+ * Coverage:
+ *   1. `claudeCodeAdapter.name === 'claude-code'` + `describesFiles()` non-empty.
+ *   2. `scanPaths()` returns valid `InventoryEntry[]` matching Wave 1's output.
+ *   3. `applyAction({kind:'rename', from, to})` performs a raw `fs.rename`.
+ *   4. `applyAction({kind:'inline-edit', searchMode:'literal', ...})` mutates
+ *      the file via Wave 3's applyRecommendedEdit (registered template only).
+ *   5. `applyAction({kind:'inline-edit', searchMode:'regex', ...})` throws
+ *      `namespace.adapter.unsupported_search_mode` and the file is unchanged.
+ *   6. Convenience wrapper `applyRename(entry, newName, { auditId })` runs
+ *      Wave 2's applyRename flow (backup + ledger + rename) for a command file.
+ *   7. Convenience wrapper `applyEdit(edit, { auditId })` round-trips through
+ *      `applyAction` and mutates the file.
+ *   8. Conformance: `claudeCodeAdapter` satisfies `FrameworkAdapter` (compile-
+ *      time guard via the `const adapter: FrameworkAdapter = claudeCodeAdapter`
+ *      assignment in this file).
+ *   9. Inline-edit with missing `auditId` rejects with
+ *      `namespace.adapter.missing_context`.
+ *  10. Inline-edit with non-registered `pattern` rejects with
+ *      `namespace.adapter.template_not_in_apply_registry`.
+ */
+import { afterEach, beforeEach, describe, expect, it } from 'vitest';
+import * as fs from 'node:fs';
+import * as os from 'node:os';
+import * as path from 'node:path';
+import { newAuditId } from '../../src/audit/audit-history.js';
+import { claudeCodeAdapter, FrameworkAdapterError } from '../../src/audit/framework-adapter.js';
+import { writeSkillMd } from './edit-suggester.fixtures.js';
+// Compile-time conformance assertion. If `claudeCodeAdapter` ever drifts
+// out of the `FrameworkAdapter` shape, this assignment will fail to
+// type-check during the build step in CI.
+const _conformance = claudeCodeAdapter;
+void _conformance;
+let TEST_HOME;
+let ORIGINAL_HOME;
+beforeEach(() => {
+    TEST_HOME = fs.mkdtempSync(path.join(os.tmpdir(), 'skillsmith-framework-adapter-'));
+    ORIGINAL_HOME = process.env['HOME'];
+    process.env['HOME'] = TEST_HOME;
+});
+afterEach(() => {
+    if (ORIGINAL_HOME !== undefined) {
+        process.env['HOME'] = ORIGINAL_HOME;
+    }
+    else {
+        delete process.env['HOME'];
+    }
+    if (TEST_HOME && fs.existsSync(TEST_HOME)) {
+        fs.rmSync(TEST_HOME, { recursive: true, force: true });
+    }
+});
+describe('claudeCodeAdapter — identity', () => {
+    it('has name "claude-code" and non-empty describesFiles()', () => {
+        expect(claudeCodeAdapter.name).toBe('claude-code');
+        const files = claudeCodeAdapter.describesFiles();
+        expect(files.length).toBeGreaterThan(0);
+        expect(files).toContain('~/.claude/skills/*/SKILL.md');
+    });
+});
+describe('claudeCodeAdapter.scanPaths', () => {
+    it('returns InventoryEntry[] from an empty home (no scan errors)', async () => {
+        const entries = await claudeCodeAdapter.scanPaths(TEST_HOME);
+        expect(Array.isArray(entries)).toBe(true);
+        // Empty .claude/ → no entries; the contract is just "Array of InventoryEntry".
+        expect(entries.every((e) => typeof e.identifier === 'string')).toBe(true);
+    });
+    it('discovers a SKILL.md created on disk and returns it as a kind:"skill" entry', async () => {
+        writeSkillMd(TEST_HOME, {
+            identifier: 'fixture-skill',
+            description: 'Use when deploying to staging',
+        });
+        const entries = await claudeCodeAdapter.scanPaths(TEST_HOME);
+        const skill = entries.find((e) => e.identifier === 'fixture-skill');
+        expect(skill).toBeDefined();
+        expect(skill?.kind).toBe('skill');
+        expect(skill?.source_path).toContain('SKILL.md');
+    });
+});
+describe('claudeCodeAdapter.applyAction — rename refusal (force-uses-applyRename)', () => {
+    it('refuses bare {kind:"rename"} dispatch with namespace.adapter.missing_context and leaves disk untouched', async () => {
+        const fromPath = path.join(TEST_HOME, 'src.md');
+        const toPath = path.join(TEST_HOME, 'dst.md');
+        fs.writeFileSync(fromPath, 'hello', 'utf-8');
+        await expect(claudeCodeAdapter.applyAction({
+            kind: 'rename',
+            from: fromPath,
+            to: toPath,
+        })).rejects.toMatchObject({
+            kind: 'namespace.adapter.missing_context',
+        });
+        // Disk untouched: refusing the bare path is the whole point — Wave 2's
+        // backup + ledger flow must not be bypassed.
+        expect(fs.existsSync(fromPath)).toBe(true);
+        expect(fs.existsSync(toPath)).toBe(false);
+        expect(fs.readFileSync(fromPath, 'utf-8')).toBe('hello');
+    });
+});
+describe('claudeCodeAdapter.applyAction — inline-edit', () => {
+    it('rejects searchMode "regex" with namespace.adapter.unsupported_search_mode and leaves the file untouched', async () => {
+        const filePath = path.join(TEST_HOME, 'doc.md');
+        const original = 'Use when deploying to staging';
+        fs.writeFileSync(filePath, original, 'utf-8');
+        await expect(claudeCodeAdapter.applyAction({
+            kind: 'inline-edit',
+            filePath,
+            search: 'deploying',
+            replace: 'shipping',
+            searchMode: 'regex',
+            auditId: newAuditId(),
+            pattern: 'add_domain_qualifier',
+        })).rejects.toMatchObject({
+            kind: 'namespace.adapter.unsupported_search_mode',
+        });
+        // File untouched.
+        expect(fs.readFileSync(filePath, 'utf-8')).toBe(original);
+    });
+    it('rejects literal-mode dispatch missing auditId with namespace.adapter.missing_context', async () => {
+        const filePath = path.join(TEST_HOME, 'doc.md');
+        fs.writeFileSync(filePath, 'Use when deploying', 'utf-8');
+        await expect(claudeCodeAdapter.applyAction({
+            kind: 'inline-edit',
+            filePath,
+            search: 'deploying',
+            replace: 'shipping',
+            searchMode: 'literal',
+            // auditId intentionally omitted
+            pattern: 'add_domain_qualifier',
+        })).rejects.toBeInstanceOf(FrameworkAdapterError);
+    });
+    it('rejects literal-mode dispatch with a non-registered pattern with namespace.adapter.template_not_in_apply_registry', async () => {
+        const filePath = path.join(TEST_HOME, 'doc.md');
+        fs.writeFileSync(filePath, 'Use when deploying', 'utf-8');
+        await expect(claudeCodeAdapter.applyAction({
+            kind: 'inline-edit',
+            filePath,
+            search: 'deploying',
+            replace: 'shipping',
+            searchMode: 'literal',
+            auditId: newAuditId(),
+            // narrow_scope is NOT in APPLY_TEMPLATE_REGISTRY in v1.
+            pattern: 'narrow_scope',
+        })).rejects.toMatchObject({
+            kind: 'namespace.adapter.template_not_in_apply_registry',
+        });
+    });
+});
+describe('claudeCodeAdapter.applyEdit — convenience wrapper round-trip', () => {
+    it('round-trips through applyAction and mutates the file (registered template)', async () => {
+        // Build a SKILL.md whose description contains the literal we want
+        // to edit. The applier requires byte-for-byte stale-before match.
+        const skillPath = writeSkillMd(TEST_HOME, {
+            identifier: 'roundtrip-fixture',
+            description: 'Use when deploying',
+        });
+        const original = fs.readFileSync(skillPath, 'utf-8');
+        expect(original).toContain('Use when deploying');
+        const auditId = newAuditId();
+        const edit = {
+            // The collisionId here is opaque — Wave 3 applier only uses it as
+            // the ledger FK, not to look up state. The convenience wrapper
+            // builds an InlineEditAction with `before` as the literal search.
+            collisionId: 'cid-roundtrip-0',
+            category: 'description_overlap',
+            pattern: 'add_domain_qualifier',
+            filePath: skillPath,
+            lineRange: { start: 1, end: 1 }, // recomputed by adapter; ignored by inline-edit translator
+            before: 'Use when deploying',
+            after: 'Use when deploying for release-tools tasks',
+            rationale: 'test',
+            applyAction: 'recommended_edit',
+            applyMode: 'apply_with_confirmation',
+            otherEntry: { identifier: 'other', sourcePath: '/tmp/other' },
+        };
+        expect(claudeCodeAdapter.applyEdit).toBeDefined();
+        await claudeCodeAdapter.applyEdit?.(edit, { auditId });
+        const updated = fs.readFileSync(skillPath, 'utf-8');
+        expect(updated).toContain('Use when deploying for release-tools tasks');
+        expect(updated).not.toBe(original);
+    });
+});
+describe('claudeCodeAdapter.applyRename — convenience wrapper for command files', () => {
+    it('renames a ~/.claude/commands/<name>.md via Wave 2 applyRename + ledger', async () => {
+        // Stage a command file at ~/.claude/commands/foo.md.
+        const commandsDir = path.join(TEST_HOME, '.claude', 'commands');
+        fs.mkdirSync(commandsDir, { recursive: true });
+        const fromPath = path.join(commandsDir, 'foo.md');
+        fs.writeFileSync(fromPath, '# /foo\n', 'utf-8');
+        const entry = {
+            kind: 'command',
+            source_path: fromPath,
+            identifier: 'foo',
+            triggerSurface: ['/foo'],
+        };
+        expect(claudeCodeAdapter.applyRename).toBeDefined();
+        await claudeCodeAdapter.applyRename?.(entry, 'mine-foo', {
+            auditId: newAuditId(),
+        });
+        const targetPath = path.join(commandsDir, 'mine-foo.md');
+        expect(fs.existsSync(fromPath)).toBe(false);
+        expect(fs.existsSync(targetPath)).toBe(true);
+    });
+    it('rejects rename of a claude_md_rule entry with namespace.adapter.unsupported_action', async () => {
+        const entry = {
+            kind: 'claude_md_rule',
+            source_path: path.join(TEST_HOME, '.claude', 'CLAUDE.md'),
+            identifier: 'rule-hash-stub',
+            triggerSurface: ['use when deploying'],
+        };
+        await expect(claudeCodeAdapter.applyRename?.(entry, 'whatever', {
+            auditId: newAuditId(),
+        })).rejects.toBeInstanceOf(FrameworkAdapterError);
+    });
+});
+//# sourceMappingURL=framework-adapter.test.js.map

package/dist/tests/unit/framework-adapter.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"framework-adapter.test.js","sourceRoot":"","sources":["../../../tests/unit/framework-adapter.test.ts"],"names":[],"mappings":"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"}