@fractary/faber-cli 1.5.48 → 1.5.50

package/dist/commands/init.js

@@ -1,161 +0,0 @@
-/**
- * Init command - Initialize FABER section in unified config.yaml
- *
- * This command ONLY manages the faber: section of .fractary/config.yaml
- * It assumes shared configuration (github, anthropic) is already set up via fractary-core:init
- */
-import { Command } from 'commander';
-import chalk from 'chalk';
-import * as readline from 'readline/promises';
-import os from 'os';
-import path from 'path';
-import { loadYamlConfig, writeYamlConfig, configExists, oldSettingsExists, getConfigPath, getOldSettingsPath } from '../lib/yaml-config.js';
-export function createInitCommand() {
-    return new Command('configure')
-        .description('Initialize FABER section in unified config.yaml')
-        .option('--force', 'Overwrite existing FABER configuration')
-        .option('--json', 'Output as JSON')
-        .action(async (options) => {
-        try {
-            if (!options.json) {
-                console.log(chalk.cyan('Initializing FABER configuration...'));
-                console.log();
-            }
-            // Step 1: Check for old settings.json and suggest migration
-            if (oldSettingsExists()) {
-                const oldPath = getOldSettingsPath();
-                if (options.json) {
-                    console.log(JSON.stringify({
-                        status: 'error',
-                        error: {
-                            message: 'Old settings.json found',
-                            oldPath,
-                            migration: 'Run: fractary-faber migrate'
-                        }
-                    }));
-                }
-                else {
-                    console.log(chalk.yellow('⚠️  Detected old .fractary/settings.json'));
-                    console.log(`Found: ${chalk.gray(oldPath)}`);
-                    console.log();
-                    console.log('Run this command to migrate to the new format:');
-                    console.log(chalk.cyan('  fractary-faber migrate'));
-                    console.log();
-                }
-                process.exit(1);
-            }
-            // Step 2: Check if config.yaml exists
-            if (!configExists()) {
-                if (options.json) {
-                    console.log(JSON.stringify({
-                        status: 'error',
-                        error: {
-                            message: 'No .fractary/config.yaml found',
-                            recommendation: 'Run fractary-core:init first'
-                        }
-                    }));
-                }
-                else {
-                    console.error(chalk.red('Error: No .fractary/config.yaml found'));
-                    console.log();
-                    console.log('FABER requires shared configuration to be set up first.');
-                    console.log();
-                    console.log('Please run one of the following:');
-                    console.log(chalk.cyan('  1. fractary-core:init') + '     - Initialize unified config with GitHub/Anthropic settings');
-                    console.log(chalk.cyan('  2. fractary-faber migrate') + ' - Migrate from old .fractary/settings.json');
-                    console.log();
-                }
-                process.exit(1);
-            }
-            // Step 3: Load existing config
-            const config = loadYamlConfig();
-            if (!config) {
-                throw new Error('Failed to load .fractary/config.yaml');
-            }
-            // Step 4: Check if FABER section already exists
-            if (config.faber && !options.force) {
-                if (options.json) {
-                    console.log(JSON.stringify({
-                        status: 'exists',
-                        path: getConfigPath(),
-                        message: 'FABER section already configured'
-                    }));
-                }
-                else {
-                    console.log(chalk.yellow('FABER section already exists in config.yaml'));
-                    console.log();
-                    console.log('Use --force to overwrite existing configuration.');
-                    console.log();
-                }
-                return;
-            }
-            // Step 5: Validate shared sections and warn if missing
-            const warnings = [];
-            if (!config.github) {
-                warnings.push('Missing \'github\' section - FABER needs GitHub authentication');
-            }
-            if (!config.anthropic) {
-                warnings.push('Missing \'anthropic\' section - FABER needs Anthropic API key');
-            }
-            if (warnings.length > 0 && !options.json) {
-                console.log(chalk.yellow('⚠️  Configuration warnings:'));
-                warnings.forEach(w => console.log(chalk.yellow(`  - ${w}`)));
-                console.log();
-                console.log(chalk.bold('Recommendation:') + ' Run ' + chalk.cyan('fractary-core:init') + ' to set up shared configuration');
-                console.log();
-                // Ask if user wants to continue
-                const rl = readline.createInterface({
-                    input: process.stdin,
-                    output: process.stdout,
-                });
-                const answer = await rl.question('Continue with FABER initialization? (y/N) ');
-                rl.close();
-                console.log();
-                if (answer.toLowerCase() !== 'y') {
-                    console.log('Initialization cancelled.');
-                    return;
-                }
-            }
-            // Step 6: Initialize FABER section
-            config.faber = {
-                worktree: {
-                    location: path.join(os.homedir(), '.claude-worktrees'),
-                    inherit_from_claude: true
-                },
-                workflow: {
-                    config_path: path.join('.fractary', 'faber', 'workflows')
-                }
-            };
-            // Step 7: Write config back
-            writeYamlConfig(config);
-            if (options.json) {
-                console.log(JSON.stringify({
-                    status: 'success',
-                    path: getConfigPath()
-                }));
-            }
-            else {
-                console.log(chalk.green('✓ FABER configuration initialized in .fractary/config.yaml'));
-                console.log();
-                console.log('Next steps:');
-                console.log('  1. Set up GitHub App authentication: ' + chalk.cyan('fractary-faber auth setup'));
-                console.log('  2. Create workflow configuration files in .fractary/faber/workflows/');
-                console.log('  3. Run your first workflow: ' + chalk.cyan('fractary-faber workflow plan <issue-number>'));
-                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/commands/spec/index.d.ts

@@ -1,11 +0,0 @@
-/**
- * Spec subcommand - Specification management
- *
- * Provides spec operations via @fractary/faber SpecManager.
- */
-import { Command } from 'commander';
-/**
- * Create the spec command tree
- */
-export declare function createSpecCommand(): Command;
-//# sourceMappingURL=index.d.ts.map

package/dist/commands/spec/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/fractary-faber-spec/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAc3C"}

package/dist/commands/spec/index.js

@@ -1,280 +0,0 @@
-/**
- * Spec subcommand - Specification management
- *
- * Provides spec operations via @fractary/faber SpecManager.
- */
-import { Command } from 'commander';
-import chalk from 'chalk';
-import { SpecManager } from '@fractary/faber';
-/**
- * Create the spec command tree
- */
-export function createSpecCommand() {
-    const spec = new Command('spec')
-        .description('Specification management');
-    spec.addCommand(createSpecCreateCommand());
-    spec.addCommand(createSpecGetCommand());
-    spec.addCommand(createSpecListCommand());
-    spec.addCommand(createSpecUpdateCommand());
-    spec.addCommand(createSpecValidateCommand());
-    spec.addCommand(createSpecRefineCommand());
-    spec.addCommand(createSpecDeleteCommand());
-    spec.addCommand(createSpecTemplatesCommand());
-    return spec;
-}
-function createSpecCreateCommand() {
-    return new Command('create')
-        .description('Create a new specification')
-        .argument('<title>', 'Specification title')
-        .option('--template <type>', 'Specification template (feature, bugfix, refactor)', 'feature')
-        .option('--work-id <id>', 'Associated work item ID')
-        .option('--json', 'Output as JSON')
-        .action(async (title, options) => {
-        try {
-            const specManager = new SpecManager();
-            const spec = specManager.createSpec(title, {
-                template: options.template,
-                workId: options.workId,
-            });
-            if (options.json) {
-                console.log(JSON.stringify({ status: 'success', data: spec }, null, 2));
-            }
-            else {
-                console.log(chalk.green(`✓ Created specification: ${spec.title}`));
-                console.log(chalk.gray(`  ID: ${spec.id}`));
-                console.log(chalk.gray(`  Path: ${spec.path}`));
-            }
-        }
-        catch (error) {
-            handleSpecError(error, options);
-        }
-    });
-}
-function createSpecGetCommand() {
-    return new Command('get')
-        .description('Get a specification by ID or path')
-        .argument('<id>', 'Specification ID or path')
-        .option('--json', 'Output as JSON')
-        .action(async (id, options) => {
-        try {
-            const specManager = new SpecManager();
-            const spec = specManager.getSpec(id);
-            if (!spec) {
-                if (options.json) {
-                    console.error(JSON.stringify({
-                        status: 'error',
-                        error: { code: 'SPEC_NOT_FOUND', message: `Specification not found: ${id}` },
-                    }));
-                }
-                else {
-                    console.error(chalk.red(`Specification not found: ${id}`));
-                }
-                process.exit(5);
-            }
-            if (options.json) {
-                console.log(JSON.stringify({ status: 'success', data: spec }, null, 2));
-            }
-            else {
-                console.log(chalk.bold(`${spec.title}`));
-                console.log(chalk.gray(`ID: ${spec.id}`));
-                console.log(chalk.gray(`Status: ${spec.metadata.validation_status || 'not_validated'}`));
-                console.log(chalk.gray(`Work ID: ${spec.workId || 'N/A'}`));
-                console.log('\n' + spec.content);
-            }
-        }
-        catch (error) {
-            handleSpecError(error, options);
-        }
-    });
-}
-function createSpecListCommand() {
-    return new Command('list')
-        .description('List specifications')
-        .option('--status <status>', 'Filter by status (draft, validated, needs_revision)')
-        .option('--work-id <id>', 'Filter by work item ID')
-        .option('--json', 'Output as JSON')
-        .action(async (options) => {
-        try {
-            const specManager = new SpecManager();
-            const specs = specManager.listSpecs({
-                status: options.status,
-                workId: options.workId,
-            });
-            if (options.json) {
-                console.log(JSON.stringify({ status: 'success', data: specs }, null, 2));
-            }
-            else {
-                if (specs.length === 0) {
-                    console.log(chalk.yellow('No specifications found'));
-                }
-                else {
-                    specs.forEach((spec) => {
-                        const status = spec.metadata.validation_status || 'not_validated';
-                        const statusColor = status === 'complete' ? chalk.green :
-                            status === 'failed' ? chalk.red :
-                                status === 'partial' ? chalk.yellow : chalk.gray;
-                        console.log(`${spec.id} ${spec.title} [${statusColor(status)}]`);
-                    });
-                }
-            }
-        }
-        catch (error) {
-            handleSpecError(error, options);
-        }
-    });
-}
-function createSpecUpdateCommand() {
-    return new Command('update')
-        .description('Update a specification')
-        .argument('<id>', 'Specification ID or path')
-        .option('--title <title>', 'New title')
-        .option('--content <content>', 'New content')
-        .option('--work-id <id>', 'Associated work item ID')
-        .option('--status <status>', 'Validation status')
-        .option('--json', 'Output as JSON')
-        .action(async (id, options) => {
-        try {
-            const specManager = new SpecManager();
-            const spec = specManager.updateSpec(id, {
-                title: options.title,
-                content: options.content,
-                workId: options.workId,
-                validationStatus: options.status,
-            });
-            if (options.json) {
-                console.log(JSON.stringify({ status: 'success', data: spec }, null, 2));
-            }
-            else {
-                console.log(chalk.green(`✓ Updated specification: ${spec.title}`));
-            }
-        }
-        catch (error) {
-            handleSpecError(error, options);
-        }
-    });
-}
-function createSpecValidateCommand() {
-    return new Command('validate')
-        .description('Validate a specification')
-        .argument('<id>', 'Specification ID or path')
-        .option('--json', 'Output as JSON')
-        .action(async (id, options) => {
-        try {
-            const specManager = new SpecManager();
-            const result = specManager.validateSpec(id);
-            if (options.json) {
-                console.log(JSON.stringify({ status: 'success', data: result }, null, 2));
-            }
-            else {
-                const statusColor = result.status === 'pass' ? chalk.green :
-                    result.status === 'fail' ? chalk.red : chalk.yellow;
-                console.log(`Validation: ${statusColor(result.status.toUpperCase())}`);
-                console.log(chalk.gray(`  Score: ${result.score}%`));
-                // Show check results
-                console.log(chalk.yellow('\nChecks:'));
-                const { requirements, acceptanceCriteria } = result.checks;
-                console.log(`  Requirements: ${requirements.completed}/${requirements.total} [${requirements.status}]`);
-                console.log(`  Acceptance Criteria: ${acceptanceCriteria.met}/${acceptanceCriteria.total} [${acceptanceCriteria.status}]`);
-            }
-        }
-        catch (error) {
-            handleSpecError(error, options);
-        }
-    });
-}
-function createSpecRefineCommand() {
-    return new Command('refine')
-        .description('Generate refinement questions for a specification')
-        .argument('<id>', 'Specification ID or path')
-        .option('--json', 'Output as JSON')
-        .action(async (id, options) => {
-        try {
-            const specManager = new SpecManager();
-            const questions = specManager.generateRefinementQuestions(id);
-            if (options.json) {
-                console.log(JSON.stringify({ status: 'success', data: questions }, null, 2));
-            }
-            else {
-                if (questions.length === 0) {
-                    console.log(chalk.green('✓ Specification appears complete, no refinement questions'));
-                }
-                else {
-                    console.log(chalk.yellow('Refinement Questions:'));
-                    questions.forEach((q, i) => {
-                        const priorityColor = q.priority === 'high' ? chalk.red :
-                            q.priority === 'medium' ? chalk.yellow : chalk.gray;
-                        console.log(`\n${i + 1}. [${priorityColor(q.priority)}] ${q.category}`);
-                        console.log(`   ${q.question}`);
-                    });
-                }
-            }
-        }
-        catch (error) {
-            handleSpecError(error, options);
-        }
-    });
-}
-function createSpecDeleteCommand() {
-    return new Command('delete')
-        .description('Delete a specification')
-        .argument('<id>', 'Specification ID or path')
-        .option('--json', 'Output as JSON')
-        .action(async (id, options) => {
-        try {
-            const specManager = new SpecManager();
-            const deleted = specManager.deleteSpec(id);
-            if (options.json) {
-                console.log(JSON.stringify({ status: 'success', data: { deleted } }, null, 2));
-            }
-            else {
-                if (deleted) {
-                    console.log(chalk.green(`✓ Deleted specification: ${id}`));
-                }
-                else {
-                    console.log(chalk.yellow(`Specification not found: ${id}`));
-                }
-            }
-        }
-        catch (error) {
-            handleSpecError(error, options);
-        }
-    });
-}
-function createSpecTemplatesCommand() {
-    return new Command('templates')
-        .description('List available specification templates')
-        .option('--json', 'Output as JSON')
-        .action(async (options) => {
-        try {
-            const specManager = new SpecManager();
-            const templates = specManager.getTemplates();
-            if (options.json) {
-                console.log(JSON.stringify({ status: 'success', data: templates }, null, 2));
-            }
-            else {
-                console.log(chalk.bold('Available Templates:'));
-                templates.forEach((t) => {
-                    console.log(`  ${chalk.cyan(t.id)} - ${t.name}`);
-                    console.log(chalk.gray(`    ${t.description}`));
-                });
-            }
-        }
-        catch (error) {
-            handleSpecError(error, options);
-        }
-    });
-}
-// Error handling
-function handleSpecError(error, options) {
-    const message = error instanceof Error ? error.message : String(error);
-    if (options.json) {
-        console.error(JSON.stringify({
-            status: 'error',
-            error: { code: 'SPEC_ERROR', message },
-        }));
-    }
-    else {
-        console.error(chalk.red('Error:'), message);
-    }
-    process.exit(1);
-}

package/dist/lib/github-app-auth.d.ts

@@ -1,122 +0,0 @@
-/**
- * GitHub App Authentication Module
- *
- * Provides JWT generation, installation token exchange, and token caching
- * for GitHub App authentication in FABER CLI.
- */
-import type { GitHubAppConfig } from '../types/config.js';
-/**
- * Private Key Loader
- *
- * Loads private keys from file path or environment variable
- */
-export declare class PrivateKeyLoader {
-    /**
-     * Load private key from configured sources.
-     * Priority: env var > file path
-     *
-     * @param config - GitHub App configuration
-     * @returns The private key content
-     * @throws Error if private key cannot be loaded
-     */
-    static load(config: GitHubAppConfig): Promise<string>;
-    /**
-     * Validate private key format.
-     *
-     * @param key - The private key content
-     * @returns true if valid PEM format
-     */
-    static validate(key: string): boolean;
-}
-/**
- * GitHub App Authentication
- *
- * Handles JWT generation, installation token exchange, and caching
- */
-export declare class GitHubAppAuth {
-    private cache;
-    private config;
-    private refreshPromise;
-    private static readonly REFRESH_THRESHOLD_MS;
-    private static readonly JWT_EXPIRY_SECONDS;
-    private static readonly GITHUB_API_URL;
-    constructor(config: GitHubAppConfig);
-    /**
-     * Get a valid installation token.
-     * Returns cached token if still valid, otherwise generates new one.
-     *
-     * @returns Installation access token
-     */
-    getToken(): Promise<string>;
-    /**
-     * Force refresh the token.
-     *
-     * @returns New installation access token
-     */
-    refreshToken(): Promise<string>;
-    /**
-     * Check if token needs refresh (within 5 minutes of expiration).
-     *
-     * @returns true if token should be refreshed
-     */
-    isTokenExpiringSoon(): boolean;
-    /**
-     * Validate the configuration and private key.
-     *
-     * @throws Error if configuration is invalid
-     */
-    validate(): Promise<void>;
-    /**
-     * Perform the actual token refresh
-     */
-    private doRefresh;
-    /**
-     * Generate a JWT for GitHub App authentication
-     */
-    private generateJWT;
-    /**
-     * Exchange JWT for installation access token
-     */
-    private exchangeForInstallationToken;
-    /**
-     * Check if token is expired
-     */
-    private isExpired;
-    /**
-     * Check if token is expiring soon
-     */
-    private isExpiringSoon;
-    /**
-     * Trigger background token refresh (non-blocking)
-     */
-    private triggerBackgroundRefresh;
-}
-/**
- * Token Provider Interface
- *
- * Abstract interface for getting tokens, supporting both PAT and GitHub App
- */
-export interface TokenProvider {
-    getToken(): Promise<string>;
-}
-/**
- * Static Token Provider
- *
- * Simple provider for static PAT tokens
- */
-export declare class StaticTokenProvider implements TokenProvider {
-    private token;
-    constructor(token: string);
-    getToken(): Promise<string>;
-}
-/**
- * GitHub App Token Provider
- *
- * Provider that uses GitHubAppAuth for dynamic token generation
- */
-export declare class GitHubAppTokenProvider implements TokenProvider {
-    private auth;
-    constructor(auth: GitHubAppAuth);
-    getToken(): Promise<string>;
-}
-//# sourceMappingURL=github-app-auth.d.ts.map

package/dist/lib/github-app-auth.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"github-app-auth.d.ts","sourceRoot":"","sources":["../../src/lib/github-app-auth.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAqB1D;;;;GAIG;AACH,qBAAa,gBAAgB;IAC3B;;;;;;;OAOG;WACU,IAAI,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC;IAiD3D;;;;;OAKG;IACH,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;CAUtC;AAED;;;;GAIG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,KAAK,CAAuC;IACpD,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,cAAc,CAAgC;IAGtD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,oBAAoB,CAAiB;IAE7D,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,kBAAkB,CAAO;IAEjD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,cAAc,CAA4B;gBAEtD,MAAM,EAAE,eAAe;IAInC;;;;;OAKG;IACG,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC;IAkBjC;;;;OAIG;IACG,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC;IAerC;;;;OAIG;IACH,mBAAmB,IAAI,OAAO;IAK9B;;;;OAIG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAkB/B;;OAEG;YACW,SAAS;IAmBvB;;OAEG;YACW,WAAW;IAoBzB;;OAEG;YACW,4BAA4B;IAyD1C;;OAEG;IACH,OAAO,CAAC,SAAS;IAIjB;;OAEG;IACH,OAAO,CAAC,cAAc;IAItB;;OAEG;IACH,OAAO,CAAC,wBAAwB;CAUjC;AAED;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;CAC7B;AAED;;;;GAIG;AACH,qBAAa,mBAAoB,YAAW,aAAa;IAC3C,OAAO,CAAC,KAAK;gBAAL,KAAK,EAAE,MAAM;IAE3B,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC;CAGlC;AAED;;;;GAIG;AACH,qBAAa,sBAAuB,YAAW,aAAa;IAC9C,OAAO,CAAC,IAAI;gBAAJ,IAAI,EAAE,aAAa;IAEjC,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC;CAGlC"}