@pennyfarthing/core 7.5.0 → 7.6.0

package/packages/core/dist/cli/commands/uninstall.d.ts

@@ -0,0 +1,8 @@
+interface UninstallOptions {
+    force?: boolean;
+    all?: boolean;
+    dryRun?: boolean;
+}
+export declare function uninstallCommand(options: UninstallOptions): Promise<void>;
+export {};
+//# sourceMappingURL=uninstall.d.ts.map

package/packages/core/dist/cli/commands/uninstall.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uninstall.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/uninstall.ts"],"names":[],"mappings":"AAOA,UAAU,gBAAgB;IACxB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AA6BD,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAuJ/E"}

package/packages/core/dist/cli/commands/uninstall.js

@@ -0,0 +1,237 @@
+import { rmSync, statSync, readdirSync } from 'fs';
+import { join } from 'path';
+import { logger } from '../utils/logger.js';
+import { pathExists } from '../utils/files.js';
+import { readManifest } from '../utils/manifest.js';
+import { confirm } from '../utils/prompts.js';
+// Managed paths - always removed
+// Note: .claude/pennyfarthing includes scripts/, agents, commands, etc.
+const MANAGED_PATHS = [
+    '.claude/pennyfarthing',
+    '.claude/agents', // symlink
+    '.claude/commands', // symlink
+    '.claude/subagents', // symlink
+    '.claude/guides', // symlink
+    '.claude/skills', // symlink
+    '.claude/personas', // symlink
+    '.claude/manifest.json',
+    '.claude/settings.local.json'
+];
+// Project paths - only removed with --all
+const PROJECT_PATHS = [
+    '.claude/project',
+    '.claude/persona-config.yaml',
+    '.session'
+];
+// Always preserved - even with --all
+const PRESERVED_PATHS = [
+    'sprint/archive',
+    'sprint/context'
+];
+export async function uninstallCommand(options) {
+    const projectRoot = process.cwd();
+    const dryRun = options.dryRun;
+    // Check for manifest
+    const manifest = readManifest(projectRoot);
+    if (!manifest) {
+        logger.error('No Pennyfarthing installation found in this directory.');
+        logger.info('(missing .claude/manifest.json)');
+        process.exit(1);
+    }
+    logger.header('Pennyfarthing Uninstall');
+    logger.info(`Project: ${projectRoot}`);
+    logger.info(`Installed version: ${manifest.version}`);
+    if (dryRun) {
+        logger.newline();
+        logger.info('Dry run mode - no changes will be made');
+    }
+    // Show what will be removed
+    logger.newline();
+    logger.header('Files to remove (managed):');
+    const managedToRemove = [];
+    for (const path of MANAGED_PATHS) {
+        const fullPath = join(projectRoot, path);
+        if (pathExists(fullPath)) {
+            const info = getPathInfo(fullPath);
+            logger.info(`  ${path}${info}`);
+            managedToRemove.push(path);
+        }
+    }
+    const projectToRemove = [];
+    if (options.all) {
+        logger.newline();
+        logger.header('Files to remove (project-specific):');
+        for (const path of PROJECT_PATHS) {
+            const fullPath = join(projectRoot, path);
+            if (pathExists(fullPath)) {
+                const info = getPathInfo(fullPath);
+                logger.info(`  ${path}${info}`);
+                projectToRemove.push(path);
+            }
+        }
+        // Sprint YAML (but not archive/context)
+        const sprintYaml = join(projectRoot, 'sprint/current-sprint.yaml');
+        if (pathExists(sprintYaml)) {
+            logger.info('  sprint/current-sprint.yaml');
+            projectToRemove.push('sprint/current-sprint.yaml');
+        }
+    }
+    else {
+        logger.newline();
+        logger.header('Files preserved (project-specific):');
+        for (const path of PROJECT_PATHS) {
+            const fullPath = join(projectRoot, path);
+            if (pathExists(fullPath)) {
+                logger.success(`  ${path}`);
+            }
+        }
+        if (pathExists(join(projectRoot, 'sprint'))) {
+            logger.success('  sprint/');
+        }
+        logger.newline();
+        logger.info('Use --all to also remove project-specific files');
+    }
+    // Show preserved paths
+    logger.newline();
+    logger.header('Files ALWAYS preserved (archived work):');
+    for (const path of PRESERVED_PATHS) {
+        const fullPath = join(projectRoot, path);
+        if (pathExists(fullPath)) {
+            const info = getPathInfo(fullPath);
+            logger.success(`  ${path}${info}`);
+        }
+    }
+    // Confirm unless --force
+    if (!options.force && !dryRun) {
+        logger.newline();
+        const confirmed = await confirm('Proceed with uninstall?');
+        if (!confirmed) {
+            logger.info('Aborted.');
+            return;
+        }
+    }
+    // Remove files
+    logger.newline();
+    logger.header('Removing files...');
+    // Remove managed paths
+    for (const path of managedToRemove) {
+        const fullPath = join(projectRoot, path);
+        if (!dryRun) {
+            rmSync(fullPath, { recursive: true, force: true });
+        }
+        logger.error(`  ✗ ${path}`);
+    }
+    // Remove project paths if --all
+    if (options.all) {
+        for (const path of projectToRemove) {
+            const fullPath = join(projectRoot, path);
+            if (!dryRun) {
+                rmSync(fullPath, { recursive: true, force: true });
+            }
+            logger.error(`  ✗ ${path}`);
+        }
+        // Show preserved
+        logger.newline();
+        logger.header('Preserved:');
+        for (const path of PRESERVED_PATHS) {
+            const fullPath = join(projectRoot, path);
+            if (pathExists(fullPath)) {
+                logger.success(`  ✓ ${path}`);
+            }
+        }
+    }
+    // Clean up empty directories
+    cleanupEmptyDirs(projectRoot, dryRun);
+    // Remove symlinks in .claude/ if they exist
+    const symlinks = ['agents', 'subagents', 'commands', 'guides'];
+    for (const link of symlinks) {
+        const linkPath = join(projectRoot, '.claude', link);
+        try {
+            const stats = statSync(linkPath);
+            if (stats.isSymbolicLink()) {
+                if (!dryRun) {
+                    rmSync(linkPath);
+                }
+                logger.error(`  ✗ .claude/${link} (symlink)`);
+            }
+        }
+        catch {
+            // Ignore - doesn't exist or not a symlink
+        }
+    }
+    logger.newline();
+    logger.success('Pennyfarthing uninstalled successfully.');
+    logger.newline();
+    logger.info('To reinstall:');
+    logger.info('  pennyfarthing init');
+}
+function getPathInfo(fullPath) {
+    try {
+        const stats = statSync(fullPath);
+        if (stats.isDirectory()) {
+            const files = countFiles(fullPath);
+            return ` (${files} files)`;
+        }
+        return '';
+    }
+    catch {
+        return '';
+    }
+}
+function countFiles(dir) {
+    let count = 0;
+    try {
+        const entries = readdirSync(dir, { withFileTypes: true });
+        for (const entry of entries) {
+            if (entry.isFile()) {
+                count++;
+            }
+            else if (entry.isDirectory()) {
+                count += countFiles(join(dir, entry.name));
+            }
+        }
+    }
+    catch {
+        // Ignore errors
+    }
+    return count;
+}
+function cleanupEmptyDirs(projectRoot, dryRun) {
+    // Clean up .claude if empty
+    const claudeDir = join(projectRoot, '.claude');
+    if (pathExists(claudeDir) && isDirEmpty(claudeDir)) {
+        if (!dryRun) {
+            rmSync(claudeDir, { recursive: true });
+        }
+        logger.error('  ✗ .claude/ (empty)');
+    }
+    // Clean up scripts if empty
+    const scriptsDir = join(projectRoot, 'scripts');
+    if (pathExists(scriptsDir) && isDirEmpty(scriptsDir)) {
+        if (!dryRun) {
+            rmSync(scriptsDir, { recursive: true });
+        }
+        logger.error('  ✗ scripts/ (empty)');
+    }
+}
+function isDirEmpty(dir) {
+    try {
+        const entries = readdirSync(dir);
+        if (entries.length === 0)
+            return true;
+        // Check if all entries are empty directories
+        for (const entry of entries) {
+            const fullPath = join(dir, entry);
+            const stats = statSync(fullPath);
+            if (stats.isFile())
+                return false;
+            if (stats.isDirectory() && !isDirEmpty(fullPath))
+                return false;
+        }
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=uninstall.js.map

package/packages/core/dist/cli/commands/uninstall.js.map

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

package/packages/core/dist/cli/commands/update.d.ts

@@ -0,0 +1,9 @@
+interface UpdateOptions {
+    force?: boolean;
+    backup?: boolean;
+    check?: boolean;
+    dryRun?: boolean;
+}
+export declare function updateCommand(options: UpdateOptions): Promise<void>;
+export {};
+//# sourceMappingURL=update.d.ts.map

package/packages/core/dist/cli/commands/update.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/update.ts"],"names":[],"mappings":"AA0BA,UAAU,aAAa;IACrB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAUD,wBAAsB,aAAa,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAyFzE"}

package/packages/core/dist/cli/commands/update.js

@@ -0,0 +1,390 @@
+import { readFileSync, writeFileSync, copyFileSync, readdirSync } from 'fs';
+import { join, relative } from 'path';
+import fsExtra from 'fs-extra';
+const { ensureDirSync, removeSync } = fsExtra;
+import { logger } from '../utils/logger.js';
+import { manifestExists, readManifest, writeManifest, createManifest } from '../utils/manifest.js';
+import { pathExists, isDirectory, hashFile } from '../utils/files.js';
+import { getPackageVersion, getAssetsPath } from '../utils/version.js';
+import { copyDirectory, copyCommandsDirectory, copySkillsDirectory } from '../utils/symlinks.js';
+import { findNodeModulesPath } from '../utils/node-modules.js';
+import { DIRECTORY_SYMLINKS, CORE_AGENTS } from '../utils/constants.js';
+export async function updateCommand(options) {
+    const projectRoot = process.cwd();
+    const dryRun = options.dryRun;
+    // 1. Check for manifest
+    if (!manifestExists(projectRoot)) {
+        logger.error('Pennyfarthing not initialized. Run `pennyfarthing init` first.');
+        process.exit(1);
+    }
+    const manifest = readManifest(projectRoot);
+    if (!manifest) {
+        logger.error('Failed to read manifest');
+        process.exit(1);
+    }
+    // 2. Compare versions
+    const packageVersion = getPackageVersion();
+    const updateInfo = await checkForUpdates(projectRoot, manifest);
+    if (options.check) {
+        // Just check and exit
+        if (updateInfo.needsUpdate) {
+            logger.info(`Update available: ${updateInfo.currentVersion} → ${updateInfo.availableVersion}`);
+            process.exit(0);
+        }
+        else {
+            logger.success(`Already up to date (v${updateInfo.currentVersion})`);
+            process.exit(0);
+        }
+    }
+    // 3. Show update info
+    logger.header('Pennyfarthing Update');
+    // Check installation type and node_modules availability
+    const nodeModulesPath = findNodeModulesPath(projectRoot);
+    const currentInstallType = manifest.installationType || 'copy'; // Default to copy for old manifests
+    // Always check and update settings (idempotent - only makes changes if needed)
+    const assetsPath = getAssetsPath();
+    // Copy mode is no longer supported - require fresh install
+    if (currentInstallType === 'copy') {
+        logger.error('Copy mode installations are no longer supported.');
+        logger.error('');
+        logger.error('Please reinstall with npm:');
+        logger.error('  npm install pennyfarthing');
+        logger.error('  npx pennyfarthing init --force');
+        process.exit(1);
+    }
+    // Must have node_modules for symlink mode
+    if (!nodeModulesPath) {
+        logger.error('@pennyfarthing/core (or pennyfarthing) not found');
+        logger.error('');
+        logger.error('Please ensure pennyfarthing is installed:');
+        logger.error('  npm install pennyfarthing');
+        process.exit(1);
+    }
+    const settingsUpdated = await mergeSettingsHooks(projectRoot, assetsPath, { dryRun });
+    if (!updateInfo.needsUpdate && updateInfo.userModifiedFiles.length === 0 && !settingsUpdated) {
+        logger.success(`Already up to date (v${updateInfo.currentVersion})`);
+        return;
+    }
+    if (updateInfo.needsUpdate) {
+        logger.info(`Updating ${updateInfo.currentVersion} → ${updateInfo.availableVersion}`);
+    }
+    else {
+        logger.info(`Refreshing files (v${updateInfo.currentVersion})`);
+    }
+    if (dryRun) {
+        logger.info('Dry run mode - no changes will be made');
+    }
+    // Update installed content by re-copying from package
+    await updateInstalledContent(projectRoot, nodeModulesPath, manifest, packageVersion, { dryRun });
+    // 7. Success
+    logger.newline();
+    logger.success(`Updated to v${packageVersion}`);
+    // 8. Run doctor
+    logger.newline();
+    logger.info('Running health check...');
+    const { doctorCommand } = await import('./doctor.js');
+    await doctorCommand({ quiet: true });
+}
+/**
+ * Update installed content by re-copying from package
+ * This ensures .pennyfarthing/ has the latest content
+ */
+async function updateInstalledContent(projectRoot, nodeModulesPath, manifest, version, options) {
+    const dryRun = options.dryRun;
+    logger.newline();
+    logger.info('Updating Pennyfarthing content...');
+    // Re-copy directories from package to .pennyfarthing/
+    for (const { name, link } of DIRECTORY_SYMLINKS) {
+        const sourcePath = join(nodeModulesPath, name);
+        const destPath = join(projectRoot, link);
+        if (copyDirectory(sourcePath, destPath, dryRun)) {
+            logger.updated(`${link}/`);
+        }
+        else {
+            logger.warning(`Could not update ${link}`);
+        }
+    }
+    // Ensure project directories exist
+    const projectCommandsDir = join(projectRoot, '.claude/project/commands');
+    if (!pathExists(projectCommandsDir)) {
+        if (!dryRun) {
+            ensureDirSync(projectCommandsDir);
+        }
+        logger.created('.claude/project/commands/ (for user custom commands)');
+    }
+    const projectSkillsDir = join(projectRoot, '.claude/project/skills');
+    if (!pathExists(projectSkillsDir)) {
+        if (!dryRun) {
+            ensureDirSync(projectSkillsDir);
+        }
+        logger.created('.claude/project/skills/ (for user custom skills)');
+    }
+    // Re-copy commands and skills
+    const builtInCommandsPath = join(nodeModulesPath, 'commands');
+    copyCommandsDirectory(projectRoot, builtInCommandsPath, projectCommandsDir, dryRun || false);
+    const builtInSkillsPath = join(nodeModulesPath, 'skills');
+    copySkillsDirectory(projectRoot, builtInSkillsPath, projectSkillsDir, dryRun || false);
+    // Migrate sidecars from old location to new location
+    await migrateSidecars(projectRoot, { dryRun });
+    // Update settings
+    const assetsPath = getAssetsPath();
+    await mergeSettingsHooks(projectRoot, assetsPath, { dryRun });
+    // Update manifest version
+    logger.newline();
+    logger.info('Updating manifest...');
+    const nodeModulesRelPath = relative(projectRoot, nodeModulesPath);
+    const newManifest = createManifest(manifest?.projectName || 'unknown', version, {
+        nodeModulesPath: nodeModulesRelPath
+    });
+    writeManifest(projectRoot, newManifest, { dryRun });
+    logger.updated('.claude/manifest.json');
+}
+/**
+ * Migrate sidecars from .claude/project/agents/{agent}-sidecar/ to .pennyfarthing/sidecars/{agent}/
+ * Also migrates from old sprint/sidecars/ location
+ * Preserves user content while moving to new location
+ */
+async function migrateSidecars(projectRoot, options) {
+    const dryRun = options.dryRun;
+    let migrated = 0;
+    // Ensure new sidecars directory exists
+    const newSidecarsDir = join(projectRoot, '.pennyfarthing/sidecars');
+    if (!pathExists(newSidecarsDir)) {
+        if (!dryRun) {
+            ensureDirSync(newSidecarsDir);
+        }
+    }
+    for (const agent of CORE_AGENTS) {
+        // Check both legacy locations
+        const legacyDir1 = join(projectRoot, `.claude/project/agents/${agent}-sidecar`);
+        const legacyDir2 = join(projectRoot, `sprint/sidecars/${agent}`);
+        const oldDir = pathExists(legacyDir1) ? legacyDir1 : (pathExists(legacyDir2) ? legacyDir2 : null);
+        const newDir = join(projectRoot, `.pennyfarthing/sidecars/${agent}`);
+        // Skip if no legacy directory found
+        if (!oldDir) {
+            continue;
+        }
+        // Create new directory if needed
+        if (!pathExists(newDir)) {
+            if (!dryRun) {
+                ensureDirSync(newDir);
+            }
+        }
+        // Copy each .md file from old to new (don't overwrite existing)
+        try {
+            const files = readdirSync(oldDir);
+            for (const file of files) {
+                if (!file.endsWith('.md'))
+                    continue;
+                const oldPath = join(oldDir, file);
+                const newPath = join(newDir, file);
+                // Don't overwrite if new file already exists
+                if (pathExists(newPath)) {
+                    continue;
+                }
+                if (!dryRun) {
+                    copyFileSync(oldPath, newPath);
+                }
+                migrated++;
+            }
+        }
+        catch {
+            // Ignore errors reading old directory
+        }
+    }
+    if (migrated > 0) {
+        logger.info(`Migrated ${migrated} sidecar files to .pennyfarthing/sidecars/`);
+    }
+    // Clean up old sprint/sidecars directory if it exists and is now empty or fully migrated
+    const oldSprintSidecars = join(projectRoot, 'sprint/sidecars');
+    if (pathExists(oldSprintSidecars)) {
+        try {
+            const remaining = readdirSync(oldSprintSidecars);
+            // Check if all remaining items are agent directories that have been migrated
+            const allMigrated = remaining.every(item => {
+                const itemPath = join(oldSprintSidecars, item);
+                if (!isDirectory(itemPath))
+                    return false;
+                // Check if this agent's sidecar now exists in new location
+                const newAgentDir = join(projectRoot, `.pennyfarthing/sidecars/${item}`);
+                return pathExists(newAgentDir);
+            });
+            if (allMigrated && !dryRun) {
+                removeSync(oldSprintSidecars);
+                logger.info('Removed legacy sprint/sidecars/ directory');
+            }
+        }
+        catch {
+            // Ignore cleanup errors
+        }
+    }
+}
+async function checkForUpdates(projectRoot, manifest) {
+    const packageVersion = getPackageVersion();
+    const assetsPath = getAssetsPath();
+    const changedFiles = [];
+    const userModifiedFiles = [];
+    if (!manifest) {
+        return {
+            currentVersion: '0.0.0',
+            availableVersion: packageVersion,
+            needsUpdate: true,
+            changedFiles: [],
+            userModifiedFiles: []
+        };
+    }
+    // Check each file in manifest
+    for (const [filePath, expectedHash] of Object.entries(manifest.fileHashes)) {
+        const fullPath = join(projectRoot, filePath);
+        if (!pathExists(fullPath)) {
+            changedFiles.push(filePath);
+            continue;
+        }
+        const currentHash = hashFile(fullPath);
+        if (currentHash !== expectedHash) {
+            // File has been modified locally
+            userModifiedFiles.push(filePath);
+        }
+        // Check if package has a newer version
+        // Map installed path back to source path
+        const assetsFile = filePath
+            .replace('.claude/pennyfarthing/', '')
+            .replace('scripts/', 'scripts/');
+        const assetsFilePath = join(assetsPath, assetsFile);
+        if (pathExists(assetsFilePath)) {
+            const packageHash = hashFile(assetsFilePath);
+            if (packageHash !== expectedHash) {
+                changedFiles.push(filePath);
+            }
+        }
+    }
+    // Compare versions
+    const needsUpdate = compareVersions(packageVersion, manifest.version) > 0;
+    return {
+        currentVersion: manifest.version,
+        availableVersion: packageVersion,
+        needsUpdate,
+        changedFiles,
+        userModifiedFiles
+    };
+}
+function compareVersions(a, b) {
+    const partsA = a.split('.').map(Number);
+    const partsB = b.split('.').map(Number);
+    for (let i = 0; i < Math.max(partsA.length, partsB.length); i++) {
+        const numA = partsA[i] || 0;
+        const numB = partsB[i] || 0;
+        if (numA > numB)
+            return 1;
+        if (numA < numB)
+            return -1;
+    }
+    return 0;
+}
+/**
+ * Merge required hooks into existing settings.local.json
+ * This ensures critical hooks like SessionStart are always configured
+ * Returns true if any changes were made
+ */
+async function mergeSettingsHooks(projectRoot, assetsPath, options) {
+    const settingsPath = join(projectRoot, '.claude/settings.local.json');
+    const templatePath = join(assetsPath, 'templates/settings.local.json.template');
+    if (!pathExists(templatePath)) {
+        return false;
+    }
+    const templateContent = JSON.parse(readFileSync(templatePath, 'utf8'));
+    // If no existing settings, create from template
+    if (!pathExists(settingsPath)) {
+        if (!options.dryRun) {
+            ensureDirSync(join(projectRoot, '.claude'));
+            writeFileSync(settingsPath, JSON.stringify(templateContent, null, 2), 'utf8');
+        }
+        logger.created('.claude/settings.local.json');
+        return true;
+    }
+    // Read existing settings
+    let existingSettings;
+    try {
+        existingSettings = JSON.parse(readFileSync(settingsPath, 'utf8'));
+    }
+    catch {
+        logger.warning('Could not parse existing settings.local.json, skipping merge');
+        return false;
+    }
+    let modified = false;
+    // Ensure hooks object exists
+    if (!existingSettings.hooks) {
+        existingSettings.hooks = {};
+        modified = true;
+    }
+    const hooks = existingSettings.hooks;
+    // Merge SessionStart hooks - these are critical for PROJECT_ROOT
+    if (!hooks.SessionStart) {
+        hooks.SessionStart = templateContent.hooks?.SessionStart || [];
+        modified = true;
+        logger.info('Added missing SessionStart hooks');
+    }
+    else if (Array.isArray(hooks.SessionStart)) {
+        // Check if session-start.sh hook is configured
+        const hasSessionStartHook = hooks.SessionStart.some((entry) => {
+            if (typeof entry === 'object' && entry !== null) {
+                const hookEntry = entry;
+                return hookEntry.hooks?.some(h => h.command?.includes('session-start.sh'));
+            }
+            return false;
+        });
+        if (!hasSessionStartHook && templateContent.hooks?.SessionStart) {
+            // Prepend the session-start.sh hook entry
+            const sessionStartEntry = templateContent.hooks.SessionStart.find((entry) => {
+                if (typeof entry === 'object' && entry !== null) {
+                    const hookEntry = entry;
+                    return hookEntry.hooks?.some(h => h.command?.includes('session-start.sh'));
+                }
+                return false;
+            });
+            if (sessionStartEntry) {
+                hooks.SessionStart = [sessionStartEntry, ...hooks.SessionStart];
+                modified = true;
+                logger.info('Added missing session-start.sh hook');
+            }
+        }
+    }
+    // Merge SessionEnd hooks if missing
+    if (!hooks.SessionEnd && templateContent.hooks?.SessionEnd) {
+        hooks.SessionEnd = templateContent.hooks.SessionEnd;
+        modified = true;
+        logger.info('Added missing SessionEnd hooks');
+    }
+    // Ensure statusLine is configured and points to new location
+    const statusLine = existingSettings.statusLine;
+    if (!statusLine) {
+        existingSettings.statusLine = templateContent.statusLine;
+        modified = true;
+        logger.info('Added missing statusLine configuration');
+    }
+    else if (statusLine.command && typeof statusLine.command === 'string') {
+        // Migrate from any legacy path to new path (.pennyfarthing/scripts/misc/statusline.sh)
+        const legacyPaths = [
+            '.claude/core/statusline.sh',
+            '.claude/statusline.sh',
+            '.claude/pennyfarthing/statusline.sh', // Old copy-mode path (v4.0.0-4.0.3)
+            '.claude/pennyfarthing/scripts/statusline.sh', // Bug in template (fixed in v4.0.5)
+            '.claude/scripts/statusline.sh', // Previous location (pre-v6.6)
+            '.pennyfarthing/scripts/statusline.sh' // Missing misc/ subdirectory (fixed in v7.0.3)
+        ];
+        for (const legacyPath of legacyPaths) {
+            if (statusLine.command.includes(legacyPath)) {
+                statusLine.command = statusLine.command.replace(legacyPath, '.pennyfarthing/scripts/misc/statusline.sh');
+                modified = true;
+                logger.info(`Updated statusLine path from ${legacyPath} to new location`);
+                break;
+            }
+        }
+    }
+    if (modified && !options.dryRun) {
+        writeFileSync(settingsPath, JSON.stringify(existingSettings, null, 2), 'utf8');
+        logger.updated('.claude/settings.local.json');
+    }
+    return modified;
+}
+//# sourceMappingURL=update.js.map