@skillsmith/mcp-server 0.4.13 → 0.5.0

package/dist/src/utils/local-inventory.helpers.js

@@ -0,0 +1,279 @@
+/**
+ * @fileoverview Helpers for the local-inventory scanner (SMI-4587 Wave 1 Step 2).
+ * @module @skillsmith/mcp-server/utils/local-inventory.helpers
+ *
+ * Pure functions extracted to keep `local-inventory.ts` thin. CLAUDE.md
+ * regex extraction lives here so the regex behavior can be tested in
+ * isolation. Frontmatter helpers wrap the existing `parseYamlFrontmatter`.
+ */
+import * as crypto from 'node:crypto';
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { parseYamlFrontmatter } from '../tools/validate.helpers.js';
+/**
+ * Stable warning code catalog. Keep this in sync with the writer; the audit
+ * report renders messages keyed off `code`.
+ */
+export const WARNING_CODES = {
+    TRIGGER_SURFACE_TRUNCATED: 'namespace.inventory.trigger_surface_truncated',
+    BOOTSTRAP_FAILED: 'namespace.inventory.bootstrap_failed',
+    CLAUDE_MD_RECALL_LOW: 'namespace.inventory.claude_md_recall_low',
+    REGEX_EXTRACTION_SKIPPED: 'namespace.inventory.regex_extraction_skipped',
+    UNMANAGED_SKILL_BOOTSTRAPPED: 'namespace.inventory.unmanaged_skill_bootstrapped',
+    PARSE_FAILED: 'namespace.inventory.parse_failed',
+};
+/** Maximum trigger phrases retained per entry — matches `OverlapDetector.MAX_TRIGGER_PHRASES_PER_SKILL`. */
+export const MAX_TRIGGER_PHRASES_PER_SKILL = 50;
+/**
+ * Cap an array of trigger phrases at MAX_TRIGGER_PHRASES_PER_SKILL. When
+ * truncation occurs, append a warning of code `trigger_surface_truncated`
+ * with the dropped count so the user sees it in the audit report.
+ */
+export function capTriggerSurface(identifier, phrases, warnings) {
+    if (phrases.length <= MAX_TRIGGER_PHRASES_PER_SKILL) {
+        return phrases;
+    }
+    warnings.push({
+        code: WARNING_CODES.TRIGGER_SURFACE_TRUNCATED,
+        message: `triggerSurface for "${identifier}" was capped at ${MAX_TRIGGER_PHRASES_PER_SKILL} phrases (${phrases.length - MAX_TRIGGER_PHRASES_PER_SKILL} dropped)`,
+        context: {
+            entry_identifier: identifier,
+            dropped_count: phrases.length - MAX_TRIGGER_PHRASES_PER_SKILL,
+        },
+    });
+    return phrases.slice(0, MAX_TRIGGER_PHRASES_PER_SKILL);
+}
+/**
+ * Split a description into sentence-level trigger phrases. Empty or
+ * whitespace-only segments are filtered.
+ */
+export function splitDescriptionToPhrases(description) {
+    if (!description)
+        return [];
+    // Split on sentence terminators; tolerate runs of whitespace and trailing
+    // punctuation. Not a strict NLP tokenizer — close-enough for trigger surface.
+    return description
+        .split(/[.!?\n]+/)
+        .map((s) => s.trim())
+        .filter((s) => s.length > 0);
+}
+/**
+ * Read the YAML frontmatter from a `.md` file. Returns `{}` if no
+ * frontmatter or the file cannot be parsed.
+ */
+export function readFrontmatter(filePath) {
+    try {
+        const content = fs.readFileSync(filePath, 'utf-8');
+        return parseYamlFrontmatter(content) ?? {};
+    }
+    catch {
+        return {};
+    }
+}
+/**
+ * Extract the body of a `.md` file (everything after the closing
+ * frontmatter delimiter, or the full content if no frontmatter).
+ */
+export function readBody(filePath) {
+    try {
+        const content = fs.readFileSync(filePath, 'utf-8');
+        if (!content.startsWith('---'))
+            return content;
+        const end = content.indexOf('---', 3);
+        if (end === -1)
+            return content;
+        return content.slice(end + 3).trimStart();
+    }
+    catch {
+        return '';
+    }
+}
+/**
+ * Pull the first non-empty line from a body string. Used as the fallback
+ * trigger surface for frontmatter-less command files.
+ */
+export function firstNonEmptyLine(body) {
+    for (const line of body.split('\n')) {
+        const trimmed = line.trim();
+        if (trimmed)
+            return trimmed;
+    }
+    return '';
+}
+/**
+ * Stable identifier for a CLAUDE.md trigger line. The identifier doubles as
+ * dedup key — two scans of the same line produce the same id. Hashed
+ * because the line itself can be long; first 12 hex chars are sufficient.
+ */
+export function hashClaudeMdLine(claudeMdPath, line) {
+    const norm = line.trim().toLowerCase();
+    const hash = crypto
+        .createHash('sha256')
+        .update(`${claudeMdPath}:${norm}`)
+        .digest('hex')
+        .slice(0, 12);
+    return `claude_md:${hash}`;
+}
+/**
+ * Best-effort regex extractor for CLAUDE.md trigger phrases.
+ *
+ * Two patterns are recognized (per Wave 0 spike goal #3):
+ *
+ * 1. Bullet items under headings matching
+ *    `/^#{1,3}\s*(Trigger phrases|Use when|Skills)\b/i`. Recall is
+ *    best-effort — false negatives expected for non-standard heading text.
+ * 2. Any line containing the high-confidence marker
+ *    `<!-- skillsmith:trigger -->`. The full line is captured as a phrase.
+ *
+ * Returns one `InventoryEntry` per extracted line. Failures (file missing,
+ * unparseable) emit a `warnings[]` entry — never throw.
+ */
+export function extractClaudeMdTriggers(claudeMdPath, warnings) {
+    let content;
+    try {
+        content = fs.readFileSync(claudeMdPath, 'utf-8');
+    }
+    catch {
+        // Missing file is silent (no CLAUDE.md is a normal state).
+        return [];
+    }
+    const entries = [];
+    let stat;
+    try {
+        stat = fs.statSync(claudeMdPath);
+    }
+    catch {
+        stat = undefined;
+    }
+    let captureMode = 'idle';
+    let lines;
+    try {
+        lines = content.split('\n');
+    }
+    catch {
+        warnings.push({
+            code: WARNING_CODES.REGEX_EXTRACTION_SKIPPED,
+            message: `CLAUDE.md at ${claudeMdPath} unparseable; trigger-phrase scan skipped`,
+            context: { path: claudeMdPath },
+        });
+        return [];
+    }
+    // Headings considered as trigger sections. Case-insensitive, allow up to
+    // three leading hashes (per spec line 104).
+    const headingRe = /^#{1,3}\s*(Trigger phrases|Use when|Skills)\b/i;
+    const otherHeadingRe = /^#{1,6}\s+/;
+    const bulletRe = /^[-*]\s+(.+)$/;
+    const markerRe = /<!--\s*skillsmith:trigger\s*-->/;
+    for (const rawLine of lines) {
+        const line = rawLine.trim();
+        if (markerRe.test(line)) {
+            // High-confidence marker line — capture the whole line minus the marker.
+            const phrase = line.replace(markerRe, '').trim();
+            if (phrase) {
+                entries.push(makeClaudeMdEntry(claudeMdPath, phrase, stat?.mtimeMs));
+            }
+            continue;
+        }
+        if (headingRe.test(line)) {
+            captureMode = 'heading';
+            continue;
+        }
+        // Reset capture mode on any other heading.
+        if (otherHeadingRe.test(line)) {
+            captureMode = 'idle';
+            continue;
+        }
+        if (captureMode === 'heading') {
+            const m = bulletRe.exec(line);
+            if (m && m[1]) {
+                const phrase = m[1].trim();
+                if (phrase) {
+                    entries.push(makeClaudeMdEntry(claudeMdPath, phrase, stat?.mtimeMs));
+                }
+            }
+        }
+    }
+    return entries;
+}
+function makeClaudeMdEntry(claudeMdPath, phrase, mtime) {
+    return {
+        kind: 'claude_md_rule',
+        source_path: claudeMdPath,
+        identifier: hashClaudeMdLine(claudeMdPath, phrase),
+        triggerSurface: [phrase],
+        mtime,
+        meta: { description: phrase },
+    };
+}
+/**
+ * Resolve `~/.skillsmith/manifest.json` and return the parsed object, or
+ * `null` if absent / unreadable. Scanner uses this to populate
+ * `entry.meta.author` for installed skills.
+ */
+export function loadManifest(manifestPath) {
+    try {
+        if (!fs.existsSync(manifestPath))
+            return null;
+        const raw = fs.readFileSync(manifestPath, 'utf-8');
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Look up an `author` (and `tags`) for a given skill identifier in the
+ * manifest. Manifest shape varies — be tolerant: walk the top-level keys
+ * and any obvious `skills` array/object.
+ */
+export function lookupAuthor(manifest, identifier) {
+    if (!manifest)
+        return {};
+    // Many manifest shapes possible; check common ones.
+    const skills = (manifest.skills ?? manifest.installed);
+    if (Array.isArray(skills)) {
+        for (const s of skills) {
+            if (s &&
+                typeof s === 'object' &&
+                (s.id === identifier ||
+                    s.name === identifier)) {
+                const rec = s;
+                return {
+                    author: typeof rec.author === 'string' ? rec.author : undefined,
+                    tags: Array.isArray(rec.tags) ? rec.tags : undefined,
+                };
+            }
+        }
+    }
+    if (skills && typeof skills === 'object') {
+        const rec = skills[identifier];
+        if (rec && typeof rec === 'object') {
+            const r = rec;
+            return {
+                author: typeof r.author === 'string' ? r.author : undefined,
+                tags: Array.isArray(r.tags) ? r.tags : undefined,
+            };
+        }
+    }
+    return {};
+}
+/**
+ * Cross-platform mtime read. Returns `undefined` on stat failure rather
+ * than throwing — mtime is informational for ordering, not load-bearing.
+ */
+export function readMtime(filePath) {
+    try {
+        return fs.statSync(filePath).mtimeMs;
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Resolve absolute path joining `dir + filename`. Centralized so future
+ * portability work (E-ANTI-1 v2) can swap in a relative-to-home derivation.
+ */
+export function joinPath(dir, filename) {
+    return path.join(dir, filename);
+}
+//# sourceMappingURL=local-inventory.helpers.js.map

package/dist/src/utils/local-inventory.helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-inventory.helpers.js","sourceRoot":"","sources":["../../../src/utils/local-inventory.helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AACrC,OAAO,KAAK,EAAE,MAAM,SAAS,CAAA;AAC7B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAA;AAEjC,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAA;AAGnE;;;GAGG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,yBAAyB,EAAE,+CAA+C;IAC1E,gBAAgB,EAAE,sCAAsC;IACxD,oBAAoB,EAAE,0CAA0C;IAChE,wBAAwB,EAAE,8CAA8C;IACxE,4BAA4B,EAAE,kDAAkD;IAChF,YAAY,EAAE,kCAAkC;CACxC,CAAA;AAEV,4GAA4G;AAC5G,MAAM,CAAC,MAAM,6BAA6B,GAAG,EAAE,CAAA;AAE/C;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAC/B,UAAkB,EAClB,OAAiB,EACjB,QAAuB;IAEvB,IAAI,OAAO,CAAC,MAAM,IAAI,6BAA6B,EAAE,CAAC;QACpD,OAAO,OAAO,CAAA;IAChB,CAAC;IAED,QAAQ,CAAC,IAAI,CAAC;QACZ,IAAI,EAAE,aAAa,CAAC,yBAAyB;QAC7C,OAAO,EAAE,uBAAuB,UAAU,mBAAmB,6BAA6B,aAAa,OAAO,CAAC,MAAM,GAAG,6BAA6B,WAAW;QAChK,OAAO,EAAE;YACP,gBAAgB,EAAE,UAAU;YAC5B,aAAa,EAAE,OAAO,CAAC,MAAM,GAAG,6BAA6B;SAC9D;KACF,CAAC,CAAA;IAEF,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,6BAA6B,CAAC,CAAA;AACxD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,yBAAyB,CAAC,WAA+B;IACvE,IAAI,CAAC,WAAW;QAAE,OAAO,EAAE,CAAA;IAC3B,0EAA0E;IAC1E,8EAA8E;IAC9E,OAAO,WAAW;SACf,KAAK,CAAC,UAAU,CAAC;SACjB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;SACpB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;AAChC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,QAAgB;IAC9C,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;QAClD,OAAO,oBAAoB,CAAC,OAAO,CAAC,IAAI,EAAE,CAAA;IAC5C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAA;IACX,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,QAAQ,CAAC,QAAgB;IACvC,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;QAClD,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC;YAAE,OAAO,OAAO,CAAA;QAC9C,MAAM,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAA;QACrC,IAAI,GAAG,KAAK,CAAC,CAAC;YAAE,OAAO,OAAO,CAAA;QAC9B,OAAO,OAAO,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,SAAS,EAAE,CAAA;IAC3C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAA;IACX,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACpC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAA;QAC3B,IAAI,OAAO;YAAE,OAAO,OAAO,CAAA;IAC7B,CAAC;IACD,OAAO,EAAE,CAAA;AACX,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,YAAoB,EAAE,IAAY;IACjE,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAA;IACtC,MAAM,IAAI,GAAG,MAAM;SAChB,UAAU,CAAC,QAAQ,CAAC;SACpB,MAAM,CAAC,GAAG,YAAY,IAAI,IAAI,EAAE,CAAC;SACjC,MAAM,CAAC,KAAK,CAAC;SACb,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;IACf,OAAO,aAAa,IAAI,EAAE,CAAA;AAC5B,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,uBAAuB,CACrC,YAAoB,EACpB,QAAuB;IAEvB,IAAI,OAAe,CAAA;IACnB,IAAI,CAAC;QACH,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAA;IAClD,CAAC;IAAC,MAAM,CAAC;QACP,2DAA2D;QAC3D,OAAO,EAAE,CAAA;IACX,CAAC;IAED,MAAM,OAAO,GAAqB,EAAE,CAAA;IACpC,IAAI,IAA0B,CAAA;IAC9B,IAAI,CAAC;QACH,IAAI,GAAG,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAA;IAClC,CAAC;IAAC,MAAM,CAAC;QACP,IAAI,GAAG,SAAS,CAAA;IAClB,CAAC;IAED,IAAI,WAAW,GAAkC,MAAM,CAAA;IACvD,IAAI,KAAe,CAAA;IACnB,IAAI,CAAC;QACH,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IAC7B,CAAC;IAAC,MAAM,CAAC;QACP,QAAQ,CAAC,IAAI,CAAC;YACZ,IAAI,EAAE,aAAa,CAAC,wBAAwB;YAC5C,OAAO,EAAE,gBAAgB,YAAY,2CAA2C;YAChF,OAAO,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE;SAChC,CAAC,CAAA;QACF,OAAO,EAAE,CAAA;IACX,CAAC;IAED,yEAAyE;IACzE,4CAA4C;IAC5C,MAAM,SAAS,GAAG,gDAAgD,CAAA;IAClE,MAAM,cAAc,GAAG,YAAY,CAAA;IACnC,MAAM,QAAQ,GAAG,eAAe,CAAA;IAChC,MAAM,QAAQ,GAAG,iCAAiC,CAAA;IAElD,KAAK,MAAM,OAAO,IAAI,KAAK,EAAE,CAAC;QAC5B,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,EAAE,CAAA;QAE3B,IAAI,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACxB,yEAAyE;YACzE,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAA;YAChD,IAAI,MAAM,EAAE,CAAC;gBACX,OAAO,CAAC,IAAI,CAAC,iBAAiB,CAAC,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAA;YACtE,CAAC;YACD,SAAQ;QACV,CAAC;QAED,IAAI,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACzB,WAAW,GAAG,SAAS,CAAA;YACvB,SAAQ;QACV,CAAC;QAED,2CAA2C;QAC3C,IAAI,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAC9B,WAAW,GAAG,MAAM,CAAA;YACpB,SAAQ;QACV,CAAC;QAED,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;YAC9B,MAAM,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;YAC7B,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;gBACd,MAAM,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAA;gBAC1B,IAAI,MAAM,EAAE,CAAC;oBACX,OAAO,CAAC,IAAI,CAAC,iBAAiB,CAAC,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAA;gBACtE,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAA;AAChB,CAAC;AAED,SAAS,iBAAiB,CACxB,YAAoB,EACpB,MAAc,EACd,KAAyB;IAEzB,OAAO;QACL,IAAI,EAAE,gBAAgB;QACtB,WAAW,EAAE,YAAY;QACzB,UAAU,EAAE,gBAAgB,CAAC,YAAY,EAAE,MAAM,CAAC;QAClD,cAAc,EAAE,CAAC,MAAM,CAAC;QACxB,KAAK;QACL,IAAI,EAAE,EAAE,WAAW,EAAE,MAAM,EAAE;KAC9B,CAAA;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,YAAoB;IAC/C,IAAI,CAAC;QACH,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC;YAAE,OAAO,IAAI,CAAA;QAC7C,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAA;QAClD,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAA4B,CAAA;IACnD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAA;IACb,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAC1B,QAAwC,EACxC,UAAkB;IAElB,IAAI,CAAC,QAAQ;QAAE,OAAO,EAAE,CAAA;IAExB,oDAAoD;IACpD,MAAM,MAAM,GAAG,CAAC,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,SAAS,CAAY,CAAA;IACjE,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAC1B,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;YACvB,IACE,CAAC;gBACD,OAAO,CAAC,KAAK,QAAQ;gBACrB,CAAE,CAA6B,CAAC,EAAE,KAAK,UAAU;oBAC9C,CAA6B,CAAC,IAAI,KAAK,UAAU,CAAC,EACrD,CAAC;gBACD,MAAM,GAAG,GAAG,CAA4B,CAAA;gBACxC,OAAO;oBACL,MAAM,EAAE,OAAO,GAAG,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS;oBAC/D,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAE,GAAG,CAAC,IAAiB,CAAC,CAAC,CAAC,SAAS;iBACnE,CAAA;YACH,CAAC;QACH,CAAC;IACH,CAAC;IACD,IAAI,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QACzC,MAAM,GAAG,GAAI,MAAkC,CAAC,UAAU,CAAC,CAAA;QAC3D,IAAI,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;YACnC,MAAM,CAAC,GAAG,GAA8B,CAAA;YACxC,OAAO;gBACL,MAAM,EAAE,OAAO,CAAC,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS;gBAC3D,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAE,CAAC,CAAC,IAAiB,CAAC,CAAC,CAAC,SAAS;aAC/D,CAAA;QACH,CAAC;IACH,CAAC;IACD,OAAO,EAAE,CAAA;AACX,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,QAAgB;IACxC,IAAI,CAAC;QACH,OAAO,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAA;IACtC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAA;IAClB,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,QAAQ,CAAC,GAAW,EAAE,QAAgB;IACpD,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAA;AACjC,CAAC"}

package/dist/src/utils/local-inventory.js

@@ -0,0 +1,202 @@
+/**
+ * @fileoverview Local-inventory scanner for the consumer namespace audit.
+ * @module @skillsmith/mcp-server/utils/local-inventory
+ * @see SMI-4587 Wave 1 Step 2 — scan ~/.claude/{skills,commands,agents} +
+ *      CLAUDE.md trigger phrases into a unified InventoryEntry[].
+ *
+ * Each source is independent — failure in one does not fail the others.
+ * The scanner is read-only; bootstrapping unmanaged skills via `index_local`
+ * is wired in a subsequent PR (Step 6a).
+ */
+import * as fs from 'node:fs';
+import * as os from 'node:os';
+import * as path from 'node:path';
+import { WARNING_CODES, capTriggerSurface, extractClaudeMdTriggers, firstNonEmptyLine, loadManifest, lookupAuthor, readBody, readFrontmatter, readMtime, splitDescriptionToPhrases, } from './local-inventory.helpers.js';
+const DEFAULT_HOME_CLAUDE_DIR = path.join(os.homedir(), '.claude');
+const DEFAULT_MANIFEST_PATH = path.join(os.homedir(), '.skillsmith', 'manifest.json');
+/**
+ * Scan `~/.claude/{skills,commands,agents}` and CLAUDE.md trigger phrases.
+ *
+ * Returns `entries[]` sorted by `kind` then `identifier`, plus any soft
+ * `warnings[]` raised during scanning. `durationMs` measures wall-clock
+ * time for the whole scan (excluding the optional bootstrap step that
+ * lands in a subsequent PR).
+ */
+export async function scanLocalInventory(opts = {}) {
+    const startedAt = process.hrtime.bigint();
+    const homeDir = opts.homeDir ?? os.homedir();
+    const claudeDir = opts.homeDir ? path.join(opts.homeDir, '.claude') : DEFAULT_HOME_CLAUDE_DIR;
+    const manifestPath = opts.manifestPath ?? DEFAULT_MANIFEST_PATH;
+    const warnings = [];
+    const entries = [];
+    const manifest = loadManifest(manifestPath);
+    // Source 1: ~/.claude/skills/*/SKILL.md
+    entries.push(...scanSkills(path.join(claudeDir, 'skills'), manifest, warnings));
+    // Source 2: ~/.claude/commands/*.md
+    entries.push(...scanCommands(path.join(claudeDir, 'commands'), warnings));
+    // Source 3: ~/.claude/agents/*.md
+    entries.push(...scanAgents(path.join(claudeDir, 'agents'), warnings));
+    // Source 4: ~/.claude/CLAUDE.md and (optional) project CLAUDE.md
+    const userClaudeMd = path.join(claudeDir, 'CLAUDE.md');
+    if (fs.existsSync(userClaudeMd)) {
+        entries.push(...extractClaudeMdTriggers(userClaudeMd, warnings));
+    }
+    if (opts.projectDir) {
+        const projectClaudeMd = path.join(opts.projectDir, 'CLAUDE.md');
+        if (fs.existsSync(projectClaudeMd)) {
+            entries.push(...extractClaudeMdTriggers(projectClaudeMd, warnings));
+        }
+    }
+    // Stable ordering for downstream consumers.
+    entries.sort((a, b) => {
+        if (a.kind !== b.kind)
+            return a.kind.localeCompare(b.kind);
+        return a.identifier.localeCompare(b.identifier);
+    });
+    const elapsedNs = process.hrtime.bigint() - startedAt;
+    const durationMs = Number(elapsedNs) / 1_000_000;
+    // Suppress unused-variable warning while keeping the homeDir resolution
+    // visible in opts handling above. Reserved for future per-OS path logic.
+    void homeDir;
+    return { entries, warnings, durationMs };
+}
+/**
+ * Scan `~/.claude/skills/*` for SKILL.md frontmatter. Returns one entry
+ * per directory; entries without SKILL.md are still recorded (with
+ * directory-name fallback) so the collision detector still sees them.
+ */
+function scanSkills(skillsDir, manifest, warnings) {
+    if (!fs.existsSync(skillsDir))
+        return [];
+    const out = [];
+    let dirEntries;
+    try {
+        dirEntries = fs.readdirSync(skillsDir, { withFileTypes: true });
+    }
+    catch {
+        return [];
+    }
+    for (const dirent of dirEntries) {
+        if (!dirent.isDirectory() || dirent.name.startsWith('.'))
+            continue;
+        const skillDir = path.join(skillsDir, dirent.name);
+        const skillMd = path.join(skillDir, 'SKILL.md');
+        let identifier = dirent.name;
+        let description;
+        let mtime;
+        if (fs.existsSync(skillMd)) {
+            const fm = readFrontmatter(skillMd);
+            const fmName = typeof fm.name === 'string' ? fm.name : undefined;
+            if (fmName && fmName.trim())
+                identifier = fmName.trim();
+            const fmDesc = coerceDescription(fm.description);
+            if (fmDesc)
+                description = fmDesc;
+            mtime = readMtime(skillMd);
+        }
+        else {
+            // Skill directory without SKILL.md is unusual; record a soft warning
+            // so the audit report can flag it but do not block the scan.
+            warnings.push({
+                code: WARNING_CODES.PARSE_FAILED,
+                message: `skill directory ${skillDir} has no SKILL.md; using directory name as identifier`,
+                context: { path: skillDir },
+            });
+        }
+        const phrases = capTriggerSurface(identifier, [identifier, ...splitDescriptionToPhrases(description)], warnings);
+        const author = lookupAuthor(manifest, identifier);
+        out.push({
+            kind: 'skill',
+            source_path: skillMd,
+            identifier,
+            triggerSurface: phrases,
+            mtime,
+            meta: {
+                description,
+                author: author.author,
+                tags: author.tags,
+            },
+        });
+    }
+    return out;
+}
+/**
+ * Scan `~/.claude/commands/*.md`. Frontmatter `description:` wins as
+ * trigger surface; otherwise the first non-empty line of the body.
+ * Tolerates frontmatter-less files (most slash commands have none).
+ */
+function scanCommands(commandsDir, warnings) {
+    if (!fs.existsSync(commandsDir))
+        return [];
+    return scanMdDir(commandsDir, 'command', warnings);
+}
+/**
+ * Scan `~/.claude/agents/*.md`. Subagent files always carry frontmatter
+ * `description:` per Claude Code convention; surface that. Falls back to
+ * filename + body first-line if frontmatter is absent.
+ */
+function scanAgents(agentsDir, warnings) {
+    if (!fs.existsSync(agentsDir))
+        return [];
+    return scanMdDir(agentsDir, 'agent', warnings);
+}
+/**
+ * Shared scan logic for commands + agents — both follow the
+ * "filename = identifier; description from frontmatter or body" shape.
+ */
+function scanMdDir(dir, kind, warnings) {
+    const out = [];
+    let dirEntries;
+    try {
+        dirEntries = fs.readdirSync(dir, { withFileTypes: true });
+    }
+    catch {
+        return [];
+    }
+    for (const dirent of dirEntries) {
+        if (!dirent.isFile())
+            continue;
+        if (!dirent.name.endsWith('.md'))
+            continue;
+        if (dirent.name.startsWith('.'))
+            continue;
+        const filePath = path.join(dir, dirent.name);
+        const identifier = dirent.name.slice(0, -3); // strip .md
+        const fm = readFrontmatter(filePath);
+        const description = coerceDescription(fm.description);
+        let triggerLine = description ?? '';
+        if (!triggerLine) {
+            triggerLine = firstNonEmptyLine(readBody(filePath));
+        }
+        const phrases = capTriggerSurface(identifier, [identifier, ...(triggerLine ? splitDescriptionToPhrases(triggerLine) : [])], warnings);
+        out.push({
+            kind,
+            source_path: filePath,
+            identifier,
+            triggerSurface: phrases,
+            mtime: readMtime(filePath),
+            meta: {
+                description: triggerLine || undefined,
+            },
+        });
+    }
+    return out;
+}
+/**
+ * `parseYamlFrontmatter` returns `string | string[] | undefined` for
+ * description (depending on block-scalar syntax). Normalize to a single
+ * string for downstream consumers.
+ */
+function coerceDescription(value) {
+    if (typeof value === 'string')
+        return value.trim() || undefined;
+    if (Array.isArray(value)) {
+        const joined = value
+            .map((v) => (typeof v === 'string' ? v.trim() : ''))
+            .filter((v) => v.length > 0)
+            .join(' ');
+        return joined.length > 0 ? joined : undefined;
+    }
+    return undefined;
+}
+//# sourceMappingURL=local-inventory.js.map

package/dist/src/utils/local-inventory.js.map

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

package/dist/src/utils/local-inventory.types.d.ts

@@ -0,0 +1,100 @@
+/**
+ * @fileoverview Type vocabulary for the local-inventory scanner (SMI-4587 Wave 1 Step 1).
+ * @module @skillsmith/mcp-server/utils/local-inventory.types
+ *
+ * Public surface consumed by the collision-detector + audit-history modules.
+ * Wave 2/3/4 import these types — keep stable and additive.
+ */
+/**
+ * The four sources scanned by `scanLocalInventory`. Each kind carries different
+ * `triggerSurface` semantics; the collision detector handles them uniformly.
+ */
+export type InventoryKind = 'skill' | 'command' | 'agent' | 'claude_md_rule';
+/**
+ * One entry in the user's local inventory. Keyed by `kind` + `identifier`,
+ * sourced at `source_path`, with the trigger text used by the collision detector
+ * surfaced in `triggerSurface`.
+ */
+export interface InventoryEntry {
+    kind: InventoryKind;
+    /** Absolute path to the source file. */
+    source_path: string;
+    /**
+     * Skills: name from frontmatter or directory fallback.
+     * Commands / agents: filename without `.md`.
+     * `claude_md_rule`: hashed line excerpt — see helpers.ts for the derivation.
+     */
+    identifier: string;
+    /** Phrases the collision detector matches against. */
+    triggerSurface: string[];
+    /**
+     * Last-modified timestamp (Unix epoch ms) from `fs.stat`. Populated by the
+     * scanner; consumed by the audit-report writer's mtime-based collision-cluster
+     * sort (most-recent first within each severity group).
+     */
+    mtime?: number;
+    meta?: {
+        /** From `~/.skillsmith/manifest.json` if registered; else undefined. */
+        author?: string;
+        tags?: string[];
+        /** Raw description for audit-report rendering. */
+        description?: string;
+    };
+}
+/**
+ * Soft-failure signal emitted by the scanner. `code` is a stable identifier
+ * (catalog in local-inventory.helpers.ts); `context` carries structured detail.
+ */
+export interface ScanWarning {
+    /** Stable warning code; see WARNING_CODES in helpers. */
+    code: string;
+    /** Human-readable text for the audit report. */
+    message: string;
+    context?: Record<string, unknown>;
+}
+/**
+ * Output of `scanLocalInventory`. `warnings` are typed-coded objects (not
+ * strings) so report writers + telemetry can branch on `code` without parsing
+ * prose.
+ */
+export interface ScanResult {
+    entries: InventoryEntry[];
+    warnings: ScanWarning[];
+    durationMs: number;
+}
+/** Brand type for ULID-shaped audit identifiers. */
+export type AuditId = string & {
+    readonly __brand: 'AuditId';
+};
+/**
+ * Brand type for collision identifiers.
+ *
+ * Machine-local constraint (E-ANTI-1): derived from absolute filesystem paths
+ * via sha256(auditId + ':' + sortedEntryPaths.join(',')). Portability across
+ * home-directory renames is NOT supported in v1; if the user renames their
+ * home directory or moves skills, prior `namespace-overrides.json` ledger
+ * entries become unreachable. Acceptable for v1 (local-only tool); a v2
+ * follow-up will switch to a path-relative derivation.
+ */
+export type CollisionId = string & {
+    readonly __brand: 'CollisionId';
+};
+/**
+ * Exact-name collision: two or more entries share the same normalized
+ * `identifier`. Severity is always `error` — exact collisions are unambiguous.
+ *
+ * Design note (E-CONF-2): no `suggestion` field. Wave 2's rename engine
+ * generates suggestions from `ExactCollisionFlag` entries; coupling a
+ * suggestion field here would force Wave 4's display logic into the detector
+ * module, breaking detection-only separation.
+ */
+export interface ExactCollisionFlag {
+    kind: 'exact';
+    collisionId: CollisionId;
+    identifier: string;
+    /** Two or more entries colliding on the same identifier. */
+    entries: InventoryEntry[];
+    severity: 'error';
+    reason: string;
+}
+//# sourceMappingURL=local-inventory.types.d.ts.map

package/dist/src/utils/local-inventory.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-inventory.types.d.ts","sourceRoot":"","sources":["../../../src/utils/local-inventory.types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,SAAS,GAAG,OAAO,GAAG,gBAAgB,CAAA;AAE5E;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,aAAa,CAAA;IACnB,wCAAwC;IACxC,WAAW,EAAE,MAAM,CAAA;IACnB;;;;OAIG;IACH,UAAU,EAAE,MAAM,CAAA;IAClB,sDAAsD;IACtD,cAAc,EAAE,MAAM,EAAE,CAAA;IACxB;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,IAAI,CAAC,EAAE;QACL,wEAAwE;QACxE,MAAM,CAAC,EAAE,MAAM,CAAA;QACf,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;QACf,kDAAkD;QAClD,WAAW,CAAC,EAAE,MAAM,CAAA;KACrB,CAAA;CACF;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,yDAAyD;IACzD,IAAI,EAAE,MAAM,CAAA;IACZ,gDAAgD;IAChD,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAClC;AAED;;;;GAIG;AACH,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,cAAc,EAAE,CAAA;IACzB,QAAQ,EAAE,WAAW,EAAE,CAAA;IACvB,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,oDAAoD;AACpD,MAAM,MAAM,OAAO,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAA;CAAE,CAAA;AAE9D;;;;;;;;;GASG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAA;CAAE,CAAA;AAEtE;;;;;;;;GAQG;AACH,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,OAAO,CAAA;IACb,WAAW,EAAE,WAAW,CAAA;IACxB,UAAU,EAAE,MAAM,CAAA;IAClB,4DAA4D;IAC5D,OAAO,EAAE,cAAc,EAAE,CAAA;IACzB,QAAQ,EAAE,OAAO,CAAA;IACjB,MAAM,EAAE,MAAM,CAAA;CACf"}

package/dist/src/utils/local-inventory.types.js

@@ -0,0 +1,9 @@
+/**
+ * @fileoverview Type vocabulary for the local-inventory scanner (SMI-4587 Wave 1 Step 1).
+ * @module @skillsmith/mcp-server/utils/local-inventory.types
+ *
+ * Public surface consumed by the collision-detector + audit-history modules.
+ * Wave 2/3/4 import these types — keep stable and additive.
+ */
+export {};
+//# sourceMappingURL=local-inventory.types.js.map

package/dist/src/utils/local-inventory.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-inventory.types.js","sourceRoot":"","sources":["../../../src/utils/local-inventory.types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/src/webhooks/stripe-webhook-endpoint.d.ts

@@ -61,6 +61,18 @@ export declare function startStripeWebhookServer(webhookServer: StripeWebhookSer
     port?: number;
     host?: string;
 }): Promise<void>;
+/**
+ * Attach SIGTERM/SIGINT shutdown handlers idempotently to the standalone
+ * Stripe webhook server. Returns a `detach()` function that removes both
+ * handlers, intended for the listener-count audit test.
+ *
+ * SMI-4694: mirrors `webhook-endpoint.ts#attachShutdownHandlers`. Same
+ * risk profile (standalone daemon, supervisor re-entry possible).
+ *
+ * @internal Exported for the SMI-4694 listener-count audit test only; not
+ * part of the public webhook surface.
+ */
+export declare function attachShutdownHandlers(webhookServer: StripeWebhookServer): () => void;
 /**
  * Standalone entry point for Stripe webhook server
  */

package/dist/src/webhooks/stripe-webhook-endpoint.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stripe-webhook-endpoint.d.ts","sourceRoot":"","sources":["../../../src/webhooks/stripe-webhook-endpoint.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAiD,MAAM,EAAE,MAAM,MAAM,CAAA;AAO5E,OAAO,KAAK,EAAE,gBAAgB,EAAuB,MAAM,uBAAuB,CAAA;AAClF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAA;AAMpE,MAAM,WAAW,yBAAyB;IACxC;;OAEG;IACH,aAAa,EAAE,MAAM,CAAA;IAErB;;OAEG;IACH,UAAU,CAAC,EAAE,OAAO,CAAA;IAEpB;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,EAAE,CAAA;IAEzB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAA;IAEpB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,0BAA2B,SAAQ,yBAAyB;IAC3E;;OAEG;IACH,cAAc,EAAE,oBAAoB,CAAA;IAEpC;;OAEG;IACH,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,KAAK,IAAI,CAAA;CACpF;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAA;IACd,WAAW,EAAE,gBAAgB,CAAA;IAC7B,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAC1B;AAMD;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,0BAA0B,GAClC,mBAAmB,CAiJrB;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,aAAa,EAAE,mBAAmB,EAClC,OAAO,GAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAO,GAC7C,OAAO,CAAC,IAAI,CAAC,CAUf;AAED;;GAEG;AACH,wBAAsB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAqD1C"}
+{"version":3,"file":"stripe-webhook-endpoint.d.ts","sourceRoot":"","sources":["../../../src/webhooks/stripe-webhook-endpoint.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAiD,MAAM,EAAE,MAAM,MAAM,CAAA;AAO5E,OAAO,KAAK,EAAE,gBAAgB,EAAuB,MAAM,uBAAuB,CAAA;AAClF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAA;AAMpE,MAAM,WAAW,yBAAyB;IACxC;;OAEG;IACH,aAAa,EAAE,MAAM,CAAA;IAErB;;OAEG;IACH,UAAU,CAAC,EAAE,OAAO,CAAA;IAEpB;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,EAAE,CAAA;IAEzB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAA;IAEpB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,0BAA2B,SAAQ,yBAAyB;IAC3E;;OAEG;IACH,cAAc,EAAE,oBAAoB,CAAA;IAEpC;;OAEG;IACH,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,KAAK,IAAI,CAAA;CACpF;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAA;IACd,WAAW,EAAE,gBAAgB,CAAA;IAC7B,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAC1B;AAMD;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,0BAA0B,GAClC,mBAAmB,CAiJrB;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,aAAa,EAAE,mBAAmB,EAClC,OAAO,GAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAO,GAC7C,OAAO,CAAC,IAAI,CAAC,CAUf;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,sBAAsB,CAAC,aAAa,EAAE,mBAAmB,GAAG,MAAM,IAAI,CAkBrF;AAED;;GAEG;AACH,wBAAsB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CA6C1C"}