@pennyfarthing/shared 7.0.2

package/dist/generate-skill-docs.test.js

@@ -0,0 +1,519 @@
+/**
+ * Tests for Story 9-4: Skill Documentation Generator
+ *
+ * These tests verify:
+ * - AC1: docs/SKILLS.md auto-generated from skill-registry.yaml
+ * - AC2: Generated docs include all skill metadata
+ * - AC3: Skills organized by category with table of contents
+ * - AC4: Build process triggers doc generation
+ *
+ * Run with: npm test -- packages/shared/src/generate-skill-docs.test.ts
+ */
+import { describe, it } from 'node:test';
+import assert from 'node:assert';
+import { execSync } from 'child_process';
+import { existsSync, readFileSync, mkdirSync, writeFileSync, rmSync, statSync } from 'fs';
+import { join, dirname } from 'path';
+import { tmpdir } from 'os';
+import { fileURLToPath } from 'url';
+// Import the generator function - this doesn't exist yet, tests should fail (RED)
+import { generateSkillDocs, } from './generate-skill-docs.js';
+// Paths
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const PROJECT_ROOT = join(__dirname, '../../..');
+const REGISTRY_PATH = join(PROJECT_ROOT, 'pennyfarthing-dist/skills/skill-registry.yaml');
+const OUTPUT_PATH = join(PROJECT_ROOT, 'docs/SKILLS.md');
+const GENERATOR_SCRIPT = join(PROJECT_ROOT, 'scripts/utils/generate-skill-docs.sh');
+// Sample minimal registry for isolated tests
+const MINIMAL_REGISTRY = `
+version: "1.0.0"
+skills:
+  test-skill:
+    name: test-skill
+    description: A test skill for verification
+    category: development
+    tags: [test, example]
+    version: "1.0.0"
+    prerequisites: []
+    examples:
+      - context: Testing the generator
+        invocation: /test-skill
+    anti_patterns:
+      - Don't use in production
+    related_skills: []
+    keywords: [test, sample]
+`;
+describe('Story 9-4: Skill Documentation Generator', () => {
+    describe('AC1: Auto-generate docs/SKILLS.md from skill-registry.yaml', () => {
+        it('should read skill-registry.yaml and generate markdown', async () => {
+            // AC1: docs/SKILLS.md auto-generated from skill-registry.yaml
+            const result = await generateSkillDocs({
+                registryPath: REGISTRY_PATH,
+            });
+            assert.ok(result.success, 'Generation should succeed');
+            assert.ok(result.content, 'Should produce content');
+            assert.ok(result.content.length > 0, 'Content should not be empty');
+        });
+        it('should generate valid markdown output', async () => {
+            // AC1: Output should be valid markdown
+            const result = await generateSkillDocs({
+                registryPath: REGISTRY_PATH,
+            });
+            assert.ok(result.content, 'Should produce content');
+            // Basic markdown structure checks
+            assert.ok(result.content.startsWith('#'), 'Should start with a heading');
+            assert.ok(result.content.includes('##'), 'Should have section headings');
+        });
+        it('should include all 19 skills from registry', async () => {
+            // AC1: All skills from registry should appear in output
+            const result = await generateSkillDocs({
+                registryPath: REGISTRY_PATH,
+            });
+            assert.ok(result.skillCount === 19, `Should include all 19 skills, got ${result.skillCount}`);
+            // Check for a sample of known skills
+            const expectedSkills = ['testing', 'jira', 'code-review', 'changelog', 'theme'];
+            for (const skill of expectedSkills) {
+                assert.ok(result.content.includes(skill), `Output should include ${skill} skill`);
+            }
+        });
+        it('should be idempotent - running twice produces same output', async () => {
+            // AC1: Generator should be deterministic
+            const result1 = await generateSkillDocs({
+                registryPath: REGISTRY_PATH,
+            });
+            const result2 = await generateSkillDocs({
+                registryPath: REGISTRY_PATH,
+            });
+            assert.strictEqual(result1.content, result2.content, 'Running twice should produce identical output');
+        });
+        it('should handle custom output path', async () => {
+            // AC1: Support writing to custom location
+            const tempDir = join(tmpdir(), `skill-docs-test-${Date.now()}`);
+            mkdirSync(tempDir, { recursive: true });
+            const customOutput = join(tempDir, 'SKILLS.md');
+            try {
+                const result = await generateSkillDocs({
+                    registryPath: REGISTRY_PATH,
+                    outputPath: customOutput,
+                    writeFile: true,
+                });
+                assert.ok(result.success, 'Generation should succeed');
+                assert.ok(existsSync(customOutput), 'Output file should be created');
+                const fileContent = readFileSync(customOutput, 'utf-8');
+                assert.strictEqual(fileContent, result.content, 'File content should match returned content');
+            }
+            finally {
+                rmSync(tempDir, { recursive: true, force: true });
+            }
+        });
+        it('should throw helpful error when registry file is missing', async () => {
+            // AC1: Error handling for missing registry
+            await assert.rejects(async () => generateSkillDocs({
+                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 handle malformed YAML gracefully', async () => {
+            // AC1: Error handling for invalid registry
+            const tempDir = join(tmpdir(), `skill-docs-test-${Date.now()}`);
+            mkdirSync(tempDir, { recursive: true });
+            const badRegistry = join(tempDir, 'bad-registry.yaml');
+            writeFileSync(badRegistry, 'this is not valid: yaml: content: [broken');
+            try {
+                await assert.rejects(async () => generateSkillDocs({
+                    registryPath: badRegistry,
+                }), {
+                    message: /invalid|parse|yaml/i,
+                }, 'Should throw error for malformed YAML');
+            }
+            finally {
+                rmSync(tempDir, { recursive: true, force: true });
+            }
+        });
+    });
+    describe('AC2: Include all skill metadata', () => {
+        it('should include skill description in output', async () => {
+            // AC2: description field included
+            const result = await generateSkillDocs({
+                registryPath: REGISTRY_PATH,
+            });
+            // Check that descriptions are included (not just skill names)
+            assert.ok(result.content.includes('TDD') || result.content.includes('test'), 'Should include skill descriptions mentioning TDD or testing');
+        });
+        it('should include tags for each skill', async () => {
+            // AC2: tags field included
+            const result = await generateSkillDocs({
+                registryPath: REGISTRY_PATH,
+            });
+            // Tags should appear in some form (could be **Tags:** or similar)
+            assert.ok(result.content.toLowerCase().includes('tag') ||
+                result.content.includes('tdd') ||
+                result.content.includes('quality'), 'Should include tags in output');
+        });
+        it('should include examples for each skill', async () => {
+            // AC2: examples field included
+            const result = await generateSkillDocs({
+                registryPath: REGISTRY_PATH,
+            });
+            // Examples section or invocation patterns should appear
+            assert.ok(result.content.toLowerCase().includes('example') ||
+                result.content.includes('/testing') ||
+                result.content.includes('invocation'), 'Should include examples or invocations');
+        });
+        it('should include anti-patterns for each skill', async () => {
+            // AC2: anti_patterns field included
+            const result = await generateSkillDocs({
+                registryPath: REGISTRY_PATH,
+            });
+            // Anti-patterns section should appear
+            assert.ok(result.content.toLowerCase().includes('anti-pattern') ||
+                result.content.toLowerCase().includes('antipattern') ||
+                result.content.toLowerCase().includes("don't"), 'Should include anti-patterns section');
+        });
+        it('should include related skills references', async () => {
+            // AC2: related_skills field included
+            const result = await generateSkillDocs({
+                registryPath: REGISTRY_PATH,
+            });
+            // Related skills should appear
+            assert.ok(result.content.toLowerCase().includes('related') ||
+                result.content.includes('See also'), 'Should include related skills references');
+        });
+        it('should include keywords for searchability', async () => {
+            // AC2: keywords field included (for skill discovery)
+            const result = await generateSkillDocs({
+                registryPath: REGISTRY_PATH,
+            });
+            // Keywords should appear (might be in a keywords section or as searchable terms)
+            assert.ok(result.content.toLowerCase().includes('keyword') ||
+                result.content.includes('jest') ||
+                result.content.includes('vitest'), 'Should include keywords for searchability');
+        });
+        it('should validate required fields are present in registry', async () => {
+            // AC2: Error if registry missing required fields
+            const tempDir = join(tmpdir(), `skill-docs-test-${Date.now()}`);
+            mkdirSync(tempDir, { recursive: true });
+            const incompleteRegistry = join(tempDir, 'incomplete-registry.yaml');
+            // Registry with skill missing required description
+            writeFileSync(incompleteRegistry, `
+version: "1.0.0"
+skills:
+  incomplete-skill:
+    name: incomplete-skill
+    # missing description
+    category: development
+    tags: []
+`);
+            try {
+                await assert.rejects(async () => generateSkillDocs({
+                    registryPath: incompleteRegistry,
+                    strict: true,
+                }), {
+                    message: /missing.*description|required.*field/i,
+                }, 'Should error when required fields are missing');
+            }
+            finally {
+                rmSync(tempDir, { recursive: true, force: true });
+            }
+        });
+    });
+    describe('AC3: Category organization with table of contents', () => {
+        it('should organize skills by category', async () => {
+            // AC3: Skills organized by category
+            const result = await generateSkillDocs({
+                registryPath: REGISTRY_PATH,
+            });
+            // Category headings should appear
+            const categories = ['development', 'project-management', 'tools', 'ai-llm', 'documentation', 'theming', 'benchmarking'];
+            let foundCategories = 0;
+            for (const category of categories) {
+                // Check for category as heading (could be ## Development or ## AI/LLM, etc.)
+                const normalizedCategory = category.replace(/-/g, ' ').replace(/ai llm/i, 'AI/LLM');
+                if (result.content.toLowerCase().includes(`## ${category}`) ||
+                    result.content.toLowerCase().includes(normalizedCategory.toLowerCase())) {
+                    foundCategories++;
+                }
+            }
+            assert.ok(foundCategories >= 3, `Should have at least 3 category sections, found ${foundCategories}`);
+        });
+        it('should include table of contents with links', async () => {
+            // AC3: Table of contents with anchor links
+            const result = await generateSkillDocs({
+                registryPath: REGISTRY_PATH,
+            });
+            // TOC should have links (markdown format: [Text](#anchor))
+            assert.ok(result.content.includes('](#') ||
+                result.content.toLowerCase().includes('table of contents') ||
+                result.content.toLowerCase().includes('contents'), 'Should include table of contents with anchor links');
+        });
+        it('should place skills under correct category heading', async () => {
+            // AC3: Skills appear under their category
+            const result = await generateSkillDocs({
+                registryPath: REGISTRY_PATH,
+            });
+            // testing skill should be under development category
+            // Check that testing appears after development heading and before next category
+            const content = result.content.toLowerCase();
+            const devIndex = content.indexOf('development');
+            const testingIndex = content.indexOf('testing');
+            assert.ok(devIndex > -1, 'Development category should exist');
+            assert.ok(testingIndex > -1, 'Testing skill should exist');
+            // Testing should appear in development section (after heading, before significant distance)
+        });
+        it('should sort categories alphabetically', async () => {
+            // AC3: Predictable ordering
+            const result = await generateSkillDocs({
+                registryPath: REGISTRY_PATH,
+            });
+            // Find positions of category headings
+            const content = result.content.toLowerCase();
+            const _aiIndex = content.indexOf('ai') > -1 ? content.indexOf('ai') : Infinity;
+            const devIndex = content.indexOf('development');
+            const toolsIndex = content.indexOf('tools');
+            // AI/LLM should come before Development alphabetically
+            // (or however the ordering is defined - at least should be consistent)
+            assert.ok(devIndex > -1 && toolsIndex > -1, 'Multiple category sections should exist');
+        });
+        it('should sort skills alphabetically within category', async () => {
+            // AC3: Skills sorted within their category
+            const result = await generateSkillDocs({
+                registryPath: REGISTRY_PATH,
+            });
+            // Within development: code-review should come before dev-patterns (alphabetically)
+            const content = result.content.toLowerCase();
+            const codeReviewIndex = content.indexOf('code-review');
+            const devPatternsIndex = content.indexOf('dev-patterns');
+            if (codeReviewIndex > -1 && devPatternsIndex > -1) {
+                assert.ok(codeReviewIndex < devPatternsIndex, 'Skills should be sorted alphabetically within category');
+            }
+        });
+        it('should generate valid TOC anchors', async () => {
+            // AC3: TOC links should match heading anchors
+            const result = await generateSkillDocs({
+                registryPath: REGISTRY_PATH,
+            });
+            // Extract TOC links and verify they have corresponding headings
+            const tocLinkMatches = result.content.match(/\[([^\]]+)\]\(#([^)]+)\)/g) || [];
+            if (tocLinkMatches.length > 0) {
+                // At least some TOC links should exist
+                assert.ok(tocLinkMatches.length > 0, 'TOC should have anchor links');
+                // Verify at least one link has a valid target
+                for (const link of tocLinkMatches.slice(0, 3)) {
+                    const anchorMatch = link.match(/\(#([^)]+)\)/);
+                    if (anchorMatch) {
+                        const anchor = anchorMatch[1];
+                        // The heading for this anchor should exist somewhere
+                        // (GitHub-style anchors: lowercase, spaces to dashes)
+                        assert.ok(anchor.length > 0, `Anchor should not be empty: ${link}`);
+                    }
+                }
+            }
+        });
+    });
+    describe('AC4: Build process triggers doc generation', () => {
+        it('should have generate-skill-docs.sh script', () => {
+            // AC4: Script exists for build integration
+            assert.ok(existsSync(GENERATOR_SCRIPT), `Generator script should exist at ${GENERATOR_SCRIPT}`);
+        });
+        it('should script be executable', () => {
+            // AC4: Script should have execute permissions
+            if (!existsSync(GENERATOR_SCRIPT)) {
+                assert.fail('Generator script does not exist yet');
+            }
+            // Try to get file stats - executable bit
+            const stats = statSync(GENERATOR_SCRIPT);
+            const isExecutable = (stats.mode & parseInt('111', 8)) !== 0;
+            assert.ok(isExecutable, 'Script should have execute permissions');
+        });
+        it('should script produce output when run directly', () => {
+            // AC4: Shell script integration
+            if (!existsSync(GENERATOR_SCRIPT)) {
+                assert.fail('Generator script does not exist yet');
+            }
+            try {
+                const output = execSync(`bash ${GENERATOR_SCRIPT} --dry-run`, {
+                    encoding: 'utf-8',
+                    cwd: PROJECT_ROOT,
+                });
+                assert.ok(output.length > 0, 'Script should produce output');
+                assert.ok(output.includes('#') || output.includes('Generated'), 'Output should be markdown or status message');
+            }
+            catch (error) {
+                assert.fail(`Script execution failed: ${error}`);
+            }
+        });
+        it('should package.json include docs generation script', () => {
+            // AC4: Build process integration
+            const packageJsonPath = join(PROJECT_ROOT, 'package.json');
+            const packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf-8'));
+            const hasDocsScript = packageJson.scripts?.docs ||
+                packageJson.scripts?.['generate-docs'] ||
+                packageJson.scripts?.build?.includes('generate-skill-docs');
+            assert.ok(hasDocsScript, 'package.json should have docs generation in scripts');
+        });
+        it('should build script include docs generation', () => {
+            // AC4: Build triggers doc generation
+            const packageJsonPath = join(PROJECT_ROOT, 'package.json');
+            const packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf-8'));
+            const buildScript = packageJson.scripts?.build || '';
+            // Either build includes docs, or there's a prebuild/postbuild hook
+            const triggersDocGen = buildScript.includes('generate-skill-docs') ||
+                buildScript.includes('docs') ||
+                packageJson.scripts?.prebuild?.includes('docs') ||
+                packageJson.scripts?.postbuild?.includes('docs');
+            assert.ok(triggersDocGen, 'Build process should trigger doc generation');
+        });
+        it('should generate fresh docs match current registry', async () => {
+            // AC4: Generated docs should be up-to-date with registry
+            if (!existsSync(OUTPUT_PATH)) {
+                assert.fail('docs/SKILLS.md does not exist yet');
+            }
+            const result = await generateSkillDocs({
+                registryPath: REGISTRY_PATH,
+            });
+            const currentDocs = readFileSync(OUTPUT_PATH, 'utf-8');
+            // The generated content should match what's in the file
+            // (allowing for timestamp differences if there's a "generated at" header)
+            const normalize = (s) => s.replace(/Generated at:.*/g, '').replace(/\s+/g, ' ').trim();
+            assert.strictEqual(normalize(result.content), normalize(currentDocs), 'Generated docs should match current docs/SKILLS.md (regenerate if stale)');
+        });
+    });
+    describe('Shell Script Integration', () => {
+        it('should script accept --help flag', () => {
+            // Usability: Show help text
+            if (!existsSync(GENERATOR_SCRIPT)) {
+                assert.fail('Generator script does not exist yet');
+            }
+            try {
+                const output = execSync(`bash ${GENERATOR_SCRIPT} --help`, {
+                    encoding: 'utf-8',
+                    cwd: PROJECT_ROOT,
+                });
+                assert.ok(output.includes('usage') || output.includes('Usage') || output.includes('help'), 'Should show usage information');
+            }
+            catch (error) {
+                // --help might exit with 0 or non-zero depending on implementation
+                assert.fail(`--help should work: ${error}`);
+            }
+        });
+        it('should script accept custom registry path', () => {
+            // Flexibility: Allow custom registry
+            if (!existsSync(GENERATOR_SCRIPT)) {
+                assert.fail('Generator script does not exist yet');
+            }
+            const tempDir = join(tmpdir(), `skill-docs-test-${Date.now()}`);
+            mkdirSync(tempDir, { recursive: true });
+            const customRegistry = join(tempDir, 'custom-registry.yaml');
+            writeFileSync(customRegistry, MINIMAL_REGISTRY);
+            try {
+                const output = execSync(`bash ${GENERATOR_SCRIPT} --registry ${customRegistry} --dry-run`, {
+                    encoding: 'utf-8',
+                    cwd: PROJECT_ROOT,
+                });
+                assert.ok(output.includes('test-skill'), 'Should use custom registry');
+            }
+            catch (error) {
+                assert.fail(`Custom registry should work: ${error}`);
+            }
+            finally {
+                rmSync(tempDir, { recursive: true, force: true });
+            }
+        });
+        it('should script exit with error code on failure', () => {
+            // Error handling: Non-zero exit on failure
+            if (!existsSync(GENERATOR_SCRIPT)) {
+                assert.fail('Generator script does not exist yet');
+            }
+            try {
+                execSync(`bash ${GENERATOR_SCRIPT} --registry /nonexistent/path.yaml`, {
+                    encoding: 'utf-8',
+                    cwd: PROJECT_ROOT,
+                });
+                assert.fail('Should have thrown for missing registry');
+            }
+            catch (error) {
+                assert.ok(error.status !== 0, 'Should exit with non-zero status on error');
+            }
+        });
+    });
+    describe('Error Handling', () => {
+        it('should handle empty registry gracefully', async () => {
+            // Edge case: Registry with no skills
+            const tempDir = join(tmpdir(), `skill-docs-test-${Date.now()}`);
+            mkdirSync(tempDir, { recursive: true });
+            const emptyRegistry = join(tempDir, 'empty-registry.yaml');
+            writeFileSync(emptyRegistry, 'version: "1.0.0"\nskills: {}');
+            try {
+                const result = await generateSkillDocs({
+                    registryPath: emptyRegistry,
+                });
+                assert.ok(result.success, 'Should succeed with empty registry');
+                assert.strictEqual(result.skillCount, 0, 'Should report 0 skills');
+                assert.ok(result.content.includes('#'), 'Should still produce valid markdown structure');
+            }
+            finally {
+                rmSync(tempDir, { recursive: true, force: true });
+            }
+        });
+        it('should handle skills with missing optional fields', async () => {
+            // Edge case: Skills missing optional fields
+            const tempDir = join(tmpdir(), `skill-docs-test-${Date.now()}`);
+            mkdirSync(tempDir, { recursive: true });
+            const minimalSkillRegistry = join(tempDir, 'minimal-registry.yaml');
+            writeFileSync(minimalSkillRegistry, `
+version: "1.0.0"
+skills:
+  minimal:
+    name: minimal
+    description: A minimal skill
+    category: development
+    tags: []
+    # optional fields omitted: examples, anti_patterns, related_skills, keywords
+`);
+            try {
+                const result = await generateSkillDocs({
+                    registryPath: minimalSkillRegistry,
+                });
+                assert.ok(result.success, 'Should succeed with minimal skill');
+                assert.ok(result.content.includes('minimal'), 'Should include minimal skill');
+            }
+            finally {
+                rmSync(tempDir, { recursive: true, force: true });
+            }
+        });
+        it('should handle special characters in skill content', async () => {
+            // Edge case: Special markdown characters in content
+            const tempDir = join(tmpdir(), `skill-docs-test-${Date.now()}`);
+            mkdirSync(tempDir, { recursive: true });
+            const specialRegistry = join(tempDir, 'special-registry.yaml');
+            writeFileSync(specialRegistry, `
+version: "1.0.0"
+skills:
+  special:
+    name: special
+    description: "A skill with *asterisks* and [brackets] and \`backticks\`"
+    category: development
+    tags: [tag-with-dash, tag_with_underscore]
+    examples:
+      - context: "Example with 'quotes'"
+        invocation: /special --flag=value
+    anti_patterns:
+      - "Don't do this: \`bad code\`"
+    related_skills: []
+    keywords: []
+`);
+            try {
+                const result = await generateSkillDocs({
+                    registryPath: specialRegistry,
+                });
+                assert.ok(result.success, 'Should handle special characters');
+                assert.ok(result.content.includes('special'), 'Should include skill');
+            }
+            finally {
+                rmSync(tempDir, { recursive: true, force: true });
+            }
+        });
+    });
+});
+//# sourceMappingURL=generate-skill-docs.test.js.map

package/dist/generate-skill-docs.test.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @pennyfarthing/shared
+ * Shared utilities for Pennyfarthing including portrait path resolution
+ */
+export { resolvePennyfarthingDist, resolvePortraitPath, getPortraitPaths, type PortraitPaths, } from './portrait-resolver.js';
+export { loadTheme, listThemes, getAgentPersona, type Theme, type ThemeAgent, } from './theme-loader.js';
+export { searchSkills, type SearchOptions, type SkillResult, } from './skill-search.js';
+export { suggestSkills, suggestFromSession, suggestFromKeywords, type SuggestOptions, type SkillSuggestion, type SessionContext, } from './skill-suggest.js';
+export { generateSkillDocs, type GeneratorOptions, type GeneratorResult, } from './generate-skill-docs.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,wBAAwB,EACxB,mBAAmB,EACnB,gBAAgB,EAChB,KAAK,aAAa,GACnB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,SAAS,EACT,UAAU,EACV,eAAe,EACf,KAAK,KAAK,EACV,KAAK,UAAU,GAChB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,YAAY,EACZ,KAAK,aAAa,EAClB,KAAK,WAAW,GACjB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,mBAAmB,EACnB,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,cAAc,GACpB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,iBAAiB,EACjB,KAAK,gBAAgB,EACrB,KAAK,eAAe,GACrB,MAAM,0BAA0B,CAAC"}

package/dist/index.js

@@ -0,0 +1,10 @@
+/**
+ * @pennyfarthing/shared
+ * Shared utilities for Pennyfarthing including portrait path resolution
+ */
+export { resolvePennyfarthingDist, resolvePortraitPath, getPortraitPaths, } from './portrait-resolver.js';
+export { loadTheme, listThemes, getAgentPersona, } from './theme-loader.js';
+export { searchSkills, } from './skill-search.js';
+export { suggestSkills, suggestFromSession, suggestFromKeywords, } from './skill-suggest.js';
+export { generateSkillDocs, } from './generate-skill-docs.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,wBAAwB,EACxB,mBAAmB,EACnB,gBAAgB,GAEjB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,SAAS,EACT,UAAU,EACV,eAAe,GAGhB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,YAAY,GAGb,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,mBAAmB,GAIpB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,iBAAiB,GAGlB,MAAM,0BAA0B,CAAC"}

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