@fractary/faber-cli 1.5.8 → 1.5.12

package/README.md

@@ -1,6 +1,6 @@
 # @fractary/faber-cli
 
-Command-line interface for FABER development toolkit. Execute and manage FABER workflows, work items, repository operations, specifications, and logs.
+Command-line interface for FABER development toolkit.
 
 ## Installation
 
@@ -16,205 +16,35 @@ npx @fractary/faber-cli --help
 
 ## Quick Start
 
-### 1. Install
+### 1. Authenticate
 
 ```bash
-npm install -g @fractary/faber-cli
-```
-
-Or use directly with `npx`:
-
-```bash
-npx @fractary/faber-cli --help
-```
-
-### 2. Authenticate with GitHub
-
-**Option A: Automated Setup (Recommended)**
-
-```bash
-cd your-project
 fractary-faber auth setup
 ```
 
-This command will:
-1. Detect your GitHub organization and repository
-2. Show you a URL to create a GitHub App
-3. Guide you through copying the authorization code
-4. Automatically configure FABER CLI
-
-All in ~30 seconds!
-
-**Option B: Manual Setup**
-
-See [GitHub App Setup Guide](../docs/github-app-setup.md) for detailed manual instructions.
-
-### 3. Initialize a FABER project
+### 2. Initialize
 
 ```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
+### 3. Run a Workflow
 
 ```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
+faber plan --work-id 123
+cd ~/.claude-worktrees/{org}-{project}-123
+/fractary-faber:workflow-run 123
 ```
 
-### 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>
-```
+## Commands
 
-### 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"
-  }
-}
-```
+| Category | Commands |
+|----------|----------|
+| **Workflow** | `run`, `status`, `pause`, `resume`, `recover`, `cleanup` |
+| **Work** | `issue`, `comment`, `label`, `milestone` |
+| **Repo** | `branch`, `commit`, `pr`, `tag`, `worktree` |
+| **Spec** | `create`, `get`, `list`, `validate`, `refine` |
+| **Logs** | `capture`, `stop`, `read`, `search`, `archive` |
 
 ## Options
 
@@ -224,96 +54,13 @@ All commands support:
 - `--debug` - Enable debug output
 - `--help` - Show command help
 
-## Authentication
-
-### GitHub App Authentication (Recommended)
-
-For enhanced security, audit trails, and enterprise readiness, use GitHub App authentication instead of Personal Access Tokens.
-
-**Quick Setup (Automated):**
-
-```bash
-fractary-faber auth setup
-```
-
-This command will guide you through creating and configuring a GitHub App in ~30 seconds.
-
-**Manual Configuration (`.fractary/settings.json`):**
-```json
-{
-  "github": {
-    "organization": "your-org",
-    "project": "your-repo",
-    "app": {
-      "id": "123456",
-      "installation_id": "12345678",
-      "private_key_path": "~/.github/faber-app.pem"
-    }
-  }
-}
-```
-
-**For CI/CD (environment variable):**
-```json
-{
-  "github": {
-    "organization": "your-org",
-    "project": "your-repo",
-    "app": {
-      "id": "123456",
-      "installation_id": "12345678",
-      "private_key_env_var": "GITHUB_APP_PRIVATE_KEY"
-    }
-  }
-}
-```
-
-```bash
-export GITHUB_APP_PRIVATE_KEY=$(cat ~/.github/faber-app.pem | base64)
-```
-
-**See detailed setup guide:** [docs/github-app-setup.md](../docs/github-app-setup.md)
-
-### Personal Access Token (Legacy)
-
-Still supported for backward compatibility:
-
-```bash
-export GITHUB_TOKEN=<token>
-```
-
-Or in `.fractary/settings.json`:
-```json
-{
-  "github": {
-    "token": "ghp_xxxxxxxxxxxx",
-    "organization": "your-org",
-    "project": "your-repo"
-  }
-}
-```
-
-### Other Providers
-
-```bash
-# Jira
-export JIRA_BASE_URL=<url>
-export JIRA_USERNAME=<username>
-export JIRA_API_TOKEN=<token>
-
-# Linear
-export LINEAR_API_KEY=<key>
-```
-
-## Architecture
+## Documentation
 
-See [SPEC-00026: Distributed Plugin Architecture](../specs/SPEC-00026-distributed-plugin-architecture.md)
+For complete documentation, see:
 
-The CLI follows SPEC-00026 standards:
-- Package: `@fractary/faber-cli`
-- Binary: `fractary-faber`
-- Located: `/cli` at root of repository
-- Depends on: `@fractary/faber` SDK
+- **[Commands Reference](../docs/cli/commands.md)** - All commands
+- **[Authentication Guide](../docs/cli/authentication.md)** - GitHub App and PAT setup
+- **[Configuration Guide](../docs/guides/configuration.md)** - Configuration options
 
 ## License
 

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/auth/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA+BpC;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,OAAO,CAehD;AAojBD;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAM3C"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/auth/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA8BpC;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,OAAO,CAehD;AAojBD;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAM3C"}

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -13,7 +13,6 @@ import chalk from 'chalk';
 import { createRunCommand, createStatusCommand, createResumeCommand, createPauseCommand, createRecoverCommand, createCleanupCommand } from './commands/workflow/index.js';
 import { createWorkCommand } from './commands/work/index.js';
 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';
@@ -23,15 +22,14 @@ import { createAuthCommand } from './commands/auth/index.js';
 if (process.stdout.isTTY) {
     process.stdout._handle?.setBlocking?.(true);
 }
-console.error('[DEBUG] CLI starting, args:', process.argv);
-const version = '1.5.8';
+const version = '1.5.12';
 /**
  * Create and configure the main CLI program
  */
 export function createFaberCLI() {
     const program = new Command('fractary-faber');
     program
-        .description('FABER development toolkit (workflow, work, repo, spec, logs, auth)')
+        .description('FABER development toolkit (workflow, work, repo, logs, auth)')
         .version(version)
         .enablePositionalOptions();
     // Global options
@@ -153,7 +151,6 @@ export function createFaberCLI() {
     program.addCommand(createAuthCommand());
     program.addCommand(createWorkCommand());
     program.addCommand(createRepoCommand());
-    program.addCommand(createSpecCommand());
     program.addCommand(createLogsCommand());
     // Help command
     program.addCommand(new Command('help')
@@ -172,11 +169,8 @@ export function createFaberCLI() {
 const isMainModule = import.meta.url === `file://${process.argv[1]}` ||
     process.argv[1]?.endsWith('fractary-faber');
 if (isMainModule) {
-    console.error('[DEBUG] Creating CLI program');
     const program = createFaberCLI();
-    console.error('[DEBUG] Parsing argv');
     program.parse(process.argv);
-    console.error('[DEBUG] Parse complete');
     // Show help if no command provided
     if (!process.argv.slice(2).length) {
         program.outputHelp();

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

@@ -48,10 +48,6 @@ export declare class AnthropicClient {
      * Generate workflow plan via Claude API
      */
     generatePlan(input: GeneratePlanInput): Promise<WorkflowPlan>;
-    /**
-     * Load workflow configuration
-     */
-    private loadWorkflowConfig;
     /**
      * Construct planning prompt for Claude
      */

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,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"}
+{"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;IAiBrC;;OAEG;YACW,cAAc;IAiB5B;;OAEG;IACH,OAAO,CAAC,YAAY;IAepB;;OAEG;IACG,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,YAAY,CAAC;IA8DnE;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAqD/B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAgB/B;;OAEG;YACW,eAAe;CAqB9B"}

package/dist/lib/anthropic-client.js

@@ -8,7 +8,7 @@ import Ajv from 'ajv';
 import fs from 'fs/promises';
 import path from 'path';
 import { fileURLToPath } from 'url';
-import { Git } from '@fractary/faber';
+import { Git, WorkflowResolver } from '@fractary/faber';
 import { validateJsonSize } from '../utils/validation.js';
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
@@ -19,7 +19,9 @@ export class AnthropicClient {
     constructor(config) {
         this.config = config;
         this.git = new Git();
-        this.ajv = new Ajv({ strict: false }); // Allow additional properties
+        // validateFormats: false suppresses warnings about unknown formats (uri, date-time)
+        // These formats are used for documentation, not strict validation
+        this.ajv = new Ajv({ strict: false, validateFormats: false });
         const apiKey = config.anthropic?.api_key;
         if (!apiKey) {
             throw new Error('Anthropic API key not found. Set ANTHROPIC_API_KEY environment variable.');
@@ -36,8 +38,8 @@ export class AnthropicClient {
             return; // Already loaded
         }
         try {
-            // Schema path relative to this file
-            const schemaPath = path.resolve(__dirname, '../../../plugins/faber/config/schemas/plan.schema.json');
+            // Schema bundled with CLI package (cli/schemas/plan.schema.json)
+            const schemaPath = path.resolve(__dirname, '../../schemas/plan.schema.json');
             const schemaContent = await fs.readFile(schemaPath, 'utf8');
             this.planSchema = JSON.parse(schemaContent);
         }
@@ -68,8 +70,9 @@ export class AnthropicClient {
     async generatePlan(input) {
         // Load plan schema for validation
         await this.loadPlanSchema();
-        // Load workflow configuration
-        const workflowConfig = await this.loadWorkflowConfig(input.workflow);
+        // Resolve workflow with inheritance (uses SDK WorkflowResolver)
+        const resolver = new WorkflowResolver({ projectRoot: process.cwd() });
+        const workflowConfig = await resolver.resolveWorkflow(input.workflow);
         // Generate plan ID
         const timestamp = new Date().toISOString().replace(/[-:]/g, '').replace(/\.\d+Z/, '').replace('T', '-');
         const planId = `fractary-faber-${input.issueNumber}-${timestamp}`;
@@ -115,19 +118,6 @@ export class AnthropicClient {
         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
      */

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

@@ -92,12 +92,6 @@ export declare function generateAppManifest(config: ManifestConfig): GitHubAppMa
  * @returns HTML content ready to save to file
  */
 export declare function generateManifestHtml(manifest: GitHubAppManifest, organization: string): string;
-/**
- * Generate GitHub App creation URL (legacy - prefer generateManifestHtml)
- *
- * @deprecated Use generateManifestHtml() instead for proper manifest flow
- */
-export declare function getManifestCreationUrl(manifest: GitHubAppManifest): string;
 /**
  * Exchange manifest code for app credentials
  *

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

@@ -1 +1 @@
-{"version":3,"file":"github-app-setup.d.ts","sourceRoot":"","sources":["../../src/lib/github-app-setup.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"github-app-setup.d.ts","sourceRoot":"","sources":["../../src/lib/github-app-setup.ts"],"names":[],"mappings":"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"}

package/dist/lib/github-app-setup.js

@@ -155,15 +155,6 @@ export function generateManifestHtml(manifest, organization) {
 </body>
 </html>`;
 }
-/**
- * Generate GitHub App creation URL (legacy - prefer generateManifestHtml)
- *
- * @deprecated Use generateManifestHtml() instead for proper manifest flow
- */
-export function getManifestCreationUrl(manifest) {
-    // For backward compatibility, return the basic GitHub App creation page
-    return 'https://github.com/settings/apps/new';
-}
 /**
  * Exchange manifest code for app credentials
  *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fractary/faber-cli",
-  "version": "1.5.8",
+  "version": "1.5.12",
   "description": "FABER CLI - Command-line interface for FABER development toolkit",
   "main": "dist/index.js",
   "bin": {
@@ -9,6 +9,7 @@
   "type": "module",
   "files": [
     "dist",
+    "schemas",
     "README.md",
     "LICENSE"
   ],
@@ -37,7 +38,7 @@
   },
   "dependencies": {
     "@fractary/core": "^0.5.0",
-    "@fractary/faber": "^2.1.2",
+    "@fractary/faber": "^2.3.0",
     "ajv": "^8.12.0",
     "chalk": "^5.0.0",
     "commander": "^12.0.0",

package/schemas/plan.schema.json

@@ -0,0 +1,230 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://raw.githubusercontent.com/fractary/faber/main/plugins/faber/config/schemas/plan.schema.json",
+  "title": "FABER Plan Schema",
+  "description": "JSON Schema for FABER workflow plans generated by CLI or Claude plugin",
+  "type": "object",
+  "required": ["plan_id", "created_by", "created_at", "workflow", "phases"],
+  "additionalProperties": true,
+  "properties": {
+    "$schema": {
+      "type": "string",
+      "format": "uri",
+      "description": "JSON Schema reference for IDE validation"
+    },
+    "plan_id": {
+      "type": "string",
+      "pattern": "^fractary-faber-[0-9]+-[0-9]{8}-[0-9]{6}$",
+      "description": "Unique plan identifier (format: fractary-faber-{work-id}-{YYYYMMDD}-{HHMMSS})",
+      "examples": ["fractary-faber-258-20260106-143022"]
+    },
+    "created_by": {
+      "type": "string",
+      "enum": ["cli", "claude", "api"],
+      "description": "Tool that created the plan"
+    },
+    "cli_version": {
+      "type": "string",
+      "pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+$",
+      "description": "Version of CLI that created the plan (if created_by: cli)",
+      "examples": ["3.4.0"]
+    },
+    "created_at": {
+      "type": "string",
+      "format": "date-time",
+      "description": "ISO 8601 timestamp when plan was created"
+    },
+    "issue": {
+      "type": "object",
+      "required": ["source", "id"],
+      "description": "Issue metadata - links plan to originating work item",
+      "properties": {
+        "source": {
+          "type": "string",
+          "enum": ["github", "jira", "linear", "manual"],
+          "description": "Issue tracking system"
+        },
+        "id": {
+          "type": "string",
+          "description": "Issue identifier (e.g., issue number)"
+        },
+        "url": {
+          "type": "string",
+          "format": "uri",
+          "description": "Full URL to issue"
+        }
+      }
+    },
+    "branch": {
+      "type": "string",
+      "description": "Git branch name for this workflow (e.g., feature/258)"
+    },
+    "worktree": {
+      "type": "string",
+      "description": "Git worktree path (e.g., ~/.claude-worktrees/fractary-myproject-258)"
+    },
+    "workflow": {
+      "type": "string",
+      "description": "Workflow type identifier (e.g., etl, bugfix, core)"
+    },
+    "overall_complexity": {
+      "type": "string",
+      "enum": ["low", "medium", "high"],
+      "description": "Overall estimated complexity"
+    },
+    "estimated_phases": {
+      "type": "integer",
+      "minimum": 1,
+      "description": "Estimated number of phases to complete"
+    },
+    "special_considerations": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      },
+      "description": "Special notes or warnings for this workflow"
+    },
+    "phases": {
+      "type": "array",
+      "description": "Ordered list of workflow phases",
+      "items": {
+        "$ref": "#/definitions/phase"
+      }
+    },
+    "metadata": {
+      "type": "object",
+      "description": "Additional metadata (flexible)",
+      "properties": {
+        "org": {
+          "type": "string",
+          "description": "GitHub organization"
+        },
+        "project": {
+          "type": "string",
+          "description": "Project/repository name"
+        },
+        "subproject": {
+          "type": "string",
+          "description": "Subproject identifier (optional)"
+        }
+      }
+    },
+    "autonomy": {
+      "type": "string",
+      "enum": ["supervised", "assisted", "autonomous", "guarded"],
+      "description": "Autonomy level for workflow execution"
+    }
+  },
+  "definitions": {
+    "phase": {
+      "type": "object",
+      "required": ["phase", "description", "steps"],
+      "properties": {
+        "phase": {
+          "type": "string",
+          "description": "Phase identifier (e.g., frame, architect, build, evaluate, release)"
+        },
+        "description": {
+          "type": "string",
+          "description": "What this phase accomplishes"
+        },
+        "steps": {
+          "type": "array",
+          "description": "Specific steps for this phase",
+          "items": {
+            "$ref": "#/definitions/step"
+          }
+        },
+        "success_criteria": {
+          "type": "array",
+          "description": "Criteria to verify phase completion",
+          "items": {
+            "type": "string"
+          }
+        },
+        "complexity": {
+          "type": "string",
+          "enum": ["low", "medium", "high"],
+          "description": "Phase complexity estimate"
+        }
+      }
+    },
+    "step": {
+      "type": "object",
+      "required": ["action"],
+      "properties": {
+        "action": {
+          "type": "string",
+          "description": "Specific action to take"
+        },
+        "details": {
+          "type": "string",
+          "description": "Additional context or requirements"
+        },
+        "command": {
+          "type": ["string", "null"],
+          "description": "Shell command to execute (optional)"
+        },
+        "prompt": {
+          "type": "string",
+          "description": "LLM prompt for this step (optional)"
+        },
+        "artifacts": {
+          "type": "object",
+          "description": "Expected artifacts from this step"
+        }
+      }
+    }
+  },
+  "examples": [
+    {
+      "plan_id": "fractary-faber-258-20260106-143022",
+      "created_by": "cli",
+      "cli_version": "3.4.0",
+      "created_at": "2026-01-06T14:30:22Z",
+      "issue": {
+        "source": "github",
+        "id": "258",
+        "url": "https://github.com/fractary/myproject/issues/258"
+      },
+      "branch": "feature/258",
+      "worktree": "~/.claude-worktrees/fractary-myproject-258",
+      "workflow": "etl",
+      "overall_complexity": "medium",
+      "estimated_phases": 5,
+      "phases": [
+        {
+          "phase": "frame",
+          "description": "Understand requirements and plan approach",
+          "steps": [
+            {
+              "action": "Read issue description and extract requirements",
+              "details": "Identify data source, target format, and validation rules"
+            }
+          ],
+          "success_criteria": [
+            "Requirements documented",
+            "Data source identified"
+          ],
+          "complexity": "low"
+        },
+        {
+          "phase": "architect",
+          "description": "Design ETL pipeline architecture",
+          "steps": [
+            {
+              "action": "Design data transformation logic",
+              "details": "Map source fields to target schema"
+            }
+          ],
+          "success_criteria": [
+            "Architecture documented",
+            "Data flow mapped"
+          ],
+          "complexity": "medium"
+        }
+      ],
+      "autonomy": "supervised"
+    }
+  ]
+}