@pennyfarthing/shared 7.5.0 → 9.3.0

package/dist/portrait-resolver.test.js

@@ -0,0 +1,156 @@
+import { describe, it, afterEach } from 'node:test';
+import assert from 'node:assert';
+import path from 'node:path';
+import { resolvePennyfarthingDist, resolvePortraitPath, getPortraitPaths, } from './portrait-resolver.js';
+describe('portrait-resolver', () => {
+    describe('resolvePennyfarthingDist', () => {
+        const originalEnv = process.env.PENNYFARTHING_DIST;
+        afterEach(() => {
+            // Restore original env
+            if (originalEnv !== undefined) {
+                process.env.PENNYFARTHING_DIST = originalEnv;
+            }
+            else {
+                delete process.env.PENNYFARTHING_DIST;
+            }
+        });
+        it('should return PENNYFARTHING_DIST env var when set and path exists', () => {
+            // Scenario 1: Explicit env var override with existing path
+            // Use the actual pennyfarthing-dist path that exists
+            const actualDistPath = resolvePennyfarthingDist();
+            assert.ok(actualDistPath !== null, 'Should have a valid dist path');
+            process.env.PENNYFARTHING_DIST = actualDistPath;
+            const result = resolvePennyfarthingDist();
+            // When env var is set to valid existing path, should return it
+            assert.strictEqual(result, actualDistPath);
+        });
+        it('should fall through when PENNYFARTHING_DIST is set but path does not exist', () => {
+            // Scenario 1b: Env var set but invalid - should fall through to other checks
+            process.env.PENNYFARTHING_DIST = '/nonexistent/path/pennyfarthing-dist';
+            const result = resolvePennyfarthingDist();
+            // Should fall through and find monorepo path (since we're in monorepo)
+            // The key behavior is it doesn't return the invalid env var path
+            assert.ok(result === null || !result.includes('/nonexistent/'));
+        });
+        it('should find monorepo root pennyfarthing-dist directory', () => {
+            // Scenario 2: Monorepo root detection (dogfooding)
+            // When running from within pennyfarthing repo, find pennyfarthing-dist/ at root
+            delete process.env.PENNYFARTHING_DIST;
+            const result = resolvePennyfarthingDist();
+            // Should find the monorepo root path
+            assert.ok(result !== null, 'Should find monorepo root');
+            assert.ok(result.endsWith('pennyfarthing-dist'), 'Path should end with pennyfarthing-dist');
+        });
+        it('should find sibling pennyfarthing-dist directory', () => {
+            // Scenario 3: Sibling directory for dev scenarios
+            // e.g., project/pennyfarthing-dist when called from project/packages/shared
+            delete process.env.PENNYFARTHING_DIST;
+            const result = resolvePennyfarthingDist();
+            // Implementation should check ../pennyfarthing-dist, ../../pennyfarthing-dist, etc.
+            assert.ok(result === null || result.includes('pennyfarthing-dist'));
+        });
+        it('should find scoped npm package path', () => {
+            // Scenario 4: Scoped npm install
+            // node_modules/@pennyfarthing/core/pennyfarthing-dist/
+            delete process.env.PENNYFARTHING_DIST;
+            const result = resolvePennyfarthingDist();
+            // When installed via @pennyfarthing/core, should find that path
+            assert.ok(result === null || result.includes('pennyfarthing-dist'));
+        });
+        it('should find legacy npm package path', () => {
+            // Scenario 5: Legacy npm install
+            // node_modules/pennyfarthing/pennyfarthing-dist/
+            delete process.env.PENNYFARTHING_DIST;
+            const result = resolvePennyfarthingDist();
+            // When installed via pennyfarthing, should find that path
+            assert.ok(result === null || result.includes('pennyfarthing-dist'));
+        });
+        it('should return a valid path or null', () => {
+            // This tests that the function returns a valid result
+            delete process.env.PENNYFARTHING_DIST;
+            const result = resolvePennyfarthingDist();
+            // Result should be either null or a valid pennyfarthing-dist path
+            if (result !== null) {
+                assert.ok(result.includes('pennyfarthing-dist'));
+            }
+        });
+        it('should check paths in priority order - env var takes precedence', () => {
+            // When multiple paths exist, env var should return first if it exists
+            const actualDistPath = resolvePennyfarthingDist();
+            assert.ok(actualDistPath !== null, 'Should have a valid dist path');
+            // Set env var to actual path
+            process.env.PENNYFARTHING_DIST = actualDistPath;
+            const result = resolvePennyfarthingDist();
+            // Env var should take precedence (returns same path since it exists)
+            assert.strictEqual(result, actualDistPath);
+        });
+    });
+    describe('resolvePortraitPath', () => {
+        it('should resolve portrait path for valid theme and agent', () => {
+            // Use a-team which has actual portraits (shakespeare has only .gitkeep)
+            const result = resolvePortraitPath('a-team', 'sm');
+            assert.ok(result !== null, 'Should find portrait');
+            assert.ok(result.includes('a-team'), 'Path should include theme');
+            // Portrait files use character names (faceman) not agent names (sm)
+            assert.ok(result.includes('face'), 'Path should include character name');
+            assert.ok(result.endsWith('.png') || result.endsWith('.jpg'), 'Should be image file');
+        });
+        it('should return null for invalid theme', () => {
+            const result = resolvePortraitPath('nonexistent-theme', 'sm');
+            assert.strictEqual(result, null);
+        });
+        it('should return null for invalid agent', () => {
+            const result = resolvePortraitPath('a-team', 'nonexistent-agent');
+            assert.strictEqual(result, null);
+        });
+        it('should handle theme with special characters in name', () => {
+            // Themes like 'star-trek-tos' have hyphens
+            const result = resolvePortraitPath('star-trek-tos', 'sm');
+            assert.ok(result === null || result.includes('star-trek-tos'));
+        });
+        it('should handle portrait resolution when dist is found', () => {
+            // When resolvePennyfarthingDist returns a valid path, we should be able
+            // to resolve portraits for known themes
+            delete process.env.PENNYFARTHING_DIST;
+            const result = resolvePortraitPath('a-team', 'dev');
+            // If dist is found (which it is in monorepo), should find portrait
+            // dev maps to ba in a-team theme
+            if (result !== null) {
+                assert.ok(result.includes('a-team'));
+                assert.ok(result.includes('ba'));
+            }
+        });
+    });
+    describe('getPortraitPaths', () => {
+        it('should return correct paths structure', () => {
+            const distPath = '/test/pennyfarthing-dist';
+            const result = getPortraitPaths(distPath);
+            assert.ok('portraitsDir' in result, 'Should have portraitsDir');
+            assert.ok('themesDir' in result, 'Should have themesDir');
+            assert.ok('agentsDir' in result, 'Should have agentsDir');
+        });
+        it('should build portraitsDir correctly', () => {
+            const distPath = '/test/pennyfarthing-dist';
+            const result = getPortraitPaths(distPath);
+            // Actual structure: pennyfarthing-dist/personas/portraits/
+            assert.strictEqual(result.portraitsDir, path.join(distPath, 'personas', 'portraits'), 'portraitsDir should be distPath/personas/portraits');
+        });
+        it('should build themesDir correctly', () => {
+            const distPath = '/test/pennyfarthing-dist';
+            const result = getPortraitPaths(distPath);
+            assert.strictEqual(result.themesDir, path.join(distPath, 'personas'), 'themesDir should be distPath/personas');
+        });
+        it('should build agentsDir correctly', () => {
+            const distPath = '/test/pennyfarthing-dist';
+            const result = getPortraitPaths(distPath);
+            assert.strictEqual(result.agentsDir, path.join(distPath, 'agents'), 'agentsDir should be distPath/agents');
+        });
+        it('should handle paths with trailing slashes', () => {
+            const distPath = '/test/pennyfarthing-dist/';
+            const result = getPortraitPaths(distPath);
+            // Should normalize paths correctly
+            assert.ok(!result.portraitsDir.includes('//'), 'Should not have double slashes');
+        });
+    });
+});
+//# sourceMappingURL=portrait-resolver.test.js.map

package/dist/portrait-resolver.test.js.map

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

package/dist/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/dist/skill-search.d.ts.map

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

package/dist/skill-search.js

@@ -0,0 +1,300 @@
+/**
+ * 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.
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { resolvePennyfarthingDist } from './portrait-resolver.js';
+/** Valid categories from the registry */
+const VALID_CATEGORIES = [
+    'ai-llm',
+    'documentation',
+    'development',
+    'tools',
+    'benchmarking',
+    'project-management',
+    'theming'
+];
+/**
+ * Simple YAML parser for skill registry
+ * Handles nested objects and arrays in the specific structure we need
+ */
+function parseRegistryYaml(content) {
+    const result = { version: '', skills: {} };
+    const lines = content.split('\n');
+    let currentSkillKey = null;
+    let currentArrayField = null;
+    let insideExamples = false;
+    for (const line of lines) {
+        const trimmed = line.trimEnd();
+        // Skip empty lines and comments
+        if (!trimmed || trimmed.startsWith('#'))
+            continue;
+        const indent = line.length - line.trimStart().length;
+        const colonIndex = trimmed.indexOf(':');
+        const key = colonIndex >= 0 ? trimmed.substring(0, colonIndex).trim() : trimmed.trim();
+        const value = colonIndex >= 0 ? trimmed.substring(colonIndex + 1).trim() : '';
+        // Top-level version
+        if (indent === 0 && key === 'version') {
+            result.version = value.replace(/^["']|["']$/g, '');
+            continue;
+        }
+        // Top-level skills key
+        if (indent === 0 && key === 'skills') {
+            continue;
+        }
+        // Skill key (indent 2)
+        if (indent === 2 && !trimmed.startsWith('-')) {
+            currentSkillKey = key;
+            result.skills[currentSkillKey] = {
+                name: '',
+                description: '',
+                category: '',
+                tags: [],
+                version: '',
+                prerequisites: [],
+                examples: [],
+                anti_patterns: [],
+                related_skills: [],
+                keywords: []
+            };
+            currentArrayField = null;
+            insideExamples = false;
+            continue;
+        }
+        // Skill fields (indent 4)
+        if (indent === 4 && currentSkillKey) {
+            insideExamples = false;
+            currentArrayField = null;
+            if (key === 'name') {
+                result.skills[currentSkillKey].name = value.replace(/^["']|["']$/g, '');
+            }
+            else if (key === 'description') {
+                result.skills[currentSkillKey].description = value.replace(/^["']|["']$/g, '');
+            }
+            else if (key === 'category') {
+                result.skills[currentSkillKey].category = value.replace(/^["']|["']$/g, '');
+            }
+            else if (key === 'version') {
+                result.skills[currentSkillKey].version = value.replace(/^["']|["']$/g, '');
+            }
+            else if (key === 'tags') {
+                // Inline array: [tag1, tag2]
+                if (value.startsWith('[')) {
+                    result.skills[currentSkillKey].tags = parseInlineArray(value);
+                }
+                else {
+                    currentArrayField = 'tags';
+                }
+            }
+            else if (key === 'keywords') {
+                if (value.startsWith('[')) {
+                    result.skills[currentSkillKey].keywords = parseInlineArray(value);
+                }
+                else {
+                    currentArrayField = 'keywords';
+                }
+            }
+            else if (key === 'prerequisites') {
+                if (value.startsWith('[')) {
+                    result.skills[currentSkillKey].prerequisites = parseInlineArray(value);
+                }
+                else {
+                    currentArrayField = 'prerequisites';
+                }
+            }
+            else if (key === 'related_skills') {
+                if (value.startsWith('[')) {
+                    result.skills[currentSkillKey].related_skills = parseInlineArray(value);
+                }
+                else {
+                    currentArrayField = 'related_skills';
+                }
+            }
+            else if (key === 'anti_patterns') {
+                currentArrayField = 'anti_patterns';
+            }
+            else if (key === 'examples') {
+                insideExamples = true;
+                currentArrayField = null;
+            }
+            continue;
+        }
+        // Array items (indent 6 starting with -)
+        if (indent === 6 && currentSkillKey && trimmed.startsWith('-')) {
+            const itemValue = trimmed.substring(1).trim().replace(/^["']|["']$/g, '');
+            if (insideExamples) {
+                // Start of a new example object
+                result.skills[currentSkillKey].examples.push({ context: '', invocation: '' });
+            }
+            else if (currentArrayField && currentArrayField in result.skills[currentSkillKey]) {
+                const arr = result.skills[currentSkillKey][currentArrayField];
+                if (Array.isArray(arr) && typeof arr[0] !== 'object') {
+                    arr.push(itemValue);
+                }
+            }
+            continue;
+        }
+        // Example sub-fields (indent 8)
+        if (indent === 8 && currentSkillKey && insideExamples) {
+            const examples = result.skills[currentSkillKey].examples;
+            if (examples.length > 0) {
+                const lastExample = examples[examples.length - 1];
+                if (key === 'context') {
+                    lastExample.context = value.replace(/^["']|["']$/g, '');
+                }
+                else if (key === 'invocation') {
+                    lastExample.invocation = value.replace(/^["']|["']$/g, '');
+                }
+            }
+            continue;
+        }
+    }
+    return result;
+}
+/**
+ * Parse inline YAML array like [tag1, tag2, tag3]
+ */
+function parseInlineArray(value) {
+    const match = value.match(/^\[(.*)\]$/);
+    if (!match)
+        return [];
+    return match[1]
+        .split(',')
+        .map(item => item.trim().replace(/^["']|["']$/g, ''))
+        .filter(Boolean);
+}
+/**
+ * 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 async function searchSkills(options) {
+    // Resolve registry path
+    let registryPath = options.registryPath;
+    if (!registryPath) {
+        const distPath = resolvePennyfarthingDist();
+        if (!distPath) {
+            throw new Error('Registry not found: Cannot resolve pennyfarthing-dist directory');
+        }
+        registryPath = join(distPath, 'skills', 'skill-registry.yaml');
+    }
+    // Validate registry exists
+    if (!existsSync(registryPath)) {
+        throw new Error(`Registry not found: ${registryPath}`);
+    }
+    // Validate category if provided
+    if (options.category && !VALID_CATEGORIES.includes(options.category)) {
+        throw new Error(`Invalid category: ${options.category}. Valid categories: ${VALID_CATEGORIES.join(', ')}`);
+    }
+    // Parse registry
+    const content = readFileSync(registryPath, 'utf-8');
+    const registry = parseRegistryYaml(content);
+    // Convert to SkillResult array
+    let results = Object.values(registry.skills).map(skill => ({
+        name: skill.name,
+        description: skill.description,
+        category: skill.category,
+        tags: skill.tags,
+        keywords: skill.keywords.length > 0 ? skill.keywords : undefined,
+        version: skill.version || undefined,
+        related_skills: skill.related_skills.length > 0 ? skill.related_skills : undefined
+    }));
+    // Apply filters (AND logic - all filters must match)
+    // Filter by category
+    if (options.category) {
+        results = results.filter(s => s.category === options.category);
+    }
+    // Filter by tag (case-insensitive)
+    if (options.tag) {
+        const searchTag = options.tag.toLowerCase();
+        results = results.filter(s => s.tags.some(t => t.toLowerCase() === searchTag));
+    }
+    // Filter by keyword (case-insensitive)
+    if (options.keyword) {
+        const searchKeyword = options.keyword.toLowerCase();
+        results = results.filter(s => s.keywords?.some(k => k.toLowerCase() === searchKeyword));
+    }
+    // Filter by query (searches description, case-insensitive)
+    if (options.query) {
+        const searchQuery = options.query.toLowerCase();
+        results = results.filter(s => s.description.toLowerCase().includes(searchQuery));
+    }
+    return results;
+}
+// CLI entry point when run directly
+if (import.meta.url === `file://${process.argv[1]}`) {
+    const args = process.argv.slice(2);
+    const options = {};
+    let jsonOutput = false;
+    // Parse command-line arguments
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (arg === '--help' || arg === '-h') {
+            console.log(`Usage: skill-search [options]
+
+Options:
+  --tag <tag>        Filter by tag (e.g., "tdd", "quality")
+  --keyword <kw>     Filter by keyword (e.g., "jest", "vitest")
+  --query <text>     Search description text
+  --category <cat>   Filter by category
+  --json             Output as JSON (default: table)
+  --help, -h         Show this help
+
+Examples:
+  skill-search --tag tdd
+  skill-search --category development --json
+  skill-search --query "TDD workflow"
+`);
+            process.exit(0);
+        }
+        else if (arg === '--json') {
+            jsonOutput = true;
+        }
+        else if (arg === '--tag' && args[i + 1]) {
+            options.tag = args[++i];
+        }
+        else if (arg === '--keyword' && args[i + 1]) {
+            options.keyword = args[++i];
+        }
+        else if (arg === '--query' && args[i + 1]) {
+            options.query = args[++i];
+        }
+        else if (arg === '--category' && args[i + 1]) {
+            options.category = args[++i];
+        }
+    }
+    searchSkills(options)
+        .then(results => {
+        if (jsonOutput) {
+            console.log(JSON.stringify(results, null, 2));
+        }
+        else {
+            // Table output
+            if (results.length === 0) {
+                console.log('No skills found matching criteria.');
+            }
+            else {
+                const maxName = Math.max(...results.map(s => s.name.length), 4);
+                const maxCat = Math.max(...results.map(s => s.category.length), 8);
+                console.log(`${'NAME'.padEnd(maxName)}  ${'CATEGORY'.padEnd(maxCat)}  DESCRIPTION`);
+                console.log(`${'-'.repeat(maxName)}  ${'-'.repeat(maxCat)}  ${'-'.repeat(40)}`);
+                for (const skill of results) {
+                    const desc = skill.description.length > 50
+                        ? skill.description.substring(0, 47) + '...'
+                        : skill.description;
+                    console.log(`${skill.name.padEnd(maxName)}  ${skill.category.padEnd(maxCat)}  ${desc}`);
+                }
+            }
+        }
+    })
+        .catch(err => {
+        console.error(`Error: ${err.message}`);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=skill-search.js.map

package/dist/skill-search.js.map

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

package/dist/skill-search.sh

@@ -0,0 +1,41 @@
+#!/usr/bin/env bash
+# Skill Search Shell Wrapper - Story 9-2
+#
+# Thin wrapper around the TypeScript skill-search utility.
+# Provides CLI access to skill registry search functionality.
+#
+# Usage:
+#   skill-search.sh [options]
+#
+# Options:
+#   --tag <tag>        Filter by tag (e.g., "tdd", "quality")
+#   --keyword <kw>     Filter by keyword (e.g., "jest", "vitest")
+#   --query <text>     Search description text
+#   --category <cat>   Filter by category
+#   --json             Output as JSON (default: table)
+#   --help, -h         Show this help
+#
+# Examples:
+#   skill-search.sh --tag tdd
+#   skill-search.sh --category development --json
+#   skill-search.sh --query "TDD workflow"
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+
+# Find the compiled JavaScript file
+JS_FILE="$SCRIPT_DIR/../dist/skill-search.js"
+
+if [[ ! -f "$JS_FILE" ]]; then
+  # Try looking relative to where we are in the repo
+  JS_FILE="$(dirname "$SCRIPT_DIR")/dist/skill-search.js"
+fi
+
+if [[ ! -f "$JS_FILE" ]]; then
+  echo "Error: skill-search.js not found. Run 'npm run build' first." >&2
+  exit 1
+fi
+
+# Execute the Node.js script with all arguments
+exec node "$JS_FILE" "$@"

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

@@ -0,0 +1,16 @@
+/**
+ * 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
+ */
+export {};
+//# sourceMappingURL=skill-search.test.d.ts.map

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

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