@pennyfarthing/shared 7.5.0 → 7.9.0

package/dist/marker/strip.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Strip functions for the Reflector marker system.
+ *
+ * @see docs/adr/0011-reflector-marker-consolidation.md
+ */
+/**
+ * Strip fenced code blocks from text.
+ *
+ * Used before marker detection to ensure markers inside code blocks
+ * are not processed as actual markers.
+ *
+ * @param text - Text potentially containing fenced code blocks
+ * @returns Text with code blocks removed
+ */
+export declare function stripCodeBlocks(text: string): string;
+/**
+ * Strip CYCLIST markers from text for display.
+ *
+ * Removes all CYCLIST markers while preserving surrounding text.
+ * Useful for cleaning agent output before displaying to users.
+ *
+ * @param text - Text containing markers
+ * @returns Text with markers removed
+ */
+export declare function stripMarkers(text: string): string;
+//# sourceMappingURL=strip.d.ts.map

package/dist/marker/strip.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"strip.d.ts","sourceRoot":"","sources":["../../src/marker/strip.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKpD;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAOjD"}

package/dist/marker/strip.js

@@ -0,0 +1,39 @@
+/**
+ * Strip functions for the Reflector marker system.
+ *
+ * @see docs/adr/0011-reflector-marker-consolidation.md
+ */
+import { MARKER_PATTERN } from './constants.js';
+/**
+ * Strip fenced code blocks from text.
+ *
+ * Used before marker detection to ensure markers inside code blocks
+ * are not processed as actual markers.
+ *
+ * @param text - Text potentially containing fenced code blocks
+ * @returns Text with code blocks removed
+ */
+export function stripCodeBlocks(text) {
+    if (!text) {
+        return '';
+    }
+    return text.replace(/```[\s\S]*?```/g, '');
+}
+/**
+ * Strip CYCLIST markers from text for display.
+ *
+ * Removes all CYCLIST markers while preserving surrounding text.
+ * Useful for cleaning agent output before displaying to users.
+ *
+ * @param text - Text containing markers
+ * @returns Text with markers removed
+ */
+export function stripMarkers(text) {
+    if (!text) {
+        return '';
+    }
+    // Reset lastIndex since MARKER_PATTERN is global
+    MARKER_PATTERN.lastIndex = 0;
+    return text.replace(MARKER_PATTERN, '').trim();
+}
+//# sourceMappingURL=strip.js.map

package/dist/marker/strip.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"strip.js","sourceRoot":"","sources":["../../src/marker/strip.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEhD;;;;;;;;GAQG;AACH,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,OAAO,IAAI,CAAC,OAAO,CAAC,iBAAiB,EAAE,EAAE,CAAC,CAAC;AAC7C,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,iDAAiD;IACjD,cAAc,CAAC,SAAS,GAAG,CAAC,CAAC;IAC7B,OAAO,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;AACjD,CAAC"}

package/dist/marker/types.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Type definitions for the Reflector marker system.
+ *
+ * @see docs/adr/0011-reflector-marker-consolidation.md
+ */
+/**
+ * Marker types supported by the Reflector protocol.
+ * These map to UI actions in Cyclist and VS Code extension.
+ */
+export type MarkerType = 'handoff' | 'context_clear' | 'invoke' | 'question' | 'choices';
+/**
+ * Parsed marker from agent output.
+ *
+ * @property type - The marker type (normalized to lowercase)
+ * @property value - The marker value (case preserved)
+ * @property source - Optional source identifier (always 'structured_marker' when detected)
+ */
+export interface Marker {
+    type: MarkerType;
+    value: string;
+    source?: 'structured_marker';
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/marker/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/marker/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;GAGG;AACH,MAAM,MAAM,UAAU,GAClB,SAAS,GACT,eAAe,GACf,QAAQ,GACR,UAAU,GACV,SAAS,CAAC;AAEd;;;;;;GAMG;AACH,MAAM,WAAW,MAAM;IACrB,IAAI,EAAE,UAAU,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,mBAAmB,CAAC;CAC9B"}

package/dist/marker/types.js

@@ -0,0 +1,7 @@
+/**
+ * Type definitions for the Reflector marker system.
+ *
+ * @see docs/adr/0011-reflector-marker-consolidation.md
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/marker/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/marker/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/migrate-theme-schema.test.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Theme Schema Migration Tests - MSSCI-12478
+ *
+ * Tests for the migration script that consolidates quote into catchphrases.
+ * RED STATE: These tests should FAIL until implementation is complete.
+ */
+export {};
+//# sourceMappingURL=migrate-theme-schema.test.d.ts.map

package/dist/migrate-theme-schema.test.d.ts.map

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

package/dist/migrate-theme-schema.test.js

@@ -0,0 +1,67 @@
+/**
+ * Theme Schema Migration Tests - MSSCI-12478
+ *
+ * Tests for the migration script that consolidates quote into catchphrases.
+ * RED STATE: These tests should FAIL until implementation is complete.
+ */
+import { describe, it, before } from 'node:test';
+import assert from 'node:assert';
+import { readFileSync, readdirSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+// Path to themes directory (relative to test location)
+const THEMES_DIR = join(__dirname, '..', '..', '..', 'pennyfarthing-dist', 'personas', 'themes');
+describe('MSSCI-12478: Theme YAML Migration', () => {
+    let themeFiles;
+    before(() => {
+        themeFiles = readdirSync(THEMES_DIR).filter(f => f.endsWith('.yaml'));
+    });
+    describe('AC2: All 102 themes updated', () => {
+        it('should have 102 theme files', () => {
+            assert.strictEqual(themeFiles.length, 102, `Expected 102 themes, got ${themeFiles.length}`);
+        });
+        it('no theme file should contain quote: field under agents', () => {
+            const themesWithQuote = [];
+            for (const file of themeFiles) {
+                const content = readFileSync(join(THEMES_DIR, file), 'utf-8');
+                // Check for quote: at 4-space indent (under agent definition)
+                if (/^ {4}quote:/m.test(content)) {
+                    themesWithQuote.push(file);
+                }
+            }
+            assert.strictEqual(themesWithQuote.length, 0, `These themes still have quote field: ${themesWithQuote.slice(0, 5).join(', ')}${themesWithQuote.length > 5 ? ` and ${themesWithQuote.length - 5} more` : ''}`);
+        });
+        it('every theme should have catchphrases array for each agent', () => {
+            const themesWithMissingCatchphrases = [];
+            for (const file of themeFiles) {
+                // Skip control.yaml which is a special baseline theme
+                if (file === 'control.yaml')
+                    continue;
+                const content = readFileSync(join(THEMES_DIR, file), 'utf-8');
+                // Count catchphrases section markers (10 agents expected)
+                const catchphrasesMatches = content.match(/^ {4}catchphrases:/gm);
+                if (!catchphrasesMatches || catchphrasesMatches.length < 10) {
+                    themesWithMissingCatchphrases.push(file);
+                }
+            }
+            assert.strictEqual(themesWithMissingCatchphrases.length, 0, `These themes have missing catchphrases: ${themesWithMissingCatchphrases.slice(0, 5).join(', ')}${themesWithMissingCatchphrases.length > 5 ? ` and ${themesWithMissingCatchphrases.length - 5} more` : ''}`);
+        });
+    });
+    describe('AC1: Migration preserves original quote in catchphrases', () => {
+        it('the-expanse orchestrator catchphrases should contain original quote', () => {
+            const content = readFileSync(join(THEMES_DIR, 'the-expanse.yaml'), 'utf-8');
+            // Original quote was: "Doors and corners, kid. That's where they get you."
+            // This should now be in the catchphrases array
+            assert.ok(content.includes("Doors and corners, kid. That's where they get you."), 'Quote should still be present in file');
+            assert.ok(/catchphrases:[\s\S]*?Doors and corners/.test(content), 'Quote should be within catchphrases array, not as separate quote field');
+        });
+        it('star-trek-tng picard catchphrases should contain original quote', () => {
+            const content = readFileSync(join(THEMES_DIR, 'star-trek-tng.yaml'), 'utf-8');
+            // Picard's famous quote should be in catchphrases
+            assert.ok(/catchphrases:[\s\S]*?(Make it so|Engage)/.test(content), 'Picard quote should be within catchphrases array');
+        });
+    });
+});
+//# sourceMappingURL=migrate-theme-schema.test.js.map

package/dist/migrate-theme-schema.test.js.map

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

package/dist/portrait-resolver.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Portrait Resolver - Smart path resolution for Pennyfarthing portraits
+ *
+ * Checks paths in priority order:
+ * 1. PENNYFARTHING_DIST env var (explicit override)
+ * 2. Monorepo root (pennyfarthing-dist/ at repo root for dogfooding)
+ * 3. Sibling directory (for dev scenarios)
+ * 4. Scoped npm (node_modules/@pennyfarthing/core/pennyfarthing-dist/)
+ * 5. Legacy npm (node_modules/pennyfarthing/pennyfarthing-dist/)
+ */
+export interface PortraitPaths {
+    portraitsDir: string;
+    themesDir: string;
+    agentsDir: string;
+}
+/**
+ * Resolve the pennyfarthing-dist directory path
+ * Checks multiple locations in priority order
+ */
+export declare function resolvePennyfarthingDist(): string | null;
+/**
+ * Resolve the full path to a portrait image
+ * @param theme - Theme name (e.g., 'shakespeare', 'norse-mythology')
+ * @param agent - Agent name (e.g., 'sm', 'tea', 'dev')
+ * @returns Full path to portrait file, or null if not found
+ */
+export declare function resolvePortraitPath(theme: string, agent: string): string | null;
+/**
+ * Get all portrait-related paths for a resolved dist directory
+ */
+export declare function getPortraitPaths(distPath: string): PortraitPaths;
+//# sourceMappingURL=portrait-resolver.d.ts.map

package/dist/portrait-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"portrait-resolver.d.ts","sourceRoot":"","sources":["../src/portrait-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAMH,MAAM,WAAW,aAAa;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAMD;;;GAGG;AACH,wBAAgB,wBAAwB,IAAI,MAAM,GAAG,IAAI,CAgDxD;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAsE/E;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,aAAa,CAShE"}

package/dist/portrait-resolver.js

@@ -0,0 +1,147 @@
+/**
+ * Portrait Resolver - Smart path resolution for Pennyfarthing portraits
+ *
+ * Checks paths in priority order:
+ * 1. PENNYFARTHING_DIST env var (explicit override)
+ * 2. Monorepo root (pennyfarthing-dist/ at repo root for dogfooding)
+ * 3. Sibling directory (for dev scenarios)
+ * 4. Scoped npm (node_modules/@pennyfarthing/core/pennyfarthing-dist/)
+ * 5. Legacy npm (node_modules/pennyfarthing/pennyfarthing-dist/)
+ */
+import { existsSync, readdirSync } from 'node:fs';
+import { join, dirname, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+// Get the directory where this module is located
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+/**
+ * Resolve the pennyfarthing-dist directory path
+ * Checks multiple locations in priority order
+ */
+export function resolvePennyfarthingDist() {
+    // 1. PENNYFARTHING_DIST env var (explicit override)
+    const envPath = process.env.PENNYFARTHING_DIST;
+    if (envPath) {
+        if (existsSync(envPath)) {
+            return envPath;
+        }
+        // Env var set but path doesn't exist - fall through to other checks
+    }
+    // 2. Monorepo root (pennyfarthing-dist/ at repo root for dogfooding)
+    // Walk up from current directory looking for pennyfarthing-dist/
+    let currentDir = __dirname;
+    for (let i = 0; i < 10; i++) {
+        const monorepoPath = join(currentDir, 'pennyfarthing-dist');
+        if (existsSync(monorepoPath)) {
+            return monorepoPath;
+        }
+        const parentDir = dirname(currentDir);
+        if (parentDir === currentDir)
+            break; // Reached root
+        currentDir = parentDir;
+    }
+    // 3. Sibling directory (for dev scenarios)
+    // Check ../pennyfarthing-dist, ../../pennyfarthing-dist from module location
+    currentDir = __dirname;
+    for (let i = 0; i < 5; i++) {
+        currentDir = dirname(currentDir);
+        const siblingPath = join(currentDir, 'pennyfarthing-dist');
+        if (existsSync(siblingPath)) {
+            return siblingPath;
+        }
+    }
+    // 4. Scoped npm (node_modules/@pennyfarthing/core/pennyfarthing-dist/)
+    const scopedNpmPath = resolve(__dirname, '..', '..', '..', '@pennyfarthing', 'core', 'pennyfarthing-dist');
+    if (existsSync(scopedNpmPath)) {
+        return scopedNpmPath;
+    }
+    // 5. Legacy npm (node_modules/pennyfarthing/pennyfarthing-dist/)
+    const legacyNpmPath = resolve(__dirname, '..', '..', '..', 'pennyfarthing', 'pennyfarthing-dist');
+    if (existsSync(legacyNpmPath)) {
+        return legacyNpmPath;
+    }
+    // No valid path found
+    return null;
+}
+/**
+ * Resolve the full path to a portrait image
+ * @param theme - Theme name (e.g., 'shakespeare', 'norse-mythology')
+ * @param agent - Agent name (e.g., 'sm', 'tea', 'dev')
+ * @returns Full path to portrait file, or null if not found
+ */
+export function resolvePortraitPath(theme, agent) {
+    const distPath = resolvePennyfarthingDist();
+    if (!distPath) {
+        return null;
+    }
+    const paths = getPortraitPaths(distPath);
+    const portraitsThemeDir = join(paths.portraitsDir, theme);
+    if (!existsSync(portraitsThemeDir)) {
+        return null;
+    }
+    // Look for portrait file matching the agent
+    // Portraits are in size subdirectories: large/, medium/, small/, original/
+    // Portraits follow pattern: {shortName}-{ocean}.png
+    // Agent names in tests may be short names (sm, tea, dev) or need mapping
+    try {
+        // Check size subdirectories in preference order
+        const sizeDirectories = ['large', 'medium', 'small', 'original'];
+        let files = [];
+        let searchDir = portraitsThemeDir;
+        for (const sizeDir of sizeDirectories) {
+            const sizedPath = join(portraitsThemeDir, sizeDir);
+            if (existsSync(sizedPath)) {
+                files = readdirSync(sizedPath);
+                searchDir = sizedPath;
+                break;
+            }
+        }
+        // Fallback to root directory if no size subdirectories
+        if (files.length === 0) {
+            files = readdirSync(portraitsThemeDir);
+            searchDir = portraitsThemeDir;
+        }
+        // Map agent names to portrait file prefixes based on theme conventions
+        // For most themes, portrait names use character short names
+        // We need to find a file that contains the agent name or its mapping
+        // Note: This includes characters from multiple themes (shakespeare, norse, a-team)
+        const agentMappings = {
+            'sm': ['prospero', 'baldur', 'face', 'faceman', 'sm'],
+            'tea': ['hamlet', 'tyr', 'murdock', 'tea'],
+            'dev': ['puck', 'loki', 'ba', 'dev'],
+            'reviewer': ['portia', 'heimdall', 'lynch', 'decker', 'reviewer'],
+            'architect': ['oberon', 'mimir', 'hannibal', 'architect'],
+            'pm': ['henry', 'thor', 'amy', 'pm'],
+            'tech-writer': ['horatio', 'bragi', 'tech-writer'],
+            'ux-designer': ['viola', 'idunn', 'ux-designer'],
+            'devops': ['caliban', 'norns', 'devops'],
+            'orchestrator': ['chorus', 'odin', 'orchestrator'],
+        };
+        const possiblePrefixes = agentMappings[agent] || [agent];
+        for (const file of files) {
+            for (const prefix of possiblePrefixes) {
+                if (file.toLowerCase().startsWith(prefix.toLowerCase()) &&
+                    (file.endsWith('.png') || file.endsWith('.jpg'))) {
+                    return join(searchDir, file);
+                }
+            }
+        }
+    }
+    catch {
+        return null;
+    }
+    return null;
+}
+/**
+ * Get all portrait-related paths for a resolved dist directory
+ */
+export function getPortraitPaths(distPath) {
+    // Normalize path to remove trailing slashes
+    const normalizedPath = distPath.replace(/\/+$/, '');
+    return {
+        portraitsDir: join(normalizedPath, 'personas', 'portraits'),
+        themesDir: join(normalizedPath, 'personas'),
+        agentsDir: join(normalizedPath, 'agents'),
+    };
+}
+//# sourceMappingURL=portrait-resolver.js.map

package/dist/portrait-resolver.js.map

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

package/dist/portrait-resolver.test.d.ts

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

package/dist/portrait-resolver.test.d.ts.map

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

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"}