@fractary/faber-cli 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Fractary Team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,223 @@
+# @fractary/faber-cli
+
+Command-line interface for FABER development toolkit. Execute and manage FABER workflows, work items, repository operations, specifications, and logs.
+
+## Installation
+
+```bash
+npm install -g @fractary/faber-cli
+```
+
+Or use directly with `npx`:
+
+```bash
+npx @fractary/faber-cli --help
+```
+
+## Quick Start
+
+### Initialize a FABER project
+
+```bash
+fractary-faber init
+fractary-faber init --preset minimal
+fractary-faber init --preset enterprise
+```
+
+### Workflow Commands
+
+```bash
+# Start a FABER workflow
+fractary-faber run --work-id 123
+
+# Check workflow status
+fractary-faber status
+fractary-faber status --workflow-id <id>
+
+# Pause/resume workflows
+fractary-faber pause <workflow-id>
+fractary-faber resume <workflow-id>
+
+# Recover from checkpoint
+fractary-faber recover <workflow-id>
+
+# Clean up old workflows
+fractary-faber cleanup --max-age 30
+```
+
+### Work Commands
+
+```bash
+# Issue operations
+fractary-faber work issue fetch 123
+fractary-faber work issue create --title "New feature"
+fractary-faber work issue update 123 --title "Updated"
+fractary-faber work issue close 123
+fractary-faber work issue search --query "bug fix"
+
+# Comment operations
+fractary-faber work comment create 123 --body "This is a comment"
+fractary-faber work comment list 123
+
+# Label operations
+fractary-faber work label add 123 --label "bug,critical"
+fractary-faber work label remove 123 --label "wontfix"
+fractary-faber work label list
+
+# Milestone operations
+fractary-faber work milestone create --title "v1.0" --due-on "2025-12-31"
+fractary-faber work milestone list
+fractary-faber work milestone set 123 --milestone "v1.0"
+```
+
+### Repository Commands
+
+```bash
+# Branch operations
+fractary-faber repo branch create "feat/new-feature"
+fractary-faber repo branch list
+fractary-faber repo branch delete feat/old-feature
+
+# Commit operations
+fractary-faber repo commit "feat: add new feature"
+
+# Pull request operations
+fractary-faber repo pr create "Add new feature" --body "Description"
+fractary-faber repo pr list
+fractary-faber repo pr merge 42
+fractary-faber repo pr review 42
+
+# Tag operations
+fractary-faber repo tag create v1.0.0
+fractary-faber repo tag push v1.0.0
+fractary-faber repo tag list
+
+# Worktree operations
+fractary-faber repo worktree create feat/new-feature
+fractary-faber repo worktree list
+fractary-faber repo worktree remove feat/new-feature
+```
+
+### Specification Commands
+
+```bash
+# Create specifications
+fractary-faber spec create "My Specification"
+
+# Get specification
+fractary-faber spec get <id>
+
+# List specifications
+fractary-faber spec list
+
+# Update specification
+fractary-faber spec update <id> --title "Updated"
+
+# Validate specification
+fractary-faber spec validate <id>
+
+# Refine specification
+fractary-faber spec refine <id>
+
+# Delete specification
+fractary-faber spec delete <id>
+```
+
+### Logs Commands
+
+```bash
+# Capture logs
+fractary-faber logs capture <workflow-id>
+
+# Stop capturing logs
+fractary-faber logs stop <session-id>
+
+# Write logs
+fractary-faber logs write --message "Log message"
+
+# Read logs
+fractary-faber logs read <session-id>
+
+# Search logs
+fractary-faber logs search --query "error"
+
+# List logs
+fractary-faber logs list
+
+# Archive logs
+fractary-faber logs archive --older-than 30
+
+# Delete logs
+fractary-faber logs delete <session-id>
+```
+
+## Configuration
+
+FABER is configured via `.fractary/faber/config.json`:
+
+```json
+{
+  "version": "1.0.0",
+  "preset": "default",
+  "work": {
+    "provider": "github"
+  },
+  "repo": {
+    "provider": "github",
+    "defaultBranch": "main"
+  },
+  "spec": {
+    "directory": ".fractary/faber/specs"
+  },
+  "logs": {
+    "directory": ".fractary/faber/logs"
+  },
+  "workflow": {
+    "defaultAutonomy": "guarded",
+    "phases": ["frame", "architect", "build", "evaluate", "release"],
+    "checkpoints": true
+  },
+  "state": {
+    "directory": ".fractary/faber/state"
+  }
+}
+```
+
+## Options
+
+All commands support:
+
+- `--json` - Output as JSON
+- `--debug` - Enable debug output
+- `--help` - Show command help
+
+## Environment Variables
+
+Configure providers via environment variables:
+
+```bash
+# GitHub
+export GITHUB_TOKEN=<token>
+
+# Jira
+export JIRA_BASE_URL=<url>
+export JIRA_USERNAME=<username>
+export JIRA_API_TOKEN=<token>
+
+# Linear
+export LINEAR_API_KEY=<key>
+```
+
+## Architecture
+
+See [SPEC-00026: Distributed Plugin Architecture](../specs/SPEC-00026-distributed-plugin-architecture.md)
+
+The CLI follows SPEC-00026 standards:
+- Package: `@fractary/faber-cli`
+- Binary: `fractary-faber`
+- Located: `/cli` at root of repository
+- Depends on: `@fractary/faber` SDK
+
+## License
+
+MIT

package/dist/commands/init.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Init command - Initialize a new FABER project
+ */
+import { Command } from 'commander';
+export declare function createInitCommand(): Command;
+//# sourceMappingURL=init.d.ts.map

package/dist/commands/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKpC,wBAAgB,iBAAiB,IAAI,OAAO,CAsE3C"}

package/dist/commands/init.js

@@ -0,0 +1,163 @@
+/**
+ * Init command - Initialize a new FABER project
+ */
+import { Command } from 'commander';
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import chalk from 'chalk';
+export function createInitCommand() {
+    return new Command('init')
+        .description('Initialize a new FABER project')
+        .option('--preset <name>', 'Use a preset configuration', 'default')
+        .option('--force', 'Overwrite existing configuration')
+        .option('--json', 'Output as JSON')
+        .action(async (options) => {
+        try {
+            const configDir = '.fractary/faber';
+            const configPath = path.join(configDir, 'config.json');
+            // Check if already initialized
+            const exists = await fs.access(configPath).then(() => true).catch(() => false);
+            if (exists && !options.force) {
+                if (options.json) {
+                    console.log(JSON.stringify({
+                        status: 'error',
+                        error: { code: 'ALREADY_INITIALIZED', message: 'FABER already initialized. Use --force to reinitialize.' },
+                    }));
+                }
+                else {
+                    console.error(chalk.yellow('FABER already initialized. Use --force to reinitialize.'));
+                }
+                process.exit(1);
+            }
+            // Create directory structure
+            await fs.mkdir(configDir, { recursive: true });
+            await fs.mkdir(path.join(configDir, 'specs'), { recursive: true });
+            await fs.mkdir(path.join(configDir, 'logs'), { recursive: true });
+            await fs.mkdir(path.join(configDir, 'state'), { recursive: true });
+            // Create default configuration
+            const config = createDefaultConfig(options.preset);
+            await fs.writeFile(configPath, JSON.stringify(config, null, 2));
+            // Create .gitignore for sensitive files
+            const gitignore = `# FABER state files
+state/*.json
+logs/session-*.md
+*.tmp
+`;
+            await fs.writeFile(path.join(configDir, '.gitignore'), gitignore);
+            if (options.json) {
+                console.log(JSON.stringify({
+                    status: 'success',
+                    data: { configPath, preset: options.preset },
+                }, null, 2));
+            }
+            else {
+                console.log(chalk.green('✓ FABER initialized successfully'));
+                console.log(chalk.gray(`  Config: ${configPath}`));
+                console.log(chalk.gray(`  Preset: ${options.preset}`));
+                console.log('\nNext steps:');
+                console.log('  1. Configure work tracking: Edit .fractary/faber/config.json');
+                console.log('  2. Start a workflow: fractary-faber run --work-id <issue-number>');
+                console.log('  3. Check status: fractary-faber status');
+            }
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            if (options.json) {
+                console.error(JSON.stringify({
+                    status: 'error',
+                    error: { code: 'INIT_ERROR', message },
+                }));
+            }
+            else {
+                console.error(chalk.red('Error:'), message);
+            }
+            process.exit(1);
+        }
+    });
+}
+/**
+ * Create default FABER configuration
+ */
+function createDefaultConfig(preset) {
+    const baseConfig = {
+        version: '1.0.0',
+        preset,
+        // Work tracking configuration
+        work: {
+            provider: 'github', // or 'jira', 'linear'
+        },
+        // Repository configuration
+        repo: {
+            provider: 'github', // or 'gitlab', 'bitbucket'
+            defaultBranch: 'main',
+            branchPrefix: 'feat/',
+            conventionalCommits: true,
+        },
+        // Specification configuration
+        spec: {
+            directory: '.fractary/faber/specs',
+            templates: {
+                feature: 'feature',
+                bugfix: 'bugfix',
+                refactor: 'refactor',
+            },
+        },
+        // Log configuration
+        logs: {
+            directory: '.fractary/faber/logs',
+            retention: {
+                session: 30,
+                build: 90,
+                deployment: 365,
+            },
+        },
+        // Workflow configuration
+        workflow: {
+            defaultAutonomy: 'guarded',
+            phases: ['frame', 'architect', 'build', 'evaluate', 'release'],
+            checkpoints: true,
+        },
+        // State management
+        state: {
+            directory: '.fractary/faber/state',
+            persistence: 'file', // or 'none' for stateless
+        },
+    };
+    // Apply preset modifications
+    switch (preset) {
+        case 'minimal':
+            return {
+                ...baseConfig,
+                workflow: {
+                    ...baseConfig.workflow,
+                    checkpoints: false,
+                },
+                logs: {
+                    ...baseConfig.logs,
+                    retention: {
+                        session: 7,
+                        build: 30,
+                        deployment: 90,
+                    },
+                },
+            };
+        case 'enterprise':
+            return {
+                ...baseConfig,
+                workflow: {
+                    ...baseConfig.workflow,
+                    defaultAutonomy: 'assist',
+                },
+                logs: {
+                    ...baseConfig.logs,
+                    retention: {
+                        session: 90,
+                        build: 365,
+                        deployment: 730,
+                    },
+                },
+            };
+        default:
+            return baseConfig;
+    }
+}

package/dist/commands/logs/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Logs subcommand - Log management
+ *
+ * Provides capture, write, search, list, archive operations via LogManager SDK.
+ */
+import { Command } from 'commander';
+/**
+ * Create the logs command tree
+ */
+export declare function createLogsCommand(): Command;
+//# sourceMappingURL=index.d.ts.map

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

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