@pennyfarthing/core 10.3.1 → 11.0.0-alpha.0

package/packages/core/dist/shared/repos-topology.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repos-topology.d.ts","sourceRoot":"","sources":["../../src/shared/repos-topology.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,0CAA0C;AAC1C,MAAM,MAAM,OAAO,GAAG,OAAO,GAAG,KAAK,GAAG,MAAM,CAAC;AAE/C,mCAAmC;AACnC,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IAGf,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,qCAAqC;AACrC,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;CACrC;AAED,wBAAwB;AACxB,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAmED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,OAAO,GAAG,gBAAgB,CAgBvE;AAED;;;GAGG;AACH,wBAAsB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,WAAW,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAc5H"}

package/packages/core/dist/shared/repos-topology.js

@@ -0,0 +1,101 @@
+/**
+ * repos-topology.ts — Schema validation for repos.yaml topology fields
+ *
+ * Story 87-1: Extend repos.yaml schema with ownership and boundaries.
+ * Validates the spatial awareness fields that agents use to know which
+ * repo owns which paths, what's off-limits, and rendering context.
+ */
+const VALID_UI_LAYERS = ['react', 'cli', 'none'];
+function isRecord(v) {
+    return v !== null && typeof v === 'object' && !Array.isArray(v);
+}
+function validateStringArray(value, repoName, field, errors) {
+    if (!Array.isArray(value)) {
+        errors.push(`repos.${repoName}.${field} must be an array`);
+        return;
+    }
+    for (let i = 0; i < value.length; i++) {
+        if (typeof value[i] !== 'string') {
+            errors.push(`repos.${repoName}.${field}[${i}] must be a string`);
+        }
+    }
+}
+function validateRepo(repoName, repo, errors) {
+    if (!isRecord(repo)) {
+        errors.push(`repos.${repoName} must be an object`);
+        return;
+    }
+    // Required fields
+    for (const field of ['path', 'type', 'description']) {
+        if (typeof repo[field] !== 'string') {
+            errors.push(`repos.${repoName}.${field} is required and must be a string`);
+        }
+    }
+    // Optional topology fields — validate only when present
+    if ('owns' in repo && repo.owns !== undefined) {
+        validateStringArray(repo.owns, repoName, 'owns', errors);
+    }
+    if ('never_edit' in repo && repo.never_edit !== undefined) {
+        validateStringArray(repo.never_edit, repoName, 'never_edit', errors);
+    }
+    if ('symlinks' in repo && repo.symlinks !== undefined) {
+        if (!isRecord(repo.symlinks)) {
+            errors.push(`repos.${repoName}.symlinks must be an object`);
+        }
+        else {
+            for (const [key, val] of Object.entries(repo.symlinks)) {
+                if (typeof val !== 'string') {
+                    errors.push(`repos.${repoName}.symlinks["${key}"] must be a string`);
+                }
+            }
+        }
+    }
+    if ('ui_layer' in repo && repo.ui_layer !== undefined) {
+        if (typeof repo.ui_layer !== 'string' || !VALID_UI_LAYERS.includes(repo.ui_layer)) {
+            errors.push(`repos.${repoName}.ui_layer must be one of: ${VALID_UI_LAYERS.join(', ')}`);
+        }
+    }
+    if ('components_path' in repo && repo.components_path !== undefined) {
+        if (typeof repo.components_path !== 'string') {
+            errors.push(`repos.${repoName}.components_path must be a string`);
+        }
+    }
+}
+/**
+ * Validate a parsed repos.yaml config for topology schema compliance.
+ * Returns { valid, errors } — never throws.
+ */
+export function validateReposTopology(config) {
+    const errors = [];
+    if (!isRecord(config)) {
+        return { valid: false, errors: ['config must be an object'] };
+    }
+    if (!isRecord(config.repos)) {
+        return { valid: false, errors: ['config.repos must be an object'] };
+    }
+    for (const [name, repo] of Object.entries(config.repos)) {
+        validateRepo(name, repo, errors);
+    }
+    return { valid: errors.length === 0, errors };
+}
+/**
+ * Load and validate repos.yaml from a file path.
+ * Returns the parsed config if valid, or errors if not.
+ */
+export async function loadReposConfig(filePath) {
+    try {
+        const { readFileSync } = await import('node:fs');
+        const { parse } = await import('yaml');
+        const content = readFileSync(filePath, 'utf-8');
+        const parsed = parse(content);
+        const result = validateReposTopology(parsed);
+        if (!result.valid) {
+            return { success: false, errors: result.errors };
+        }
+        return { success: true, data: parsed };
+    }
+    catch (err) {
+        return { success: false, errors: [err.message] };
+    }
+}
+//# sourceMappingURL=repos-topology.js.map

package/packages/core/dist/shared/repos-topology.js.map

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

package/packages/core/dist/shared/repos-topology.test.d.ts

@@ -0,0 +1,8 @@
+/**
+ * repos-topology.test.ts — Tests for repos.yaml topology schema validation
+ *
+ * Story 87-1: Extend repos.yaml schema with ownership and boundaries
+ * RED STATE: These tests should FAIL until Dev implements validateReposTopology()
+ */
+export {};
+//# sourceMappingURL=repos-topology.test.d.ts.map

package/packages/core/dist/shared/repos-topology.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repos-topology.test.d.ts","sourceRoot":"","sources":["../../src/shared/repos-topology.test.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/packages/core/dist/shared/repos-topology.test.js

@@ -0,0 +1,250 @@
+/**
+ * repos-topology.test.ts — Tests for repos.yaml topology schema validation
+ *
+ * Story 87-1: Extend repos.yaml schema with ownership and boundaries
+ * RED STATE: These tests should FAIL until Dev implements validateReposTopology()
+ */
+/* eslint-disable @typescript-eslint/no-explicit-any */
+import { describe, it } from 'node:test';
+import assert from 'node:assert';
+import { validateReposTopology } from './repos-topology.js';
+// ── Fixtures ──────────────────────────────────────────────────────────
+/** Minimal valid config with all topology fields */
+const VALID_CONFIG = {
+    repos: {
+        orchestrator: {
+            path: '.',
+            type: 'orchestrator',
+            description: 'Sprint management and coordination',
+            language: 'javascript',
+            build_command: 'npm install',
+            owns: ['sprint/**', 'docs/**', '.session/**'],
+            never_edit: ['node_modules/**', '.pennyfarthing/**'],
+            symlinks: {
+                '.pennyfarthing/agents': 'pennyfarthing/pennyfarthing-dist/agents',
+                '.pennyfarthing/scripts': 'pennyfarthing/pennyfarthing-dist/scripts',
+            },
+            ui_layer: 'none',
+        },
+        pennyfarthing: {
+            path: 'pennyfarthing',
+            type: 'framework',
+            description: 'Pennyfarthing framework source',
+            language: 'typescript',
+            test_command: 'pnpm test',
+            build_command: 'pnpm build',
+            owns: ['pennyfarthing-dist/**', 'packages/**'],
+            never_edit: ['node_modules/**', 'dist/**'],
+            symlinks: {},
+            ui_layer: 'react',
+            components_path: 'packages/cyclist/src/components',
+        },
+    },
+};
+/** Config with only legacy fields (no topology) — backwards compatible */
+const LEGACY_CONFIG = {
+    repos: {
+        orchestrator: {
+            path: '.',
+            type: 'orchestrator',
+            description: 'Sprint management',
+            language: 'javascript',
+            build_command: 'npm install',
+        },
+    },
+};
+// ── AC1: owns field ───────────────────────────────────────────────────
+describe('AC1: owns field — glob patterns for directory ownership', () => {
+    it('accepts valid owns array with glob patterns', () => {
+        const result = validateReposTopology(VALID_CONFIG);
+        assert.strictEqual(result.valid, true, `Expected valid but got errors: ${result.errors.join(', ')}`);
+    });
+    it('rejects owns when not an array', () => {
+        const config = structuredClone(VALID_CONFIG);
+        config.repos.orchestrator.owns = 'sprint/**';
+        const result = validateReposTopology(config);
+        assert.strictEqual(result.valid, false);
+        assert.ok(result.errors.some(e => e.includes('owns')), 'Should mention owns field');
+    });
+    it('rejects owns with non-string entries', () => {
+        const config = structuredClone(VALID_CONFIG);
+        config.repos.orchestrator.owns = ['sprint/**', 42, null];
+        const result = validateReposTopology(config);
+        assert.strictEqual(result.valid, false);
+        assert.ok(result.errors.some(e => e.includes('owns')), 'Should mention owns field');
+    });
+});
+// ── AC2: never_edit field ─────────────────────────────────────────────
+describe('AC2: never_edit field — off-limits paths', () => {
+    it('accepts valid never_edit array', () => {
+        const result = validateReposTopology(VALID_CONFIG);
+        assert.strictEqual(result.valid, true, `Expected valid but got errors: ${result.errors.join(', ')}`);
+    });
+    it('rejects never_edit when not an array', () => {
+        const config = structuredClone(VALID_CONFIG);
+        config.repos.orchestrator.never_edit = 'node_modules/**';
+        const result = validateReposTopology(config);
+        assert.strictEqual(result.valid, false);
+        assert.ok(result.errors.some(e => e.includes('never_edit')), 'Should mention never_edit field');
+    });
+    it('rejects never_edit with non-string entries', () => {
+        const config = structuredClone(VALID_CONFIG);
+        config.repos.pennyfarthing.never_edit = [123];
+        const result = validateReposTopology(config);
+        assert.strictEqual(result.valid, false);
+        assert.ok(result.errors.some(e => e.includes('never_edit')), 'Should mention never_edit field');
+    });
+});
+// ── AC3: symlinks mapping ─────────────────────────────────────────────
+describe('AC3: symlinks field — mapping of symlink paths to sources', () => {
+    it('accepts valid symlinks object', () => {
+        const result = validateReposTopology(VALID_CONFIG);
+        assert.strictEqual(result.valid, true, `Expected valid but got errors: ${result.errors.join(', ')}`);
+    });
+    it('accepts empty symlinks object', () => {
+        const config = structuredClone(VALID_CONFIG);
+        config.repos.orchestrator.symlinks = {};
+        const result = validateReposTopology(config);
+        assert.strictEqual(result.valid, true, `Expected valid but got errors: ${result.errors.join(', ')}`);
+    });
+    it('rejects symlinks when not an object', () => {
+        const config = structuredClone(VALID_CONFIG);
+        config.repos.orchestrator.symlinks = ['.pennyfarthing/agents'];
+        const result = validateReposTopology(config);
+        assert.strictEqual(result.valid, false);
+        assert.ok(result.errors.some(e => e.includes('symlinks')), 'Should mention symlinks field');
+    });
+    it('rejects symlinks with non-string values', () => {
+        const config = structuredClone(VALID_CONFIG);
+        config.repos.orchestrator.symlinks = { '.pennyfarthing/agents': 42 };
+        const result = validateReposTopology(config);
+        assert.strictEqual(result.valid, false);
+        assert.ok(result.errors.some(e => e.includes('symlinks')), 'Should mention symlinks field');
+    });
+});
+// ── AC4: ui_layer field ───────────────────────────────────────────────
+describe('AC4: ui_layer field — rendering context', () => {
+    it('accepts react as ui_layer', () => {
+        const config = structuredClone(VALID_CONFIG);
+        config.repos.pennyfarthing.ui_layer = 'react';
+        const result = validateReposTopology(config);
+        assert.strictEqual(result.valid, true, `Expected valid but got errors: ${result.errors.join(', ')}`);
+    });
+    it('accepts cli as ui_layer', () => {
+        const config = structuredClone(VALID_CONFIG);
+        config.repos.pennyfarthing.ui_layer = 'cli';
+        const result = validateReposTopology(config);
+        assert.strictEqual(result.valid, true, `Expected valid but got errors: ${result.errors.join(', ')}`);
+    });
+    it('accepts none as ui_layer', () => {
+        const config = structuredClone(VALID_CONFIG);
+        config.repos.orchestrator.ui_layer = 'none';
+        const result = validateReposTopology(config);
+        assert.strictEqual(result.valid, true, `Expected valid but got errors: ${result.errors.join(', ')}`);
+    });
+    it('rejects invalid ui_layer value', () => {
+        const config = structuredClone(VALID_CONFIG);
+        config.repos.orchestrator.ui_layer = 'angular';
+        const result = validateReposTopology(config);
+        assert.strictEqual(result.valid, false);
+        assert.ok(result.errors.some(e => e.includes('ui_layer')), 'Should mention ui_layer field');
+    });
+});
+// ── AC5: components_path field (optional) ─────────────────────────────
+describe('AC5: components_path field — optional UI component location', () => {
+    it('accepts config with components_path set', () => {
+        const result = validateReposTopology(VALID_CONFIG);
+        assert.strictEqual(result.valid, true, `Expected valid but got errors: ${result.errors.join(', ')}`);
+        assert.strictEqual(VALID_CONFIG.repos.pennyfarthing.components_path, 'packages/cyclist/src/components');
+    });
+    it('accepts config without components_path (optional field)', () => {
+        const config = structuredClone(VALID_CONFIG);
+        delete config.repos.orchestrator.components_path;
+        const result = validateReposTopology(config);
+        assert.strictEqual(result.valid, true, `Expected valid but got errors: ${result.errors.join(', ')}`);
+    });
+    it('rejects components_path when not a string', () => {
+        const config = structuredClone(VALID_CONFIG);
+        config.repos.pennyfarthing.components_path = ['src/components'];
+        const result = validateReposTopology(config);
+        assert.strictEqual(result.valid, false);
+        assert.ok(result.errors.some(e => e.includes('components_path')), 'Should mention components_path field');
+    });
+});
+// ── AC6: Schema validation ────────────────────────────────────────────
+describe('AC6: Schema validation — structural correctness', () => {
+    it('rejects null input', () => {
+        const result = validateReposTopology(null);
+        assert.strictEqual(result.valid, false);
+    });
+    it('rejects input without repos key', () => {
+        const result = validateReposTopology({ notRepos: {} });
+        assert.strictEqual(result.valid, false);
+        assert.ok(result.errors.some(e => e.includes('repos')));
+    });
+    it('rejects repos that is not an object', () => {
+        const result = validateReposTopology({ repos: 'bad' });
+        assert.strictEqual(result.valid, false);
+    });
+    it('rejects repo entry without required path field', () => {
+        const config = {
+            repos: {
+                myrepo: { type: 'app', description: 'test' },
+            },
+        };
+        const result = validateReposTopology(config);
+        assert.strictEqual(result.valid, false);
+        assert.ok(result.errors.some(e => e.includes('path')));
+    });
+    it('rejects repo entry without required type field', () => {
+        const config = {
+            repos: {
+                myrepo: { path: '.', description: 'test' },
+            },
+        };
+        const result = validateReposTopology(config);
+        assert.strictEqual(result.valid, false);
+        assert.ok(result.errors.some(e => e.includes('type')));
+    });
+    it('rejects repo entry without required description field', () => {
+        const config = {
+            repos: {
+                myrepo: { path: '.', type: 'app' },
+            },
+        };
+        const result = validateReposTopology(config);
+        assert.strictEqual(result.valid, false);
+        assert.ok(result.errors.some(e => e.includes('description')));
+    });
+    it('validates a fully populated config', () => {
+        const result = validateReposTopology(VALID_CONFIG);
+        assert.strictEqual(result.valid, true, `Expected valid but got errors: ${result.errors.join(', ')}`);
+    });
+});
+// ── AC7: Backwards compatibility ──────────────────────────────────────
+describe('AC7: Backwards compatibility — legacy configs still valid', () => {
+    it('accepts legacy config without any topology fields', () => {
+        const result = validateReposTopology(LEGACY_CONFIG);
+        assert.strictEqual(result.valid, true, `Legacy config should be valid. Errors: ${result.errors.join(', ')}`);
+    });
+    it('accepts config with only some topology fields set', () => {
+        const config = structuredClone(LEGACY_CONFIG);
+        config.repos.orchestrator.owns = ['sprint/**'];
+        // No never_edit, symlinks, ui_layer, or components_path
+        const result = validateReposTopology(config);
+        assert.strictEqual(result.valid, true, `Partial topology should be valid. Errors: ${result.errors.join(', ')}`);
+    });
+    it('preserves existing fields alongside new topology fields', () => {
+        const config = structuredClone(VALID_CONFIG);
+        // Verify base fields still present
+        assert.strictEqual(config.repos.orchestrator.path, '.');
+        assert.strictEqual(config.repos.orchestrator.type, 'orchestrator');
+        assert.strictEqual(config.repos.orchestrator.description, 'Sprint management and coordination');
+        assert.strictEqual(config.repos.orchestrator.language, 'javascript');
+        assert.strictEqual(config.repos.orchestrator.build_command, 'npm install');
+        // And topology fields coexist
+        assert.ok(Array.isArray(config.repos.orchestrator.owns));
+        assert.ok(Array.isArray(config.repos.orchestrator.never_edit));
+    });
+});
+//# sourceMappingURL=repos-topology.test.js.map

package/packages/core/dist/shared/repos-topology.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repos-topology.test.js","sourceRoot":"","sources":["../../src/shared/repos-topology.test.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,uDAAuD;AACvD,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,MAAM,MAAM,aAAa,CAAC;AACjC,OAAO,EAAE,qBAAqB,EAAoB,MAAM,qBAAqB,CAAC;AAE9E,yEAAyE;AAEzE,oDAAoD;AACpD,MAAM,YAAY,GAAgB;IAChC,KAAK,EAAE;QACL,YAAY,EAAE;YACZ,IAAI,EAAE,GAAG;YACT,IAAI,EAAE,cAAc;YACpB,WAAW,EAAE,oCAAoC;YACjD,QAAQ,EAAE,YAAY;YACtB,aAAa,EAAE,aAAa;YAC5B,IAAI,EAAE,CAAC,WAAW,EAAE,SAAS,EAAE,aAAa,CAAC;YAC7C,UAAU,EAAE,CAAC,iBAAiB,EAAE,mBAAmB,CAAC;YACpD,QAAQ,EAAE;gBACR,uBAAuB,EAAE,yCAAyC;gBAClE,wBAAwB,EAAE,0CAA0C;aACrE;YACD,QAAQ,EAAE,MAAM;SACjB;QACD,aAAa,EAAE;YACb,IAAI,EAAE,eAAe;YACrB,IAAI,EAAE,WAAW;YACjB,WAAW,EAAE,gCAAgC;YAC7C,QAAQ,EAAE,YAAY;YACtB,YAAY,EAAE,WAAW;YACzB,aAAa,EAAE,YAAY;YAC3B,IAAI,EAAE,CAAC,uBAAuB,EAAE,aAAa,CAAC;YAC9C,UAAU,EAAE,CAAC,iBAAiB,EAAE,SAAS,CAAC;YAC1C,QAAQ,EAAE,EAAE;YACZ,QAAQ,EAAE,OAAO;YACjB,eAAe,EAAE,iCAAiC;SACnD;KACF;CACF,CAAC;AAEF,0EAA0E;AAC1E,MAAM,aAAa,GAAgB;IACjC,KAAK,EAAE;QACL,YAAY,EAAE;YACZ,IAAI,EAAE,GAAG;YACT,IAAI,EAAE,cAAc;YACpB,WAAW,EAAE,mBAAmB;YAChC,QAAQ,EAAE,YAAY;YACtB,aAAa,EAAE,aAAa;SAC7B;KACF;CACF,CAAC;AAEF,yEAAyE;AAEzE,QAAQ,CAAC,yDAAyD,EAAE,GAAG,EAAE;IACvE,EAAE,CAAC,6CAA6C,EAAE,GAAG,EAAE;QACrD,MAAM,MAAM,GAAG,qBAAqB,CAAC,YAAY,CAAC,CAAC;QACnD,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,kCAAkC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACvG,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;QACxC,MAAM,MAAM,GAAG,eAAe,CAAC,YAAY,CAAC,CAAC;QAC5C,MAAM,CAAC,KAAK,CAAC,YAAoB,CAAC,IAAI,GAAG,WAAW,CAAC;QACtD,MAAM,MAAM,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;QAC7C,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QACxC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,EAAE,2BAA2B,CAAC,CAAC;IACtF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;QAC9C,MAAM,MAAM,GAAG,eAAe,CAAC,YAAY,CAAC,CAAC;QAC5C,MAAM,CAAC,KAAK,CAAC,YAAoB,CAAC,IAAI,GAAG,CAAC,WAAW,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC;QAClE,MAAM,MAAM,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;QAC7C,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QACxC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,EAAE,2BAA2B,CAAC,CAAC;IACtF,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,yEAAyE;AAEzE,QAAQ,CAAC,0CAA0C,EAAE,GAAG,EAAE;IACxD,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;QACxC,MAAM,MAAM,GAAG,qBAAqB,CAAC,YAAY,CAAC,CAAC;QACnD,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,kCAAkC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACvG,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;QAC9C,MAAM,MAAM,GAAG,eAAe,CAAC,YAAY,CAAC,CAAC;QAC5C,MAAM,CAAC,KAAK,CAAC,YAAoB,CAAC,UAAU,GAAG,iBAAiB,CAAC;QAClE,MAAM,MAAM,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;QAC7C,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QACxC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,EAAE,iCAAiC,CAAC,CAAC;IAClG,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4CAA4C,EAAE,GAAG,EAAE;QACpD,MAAM,MAAM,GAAG,eAAe,CAAC,YAAY,CAAC,CAAC;QAC5C,MAAM,CAAC,KAAK,CAAC,aAAqB,CAAC,UAAU,GAAG,CAAC,GAAG,CAAC,CAAC;QACvD,MAAM,MAAM,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;QAC7C,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QACxC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,EAAE,iCAAiC,CAAC,CAAC;IAClG,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,yEAAyE;AAEzE,QAAQ,CAAC,2DAA2D,EAAE,GAAG,EAAE;IACzE,EAAE,CAAC,+BAA+B,EAAE,GAAG,EAAE;QACvC,MAAM,MAAM,GAAG,qBAAqB,CAAC,YAAY,CAAC,CAAC;QACnD,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,kCAAkC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACvG,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+BAA+B,EAAE,GAAG,EAAE;QACvC,MAAM,MAAM,GAAG,eAAe,CAAC,YAAY,CAAC,CAAC;QAC7C,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,QAAQ,GAAG,EAAE,CAAC;QACxC,MAAM,MAAM,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;QAC7C,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,kCAAkC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACvG,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;QAC7C,MAAM,MAAM,GAAG,eAAe,CAAC,YAAY,CAAC,CAAC;QAC5C,MAAM,CAAC,KAAK,CAAC,YAAoB,CAAC,QAAQ,GAAG,CAAC,uBAAuB,CAAC,CAAC;QACxE,MAAM,MAAM,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;QAC7C,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QACxC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,EAAE,+BAA+B,CAAC,CAAC;IAC9F,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yCAAyC,EAAE,GAAG,EAAE;QACjD,MAAM,MAAM,GAAG,eAAe,CAAC,YAAY,CAAC,CAAC;QAC5C,MAAM,CAAC,KAAK,CAAC,YAAoB,CAAC,QAAQ,GAAG,EAAE,uBAAuB,EAAE,EAAE,EAAE,CAAC;QAC9E,MAAM,MAAM,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;QAC7C,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QACxC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,EAAE,+BAA+B,CAAC,CAAC;IAC9F,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,yEAAyE;AAEzE,QAAQ,CAAC,yCAAyC,EAAE,GAAG,EAAE;IACvD,EAAE,CAAC,2BAA2B,EAAE,GAAG,EAAE;QACnC,MAAM,MAAM,GAAG,eAAe,CAAC,YAAY,CAAC,CAAC;QAC7C,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC,QAAQ,GAAG,OAAO,CAAC;QAC9C,MAAM,MAAM,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;QAC7C,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,kCAAkC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACvG,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yBAAyB,EAAE,GAAG,EAAE;QACjC,MAAM,MAAM,GAAG,eAAe,CAAC,YAAY,CAAC,CAAC;QAC7C,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC,QAAQ,GAAG,KAAK,CAAC;QAC5C,MAAM,MAAM,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;QAC7C,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,kCAAkC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACvG,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0BAA0B,EAAE,GAAG,EAAE;QAClC,MAAM,MAAM,GAAG,eAAe,CAAC,YAAY,CAAC,CAAC;QAC7C,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,QAAQ,GAAG,MAAM,CAAC;QAC5C,MAAM,MAAM,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;QAC7C,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,kCAAkC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACvG,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;QACxC,MAAM,MAAM,GAAG,eAAe,CAAC,YAAY,CAAC,CAAC;QAC5C,MAAM,CAAC,KAAK,CAAC,YAAoB,CAAC,QAAQ,GAAG,SAAS,CAAC;QACxD,MAAM,MAAM,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;QAC7C,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QACxC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,EAAE,+BAA+B,CAAC,CAAC;IAC9F,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,yEAAyE;AAEzE,QAAQ,CAAC,6DAA6D,EAAE,GAAG,EAAE;IAC3E,EAAE,CAAC,yCAAyC,EAAE,GAAG,EAAE;QACjD,MAAM,MAAM,GAAG,qBAAqB,CAAC,YAAY,CAAC,CAAC;QACnD,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,kCAAkC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACrG,MAAM,CAAC,WAAW,CAAC,YAAY,CAAC,KAAK,CAAC,aAAa,CAAC,eAAe,EAAE,iCAAiC,CAAC,CAAC;IAC1G,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yDAAyD,EAAE,GAAG,EAAE;QACjE,MAAM,MAAM,GAAG,eAAe,CAAC,YAAY,CAAC,CAAC;QAC7C,OAAO,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,eAAe,CAAC;QACjD,MAAM,MAAM,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;QAC7C,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,kCAAkC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACvG,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;QACnD,MAAM,MAAM,GAAG,eAAe,CAAC,YAAY,CAAC,CAAC;QAC5C,MAAM,CAAC,KAAK,CAAC,aAAqB,CAAC,eAAe,GAAG,CAAC,gBAAgB,CAAC,CAAC;QACzE,MAAM,MAAM,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;QAC7C,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QACxC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAAC,EAAE,sCAAsC,CAAC,CAAC;IAC5G,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,yEAAyE;AAEzE,QAAQ,CAAC,iDAAiD,EAAE,GAAG,EAAE;IAC/D,EAAE,CAAC,oBAAoB,EAAE,GAAG,EAAE;QAC5B,MAAM,MAAM,GAAG,qBAAqB,CAAC,IAAI,CAAC,CAAC;QAC3C,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iCAAiC,EAAE,GAAG,EAAE;QACzC,MAAM,MAAM,GAAG,qBAAqB,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAC;QACvD,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QACxC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IAC1D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;QAC7C,MAAM,MAAM,GAAG,qBAAqB,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;QACvD,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gDAAgD,EAAE,GAAG,EAAE;QACxD,MAAM,MAAM,GAAG;YACb,KAAK,EAAE;gBACL,MAAM,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE;aAC7C;SACF,CAAC;QACF,MAAM,MAAM,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;QAC7C,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QACxC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IACzD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gDAAgD,EAAE,GAAG,EAAE;QACxD,MAAM,MAAM,GAAG;YACb,KAAK,EAAE;gBACL,MAAM,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,WAAW,EAAE,MAAM,EAAE;aAC3C;SACF,CAAC;QACF,MAAM,MAAM,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;QAC7C,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QACxC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IACzD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uDAAuD,EAAE,GAAG,EAAE;QAC/D,MAAM,MAAM,GAAG;YACb,KAAK,EAAE;gBACL,MAAM,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE;aACnC;SACF,CAAC;QACF,MAAM,MAAM,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;QAC7C,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QACxC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;IAChE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;QAC5C,MAAM,MAAM,GAAG,qBAAqB,CAAC,YAAY,CAAC,CAAC;QACnD,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,kCAAkC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACvG,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,yEAAyE;AAEzE,QAAQ,CAAC,2DAA2D,EAAE,GAAG,EAAE;IACzE,EAAE,CAAC,mDAAmD,EAAE,GAAG,EAAE;QAC3D,MAAM,MAAM,GAAG,qBAAqB,CAAC,aAAa,CAAC,CAAC;QACpD,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,0CAA0C,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC/G,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mDAAmD,EAAE,GAAG,EAAE;QAC3D,MAAM,MAAM,GAAG,eAAe,CAAC,aAAa,CAAC,CAAC;QAC9C,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,GAAG,CAAC,WAAW,CAAC,CAAC;QAC/C,wDAAwD;QACxD,MAAM,MAAM,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;QAC7C,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,6CAA6C,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAClH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yDAAyD,EAAE,GAAG,EAAE;QACjE,MAAM,MAAM,GAAG,eAAe,CAAC,YAAY,CAAC,CAAC;QAC7C,mCAAmC;QACnC,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QACxD,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;QACnE,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,WAAW,EAAE,oCAAoC,CAAC,CAAC;QAChG,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;QACrE,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,aAAa,EAAE,aAAa,CAAC,CAAC;QAC3E,8BAA8B;QAC9B,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC;QACzD,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC,CAAC;IACjE,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/packages/core/dist/shared/skill-search.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Skill Search Utility - Story 9-2
+ *
+ * Searches the skill registry by tag, keyword, category, or description query.
+ * Returns matching skills with metadata for discovery and suggestions.
+ */
+export interface SearchOptions {
+    /** Filter by tag (e.g., "tdd", "quality") */
+    tag?: string;
+    /** Filter by keyword (e.g., "jest", "vitest") */
+    keyword?: string;
+    /** Search description text */
+    query?: string;
+    /** Filter by category (e.g., "development", "tools") */
+    category?: string;
+    /** Custom path to registry file (for testing) */
+    registryPath?: string;
+}
+export interface SkillResult {
+    name: string;
+    description: string;
+    category: string;
+    tags: string[];
+    keywords?: string[];
+    version?: string;
+    related_skills?: string[];
+}
+/**
+ * Search skills in the registry based on provided options.
+ *
+ * @param options - Search options (tag, keyword, query, category)
+ * @returns Promise resolving to array of matching skills
+ * @throws Error if registry file not found or invalid category
+ */
+export declare function searchSkills(options: SearchOptions): Promise<SkillResult[]>;
+//# sourceMappingURL=skill-search.d.ts.map

package/packages/core/dist/shared/skill-search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-search.d.ts","sourceRoot":"","sources":["../../src/shared/skill-search.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,MAAM,WAAW,aAAa;IAC5B,6CAA6C;IAC7C,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,iDAAiD;IACjD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8BAA8B;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wDAAwD;IACxD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iDAAiD;IACjD,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;CAC3B;AAmLD;;;;;;GAMG;AACH,wBAAsB,YAAY,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAoEjF"}