@pennyfarthing/shared 7.5.0 → 9.3.0

package/dist/skill-search.test.js

@@ -0,0 +1,177 @@
+/**
+ * Tests for Story 9-2: Build Skill Search Utility
+ *
+ * These tests verify:
+ * - Tag filtering returns expected skills
+ * - Keyword search returns expected skills
+ * - Category filtering works
+ * - Combined filters use AND logic
+ * - JSON output is valid and includes required fields
+ * - Empty results return empty array (not error)
+ * - Error handling for missing registry
+ *
+ * Run with: npm test -- scripts/utils/skill-search.test.ts
+ */
+import { describe, it } from 'node:test';
+import assert from 'node:assert';
+import { execSync } from 'child_process';
+import { existsSync } from 'fs';
+import { join } from 'path';
+// Import functions to test - these don't exist yet, tests should fail
+import { searchSkills } from './skill-search.js';
+// Path to the shell wrapper for integration tests
+const WRAPPER_PATH = join(import.meta.dirname, 'skill-search.sh');
+describe('Story 9-2: Skill Search Utility', () => {
+    describe('searchSkills() - Core Function', () => {
+        describe('AC1: Script is functional', () => {
+            it('should read skill-registry.yaml and return all skills when no filters', async () => {
+                // AC1: Reads skill-registry.yaml
+                const results = await searchSkills({});
+                assert.ok(Array.isArray(results), 'Should return an array');
+                assert.ok(results.length > 0, 'Should return skills from registry');
+                assert.ok(results.length === 22, 'Should return all 22 skills when no filters');
+            });
+            it('should return skills with required fields', async () => {
+                // AC1: Each skill should have core metadata
+                const results = await searchSkills({});
+                for (const skill of results) {
+                    assert.ok(skill.name, `Skill should have name`);
+                    assert.ok(skill.description, `Skill ${skill.name} should have description`);
+                    assert.ok(skill.category, `Skill ${skill.name} should have category`);
+                    assert.ok(Array.isArray(skill.tags), `Skill ${skill.name} should have tags array`);
+                }
+            });
+            it('should filter by tag with --tag option', async () => {
+                // AC1: Filters by tag with --tag <category>
+                const results = await searchSkills({ tag: 'tdd' });
+                assert.ok(results.length > 0, 'Should return at least one skill with tdd tag');
+                assert.ok(results.every(s => s.tags.includes('tdd')), 'All results should have tdd tag');
+            });
+            it('should filter by keyword with --keyword option', async () => {
+                // AC1: Filters by keyword with --keyword <term>
+                const results = await searchSkills({ keyword: 'jest' });
+                assert.ok(results.length > 0, 'Should return at least one skill with jest keyword');
+                assert.ok(results.every(s => s.keywords?.includes('jest')), 'All results should have jest in keywords');
+            });
+            it('should search descriptions with --query option', async () => {
+                // AC1: Searches descriptions with --query <text>
+                const results = await searchSkills({ query: 'TDD workflow' });
+                assert.ok(results.length > 0, 'Should return skills matching query');
+                assert.ok(results.some(s => s.description.toLowerCase().includes('tdd')), 'At least one result should mention TDD in description');
+            });
+        });
+        describe('AC2: Tag/keyword search returns expected results', () => {
+            it('should return testing skill when filtering by --tag tdd', async () => {
+                // AC2: --tag development returns skills with that tag
+                const results = await searchSkills({ tag: 'tdd' });
+                const skillNames = results.map(s => s.name);
+                assert.ok(skillNames.includes('testing'), 'Should include testing skill for tdd tag');
+            });
+            it('should return testing skill when filtering by --keyword vitest', async () => {
+                // AC2: --keyword jest returns skills mentioning jest in keywords
+                const results = await searchSkills({ keyword: 'vitest' });
+                const skillNames = results.map(s => s.name);
+                assert.ok(skillNames.includes('testing'), 'Should include testing skill for vitest keyword');
+            });
+            it('should return 4 skills when filtering by --category development', async () => {
+                // AC2: Category filter returns expected count
+                const results = await searchSkills({ category: 'development' });
+                assert.strictEqual(results.length, 4, 'Should return 4 development skills');
+                assert.ok(results.every(s => s.category === 'development'), 'All results should be development category');
+            });
+            it('should combine multiple filters with AND logic', async () => {
+                // AC2: Multiple filters can be combined (AND logic)
+                const results = await searchSkills({
+                    tag: 'quality',
+                    category: 'development'
+                });
+                assert.ok(results.length > 0, 'Should return at least one result');
+                assert.ok(results.length < 3, 'Should be narrower than just category filter');
+                assert.ok(results.every(s => s.category === 'development' && s.tags.includes('quality')), 'All results should match both filters');
+            });
+            it('should return empty array for non-existent tag (not error)', async () => {
+                // AC2: Empty results handled gracefully
+                const results = await searchSkills({ tag: 'nonexistent-tag-xyz' });
+                assert.ok(Array.isArray(results), 'Should return an array');
+                assert.strictEqual(results.length, 0, 'Should return empty array for no matches');
+            });
+            it('should return empty array for non-existent keyword', async () => {
+                // AC2: Empty results for non-existent keyword
+                const results = await searchSkills({ keyword: 'nonexistent-keyword-xyz' });
+                assert.ok(Array.isArray(results), 'Should return an array');
+                assert.strictEqual(results.length, 0, 'Should return empty array for no matches');
+            });
+            it('should handle case-insensitive tag matching', async () => {
+                // AC2: Tags should match case-insensitively
+                const upperResults = await searchSkills({ tag: 'TDD' });
+                const lowerResults = await searchSkills({ tag: 'tdd' });
+                assert.deepStrictEqual(upperResults.map(s => s.name).sort(), lowerResults.map(s => s.name).sort(), 'Tag matching should be case-insensitive');
+            });
+        });
+        describe('AC3: JSON output format', () => {
+            it('should return valid JSON-serializable results', async () => {
+                // AC3: Output should be valid JSON
+                const results = await searchSkills({});
+                const jsonString = JSON.stringify(results);
+                const parsed = JSON.parse(jsonString);
+                assert.ok(Array.isArray(parsed), 'Should produce valid JSON array');
+            });
+            it('should include name, description, category, tags in each result', async () => {
+                // AC3: Each skill object includes: name, description, category, tags
+                const results = await searchSkills({});
+                for (const skill of results) {
+                    assert.ok('name' in skill, 'Should include name');
+                    assert.ok('description' in skill, 'Should include description');
+                    assert.ok('category' in skill, 'Should include category');
+                    assert.ok('tags' in skill, 'Should include tags');
+                }
+            });
+            it('should include keywords in results when present', async () => {
+                // AC3: Keywords should be included for search relevance
+                const results = await searchSkills({ keyword: 'jest' });
+                assert.ok(results.length > 0, 'Should have results');
+                assert.ok(results.every(s => 'keywords' in s), 'All results should include keywords field');
+            });
+        });
+        describe('Error Handling', () => {
+            it('should throw helpful error when registry file is missing', async () => {
+                // Error handling: Missing registry file shows helpful error
+                await assert.rejects(async () => searchSkills({ registryPath: '/nonexistent/path/registry.yaml' }), {
+                    message: /registry.*not found|cannot find|no such file/i
+                }, 'Should throw error with helpful message for missing registry');
+            });
+            it('should throw error for invalid category value', async () => {
+                // Error handling: Invalid category should be rejected
+                await assert.rejects(async () => searchSkills({ category: 'invalid-category' }), {
+                    message: /invalid category|unknown category/i
+                }, 'Should throw error for invalid category');
+            });
+        });
+    });
+    describe('Shell Wrapper Integration', { skip: !existsSync(WRAPPER_PATH) }, () => {
+        // Skip all wrapper tests if skill-search.sh doesn't exist yet
+        it('should execute via bash wrapper', () => {
+            const result = execSync(`bash ${WRAPPER_PATH} --help`, { encoding: 'utf-8' });
+            assert.ok(result.includes('search') || result.includes('usage'), 'Should show help text');
+        });
+        it('should output JSON with --json flag via wrapper', () => {
+            const result = execSync(`bash ${WRAPPER_PATH} --json`, { encoding: 'utf-8' });
+            const parsed = JSON.parse(result);
+            assert.ok(Array.isArray(parsed), 'Should output valid JSON array');
+        });
+        it('should filter by tag via wrapper', () => {
+            const result = execSync(`bash ${WRAPPER_PATH} --tag tdd --json`, { encoding: 'utf-8' });
+            const parsed = JSON.parse(result);
+            assert.ok(parsed.length > 0, 'Should return results for tdd tag');
+            assert.ok(parsed.every((s) => s.tags.includes('tdd')), 'All results should have tdd tag');
+        });
+        it('should show human-readable table without --json flag', () => {
+            const result = execSync(`bash ${WRAPPER_PATH} --tag tdd`, { encoding: 'utf-8' });
+            // Should not be valid JSON (it's a table)
+            assert.throws(() => JSON.parse(result), 'Non-JSON output should not be valid JSON');
+            // Should contain skill name and some formatting
+            assert.ok(result.includes('testing'), 'Should show testing skill name');
+        });
+    });
+});
+//# sourceMappingURL=skill-search.test.js.map

package/dist/skill-search.test.js.map

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

package/dist/skill-suggest.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Skill Suggestions Utility - Story 9-3
+ *
+ * Provides intelligent skill suggestions based on:
+ * - AC1: Session context (story, ACs, phase)
+ * - AC2: Keyword extraction and matching
+ * - AC3: Non-intrusive presentation (thresholds, limits)
+ *
+ * Reuses searchSkills() from skill-search.ts for registry access.
+ */
+/**
+ * Session context for story-aware suggestions
+ */
+export interface SessionContext {
+    /** Story identifier (e.g., "9-3") */
+    storyId: string;
+    /** List of acceptance criteria */
+    acceptanceCriteria: string[];
+    /** Current workflow phase */
+    phase: string;
+    /** Optional Jira issue key */
+    jiraKey?: string;
+}
+/**
+ * Options for skill suggestions
+ */
+export interface SuggestOptions {
+    /** Minimum confidence score (0-1) to include suggestion. Default: 0.3 */
+    confidenceThreshold?: number;
+    /** Maximum number of suggestions to return. Default: 5 */
+    maxResults?: number;
+    /** Skills to exclude from suggestions (already in use) */
+    excludeSkills?: string[];
+    /** Session context for combined suggestions */
+    sessionContext?: SessionContext;
+    /** Custom path to registry file (for testing) */
+    registryPath?: string;
+}
+/**
+ * A skill suggestion with relevance scoring
+ */
+export interface SkillSuggestion {
+    /** Skill name */
+    name: string;
+    /** Skill description */
+    description: string;
+    /** Relevance score (0-1) */
+    score: number;
+    /** Reason for suggesting this skill */
+    reason: string;
+    /** What triggered the match (keywords, tags, phase) */
+    matchedOn?: string[];
+}
+/**
+ * Suggest skills based on session context (story, ACs, phase)
+ *
+ * @param context - Session context with story details
+ * @returns Promise resolving to array of skill suggestions
+ */
+export declare function suggestFromSession(context: SessionContext): Promise<SkillSuggestion[]>;
+/**
+ * Suggest skills based on keywords in user input
+ *
+ * @param userInput - User's message or query
+ * @returns Promise resolving to array of skill suggestions
+ */
+export declare function suggestFromKeywords(userInput: string): Promise<SkillSuggestion[]>;
+/**
+ * Main suggestion function combining session context and keywords
+ *
+ * @param userInput - User's message or query
+ * @param options - Suggestion options (threshold, limits, exclusions)
+ * @returns Promise resolving to filtered, limited skill suggestions
+ */
+export declare function suggestSkills(userInput: string, options?: SuggestOptions): Promise<SkillSuggestion[]>;
+//# sourceMappingURL=skill-suggest.d.ts.map

package/dist/skill-suggest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-suggest.d.ts","sourceRoot":"","sources":["../src/skill-suggest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,qCAAqC;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,kCAAkC;IAClC,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,6BAA6B;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,8BAA8B;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,yEAAyE;IACzE,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,0DAA0D;IAC1D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,0DAA0D;IAC1D,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,+CAA+C;IAC/C,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,iDAAiD;IACjD,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,iBAAiB;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,wBAAwB;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,4BAA4B;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,uCAAuC;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,uDAAuD;IACvD,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAyDD;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,eAAe,EAAE,CAAC,CA0D5B;AAED;;;;;GAKG;AACH,wBAAsB,mBAAmB,CACvC,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,eAAe,EAAE,CAAC,CAqD5B;AAED;;;;;;GAMG;AACH,wBAAsB,aAAa,CACjC,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,eAAe,EAAE,CAAC,CA2E5B"}

package/dist/skill-suggest.js

@@ -0,0 +1,256 @@
+/**
+ * Skill Suggestions Utility - Story 9-3
+ *
+ * Provides intelligent skill suggestions based on:
+ * - AC1: Session context (story, ACs, phase)
+ * - AC2: Keyword extraction and matching
+ * - AC3: Non-intrusive presentation (thresholds, limits)
+ *
+ * Reuses searchSkills() from skill-search.ts for registry access.
+ */
+import { searchSkills } from './skill-search.js';
+/** Phase to skill mappings for session-aware suggestions */
+const PHASE_SKILL_MAP = {
+    testing: ['testing'],
+    development: ['dev-patterns', 'testing'],
+    review: ['code-review'],
+    planning: ['story-management', 'sprint-context'],
+    deployment: ['just', 'run-ci'],
+};
+/** Keywords that suggest specific skills */
+const SKILL_KEYWORDS = {
+    testing: [
+        'test', 'tests', 'testing', 'tdd', 'unit', 'integration', 'jest', 'vitest',
+        'mocha', 'pytest', 'coverage', 'spec', 'specs', 'assertion', 'mock', 'stub'
+    ],
+    'code-review': [
+        'review', 'reviewing', 'pr', 'pull request', 'code review', 'approve', 'reject'
+    ],
+    'dev-patterns': [
+        'pattern', 'patterns', 'implement', 'implementation', 'refactor', 'fix', 'bug'
+    ],
+    jira: [
+        'jira', 'ticket', 'issue', 'sprint', 'backlog', 'story', 'epic', 'mssci'
+    ],
+    just: [
+        'just', 'justfile', 'recipe', 'task', 'run', 'build', 'script'
+    ],
+    'run-ci': [
+        'ci', 'cd', 'pipeline', 'deploy', 'deployment', 'production', 'staging'
+    ],
+    changelog: [
+        'changelog', 'release', 'version', 'document', 'documentation', 'docs', 'readme'
+    ],
+    theme: [
+        'theme', 'themes', 'persona', 'character', 'style'
+    ],
+    mermaid: [
+        'diagram', 'flowchart', 'sequence', 'architecture', 'uml', 'mermaid'
+    ],
+    'story-management': [
+        'story', 'stories', 'sizing', 'estimate', 'points', 'planning'
+    ],
+    'sprint-context': [
+        'sprint', 'backlog', 'velocity', 'status', 'current sprint'
+    ],
+};
+/** Tags that map to skills */
+const TAG_SKILL_MAP = {
+    quality: ['testing', 'code-review'],
+    tdd: ['testing'],
+    workflow: ['story-management', 'sprint-context'],
+    documentation: ['changelog', 'mermaid'],
+};
+/**
+ * Suggest skills based on session context (story, ACs, phase)
+ *
+ * @param context - Session context with story details
+ * @returns Promise resolving to array of skill suggestions
+ */
+export async function suggestFromSession(context) {
+    // Return empty for missing context
+    if (!context.storyId && context.acceptanceCriteria.length === 0) {
+        return [];
+    }
+    const suggestions = [];
+    const seen = new Set();
+    // 1. Phase-based suggestions
+    const phaseSkills = PHASE_SKILL_MAP[context.phase] || [];
+    for (const skillName of phaseSkills) {
+        if (!seen.has(skillName)) {
+            seen.add(skillName);
+            suggestions.push({
+                name: skillName,
+                description: await getSkillDescription(skillName),
+                score: 0.8,
+                reason: `Suggested for ${context.phase} phase of the workflow`,
+                matchedOn: [`phase:${context.phase}`],
+            });
+        }
+    }
+    // 2. AC-based suggestions - scan for keywords
+    const acText = context.acceptanceCriteria.join(' ').toLowerCase();
+    for (const [skillName, keywords] of Object.entries(SKILL_KEYWORDS)) {
+        if (seen.has(skillName))
+            continue;
+        const matchedKeywords = keywords.filter(kw => acText.includes(kw));
+        if (matchedKeywords.length > 0) {
+            seen.add(skillName);
+            suggestions.push({
+                name: skillName,
+                description: await getSkillDescription(skillName),
+                score: Math.min(0.5 + matchedKeywords.length * 0.1, 1.0),
+                reason: `Acceptance criteria mention: ${matchedKeywords.slice(0, 3).join(', ')}`,
+                matchedOn: matchedKeywords.map(kw => `keyword:${kw}`),
+            });
+        }
+    }
+    // 3. Jira context
+    if (context.jiraKey && !seen.has('jira')) {
+        seen.add('jira');
+        suggestions.push({
+            name: 'jira',
+            description: await getSkillDescription('jira'),
+            score: 0.7,
+            reason: `Story has Jira reference: ${context.jiraKey}`,
+            matchedOn: [`jira:${context.jiraKey}`],
+        });
+    }
+    // Sort by score descending
+    suggestions.sort((a, b) => b.score - a.score);
+    return suggestions;
+}
+/**
+ * Suggest skills based on keywords in user input
+ *
+ * @param userInput - User's message or query
+ * @returns Promise resolving to array of skill suggestions
+ */
+export async function suggestFromKeywords(userInput) {
+    if (!userInput || userInput.trim() === '') {
+        return [];
+    }
+    const inputLower = userInput.toLowerCase();
+    const suggestions = [];
+    // Check keyword matches
+    for (const [skillName, keywords] of Object.entries(SKILL_KEYWORDS)) {
+        const matchedKeywords = keywords.filter(kw => inputLower.includes(kw));
+        if (matchedKeywords.length > 0) {
+            // Score based on number of matches, normalized to 0-1
+            const score = Math.min(matchedKeywords.length * 0.2, 1.0);
+            suggestions.push({
+                name: skillName,
+                description: await getSkillDescription(skillName),
+                score,
+                reason: `Matched keywords: ${matchedKeywords.join(', ')}`,
+                matchedOn: matchedKeywords.map(kw => `keyword:${kw}`),
+            });
+        }
+    }
+    // Check tag matches
+    for (const [tag, skillNames] of Object.entries(TAG_SKILL_MAP)) {
+        if (inputLower.includes(tag)) {
+            for (const skillName of skillNames) {
+                // Check if we already have this skill
+                const existing = suggestions.find(s => s.name === skillName);
+                if (existing) {
+                    // Boost score and add tag to matchedOn
+                    existing.score = Math.min(existing.score + 0.15, 1.0);
+                    existing.matchedOn?.push(`tag:${tag}`);
+                }
+                else {
+                    suggestions.push({
+                        name: skillName,
+                        description: await getSkillDescription(skillName),
+                        score: 0.4,
+                        reason: `Matched tag: ${tag}`,
+                        matchedOn: [`tag:${tag}`],
+                    });
+                }
+            }
+        }
+    }
+    // Sort by score descending
+    suggestions.sort((a, b) => b.score - a.score);
+    return suggestions;
+}
+/**
+ * Main suggestion function combining session context and keywords
+ *
+ * @param userInput - User's message or query
+ * @param options - Suggestion options (threshold, limits, exclusions)
+ * @returns Promise resolving to filtered, limited skill suggestions
+ */
+export async function suggestSkills(userInput, options = {}) {
+    const { confidenceThreshold = 0.3, maxResults = 5, excludeSkills = [], sessionContext, registryPath, } = options;
+    // Handle empty input
+    if (!userInput || userInput.trim() === '') {
+        return [];
+    }
+    // Handle missing registry gracefully
+    if (registryPath) {
+        try {
+            await searchSkills({ registryPath });
+        }
+        catch {
+            return [];
+        }
+    }
+    // Get keyword suggestions
+    const keywordSuggestions = await suggestFromKeywords(userInput);
+    // Get session suggestions if context provided
+    let sessionSuggestions = [];
+    if (sessionContext) {
+        sessionSuggestions = await suggestFromSession(sessionContext);
+    }
+    // Merge suggestions, boosting skills that appear in both
+    const merged = new Map();
+    for (const suggestion of keywordSuggestions) {
+        merged.set(suggestion.name, suggestion);
+    }
+    for (const suggestion of sessionSuggestions) {
+        const existing = merged.get(suggestion.name);
+        if (existing) {
+            // Strong boost when found in both sources - these are high priority
+            existing.score = Math.min(existing.score + suggestion.score, 1.0);
+            existing.matchedOn = [
+                ...(existing.matchedOn || []),
+                ...(suggestion.matchedOn || []),
+            ];
+            if (suggestion.reason && !existing.reason.includes(suggestion.reason)) {
+                existing.reason = `${existing.reason}; ${suggestion.reason}`;
+            }
+        }
+        else {
+            merged.set(suggestion.name, suggestion);
+        }
+    }
+    // Convert to array and filter
+    let results = Array.from(merged.values());
+    // Exclude already-used skills
+    if (excludeSkills.length > 0) {
+        const excludeSet = new Set(excludeSkills.map(s => s.toLowerCase()));
+        results = results.filter(s => !excludeSet.has(s.name.toLowerCase()));
+    }
+    // Filter by confidence threshold
+    results = results.filter(s => s.score >= confidenceThreshold);
+    // Sort by score descending
+    results.sort((a, b) => b.score - a.score);
+    // Limit results
+    results = results.slice(0, maxResults);
+    return results;
+}
+/**
+ * Get skill description from registry or use fallback
+ */
+async function getSkillDescription(skillName) {
+    try {
+        const results = await searchSkills({});
+        const skill = results.find(s => s.name.toLowerCase() === skillName.toLowerCase());
+        return skill?.description || `${skillName} skill`;
+    }
+    catch {
+        return `${skillName} skill`;
+    }
+}
+//# sourceMappingURL=skill-suggest.js.map

package/dist/skill-suggest.js.map

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

package/dist/skill-suggest.test.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Tests for Story 9-3: Add Skill Suggestions to Agents
+ *
+ * These tests verify:
+ * - AC1: Session-aware suggestions based on story context
+ * - AC2: Keyword-triggered suggestions with scoring
+ * - AC3: Non-intrusive presentation (confidence threshold, limits)
+ *
+ * Run with: npm test -- packages/shared/src/skill-suggest.test.ts
+ */
+export {};
+//# sourceMappingURL=skill-suggest.test.d.ts.map

package/dist/skill-suggest.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-suggest.test.d.ts","sourceRoot":"","sources":["../src/skill-suggest.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}