@fractary/faber-cli 1.1.0 → 1.3.0

package/dist/lib/anthropic-client.js

@@ -0,0 +1,225 @@
+/**
+ * Anthropic API Client
+ *
+ * Generates workflow plans via Claude API
+ */
+import Anthropic from '@anthropic-ai/sdk';
+import Ajv from 'ajv';
+import fs from 'fs/promises';
+import path from 'path';
+import { fileURLToPath } from 'url';
+import { Git } from '@fractary/faber';
+import { validateJsonSize } from '../utils/validation.js';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+/**
+ * Anthropic API Client
+ */
+export class AnthropicClient {
+    constructor(config) {
+        this.config = config;
+        this.git = new Git();
+        this.ajv = new Ajv({ strict: false }); // Allow additional properties
+        const apiKey = config.anthropic?.api_key;
+        if (!apiKey) {
+            throw new Error('Anthropic API key not found. Set ANTHROPIC_API_KEY environment variable.');
+        }
+        this.client = new Anthropic({
+            apiKey,
+        });
+    }
+    /**
+     * Load plan JSON schema for validation
+     */
+    async loadPlanSchema() {
+        if (this.planSchema) {
+            return; // Already loaded
+        }
+        try {
+            // Schema path relative to this file
+            const schemaPath = path.resolve(__dirname, '../../../plugins/faber/config/schemas/plan.schema.json');
+            const schemaContent = await fs.readFile(schemaPath, 'utf8');
+            this.planSchema = JSON.parse(schemaContent);
+        }
+        catch (error) {
+            // Schema not found or invalid - log warning but don't fail
+            console.warn('Warning: Could not load plan schema for validation:', error instanceof Error ? error.message : 'Unknown error');
+            this.planSchema = null;
+        }
+    }
+    /**
+     * Validate plan JSON against schema
+     */
+    validatePlan(plan) {
+        if (!this.planSchema) {
+            // Schema not loaded - skip validation
+            return;
+        }
+        const validate = this.ajv.compile(this.planSchema);
+        const valid = validate(plan);
+        if (!valid) {
+            const errors = validate.errors?.map(e => `${e.instancePath} ${e.message}`).join(', ') || 'Unknown validation errors';
+            throw new Error(`Plan JSON validation failed: ${errors}`);
+        }
+    }
+    /**
+     * Generate workflow plan via Claude API
+     */
+    async generatePlan(input) {
+        // Load plan schema for validation
+        await this.loadPlanSchema();
+        // Load workflow configuration
+        const workflowConfig = await this.loadWorkflowConfig(input.workflow);
+        // Generate plan ID
+        const timestamp = new Date().toISOString().replace(/[-:]/g, '').replace(/\.\d+Z/, '').replace('T', '-');
+        const planId = `fractary-faber-${input.issueNumber}-${timestamp}`;
+        // Construct prompt for Claude
+        const prompt = this.constructPlanningPrompt(input, workflowConfig);
+        // Call Claude API
+        const response = await this.client.messages.create({
+            model: 'claude-sonnet-4-5-20250929',
+            max_tokens: 8192,
+            messages: [
+                {
+                    role: 'user',
+                    content: prompt,
+                },
+            ],
+        });
+        // Extract plan JSON from response
+        const content = response.content[0];
+        if (content.type !== 'text') {
+            throw new Error('Unexpected response type from Claude API');
+        }
+        // Validate response size (prevent DoS)
+        validateJsonSize(content.text, 1024 * 1024); // 1MB limit
+        const planJson = this.extractJsonFromResponse(content.text);
+        // Add metadata
+        const { organization, project } = await this.extractRepoInfo();
+        const plan = {
+            ...planJson,
+            plan_id: planId,
+            created_by: 'cli',
+            cli_version: '1.0.0',
+            created_at: new Date().toISOString(),
+            issue: {
+                source: 'github',
+                id: input.issueNumber.toString(),
+                url: `https://github.com/${organization}/${project}/issues/${input.issueNumber}`,
+            },
+            branch: `feature/${input.issueNumber}`,
+            worktree: `~/.claude-worktrees/${organization}-${project}-${input.issueNumber}`,
+            workflow: input.workflow,
+        };
+        // Validate plan against schema
+        this.validatePlan(plan);
+        return plan;
+    }
+    /**
+     * Load workflow configuration
+     */
+    async loadWorkflowConfig(workflow) {
+        const workflowPath = path.join(this.config.workflow?.config_path || './plugins/faber/config/workflows', `${workflow}.json`);
+        try {
+            const content = await fs.readFile(workflowPath, 'utf-8');
+            return JSON.parse(content);
+        }
+        catch (error) {
+            throw new Error(`Failed to load workflow config: ${workflow} (${workflowPath})`);
+        }
+    }
+    /**
+     * Construct planning prompt for Claude
+     */
+    constructPlanningPrompt(input, workflowConfig) {
+        return `You are a workflow planning assistant for the FABER system. Your task is to generate a structured workflow plan based on the provided issue and workflow configuration.
+
+**Issue Information:**
+- Number: #${input.issueNumber}
+- Title: ${input.issueTitle}
+- Description: ${input.issueDescription}
+
+**Workflow Type:** ${input.workflow}
+
+**Workflow Configuration:**
+${JSON.stringify(workflowConfig, null, 2)}
+
+**Your Task:**
+Generate a complete workflow plan that includes:
+1. All phases from the workflow configuration
+2. Specific steps for each phase based on the issue requirements
+3. Success criteria for each phase
+4. Estimated complexity
+
+**Output Format:**
+Return ONLY a valid JSON object with the following structure:
+
+\`\`\`json
+{
+  "phases": [
+    {
+      "phase": "phase_name",
+      "description": "What this phase accomplishes",
+      "steps": [
+        {
+          "action": "specific action to take",
+          "details": "additional context or requirements"
+        }
+      ],
+      "success_criteria": [
+        "criterion 1",
+        "criterion 2"
+      ],
+      "complexity": "low|medium|high"
+    }
+  ],
+  "overall_complexity": "low|medium|high",
+  "estimated_phases": 4,
+  "special_considerations": [
+    "Any special notes or warnings"
+  ]
+}
+\`\`\`
+
+Generate the plan now:`;
+    }
+    /**
+     * Extract JSON from Claude response
+     */
+    extractJsonFromResponse(text) {
+        // Try to find JSON in code blocks
+        const jsonBlockMatch = text.match(/```json\s*\n([\s\S]*?)\n```/);
+        if (jsonBlockMatch) {
+            return JSON.parse(jsonBlockMatch[1]);
+        }
+        // Try to find JSON in the text
+        const jsonMatch = text.match(/\{[\s\S]*\}/);
+        if (jsonMatch) {
+            return JSON.parse(jsonMatch[0]);
+        }
+        throw new Error('Could not extract JSON from Claude response');
+    }
+    /**
+     * Extract repository organization and project name using SDK Git class
+     */
+    async extractRepoInfo() {
+        try {
+            const remoteUrl = this.git.exec('remote get-url origin');
+            // Parse git@github.com:organization/project.git or https://github.com/organization/project.git
+            const match = remoteUrl.match(/[:/]([^/]+)\/([^/]+?)(?:\.git)?$/);
+            if (match) {
+                return {
+                    organization: match[1],
+                    project: match[2],
+                };
+            }
+        }
+        catch (error) {
+            // Fall back to config or defaults
+        }
+        return {
+            organization: this.config.github?.organization || 'unknown',
+            project: this.config.github?.project || 'unknown',
+        };
+    }
+}

package/dist/lib/config.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Configuration Manager
+ *
+ * Loads FABER CLI configuration and respects Claude Code settings
+ */
+import type { FaberConfig } from '../types/config.js';
+/**
+ * Configuration Manager
+ */
+export declare class ConfigManager {
+    private config;
+    private constructor();
+    /**
+     * Load configuration
+     */
+    static load(): Promise<FaberConfig>;
+    /**
+     * Read Claude Code configuration for worktree location
+     */
+    private static readClaudeCodeWorktreeLocation;
+    /**
+     * Get Claude Code configuration paths by platform
+     */
+    private static getClaudeConfigPaths;
+    /**
+     * Get configuration value
+     */
+    get(key: keyof FaberConfig): any;
+}
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +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;IAgEzC;;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

@@ -0,0 +1,127 @@
+/**
+ * Configuration Manager
+ *
+ * Loads FABER CLI configuration and respects Claude Code settings
+ */
+import fs from 'fs/promises';
+import path from 'path';
+import os from 'os';
+/**
+ * Configuration Manager
+ */
+export class ConfigManager {
+    constructor(config) {
+        this.config = config;
+    }
+    /**
+     * Load configuration
+     */
+    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
+        try {
+            const faberConfigPath = path.join(process.cwd(), '.fractary', 'settings.json');
+            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 };
+            }
+        }
+        catch (error) {
+            // FABER config not found, use defaults
+        }
+        // Read Claude Code configuration for worktree location
+        if (!config.worktree?.location || config.worktree?.inherit_from_claude !== false) {
+            const claudeWorktreeLocation = await ConfigManager.readClaudeCodeWorktreeLocation();
+            if (claudeWorktreeLocation) {
+                if (!config.worktree) {
+                    config.worktree = {};
+                }
+                config.worktree.location = claudeWorktreeLocation;
+            }
+        }
+        // Set defaults
+        if (!config.worktree?.location) {
+            config.worktree = {
+                ...config.worktree,
+                location: path.join(os.homedir(), '.claude-worktrees'),
+            };
+        }
+        if (!config.workflow?.config_path) {
+            config.workflow = {
+                ...config.workflow,
+                config_path: path.join(process.cwd(), 'plugins', 'faber', 'config', 'workflows'),
+            };
+        }
+        return config;
+    }
+    /**
+     * Read Claude Code configuration for worktree location
+     */
+    static async readClaudeCodeWorktreeLocation() {
+        const configPaths = ConfigManager.getClaudeConfigPaths();
+        for (const configPath of configPaths) {
+            try {
+                const content = await fs.readFile(configPath, 'utf-8');
+                const config = JSON.parse(content);
+                if (config.worktree?.directory) {
+                    return config.worktree.directory;
+                }
+            }
+            catch (error) {
+                // Config file not found or not readable, try next
+                continue;
+            }
+        }
+        return null;
+    }
+    /**
+     * Get Claude Code configuration paths by platform
+     */
+    static getClaudeConfigPaths() {
+        const homeDir = os.homedir();
+        const platform = os.platform();
+        switch (platform) {
+            case 'linux':
+                return [
+                    path.join(homeDir, '.config', 'claude', 'config.json'),
+                    path.join(homeDir, '.claude', 'config.json'),
+                ];
+            case 'darwin': // macOS
+                return [
+                    path.join(homeDir, 'Library', 'Application Support', 'Claude', 'config.json'),
+                    path.join(homeDir, '.config', 'claude', 'config.json'),
+                ];
+            case 'win32': // Windows
+                return [
+                    path.join(process.env.APPDATA || path.join(homeDir, 'AppData', 'Roaming'), 'Claude', 'config.json'),
+                    path.join(homeDir, '.claude', 'config.json'),
+                ];
+            default:
+                return [path.join(homeDir, '.claude', 'config.json')];
+        }
+    }
+    /**
+     * Get configuration value
+     */
+    get(key) {
+        return this.config[key];
+    }
+}

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

@@ -0,0 +1,78 @@
+/**
+ * Repo Client
+ *
+ * Integrates with @fractary/core SDK for repository and work tracking operations
+ */
+interface Issue {
+    id: string;
+    number: number;
+    title: string;
+    description: string;
+    labels: string[];
+    url: string;
+    state: string;
+}
+interface WorktreeResult {
+    path: string;
+    absolute_path: string;
+    branch: string;
+    created_at: string;
+    organization: string;
+    project: string;
+    work_id: string;
+}
+interface IssueUpdateOptions {
+    id: string;
+    comment?: string;
+    addLabel?: string;
+    removeLabel?: string;
+}
+/**
+ * Repo Client - integrates with @fractary/core SDK
+ *
+ * Provides repository and work tracking operations using WorkManager and RepoManager
+ * from the @fractary/core SDK. Replaces the previous CLI-based approach.
+ */
+export declare class RepoClient {
+    private config;
+    private workManager;
+    private repoManager;
+    private organization;
+    private project;
+    constructor(config: any);
+    /**
+     * Fetch specific issues by ID
+     *
+     * Uses WorkManager from @fractary/core SDK
+     */
+    fetchIssues(ids: string[]): Promise<Issue[]>;
+    /**
+     * Search issues by labels
+     *
+     * Uses WorkManager from @fractary/core SDK
+     */
+    searchIssues(labels: string[]): Promise<Issue[]>;
+    /**
+     * Create a git branch
+     *
+     * Uses RepoManager from @fractary/core SDK
+     */
+    createBranch(branchName: string): Promise<void>;
+    /**
+     * Create a git worktree
+     *
+     * Uses RepoManager from @fractary/core SDK
+     */
+    createWorktree(options: {
+        workId: string;
+        path?: string;
+    }): Promise<WorktreeResult>;
+    /**
+     * Update GitHub issue
+     *
+     * Uses WorkManager from @fractary/core SDK
+     */
+    updateIssue(options: IssueUpdateOptions): Promise<void>;
+}
+export {};
+//# sourceMappingURL=repo-client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"repo-client.d.ts","sourceRoot":"","sources":["../../src/lib/repo-client.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH,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,CAAM;IACpB,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,OAAO,CAAS;gBAEZ,MAAM,EAAE,GAAG;IA6BvB;;;;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/repo-client.js

@@ -0,0 +1,151 @@
+/**
+ * Repo Client
+ *
+ * Integrates with @fractary/core SDK for repository and work tracking operations
+ */
+import { WorkManager, RepoManager } from '@fractary/core';
+import { createWorkConfig, createRepoConfig } from './sdk-config-adapter.js';
+import { sdkIssueToCLIIssue, sdkWorktreeToCLIWorktreeResult } from './sdk-type-adapter.js';
+import os from 'os';
+/**
+ * Repo Client - integrates with @fractary/core SDK
+ *
+ * Provides repository and work tracking operations using WorkManager and RepoManager
+ * from the @fractary/core SDK. Replaces the previous CLI-based approach.
+ */
+export class RepoClient {
+    constructor(config) {
+        this.config = config;
+        // Validate GitHub token
+        const token = config.github?.token;
+        if (!token) {
+            throw new Error('GitHub token not found. Set GITHUB_TOKEN environment variable.');
+        }
+        // Extract organization and project
+        this.organization = config.github?.organization || 'unknown';
+        this.project = config.github?.project || 'unknown';
+        // Create SDK configurations
+        const workConfig = createWorkConfig(config);
+        const repoConfig = createRepoConfig(config);
+        // Initialize SDK managers
+        try {
+            this.workManager = new WorkManager(workConfig);
+            this.repoManager = new RepoManager(repoConfig);
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                throw new Error(`Failed to initialize SDK managers: ${error.message}`);
+            }
+            throw error;
+        }
+    }
+    /**
+     * Fetch specific issues by ID
+     *
+     * Uses WorkManager from @fractary/core SDK
+     */
+    async fetchIssues(ids) {
+        try {
+            const issues = await Promise.all(ids.map(id => this.workManager.fetchIssue(id)));
+            return issues.map(sdkIssueToCLIIssue);
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                throw new Error(`Failed to fetch issues: ${error.message}`);
+            }
+            throw error;
+        }
+    }
+    /**
+     * Search issues by labels
+     *
+     * Uses WorkManager from @fractary/core SDK
+     */
+    async searchIssues(labels) {
+        try {
+            const issues = await this.workManager.searchIssues('', {
+                state: 'open',
+                labels: labels,
+            });
+            return issues.map(sdkIssueToCLIIssue);
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                throw new Error(`Failed to search issues: ${error.message}`);
+            }
+            throw error;
+        }
+    }
+    /**
+     * Create a git branch
+     *
+     * Uses RepoManager from @fractary/core SDK
+     */
+    async createBranch(branchName) {
+        try {
+            await this.repoManager.createBranch(branchName);
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                throw new Error(`Failed to create branch: ${error.message}`);
+            }
+            throw error;
+        }
+    }
+    /**
+     * Create a git worktree
+     *
+     * Uses RepoManager from @fractary/core SDK
+     */
+    async createWorktree(options) {
+        try {
+            const branch = `feature/${options.workId}`;
+            const path = options.path ||
+                `~/.claude-worktrees/${this.organization}-${this.project}-${options.workId}`;
+            // Expand ~ to home directory
+            const expandedPath = path.startsWith('~')
+                ? path.replace('~', os.homedir())
+                : path;
+            const worktree = this.repoManager.createWorktree({
+                path: expandedPath,
+                branch,
+                workId: options.workId,
+            });
+            return sdkWorktreeToCLIWorktreeResult(worktree, this.organization, this.project, options.workId);
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                throw new Error(`Failed to create worktree: ${error.message}`);
+            }
+            throw error;
+        }
+    }
+    /**
+     * Update GitHub issue
+     *
+     * Uses WorkManager from @fractary/core SDK
+     */
+    async updateIssue(options) {
+        try {
+            const issueId = parseInt(options.id, 10);
+            // Create comment if provided
+            if (options.comment) {
+                await this.workManager.createComment(issueId, options.comment);
+            }
+            // Add label if provided
+            if (options.addLabel) {
+                await this.workManager.addLabels(issueId, [options.addLabel]);
+            }
+            // Remove label if provided
+            if (options.removeLabel) {
+                await this.workManager.removeLabels(issueId, [options.removeLabel]);
+            }
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                throw new Error(`Failed to update issue: ${error.message}`);
+            }
+            throw error;
+        }
+    }
+}

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

@@ -0,0 +1,24 @@
+/**
+ * SDK Configuration Adapter
+ *
+ * Converts FABER CLI configuration to @fractary/core SDK configuration format
+ */
+import type { FaberConfig } from '../types/config.js';
+import type { WorkConfig, RepoConfig } from '@fractary/core';
+/**
+ * Create WorkConfig for WorkManager from FaberConfig
+ *
+ * @param faberConfig - FABER CLI configuration
+ * @returns WorkConfig for @fractary/core WorkManager
+ * @throws Error if required fields are missing
+ */
+export declare function createWorkConfig(faberConfig: FaberConfig): WorkConfig;
+/**
+ * Create RepoConfig for RepoManager from FaberConfig
+ *
+ * @param faberConfig - FABER CLI configuration
+ * @returns RepoConfig for @fractary/core RepoManager
+ * @throws Error if required fields are missing
+ */
+export declare function createRepoConfig(faberConfig: FaberConfig): RepoConfig;
+//# sourceMappingURL=sdk-config-adapter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sdk-config-adapter.d.ts","sourceRoot":"","sources":["../../src/lib/sdk-config-adapter.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE7D;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,WAAW,GAAG,UAAU,CAuBrE;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,WAAW,GAAG,UAAU,CAiBrE"}