@fractary/faber-cli 1.4.4 → 1.5.0

package/dist/commands/migrate.js

@@ -0,0 +1,213 @@
+/**
+ * Migrate command - Convert .fractary/settings.json to .fractary/config.yaml
+ *
+ * Migrates old FABER configuration to the unified config format.
+ * After migration, settings.json is backed up and all FABER commands use config.yaml.
+ */
+import { Command } from 'commander';
+import chalk from 'chalk';
+import fs from 'fs/promises';
+import path from 'path';
+import * as yaml from 'js-yaml';
+import { loadYamlConfig, writeYamlConfig, findProjectRoot, configExists, oldSettingsExists, getOldSettingsPath, getConfigPath } from '../lib/yaml-config.js';
+export function createMigrateCommand() {
+    return new Command('migrate')
+        .description('Migrate from .fractary/settings.json to .fractary/config.yaml')
+        .option('--dry-run', 'Show what would be migrated without making changes')
+        .option('--no-backup', 'Do not create backup of old settings.json')
+        .option('--json', 'Output as JSON')
+        .action(async (options) => {
+        try {
+            const projectRoot = findProjectRoot();
+            const settingsPath = getOldSettingsPath(projectRoot);
+            const configPath = getConfigPath(projectRoot);
+            // Step 1: Check if settings.json exists
+            if (!oldSettingsExists(projectRoot)) {
+                if (options.json) {
+                    console.log(JSON.stringify({
+                        status: 'error',
+                        error: {
+                            message: 'No .fractary/settings.json found to migrate',
+                            recommendation: 'If starting fresh, run: fractary-core:init'
+                        }
+                    }));
+                }
+                else {
+                    console.error(chalk.red('Error: No .fractary/settings.json found to migrate'));
+                    console.log();
+                    console.log('If you\'re starting fresh, run:');
+                    console.log(chalk.cyan('  fractary-core:init'));
+                    console.log();
+                }
+                process.exit(1);
+            }
+            // Step 2: Load old settings
+            let oldSettings;
+            try {
+                const content = await fs.readFile(settingsPath, 'utf-8');
+                oldSettings = JSON.parse(content);
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : String(error);
+                if (options.json) {
+                    console.log(JSON.stringify({
+                        status: 'error',
+                        error: { message: `Failed to parse settings.json: ${message}` }
+                    }));
+                }
+                else {
+                    console.error(chalk.red(`Error: Failed to parse settings.json: ${message}`));
+                }
+                process.exit(1);
+            }
+            // Step 3: Load existing config.yaml (if exists)
+            let config;
+            const configExistsAlready = configExists(projectRoot);
+            if (configExistsAlready) {
+                config = loadYamlConfig({ projectRoot }) || { version: '2.0' };
+                if (!options.json) {
+                    console.log(chalk.yellow('Note: Existing config.yaml found - will merge settings'));
+                }
+            }
+            else {
+                config = { version: '2.0' };
+            }
+            // Step 4: Build migrated config
+            // Map old structure to new unified structure
+            if (oldSettings.anthropic) {
+                config.anthropic = {
+                    ...config.anthropic,
+                    ...oldSettings.anthropic
+                };
+                // Convert hardcoded API key to env var reference if present
+                if (config.anthropic?.api_key && !config.anthropic.api_key.startsWith('${')) {
+                    if (!options.json) {
+                        console.log(chalk.yellow('⚠️  Found hardcoded Anthropic API key'));
+                        console.log('   Recommendation: Set ANTHROPIC_API_KEY environment variable');
+                        console.log('   and use ${ANTHROPIC_API_KEY} in config.yaml');
+                        console.log();
+                    }
+                }
+            }
+            if (oldSettings.github) {
+                config.github = {
+                    ...config.github,
+                    ...oldSettings.github
+                };
+                // Warn about hardcoded tokens
+                if (config.github?.token && !config.github.token.startsWith('${')) {
+                    if (!options.json) {
+                        console.log(chalk.yellow('⚠️  Found hardcoded GitHub token'));
+                        console.log('   Recommendation: Set GITHUB_TOKEN environment variable');
+                        console.log('   and use ${GITHUB_TOKEN} in config.yaml');
+                        console.log();
+                    }
+                }
+            }
+            // Move FABER-specific settings to faber section
+            if (oldSettings.worktree || oldSettings.workflow || oldSettings.backlog_management) {
+                // Validate and convert backlog_management.default_order_by
+                let backlogManagement;
+                if (oldSettings.backlog_management) {
+                    const validOrderBy = ['priority', 'created', 'updated', 'none'];
+                    const orderBy = oldSettings.backlog_management.default_order_by;
+                    backlogManagement = {
+                        ...oldSettings.backlog_management,
+                        default_order_by: orderBy && validOrderBy.includes(orderBy)
+                            ? orderBy
+                            : undefined
+                    };
+                }
+                config.faber = {
+                    ...config.faber,
+                    ...(oldSettings.worktree && { worktree: oldSettings.worktree }),
+                    ...(oldSettings.workflow && { workflow: oldSettings.workflow }),
+                    ...(backlogManagement && { backlog_management: backlogManagement })
+                };
+            }
+            // Step 5: Handle dry-run
+            if (options.dryRun) {
+                const yamlContent = yaml.dump(config, {
+                    indent: 2,
+                    lineWidth: 100,
+                    noRefs: true,
+                    sortKeys: false,
+                });
+                if (options.json) {
+                    console.log(JSON.stringify({
+                        status: 'dry-run',
+                        wouldWrite: configPath,
+                        wouldBackup: options.backup !== false ? `${settingsPath}.backup` : null,
+                        config: config
+                    }, null, 2));
+                }
+                else {
+                    console.log(chalk.cyan('Dry run - would write to config.yaml:'));
+                    console.log();
+                    console.log(yamlContent);
+                    console.log();
+                    if (options.backup !== false) {
+                        console.log(chalk.gray(`Would backup: ${settingsPath} → ${settingsPath}.backup`));
+                    }
+                }
+                return;
+            }
+            // Step 6: Write new config
+            writeYamlConfig(config, projectRoot);
+            // Step 7: Backup old settings
+            if (options.backup !== false) {
+                const backupPath = `${settingsPath}.backup`;
+                await fs.rename(settingsPath, backupPath);
+                if (options.json) {
+                    console.log(JSON.stringify({
+                        status: 'success',
+                        configPath,
+                        backupPath,
+                        message: 'Successfully migrated to config.yaml'
+                    }));
+                }
+                else {
+                    console.log(chalk.green('✓ Successfully migrated to .fractary/config.yaml'));
+                    console.log(chalk.green(`✓ Backup created at ${path.relative(projectRoot, backupPath)}`));
+                }
+            }
+            else {
+                // Delete old settings without backup
+                await fs.unlink(settingsPath);
+                if (options.json) {
+                    console.log(JSON.stringify({
+                        status: 'success',
+                        configPath,
+                        message: 'Successfully migrated to config.yaml (no backup)'
+                    }));
+                }
+                else {
+                    console.log(chalk.green('✓ Successfully migrated to .fractary/config.yaml'));
+                    console.log(chalk.yellow('⚠️  Old settings.json deleted (no backup)'));
+                }
+            }
+            if (!options.json) {
+                console.log();
+                console.log('Next steps:');
+                console.log('  1. Review .fractary/config.yaml');
+                console.log('  2. Replace any hardcoded secrets with environment variable references');
+                console.log('     Example: api_key: ${ANTHROPIC_API_KEY}');
+                console.log('  3. Consider running ' + chalk.cyan('fractary-core:init') + ' to set up other plugins');
+                console.log();
+            }
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            if (options.json) {
+                console.error(JSON.stringify({
+                    status: 'error',
+                    error: { message }
+                }));
+            }
+            else {
+                console.error(chalk.red('Error:'), message);
+            }
+            process.exit(1);
+        }
+    });
+}

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAoBpC;;GAEG;AACH,wBAAgB,cAAc,IAAI,OAAO,CA4IxC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAqBpC;;GAEG;AACH,wBAAgB,cAAc,IAAI,OAAO,CA4IxC"}

package/dist/index.js

@@ -13,6 +13,7 @@ import { createRepoCommand } from './commands/repo/index.js';
 import { createSpecCommand } from './commands/spec/index.js';
 import { createLogsCommand } from './commands/logs/index.js';
 import { createInitCommand } from './commands/init.js';
+import { createMigrateCommand } from './commands/migrate.js';
 import { createPlanCommand } from './commands/plan/index.js';
 import { createAuthCommand } from './commands/auth/index.js';
 // Force unbuffered output to prevent buffering issues in terminals
@@ -32,9 +33,10 @@ export function createFaberCLI() {
         .enablePositionalOptions();
     // Global options
     program.option('--debug', 'Enable debug output');
-    // Workflow commands (top-level) - NEW NAMES
-    program.addCommand(createInitCommand()); // workflow-init
-    program.addCommand(createPlanCommand()); // plan - NEW
+    // Workflow commands (top-level)
+    program.addCommand(createInitCommand()); // init
+    program.addCommand(createMigrateCommand()); // migrate
+    program.addCommand(createPlanCommand()); // plan
     program.addCommand(createRunCommand()); // workflow-run
     program.addCommand(createStatusCommand()); // workflow-status
     program.addCommand(createResumeCommand()); // workflow-resume
@@ -46,13 +48,12 @@ export function createFaberCLI() {
         console.warn(chalk.yellow(`\n⚠️  DEPRECATED: "${oldName}" → use "${newName}"\n`));
     };
     program
-        .command('init')
-        .description('(DEPRECATED: Use workflow-init)')
-        .option('--preset <name>', 'Use a preset configuration', 'default')
+        .command('workflow-init')
+        .description('(DEPRECATED: Use init)')
         .option('--force', 'Overwrite existing configuration')
         .option('--json', 'Output as JSON')
         .action((options) => {
-        showDeprecationWarning('init', 'workflow-init');
+        showDeprecationWarning('workflow-init', 'init');
         const initCmd = createInitCommand();
         initCmd.parse(['', '', ...Object.entries(options).flatMap(([k, v]) => typeof v === 'boolean' && v ? [`--${k}`] : typeof v === 'string' ? [`--${k}`, v] : [])], { from: 'user' });
     });

package/dist/lib/anthropic-client.d.ts

@@ -3,7 +3,7 @@
  *
  * Generates workflow plans via Claude API
  */
-import type { FaberConfig } from '../types/config.js';
+import type { LoadedFaberConfig } from '../types/config.js';
 interface GeneratePlanInput {
     workflow: string;
     issueTitle: string;
@@ -35,7 +35,7 @@ export declare class AnthropicClient {
     private git;
     private ajv;
     private planSchema;
-    constructor(config: FaberConfig);
+    constructor(config: LoadedFaberConfig);
     /**
      * Load plan JSON schema for validation
      */

package/dist/lib/anthropic-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"anthropic-client.d.ts","sourceRoot":"","sources":["../../src/lib/anthropic-client.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AASH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAKtD,UAAU,iBAAiB;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,UAAU,YAAY;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE;QACL,MAAM,EAAE,MAAM,CAAC;QACf,EAAE,EAAE,MAAM,CAAC;QACX,GAAG,EAAE,MAAM,CAAC;KACb,CAAC;IACF,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,GAAG,EAAE,CAAC;IACd,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED;;GAEG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,GAAG,CAAM;IACjB,OAAO,CAAC,GAAG,CAAM;IACjB,OAAO,CAAC,UAAU,CAAM;gBAEZ,MAAM,EAAE,WAAW;IAe/B;;OAEG;YACW,cAAc;IAiB5B;;OAEG;IACH,OAAO,CAAC,YAAY;IAepB;;OAEG;IACG,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,YAAY,CAAC;IA6DnE;;OAEG;YACW,kBAAkB;IAchC;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAqD/B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAgB/B;;OAEG;YACW,eAAe;CAqB9B"}
+{"version":3,"file":"anthropic-client.d.ts","sourceRoot":"","sources":["../../src/lib/anthropic-client.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AASH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAK5D,UAAU,iBAAiB;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,UAAU,YAAY;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE;QACL,MAAM,EAAE,MAAM,CAAC;QACf,EAAE,EAAE,MAAM,CAAC;QACX,GAAG,EAAE,MAAM,CAAC;KACb,CAAC;IACF,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,GAAG,EAAE,CAAC;IACd,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED;;GAEG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,GAAG,CAAM;IACjB,OAAO,CAAC,GAAG,CAAM;IACjB,OAAO,CAAC,UAAU,CAAM;gBAEZ,MAAM,EAAE,iBAAiB;IAerC;;OAEG;YACW,cAAc;IAiB5B;;OAEG;IACH,OAAO,CAAC,YAAY;IAepB;;OAEG;IACG,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,YAAY,CAAC;IA6DnE;;OAEG;YACW,kBAAkB;IAchC;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAqD/B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAgB/B;;OAEG;YACW,eAAe;CAqB9B"}

package/dist/lib/config.d.ts

@@ -1,9 +1,10 @@
 /**
  * Configuration Manager
  *
- * Loads FABER CLI configuration and respects Claude Code settings
+ * Loads FABER CLI configuration from unified .fractary/config.yaml
+ * and respects Claude Code settings
  */
-import type { FaberConfig } from '../types/config.js';
+import type { FaberConfig, AnthropicConfig, GitHubConfig } from '../types/config.js';
 /**
  * Configuration Manager
  */
@@ -11,9 +12,13 @@ export declare class ConfigManager {
     private config;
     private constructor();
     /**
-     * Load configuration
+     * Load configuration from unified .fractary/config.yaml
+     * Returns a FaberConfig structure with all necessary settings
      */
-    static load(): Promise<FaberConfig>;
+    static load(): Promise<FaberConfig & {
+        anthropic?: AnthropicConfig;
+        github?: GitHubConfig;
+    }>;
     /**
      * Find config file by searching upwards from current directory
      * Similar to how git finds .git directory

package/dist/lib/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/lib/config.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,KAAK,EAAE,WAAW,EAAgB,MAAM,oBAAoB,CAAC;AAEpE;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAc;IAE5B,OAAO;IAIP;;OAEG;WACU,IAAI,IAAI,OAAO,CAAC,WAAW,CAAC;IAoFzC;;;OAGG;mBACkB,cAAc;IAwBnC;;OAEG;mBACkB,8BAA8B;IAoBnD;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,oBAAoB;IAyBnC;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,WAAW,GAAG,GAAG;CAGjC"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/lib/config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,KAAK,EAAE,WAAW,EAAiB,eAAe,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGpG;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAc;IAE5B,OAAO;IAIP;;;OAGG;WACU,IAAI,IAAI,OAAO,CAAC,WAAW,GAAG;QAAE,SAAS,CAAC,EAAE,eAAe,CAAC;QAAC,MAAM,CAAC,EAAE,YAAY,CAAA;KAAE,CAAC;IAiGlG;;;OAGG;mBACkB,cAAc;IAwBnC;;OAEG;mBACkB,8BAA8B;IAoBnD;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,oBAAoB;IAyBnC;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,WAAW,GAAG,GAAG;CAGjC"}

package/dist/lib/config.js

@@ -1,11 +1,13 @@
 /**
  * Configuration Manager
  *
- * Loads FABER CLI configuration and respects Claude Code settings
+ * Loads FABER CLI configuration from unified .fractary/config.yaml
+ * and respects Claude Code settings
  */
 import fs from 'fs/promises';
 import path from 'path';
 import os from 'os';
+import { loadYamlConfig, oldSettingsExists, getOldSettingsPath } from './yaml-config.js';
 /**
  * Configuration Manager
  */
@@ -14,41 +16,48 @@ export class ConfigManager {
         this.config = config;
     }
     /**
-     * Load configuration
+     * Load configuration from unified .fractary/config.yaml
+     * Returns a FaberConfig structure with all necessary settings
      */
     static async load() {
-        const config = {};
-        // Load from environment variables
-        config.anthropic = {
-            api_key: process.env.ANTHROPIC_API_KEY,
-        };
-        config.github = {
-            token: process.env.GITHUB_TOKEN,
-        };
-        // Load from FABER config file - search upwards from current directory
-        try {
-            const faberConfigPath = await ConfigManager.findConfigFile('.fractary', 'settings.json');
-            if (faberConfigPath) {
-                const faberConfigContent = await fs.readFile(faberConfigPath, 'utf-8');
-                const faberConfig = JSON.parse(faberConfigContent);
-                // Merge with config
-                if (faberConfig.anthropic) {
-                    config.anthropic = { ...config.anthropic, ...faberConfig.anthropic };
-                }
-                if (faberConfig.github) {
-                    config.github = { ...config.github, ...faberConfig.github };
-                }
-                if (faberConfig.worktree) {
-                    config.worktree = { ...config.worktree, ...faberConfig.worktree };
-                }
-                if (faberConfig.workflow) {
-                    config.workflow = { ...config.workflow, ...faberConfig.workflow };
-                }
-            }
+        // Check if old settings.json exists and show error
+        if (oldSettingsExists()) {
+            const oldPath = getOldSettingsPath();
+            throw new Error(`Found old configuration at ${oldPath}\n\n` +
+                `This version requires .fractary/config.yaml format.\n` +
+                `Run: fractary-faber migrate\n\n` +
+                `This will convert your settings to the new unified config format.`);
         }
-        catch (error) {
-            // FABER config not found, use defaults
+        // Load unified config from YAML
+        const unifiedConfig = loadYamlConfig({ warnMissingEnvVars: true });
+        if (!unifiedConfig) {
+            throw new Error('No .fractary/config.yaml found.\n' +
+                'Run `fractary-core:init` first to initialize shared configuration.');
         }
+        // Extract anthropic config (from top level)
+        let anthropic = {
+            api_key: process.env.ANTHROPIC_API_KEY || unifiedConfig.anthropic?.api_key,
+            model: unifiedConfig.anthropic?.model,
+            max_tokens: unifiedConfig.anthropic?.max_tokens,
+        };
+        // Extract github config (from top level)
+        let github = {
+            token: process.env.GITHUB_TOKEN || unifiedConfig.github?.token,
+            organization: unifiedConfig.github?.organization,
+            project: unifiedConfig.github?.project,
+            repo: unifiedConfig.github?.repo,
+            app: unifiedConfig.github?.app,
+        };
+        // Extract FABER-specific config
+        const faberConfig = unifiedConfig.faber || {};
+        // Build the result config (keeping anthropic and github for backward compatibility)
+        const config = {
+            anthropic,
+            github,
+            worktree: faberConfig.worktree,
+            workflow: faberConfig.workflow,
+            backlog_management: faberConfig.backlog_management,
+        };
         // Read Claude Code configuration for worktree location
         if (!config.worktree?.location || config.worktree?.inherit_from_claude !== false) {
             const claudeWorktreeLocation = await ConfigManager.readClaudeCodeWorktreeLocation();

package/dist/lib/repo-client.d.ts

@@ -5,7 +5,7 @@
  * Supports both PAT and GitHub App authentication methods.
  */
 import { WorkManager, RepoManager } from '@fractary/core';
-import type { FaberConfig } from '../types/config.js';
+import type { LoadedFaberConfig } from '../types/config.js';
 interface Issue {
     id: string;
     number: number;
@@ -51,7 +51,7 @@ export declare class RepoClient {
      * @param config - FABER CLI configuration
      * @returns Promise resolving to RepoClient instance
      */
-    static create(config: FaberConfig): Promise<RepoClient>;
+    static create(config: LoadedFaberConfig): Promise<RepoClient>;
     /**
      * Create a RepoClient instance
      *
@@ -59,7 +59,7 @@ export declare class RepoClient {
      * @param workManager - Optional pre-initialized WorkManager (for async factory)
      * @param repoManager - Optional pre-initialized RepoManager (for async factory)
      */
-    constructor(config: FaberConfig, workManager?: WorkManager, repoManager?: RepoManager);
+    constructor(config: LoadedFaberConfig, workManager?: WorkManager, repoManager?: RepoManager);
     /**
      * Fetch specific issues by ID
      *

package/dist/lib/repo-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"repo-client.d.ts","sourceRoot":"","sources":["../../src/lib/repo-client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAS1D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGtD,UAAU,KAAK;IACb,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;CACf;AAED,UAAU,cAAc;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,UAAU,kBAAkB;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;GAKG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,WAAW,CAAe;IAClC,OAAO,CAAC,WAAW,CAAe;IAClC,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,OAAO,CAAS;IAExB;;;;;;;;OAQG;WACU,MAAM,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;IAmB7D;;;;;;OAMG;gBACS,MAAM,EAAE,WAAW,EAAE,WAAW,CAAC,EAAE,WAAW,EAAE,WAAW,CAAC,EAAE,WAAW;IA0CrF;;;;OAIG;IACG,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAclD;;;;OAIG;IACG,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAetD;;;;OAIG;IACG,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAWrD;;;;OAIG;IACG,cAAc,CAAC,OAAO,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,cAAc,CAAC;IA+BzF;;;;OAIG;IACG,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;CA0B9D"}
+{"version":3,"file":"repo-client.d.ts","sourceRoot":"","sources":["../../src/lib/repo-client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAS1D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAG5D,UAAU,KAAK;IACb,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;CACf;AAED,UAAU,cAAc;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,UAAU,kBAAkB;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;GAKG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,WAAW,CAAe;IAClC,OAAO,CAAC,WAAW,CAAe;IAClC,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,OAAO,CAAS;IAExB;;;;;;;;OAQG;WACU,MAAM,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,UAAU,CAAC;IAmBnE;;;;;;OAMG;gBACS,MAAM,EAAE,iBAAiB,EAAE,WAAW,CAAC,EAAE,WAAW,EAAE,WAAW,CAAC,EAAE,WAAW;IA0C3F;;;;OAIG;IACG,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAclD;;;;OAIG;IACG,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAetD;;;;OAIG;IACG,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAWrD;;;;OAIG;IACG,cAAc,CAAC,OAAO,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,cAAc,CAAC;IA+BzF;;;;OAIG;IACG,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;CA0B9D"}

package/dist/lib/sdk-config-adapter.d.ts

@@ -4,7 +4,7 @@
  * Converts FABER CLI configuration to @fractary/core SDK configuration format
  * Supports both PAT and GitHub App authentication methods.
  */
-import type { FaberConfig } from '../types/config.js';
+import type { LoadedFaberConfig } from '../types/config.js';
 import type { WorkConfig, RepoConfig } from '@fractary/core';
 import { TokenProvider } from './github-app-auth.js';
 /**
@@ -14,7 +14,7 @@ import { TokenProvider } from './github-app-auth.js';
  * @param faberConfig - FABER CLI configuration
  * @returns Promise resolving to the current token
  */
-export declare function getToken(faberConfig: FaberConfig): Promise<string>;
+export declare function getToken(faberConfig: LoadedFaberConfig): Promise<string>;
 /**
  * Get the token provider for dynamic token refresh
  * Useful for long-running operations that need fresh tokens
@@ -22,21 +22,21 @@ export declare function getToken(faberConfig: FaberConfig): Promise<string>;
  * @param faberConfig - FABER CLI configuration
  * @returns TokenProvider instance
  */
-export declare function getTokenProviderInstance(faberConfig: FaberConfig): TokenProvider;
+export declare function getTokenProviderInstance(faberConfig: LoadedFaberConfig): TokenProvider;
 /**
  * Validate GitHub authentication configuration
  *
  * @param faberConfig - FABER CLI configuration
  * @throws Error if configuration is invalid
  */
-export declare function validateGitHubAuth(faberConfig: FaberConfig): Promise<void>;
+export declare function validateGitHubAuth(faberConfig: LoadedFaberConfig): Promise<void>;
 /**
  * Check if GitHub App authentication is configured
  *
  * @param faberConfig - FABER CLI configuration
  * @returns true if GitHub App is configured
  */
-export declare function isGitHubAppConfigured(faberConfig: FaberConfig): boolean;
+export declare function isGitHubAppConfigured(faberConfig: LoadedFaberConfig): boolean;
 /**
  * Create WorkConfig for WorkManager from FaberConfig
  *
@@ -44,7 +44,7 @@ export declare function isGitHubAppConfigured(faberConfig: FaberConfig): boolean
  * @returns WorkConfig for @fractary/core WorkManager
  * @throws Error if required fields are missing
  */
-export declare function createWorkConfig(faberConfig: FaberConfig): WorkConfig;
+export declare function createWorkConfig(faberConfig: LoadedFaberConfig): WorkConfig;
 /**
  * Create WorkConfig for WorkManager from FaberConfig (async version)
  *
@@ -54,7 +54,7 @@ export declare function createWorkConfig(faberConfig: FaberConfig): WorkConfig;
  * @returns Promise resolving to WorkConfig for @fractary/core WorkManager
  * @throws Error if required fields are missing
  */
-export declare function createWorkConfigAsync(faberConfig: FaberConfig): Promise<WorkConfig>;
+export declare function createWorkConfigAsync(faberConfig: LoadedFaberConfig): Promise<WorkConfig>;
 /**
  * Create RepoConfig for RepoManager from FaberConfig
  *
@@ -62,7 +62,7 @@ export declare function createWorkConfigAsync(faberConfig: FaberConfig): Promise
  * @returns RepoConfig for @fractary/core RepoManager
  * @throws Error if required fields are missing
  */
-export declare function createRepoConfig(faberConfig: FaberConfig): RepoConfig;
+export declare function createRepoConfig(faberConfig: LoadedFaberConfig): RepoConfig;
 /**
  * Create RepoConfig for RepoManager from FaberConfig (async version)
  *
@@ -72,5 +72,5 @@ export declare function createRepoConfig(faberConfig: FaberConfig): RepoConfig;
  * @returns Promise resolving to RepoConfig for @fractary/core RepoManager
  * @throws Error if required fields are missing
  */
-export declare function createRepoConfigAsync(faberConfig: FaberConfig): Promise<RepoConfig>;
+export declare function createRepoConfigAsync(faberConfig: LoadedFaberConfig): Promise<RepoConfig>;
 //# sourceMappingURL=sdk-config-adapter.d.ts.map

package/dist/lib/sdk-config-adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sdk-config-adapter.d.ts","sourceRoot":"","sources":["../../src/lib/sdk-config-adapter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAmB,MAAM,oBAAoB,CAAC;AACvE,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC7D,OAAO,EAEL,aAAa,EAGd,MAAM,sBAAsB,CAAC;AA2D9B;;;;;;GAMG;AACH,wBAAsB,QAAQ,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAGxE;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,WAAW,EAAE,WAAW,GAAG,aAAa,CAEhF;AAED;;;;;GAKG;AACH,wBAAsB,kBAAkB,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAgBhF;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAGvE;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,WAAW,GAAG,UAAU,CAmCrE;AAED;;;;;;;;GAQG;AACH,wBAAsB,qBAAqB,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAkBzF;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,WAAW,GAAG,UAAU,CAyBrE;AAED;;;;;;;;GAQG;AACH,wBAAsB,qBAAqB,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAYzF"}
+{"version":3,"file":"sdk-config-adapter.d.ts","sourceRoot":"","sources":["../../src/lib/sdk-config-adapter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAmB,MAAM,oBAAoB,CAAC;AAC7E,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC7D,OAAO,EAEL,aAAa,EAGd,MAAM,sBAAsB,CAAC;AA2D9B;;;;;;GAMG;AACH,wBAAsB,QAAQ,CAAC,WAAW,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC,CAG9E;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,WAAW,EAAE,iBAAiB,GAAG,aAAa,CAEtF;AAED;;;;;GAKG;AACH,wBAAsB,kBAAkB,CAAC,WAAW,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAgBtF;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,iBAAiB,GAAG,OAAO,CAG7E;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,iBAAiB,GAAG,UAAU,CAmC3E;AAED;;;;;;;;GAQG;AACH,wBAAsB,qBAAqB,CAAC,WAAW,EAAE,iBAAiB,GAAG,OAAO,CAAC,UAAU,CAAC,CAkB/F;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,iBAAiB,GAAG,UAAU,CAyB3E;AAED;;;;;;;;GAQG;AACH,wBAAsB,qBAAqB,CAAC,WAAW,EAAE,iBAAiB,GAAG,OAAO,CAAC,UAAU,CAAC,CAY/F"}

package/dist/lib/yaml-config.d.ts

@@ -0,0 +1,108 @@
+/**
+ * Unified YAML Configuration Loader for FABER CLI
+ *
+ * Loads and parses `.fractary/config.yaml` with environment variable substitution.
+ * Provides access to shared configuration for FABER and fractary-core plugins.
+ */
+export type { AnthropicConfig, GitHubAppConfig, GitHubConfig, WorktreeConfig, WorkflowConfig, BacklogManagementConfig, FaberConfig, UnifiedConfig, ConfigLoadOptions, } from '../types/config.js';
+import type { UnifiedConfig, ConfigLoadOptions } from '../types/config.js';
+/**
+ * Load and parse `.fractary/config.yaml` with environment variable substitution
+ *
+ * @param options Configuration loading options
+ * @returns Parsed configuration object or null if not found
+ * @throws Error if config is invalid or throwIfMissing is true and file doesn't exist
+ *
+ * @example
+ * ```typescript
+ * const config = loadYamlConfig();
+ * if (config?.github) {
+ *   console.log('GitHub config:', config.github);
+ * }
+ * ```
+ */
+export declare function loadYamlConfig(options?: ConfigLoadOptions): UnifiedConfig | null;
+/**
+ * Write unified configuration to `.fractary/config.yaml`
+ *
+ * @param config Configuration object to write
+ * @param projectRoot Project root directory (auto-detected if not provided)
+ *
+ * @example
+ * ```typescript
+ * writeYamlConfig({
+ *   version: '2.0',
+ *   github: {
+ *     organization: 'myorg',
+ *     project: 'myrepo'
+ *   }
+ * });
+ * ```
+ */
+export declare function writeYamlConfig(config: UnifiedConfig, projectRoot?: string): void;
+/**
+ * Substitute ${ENV_VAR} placeholders with actual environment variables
+ *
+ * Supports:
+ * - ${VAR_NAME} - Replace with env var value
+ * - ${VAR_NAME:-default} - Replace with env var value or default if not set
+ *
+ * Security: Default values are limited to 1000 characters to prevent abuse.
+ * Variable names must match pattern: [A-Z_][A-Z0-9_]*
+ *
+ * @param content Content with environment variable placeholders
+ * @param warnMissing Whether to warn about missing environment variables
+ * @returns Content with substituted values
+ *
+ * @example
+ * ```typescript
+ * const content = 'token: ${GITHUB_TOKEN}';
+ * const result = substituteEnvVars(content);
+ * // result: 'token: ghp_xxxxx'
+ * ```
+ */
+export declare function substituteEnvVars(content: string, warnMissing?: boolean): string;
+/**
+ * Find project root by looking for .fractary directory or .git
+ *
+ * Walks up the directory tree from startDir until it finds:
+ * - A directory containing `.fractary/`
+ * - A directory containing `.git/`
+ * - The filesystem root
+ *
+ * Security: Normalizes paths and prevents traversal outside filesystem boundaries.
+ * Maximum of 100 directory levels to prevent infinite loops.
+ *
+ * @param startDir Directory to start searching from (default: current working directory)
+ * @returns Project root directory (normalized absolute path)
+ */
+export declare function findProjectRoot(startDir?: string): string;
+/**
+ * Check if a valid configuration file exists
+ *
+ * @param projectRoot Project root directory (auto-detected if not provided)
+ * @returns true if config exists at .fractary/config.yaml
+ */
+export declare function configExists(projectRoot?: string): boolean;
+/**
+ * Get the configuration file path
+ *
+ * @param projectRoot Project root directory (auto-detected if not provided)
+ * @returns Full path to configuration file
+ */
+export declare function getConfigPath(projectRoot?: string): string;
+/**
+ * Check if old settings.json exists (for migration)
+ *
+ * @param projectRoot Project root directory (auto-detected if not provided)
+ * @returns true if old settings.json exists
+ */
+export declare function oldSettingsExists(projectRoot?: string): boolean;
+/**
+ * Get the old settings.json file path
+ *
+ * @param projectRoot Project root directory (auto-detected if not provided)
+ * @returns Full path to old settings.json file
+ */
+export declare function getOldSettingsPath(projectRoot?: string): string;
+//# sourceMappingURL=yaml-config.d.ts.map

package/dist/lib/yaml-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"yaml-config.d.ts","sourceRoot":"","sources":["../../src/lib/yaml-config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,YAAY,EACV,eAAe,EACf,eAAe,EACf,YAAY,EACZ,cAAc,EACd,cAAc,EACd,uBAAuB,EACvB,WAAW,EACX,aAAa,EACb,iBAAiB,GAClB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AA8F3E;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,cAAc,CAAC,OAAO,GAAE,iBAAsB,GAAG,aAAa,GAAG,IAAI,CAoDpF;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,aAAa,EACrB,WAAW,CAAC,EAAE,MAAM,GACnB,IAAI,CAkBN;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,UAAO,GAAG,MAAM,CAgD7E;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,eAAe,CAAC,QAAQ,GAAE,MAAsB,GAAG,MAAM,CAoDxE;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAI1D;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAG1D;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAI/D;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAG/D"}