@pennyfarthing/shared 7.5.0 → 7.9.0

package/dist/theme-loader.js

@@ -0,0 +1,84 @@
+/**
+ * Theme Loader - Load and parse Pennyfarthing theme configurations
+ */
+import { existsSync, readFileSync, readdirSync } from 'node:fs';
+import { join, basename } from 'node:path';
+import { parse as parseYaml } from 'yaml';
+import { resolvePennyfarthingDist, getPortraitPaths } from './portrait-resolver.js';
+/**
+ * Load a theme configuration by name
+ * @param themeName - Name of the theme (e.g., 'shakespeare', 'norse-mythology')
+ * @returns Parsed theme configuration or null if not found
+ */
+export function loadTheme(themeName) {
+    const distPath = resolvePennyfarthingDist();
+    if (!distPath) {
+        return null;
+    }
+    const paths = getPortraitPaths(distPath);
+    const themePath = join(paths.themesDir, 'themes', `${themeName}.yaml`);
+    if (!existsSync(themePath)) {
+        return null;
+    }
+    try {
+        const content = readFileSync(themePath, 'utf-8');
+        const raw = parseYaml(content);
+        const agents = {};
+        for (const [agentKey, agentData] of Object.entries(raw.agents || {})) {
+            agents[agentKey] = {
+                character: agentData.character || '',
+                style: agentData.style || '',
+                role: agentData.role || '',
+                trait: agentData.trait || '',
+                catchphrases: agentData.catchphrases || [],
+                helper: agentData.helper?.name,
+            };
+        }
+        return {
+            name: themeName,
+            description: raw.theme?.description || '',
+            agents,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * List all available themes
+ * @returns Array of theme names
+ */
+export function listThemes() {
+    const distPath = resolvePennyfarthingDist();
+    if (!distPath) {
+        return [];
+    }
+    const paths = getPortraitPaths(distPath);
+    const themesDir = join(paths.themesDir, 'themes');
+    if (!existsSync(themesDir)) {
+        return [];
+    }
+    try {
+        const files = readdirSync(themesDir);
+        return files
+            .filter(f => f.endsWith('.yaml'))
+            .map(f => basename(f, '.yaml'));
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Get agent persona from a theme
+ * @param themeName - Theme name
+ * @param agentName - Agent name (e.g., 'sm', 'tea', 'dev')
+ * @returns Agent persona or null if not found
+ */
+export function getAgentPersona(themeName, agentName) {
+    const theme = loadTheme(themeName);
+    if (!theme) {
+        return null;
+    }
+    return theme.agents[agentName] || null;
+}
+//# sourceMappingURL=theme-loader.js.map

package/dist/theme-loader.js.map

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

package/dist/theme-loader.test.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Theme Schema Consolidation Tests - MSSCI-12478
+ *
+ * Tests for consolidating quote field into catchphrases array.
+ * RED STATE: These tests should FAIL until implementation is complete.
+ */
+export {};
+//# sourceMappingURL=theme-loader.test.d.ts.map

package/dist/theme-loader.test.d.ts.map

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

package/dist/theme-loader.test.js

@@ -0,0 +1,62 @@
+/**
+ * Theme Schema Consolidation Tests - MSSCI-12478
+ *
+ * Tests for consolidating quote field into catchphrases array.
+ * RED STATE: These tests should FAIL until implementation is complete.
+ */
+import { describe, it } from 'node:test';
+import assert from 'node:assert';
+import { loadTheme } from './theme-loader.js';
+describe('MSSCI-12478: Theme Schema Consolidation', () => {
+    describe('AC3: quote field removed from schema', () => {
+        it('ThemeAgent interface should have catchphrases array, not quote string', () => {
+            // Load any theme and check the agent structure
+            const theme = loadTheme('the-expanse');
+            assert.ok(theme !== null, 'Theme should load');
+            const agent = theme.agents['sm'];
+            assert.ok(agent !== undefined, 'SM agent should exist');
+            // Should have catchphrases array
+            assert.ok('catchphrases' in agent, 'Agent should have catchphrases property');
+            assert.ok(Array.isArray(agent.catchphrases), 'catchphrases should be an array');
+            // Should NOT have quote field (removed from schema)
+            assert.ok(!('quote' in agent), 'Agent should NOT have quote property after migration');
+        });
+        it('catchphrases array should contain at least one entry', () => {
+            const theme = loadTheme('the-expanse');
+            assert.ok(theme !== null, 'Theme should load');
+            const agent = theme.agents['tea'];
+            assert.ok(agent.catchphrases !== undefined, 'catchphrases should be defined');
+            assert.ok(agent.catchphrases.length > 0, 'catchphrases should have at least one entry');
+        });
+    });
+    describe('AC1: Migration script merges quote into catchphrases', () => {
+        it('original quote should be present in catchphrases array', () => {
+            // The Investigator's quote was "Doors and corners, kid. That's where they get you."
+            // After migration, this should be in the catchphrases array
+            const theme = loadTheme('the-expanse');
+            assert.ok(theme !== null, 'Theme should load');
+            const agent = theme.agents['orchestrator'];
+            assert.ok(agent.catchphrases.includes("Doors and corners, kid. That's where they get you."), 'Original quote should be in catchphrases array');
+        });
+        it('catchphrases should not have duplicates after migration', () => {
+            const theme = loadTheme('the-expanse');
+            assert.ok(theme !== null, 'Theme should load');
+            const agent = theme.agents['sm'];
+            // Check for duplicates
+            const uniqueCatchphrases = [...new Set(agent.catchphrases)];
+            assert.strictEqual(agent.catchphrases.length, uniqueCatchphrases.length, 'catchphrases should have no duplicates');
+        });
+    });
+    describe('AC4: Theme validation updated', () => {
+        it('should parse catchphrases array from YAML', () => {
+            const theme = loadTheme('star-trek-tng');
+            assert.ok(theme !== null, 'Theme should load');
+            // Every agent should have catchphrases parsed
+            for (const [agentName, agent] of Object.entries(theme.agents)) {
+                assert.ok(agent.catchphrases !== undefined, `Agent ${agentName} should have catchphrases`);
+                assert.ok(Array.isArray(agent.catchphrases), `Agent ${agentName} catchphrases should be array`);
+            }
+        });
+    });
+});
+//# sourceMappingURL=theme-loader.test.js.map

package/dist/theme-loader.test.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pennyfarthing/shared",
-  "version": "7.5.0",
+  "version": "7.9.0",
   "description": "Shared utilities for Pennyfarthing including portrait path resolution",
   "type": "module",
   "main": "dist/index.js",
@@ -34,5 +34,8 @@
   "devDependencies": {
     "@types/node": "^20.10.0",
     "typescript": "^5.3.3"
+  },
+  "dependencies": {
+    "yaml": "^2.8.2"
   }
 }