@skillsmith/core 0.5.8 → 0.6.1

package/dist/tests/unit/skills/index-local.test.js

@@ -0,0 +1,88 @@
+/**
+ * Frozen-fixture regression test for SMI-4587 NEW-E-2.
+ *
+ * Asserts `indexLocalSkill` returns deterministic output for known
+ * frontmatter shapes. The fixtures live under
+ * `packages/core/tests/fixtures/index-local/` and must not be edited
+ * without updating these snapshots — that's the regression-detection
+ * contract for Wave 2/3/4 callers (audit bootstrap + MCP tool).
+ */
+import { describe, expect, it } from 'vitest';
+import * as path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { indexLocalSkill } from '../../../src/skills/index-local.js';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const FIXTURES = path.resolve(__dirname, '../../fixtures/index-local');
+describe('indexLocalSkill (NEW-E-2 frozen fixture regression)', () => {
+    it('full-fixture/SKILL.md → deterministic IndexLocalSkillResult', () => {
+        const skillMdPath = path.join(FIXTURES, 'full-fixture', 'SKILL.md');
+        const result = indexLocalSkill(skillMdPath);
+        expect(result.id).toBe('local/full-fixture');
+        expect(result.name).toBe('full-fixture');
+        expect(result.description).toBe('A frozen fixture for SMI-4587 NEW-E-2 regression test');
+        expect(result.author).toBe('smith-horn');
+        expect(result.tags).toEqual(['audit', 'namespace', 'fixture']);
+        expect(result.repository).toBe('https://github.com/smith-horn/skillsmith');
+        expect(result.compatibility).toEqual(['claude-code', 'cursor']);
+        expect(result.trustTier).toBe('local');
+        expect(result.source).toBe('local');
+        expect(result.hasSkillMd).toBe(true);
+        expect(result.path).toBe(path.join(FIXTURES, 'full-fixture'));
+        // Score: hasSkillMd=20 + hasName=10 + hasDescription=20 +
+        // descLength≈4 (52/200 ≈ 26% * 15 ≈ 4) + hasTags=15 + tagCount=9
+        // (3/5 * 15) + hasAuthor=5 = 83. Allow exact match — snapshot.
+        expect(result.qualityScore).toBe(83);
+    });
+    it('full-fixture works when caller passes the directory (not the SKILL.md path)', () => {
+        const dir = path.join(FIXTURES, 'full-fixture');
+        const result = indexLocalSkill(dir);
+        expect(result.id).toBe('local/full-fixture');
+        expect(result.hasSkillMd).toBe(true);
+        expect(result.path).toBe(dir);
+    });
+    it('minimal-fixture: frontmatter with only `name` still indexes', () => {
+        const skillMdPath = path.join(FIXTURES, 'minimal-fixture', 'SKILL.md');
+        const result = indexLocalSkill(skillMdPath);
+        expect(result.name).toBe('minimal-fixture');
+        expect(result.id).toBe('local/minimal-fixture');
+        expect(result.author).toBe('local');
+        expect(result.description).toBeNull();
+        expect(result.tags).toEqual([]);
+        expect(result.compatibility).toBeUndefined();
+        expect(result.hasSkillMd).toBe(true);
+        // Score: hasSkillMd=20 + hasName=10 = 30
+        expect(result.qualityScore).toBe(30);
+    });
+    it('no-skill-md fixture: directory exists but SKILL.md missing → hasSkillMd=false', () => {
+        const dir = path.join(FIXTURES, 'no-skill-md');
+        const result = indexLocalSkill(dir);
+        expect(result.hasSkillMd).toBe(false);
+        expect(result.name).toBe('no-skill-md');
+        expect(result.id).toBe('local/no-skill-md');
+        expect(result.qualityScore).toBe(0);
+        expect(result.lastModified).not.toBeNull();
+    });
+    it('throws a typed error when the path does not exist (audit bootstrap converts to ScanWarning)', () => {
+        const ghost = path.join(FIXTURES, 'does-not-exist', 'SKILL.md');
+        expect(() => indexLocalSkill(ghost)).toThrowError(/cannot stat/);
+    });
+    it('respects a caller-supplied parseFrontmatter override', () => {
+        const skillMdPath = path.join(FIXTURES, 'full-fixture', 'SKILL.md');
+        const result = indexLocalSkill(skillMdPath, {
+            parseFrontmatter: () => ({
+                name: 'override-name',
+                description: 'override',
+                author: 'override-author',
+                tags: ['x'],
+                version: null,
+                repository: null,
+                homepage: null,
+                compatibility: [],
+            }),
+        });
+        expect(result.name).toBe('override-name');
+        expect(result.author).toBe('override-author');
+    });
+});
+//# sourceMappingURL=index-local.test.js.map

package/dist/tests/unit/skills/index-local.test.js.map

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

package/dist/tests/unit/sync-engine.source-aware.test.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @fileoverview SyncEngine source-aware predicate tests
+ * @see SMI-4665: Filesystem-walking SKILL.md import command
+ *
+ * Coverage:
+ *   - Live path: `force=true` does NOT overwrite `source='local'` rows
+ *   - Live path: `source='registry'` rows continue to update normally
+ *   - Dry-run: local rows are reported as `unchanged`, not `updated`
+ */
+export {};
+//# sourceMappingURL=sync-engine.source-aware.test.d.ts.map

package/dist/tests/unit/sync-engine.source-aware.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-engine.source-aware.test.d.ts","sourceRoot":"","sources":["../../../tests/unit/sync-engine.source-aware.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/dist/tests/unit/sync-engine.source-aware.test.js

@@ -0,0 +1,147 @@
+/**
+ * @fileoverview SyncEngine source-aware predicate tests
+ * @see SMI-4665: Filesystem-walking SKILL.md import command
+ *
+ * Coverage:
+ *   - Live path: `force=true` does NOT overwrite `source='local'` rows
+ *   - Live path: `source='registry'` rows continue to update normally
+ *   - Dry-run: local rows are reported as `unchanged`, not `updated`
+ */
+import { describe, it, expect, beforeEach, afterEach, vi } from 'vitest';
+import { createDatabase, closeDatabase } from '../../src/db/schema.js';
+import { SyncConfigRepository } from '../../src/repositories/SyncConfigRepository.js';
+import { SyncHistoryRepository } from '../../src/repositories/SyncHistoryRepository.js';
+import { SkillRepository } from '../../src/repositories/SkillRepository.js';
+import { SyncEngine } from '../../src/sync/SyncEngine.js';
+function createMockSkillVersionRepo() {
+    return {
+        recordVersion: vi.fn().mockResolvedValue(undefined),
+        pruneVersions: vi.fn().mockResolvedValue(undefined),
+        getLatestVersion: vi.fn().mockResolvedValue(null),
+        getVersionHistory: vi.fn().mockResolvedValue([]),
+        getVersionByHash: vi.fn().mockResolvedValue(null),
+    };
+}
+function createApiSkill(id, updatedAt) {
+    return {
+        id,
+        name: `Registry ${id}`,
+        description: `Registry description for ${id}`,
+        author: 'registry-author',
+        repo_url: `https://github.com/registry/${id}`,
+        quality_score: 0.9,
+        trust_tier: 'community',
+        tags: ['registry'],
+        stars: 10,
+        installable: true,
+        created_at: updatedAt,
+        updated_at: updatedAt,
+    };
+}
+function createMockApiClient(skills) {
+    const search = vi.fn().mockImplementation(async ({ limit = 100, offset = 0 }) => ({
+        data: skills.slice(offset, offset + limit),
+        total: skills.length,
+        limit,
+        offset,
+    }));
+    return {
+        isOffline: vi.fn().mockReturnValue(false),
+        checkHealth: vi.fn().mockResolvedValue({ status: 'healthy' }),
+        search,
+        getSkill: vi.fn(),
+        getHealthStatus: vi.fn(),
+    };
+}
+describe('SyncEngine source-aware predicate (SMI-4665)', () => {
+    let db;
+    let skillRepo;
+    let syncConfigRepo;
+    let syncHistoryRepo;
+    beforeEach(() => {
+        db = createDatabase(':memory:');
+        skillRepo = new SkillRepository(db);
+        syncConfigRepo = new SyncConfigRepository(db);
+        syncHistoryRepo = new SyncHistoryRepository(db);
+    });
+    afterEach(() => {
+        closeDatabase(db);
+    });
+    it('force=true does NOT overwrite source=local rows', async () => {
+        // Seed a locally-imported skill with the same id the registry would later carry.
+        skillRepo.create({
+            id: 'shared-id',
+            name: 'My Local WIP',
+            description: 'Iterating on disk',
+            trustTier: 'local',
+            source: 'local',
+            tags: ['wip'],
+        });
+        const future = new Date(Date.now() + 60_000).toISOString();
+        const apiClient = createMockApiClient([createApiSkill('shared-id', future)]);
+        const engine = new SyncEngine(apiClient, skillRepo, syncConfigRepo, syncHistoryRepo, createMockSkillVersionRepo());
+        const result = await engine.sync({ force: true });
+        expect(result.success).toBe(true);
+        expect(result.skillsAdded).toBe(0);
+        expect(result.skillsUpdated).toBe(0);
+        expect(result.skillsUnchanged).toBeGreaterThanOrEqual(1);
+        const after = skillRepo.findById('shared-id');
+        expect(after).not.toBeNull();
+        expect(after.name).toBe('My Local WIP');
+        expect(after.source).toBe('local');
+        expect(after.trustTier).toBe('local');
+    });
+    it('source=registry rows continue to update under force=true', async () => {
+        // Seed a registry-sourced row.
+        skillRepo.create({
+            id: 'registry-id',
+            name: 'Old Registry',
+            trustTier: 'community',
+            source: 'registry',
+            tags: ['old'],
+        });
+        const future = new Date(Date.now() + 60_000).toISOString();
+        const apiClient = createMockApiClient([createApiSkill('registry-id', future)]);
+        const engine = new SyncEngine(apiClient, skillRepo, syncConfigRepo, syncHistoryRepo, createMockSkillVersionRepo());
+        const result = await engine.sync({ force: true });
+        expect(result.success).toBe(true);
+        expect(result.skillsUpdated).toBeGreaterThanOrEqual(1);
+        const after = skillRepo.findById('registry-id');
+        expect(after).not.toBeNull();
+        expect(after.name).toBe('Registry registry-id');
+        expect(after.source).toBe('registry');
+    });
+    it('dry-run reports local rows as unchanged, not updated', async () => {
+        skillRepo.create({
+            id: 'local-id',
+            name: 'Local',
+            trustTier: 'local',
+            source: 'local',
+            tags: [],
+        });
+        skillRepo.create({
+            id: 'reg-id',
+            name: 'Reg',
+            trustTier: 'community',
+            source: 'registry',
+            tags: [],
+        });
+        const future = new Date(Date.now() + 60_000).toISOString();
+        const apiClient = createMockApiClient([
+            createApiSkill('local-id', future),
+            createApiSkill('reg-id', future),
+        ]);
+        const engine = new SyncEngine(apiClient, skillRepo, syncConfigRepo, syncHistoryRepo, createMockSkillVersionRepo());
+        const result = await engine.sync({ force: true, dryRun: true });
+        expect(result.dryRun).toBe(true);
+        // Exactly one row (local-id) should be classified as unchanged-due-to-source,
+        // and exactly one (reg-id) should be classified as updated.
+        expect(result.skillsUpdated).toBeGreaterThanOrEqual(1);
+        expect(result.skillsUpdated).toBeLessThan(2);
+        // Even in dry-run we MUST NOT have mutated the DB.
+        const localAfter = skillRepo.findById('local-id');
+        expect(localAfter.name).toBe('Local');
+        expect(localAfter.source).toBe('local');
+    });
+});
+//# sourceMappingURL=sync-engine.source-aware.test.js.map

package/dist/tests/unit/sync-engine.source-aware.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-engine.source-aware.test.js","sourceRoot":"","sources":["../../../tests/unit/sync-engine.source-aware.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAA;AACxE,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAA;AACtE,OAAO,EAAE,oBAAoB,EAAE,MAAM,gDAAgD,CAAA;AACrF,OAAO,EAAE,qBAAqB,EAAE,MAAM,iDAAiD,CAAA;AACvF,OAAO,EAAE,eAAe,EAAE,MAAM,2CAA2C,CAAA;AAC3E,OAAO,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAA;AAKzD,SAAS,0BAA0B;IACjC,OAAO;QACL,aAAa,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,SAAS,CAAC;QACnD,aAAa,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,SAAS,CAAC;QACnD,gBAAgB,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,IAAI,CAAC;QACjD,iBAAiB,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,CAAC;QAChD,gBAAgB,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,IAAI,CAAC;KACb,CAAA;AACxC,CAAC;AAED,SAAS,cAAc,CAAC,EAAU,EAAE,SAAiB;IACnD,OAAO;QACL,EAAE;QACF,IAAI,EAAE,YAAY,EAAE,EAAE;QACtB,WAAW,EAAE,4BAA4B,EAAE,EAAE;QAC7C,MAAM,EAAE,iBAAiB;QACzB,QAAQ,EAAE,+BAA+B,EAAE,EAAE;QAC7C,aAAa,EAAE,GAAG;QAClB,UAAU,EAAE,WAAW;QACvB,IAAI,EAAE,CAAC,UAAU,CAAC;QAClB,KAAK,EAAE,EAAE;QACT,WAAW,EAAE,IAAI;QACjB,UAAU,EAAE,SAAS;QACrB,UAAU,EAAE,SAAS;KACQ,CAAA;AACjC,CAAC;AAED,SAAS,mBAAmB,CAAC,MAAyB;IACpD,MAAM,MAAM,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,kBAAkB,CAAC,KAAK,EAAE,EAAE,KAAK,GAAG,GAAG,EAAE,MAAM,GAAG,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;QAChF,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,KAAK,CAAC;QAC1C,KAAK,EAAE,MAAM,CAAC,MAAM;QACpB,KAAK;QACL,MAAM;KACP,CAAC,CAAC,CAAA;IACH,OAAO;QACL,SAAS,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC,KAAK,CAAC;QACzC,WAAW,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;QAC7D,MAAM;QACN,QAAQ,EAAE,EAAE,CAAC,EAAE,EAAE;QACjB,eAAe,EAAE,EAAE,CAAC,EAAE,EAAE;KACS,CAAA;AACrC,CAAC;AAED,QAAQ,CAAC,8CAA8C,EAAE,GAAG,EAAE;IAC5D,IAAI,EAAgB,CAAA;IACpB,IAAI,SAA0B,CAAA;IAC9B,IAAI,cAAoC,CAAA;IACxC,IAAI,eAAsC,CAAA;IAE1C,UAAU,CAAC,GAAG,EAAE;QACd,EAAE,GAAG,cAAc,CAAC,UAAU,CAAC,CAAA;QAC/B,SAAS,GAAG,IAAI,eAAe,CAAC,EAAE,CAAC,CAAA;QACnC,cAAc,GAAG,IAAI,oBAAoB,CAAC,EAAE,CAAC,CAAA;QAC7C,eAAe,GAAG,IAAI,qBAAqB,CAAC,EAAE,CAAC,CAAA;IACjD,CAAC,CAAC,CAAA;IAEF,SAAS,CAAC,GAAG,EAAE;QACb,aAAa,CAAC,EAAE,CAAC,CAAA;IACnB,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,iDAAiD,EAAE,KAAK,IAAI,EAAE;QAC/D,iFAAiF;QACjF,SAAS,CAAC,MAAM,CAAC;YACf,EAAE,EAAE,WAAW;YACf,IAAI,EAAE,cAAc;YACpB,WAAW,EAAE,mBAAmB;YAChC,SAAS,EAAE,OAAO;YAClB,MAAM,EAAE,OAAO;YACf,IAAI,EAAE,CAAC,KAAK,CAAC;SACd,CAAC,CAAA;QAEF,MAAM,MAAM,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC,CAAC,WAAW,EAAE,CAAA;QAC1D,MAAM,SAAS,GAAG,mBAAmB,CAAC,CAAC,cAAc,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC,CAAA;QAC5E,MAAM,MAAM,GAAG,IAAI,UAAU,CAC3B,SAAS,EACT,SAAS,EACT,cAAc,EACd,eAAe,EACf,0BAA0B,EAAE,CAC7B,CAAA;QAED,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;QAEjD,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACjC,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QAClC,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QACpC,MAAM,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAA;QAExD,MAAM,KAAK,GAAG,SAAS,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAA;QAC7C,MAAM,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAA;QAC5B,MAAM,CAAC,KAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAA;QACxC,MAAM,CAAC,KAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QACnC,MAAM,CAAC,KAAM,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IACxC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,0DAA0D,EAAE,KAAK,IAAI,EAAE;QACxE,+BAA+B;QAC/B,SAAS,CAAC,MAAM,CAAC;YACf,EAAE,EAAE,aAAa;YACjB,IAAI,EAAE,cAAc;YACpB,SAAS,EAAE,WAAW;YACtB,MAAM,EAAE,UAAU;YAClB,IAAI,EAAE,CAAC,KAAK,CAAC;SACd,CAAC,CAAA;QAEF,MAAM,MAAM,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC,CAAC,WAAW,EAAE,CAAA;QAC1D,MAAM,SAAS,GAAG,mBAAmB,CAAC,CAAC,cAAc,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC,CAAC,CAAA;QAC9E,MAAM,MAAM,GAAG,IAAI,UAAU,CAC3B,SAAS,EACT,SAAS,EACT,cAAc,EACd,eAAe,EACf,0BAA0B,EAAE,CAC7B,CAAA;QAED,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;QAEjD,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACjC,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAA;QAEtD,MAAM,KAAK,GAAG,SAAS,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAA;QAC/C,MAAM,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAA;QAC5B,MAAM,CAAC,KAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAA;QAChD,MAAM,CAAC,KAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;IACxC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,sDAAsD,EAAE,KAAK,IAAI,EAAE;QACpE,SAAS,CAAC,MAAM,CAAC;YACf,EAAE,EAAE,UAAU;YACd,IAAI,EAAE,OAAO;YACb,SAAS,EAAE,OAAO;YAClB,MAAM,EAAE,OAAO;YACf,IAAI,EAAE,EAAE;SACT,CAAC,CAAA;QACF,SAAS,CAAC,MAAM,CAAC;YACf,EAAE,EAAE,QAAQ;YACZ,IAAI,EAAE,KAAK;YACX,SAAS,EAAE,WAAW;YACtB,MAAM,EAAE,UAAU;YAClB,IAAI,EAAE,EAAE;SACT,CAAC,CAAA;QAEF,MAAM,MAAM,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC,CAAC,WAAW,EAAE,CAAA;QAC1D,MAAM,SAAS,GAAG,mBAAmB,CAAC;YACpC,cAAc,CAAC,UAAU,EAAE,MAAM,CAAC;YAClC,cAAc,CAAC,QAAQ,EAAE,MAAM,CAAC;SACjC,CAAC,CAAA;QACF,MAAM,MAAM,GAAG,IAAI,UAAU,CAC3B,SAAS,EACT,SAAS,EACT,cAAc,EACd,eAAe,EACf,0BAA0B,EAAE,CAC7B,CAAA;QAED,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAA;QAE/D,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAChC,8EAA8E;QAC9E,4DAA4D;QAC5D,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAA;QACtD,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAA;QAE5C,mDAAmD;QACnD,MAAM,UAAU,GAAG,SAAS,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAA;QACjD,MAAM,CAAC,UAAW,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QACtC,MAAM,CAAC,UAAW,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IAC1C,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skillsmith/core",
-  "version": "0.5.8",
+  "version": "0.6.1",
   "description": "Core types and utilities for Skillsmith",
   "type": "module",
   "main": "./dist/src/index.js",
@@ -36,15 +36,35 @@
       "import": "./dist/src/billing/index.js",
       "default": "./dist/src/billing/index.js"
     },
+    "./audit": {
+      "types": "./dist/src/audit/index.d.ts",
+      "import": "./dist/src/audit/index.js",
+      "default": "./dist/src/audit/index.js"
+    },
     "./testkit": {
       "types": "./dist/tests/testkit.d.ts",
       "import": "./dist/tests/testkit.js",
       "default": "./dist/tests/testkit.js"
     },
+    "./install": {
+      "types": "./dist/src/install/index.d.ts",
+      "import": "./dist/src/install/index.js",
+      "default": "./dist/src/install/index.js"
+    },
     "./services/skill-installation-helpers": {
       "types": "./dist/src/services/skill-installation.helpers.d.ts",
       "import": "./dist/src/services/skill-installation.helpers.js",
       "default": "./dist/src/services/skill-installation.helpers.js"
+    },
+    "./config/audit-mode": {
+      "types": "./dist/src/config/audit-mode.d.ts",
+      "import": "./dist/src/config/audit-mode.js",
+      "default": "./dist/src/config/audit-mode.js"
+    },
+    "./skills/index-local": {
+      "types": "./dist/src/skills/index-local.d.ts",
+      "import": "./dist/src/skills/index-local.js",
+      "default": "./dist/src/skills/index-local.js"
     }
   },
   "scripts": {
@@ -61,33 +81,36 @@
     "benchmark:cache": "npx tsx src/benchmarks/cli.ts --suite cache",
     "benchmark:embedding": "npx tsx src/benchmarks/cli.ts --suite embedding",
     "benchmark:incremental-parse": "npx tsx src/benchmarks/incrementalParseBenchmark.ts",
+    "bench:hnsw:seed": "npx tsx tests/embeddings/seed-bench.ts",
+    "bench:hnsw": "vitest bench --run tests/embeddings/hnsw-vs-brute-force.bench.ts",
     "import:skills": "npx tsx src/scripts/import-to-database.ts"
   },
   "dependencies": {
     "@huggingface/transformers": "3.8.1",
-    "@opentelemetry/api": "1.9.0",
-    "@opentelemetry/instrumentation-http": "0.214.0",
-    "@opentelemetry/instrumentation-runtime-node": "0.27.0",
-    "@opentelemetry/instrumentation-undici": "0.24.0",
-    "@opentelemetry/resources": "2.6.1",
-    "@opentelemetry/sdk-node": "0.214.0",
-    "@opentelemetry/sdk-trace-base": "2.7.0",
-    "@opentelemetry/semantic-conventions": "1.40.0",
+    "@opentelemetry/api": "1.9.1",
+    "@opentelemetry/instrumentation-http": "0.218.0",
+    "@opentelemetry/instrumentation-runtime-node": "0.31.0",
+    "@opentelemetry/instrumentation-undici": "0.28.0",
+    "@opentelemetry/resources": "2.7.1",
+    "@opentelemetry/sdk-node": "0.218.0",
+    "@opentelemetry/sdk-trace-base": "2.7.1",
+    "@opentelemetry/semantic-conventions": "1.41.1",
     "fts5-sql-bundle": "1.0.2",
     "lru-cache": "11.3.3",
     "posthog-node": "5.29.2",
     "stripe": "20.3.0",
     "tree-sitter-wasms": "0.1.13",
     "typescript": "5.9.3",
-    "web-tree-sitter": "0.26.8",
+    "web-tree-sitter": "0.25.10",
     "zod": "4.2.1"
   },
   "optionalDependencies": {
-    "better-sqlite3": "11.10.0"
+    "better-sqlite3": "11.10.0",
+    "hnswlib-node": "^3.0.0"
   },
   "devDependencies": {
     "@types/better-sqlite3": "7.6.13",
-    "vitest": "4.1.2"
+    "vitest": "4.1.6"
   },
   "files": [
     "dist",