@skillsmith/mcp-server 0.4.13 → 0.5.1

package/dist/src/audit/framework-adapter.js

@@ -0,0 +1,251 @@
+/**
+ * @fileoverview `claudeCodeAdapter` — v1 implementation of `FrameworkAdapter`.
+ *               Wraps Wave 1's `scanLocalInventory`, Wave 2's `applyRename`,
+ *               and Wave 3's `applyRecommendedEdit` behind a uniform seam.
+ * @module @skillsmith/mcp-server/audit/framework-adapter
+ *
+ * Plan: docs/internal/implementation/smi-4590-cli-mcp-framework-adapter.md §5.
+ *
+ * v1 contract (Claude-Code only):
+ *   - `scanPaths` delegates to `scanLocalInventory` and returns `entries[]`.
+ *   - `applyAction({kind:'rename'})` is REFUSED — a thin {from, to} pair
+ *     cannot reconstruct the `InventoryEntry` Wave 2's `applyRename`
+ *     needs (kind discriminator, identifier, source_path), and a raw
+ *     `fs.rename` would bypass the backup + namespace ledger and leave
+ *     the user without a revert path. Callers must use the
+ *     `applyRename(entry, newName, { auditId })` convenience wrapper.
+ *     The bare `{kind:'rename'}` shape stays in the union as a forward-
+ *     compat surface for v2 adapters that own their own audit-history.
+ *   - `applyAction({kind:'inline-edit', searchMode:'literal'})` translates
+ *     the action into a Wave 3 `RecommendedEdit` and dispatches to
+ *     `applyRecommendedEdit`. Requires `action.auditId` + `action.pattern`;
+ *     missing context throws `namespace.adapter.missing_context`.
+ *   - `applyAction({kind:'inline-edit', searchMode:'regex'})` throws the
+ *     typed error `namespace.adapter.unsupported_search_mode`. Reserved
+ *     for v2 cursorAdapter.
+ *   - Convenience wrappers `applyRename` + `applyEdit` build the right
+ *     `AdapterAction` shape from inventory/edit context and call
+ *     `applyAction`. They do NOT re-implement Wave 2/3 — the rename
+ *     wrapper goes through Wave 2's full path (backup + ledger), and the
+ *     edit wrapper goes through Wave 3's `applyRecommendedEdit`.
+ */
+import * as fs from 'node:fs/promises';
+import { newAuditId, deriveCollisionId } from './audit-history.js';
+import { applyRecommendedEdit, APPLY_TEMPLATE_REGISTRY } from './edit-applier.js';
+import { applyRename as applyRenameEngine } from './rename-engine.js';
+import { scanLocalInventory } from '../utils/local-inventory.js';
+/**
+ * Typed error class for adapter-layer failures. Callers `switch` on
+ * `kind` to branch on the failure mode without parsing strings.
+ */
+export class FrameworkAdapterError extends Error {
+    kind;
+    /**
+     * For `'subcall_failed'`, carries the inner typed-error `kind` from
+     * Wave 2 (`RenameError`) or Wave 3 (`EditApplyError`) so callers can
+     * `switch` on it without parsing strings.
+     */
+    innerKind;
+    constructor(kind, message, innerKind) {
+        super(message);
+        this.name = 'FrameworkAdapterError';
+        this.kind = kind;
+        this.innerKind = innerKind;
+    }
+}
+/**
+ * Map an `InventoryEntry.kind` to the Wave 2 `RenameAction` discriminator.
+ */
+function inventoryKindToRenameAction(entry) {
+    switch (entry.kind) {
+        case 'command':
+            return 'rename_command_file';
+        case 'agent':
+            return 'rename_agent_file';
+        case 'skill':
+            return 'rename_skill_dir_and_frontmatter';
+        case 'claude_md_rule':
+            // CLAUDE.md trigger lines are not file-renamable — the inline-edit
+            // path is the right surface for them. Reject so callers cannot
+            // accidentally pass a `claude_md_rule` entry into the rename flow.
+            throw new FrameworkAdapterError('namespace.adapter.unsupported_action', `inventory kind "claude_md_rule" cannot be renamed; use applyEdit instead`);
+        default: {
+            const exhaustive = entry.kind;
+            throw new FrameworkAdapterError('namespace.adapter.unsupported_action', `unknown inventory kind: ${String(exhaustive)}`);
+        }
+    }
+}
+/**
+ * Translate an `InlineEditAction` (literal mode) into a Wave 3
+ * `RecommendedEdit`. Locates the literal `search` substring in the file
+ * and computes a 1-indexed inclusive line range covering it.
+ *
+ * Throws if `search` is absent from the file or appears more than once
+ * (Wave 3's stale-before guard requires byte-for-byte exact match at
+ * the recorded `lineRange`).
+ */
+async function buildRecommendedEditFromInlineEdit(action) {
+    if (!action.auditId) {
+        throw new FrameworkAdapterError('namespace.adapter.missing_context', `inline-edit dispatch requires action.auditId for v1 claudeCodeAdapter`);
+    }
+    if (!action.pattern) {
+        throw new FrameworkAdapterError('namespace.adapter.missing_context', `inline-edit dispatch requires action.pattern for v1 claudeCodeAdapter`);
+    }
+    if (!APPLY_TEMPLATE_REGISTRY.has(action.pattern)) {
+        throw new FrameworkAdapterError('namespace.adapter.template_not_in_apply_registry', `template pattern "${action.pattern}" is not in APPLY_TEMPLATE_REGISTRY`);
+    }
+    const fileContent = await fs.readFile(action.filePath, 'utf-8');
+    const firstIndex = fileContent.indexOf(action.search);
+    if (firstIndex < 0) {
+        throw new FrameworkAdapterError('namespace.adapter.search_not_found', `literal search string not found in ${action.filePath}`);
+    }
+    const secondIndex = fileContent.indexOf(action.search, firstIndex + 1);
+    if (secondIndex >= 0) {
+        throw new FrameworkAdapterError('namespace.adapter.search_not_unique', `literal search string occurs more than once in ${action.filePath}; refusing to mutate`);
+    }
+    // Compute 1-indexed inclusive line range covering the match. Wave 3's
+    // applier uses line-based slicing (`fileLines.slice(start-1, end).join('\n')`
+    // must equal `before`), so we expand the substring search to the full
+    // line(s) it sits on and replace within those lines.
+    const fileLines = fileContent.split('\n');
+    // UTF-16 code-unit offsets (matches `String.indexOf` semantics) for
+    // the start of each line. Not byte offsets — for ASCII content the
+    // two coincide, but multi-byte glyphs (em dashes, emoji) make the
+    // distinction load-bearing if this is ever consumed as a byte index.
+    const lineStartOffsets = [0];
+    for (let i = 0; i < fileLines.length - 1; i++) {
+        // +1 for the consumed '\n' separator
+        lineStartOffsets.push(lineStartOffsets[i] + fileLines[i].length + 1);
+    }
+    // Locate the start line for `firstIndex`.
+    let startLine = 1;
+    for (let i = lineStartOffsets.length - 1; i >= 0; i--) {
+        if (firstIndex >= lineStartOffsets[i]) {
+            startLine = i + 1;
+            break;
+        }
+    }
+    // The match may span multiple lines if `search` contains '\n'.
+    const matchLineCount = action.search.split('\n').length;
+    const endLine = startLine + matchLineCount - 1;
+    // Whole-line `before` = the lines covering the substring match.
+    const beforeLines = fileLines.slice(startLine - 1, endLine).join('\n');
+    // Whole-line `after` = same lines with `search` substituted for `replace`.
+    const afterLines = beforeLines.replace(action.search, action.replace);
+    // collisionId is derived from auditId + filePath (single-entry adapter
+    // dispatch). Use a synthetic single-entry InventoryEntry shape solely
+    // to feed `deriveCollisionId`'s sorted-paths input — the resulting
+    // CollisionId is opaque to the caller and stable for the same
+    // (auditId, filePath) pair.
+    const collisionId = deriveCollisionId(action.auditId, [
+        {
+            kind: 'claude_md_rule',
+            source_path: action.filePath,
+            identifier: action.search.slice(0, 64),
+            triggerSurface: [],
+        },
+    ]);
+    return {
+        collisionId,
+        category: 'description_overlap',
+        pattern: action.pattern,
+        filePath: action.filePath,
+        lineRange: { start: startLine, end: endLine },
+        before: beforeLines,
+        after: afterLines,
+        rationale: 'inline-edit dispatched via claudeCodeAdapter.applyAction (literal-mode translation)',
+        applyAction: 'recommended_edit',
+        applyMode: 'apply_with_confirmation',
+        otherEntry: { identifier: '', sourcePath: '' },
+    };
+}
+/**
+ * v1 implementation of `FrameworkAdapter` for Claude-Code.
+ */
+export const claudeCodeAdapter = {
+    name: 'claude-code',
+    describesFiles: () => [
+        '~/.claude/skills/*/SKILL.md',
+        '~/.claude/commands/*.md',
+        '~/.claude/agents/*.md',
+        '~/.claude/CLAUDE.md',
+        '<project>/CLAUDE.md',
+    ],
+    scanPaths: async (homeDir, projectDir) => {
+        const result = await scanLocalInventory({ homeDir, projectDir });
+        return result.entries;
+    },
+    applyAction: async (action) => {
+        if (action.kind === 'rename') {
+            // v1 Claude-Code refuses bare `applyAction({kind:'rename'})` — a
+            // raw `fs.rename` would bypass Wave 2's backup + namespace
+            // ledger, leaving the user without a revert path. Callers must
+            // use the `applyRename(entry, newName, { auditId })` convenience
+            // wrapper which routes through Wave 2's full flow. The richer
+            // entry context (kind discriminator, identifier, source_path)
+            // cannot be reconstructed from a thin {from, to} pair.
+            throw new FrameworkAdapterError('namespace.adapter.missing_context', `claudeCodeAdapter.applyAction({kind:'rename'}) refused — use applyRename(entry, newName, { auditId }) so the rename is backed up + recorded in the namespace ledger`);
+        }
+        if (action.kind === 'inline-edit') {
+            if (action.searchMode === 'regex') {
+                throw new FrameworkAdapterError('namespace.adapter.unsupported_search_mode', `searchMode "regex" not supported by v1 claudeCodeAdapter; reserved for v2 cursorAdapter`);
+            }
+            // Literal mode: translate to RecommendedEdit + dispatch to Wave 3.
+            const edit = await buildRecommendedEditFromInlineEdit(action);
+            const result = await applyRecommendedEdit(edit, {
+                // narrowed by buildRecommendedEditFromInlineEdit:
+                auditId: action.auditId,
+                mode: 'apply_with_confirmation',
+            });
+            if (!result.success) {
+                throw new FrameworkAdapterError('namespace.adapter.subcall_failed', `applyRecommendedEdit failed: ${result.error?.message ?? 'unknown'}`, result.error?.kind);
+            }
+            return;
+        }
+        // Exhaustiveness guard.
+        const exhaustive = action;
+        throw new FrameworkAdapterError('namespace.adapter.unsupported_action', `unsupported action shape: ${JSON.stringify(exhaustive)}`);
+    },
+    applyRename: async (entry, newName, opts) => {
+        // Build a minimal RenameSuggestion and call Wave 2's applyRename
+        // for the full backup + ledger + atomic rename flow. The
+        // collisionId is synthetic (derived from auditId + the single
+        // entry's path) — the Wave 2 ledger entry is keyed by
+        // (skillId, kind, originalIdentifier), not by collisionId, so
+        // a synthetic id is acceptable for adapter-mediated renames.
+        const collisionId = deriveCollisionId(opts.auditId, [entry]);
+        const suggestion = {
+            collisionId,
+            entry,
+            currentName: entry.identifier,
+            suggested: newName,
+            applyAction: inventoryKindToRenameAction(entry),
+            reason: 'claudeCodeAdapter.applyRename convenience wrapper',
+        };
+        const result = await applyRenameEngine({
+            suggestion,
+            request: { action: 'apply', auditId: opts.auditId },
+        });
+        if (!result.success) {
+            throw new FrameworkAdapterError('namespace.adapter.subcall_failed', `applyRename failed: ${result.error?.message ?? 'unknown'}`, result.error?.kind);
+        }
+    },
+    applyEdit: async (edit, opts) => {
+        // Convenience wrapper: build an InlineEditAction and dispatch
+        // through applyAction so the literal-mode translation path runs
+        // its registry guard + uniqueness check uniformly.
+        const action = {
+            kind: 'inline-edit',
+            filePath: edit.filePath,
+            search: edit.before,
+            replace: edit.after,
+            searchMode: 'literal',
+            auditId: opts.auditId,
+            pattern: edit.pattern,
+        };
+        await claudeCodeAdapter.applyAction(action);
+    },
+};
+// Re-export helpers used by tests + callers.
+export { newAuditId };
+//# sourceMappingURL=framework-adapter.js.map

package/dist/src/audit/framework-adapter.js.map

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

package/dist/src/audit/framework-adapter.types.d.ts

@@ -0,0 +1,162 @@
+/**
+ * @fileoverview Type vocabulary for the FrameworkAdapter seam — v1 ships
+ *               `claude-code` only; v2 reserves `cursor`, `copilot`, `aider`,
+ *               `continue`, `cline`. Defines `AdapterAction` (discriminated
+ *               union over `FileRenameAction` + `InlineEditAction`) and the
+ *               adapter interface.
+ * @module @skillsmith/mcp-server/audit/framework-adapter.types
+ *
+ * Plan: docs/internal/implementation/smi-4590-cli-mcp-framework-adapter.md §1, §5.
+ *
+ * Why this seam exists (per plan §5): `.cursorrules` (Cursor v2) is a
+ * monolithic file with multiple trigger phrases inside a single file; a
+ * `FileRenameAction`-only shape would break Cursor support. Shipping
+ * `InlineEditAction` from v1 is a forcing function that lets v2 swap in
+ * `cursorAdapter` without refactoring call sites.
+ *
+ * v1 contract (claudeCodeAdapter):
+ *   - `FileRenameAction` is supported via convenience wrapper `applyRename`
+ *     which performs the full Wave 2 `applyRename` flow (backup + ledger
+ *     append + atomic rename). The bare `applyAction({kind:'rename'})`
+ *     entry point is a raw transport seam (forward-compat for v2 adapters
+ *     that own their own audit-history); v1 callers should prefer the
+ *     `applyRename` wrapper which threads `auditId` through correctly.
+ *   - `InlineEditAction` with `searchMode: 'literal'` translates to a
+ *     `RecommendedEdit` and dispatches to Wave 3's `applyRecommendedEdit`.
+ *   - `InlineEditAction` with `searchMode: 'regex'` is rejected with the
+ *     typed error `namespace.adapter.unsupported_search_mode`. Reserved
+ *     for v2 cursorAdapter.
+ */
+import type { InventoryEntry } from '../utils/local-inventory.types.js';
+import type { RecommendedEdit } from './edit-suggester.types.js';
+/**
+ * Set of frameworks the audit pipeline can target. v1 ships `claude-code`
+ * exclusively. The v2 reserved values document the intended extension
+ * surface — adding a new entry here without a matching adapter
+ * implementation is a compile-time signal, not a runtime contract.
+ */
+export type FrameworkName = 'claude-code' | 'cursor' | 'copilot' | 'aider' | 'continue' | 'cline';
+/**
+ * Rename a single file (or directory + frontmatter for `.claude/skills/`).
+ *
+ * For Claude-Code, this maps to Wave 2's `applyRename` flow: the caller
+ * should normally invoke the `applyRename` convenience wrapper which
+ * builds the action from a full `InventoryEntry` + `auditId`. The bare
+ * `applyAction({kind:'rename'})` entry is a transport seam — it expects
+ * a richer caller-side context to resolve correctly (see `auditId`
+ * field).
+ */
+export interface FileRenameAction {
+    kind: 'rename';
+    /** Absolute path (current). */
+    from: string;
+    /** Absolute path (target). */
+    to: string;
+    /**
+     * FK into `~/.skillsmith/audits/<auditId>/result.json`. Required by
+     * v1 Claude-Code adapter so the rename can be traced in the namespace
+     * overrides ledger. v2 adapters that own a different audit history
+     * may treat this as optional, hence the optional declaration here.
+     */
+    auditId?: string;
+}
+/**
+ * In-place edit at a specific point in a file. Required for monolithic
+ * files (`.cursorrules`, freeform CLAUDE.md sections) where renaming
+ * the file itself is meaningless — the edit happens at a section.
+ *
+ * v1 Claude-Code adapter accepts only `searchMode: 'literal'` and
+ * translates the action into a Wave 3 `RecommendedEdit` shape before
+ * dispatching to `applyRecommendedEdit`. `searchMode: 'regex'` is
+ * rejected with `namespace.adapter.unsupported_search_mode`.
+ */
+export interface InlineEditAction {
+    kind: 'inline-edit';
+    /** Absolute path to the file to mutate. */
+    filePath: string;
+    /**
+     * Exact substring (when `searchMode === 'literal'`) or regex source
+     * string (when `searchMode === 'regex'`) to locate within the file.
+     */
+    search: string;
+    /** Replacement text. */
+    replace: string;
+    /**
+     * Required. v1 `claudeCodeAdapter` rejects `'regex'` with the typed
+     * error `namespace.adapter.unsupported_search_mode`. Future v2
+     * `cursorAdapter` supports both modes.
+     */
+    searchMode: 'literal' | 'regex';
+    /**
+     * FK into `~/.skillsmith/audits/<auditId>/result.json`. Required by
+     * v1 Claude-Code adapter so the edit-applier ledger entry is bound
+     * to the originating audit. v2 adapters may treat this as optional,
+     * hence the optional declaration here.
+     */
+    auditId?: string;
+    /**
+     * The edit-suggester template pattern that produced this action. v1
+     * Claude-Code adapter passes this through to Wave 3's
+     * `applyRecommendedEdit`, which gates on `APPLY_TEMPLATE_REGISTRY`.
+     * Only `'add_domain_qualifier'` is in the registry in v1.
+     */
+    pattern?: RecommendedEdit['pattern'];
+}
+/**
+ * Discriminated union over every adapter action shape. The `kind`
+ * literal narrows the union for downstream dispatchers.
+ */
+export type AdapterAction = FileRenameAction | InlineEditAction;
+/**
+ * Framework adapter — abstracts over `claude-code` (v1), `cursor`,
+ * `copilot`, `aider`, `continue`, `cline` (v2). Wave 4's MCP tools,
+ * the CLI, and Wave 2's install pre-flight all consume the adapter
+ * rather than calling `scanLocalInventory` / `applyRename` /
+ * `applyRecommendedEdit` directly. This is the seam that lets v2 swap
+ * in `cursorAdapter` without touching call sites.
+ */
+export interface FrameworkAdapter {
+    name: FrameworkName;
+    /** Glob/path examples for transparency in audit reports. */
+    describesFiles(): string[];
+    /**
+     * Scan the framework's relevant filesystem locations for inventory.
+     * For `claude-code` this wraps Wave 1's `scanLocalInventory`.
+     */
+    scanPaths(homeDir: string, projectDir?: string): Promise<InventoryEntry[]>;
+    /**
+     * Required unified entry point. v1 Claude-Code:
+     *   - `kind: 'rename'` — REFUSED. A thin {from, to} pair cannot
+     *     reconstruct the `InventoryEntry` Wave 2's `applyRename` needs;
+     *     a raw `fs.rename` would bypass the backup + namespace ledger.
+     *     Callers must use the `applyRename(entry, newName, opts)`
+     *     convenience wrapper. The shape stays in the union for v2
+     *     adapters that own their own audit-history.
+     *   - `kind: 'inline-edit'` with `searchMode: 'literal'` — translates
+     *     to a `RecommendedEdit` and dispatches to Wave 3
+     *     `applyRecommendedEdit`. Requires `auditId` + `pattern`.
+     *   - `kind: 'inline-edit'` with `searchMode: 'regex'` — rejected
+     *     with `namespace.adapter.unsupported_search_mode`.
+     */
+    applyAction(action: AdapterAction): Promise<void>;
+    /**
+     * Convenience wrapper for the common `claude-code` rename flow:
+     * builds a `FileRenameAction` and forwards. v1 Claude-Code wraps
+     * Wave 2's `applyRename` (full backup + ledger append + atomic
+     * rename). Optional on the interface — v2 adapters that don't have
+     * a per-file rename concept (Cursor) may omit it.
+     */
+    applyRename?(entry: InventoryEntry, newName: string, opts: {
+        auditId: string;
+    }): Promise<void>;
+    /**
+     * Convenience wrapper for Wave 3's prose-edit surface. v1
+     * Claude-Code builds an `InlineEditAction` with
+     * `searchMode: 'literal'` from the `RecommendedEdit` shape and
+     * forwards to `applyAction`.
+     */
+    applyEdit?(edit: RecommendedEdit, opts: {
+        auditId: string;
+    }): Promise<void>;
+}
+//# sourceMappingURL=framework-adapter.types.d.ts.map

package/dist/src/audit/framework-adapter.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"framework-adapter.types.d.ts","sourceRoot":"","sources":["../../../src/audit/framework-adapter.types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAA;AACvE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAA;AAEhE;;;;;GAKG;AACH,MAAM,MAAM,aAAa,GACrB,aAAa,GAEb,QAAQ,GACR,SAAS,GACT,OAAO,GACP,UAAU,GACV,OAAO,CAAA;AAEX;;;;;;;;;GASG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,QAAQ,CAAA;IACd,+BAA+B;IAC/B,IAAI,EAAE,MAAM,CAAA;IACZ,8BAA8B;IAC9B,EAAE,EAAE,MAAM,CAAA;IACV;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,aAAa,CAAA;IACnB,2CAA2C;IAC3C,QAAQ,EAAE,MAAM,CAAA;IAChB;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAA;IACd,wBAAwB;IACxB,OAAO,EAAE,MAAM,CAAA;IACf;;;;OAIG;IACH,UAAU,EAAE,SAAS,GAAG,OAAO,CAAA;IAC/B;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,eAAe,CAAC,SAAS,CAAC,CAAA;CACrC;AAED;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG,gBAAgB,GAAG,gBAAgB,CAAA;AAE/D;;;;;;;GAOG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,aAAa,CAAA;IACnB,4DAA4D;IAC5D,cAAc,IAAI,MAAM,EAAE,CAAA;IAC1B;;;OAGG;IACH,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAAA;IAC1E;;;;;;;;;;;;;OAaG;IACH,WAAW,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACjD;;;;;;OAMG;IACH,WAAW,CAAC,CAAC,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC9F;;;;;OAKG;IACH,SAAS,CAAC,CAAC,IAAI,EAAE,eAAe,EAAE,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAC5E"}

package/dist/src/audit/framework-adapter.types.js

@@ -0,0 +1,31 @@
+/**
+ * @fileoverview Type vocabulary for the FrameworkAdapter seam — v1 ships
+ *               `claude-code` only; v2 reserves `cursor`, `copilot`, `aider`,
+ *               `continue`, `cline`. Defines `AdapterAction` (discriminated
+ *               union over `FileRenameAction` + `InlineEditAction`) and the
+ *               adapter interface.
+ * @module @skillsmith/mcp-server/audit/framework-adapter.types
+ *
+ * Plan: docs/internal/implementation/smi-4590-cli-mcp-framework-adapter.md §1, §5.
+ *
+ * Why this seam exists (per plan §5): `.cursorrules` (Cursor v2) is a
+ * monolithic file with multiple trigger phrases inside a single file; a
+ * `FileRenameAction`-only shape would break Cursor support. Shipping
+ * `InlineEditAction` from v1 is a forcing function that lets v2 swap in
+ * `cursorAdapter` without refactoring call sites.
+ *
+ * v1 contract (claudeCodeAdapter):
+ *   - `FileRenameAction` is supported via convenience wrapper `applyRename`
+ *     which performs the full Wave 2 `applyRename` flow (backup + ledger
+ *     append + atomic rename). The bare `applyAction({kind:'rename'})`
+ *     entry point is a raw transport seam (forward-compat for v2 adapters
+ *     that own their own audit-history); v1 callers should prefer the
+ *     `applyRename` wrapper which threads `auditId` through correctly.
+ *   - `InlineEditAction` with `searchMode: 'literal'` translates to a
+ *     `RecommendedEdit` and dispatches to Wave 3's `applyRecommendedEdit`.
+ *   - `InlineEditAction` with `searchMode: 'regex'` is rejected with the
+ *     typed error `namespace.adapter.unsupported_search_mode`. Reserved
+ *     for v2 cursorAdapter.
+ */
+export {};
+//# sourceMappingURL=framework-adapter.types.js.map

package/dist/src/audit/framework-adapter.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"framework-adapter.types.js","sourceRoot":"","sources":["../../../src/audit/framework-adapter.types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG"}

package/dist/src/audit/index.d.ts

@@ -0,0 +1,46 @@
+/**
+ * @fileoverview Public barrel for the consumer-namespace audit module
+ *               (SMI-4587 Wave 1 Step 9). Wave 2/3/4 callers import from
+ *               this entrypoint instead of reaching into individual files.
+ * @module @skillsmith/mcp-server/audit
+ *
+ * Surface:
+ *   - Detection:   `detectCollisions`, kind-specific helpers
+ *   - History:     `writeAuditHistory`, `readAuditHistory`, `newAuditId`
+ *   - Report:      `writeAuditReport`, `renderAuditReport`
+ *   - Telemetry:   `emitAuditCompleteEvent`
+ *   - Bootstrap:   `bootstrapUnmanagedSkills`, `isUnmanagedSkill`
+ *   - Types:       `InventoryAuditResult`, collision flag types, branded ids
+ */
+export { bootstrapUnmanagedSkills, detectCollisions, detectExactCollisions, detectGenericTokenFlags, getLastBootstrapWarnings, isUnmanagedSkill, } from './collision-detector.js';
+export type { BootstrapFn, DetectCollisionsOptions } from './collision-detector.js';
+export { deriveCollisionId, hasClaudeMdEntries, newAuditId, readAuditHistory, writeAuditHistory, } from './audit-history.js';
+export type { AuditHistoryOptions, WriteAuditHistoryResult } from './audit-history.js';
+export { renderAuditReport, writeAuditReport } from './audit-report-writer.js';
+export type { AuditReportRenderOptions, AuditReportWriteOptions, AuditReportWriteResult, } from './audit-report-writer.js';
+export { emitAuditCompleteEvent } from '../tools/namespace-audit/telemetry.js';
+export type { AuditCompleteContext, AuditCompleteTelemetryOptions, } from '../tools/namespace-audit/telemetry.js';
+export type { AuditId, CollisionId, ExactCollisionFlag, GenericTokenFlag, InventoryAuditResult, SemanticCollisionFlag, } from './collision-detector.types.js';
+export { appendOverride, findOverride, readLedger, readLedgerResult, writeLedger, } from './namespace-overrides.js';
+export type { LedgerPathOptions } from './namespace-overrides.js';
+export { CURRENT_VERSION as NAMESPACE_OVERRIDES_CURRENT_VERSION } from './namespace-overrides.types.js';
+export type { LedgerVersion, LedgerVersionUnsupportedError, OverrideRecord, OverridesLedger, ReadLedgerResult, } from './namespace-overrides.types.js';
+export type { NamespaceWarning, PendingCollision } from './namespace-audit.types.js';
+export { applyRename, generateSuggestionChain, REVERT_SUMMARY_PREFIX } from './rename-engine.js';
+export type { ApplyRenameRequest, ApplyRenameResult, RenameAction, RenameActionRequest, RenameError, RenameSuggestion, SuggestionChain, } from './rename-engine.types.js';
+export { runInstallPreflight } from './install-preflight.js';
+export type { CandidateSkill, RunInstallPreflightInput, RunInstallPreflightResult, } from './install-preflight.js';
+export { runBackupGC } from '../tools/install.backup-gc.js';
+export type { RunBackupGCOptions, RunBackupGCResult } from '../tools/install.backup-gc.js';
+export { runEditSuggester, V1_TEMPLATE_PATTERNS } from './edit-suggester.js';
+export type { EditCategory, EditTemplate, EditTemplatePattern, RecommendedEdit, } from './edit-suggester.types.js';
+export { APPLY_TEMPLATE_REGISTRY, applyRecommendedEdit } from './edit-applier.js';
+export type { ApplyRecommendedEditOptions } from './edit-applier.js';
+export type { EditApplyError, EditApplyResult } from './edit-applier.types.js';
+export { claudeCodeAdapter, FrameworkAdapterError } from './framework-adapter.js';
+export type { AdapterAction, FileRenameAction, FrameworkAdapter, FrameworkName, InlineEditAction, } from './framework-adapter.types.js';
+export { runInventoryAudit } from './run-inventory-audit.js';
+export type { RunInventoryAuditOptions, RunInventoryAuditResult } from './run-inventory-audit.js';
+export { readAuditSuggestions, writeAuditSuggestions } from './audit-suggestions.js';
+export type { AuditSuggestionsFile, AuditSuggestionsOptions } from './audit-suggestions.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/audit/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/audit/index.ts"],"names":[],"mappings":"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"}

package/dist/src/audit/index.js

@@ -0,0 +1,44 @@
+/**
+ * @fileoverview Public barrel for the consumer-namespace audit module
+ *               (SMI-4587 Wave 1 Step 9). Wave 2/3/4 callers import from
+ *               this entrypoint instead of reaching into individual files.
+ * @module @skillsmith/mcp-server/audit
+ *
+ * Surface:
+ *   - Detection:   `detectCollisions`, kind-specific helpers
+ *   - History:     `writeAuditHistory`, `readAuditHistory`, `newAuditId`
+ *   - Report:      `writeAuditReport`, `renderAuditReport`
+ *   - Telemetry:   `emitAuditCompleteEvent`
+ *   - Bootstrap:   `bootstrapUnmanagedSkills`, `isUnmanagedSkill`
+ *   - Types:       `InventoryAuditResult`, collision flag types, branded ids
+ */
+export { bootstrapUnmanagedSkills, detectCollisions, detectExactCollisions, detectGenericTokenFlags, getLastBootstrapWarnings, isUnmanagedSkill, } from './collision-detector.js';
+export { deriveCollisionId, hasClaudeMdEntries, newAuditId, readAuditHistory, writeAuditHistory, } from './audit-history.js';
+export { renderAuditReport, writeAuditReport } from './audit-report-writer.js';
+export { emitAuditCompleteEvent } from '../tools/namespace-audit/telemetry.js';
+// SMI-4588 Wave 2 PR #1 — namespace-overrides ledger surface.
+export { appendOverride, findOverride, readLedger, readLedgerResult, writeLedger, } from './namespace-overrides.js';
+export { CURRENT_VERSION as NAMESPACE_OVERRIDES_CURRENT_VERSION } from './namespace-overrides.types.js';
+// SMI-4588 Wave 2 PR #2 — rename engine + suggestion chain.
+export { applyRename, generateSuggestionChain, REVERT_SUMMARY_PREFIX } from './rename-engine.js';
+// SMI-4588 Wave 2 PR #3 — install pre-flight.
+export { runInstallPreflight } from './install-preflight.js';
+// SMI-4588 Wave 2 PR #4 — backup garbage collector. Re-exported via the
+// audit barrel so Wave 4's session-start audit hook can import the
+// helper without reaching into `tools/`.
+export { runBackupGC } from '../tools/install.backup-gc.js';
+// SMI-4589 Wave 3 — edit-suggester (templated prose-edit recommendations
+// for `description_overlap` semantic collisions).
+export { runEditSuggester, V1_TEMPLATE_PATTERNS } from './edit-suggester.js';
+// SMI-4589 Wave 3 — edit-applier (mutation path for the registered
+// `add_domain_qualifier` template, gated by APPLY_TEMPLATE_REGISTRY).
+export { APPLY_TEMPLATE_REGISTRY, applyRecommendedEdit } from './edit-applier.js';
+// SMI-4590 Wave 4 PR 2/6 — FrameworkAdapter seam + claudeCodeAdapter (v1).
+export { claudeCodeAdapter, FrameworkAdapterError } from './framework-adapter.js';
+// SMI-4590 Wave 4 PR 4/6 — shared `runInventoryAudit` composition helper
+// + per-audit suggestion persistence. Consumed by the MCP tool surface
+// (`skill_inventory_audit`) and (PR 5) the CLI `sklx audit collisions`
+// command.
+export { runInventoryAudit } from './run-inventory-audit.js';
+export { readAuditSuggestions, writeAuditSuggestions } from './audit-suggestions.js';
+//# sourceMappingURL=index.js.map

package/dist/src/audit/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/audit/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EACL,wBAAwB,EACxB,gBAAgB,EAChB,qBAAqB,EACrB,uBAAuB,EACvB,wBAAwB,EACxB,gBAAgB,GACjB,MAAM,yBAAyB,CAAA;AAIhC,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,UAAU,EACV,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,oBAAoB,CAAA;AAI3B,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAA;AAQ9E,OAAO,EAAE,sBAAsB,EAAE,MAAM,uCAAuC,CAAA;AAe9E,8DAA8D;AAC9D,OAAO,EACL,cAAc,EACd,YAAY,EACZ,UAAU,EACV,gBAAgB,EAChB,WAAW,GACZ,MAAM,0BAA0B,CAAA;AAIjC,OAAO,EAAE,eAAe,IAAI,mCAAmC,EAAE,MAAM,gCAAgC,CAAA;AAavG,4DAA4D;AAC5D,OAAO,EAAE,WAAW,EAAE,uBAAuB,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAA;AAYhG,8CAA8C;AAC9C,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAA;AAQ5D,wEAAwE;AACxE,mEAAmE;AACnE,yCAAyC;AACzC,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAA;AAI3D,yEAAyE;AACzE,kDAAkD;AAClD,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAA;AAS5E,mEAAmE;AACnE,sEAAsE;AACtE,OAAO,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAA;AAMjF,2EAA2E;AAC3E,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAA;AAUjF,yEAAyE;AACzE,uEAAuE;AACvE,uEAAuE;AACvE,WAAW;AACX,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAA;AAI5D,OAAO,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAA"}