@pennyfarthing/core 7.5.0 → 7.6.0

package/packages/core/dist/cli/utils/symlinks.js

@@ -0,0 +1,327 @@
+import { readdirSync, unlinkSync, symlinkSync, copyFileSync } from 'fs';
+import { join, relative, dirname } from 'path';
+import fsExtra from 'fs-extra';
+const { ensureDirSync, removeSync, copySync } = fsExtra;
+import { logger } from './logger.js';
+import { pathExists, isSymlink, isDirectory } from './files.js';
+/**
+ * Compute relative path for symlink from link location to target
+ */
+export function computeRelativeSymlink(linkPath, targetPath) {
+    return relative(dirname(linkPath), targetPath);
+}
+/**
+ * Remove a symlink or directory at the given path
+ * Handles both symlinks and directories (for migration from copy mode)
+ * Returns true if something was removed, false if path didn't exist
+ */
+export function removeSymlinkOrDirectory(path, dryRun = false) {
+    if (!pathExists(path) && !isSymlink(path)) {
+        return false;
+    }
+    if (dryRun) {
+        return true;
+    }
+    try {
+        unlinkSync(path);
+        return true;
+    }
+    catch {
+        try {
+            removeSync(path);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+}
+/**
+ * Create commands directory with individual symlinks to each command file.
+ * This allows users to add their own commands alongside built-in ones.
+ */
+export function createCommandsDirectory(projectRoot, builtInCommandsPath, projectCommandsPath, dryRun) {
+    const commandsDir = join(projectRoot, '.claude/commands');
+    // Remove existing symlink or directory
+    removeSymlinkOrDirectory(commandsDir, dryRun);
+    // Create commands directory
+    if (!dryRun) {
+        ensureDirSync(commandsDir);
+    }
+    logger.created('.claude/commands/ (directory for built-in + user commands)');
+    // Symlink each built-in command
+    if (pathExists(builtInCommandsPath)) {
+        const builtInCommands = readdirSync(builtInCommandsPath).filter(f => f.endsWith('.md'));
+        for (const cmd of builtInCommands) {
+            const linkPath = join(commandsDir, cmd);
+            const targetPath = join(builtInCommandsPath, cmd);
+            const relativeTarget = computeRelativeSymlink(linkPath, targetPath);
+            if (!dryRun) {
+                try {
+                    symlinkSync(relativeTarget, linkPath);
+                }
+                catch (e) {
+                    logger.warning(`Could not create symlink for ${cmd}: ${e}`);
+                }
+            }
+        }
+        logger.info(`  Linked ${builtInCommands.length} built-in commands`);
+    }
+    // Symlink user project commands (if any exist)
+    if (pathExists(projectCommandsPath)) {
+        const projectCommands = readdirSync(projectCommandsPath).filter(f => f.endsWith('.md'));
+        let linkedCount = 0;
+        for (const cmd of projectCommands) {
+            const linkPath = join(commandsDir, cmd);
+            if (pathExists(linkPath)) {
+                logger.warning(`  Skipping ${cmd} - would override built-in command`);
+                continue;
+            }
+            const targetPath = join(projectCommandsPath, cmd);
+            const relativeTarget = computeRelativeSymlink(linkPath, targetPath);
+            if (!dryRun) {
+                try {
+                    symlinkSync(relativeTarget, linkPath);
+                    linkedCount++;
+                }
+                catch (e) {
+                    logger.warning(`Could not create symlink for ${cmd}: ${e}`);
+                }
+            }
+            else {
+                linkedCount++;
+            }
+        }
+        if (linkedCount > 0) {
+            logger.info(`  Linked ${linkedCount} user commands from project/commands/`);
+        }
+    }
+}
+/**
+ * Create skills directory with individual symlinks to each skill file.
+ * This allows users to add their own skills alongside built-in ones.
+ */
+export function createSkillsDirectory(projectRoot, builtInSkillsPath, projectSkillsPath, dryRun) {
+    const skillsDir = join(projectRoot, '.claude/skills');
+    // Remove existing symlink or directory
+    removeSymlinkOrDirectory(skillsDir, dryRun);
+    // Create skills directory
+    if (!dryRun) {
+        ensureDirSync(skillsDir);
+    }
+    logger.created('.claude/skills/ (directory for built-in + user skills)');
+    // Symlink each built-in skill (skills are directories, not .md files)
+    if (pathExists(builtInSkillsPath)) {
+        const builtInSkills = readdirSync(builtInSkillsPath).filter(f => {
+            const fullPath = join(builtInSkillsPath, f);
+            return isDirectory(fullPath) && !f.startsWith('.');
+        });
+        for (const skill of builtInSkills) {
+            const linkPath = join(skillsDir, skill);
+            const targetPath = join(builtInSkillsPath, skill);
+            const relativeTarget = computeRelativeSymlink(linkPath, targetPath);
+            if (!dryRun) {
+                try {
+                    symlinkSync(relativeTarget, linkPath);
+                }
+                catch (e) {
+                    logger.warning(`Could not create symlink for ${skill}: ${e}`);
+                }
+            }
+        }
+        logger.info(`  Linked ${builtInSkills.length} built-in skills`);
+    }
+    // Symlink user project skills (if any exist) - skills are directories
+    if (pathExists(projectSkillsPath)) {
+        const projectSkills = readdirSync(projectSkillsPath).filter(f => {
+            const fullPath = join(projectSkillsPath, f);
+            return isDirectory(fullPath) && !f.startsWith('.');
+        });
+        let linkedCount = 0;
+        for (const skill of projectSkills) {
+            const linkPath = join(skillsDir, skill);
+            if (pathExists(linkPath)) {
+                logger.warning(`  Skipping ${skill} - would override built-in skill`);
+                continue;
+            }
+            const targetPath = join(projectSkillsPath, skill);
+            const relativeTarget = computeRelativeSymlink(linkPath, targetPath);
+            if (!dryRun) {
+                try {
+                    symlinkSync(relativeTarget, linkPath);
+                    linkedCount++;
+                }
+                catch (e) {
+                    logger.warning(`Could not create symlink for ${skill}: ${e}`);
+                }
+            }
+            else {
+                linkedCount++;
+            }
+        }
+        if (linkedCount > 0) {
+            logger.info(`  Linked ${linkedCount} user skills from project/skills/`);
+        }
+    }
+}
+/**
+ * Copy a directory from source to destination (for installed apps).
+ * Unlike symlinks, this makes .pennyfarthing self-contained.
+ */
+export function copyDirectory(sourcePath, destPath, dryRun = false) {
+    if (!pathExists(sourcePath)) {
+        return false;
+    }
+    // Remove existing symlink or directory
+    removeSymlinkOrDirectory(destPath, dryRun);
+    if (!dryRun) {
+        try {
+            copySync(sourcePath, destPath, { overwrite: true });
+            return true;
+        }
+        catch (e) {
+            logger.warning(`Could not copy ${sourcePath} to ${destPath}: ${e}`);
+            return false;
+        }
+    }
+    return true;
+}
+/**
+ * Copy commands directory - copies each command file.
+ * This allows users to add their own commands alongside built-in ones.
+ */
+export function copyCommandsDirectory(projectRoot, builtInCommandsPath, projectCommandsPath, dryRun) {
+    const commandsDir = join(projectRoot, '.claude/commands');
+    // Remove existing symlink or directory
+    removeSymlinkOrDirectory(commandsDir, dryRun);
+    // Create commands directory
+    if (!dryRun) {
+        ensureDirSync(commandsDir);
+    }
+    logger.created('.claude/commands/ (directory for built-in + user commands)');
+    // Copy each built-in command
+    if (pathExists(builtInCommandsPath)) {
+        const builtInCommands = readdirSync(builtInCommandsPath).filter(f => f.endsWith('.md'));
+        for (const cmd of builtInCommands) {
+            const sourcePath = join(builtInCommandsPath, cmd);
+            const destPath = join(commandsDir, cmd);
+            if (!dryRun) {
+                try {
+                    copyFileSync(sourcePath, destPath);
+                }
+                catch (e) {
+                    logger.warning(`Could not copy ${cmd}: ${e}`);
+                }
+            }
+        }
+        logger.info(`  Copied ${builtInCommands.length} built-in commands`);
+    }
+    // Copy user project commands (if any exist)
+    if (pathExists(projectCommandsPath)) {
+        const projectCommands = readdirSync(projectCommandsPath).filter(f => f.endsWith('.md'));
+        let copiedCount = 0;
+        for (const cmd of projectCommands) {
+            const destPath = join(commandsDir, cmd);
+            if (pathExists(destPath)) {
+                logger.warning(`  Skipping ${cmd} - would override built-in command`);
+                continue;
+            }
+            const sourcePath = join(projectCommandsPath, cmd);
+            if (!dryRun) {
+                try {
+                    copyFileSync(sourcePath, destPath);
+                    copiedCount++;
+                }
+                catch (e) {
+                    logger.warning(`Could not copy ${cmd}: ${e}`);
+                }
+            }
+            else {
+                copiedCount++;
+            }
+        }
+        if (copiedCount > 0) {
+            logger.info(`  Copied ${copiedCount} user commands from project/commands/`);
+        }
+    }
+}
+/**
+ * Copy skills directory - copies each skill subdirectory.
+ * This allows users to add their own skills alongside built-in ones.
+ */
+export function copySkillsDirectory(projectRoot, builtInSkillsPath, projectSkillsPath, dryRun) {
+    const skillsDir = join(projectRoot, '.claude/skills');
+    // Remove existing symlink or directory
+    removeSymlinkOrDirectory(skillsDir, dryRun);
+    // Create skills directory
+    if (!dryRun) {
+        ensureDirSync(skillsDir);
+    }
+    logger.created('.claude/skills/ (directory for built-in + user skills)');
+    // Copy each built-in skill (skills are directories)
+    if (pathExists(builtInSkillsPath)) {
+        const builtInSkills = readdirSync(builtInSkillsPath).filter(f => {
+            const fullPath = join(builtInSkillsPath, f);
+            return isDirectory(fullPath) && !f.startsWith('.');
+        });
+        for (const skill of builtInSkills) {
+            const sourcePath = join(builtInSkillsPath, skill);
+            const destPath = join(skillsDir, skill);
+            if (!dryRun) {
+                try {
+                    copySync(sourcePath, destPath, { overwrite: true });
+                }
+                catch (e) {
+                    logger.warning(`Could not copy skill ${skill}: ${e}`);
+                }
+            }
+        }
+        logger.info(`  Copied ${builtInSkills.length} built-in skills`);
+    }
+    // Copy user project skills (if any exist) - skills are directories
+    if (pathExists(projectSkillsPath)) {
+        const projectSkills = readdirSync(projectSkillsPath).filter(f => {
+            const fullPath = join(projectSkillsPath, f);
+            return isDirectory(fullPath) && !f.startsWith('.');
+        });
+        let copiedCount = 0;
+        for (const skill of projectSkills) {
+            const destPath = join(skillsDir, skill);
+            if (pathExists(destPath)) {
+                logger.warning(`  Skipping ${skill} - would override built-in skill`);
+                continue;
+            }
+            const sourcePath = join(projectSkillsPath, skill);
+            if (!dryRun) {
+                try {
+                    copySync(sourcePath, destPath, { overwrite: true });
+                    copiedCount++;
+                }
+                catch (e) {
+                    logger.warning(`Could not copy skill ${skill}: ${e}`);
+                }
+            }
+            else {
+                copiedCount++;
+            }
+        }
+        if (copiedCount > 0) {
+            logger.info(`  Copied ${copiedCount} user skills from project/skills/`);
+        }
+    }
+}
+/**
+ * Check if commands directory needs migration from single symlink to directory
+ */
+export function needsCommandsMigration(projectRoot) {
+    const commandsPath = join(projectRoot, '.claude/commands');
+    return isSymlink(commandsPath);
+}
+/**
+ * Check if skills directory needs migration from single symlink to directory
+ */
+export function needsSkillsMigration(projectRoot) {
+    const skillsPath = join(projectRoot, '.claude/skills');
+    return isSymlink(skillsPath);
+}
+//# sourceMappingURL=symlinks.js.map

package/packages/core/dist/cli/utils/symlinks.js.map

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

package/packages/core/dist/cli/utils/themes.d.ts

@@ -0,0 +1,101 @@
+export interface ThemeAgentHelper {
+    name: string;
+    style: string;
+}
+export interface ThemeAgent {
+    character: string;
+    style?: string;
+    role?: string;
+    quote?: string;
+    trait?: string;
+    expertise?: string;
+    emoji?: string;
+    helper?: ThemeAgentHelper;
+}
+export interface ThemeInfo {
+    id: string;
+    name: string;
+    description: string;
+    isCustom?: boolean;
+    agents: {
+        sm?: ThemeAgent;
+        tea?: ThemeAgent;
+        dev?: ThemeAgent;
+        reviewer?: ThemeAgent;
+        [key: string]: ThemeAgent | undefined;
+    };
+}
+/**
+ * Get the path to the themes directory
+ */
+export declare function getThemesDir(): string;
+/**
+ * Get the project-level custom themes directory
+ */
+export declare function getProjectCustomThemesDir(projectRoot: string): string;
+/**
+ * Get the user-level custom themes directory
+ */
+export declare function getUserCustomThemesDir(): string;
+/**
+ * Get the path to the .pennyfarthing local config (preferred for dogfooding)
+ */
+export declare function getPennyfarthingConfigPath(projectRoot: string): string;
+/**
+ * Get the current theme from config files
+ * Priority: .pennyfarthing/config.local.yaml > .claude/persona-config.yaml
+ */
+export declare function getCurrentTheme(projectRoot?: string): string | null;
+/**
+ * Parse a theme YAML file and extract theme info
+ */
+export declare function parseThemeFile(filePath: string, isCustom?: boolean): ThemeInfo | null;
+/**
+ * Get all available themes (built-in + custom)
+ */
+export declare function getThemes(projectRoot?: string): ThemeInfo[];
+/**
+ * Get sample agent characters for display
+ */
+export declare function getAgentSamples(theme: ThemeInfo): string;
+export interface SetThemeOptions {
+    /** If true, write to shared config (.claude/persona-config.yaml) instead of local */
+    global?: boolean;
+}
+/**
+ * Set the active theme
+ * By default writes to .pennyfarthing/config.local.yaml (agent-writable, dogfooding-friendly)
+ * Use { global: true } to write to .claude/persona-config.yaml (project default)
+ * Returns the ThemeInfo if successful, throws if theme not found
+ */
+export declare function setTheme(themeName: string, projectRoot: string, options?: SetThemeOptions): ThemeInfo;
+/**
+ * Validate a theme name
+ */
+export declare function validateThemeName(name: string): {
+    valid: boolean;
+    error?: string;
+};
+/**
+ * Get the path to a theme file (built-in or custom)
+ */
+export declare function getThemeFilePath(themeId: string): string | null;
+export interface CreateThemeOptions {
+    baseTheme?: string;
+    userLevel?: boolean;
+}
+/**
+ * Create a new custom theme
+ * Returns the path to the created theme file
+ */
+export declare function createTheme(themeName: string, projectRoot: string, options?: CreateThemeOptions): string;
+export interface ThemeSchemaValidationResult {
+    valid: boolean;
+    errors?: string[];
+}
+/**
+ * Validate a theme object has all required fields and agents
+ * Used to validate AI-generated themes before writing to file
+ */
+export declare function validateThemeSchema(themeData: unknown): ThemeSchemaValidationResult;
+//# sourceMappingURL=themes.d.ts.map

package/packages/core/dist/cli/utils/themes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"themes.d.ts","sourceRoot":"","sources":["../../../src/cli/utils/themes.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,gBAAgB,CAAC;CAC3B;AAED,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,EAAE;QACN,EAAE,CAAC,EAAE,UAAU,CAAC;QAChB,GAAG,CAAC,EAAE,UAAU,CAAC;QACjB,GAAG,CAAC,EAAE,UAAU,CAAC;QACjB,QAAQ,CAAC,EAAE,UAAU,CAAC;QACtB,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAAC;KACvC,CAAC;CACH;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAmBrC;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAErE;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,MAAM,CAE/C;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAEtE;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CA8BnE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,UAAQ,GAAG,SAAS,GAAG,IAAI,CAqBnF;AAwBD;;GAEG;AACH,wBAAgB,SAAS,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,EAAE,CAsC3D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CAcxD;AAED,MAAM,WAAW,eAAe;IAC9B,qFAAqF;IACrF,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,GAAE,eAAoB,GAAG,SAAS,CA0DzG;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAkBlF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAwB/D;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;GAGG;AACH,wBAAgB,WAAW,CACzB,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,kBAAuB,GAC/B,MAAM,CA+CR;AAkBD,MAAM,WAAW,2BAA2B;IAC1C,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,OAAO,GAAG,2BAA2B,CAoDnF"}