@pennyfarthing/core 10.4.0 → 11.0.0

package/packages/core/dist/server/otlp-receiver.d.ts

@@ -0,0 +1,87 @@
+/**
+ * OTLP receiver stub for server module.
+ * Provides functions/types used by API routes without cyclist OTLP dependency.
+ *
+ * Supports a provider pattern: call setOTLPProvider() with the real implementation
+ * (e.g. from cyclist's otlp-receiver) to wire live data through the API routes.
+ * Without a provider, all functions return safe empty defaults.
+ */
+export interface TokenStats {
+    inputTokens: number;
+    outputTokens: number;
+    cacheCreationTokens: number;
+    cacheReadTokens: number;
+    totalCost: number;
+    [key: string]: unknown;
+}
+export interface BackgroundTask {
+    taskId: string;
+    description: string;
+    subagentType: string;
+    startedAt: number;
+    completedAt?: number;
+    durationMs?: number;
+    status: 'pending' | 'completed';
+    success?: boolean;
+    output?: string;
+    error?: string;
+    isBackground?: boolean;
+}
+export interface ToolEvent {
+    toolName: string;
+    input?: string;
+    success?: boolean;
+    workingDirectory?: string;
+    [key: string]: unknown;
+}
+export interface AuditLogEntry {
+    timestamp: number;
+    type: string;
+    tool?: string;
+    [key: string]: unknown;
+}
+export interface OTLPProvider {
+    getTokenStats(): TokenStats;
+    addTokenStatsListener(callback: (stats: TokenStats) => void): void;
+    getBackgroundTasks(): BackgroundTask[];
+    setBackgroundTaskStartCallback(callback: (task: BackgroundTask) => void): void;
+    setBackgroundTaskCallback(callback: (task: BackgroundTask) => void): void;
+    processOTLPLogs(body: unknown): void;
+    processOTLPMetrics(body: unknown): void;
+    processOTLPTraces(body: unknown): void;
+    getAuditLog(): AuditLogEntry[];
+    getToolEventsFiltered(opts?: unknown): ToolEvent[];
+    getToolTypes(): string[];
+    getAuditLogStats(): Record<string, unknown>;
+    exportAuditLogAsJSON(toolType?: string): string;
+    exportAuditLogAsCSV(toolType?: string): string;
+    resetEventStore(): void;
+}
+export declare function setOTLPProvider(provider: OTLPProvider): void;
+export declare function getTokenStats(): TokenStats;
+export declare function addTokenStatsListener(callback: (stats: TokenStats) => void): void;
+export declare function getBackgroundTasks(): BackgroundTask[];
+export declare function setBackgroundTaskStartCallback(callback: (task: BackgroundTask) => void): void;
+export declare function setBackgroundTaskCallback(callback: (task: BackgroundTask) => void): void;
+export declare function processOTLPLogs(body: unknown): void;
+export declare function processOTLPMetrics(body: unknown): void;
+export declare function processOTLPTraces(body: unknown): void;
+export declare function getAuditLog(): AuditLogEntry[];
+export declare function getToolEventsFiltered(opts?: unknown): ToolEvent[];
+export declare function getToolTypes(): string[];
+export declare function getAuditLogStats(): Record<string, unknown>;
+export declare function exportAuditLogAsJSON(toolType?: string): string;
+export declare function exportAuditLogAsCSV(toolType?: string): string;
+export declare function resetEventStore(): void;
+export declare function getBackgroundTaskByToolId(_toolId: string): BackgroundTask | undefined;
+export declare function trackBackgroundTask(_task: Partial<BackgroundTask>): void;
+export declare function completeBackgroundTask(_taskId: string, _success: boolean, _result?: string, _error?: string): BackgroundTask | undefined;
+export declare function addToolEventListener(_callback: (event: ToolEvent) => void): void;
+export declare function getUserEmail(): string | null;
+export declare function isOtelDebugEnabled(): boolean;
+export declare function clearAuditLog(): void;
+export declare function parseOTLPMetrics(_body: unknown): unknown;
+export declare function aggregateTokenStats(_data: unknown): TokenStats;
+export declare function parseOTLPLogs(_body: unknown): unknown;
+export declare function processLogEvents(_events: unknown): void;
+//# sourceMappingURL=otlp-receiver.d.ts.map

package/packages/core/dist/server/otlp-receiver.d.ts.map

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

package/packages/core/dist/server/otlp-receiver.js

@@ -0,0 +1,106 @@
+/**
+ * OTLP receiver stub for server module.
+ * Provides functions/types used by API routes without cyclist OTLP dependency.
+ *
+ * Supports a provider pattern: call setOTLPProvider() with the real implementation
+ * (e.g. from cyclist's otlp-receiver) to wire live data through the API routes.
+ * Without a provider, all functions return safe empty defaults.
+ */
+let _provider = null;
+export function setOTLPProvider(provider) {
+    _provider = provider;
+}
+// =============================================================================
+// Delegating stubs — route through provider when set, empty defaults otherwise
+// =============================================================================
+export function getTokenStats() {
+    if (_provider)
+        return _provider.getTokenStats();
+    return { inputTokens: 0, outputTokens: 0, cacheCreationTokens: 0, cacheReadTokens: 0, totalCost: 0 };
+}
+export function addTokenStatsListener(callback) {
+    if (_provider)
+        return _provider.addTokenStatsListener(callback);
+}
+export function getBackgroundTasks() {
+    if (_provider)
+        return _provider.getBackgroundTasks();
+    return [];
+}
+export function setBackgroundTaskStartCallback(callback) {
+    if (_provider)
+        return _provider.setBackgroundTaskStartCallback(callback);
+}
+export function setBackgroundTaskCallback(callback) {
+    if (_provider)
+        return _provider.setBackgroundTaskCallback(callback);
+}
+export function processOTLPLogs(body) {
+    if (_provider)
+        return _provider.processOTLPLogs(body);
+}
+export function processOTLPMetrics(body) {
+    if (_provider)
+        return _provider.processOTLPMetrics(body);
+}
+export function processOTLPTraces(body) {
+    if (_provider)
+        return _provider.processOTLPTraces(body);
+}
+export function getAuditLog() {
+    if (_provider)
+        return _provider.getAuditLog();
+    return [];
+}
+export function getToolEventsFiltered(opts) {
+    if (_provider)
+        return _provider.getToolEventsFiltered(opts);
+    return [];
+}
+export function getToolTypes() {
+    if (_provider)
+        return _provider.getToolTypes();
+    return [];
+}
+export function getAuditLogStats() {
+    if (_provider)
+        return _provider.getAuditLogStats();
+    return {};
+}
+export function exportAuditLogAsJSON(toolType) {
+    if (_provider)
+        return _provider.exportAuditLogAsJSON(toolType);
+    return '[]';
+}
+export function exportAuditLogAsCSV(toolType) {
+    if (_provider)
+        return _provider.exportAuditLogAsCSV(toolType);
+    return '';
+}
+export function resetEventStore() {
+    if (_provider)
+        return _provider.resetEventStore();
+}
+// =============================================================================
+// Plain stubs — NOT used by core's API routes, only imported directly by cyclist
+// =============================================================================
+export function getBackgroundTaskByToolId(_toolId) {
+    return undefined;
+}
+export function trackBackgroundTask(_task) { }
+export function completeBackgroundTask(_taskId, _success, _result, _error) {
+    return undefined;
+}
+export function addToolEventListener(_callback) { }
+export function getUserEmail() {
+    return null;
+}
+export function isOtelDebugEnabled() {
+    return false;
+}
+export function clearAuditLog() { }
+export function parseOTLPMetrics(_body) { return null; }
+export function aggregateTokenStats(_data) { return { inputTokens: 0, outputTokens: 0, cacheCreationTokens: 0, cacheReadTokens: 0, totalCost: 0 }; }
+export function parseOTLPLogs(_body) { return null; }
+export function processLogEvents(_events) { }
+//# sourceMappingURL=otlp-receiver.js.map

package/packages/core/dist/server/otlp-receiver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"otlp-receiver.js","sourceRoot":"","sources":["../../src/server/otlp-receiver.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAqEH,IAAI,SAAS,GAAwB,IAAI,CAAC;AAE1C,MAAM,UAAU,eAAe,CAAC,QAAsB;IACpD,SAAS,GAAG,QAAQ,CAAC;AACvB,CAAC;AAED,gFAAgF;AAChF,+EAA+E;AAC/E,gFAAgF;AAEhF,MAAM,UAAU,aAAa;IAC3B,IAAI,SAAS;QAAE,OAAO,SAAS,CAAC,aAAa,EAAE,CAAC;IAChD,OAAO,EAAE,WAAW,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,mBAAmB,EAAE,CAAC,EAAE,eAAe,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;AACvG,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,QAAqC;IACzE,IAAI,SAAS;QAAE,OAAO,SAAS,CAAC,qBAAqB,CAAC,QAAQ,CAAC,CAAC;AAClE,CAAC;AAED,MAAM,UAAU,kBAAkB;IAChC,IAAI,SAAS;QAAE,OAAO,SAAS,CAAC,kBAAkB,EAAE,CAAC;IACrD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,MAAM,UAAU,8BAA8B,CAAC,QAAwC;IACrF,IAAI,SAAS;QAAE,OAAO,SAAS,CAAC,8BAA8B,CAAC,QAAQ,CAAC,CAAC;AAC3E,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,QAAwC;IAChF,IAAI,SAAS;QAAE,OAAO,SAAS,CAAC,yBAAyB,CAAC,QAAQ,CAAC,CAAC;AACtE,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,IAAa;IAC3C,IAAI,SAAS;QAAE,OAAO,SAAS,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;AACxD,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,IAAa;IAC9C,IAAI,SAAS;QAAE,OAAO,SAAS,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC;AAC3D,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,IAAa;IAC7C,IAAI,SAAS;QAAE,OAAO,SAAS,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;AAC1D,CAAC;AAED,MAAM,UAAU,WAAW;IACzB,IAAI,SAAS;QAAE,OAAO,SAAS,CAAC,WAAW,EAAE,CAAC;IAC9C,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,IAAc;IAClD,IAAI,SAAS;QAAE,OAAO,SAAS,CAAC,qBAAqB,CAAC,IAAI,CAAC,CAAC;IAC5D,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,MAAM,UAAU,YAAY;IAC1B,IAAI,SAAS;QAAE,OAAO,SAAS,CAAC,YAAY,EAAE,CAAC;IAC/C,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC9B,IAAI,SAAS;QAAE,OAAO,SAAS,CAAC,gBAAgB,EAAE,CAAC;IACnD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,QAAiB;IACpD,IAAI,SAAS;QAAE,OAAO,SAAS,CAAC,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IAC/D,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,QAAiB;IACnD,IAAI,SAAS;QAAE,OAAO,SAAS,CAAC,mBAAmB,CAAC,QAAQ,CAAC,CAAC;IAC9D,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,IAAI,SAAS;QAAE,OAAO,SAAS,CAAC,eAAe,EAAE,CAAC;AACpD,CAAC;AAED,gFAAgF;AAChF,iFAAiF;AACjF,gFAAgF;AAEhF,MAAM,UAAU,yBAAyB,CAAC,OAAe;IACvD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,KAA8B,IAAS,CAAC;AAC5E,MAAM,UAAU,sBAAsB,CAAC,OAAe,EAAE,QAAiB,EAAE,OAAgB,EAAE,MAAe;IAC1G,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,SAAqC,IAAS,CAAC;AAEpF,MAAM,UAAU,YAAY;IAC1B,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,kBAAkB;IAChC,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,aAAa,KAAU,CAAC;AAExC,MAAM,UAAU,gBAAgB,CAAC,KAAc,IAAa,OAAO,IAAI,CAAC,CAAC,CAAC;AAC1E,MAAM,UAAU,mBAAmB,CAAC,KAAc,IAAgB,OAAO,EAAE,WAAW,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,mBAAmB,EAAE,CAAC,EAAE,eAAe,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;AACzK,MAAM,UAAU,aAAa,CAAC,KAAc,IAAa,OAAO,IAAI,CAAC,CAAC,CAAC;AACvE,MAAM,UAAU,gBAAgB,CAAC,OAAgB,IAAS,CAAC"}

package/packages/core/dist/server/parser.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Parser types stub for server module.
+ * Provides types used by API routes without cyclist parser dependency.
+ */
+export interface ParsedStats {
+    model?: string;
+    status?: string;
+    pwd?: string;
+    [key: string]: unknown;
+}
+//# sourceMappingURL=parser.d.ts.map

package/packages/core/dist/server/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../src/server/parser.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,WAAW;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB"}

package/packages/core/dist/server/parser.js

@@ -0,0 +1,6 @@
+/**
+ * Parser types stub for server module.
+ * Provides types used by API routes without cyclist parser dependency.
+ */
+export {};
+//# sourceMappingURL=parser.js.map

package/packages/core/dist/server/parser.js.map

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

package/packages/core/dist/server/paths.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Path resolution for server module.
+ * Extracted from packages/cyclist/src/paths.ts (Story 98-17).
+ *
+ * Handles project directory management (CLI arg, env var, picker selection)
+ * and static asset path resolution (public dir, node_modules, portraits).
+ */
+/**
+ * Parse --project-dir argument from CLI
+ * Used when launching via: open Cyclist.app --args --project-dir=/path
+ */
+export declare function parseProjectDirArg(): string | null;
+/**
+ * Set the project directory (called after folder picker selection or in tests)
+ */
+export declare function setProjectDirectory(dir: string): void;
+/**
+ * Check if a directory is valid for use as project directory
+ */
+export declare function isValidProjectDirectory(dir: string): boolean;
+/**
+ * Get the project directory for Claude to run in
+ * Priority: CLI arg → selected dir (from picker) → env var → null (triggers picker)
+ */
+export declare function getProjectDirectory(): string | null;
+/**
+ * Reset project directory state (for testing only)
+ */
+export declare function resetProjectDirectory(): void;
+export declare function getPublicDir(): string;
+export declare function getNodeModulesDir(): string;
+export declare function getPortraitsDir(): string | null;
+export declare function getDistDir(): string;
+export declare const publicDir: string;
+export declare const nodeModulesDir: string;
+export declare const portraitsDir: string | null;
+//# sourceMappingURL=paths.d.ts.map

package/packages/core/dist/server/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/server/paths.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA8FH;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,GAAG,IAAI,CASlD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAGrD;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAQ5D;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,GAAG,IAAI,CA0BnD;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,IAAI,CAK5C;AAGD,wBAAgB,YAAY,IAAI,MAAM,CA2BrC;AAGD,wBAAgB,iBAAiB,IAAI,MAAM,CAM1C;AAGD,wBAAgB,eAAe,IAAI,MAAM,GAAG,IAAI,CAuB/C;AAGD,wBAAgB,UAAU,IAAI,MAAM,CAiBnC;AAGD,eAAO,MAAM,SAAS,QAAiB,CAAC;AACxC,eAAO,MAAM,cAAc,QAAsB,CAAC;AAClD,eAAO,MAAM,YAAY,eAAoB,CAAC"}

package/packages/core/dist/server/paths.js

@@ -0,0 +1,227 @@
+/**
+ * Path resolution for server module.
+ * Extracted from packages/cyclist/src/paths.ts (Story 98-17).
+ *
+ * Handles project directory management (CLI arg, env var, picker selection)
+ * and static asset path resolution (public dir, node_modules, portraits).
+ */
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+import { existsSync, statSync } from 'fs';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+/**
+ * Resolve the pennyfarthing-dist directory path
+ * Checks multiple locations in priority order
+ */
+function resolvePennyfarthingDist() {
+    // 1. PENNYFARTHING_DIST env var (explicit override)
+    const envPath = process.env.PENNYFARTHING_DIST;
+    if (envPath && existsSync(envPath)) {
+        return envPath;
+    }
+    // 2. Packaged Electron app: Contents/Resources/pennyfarthing-dist/
+    const resourcesPath = process.resourcesPath;
+    if (resourcesPath) {
+        const electronResourcesPath = join(resourcesPath, 'pennyfarthing-dist');
+        if (existsSync(electronResourcesPath)) {
+            return electronResourcesPath;
+        }
+    }
+    // 3. Monorepo root (pennyfarthing-dist/ at repo root for dogfooding)
+    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;
+        currentDir = parentDir;
+    }
+    // 4. npm installed: node_modules/pennyfarthing/pennyfarthing-dist/
+    const npmPath = join(__dirname, '..', '..', 'pennyfarthing', 'pennyfarthing-dist');
+    if (existsSync(npmPath)) {
+        return npmPath;
+    }
+    // 5. Scoped npm: node_modules/@pennyfarthing/core/pennyfarthing-dist/
+    const scopedPath = join(__dirname, '..', '..', '@pennyfarthing', 'core', 'pennyfarthing-dist');
+    if (existsSync(scopedPath)) {
+        return scopedPath;
+    }
+    return null;
+}
+/**
+ * Get all portrait-related paths for a resolved dist directory
+ */
+function getPortraitPaths(distPath) {
+    const normalizedPath = distPath.replace(/\/+$/, '');
+    return {
+        portraitsDir: join(normalizedPath, 'personas', 'portraits'),
+        themesDir: join(normalizedPath, 'personas'),
+        agentsDir: join(normalizedPath, 'agents'),
+    };
+}
+// =============================================================================
+// Project Directory Management (Single Source of Truth)
+// =============================================================================
+// Project directory from command-line argument (highest priority)
+let projectDirFromArg = null;
+// Project directory selected via folder picker (set at runtime)
+let selectedProjectDir = null;
+// Track if we've already logged the project directory (avoid spam)
+let hasLoggedProjectDir = false;
+// Testing mode: when true, skip env var check (set by resetProjectDirectory)
+let testingModeActive = false;
+/**
+ * Parse --project-dir argument from CLI
+ * Used when launching via: open Cyclist.app --args --project-dir=/path
+ */
+export function parseProjectDirArg() {
+    const args = process.argv.slice(1);
+    const projectDirArg = args.find(arg => arg.startsWith('--project-dir='));
+    if (projectDirArg) {
+        const path = projectDirArg.split('=')[1];
+        projectDirFromArg = path;
+        return path;
+    }
+    return null;
+}
+/**
+ * Set the project directory (called after folder picker selection or in tests)
+ */
+export function setProjectDirectory(dir) {
+    selectedProjectDir = dir;
+    testingModeActive = false;
+}
+/**
+ * Check if a directory is valid for use as project directory
+ */
+export function isValidProjectDirectory(dir) {
+    if (!dir || dir === '/' || dir === '/Users' || dir === '/Applications')
+        return false;
+    const homeDir = process.env.HOME || '/Users/' + process.env.USER;
+    if (dir === homeDir)
+        return false;
+    try {
+        const stats = statSync(dir);
+        return stats.isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Get the project directory for Claude to run in
+ * Priority: CLI arg → selected dir (from picker) → env var → null (triggers picker)
+ */
+export function getProjectDirectory() {
+    // Check CLI arg first (highest priority)
+    if (projectDirFromArg && isValidProjectDirectory(projectDirFromArg)) {
+        return projectDirFromArg;
+    }
+    // Check selected directory (from picker or setProjectDirectory call)
+    if (selectedProjectDir && isValidProjectDirectory(selectedProjectDir)) {
+        return selectedProjectDir;
+    }
+    // Skip env var check in testing mode
+    if (testingModeActive) {
+        return null;
+    }
+    // Check environment variable (useful for web mode)
+    const envDir = process.env.CYCLIST_PROJECT_DIR;
+    if (envDir && isValidProjectDirectory(envDir)) {
+        if (!hasLoggedProjectDir) {
+            hasLoggedProjectDir = true;
+        }
+        return envDir;
+    }
+    return null;
+}
+/**
+ * Reset project directory state (for testing only)
+ */
+export function resetProjectDirectory() {
+    projectDirFromArg = null;
+    selectedProjectDir = null;
+    hasLoggedProjectDir = false;
+    testingModeActive = true;
+}
+// Resolve public directory - works in dev, compiled, and packaged Electron modes
+export function getPublicDir() {
+    // In packaged Electron app, __dirname is inside asar: app.asar/dist/
+    const asarPublic = join(__dirname, '..', 'src', 'public');
+    if (existsSync(asarPublic)) {
+        return asarPublic;
+    }
+    // Compiled dist: dist/server/paths.js → ../../src/public
+    const compiledPublic = join(__dirname, '..', '..', 'src', 'public');
+    if (existsSync(compiledPublic)) {
+        return compiledPublic;
+    }
+    // Try src/public from cwd (for compiled dist/server.js in dev)
+    const srcPublic = join(process.cwd(), 'src', 'public');
+    if (existsSync(srcPublic)) {
+        return srcPublic;
+    }
+    // Monorepo: __dirname is packages/core/dist/server/, public is in packages/cyclist/src/public/
+    const monorepoPublic = join(__dirname, '..', '..', '..', 'cyclist', 'src', 'public');
+    if (existsSync(monorepoPublic)) {
+        return monorepoPublic;
+    }
+    // Fallback to relative path (for tsx dev mode)
+    return join(__dirname, 'public');
+}
+// Resolve node_modules - works in both dev and packaged Electron modes
+export function getNodeModulesDir() {
+    const asarNodeModules = join(__dirname, '..', 'node_modules');
+    if (existsSync(asarNodeModules)) {
+        return asarNodeModules;
+    }
+    return join(process.cwd(), 'node_modules');
+}
+// Resolve portraits directory
+export function getPortraitsDir() {
+    // 1. Portraits bundled with package
+    const bundledPortraits = join(__dirname, '..', 'portraits');
+    if (existsSync(bundledPortraits)) {
+        return bundledPortraits;
+    }
+    // 2. Monorepo/pennyfarthing-dist (for dogfooding)
+    const distPath = resolvePennyfarthingDist();
+    if (distPath) {
+        const paths = getPortraitPaths(distPath);
+        if (existsSync(paths.portraitsDir)) {
+            return paths.portraitsDir;
+        }
+    }
+    // 3. Fallback: portraits in public dir (dev symlink)
+    const pubDir = getPublicDir();
+    const publicPortraits = join(pubDir, 'portraits');
+    if (existsSync(publicPortraits)) {
+        return publicPortraits;
+    }
+    return null;
+}
+// Get the dist directory (where Vite build output lives — dist/public/)
+export function getDistDir() {
+    // Monorepo: Vite output is in packages/cyclist/dist/, not core's dist/
+    const monorepoDistPublic = join(__dirname, '..', '..', '..', 'cyclist', 'dist');
+    if (existsSync(join(monorepoDistPublic, 'public'))) {
+        return monorepoDistPublic;
+    }
+    if (__dirname.includes('/dist')) {
+        return __dirname;
+    }
+    const distFromSrc = join(__dirname, '..', 'dist');
+    if (existsSync(distFromSrc)) {
+        return distFromSrc;
+    }
+    return __dirname;
+}
+// Singleton instances for commonly used paths
+export const publicDir = getPublicDir();
+export const nodeModulesDir = getNodeModulesDir();
+export const portraitsDir = getPortraitsDir();
+//# sourceMappingURL=paths.js.map

package/packages/core/dist/server/paths.js.map

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

package/packages/core/dist/server/pennyfarthing.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Pennyfarthing detection and persona resolution for server module.
+ * Extracted from packages/cyclist/src/pennyfarthing.ts (Story 98-17).
+ */
+export interface Helper {
+    name: string;
+    style?: string;
+}
+export interface Persona {
+    character: string;
+    displayName: string;
+    role: string;
+    roleDescription: string;
+    style: string;
+    theme: string;
+    slug: string;
+    quote?: string;
+    helper?: Helper;
+    ocean?: {
+        O: number;
+        C: number;
+        E: number;
+        A: number;
+        N: number;
+    };
+}
+interface ThemeConfig {
+    theme: string;
+}
+/**
+ * Detects if a directory is a Pennyfarthing-enabled project
+ */
+export declare function detectPennyfarthingProject(projectDir: string): boolean;
+/**
+ * Loads theme configuration from .pennyfarthing/config.local.yaml
+ */
+export declare function loadThemeConfig(projectDir: string): ThemeConfig | null;
+/**
+ * Loads and parses a theme YAML file
+ */
+export declare function loadThemeYaml(themePath: string): Record<string, Persona> | null;
+export declare function selectCatchphrase(catchphrases: string[] | undefined | null, fallbackQuote: string | undefined | null): string;
+/**
+ * Gets the current persona data for the active agent
+ */
+export declare function getCurrentPersona(projectDir: string, sessionId?: string): Persona | null;
+/**
+ * Gets full persona details including voice, quirks, background for popup display
+ */
+export declare function getFullPersonaDetails(projectDir: string, sessionId?: string): unknown;
+/**
+ * Watches for agent changes and invokes callback when agent changes
+ */
+export declare function watchAgentChanges(projectDir: string, sessionId: string | undefined, callback: (agentRole: string) => void): () => void;
+export {};
+//# sourceMappingURL=pennyfarthing.d.ts.map

package/packages/core/dist/server/pennyfarthing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pennyfarthing.d.ts","sourceRoot":"","sources":["../../src/server/pennyfarthing.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAcH,MAAM,WAAW,MAAM;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,OAAO;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,eAAe,EAAE,MAAM,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE;QACN,CAAC,EAAE,MAAM,CAAC;QACV,CAAC,EAAE,MAAM,CAAC;QACV,CAAC,EAAE,MAAM,CAAC;QACV,CAAC,EAAE,MAAM,CAAC;QACV,CAAC,EAAE,MAAM,CAAC;KACX,CAAC;CACH;AAED,UAAU,WAAW;IACnB,KAAK,EAAE,MAAM,CAAC;CACf;AAiBD;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CA2BtE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAiBtE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAe/E;AAuFD,wBAAgB,iBAAiB,CAC/B,YAAY,EAAE,MAAM,EAAE,GAAG,SAAS,GAAG,IAAI,EACzC,aAAa,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GACvC,MAAM,CAIR;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAmExF;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CA2DrF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,QAAQ,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,GACpC,MAAM,IAAI,CA+BZ"}