@fractary/faber-cli 1.5.48 → 1.5.49

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"}