@skillsmith/core 0.4.14 → 0.4.16

package/dist/src/analysis/DependencyMerger.d.ts

@@ -0,0 +1,39 @@
+/**
+ * @fileoverview Merges declared and inferred dependencies into a flat list
+ * @module @skillsmith/core/analysis/DependencyMerger
+ * @see SMI-3146: Build DependencyMerger
+ *
+ * Combines frontmatter-declared dependencies with statically inferred
+ * MCP references, deduplicating where declared trumps inferred.
+ */
+import type { DependencyDeclaration, DepSource, DepType } from '../types/dependencies.js';
+import type { McpExtractionResult } from './McpReferenceExtractor.js';
+/** A single merged dependency ready for database insertion */
+export interface MergedDependency {
+    /** Dependency category, e.g. 'mcp_server', 'skill_hard' */
+    depType: DepType;
+    /** Target identifier, e.g. 'linear', 'claude-flow' */
+    depTarget: string;
+    /** Semver constraint or null */
+    depVersion: string | null;
+    /** How the dependency was discovered */
+    depSource: DepSource;
+    /** Confidence score (1.0 for declared, 0.9/0.5 for inferred) */
+    confidence: number | null;
+    /** JSON-serialized metadata or null */
+    metadata: string | null;
+}
+/**
+ * Merge declared dependencies from SKILL.md frontmatter with
+ * inferred MCP references from static content analysis.
+ *
+ * Declared dependencies always take precedence: if a server appears
+ * in both declared MCP servers and inferred references, only the
+ * declared entry is included.
+ *
+ * @param declared - Parsed dependency declaration from frontmatter
+ * @param inferred - MCP references extracted from content
+ * @returns Flat array of merged dependencies
+ */
+export declare function mergeDependencies(declared: DependencyDeclaration | undefined, inferred: McpExtractionResult): MergedDependency[];
+//# sourceMappingURL=DependencyMerger.d.ts.map

package/dist/src/analysis/DependencyMerger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DependencyMerger.d.ts","sourceRoot":"","sources":["../../../src/analysis/DependencyMerger.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAA;AACzF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAA;AAErE,8DAA8D;AAC9D,MAAM,WAAW,gBAAgB;IAC/B,2DAA2D;IAC3D,OAAO,EAAE,OAAO,CAAA;IAChB,sDAAsD;IACtD,SAAS,EAAE,MAAM,CAAA;IACjB,gCAAgC;IAChC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,wCAAwC;IACxC,SAAS,EAAE,SAAS,CAAA;IACpB,gEAAgE;IAChE,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,uCAAuC;IACvC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;CACxB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,qBAAqB,GAAG,SAAS,EAC3C,QAAQ,EAAE,mBAAmB,GAC5B,gBAAgB,EAAE,CAepB"}

package/dist/src/analysis/DependencyMerger.js

@@ -0,0 +1,191 @@
+/**
+ * @fileoverview Merges declared and inferred dependencies into a flat list
+ * @module @skillsmith/core/analysis/DependencyMerger
+ * @see SMI-3146: Build DependencyMerger
+ *
+ * Combines frontmatter-declared dependencies with statically inferred
+ * MCP references, deduplicating where declared trumps inferred.
+ */
+/**
+ * Merge declared dependencies from SKILL.md frontmatter with
+ * inferred MCP references from static content analysis.
+ *
+ * Declared dependencies always take precedence: if a server appears
+ * in both declared MCP servers and inferred references, only the
+ * declared entry is included.
+ *
+ * @param declared - Parsed dependency declaration from frontmatter
+ * @param inferred - MCP references extracted from content
+ * @returns Flat array of merged dependencies
+ */
+export function mergeDependencies(declared, inferred) {
+    const result = [];
+    const declaredMcpServers = new Set();
+    if (declared) {
+        addSkillDeps(declared, result);
+        addPlatformDeps(declared, result, declaredMcpServers);
+        addModelDeps(declared, result);
+        addEnvironmentDeps(declared, result);
+        addConflicts(declared, result);
+    }
+    addInferredMcp(inferred, declaredMcpServers, result);
+    return result;
+}
+/** Add skill-to-skill dependencies */
+function addSkillDeps(declared, result) {
+    if (!declared.skills)
+        return;
+    for (const skill of declared.skills) {
+        const depType = skill.type === 'hard' ? 'skill_hard' : skill.type === 'soft' ? 'skill_soft' : 'skill_peer';
+        result.push({
+            depType,
+            depTarget: skill.name,
+            depVersion: skill.version ?? null,
+            depSource: 'declared',
+            confidence: 1.0,
+            metadata: skill.reason ? JSON.stringify({ reason: skill.reason }) : null,
+        });
+    }
+}
+/** Add platform dependencies (CLI version, MCP servers) */
+function addPlatformDeps(declared, result, declaredMcpServers) {
+    if (!declared.platform)
+        return;
+    if (declared.platform.cli) {
+        result.push({
+            depType: 'cli_version',
+            depTarget: 'claude',
+            depVersion: declared.platform.cli,
+            depSource: 'declared',
+            confidence: 1.0,
+            metadata: null,
+        });
+    }
+    if (declared.platform.mcp_servers) {
+        for (const server of declared.platform.mcp_servers) {
+            declaredMcpServers.add(server.name);
+            result.push({
+                depType: 'mcp_server',
+                depTarget: server.name,
+                depVersion: null,
+                depSource: 'declared',
+                confidence: 1.0,
+                metadata: server.package
+                    ? JSON.stringify({
+                        package: server.package,
+                        required: server.required,
+                    })
+                    : JSON.stringify({ required: server.required }),
+            });
+        }
+    }
+}
+/** Add model dependencies */
+function addModelDeps(declared, result) {
+    if (!declared.models)
+        return;
+    if (declared.models.minimum) {
+        result.push({
+            depType: 'model_minimum',
+            depTarget: declared.models.minimum,
+            depVersion: null,
+            depSource: 'declared',
+            confidence: 1.0,
+            metadata: declared.models.context_window
+                ? JSON.stringify({ context_window: declared.models.context_window })
+                : null,
+        });
+    }
+    if (declared.models.capabilities) {
+        for (const cap of declared.models.capabilities) {
+            result.push({
+                depType: 'model_capability',
+                depTarget: cap,
+                depVersion: null,
+                depSource: 'declared',
+                confidence: 1.0,
+                metadata: null,
+            });
+        }
+    }
+}
+/** Add environment dependencies (tools, OS, Node) */
+function addEnvironmentDeps(declared, result) {
+    if (!declared.environment)
+        return;
+    if (declared.environment.tools) {
+        for (const tool of declared.environment.tools) {
+            result.push({
+                depType: 'env_tool',
+                depTarget: tool.name,
+                depVersion: null,
+                depSource: 'declared',
+                confidence: 1.0,
+                metadata: JSON.stringify({
+                    required: tool.required,
+                    ...(tool.check ? { check: tool.check } : {}),
+                }),
+            });
+        }
+    }
+    if (declared.environment.os) {
+        for (const os of declared.environment.os) {
+            result.push({
+                depType: 'env_os',
+                depTarget: os,
+                depVersion: null,
+                depSource: 'declared',
+                confidence: 1.0,
+                metadata: null,
+            });
+        }
+    }
+    if (declared.environment.node) {
+        result.push({
+            depType: 'env_node',
+            depTarget: 'node',
+            depVersion: declared.environment.node,
+            depSource: 'declared',
+            confidence: 1.0,
+            metadata: null,
+        });
+    }
+}
+/** Add conflict declarations — note: DependencyDeclaration doesn't have conflicts field yet */
+function addConflicts(declared, result) {
+    // DependencyDeclaration type does not include a conflicts field.
+    // This is a forward-looking handler for when the type is extended.
+    // Access via type-safe indexing to avoid runtime errors.
+    const withConflicts = declared;
+    if (!withConflicts.conflicts)
+        return;
+    for (const conflict of withConflicts.conflicts) {
+        result.push({
+            depType: 'conflict',
+            depTarget: conflict.name,
+            depVersion: conflict.versions ?? null,
+            depSource: 'declared',
+            confidence: 1.0,
+            metadata: conflict.reason ? JSON.stringify({ reason: conflict.reason }) : null,
+        });
+    }
+}
+/** Add inferred MCP servers not already declared */
+function addInferredMcp(inferred, declaredMcpServers, result) {
+    const highConfidenceSet = new Set(inferred.highConfidenceServers);
+    for (const server of inferred.servers) {
+        // Declared trumps inferred — skip if already declared
+        if (declaredMcpServers.has(server))
+            continue;
+        const isHighConfidence = highConfidenceSet.has(server);
+        result.push({
+            depType: 'mcp_server',
+            depTarget: server,
+            depVersion: null,
+            depSource: 'inferred_static',
+            confidence: isHighConfidence ? 0.9 : 0.5,
+            metadata: null,
+        });
+    }
+}
+//# sourceMappingURL=DependencyMerger.js.map

package/dist/src/analysis/DependencyMerger.js.map

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

package/dist/src/analysis/DependencyMerger.test.d.ts

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

package/dist/src/analysis/DependencyMerger.test.d.ts.map

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

package/dist/src/analysis/DependencyMerger.test.js

@@ -0,0 +1,258 @@
+import { describe, it, expect } from 'vitest';
+import { mergeDependencies } from './DependencyMerger.js';
+/** Helper: create an empty McpExtractionResult */
+function emptyInferred() {
+    return { references: [], servers: [], highConfidenceServers: [] };
+}
+/** Helper: create a McpExtractionResult with servers */
+function inferredServers(servers, highConfidence = []) {
+    return {
+        references: servers.map((s) => ({
+            server: s,
+            tool: 'some_tool',
+            line: 1,
+            inCodeBlock: !highConfidence.includes(s),
+        })),
+        servers,
+        highConfidenceServers: highConfidence,
+    };
+}
+describe('DependencyMerger', () => {
+    describe('mergeDependencies', () => {
+        it('should return empty array for undefined declared and empty inferred', () => {
+            const result = mergeDependencies(undefined, emptyInferred());
+            expect(result).toEqual([]);
+        });
+        it('should include declared skill dependencies', () => {
+            const declared = {
+                skills: [
+                    { name: 'auth-helper', type: 'hard', version: '^1.0.0' },
+                    { name: 'logger', type: 'soft' },
+                    { name: 'formatter', type: 'peer', reason: 'shared config' },
+                ],
+            };
+            const result = mergeDependencies(declared, emptyInferred());
+            expect(result).toHaveLength(3);
+            expect(result[0]).toMatchObject({
+                depType: 'skill_hard',
+                depTarget: 'auth-helper',
+                depVersion: '^1.0.0',
+                depSource: 'declared',
+                confidence: 1.0,
+            });
+            expect(result[1]).toMatchObject({
+                depType: 'skill_soft',
+                depTarget: 'logger',
+                depVersion: null,
+                depSource: 'declared',
+            });
+            expect(result[2]).toMatchObject({
+                depType: 'skill_peer',
+                depTarget: 'formatter',
+                metadata: JSON.stringify({ reason: 'shared config' }),
+            });
+        });
+        it('should include declared MCP servers', () => {
+            const declared = {
+                platform: {
+                    mcp_servers: [
+                        { name: 'linear', required: true, package: '@linear/mcp' },
+                        { name: 'slack', required: false },
+                    ],
+                },
+            };
+            const result = mergeDependencies(declared, emptyInferred());
+            expect(result).toHaveLength(2);
+            expect(result[0]).toMatchObject({
+                depType: 'mcp_server',
+                depTarget: 'linear',
+                depSource: 'declared',
+                confidence: 1.0,
+            });
+            expect(JSON.parse(result[0].metadata)).toEqual({
+                package: '@linear/mcp',
+                required: true,
+            });
+            expect(result[1]).toMatchObject({
+                depType: 'mcp_server',
+                depTarget: 'slack',
+                depSource: 'declared',
+            });
+            expect(JSON.parse(result[1].metadata)).toEqual({ required: false });
+        });
+        it('should add inferred MCP servers when no declared deps', () => {
+            const inferred = inferredServers(['linear', 'claude-flow'], ['linear']);
+            const result = mergeDependencies(undefined, inferred);
+            expect(result).toHaveLength(2);
+            const linear = result.find((d) => d.depTarget === 'linear');
+            expect(linear.depType).toBe('mcp_server');
+            expect(linear.depSource).toBe('inferred_static');
+            expect(linear.confidence).toBe(0.9); // high confidence
+            const cf = result.find((d) => d.depTarget === 'claude-flow');
+            expect(cf.depSource).toBe('inferred_static');
+            expect(cf.confidence).toBe(0.5); // low confidence (code block only)
+        });
+        it('should skip inferred server when already declared (declared trumps)', () => {
+            const declared = {
+                platform: {
+                    mcp_servers: [{ name: 'linear', required: true }],
+                },
+            };
+            const inferred = inferredServers(['linear', 'slack'], ['linear', 'slack']);
+            const result = mergeDependencies(declared, inferred);
+            // linear: declared only (not duplicated from inferred)
+            // slack: inferred (not declared)
+            const linearEntries = result.filter((d) => d.depTarget === 'linear');
+            expect(linearEntries).toHaveLength(1);
+            expect(linearEntries[0].depSource).toBe('declared');
+            expect(linearEntries[0].confidence).toBe(1.0);
+            const slackEntries = result.filter((d) => d.depTarget === 'slack');
+            expect(slackEntries).toHaveLength(1);
+            expect(slackEntries[0].depSource).toBe('inferred_static');
+            expect(slackEntries[0].confidence).toBe(0.9);
+        });
+        it('should assign correct confidence: 0.9 high, 0.5 code-block-only', () => {
+            const inferred = inferredServers(['high-server', 'low-server'], ['high-server'] // only high-server is high confidence
+            );
+            const result = mergeDependencies(undefined, inferred);
+            const high = result.find((d) => d.depTarget === 'high-server');
+            expect(high.confidence).toBe(0.9);
+            const low = result.find((d) => d.depTarget === 'low-server');
+            expect(low.confidence).toBe(0.5);
+        });
+        it('should include declared CLI version', () => {
+            const declared = {
+                platform: { cli: '>=1.0.0' },
+            };
+            const result = mergeDependencies(declared, emptyInferred());
+            expect(result).toHaveLength(1);
+            expect(result[0]).toMatchObject({
+                depType: 'cli_version',
+                depTarget: 'claude',
+                depVersion: '>=1.0.0',
+                depSource: 'declared',
+                confidence: 1.0,
+            });
+        });
+        it('should include model dependencies', () => {
+            const declared = {
+                models: {
+                    minimum: 'claude-3-sonnet',
+                    capabilities: ['tool_use', 'vision'],
+                    context_window: 200000,
+                },
+            };
+            const result = mergeDependencies(declared, emptyInferred());
+            expect(result).toHaveLength(3);
+            const minimum = result.find((d) => d.depType === 'model_minimum');
+            expect(minimum.depTarget).toBe('claude-3-sonnet');
+            expect(JSON.parse(minimum.metadata)).toEqual({
+                context_window: 200000,
+            });
+            const capabilities = result.filter((d) => d.depType === 'model_capability');
+            expect(capabilities).toHaveLength(2);
+            expect(capabilities.map((c) => c.depTarget)).toEqual(['tool_use', 'vision']);
+        });
+        it('should include environment dependencies', () => {
+            const declared = {
+                environment: {
+                    tools: [
+                        { name: 'git', required: true, check: 'git --version' },
+                        { name: 'docker', required: false },
+                    ],
+                    os: ['linux', 'darwin'],
+                    node: '>=20.0.0',
+                },
+            };
+            const result = mergeDependencies(declared, emptyInferred());
+            const tools = result.filter((d) => d.depType === 'env_tool');
+            expect(tools).toHaveLength(2);
+            expect(JSON.parse(tools[0].metadata)).toEqual({
+                required: true,
+                check: 'git --version',
+            });
+            expect(JSON.parse(tools[1].metadata)).toEqual({ required: false });
+            const osEntries = result.filter((d) => d.depType === 'env_os');
+            expect(osEntries).toHaveLength(2);
+            expect(osEntries.map((o) => o.depTarget)).toEqual(['linux', 'darwin']);
+            const nodeEntry = result.find((d) => d.depType === 'env_node');
+            expect(nodeEntry.depTarget).toBe('node');
+            expect(nodeEntry.depVersion).toBe('>=20.0.0');
+        });
+        it('should merge full declared + inferred with no duplicates', () => {
+            const declared = {
+                skills: [{ name: 'auth', type: 'hard' }],
+                platform: {
+                    cli: '>=1.0.0',
+                    mcp_servers: [{ name: 'linear', required: true }],
+                },
+                models: { minimum: 'claude-3-sonnet' },
+            };
+            const inferred = inferredServers(['linear', 'claude-flow', 'skillsmith'], ['claude-flow', 'skillsmith']);
+            const result = mergeDependencies(declared, inferred);
+            // Declared: skill_hard(auth) + cli_version + mcp_server(linear) + model_minimum
+            // Inferred: mcp_server(claude-flow, skillsmith) — linear skipped
+            expect(result).toHaveLength(6);
+            const mcpServers = result.filter((d) => d.depType === 'mcp_server');
+            expect(mcpServers).toHaveLength(3);
+            const linearEntry = mcpServers.find((d) => d.depTarget === 'linear');
+            expect(linearEntry.depSource).toBe('declared');
+            const cfEntry = mcpServers.find((d) => d.depTarget === 'claude-flow');
+            expect(cfEntry.depSource).toBe('inferred_static');
+            expect(cfEntry.confidence).toBe(0.9);
+            const ssEntry = mcpServers.find((d) => d.depTarget === 'skillsmith');
+            expect(ssEntry.depSource).toBe('inferred_static');
+            expect(ssEntry.confidence).toBe(0.9);
+        });
+        it('should handle declared-only with no inferred', () => {
+            const declared = {
+                skills: [{ name: 'helper', type: 'soft' }],
+            };
+            const result = mergeDependencies(declared, emptyInferred());
+            expect(result).toHaveLength(1);
+            expect(result[0].depType).toBe('skill_soft');
+        });
+        it('should ensure metadata is always a string or null', () => {
+            const declared = {
+                skills: [
+                    { name: 'with-reason', type: 'hard', reason: 'needed for auth' },
+                    { name: 'no-reason', type: 'soft' },
+                ],
+                platform: {
+                    mcp_servers: [{ name: 'linear', required: true }],
+                },
+            };
+            const result = mergeDependencies(declared, emptyInferred());
+            for (const dep of result) {
+                expect(dep.metadata === null || typeof dep.metadata === 'string').toBe(true);
+                // If metadata is a string, it must be valid JSON
+                if (dep.metadata !== null) {
+                    expect(() => JSON.parse(dep.metadata)).not.toThrow();
+                }
+            }
+        });
+        it('should handle conflicts', () => {
+            // Use type assertion for forward-looking conflicts field
+            const declared = {
+                conflicts: [
+                    {
+                        name: 'bad-skill',
+                        versions: '>=2.0.0',
+                        reason: 'incompatible API',
+                    },
+                ],
+            };
+            const result = mergeDependencies(declared, emptyInferred());
+            expect(result).toHaveLength(1);
+            expect(result[0]).toMatchObject({
+                depType: 'conflict',
+                depTarget: 'bad-skill',
+                depVersion: '>=2.0.0',
+                depSource: 'declared',
+                confidence: 1.0,
+                metadata: JSON.stringify({ reason: 'incompatible API' }),
+            });
+        });
+    });
+});
+//# sourceMappingURL=DependencyMerger.test.js.map

package/dist/src/analysis/DependencyMerger.test.js.map

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

package/dist/src/analysis/McpReferenceExtractor.d.ts

@@ -0,0 +1,42 @@
+/**
+ * @fileoverview Extracts MCP tool references from SKILL.md content
+ * @module @skillsmith/core/analysis/McpReferenceExtractor
+ * @see SMI-3145: Build McpReferenceExtractor
+ *
+ * Scans skill content for `mcp__<server>__<tool>` patterns,
+ * tracking whether each reference appears inside a fenced code block.
+ */
+/** A single MCP tool reference found in content */
+export interface McpReference {
+    /** MCP server name, e.g. "linear" */
+    server: string;
+    /** MCP tool name, e.g. "save_issue" */
+    tool: string;
+    /** 1-indexed line number where the reference appears */
+    line: number;
+    /** true if the reference is inside a fenced code block */
+    inCodeBlock: boolean;
+}
+/** Aggregated extraction result */
+export interface McpExtractionResult {
+    /** All individual references found */
+    references: McpReference[];
+    /** Unique server names across all references */
+    servers: string[];
+    /** Servers referenced at least once outside a code block */
+    highConfidenceServers: string[];
+    /** true if input exceeded the 100KB cap and was truncated */
+    truncated?: boolean;
+}
+/**
+ * Extract all MCP tool references from skill content.
+ *
+ * Scans each line for `mcp__server__tool` patterns, tracking fenced
+ * code block state to distinguish high-confidence (prose) references
+ * from low-confidence (code example) references.
+ *
+ * @param content - Raw SKILL.md content (markdown)
+ * @returns Extraction result with references, servers, and confidence info
+ */
+export declare function extractMcpReferences(content: string): McpExtractionResult;
+//# sourceMappingURL=McpReferenceExtractor.d.ts.map

package/dist/src/analysis/McpReferenceExtractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"McpReferenceExtractor.d.ts","sourceRoot":"","sources":["../../../src/analysis/McpReferenceExtractor.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,mDAAmD;AACnD,MAAM,WAAW,YAAY;IAC3B,qCAAqC;IACrC,MAAM,EAAE,MAAM,CAAA;IACd,uCAAuC;IACvC,IAAI,EAAE,MAAM,CAAA;IACZ,wDAAwD;IACxD,IAAI,EAAE,MAAM,CAAA;IACZ,0DAA0D;IAC1D,WAAW,EAAE,OAAO,CAAA;CACrB;AAED,mCAAmC;AACnC,MAAM,WAAW,mBAAmB;IAClC,sCAAsC;IACtC,UAAU,EAAE,YAAY,EAAE,CAAA;IAC1B,gDAAgD;IAChD,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,4DAA4D;IAC5D,qBAAqB,EAAE,MAAM,EAAE,CAAA;IAC/B,6DAA6D;IAC7D,SAAS,CAAC,EAAE,OAAO,CAAA;CACpB;AAeD;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,mBAAmB,CAyEzE"}