@specforge/cli 0.1.0 → 0.2.4

package/dist/cli/commands/debug/register.js

@@ -9,7 +9,7 @@ function registerDebugCommands(program) {
     `
 Examples:
   $ specforge call list_projects
-  $ specforge call get_ticket --args='{"ticketId":"abc123"}'
+  $ specforge call get --args='{"type":"ticket","id":"abc123"}'
   $ specforge call list_tickets --format toon
   $ specforge call get_specification --args='{"specificationId":"spec-1"}' --raw
 

package/dist/cli/commands/debug/register.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/cli/commands/debug/register.ts"],"sourcesContent":["/**\n * Debug Command Registration\n *\n * Registers all debug commands with the CLI framework.\n */\n\nimport { Command } from 'commander';\nimport { withErrorHandler } from '../../middleware/error-handler.js';\nimport { callCommand } from './call.js';\nimport { toolsCommand } from './tools.js';\nimport { testCommand } from './test.js';\nimport { whoamiCommand } from './whoami.js';\nimport type { CallOptions, ToolsOptions, WhoamiOptions } from './types.js';\n\n/**\n * Register all debug commands with the CLI\n */\nexport function registerDebugCommands(program: Command): void {\n  // Call command - directly call MCP tools\n  program\n    .command('call <tool>')\n    .description('Directly call an MCP tool')\n    .option('--args <json>', 'Tool arguments as JSON')\n    .option('--format <format>', 'Output format (json, toon)', 'json')\n    .option('--raw', 'Show raw API response')\n    .addHelpText(\n      'after',\n      `\nExamples:\n  $ specforge call list_projects\n  $ specforge call get_ticket --args='{\"ticketId\":\"abc123\"}'\n  $ specforge call list_tickets --format toon\n  $ specforge call get_specification --args='{\"specificationId\":\"spec-1\"}' --raw\n\nThe call command allows you to directly invoke MCP tools with JSON arguments.\nThis is useful for testing, debugging, and scripting. Output can be formatted\nas JSON (default), TOON, or raw API response.\n`\n    )\n    .action(\n      withErrorHandler(async (tool: string, options: CallOptions) => {\n        await callCommand(tool, options);\n      })\n    );\n\n  // Tools command - list available MCP tools\n  program\n    .command('tools')\n    .description('List available MCP tools')\n    .option('--category <category>', 'Filter by category')\n    .option('--search <query>', 'Search tool names/descriptions')\n    .option('--json', 'Output as JSON')\n    .addHelpText(\n      'after',\n      `\nExamples:\n  $ specforge tools\n  $ specforge tools --category context\n  $ specforge tools --search ticket\n  $ specforge tools --json\n\nThe tools command lists all available MCP tools grouped by category.\nUse filters to narrow down the list. This command doesn't require\nauthentication since it lists locally defined tools.\n`\n    )\n    .action(\n      withErrorHandler(async (options: ToolsOptions) => {\n        await toolsCommand(options);\n      })\n    );\n\n  // Test command - test API connection\n  program\n    .command('test')\n    .description('Test API connection and authentication')\n    .addHelpText(\n      'after',\n      `\nExamples:\n  $ specforge test\n\nThe test command verifies your API connection and authentication.\nIt displays response time, user information, and accessible projects.\nHelpful error messages are provided for common connection issues.\n`\n    )\n    .action(\n      withErrorHandler(async () => {\n        await testCommand();\n      })\n    );\n\n  // Whoami command - show current user and config\n  program\n    .command('whoami')\n    .description('Show current user and configuration')\n    .option('--json', 'Output as JSON')\n    .addHelpText(\n      'after',\n      `\nExamples:\n  $ specforge whoami\n  $ specforge whoami --json\n\nThe whoami command displays your current user information, configuration\nsettings, and config file paths. Useful for debugging authentication and\nconfiguration issues.\n`\n    )\n    .action(\n      withErrorHandler(async (options: WhoamiOptions) => {\n        await whoamiCommand(options);\n      })\n    );\n}\n"],"mappings":"AAOA,SAAS,wBAAwB;AACjC,SAAS,mBAAmB;AAC5B,SAAS,oBAAoB;AAC7B,SAAS,mBAAmB;AAC5B,SAAS,qBAAqB;AAMvB,SAAS,sBAAsB,SAAwB;AAE5D,UACG,QAAQ,aAAa,EACrB,YAAY,2BAA2B,EACvC,OAAO,iBAAiB,wBAAwB,EAChD,OAAO,qBAAqB,8BAA8B,MAAM,EAChE,OAAO,SAAS,uBAAuB,EACvC;AAAA,IACC;AAAA,IACA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAWF,EACC;AAAA,IACC,iBAAiB,OAAO,MAAc,YAAyB;AAC7D,YAAM,YAAY,MAAM,OAAO;AAAA,IACjC,CAAC;AAAA,EACH;AAGF,UACG,QAAQ,OAAO,EACf,YAAY,0BAA0B,EACtC,OAAO,yBAAyB,oBAAoB,EACpD,OAAO,oBAAoB,gCAAgC,EAC3D,OAAO,UAAU,gBAAgB,EACjC;AAAA,IACC;AAAA,IACA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAWF,EACC;AAAA,IACC,iBAAiB,OAAO,YAA0B;AAChD,YAAM,aAAa,OAAO;AAAA,IAC5B,CAAC;AAAA,EACH;AAGF,UACG,QAAQ,MAAM,EACd,YAAY,wCAAwC,EACpD;AAAA,IACC;AAAA,IACA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQF,EACC;AAAA,IACC,iBAAiB,YAAY;AAC3B,YAAM,YAAY;AAAA,IACpB,CAAC;AAAA,EACH;AAGF,UACG,QAAQ,QAAQ,EAChB,YAAY,qCAAqC,EACjD,OAAO,UAAU,gBAAgB,EACjC;AAAA,IACC;AAAA,IACA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASF,EACC;AAAA,IACC,iBAAiB,OAAO,YAA2B;AACjD,YAAM,cAAc,OAAO;AAAA,IAC7B,CAAC;AAAA,EACH;AACJ;","names":[]}
+{"version":3,"sources":["../../../../src/cli/commands/debug/register.ts"],"sourcesContent":["/**\n * Debug Command Registration\n *\n * Registers all debug commands with the CLI framework.\n */\n\nimport { Command } from 'commander';\nimport { withErrorHandler } from '../../middleware/error-handler.js';\nimport { callCommand } from './call.js';\nimport { toolsCommand } from './tools.js';\nimport { testCommand } from './test.js';\nimport { whoamiCommand } from './whoami.js';\nimport type { CallOptions, ToolsOptions, WhoamiOptions } from './types.js';\n\n/**\n * Register all debug commands with the CLI\n */\nexport function registerDebugCommands(program: Command): void {\n  // Call command - directly call MCP tools\n  program\n    .command('call <tool>')\n    .description('Directly call an MCP tool')\n    .option('--args <json>', 'Tool arguments as JSON')\n    .option('--format <format>', 'Output format (json, toon)', 'json')\n    .option('--raw', 'Show raw API response')\n    .addHelpText(\n      'after',\n      `\nExamples:\n  $ specforge call list_projects\n  $ specforge call get --args='{\"type\":\"ticket\",\"id\":\"abc123\"}'\n  $ specforge call list_tickets --format toon\n  $ specforge call get_specification --args='{\"specificationId\":\"spec-1\"}' --raw\n\nThe call command allows you to directly invoke MCP tools with JSON arguments.\nThis is useful for testing, debugging, and scripting. Output can be formatted\nas JSON (default), TOON, or raw API response.\n`\n    )\n    .action(\n      withErrorHandler(async (tool: string, options: CallOptions) => {\n        await callCommand(tool, options);\n      })\n    );\n\n  // Tools command - list available MCP tools\n  program\n    .command('tools')\n    .description('List available MCP tools')\n    .option('--category <category>', 'Filter by category')\n    .option('--search <query>', 'Search tool names/descriptions')\n    .option('--json', 'Output as JSON')\n    .addHelpText(\n      'after',\n      `\nExamples:\n  $ specforge tools\n  $ specforge tools --category context\n  $ specforge tools --search ticket\n  $ specforge tools --json\n\nThe tools command lists all available MCP tools grouped by category.\nUse filters to narrow down the list. This command doesn't require\nauthentication since it lists locally defined tools.\n`\n    )\n    .action(\n      withErrorHandler(async (options: ToolsOptions) => {\n        await toolsCommand(options);\n      })\n    );\n\n  // Test command - test API connection\n  program\n    .command('test')\n    .description('Test API connection and authentication')\n    .addHelpText(\n      'after',\n      `\nExamples:\n  $ specforge test\n\nThe test command verifies your API connection and authentication.\nIt displays response time, user information, and accessible projects.\nHelpful error messages are provided for common connection issues.\n`\n    )\n    .action(\n      withErrorHandler(async () => {\n        await testCommand();\n      })\n    );\n\n  // Whoami command - show current user and config\n  program\n    .command('whoami')\n    .description('Show current user and configuration')\n    .option('--json', 'Output as JSON')\n    .addHelpText(\n      'after',\n      `\nExamples:\n  $ specforge whoami\n  $ specforge whoami --json\n\nThe whoami command displays your current user information, configuration\nsettings, and config file paths. Useful for debugging authentication and\nconfiguration issues.\n`\n    )\n    .action(\n      withErrorHandler(async (options: WhoamiOptions) => {\n        await whoamiCommand(options);\n      })\n    );\n}\n"],"mappings":"AAOA,SAAS,wBAAwB;AACjC,SAAS,mBAAmB;AAC5B,SAAS,oBAAoB;AAC7B,SAAS,mBAAmB;AAC5B,SAAS,qBAAqB;AAMvB,SAAS,sBAAsB,SAAwB;AAE5D,UACG,QAAQ,aAAa,EACrB,YAAY,2BAA2B,EACvC,OAAO,iBAAiB,wBAAwB,EAChD,OAAO,qBAAqB,8BAA8B,MAAM,EAChE,OAAO,SAAS,uBAAuB,EACvC;AAAA,IACC;AAAA,IACA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAWF,EACC;AAAA,IACC,iBAAiB,OAAO,MAAc,YAAyB;AAC7D,YAAM,YAAY,MAAM,OAAO;AAAA,IACjC,CAAC;AAAA,EACH;AAGF,UACG,QAAQ,OAAO,EACf,YAAY,0BAA0B,EACtC,OAAO,yBAAyB,oBAAoB,EACpD,OAAO,oBAAoB,gCAAgC,EAC3D,OAAO,UAAU,gBAAgB,EACjC;AAAA,IACC;AAAA,IACA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAWF,EACC;AAAA,IACC,iBAAiB,OAAO,YAA0B;AAChD,YAAM,aAAa,OAAO;AAAA,IAC5B,CAAC;AAAA,EACH;AAGF,UACG,QAAQ,MAAM,EACd,YAAY,wCAAwC,EACpD;AAAA,IACC;AAAA,IACA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQF,EACC;AAAA,IACC,iBAAiB,YAAY;AAC3B,YAAM,YAAY;AAAA,IACpB,CAAC;AAAA,EACH;AAGF,UACG,QAAQ,QAAQ,EAChB,YAAY,qCAAqC,EACjD,OAAO,UAAU,gBAAgB,EACjC;AAAA,IACC;AAAA,IACA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASF,EACC;AAAA,IACC,iBAAiB,OAAO,YAA2B;AACjD,YAAM,cAAc,OAAO;AAAA,IAC7B,CAAC;AAAA,EACH;AACJ;","names":[]}

package/dist/cli/commands/debug/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/debug/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,oCAAoC;IACpC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iCAAiC;IACjC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,4BAA4B;IAC5B,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,yBAAyB;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qCAAqC;IACrC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qBAAqB;IACrB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,gBAAgB;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,uBAAuB;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,oBAAoB;IACpB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;AAEtD;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,qBAAqB;IACrB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,wBAAwB;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,yBAAyB;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,qBAAqB;IACrB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,0DAA0D;IAC1D,MAAM,EAAE,MAAM,CAAC;IACf,gCAAgC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kCAAkC;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sCAAsC;IACtC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,yCAAyC;IACzC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,0DAA0D;IAC1D,eAAe,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,4CAA4C;IAC5C,aAAa,EAAE,MAAM,CAAC;IACtB,kCAAkC;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,oDAAoD;IACpD,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,uBAAuB;IACvB,IAAI,EAAE,QAAQ,CAAC;IACf,gCAAgC;IAChC,aAAa,EAAE,iBAAiB,CAAC;IACjC,+BAA+B;IAC/B,KAAK,EAAE,WAAW,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,wCAAwC;IACxC,OAAO,EAAE,OAAO,CAAC;IACjB,oCAAoC;IACpC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,0BAA0B;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oCAAoC;IACpC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,8BAA8B;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,cA+B7B,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/debug/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,oCAAoC;IACpC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iCAAiC;IACjC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,4BAA4B;IAC5B,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,yBAAyB;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qCAAqC;IACrC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qBAAqB;IACrB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,gBAAgB;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,uBAAuB;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,oBAAoB;IACpB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;AAEtD;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,qBAAqB;IACrB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,wBAAwB;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,yBAAyB;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,qBAAqB;IACrB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,0DAA0D;IAC1D,MAAM,EAAE,MAAM,CAAC;IACf,gCAAgC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kCAAkC;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sCAAsC;IACtC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,yCAAyC;IACzC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,0DAA0D;IAC1D,eAAe,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,4CAA4C;IAC5C,aAAa,EAAE,MAAM,CAAC;IACtB,kCAAkC;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,oDAAoD;IACpD,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,uBAAuB;IACvB,IAAI,EAAE,QAAQ,CAAC;IACf,gCAAgC;IAChC,aAAa,EAAE,iBAAiB,CAAC;IACjC,+BAA+B;IAC/B,KAAK,EAAE,WAAW,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,wCAAwC;IACxC,OAAO,EAAE,OAAO,CAAC;IACjB,oCAAoC;IACpC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,0BAA0B;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oCAAoC;IACpC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,8BAA8B;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,cAiC7B,CAAC"}

package/dist/cli/commands/debug/types.js

@@ -11,9 +11,11 @@ const TOOL_CATEGORIES = {
     "create_epic",
     "update_epic",
     "list_tickets",
-    "get_ticket",
     "create_ticket",
-    "update_ticket",
+    "ticket_general_actions",
+    "ticket_step_actions",
+    "ticket_criteria_actions",
+    "ticket_test_actions",
     "search_tickets"
   ],
   "Context & AI": [

package/dist/cli/commands/debug/types.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/cli/commands/debug/types.ts"],"sourcesContent":["/**\n * Debug Command Types & Interfaces\n *\n * Type definitions for debug commands including call, tools, test, and whoami.\n */\n\n/**\n * Options for the call command\n */\nexport interface CallOptions {\n  /** Tool arguments as JSON string */\n  args?: string;\n  /** Output format (json, toon) */\n  format?: 'json' | 'toon';\n  /** Show raw API response */\n  raw?: boolean;\n}\n\n/**\n * Options for the tools command\n */\nexport interface ToolsOptions {\n  /** Filter by category */\n  category?: string;\n  /** Search tool names/descriptions */\n  search?: string;\n  /** Output as JSON */\n  json?: boolean;\n}\n\n/**\n * Tool information structure\n */\nexport interface ToolInfo {\n  /** Tool name */\n  name: string;\n  /** Tool description */\n  description: string;\n  /** Tool category */\n  category: string;\n}\n\n/**\n * Tool categories mapping\n */\nexport type ToolCategories = Record<string, string[]>;\n\n/**\n * Options for the whoami command\n */\nexport interface WhoamiOptions {\n  /** Output as JSON */\n  json?: boolean;\n}\n\n/**\n * User information structure\n */\nexport interface UserInfo {\n  /** User display name */\n  name?: string;\n  /** User email address */\n  email: string;\n  /** Masked API key */\n  apiKey: string;\n}\n\n/**\n * Configuration information structure\n */\nexport interface ConfigurationInfo {\n  /** Configuration source (environment, global, project) */\n  source: string;\n  /** Current project ID if set */\n  projectId?: string;\n  /** Current project name if set */\n  projectName?: string;\n  /** Current specification ID if set */\n  specificationId?: string;\n  /** Current specification title if set */\n  specificationTitle?: string;\n  /** Resolved local MCP response encoding (json or toon) */\n  mcpOutputFormat: string;\n}\n\n/**\n * Configuration file paths\n */\nexport interface ConfigPaths {\n  /** Project config path (.specforge.json) */\n  projectConfig: string;\n  /** MCP config path (.mcp.json) */\n  mcpConfig: string;\n  /** Global config path (~/.specforge/config.json) */\n  globalConfig: string;\n}\n\n/**\n * Full whoami information structure\n */\nexport interface WhoamiInfo {\n  /** User information */\n  user: UserInfo;\n  /** Configuration information */\n  configuration: ConfigurationInfo;\n  /** Configuration file paths */\n  paths: ConfigPaths;\n}\n\n/**\n * Test command result\n */\nexport interface TestResult {\n  /** Whether connection was successful */\n  success: boolean;\n  /** Response time in milliseconds */\n  responseTime?: number;\n  /** User email from API */\n  userEmail?: string;\n  /** Number of accessible projects */\n  projectCount?: number;\n  /** Error message if failed */\n  error?: string;\n}\n\n/**\n * Default tool categories\n */\nexport const TOOL_CATEGORIES: ToolCategories = {\n  'Core Operations': [\n    'list_projects',\n    'get_project',\n    'list_specifications',\n    'get_specification',\n    'create_specification',\n    'update_specification',\n    'list_epics',\n    'get_epic',\n    'create_epic',\n    'update_epic',\n    'list_tickets',\n    'get_ticket',\n    'create_ticket',\n    'update_ticket',\n    'search_tickets',\n  ],\n  'Context & AI': [\n    'get_working_context',\n    'set_working_context',\n    'get_implementation_context',\n    'get_full_context',\n    'get_pattern_chain',\n  ],\n  'Sessions & Workflow': [\n    'start_ticket',\n    'complete_ticket',\n    'update_ticket_progress',\n  ],\n  Validation: ['validate_ticket', 'validate_acceptance_criteria'],\n};\n"],"mappings":"AAgIO,MAAM,kBAAkC;AAAA,EAC7C,mBAAmB;AAAA,IACjB;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AAAA,EACA,gBAAgB;AAAA,IACd;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AAAA,EACA,uBAAuB;AAAA,IACrB;AAAA,IACA;AAAA,IACA;AAAA,EACF;AAAA,EACA,YAAY,CAAC,mBAAmB,8BAA8B;AAChE;","names":[]}
+{"version":3,"sources":["../../../../src/cli/commands/debug/types.ts"],"sourcesContent":["/**\n * Debug Command Types & Interfaces\n *\n * Type definitions for debug commands including call, tools, test, and whoami.\n */\n\n/**\n * Options for the call command\n */\nexport interface CallOptions {\n  /** Tool arguments as JSON string */\n  args?: string;\n  /** Output format (json, toon) */\n  format?: 'json' | 'toon';\n  /** Show raw API response */\n  raw?: boolean;\n}\n\n/**\n * Options for the tools command\n */\nexport interface ToolsOptions {\n  /** Filter by category */\n  category?: string;\n  /** Search tool names/descriptions */\n  search?: string;\n  /** Output as JSON */\n  json?: boolean;\n}\n\n/**\n * Tool information structure\n */\nexport interface ToolInfo {\n  /** Tool name */\n  name: string;\n  /** Tool description */\n  description: string;\n  /** Tool category */\n  category: string;\n}\n\n/**\n * Tool categories mapping\n */\nexport type ToolCategories = Record<string, string[]>;\n\n/**\n * Options for the whoami command\n */\nexport interface WhoamiOptions {\n  /** Output as JSON */\n  json?: boolean;\n}\n\n/**\n * User information structure\n */\nexport interface UserInfo {\n  /** User display name */\n  name?: string;\n  /** User email address */\n  email: string;\n  /** Masked API key */\n  apiKey: string;\n}\n\n/**\n * Configuration information structure\n */\nexport interface ConfigurationInfo {\n  /** Configuration source (environment, global, project) */\n  source: string;\n  /** Current project ID if set */\n  projectId?: string;\n  /** Current project name if set */\n  projectName?: string;\n  /** Current specification ID if set */\n  specificationId?: string;\n  /** Current specification title if set */\n  specificationTitle?: string;\n  /** Resolved local MCP response encoding (json or toon) */\n  mcpOutputFormat: string;\n}\n\n/**\n * Configuration file paths\n */\nexport interface ConfigPaths {\n  /** Project config path (.specforge.json) */\n  projectConfig: string;\n  /** MCP config path (.mcp.json) */\n  mcpConfig: string;\n  /** Global config path (~/.specforge/config.json) */\n  globalConfig: string;\n}\n\n/**\n * Full whoami information structure\n */\nexport interface WhoamiInfo {\n  /** User information */\n  user: UserInfo;\n  /** Configuration information */\n  configuration: ConfigurationInfo;\n  /** Configuration file paths */\n  paths: ConfigPaths;\n}\n\n/**\n * Test command result\n */\nexport interface TestResult {\n  /** Whether connection was successful */\n  success: boolean;\n  /** Response time in milliseconds */\n  responseTime?: number;\n  /** User email from API */\n  userEmail?: string;\n  /** Number of accessible projects */\n  projectCount?: number;\n  /** Error message if failed */\n  error?: string;\n}\n\n/**\n * Default tool categories\n */\nexport const TOOL_CATEGORIES: ToolCategories = {\n  'Core Operations': [\n    'list_projects',\n    'get_project',\n    'list_specifications',\n    'get_specification',\n    'create_specification',\n    'update_specification',\n    'list_epics',\n    'get_epic',\n    'create_epic',\n    'update_epic',\n    'list_tickets',\n    'create_ticket',\n    'ticket_general_actions',\n    'ticket_step_actions',\n    'ticket_criteria_actions',\n    'ticket_test_actions',\n    'search_tickets',\n  ],\n  'Context & AI': [\n    'get_working_context',\n    'set_working_context',\n    'get_implementation_context',\n    'get_full_context',\n    'get_pattern_chain',\n  ],\n  'Sessions & Workflow': [\n    'start_ticket',\n    'complete_ticket',\n    'update_ticket_progress',\n  ],\n  Validation: ['validate_ticket', 'validate_acceptance_criteria'],\n};\n"],"mappings":"AAgIO,MAAM,kBAAkC;AAAA,EAC7C,mBAAmB;AAAA,IACjB;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AAAA,EACA,gBAAgB;AAAA,IACd;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AAAA,EACA,uBAAuB;AAAA,IACrB;AAAA,IACA;AAAA,IACA;AAAA,EACF;AAAA,EACA,YAAY,CAAC,mBAAmB,8BAA8B;AAChE;","names":[]}

package/dist/cli/commands/init.types.d.ts

@@ -66,11 +66,11 @@ export declare const STRATEGY_CHOICES: ({
  * and is intentionally excluded here to avoid a duplicate write.
  */
 export declare const SKILL_TEMPLATE_FILES: readonly ["specforge-orchestrator", "specforge-worker", "specforge-validator"];
-import type { SpecificationStatus } from '@specforge/types/schema';
+import type { SpecificationStatus } from '@specforge/spec-types';
 /**
  * Lightweight project shape used by the init command's list/selection flow.
  *
- * Distinct from the canonical runtime `Project` in `@specforge/types/runtime`
+ * Distinct from the canonical `Project` in `@specforge/api-types`
  * — init only needs a subset of fields (name, description, specCount,
  * timestamps) to render chooser UI, so this local shape stays narrow.
  */
@@ -90,8 +90,8 @@ export interface InitProject {
 }
 /**
  * Lightweight specification shape used by the init command's list/selection
- * flow. Distinct from the canonical runtime `Specification` in
- * `@specforge/types/runtime` — init only needs a subset.
+ * flow. Distinct from the canonical `Specification` in
+ * `@specforge/spec-types` — init only needs a subset.
  */
 export interface InitSpecification {
     /** Unique specification identifier */

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

@@ -1 +1 @@
-{"version":3,"file":"init.types.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/init.types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"init.types.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/init.types.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands/init.types.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/cli/commands/init.types.ts"],"sourcesContent":["/**\n * Init Command Types\n *\n * Type definitions for the init command including options,\n * API responses, and selection interfaces.\n */\n\n/**\n * Command line options for init command\n */\nexport interface InitOptions {\n  /** Project ID for non-interactive mode */\n  project?: string;\n\n  /** Specification ID for non-interactive mode, or true when --spec is used without an ID */\n  spec?: string | true;\n\n  /** Output format preference */\n  format?: 'json' | 'toon';\n\n  /** Force overwrite existing config files */\n  force?: boolean;\n\n  /** Show current configuration settings */\n  show?: boolean;\n\n  /** Skip all interactive prompts, use defaults */\n  yes?: boolean;\n\n  /** Switch active specification (quick switch) */\n  specOnly?: boolean;\n}\n\n/**\n * Agent Teams configuration collected during init (v2.0.0).\n * Claude Code Agent Teams only.\n */\nexport interface AgentTeamsInitOptions {\n  /** Whether to configure Agent Teams */\n  enabled: boolean;\n\n  /** Execution strategy */\n  strategy: 'auto' | 'single' | 'parallel' | 'phased';\n\n  /** Max tickets per team (1-20) */\n  maxTicketsPerTeam: number;\n\n  /** Max parallel epics (1-10) */\n  maxParallelEpics: number;\n\n  /** Branch prefix for ticket branches */\n  branchPrefix: string;\n}\n\n/**\n * Strategy choices for Agent Teams init prompt\n */\nexport const STRATEGY_CHOICES = [\n  { name: 'auto (Recommended)', value: 'auto' as const },\n  { name: 'single - Sequential, one worker', value: 'single' as const },\n  { name: 'parallel - All epic teams run concurrently', value: 'parallel' as const },\n  { name: 'phased - Dependency-ordered phases', value: 'phased' as const },\n];\n\n/**\n * Skill names scaffolded into `.claude/skills/<name>/SKILL.md` (the directory\n * form required by Claude Code — see https://code.claude.com/docs/en/skills).\n *\n * The source template lives at `templates/skills/<name>.md` and is written\n * to `<name>/SKILL.md` under the project's `.claude/skills/` directory.\n *\n * `specforge-conventions` is handled by scaffoldMultiCli's writeSkillForTarget\n * and is intentionally excluded here to avoid a duplicate write.\n */\nexport const SKILL_TEMPLATE_FILES = [\n  'specforge-orchestrator',\n  'specforge-worker',\n  'specforge-validator',\n] as const;\n\nimport type { SpecificationStatus } from '@specforge/types/schema';\n\n/**\n * Lightweight project shape used by the init command's list/selection flow.\n *\n * Distinct from the canonical runtime `Project` in `@specforge/types/runtime`\n * — init only needs a subset of fields (name, description, specCount,\n * timestamps) to render chooser UI, so this local shape stays narrow.\n */\nexport interface InitProject {\n  /** Unique project identifier */\n  id: string;\n\n  /** Human-readable project name */\n  name: string;\n\n  /** Optional description */\n  description?: string;\n\n  /** Number of specifications in this project */\n  specCount?: number;\n\n  /** Creation timestamp */\n  createdAt?: string;\n\n  /** Last update timestamp */\n  updatedAt?: string;\n}\n\n/**\n * Lightweight specification shape used by the init command's list/selection\n * flow. Distinct from the canonical runtime `Specification` in\n * `@specforge/types/runtime` — init only needs a subset.\n */\nexport interface InitSpecification {\n  /** Unique specification identifier */\n  id: string;\n\n  /** Specification title */\n  title: string;\n\n  /** Current status */\n  status: SpecificationStatus;\n\n  /** Number of tickets in this specification */\n  ticketCount?: number;\n\n  /** Number of completed tickets */\n  completedTicketCount?: number;\n\n  /** Optional description */\n  description?: string;\n\n  /** Creation timestamp */\n  createdAt?: string;\n\n  /** Last update timestamp */\n  updatedAt?: string;\n}\n\n/**\n * API response for list_projects call\n */\nexport interface ListProjectsResponse {\n  /** List of user's projects */\n  projects: InitProject[];\n\n  /** Total count (for pagination) */\n  total?: number;\n}\n\n/**\n * API response for list_specifications call\n */\nexport interface ListSpecificationsResponse {\n  /** List of specifications for the project */\n  specifications: InitSpecification[];\n\n  /** Total count (for pagination) */\n  total?: number;\n}\n\n/**\n * User's selections during init flow\n */\nexport interface InitSelections {\n  /** Selected project */\n  project: InitProject;\n\n  /** Selected specification (optional) */\n  specification?: InitSpecification;\n\n  /** Selected output format */\n  format: 'json' | 'toon';\n}\n\n/**\n * Result of checking existing config files\n */\nexport interface ExistingFilesCheck {\n  /** Whether .mcp.json exists */\n  mcpConfig: boolean;\n\n  /** Whether .specforge.json exists */\n  projectConfig: boolean;\n\n  /** Whether any file exists */\n  anyExists: boolean;\n}\n\n/**\n * Inquirer choice format for project selection\n */\nexport interface ProjectChoice {\n  /** Display name */\n  name: string;\n\n  /** Project ID value */\n  value: string;\n\n  /** Short name (optional) */\n  short?: string;\n}\n\n/**\n * Inquirer choice format for specification selection\n */\nexport interface SpecificationChoice {\n  /** Display name */\n  name: string;\n\n  /** Specification ID value (undefined for \"none\" option) */\n  value: string | undefined;\n\n  /** Short name (optional) */\n  short?: string;\n}\n\n/**\n * Inquirer choice format for format selection\n */\nexport interface FormatChoice {\n  /** Display name */\n  name: string;\n\n  /** Format value */\n  value: 'json' | 'toon';\n}\n\n/**\n * Format display names with descriptions\n */\nexport const FORMAT_CHOICES: FormatChoice[] = [\n  {\n    name: 'toon (recommended - 44% fewer tokens)',\n    value: 'toon',\n  },\n  {\n    name: 'json (standard JSON format)',\n    value: 'json',\n  },\n];\n\n/**\n * Default format selection\n */\nexport const DEFAULT_FORMAT: 'json' | 'toon' = 'toon';\n"],"mappings":"AAyDO,MAAM,mBAAmB;AAAA,EAC9B,EAAE,MAAM,sBAAsB,OAAO,OAAgB;AAAA,EACrD,EAAE,MAAM,mCAAmC,OAAO,SAAkB;AAAA,EACpE,EAAE,MAAM,8CAA8C,OAAO,WAAoB;AAAA,EACjF,EAAE,MAAM,sCAAsC,OAAO,SAAkB;AACzE;AAYO,MAAM,uBAAuB;AAAA,EAClC;AAAA,EACA;AAAA,EACA;AACF;AA0JO,MAAM,iBAAiC;AAAA,EAC5C;AAAA,IACE,MAAM;AAAA,IACN,OAAO;AAAA,EACT;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,OAAO;AAAA,EACT;AACF;AAKO,MAAM,iBAAkC;","names":[]}
+{"version":3,"sources":["../../../src/cli/commands/init.types.ts"],"sourcesContent":["/**\n * Init Command Types\n *\n * Type definitions for the init command including options,\n * API responses, and selection interfaces.\n */\n\n/**\n * Command line options for init command\n */\nexport interface InitOptions {\n  /** Project ID for non-interactive mode */\n  project?: string;\n\n  /** Specification ID for non-interactive mode, or true when --spec is used without an ID */\n  spec?: string | true;\n\n  /** Output format preference */\n  format?: 'json' | 'toon';\n\n  /** Force overwrite existing config files */\n  force?: boolean;\n\n  /** Show current configuration settings */\n  show?: boolean;\n\n  /** Skip all interactive prompts, use defaults */\n  yes?: boolean;\n\n  /** Switch active specification (quick switch) */\n  specOnly?: boolean;\n}\n\n/**\n * Agent Teams configuration collected during init (v2.0.0).\n * Claude Code Agent Teams only.\n */\nexport interface AgentTeamsInitOptions {\n  /** Whether to configure Agent Teams */\n  enabled: boolean;\n\n  /** Execution strategy */\n  strategy: 'auto' | 'single' | 'parallel' | 'phased';\n\n  /** Max tickets per team (1-20) */\n  maxTicketsPerTeam: number;\n\n  /** Max parallel epics (1-10) */\n  maxParallelEpics: number;\n\n  /** Branch prefix for ticket branches */\n  branchPrefix: string;\n}\n\n/**\n * Strategy choices for Agent Teams init prompt\n */\nexport const STRATEGY_CHOICES = [\n  { name: 'auto (Recommended)', value: 'auto' as const },\n  { name: 'single - Sequential, one worker', value: 'single' as const },\n  { name: 'parallel - All epic teams run concurrently', value: 'parallel' as const },\n  { name: 'phased - Dependency-ordered phases', value: 'phased' as const },\n];\n\n/**\n * Skill names scaffolded into `.claude/skills/<name>/SKILL.md` (the directory\n * form required by Claude Code — see https://code.claude.com/docs/en/skills).\n *\n * The source template lives at `templates/skills/<name>.md` and is written\n * to `<name>/SKILL.md` under the project's `.claude/skills/` directory.\n *\n * `specforge-conventions` is handled by scaffoldMultiCli's writeSkillForTarget\n * and is intentionally excluded here to avoid a duplicate write.\n */\nexport const SKILL_TEMPLATE_FILES = [\n  'specforge-orchestrator',\n  'specforge-worker',\n  'specforge-validator',\n] as const;\n\nimport type { SpecificationStatus } from '@specforge/spec-types';\n\n/**\n * Lightweight project shape used by the init command's list/selection flow.\n *\n * Distinct from the canonical `Project` in `@specforge/api-types`\n * — init only needs a subset of fields (name, description, specCount,\n * timestamps) to render chooser UI, so this local shape stays narrow.\n */\nexport interface InitProject {\n  /** Unique project identifier */\n  id: string;\n\n  /** Human-readable project name */\n  name: string;\n\n  /** Optional description */\n  description?: string;\n\n  /** Number of specifications in this project */\n  specCount?: number;\n\n  /** Creation timestamp */\n  createdAt?: string;\n\n  /** Last update timestamp */\n  updatedAt?: string;\n}\n\n/**\n * Lightweight specification shape used by the init command's list/selection\n * flow. Distinct from the canonical `Specification` in\n * `@specforge/spec-types` — init only needs a subset.\n */\nexport interface InitSpecification {\n  /** Unique specification identifier */\n  id: string;\n\n  /** Specification title */\n  title: string;\n\n  /** Current status */\n  status: SpecificationStatus;\n\n  /** Number of tickets in this specification */\n  ticketCount?: number;\n\n  /** Number of completed tickets */\n  completedTicketCount?: number;\n\n  /** Optional description */\n  description?: string;\n\n  /** Creation timestamp */\n  createdAt?: string;\n\n  /** Last update timestamp */\n  updatedAt?: string;\n}\n\n/**\n * API response for list_projects call\n */\nexport interface ListProjectsResponse {\n  /** List of user's projects */\n  projects: InitProject[];\n\n  /** Total count (for pagination) */\n  total?: number;\n}\n\n/**\n * API response for list_specifications call\n */\nexport interface ListSpecificationsResponse {\n  /** List of specifications for the project */\n  specifications: InitSpecification[];\n\n  /** Total count (for pagination) */\n  total?: number;\n}\n\n/**\n * User's selections during init flow\n */\nexport interface InitSelections {\n  /** Selected project */\n  project: InitProject;\n\n  /** Selected specification (optional) */\n  specification?: InitSpecification;\n\n  /** Selected output format */\n  format: 'json' | 'toon';\n}\n\n/**\n * Result of checking existing config files\n */\nexport interface ExistingFilesCheck {\n  /** Whether .mcp.json exists */\n  mcpConfig: boolean;\n\n  /** Whether .specforge.json exists */\n  projectConfig: boolean;\n\n  /** Whether any file exists */\n  anyExists: boolean;\n}\n\n/**\n * Inquirer choice format for project selection\n */\nexport interface ProjectChoice {\n  /** Display name */\n  name: string;\n\n  /** Project ID value */\n  value: string;\n\n  /** Short name (optional) */\n  short?: string;\n}\n\n/**\n * Inquirer choice format for specification selection\n */\nexport interface SpecificationChoice {\n  /** Display name */\n  name: string;\n\n  /** Specification ID value (undefined for \"none\" option) */\n  value: string | undefined;\n\n  /** Short name (optional) */\n  short?: string;\n}\n\n/**\n * Inquirer choice format for format selection\n */\nexport interface FormatChoice {\n  /** Display name */\n  name: string;\n\n  /** Format value */\n  value: 'json' | 'toon';\n}\n\n/**\n * Format display names with descriptions\n */\nexport const FORMAT_CHOICES: FormatChoice[] = [\n  {\n    name: 'toon (recommended - 44% fewer tokens)',\n    value: 'toon',\n  },\n  {\n    name: 'json (standard JSON format)',\n    value: 'json',\n  },\n];\n\n/**\n * Default format selection\n */\nexport const DEFAULT_FORMAT: 'json' | 'toon' = 'toon';\n"],"mappings":"AAyDO,MAAM,mBAAmB;AAAA,EAC9B,EAAE,MAAM,sBAAsB,OAAO,OAAgB;AAAA,EACrD,EAAE,MAAM,mCAAmC,OAAO,SAAkB;AAAA,EACpE,EAAE,MAAM,8CAA8C,OAAO,WAAoB;AAAA,EACjF,EAAE,MAAM,sCAAsC,OAAO,SAAkB;AACzE;AAYO,MAAM,uBAAuB;AAAA,EAClC;AAAA,EACA;AAAA,EACA;AACF;AA0JO,MAAM,iBAAiC;AAAA,EAC5C;AAAA,IACE,MAAM;AAAA,IACN,OAAO;AAAA,EACT;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,OAAO;AAAA,EACT;AACF;AAKO,MAAM,iBAAkC;","names":[]}

package/dist/cli/commands/scaffold/agent-types.js

@@ -1,6 +1,6 @@
 const AGENT_CATEGORIES = {
   Orchestration: ["sfag-orchestrator"],
-  SpecForge: ["sfag-spec-creator", "sfag-ticket-implementer"],
+  SpecForge: ["sfag-spec-creator", "sfag-ticket-implementer", "sfag-work-resolver"],
   Research: ["sfag-package-researcher"]
 };
 function getAgentCategoryNames() {

package/dist/cli/commands/scaffold/agent-types.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/cli/commands/scaffold/agent-types.ts"],"sourcesContent":["/**\n * Agent Scaffolding Types & Interfaces\n *\n * Type definitions for AI agent scaffolding in Claude Code and other AI tools.\n */\n\nexport type AgentCategory =\n  | 'Orchestration'\n  | 'SpecForge'\n  | 'Research';\n\n/**\n * Agent model options\n */\nexport type AgentModel = 'opus' | 'sonnet' | 'haiku';\n\n/**\n * Supported colors for agent display\n */\nexport type AgentColor =\n  | 'red'\n  | 'yellow'\n  | 'green'\n  | 'cyan'\n  | 'blue'\n  | 'magenta'\n  | 'white'\n  | 'gray';\n\n/**\n * Persistent memory scope for the agent. Maps to Claude Code's `memory:`\n * frontmatter field, which triggers Claude Code to inject the persistent\n * memory system prompt and create the matching agent-memory directory:\n *   - `project` → `.claude/agent-memory/<name>/`\n *   - `user`    → `~/.claude/agent-memory/<name>/`\n *   - `local`   → `.claude/agent-memory-local/<name>/`\n */\nexport type AgentMemory = 'project' | 'user' | 'local';\n\n/**\n * Agent template definition\n */\nexport interface AgentTemplate {\n  /** Agent name (e.g., 'sfag-orchestrator') */\n  name: string;\n  /** Short description for agent list */\n  description: string;\n  /** Full description with trigger examples for frontmatter */\n  triggerDescription: string;\n  /** AI model to use for this agent */\n  model: AgentModel;\n  /** Color for agent display */\n  color: AgentColor;\n  /** Full markdown content of the agent */\n  content: string;\n  /** Agent category for grouping */\n  category: AgentCategory;\n  /** Persistent memory scope (Claude Code only) */\n  memory?: AgentMemory;\n}\n\nexport const AGENT_CATEGORIES: Record<AgentCategory, string[]> = {\n  Orchestration: ['sfag-orchestrator'],\n  SpecForge: ['sfag-spec-creator', 'sfag-ticket-implementer'],\n  Research: ['sfag-package-researcher'],\n};\n\n/**\n * Get all agent category names\n */\nexport function getAgentCategoryNames(): AgentCategory[] {\n  return Object.keys(AGENT_CATEGORIES) as AgentCategory[];\n}\n\n/**\n * Model display badges for CLI output\n */\nexport const MODEL_BADGES: Record<AgentModel, string> = {\n  opus: '◆',    // Diamond for opus (powerful)\n  sonnet: '●',  // Circle for sonnet (balanced)\n  haiku: '○',   // Empty circle for haiku (fast)\n};\n"],"mappings":"AA6DO,MAAM,mBAAoD;AAAA,EAC/D,eAAe,CAAC,mBAAmB;AAAA,EACnC,WAAW,CAAC,qBAAqB,yBAAyB;AAAA,EAC1D,UAAU,CAAC,yBAAyB;AACtC;AAKO,SAAS,wBAAyC;AACvD,SAAO,OAAO,KAAK,gBAAgB;AACrC;AAKO,MAAM,eAA2C;AAAA,EACtD,MAAM;AAAA;AAAA,EACN,QAAQ;AAAA;AAAA,EACR,OAAO;AAAA;AACT;","names":[]}
+{"version":3,"sources":["../../../../src/cli/commands/scaffold/agent-types.ts"],"sourcesContent":["/**\n * Agent Scaffolding Types & Interfaces\n *\n * Type definitions for AI agent scaffolding in Claude Code and other AI tools.\n */\n\nexport type AgentCategory =\n  | 'Orchestration'\n  | 'SpecForge'\n  | 'Research';\n\n/**\n * Agent model options\n */\nexport type AgentModel = 'opus' | 'sonnet' | 'haiku';\n\n/**\n * Supported colors for agent display\n */\nexport type AgentColor =\n  | 'red'\n  | 'yellow'\n  | 'green'\n  | 'cyan'\n  | 'blue'\n  | 'magenta'\n  | 'white'\n  | 'gray';\n\n/**\n * Persistent memory scope for the agent. Maps to Claude Code's `memory:`\n * frontmatter field, which triggers Claude Code to inject the persistent\n * memory system prompt and create the matching agent-memory directory:\n *   - `project` → `.claude/agent-memory/<name>/`\n *   - `user`    → `~/.claude/agent-memory/<name>/`\n *   - `local`   → `.claude/agent-memory-local/<name>/`\n */\nexport type AgentMemory = 'project' | 'user' | 'local';\n\n/**\n * Agent template definition\n */\nexport interface AgentTemplate {\n  /** Agent name (e.g., 'sfag-orchestrator') */\n  name: string;\n  /** Short description for agent list */\n  description: string;\n  /** Full description with trigger examples for frontmatter */\n  triggerDescription: string;\n  /** AI model to use for this agent */\n  model: AgentModel;\n  /** Color for agent display */\n  color: AgentColor;\n  /** Full markdown content of the agent */\n  content: string;\n  /** Agent category for grouping */\n  category: AgentCategory;\n  /** Persistent memory scope (Claude Code only) */\n  memory?: AgentMemory;\n}\n\nexport const AGENT_CATEGORIES: Record<AgentCategory, string[]> = {\n  Orchestration: ['sfag-orchestrator'],\n  SpecForge: ['sfag-spec-creator', 'sfag-ticket-implementer', 'sfag-work-resolver'],\n  Research: ['sfag-package-researcher'],\n};\n\n/**\n * Get all agent category names\n */\nexport function getAgentCategoryNames(): AgentCategory[] {\n  return Object.keys(AGENT_CATEGORIES) as AgentCategory[];\n}\n\n/**\n * Model display badges for CLI output\n */\nexport const MODEL_BADGES: Record<AgentModel, string> = {\n  opus: '◆',    // Diamond for opus (powerful)\n  sonnet: '●',  // Circle for sonnet (balanced)\n  haiku: '○',   // Empty circle for haiku (fast)\n};\n"],"mappings":"AA6DO,MAAM,mBAAoD;AAAA,EAC/D,eAAe,CAAC,mBAAmB;AAAA,EACnC,WAAW,CAAC,qBAAqB,2BAA2B,oBAAoB;AAAA,EAChF,UAAU,CAAC,yBAAyB;AACtC;AAKO,SAAS,wBAAyC;AACvD,SAAO,OAAO,KAAK,gBAAgB;AACrC;AAKO,MAAM,eAA2C;AAAA,EACtD,MAAM;AAAA;AAAA,EACN,QAAQ;AAAA;AAAA,EACR,OAAO;AAAA;AACT;","names":[]}

package/dist/cli/config/agent-teams.types.d.ts

@@ -6,8 +6,20 @@
  * existing ProjectConfig without breaking backward compatibility.
  *
  * Agent Teams is the Claude Code-specific orchestration layer that uses
- * Claude Code primitives (TeamCreate, TaskCreate, SendMessage, etc.)
- * to coordinate parallel ticket implementation.
+ * Claude Code primitives (TeamCreate, TaskCreate, SendMessage, etc.) to
+ * coordinate the AUTONOMOUS MULTI-AGENT work model: the sfag-orchestrator
+ * dispatches N concurrent sfag-ticket-implementer workers — one per `ready`
+ * ticket, respecting the dependency graph — and each worker opens its own
+ * WorkSession under ONE spec-wide ImplementationSession (the first
+ * start_work_session creates it, first-write-wins). These settings bound that
+ * fleet (concurrency, per-team size, branch isolation, per-worker timeout).
+ *
+ * There is NO review/dismissal coordination in the work chain — the review
+ * lifecycle is dormant, so a worker self-completes through the CWS gates.
+ * Blockers/discoveries are RECORDED by workers and handed to the
+ * sfag-work-resolver agent (the human's resolve_discovery in the web app
+ * unblocks a blocking discovery). Accordingly, the pre-v2.0.0 validation /
+ * escalation fields (see {@link DEPRECATED_AGENT_TEAMS_FIELDS}) are gone.
  *
  * @see specforge-agent-teams-spec.md (v2.0.0)
  */
@@ -15,10 +27,16 @@ import type { ProjectConfig } from './types.js';
 /**
  * Execution strategy for Agent Teams (Claude Code specific).
  *
- * - `auto`     – Analyzer picks based on spec structure (default)
+ * All strategies dispatch autonomous sfag-ticket-implementer workers over the
+ * spec's `ready` tickets, respecting the dependency graph (DAG). They differ
+ * only in how much of the DAG runs concurrently:
+ *
+ * - `auto`     – Orchestrator picks based on the DAG shape (default): parallel
+ *                when ready tickets are independent, phased when there are
+ *                cross-epic dependencies
  * - `single`   – Sequential, one worker at a time (<=3 tickets, no epic deps)
- * - `parallel` – All epic teams run concurrently (independent epics)
- * - `phased`   – Epics run in dependency-ordered phases (cross-epic deps)
+ * - `parallel` – Independent epics run concurrently (one worker per ready ticket)
+ * - `phased`   – The DAG runs in dependency-ordered phases (cross-epic deps)
  *
  * @see specforge-agent-teams-spec.md Section 4.3
  */
@@ -45,12 +63,14 @@ export interface ActiveSpecification {
 /**
  * Agent Teams execution settings (Claude Code specific).
  *
- * Controls how Agent Teams orchestrate spec implementation.
- * All fields are optional — sensible defaults are applied.
+ * Bounds the autonomous worker fleet the orchestrator dispatches over the
+ * spec's `ready` tickets (concurrency, per-team size, branch isolation, and
+ * per-worker timeout). All fields are optional — sensible defaults are applied.
  *
  * v2.0.0 simplified to 6 fields. Previous fields (maxTokensPerWorker,
  * branchPattern, autoValidate, validationCommands, escalationPolicy,
- * monorepo) are ignored on read and stripped on write.
+ * monorepo) are ignored on read and stripped on write — the review/validation
+ * lifecycle is dormant, so there is nothing to auto-validate or escalate.
  *
  * @see specforge-agent-teams-spec.md Section 9.1
  */
@@ -61,22 +81,25 @@ export interface AgentTeamsConfig {
      */
     enabled?: boolean;
     /**
-     * Execution strategy selection.
+     * Execution strategy selection (how much of the DAG runs concurrently).
      * @default "auto"
      */
     strategy?: AgentTeamsStrategy;
     /**
-     * Maximum tickets assigned to a single team (1-20).
+     * Maximum tickets (WorkSessions) assigned to a single epic team (1-20).
      * @default 10
      */
     maxTicketsPerTeam?: number;
     /**
-     * Maximum number of epics running in parallel (1-10).
+     * Maximum number of epic teams running in parallel (1-10). Caps how many
+     * concurrent workers the orchestrator keeps in flight across epics.
      * @default 3
      */
     maxParallelEpics?: number;
     /**
-     * Git branch naming prefix.
+     * Git branch naming prefix. Each worker gets its own worktree/branch off
+     * this prefix so concurrent WorkSessions don't collide on the git-clean
+     * precondition.
      * @default "ticket/"
      */
     branchPrefix?: string;

package/dist/cli/config/agent-teams.types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-teams.types.d.ts","sourceRoot":"","sources":["../../../src/cli/config/agent-teams.types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAMhD;;;;;;;;;GASG;AACH,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,QAAQ,GAAG,UAAU,GAAG,QAAQ,CAAC;AAM3E;;;;;;;GAOG;AACH,MAAM,WAAW,mBAAmB;IAClC,mCAAmC;IACnC,EAAE,EAAE,MAAM,CAAC;IAEX,8CAA8C;IAC9C,KAAK,EAAE,MAAM,CAAC;IAEd;;;OAGG;IACH,WAAW,EAAE,MAAM,CAAC;CACrB;AAMD;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;OAGG;IACH,QAAQ,CAAC,EAAE,kBAAkB,CAAC;IAE9B;;;OAGG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAMD;;;;;;GAMG;AACH,MAAM,WAAW,mBAAoB,SAAQ,aAAa;IACxD,sEAAsE;IACtE,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;IAE1C,4DAA4D;IAC5D,UAAU,CAAC,EAAE,gBAAgB,CAAC;CAC/B;AAMD;;;;GAIG;AACH,eAAO,MAAM,oBAAoB;;uBAEX,kBAAkB;;;;;CAK9B,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,6BAA6B,iKAShC,CAAC"}
+{"version":3,"file":"agent-teams.types.d.ts","sourceRoot":"","sources":["../../../src/cli/config/agent-teams.types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAMhD;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,QAAQ,GAAG,UAAU,GAAG,QAAQ,CAAC;AAM3E;;;;;;;GAOG;AACH,MAAM,WAAW,mBAAmB;IAClC,mCAAmC;IACnC,EAAE,EAAE,MAAM,CAAC;IAEX,8CAA8C;IAC9C,KAAK,EAAE,MAAM,CAAC;IAEd;;;OAGG;IACH,WAAW,EAAE,MAAM,CAAC;CACrB;AAMD;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;OAGG;IACH,QAAQ,CAAC,EAAE,kBAAkB,CAAC;IAE9B;;;OAGG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B;;;;;OAKG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAMD;;;;;;GAMG;AACH,MAAM,WAAW,mBAAoB,SAAQ,aAAa;IACxD,sEAAsE;IACtE,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;IAE1C,4DAA4D;IAC5D,UAAU,CAAC,EAAE,gBAAgB,CAAC;CAC/B;AAMD;;;;GAIG;AACH,eAAO,MAAM,oBAAoB;;uBAEX,kBAAkB;;;;;CAK9B,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,6BAA6B,iKAShC,CAAC"}

package/dist/cli/config/agent-teams.types.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/cli/config/agent-teams.types.ts"],"sourcesContent":["/**\n * Agent Teams Configuration Types — Claude Code specific\n *\n * Defines interfaces for the Agent Teams integration sections\n * of the .specforge/config.json configuration file. These extend the\n * existing ProjectConfig without breaking backward compatibility.\n *\n * Agent Teams is the Claude Code-specific orchestration layer that uses\n * Claude Code primitives (TeamCreate, TaskCreate, SendMessage, etc.)\n * to coordinate parallel ticket implementation.\n *\n * @see specforge-agent-teams-spec.md (v2.0.0)\n */\n\nimport type { ProjectConfig } from './types.js';\n\n// ---------------------------------------------------------------------------\n// Literal union types\n// ---------------------------------------------------------------------------\n\n/**\n * Execution strategy for Agent Teams (Claude Code specific).\n *\n * - `auto`     – Analyzer picks based on spec structure (default)\n * - `single`   – Sequential, one worker at a time (<=3 tickets, no epic deps)\n * - `parallel` – All epic teams run concurrently (independent epics)\n * - `phased`   – Epics run in dependency-ordered phases (cross-epic deps)\n *\n * @see specforge-agent-teams-spec.md Section 4.3\n */\nexport type AgentTeamsStrategy = 'auto' | 'single' | 'parallel' | 'phased';\n\n// ---------------------------------------------------------------------------\n// ActiveSpecification\n// ---------------------------------------------------------------------------\n\n/**\n * Currently active specification for Agent Teams implementation (Claude Code specific).\n *\n * Set automatically by `specforge spec activate`. Tells the Agent Teams Lead\n * which specification to work on at startup.\n *\n * @see specforge-agent-teams-spec.md Section 4.2 (LOAD step)\n */\nexport interface ActiveSpecification {\n  /** SpecForge specification UUID */\n  id: string;\n\n  /** Human-readable spec title (for display) */\n  title: string;\n\n  /**\n   * ISO 8601 timestamp of activation.\n   * Set automatically by `specforge spec activate`.\n   */\n  activatedAt: string;\n}\n\n// ---------------------------------------------------------------------------\n// AgentTeamsConfig (v2.0.0)\n// ---------------------------------------------------------------------------\n\n/**\n * Agent Teams execution settings (Claude Code specific).\n *\n * Controls how Agent Teams orchestrate spec implementation.\n * All fields are optional — sensible defaults are applied.\n *\n * v2.0.0 simplified to 6 fields. Previous fields (maxTokensPerWorker,\n * branchPattern, autoValidate, validationCommands, escalationPolicy,\n * monorepo) are ignored on read and stripped on write.\n *\n * @see specforge-agent-teams-spec.md Section 9.1\n */\nexport interface AgentTeamsConfig {\n  /**\n   * Master toggle for Agent Teams.\n   * @default false\n   */\n  enabled?: boolean;\n\n  /**\n   * Execution strategy selection.\n   * @default \"auto\"\n   */\n  strategy?: AgentTeamsStrategy;\n\n  /**\n   * Maximum tickets assigned to a single team (1-20).\n   * @default 10\n   */\n  maxTicketsPerTeam?: number;\n\n  /**\n   * Maximum number of epics running in parallel (1-10).\n   * @default 3\n   */\n  maxParallelEpics?: number;\n\n  /**\n   * Git branch naming prefix.\n   * @default \"ticket/\"\n   */\n  branchPrefix?: string;\n\n  /**\n   * Per-worker timeout in minutes (5-60).\n   * @default 15\n   */\n  timeoutMinutes?: number;\n}\n\n// ---------------------------------------------------------------------------\n// Extended .specforge/config.json\n// ---------------------------------------------------------------------------\n\n/**\n * Extended .specforge/config.json configuration with Agent Teams support.\n *\n * Extends the existing {@link ProjectConfig} with optional sections\n * for Agent Teams integration (Claude Code specific). All new fields\n * are optional to maintain full backward compatibility.\n */\nexport interface SpecforgeJsonConfig extends ProjectConfig {\n  /** Currently active specification for implementation (Agent Teams) */\n  activeSpecification?: ActiveSpecification;\n\n  /** Agent Teams execution settings (Claude Code specific) */\n  agentTeams?: AgentTeamsConfig;\n}\n\n// ---------------------------------------------------------------------------\n// Defaults (v2.0.0)\n// ---------------------------------------------------------------------------\n\n/**\n * Default values for AgentTeamsConfig fields (v2.0.0).\n *\n * @see specforge-agent-teams-spec.md Section 9.1\n */\nexport const AGENT_TEAMS_DEFAULTS = {\n  enabled: false,\n  strategy: 'auto' as AgentTeamsStrategy,\n  maxTicketsPerTeam: 10,\n  maxParallelEpics: 3,\n  branchPrefix: 'ticket/',\n  timeoutMinutes: 15,\n} as const;\n\n/**\n * Fields that existed pre-v2.0.0 and should be stripped on config write.\n * These are silently ignored on read for backward compatibility.\n */\nexport const DEPRECATED_AGENT_TEAMS_FIELDS = [\n  'maxParallelTeams',\n  'maxTokensPerWorker',\n  'branchPattern',\n  'autoValidate',\n  'validationCommands',\n  'escalationPolicy',\n  'maxWorkersPerTeam',\n  'monorepo',\n] as const;\n"],"mappings":"AA4IO,MAAM,uBAAuB;AAAA,EAClC,SAAS;AAAA,EACT,UAAU;AAAA,EACV,mBAAmB;AAAA,EACnB,kBAAkB;AAAA,EAClB,cAAc;AAAA,EACd,gBAAgB;AAClB;AAMO,MAAM,gCAAgC;AAAA,EAC3C;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;","names":[]}
+{"version":3,"sources":["../../../src/cli/config/agent-teams.types.ts"],"sourcesContent":["/**\n * Agent Teams Configuration Types — Claude Code specific\n *\n * Defines interfaces for the Agent Teams integration sections\n * of the .specforge/config.json configuration file. These extend the\n * existing ProjectConfig without breaking backward compatibility.\n *\n * Agent Teams is the Claude Code-specific orchestration layer that uses\n * Claude Code primitives (TeamCreate, TaskCreate, SendMessage, etc.) to\n * coordinate the AUTONOMOUS MULTI-AGENT work model: the sfag-orchestrator\n * dispatches N concurrent sfag-ticket-implementer workers — one per `ready`\n * ticket, respecting the dependency graph — and each worker opens its own\n * WorkSession under ONE spec-wide ImplementationSession (the first\n * start_work_session creates it, first-write-wins). These settings bound that\n * fleet (concurrency, per-team size, branch isolation, per-worker timeout).\n *\n * There is NO review/dismissal coordination in the work chain — the review\n * lifecycle is dormant, so a worker self-completes through the CWS gates.\n * Blockers/discoveries are RECORDED by workers and handed to the\n * sfag-work-resolver agent (the human's resolve_discovery in the web app\n * unblocks a blocking discovery). Accordingly, the pre-v2.0.0 validation /\n * escalation fields (see {@link DEPRECATED_AGENT_TEAMS_FIELDS}) are gone.\n *\n * @see specforge-agent-teams-spec.md (v2.0.0)\n */\n\nimport type { ProjectConfig } from './types.js';\n\n// ---------------------------------------------------------------------------\n// Literal union types\n// ---------------------------------------------------------------------------\n\n/**\n * Execution strategy for Agent Teams (Claude Code specific).\n *\n * All strategies dispatch autonomous sfag-ticket-implementer workers over the\n * spec's `ready` tickets, respecting the dependency graph (DAG). They differ\n * only in how much of the DAG runs concurrently:\n *\n * - `auto`     – Orchestrator picks based on the DAG shape (default): parallel\n *                when ready tickets are independent, phased when there are\n *                cross-epic dependencies\n * - `single`   – Sequential, one worker at a time (<=3 tickets, no epic deps)\n * - `parallel` – Independent epics run concurrently (one worker per ready ticket)\n * - `phased`   – The DAG runs in dependency-ordered phases (cross-epic deps)\n *\n * @see specforge-agent-teams-spec.md Section 4.3\n */\nexport type AgentTeamsStrategy = 'auto' | 'single' | 'parallel' | 'phased';\n\n// ---------------------------------------------------------------------------\n// ActiveSpecification\n// ---------------------------------------------------------------------------\n\n/**\n * Currently active specification for Agent Teams implementation (Claude Code specific).\n *\n * Set automatically by `specforge spec activate`. Tells the Agent Teams Lead\n * which specification to work on at startup.\n *\n * @see specforge-agent-teams-spec.md Section 4.2 (LOAD step)\n */\nexport interface ActiveSpecification {\n  /** SpecForge specification UUID */\n  id: string;\n\n  /** Human-readable spec title (for display) */\n  title: string;\n\n  /**\n   * ISO 8601 timestamp of activation.\n   * Set automatically by `specforge spec activate`.\n   */\n  activatedAt: string;\n}\n\n// ---------------------------------------------------------------------------\n// AgentTeamsConfig (v2.0.0)\n// ---------------------------------------------------------------------------\n\n/**\n * Agent Teams execution settings (Claude Code specific).\n *\n * Bounds the autonomous worker fleet the orchestrator dispatches over the\n * spec's `ready` tickets (concurrency, per-team size, branch isolation, and\n * per-worker timeout). All fields are optional — sensible defaults are applied.\n *\n * v2.0.0 simplified to 6 fields. Previous fields (maxTokensPerWorker,\n * branchPattern, autoValidate, validationCommands, escalationPolicy,\n * monorepo) are ignored on read and stripped on write — the review/validation\n * lifecycle is dormant, so there is nothing to auto-validate or escalate.\n *\n * @see specforge-agent-teams-spec.md Section 9.1\n */\nexport interface AgentTeamsConfig {\n  /**\n   * Master toggle for Agent Teams.\n   * @default false\n   */\n  enabled?: boolean;\n\n  /**\n   * Execution strategy selection (how much of the DAG runs concurrently).\n   * @default \"auto\"\n   */\n  strategy?: AgentTeamsStrategy;\n\n  /**\n   * Maximum tickets (WorkSessions) assigned to a single epic team (1-20).\n   * @default 10\n   */\n  maxTicketsPerTeam?: number;\n\n  /**\n   * Maximum number of epic teams running in parallel (1-10). Caps how many\n   * concurrent workers the orchestrator keeps in flight across epics.\n   * @default 3\n   */\n  maxParallelEpics?: number;\n\n  /**\n   * Git branch naming prefix. Each worker gets its own worktree/branch off\n   * this prefix so concurrent WorkSessions don't collide on the git-clean\n   * precondition.\n   * @default \"ticket/\"\n   */\n  branchPrefix?: string;\n\n  /**\n   * Per-worker timeout in minutes (5-60).\n   * @default 15\n   */\n  timeoutMinutes?: number;\n}\n\n// ---------------------------------------------------------------------------\n// Extended .specforge/config.json\n// ---------------------------------------------------------------------------\n\n/**\n * Extended .specforge/config.json configuration with Agent Teams support.\n *\n * Extends the existing {@link ProjectConfig} with optional sections\n * for Agent Teams integration (Claude Code specific). All new fields\n * are optional to maintain full backward compatibility.\n */\nexport interface SpecforgeJsonConfig extends ProjectConfig {\n  /** Currently active specification for implementation (Agent Teams) */\n  activeSpecification?: ActiveSpecification;\n\n  /** Agent Teams execution settings (Claude Code specific) */\n  agentTeams?: AgentTeamsConfig;\n}\n\n// ---------------------------------------------------------------------------\n// Defaults (v2.0.0)\n// ---------------------------------------------------------------------------\n\n/**\n * Default values for AgentTeamsConfig fields (v2.0.0).\n *\n * @see specforge-agent-teams-spec.md Section 9.1\n */\nexport const AGENT_TEAMS_DEFAULTS = {\n  enabled: false,\n  strategy: 'auto' as AgentTeamsStrategy,\n  maxTicketsPerTeam: 10,\n  maxParallelEpics: 3,\n  branchPrefix: 'ticket/',\n  timeoutMinutes: 15,\n} as const;\n\n/**\n * Fields that existed pre-v2.0.0 and should be stripped on config write.\n * These are silently ignored on read for backward compatibility.\n */\nexport const DEPRECATED_AGENT_TEAMS_FIELDS = [\n  'maxParallelTeams',\n  'maxTokensPerWorker',\n  'branchPattern',\n  'autoValidate',\n  'validationCommands',\n  'escalationPolicy',\n  'maxWorkersPerTeam',\n  'monorepo',\n] as const;\n"],"mappings":"AAmKO,MAAM,uBAAuB;AAAA,EAClC,SAAS;AAAA,EACT,UAAU;AAAA,EACV,mBAAmB;AAAA,EACnB,kBAAkB;AAAA,EAClB,cAAc;AAAA,EACd,gBAAgB;AAClB;AAMO,MAAM,gCAAgC;AAAA,EAC3C;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;","names":[]}

package/dist/cli/templates/agents/content/core/sfag-orchestrator.d.ts

@@ -1,8 +1,26 @@
 /**
- * SFAG-Orchestrator Agent Template v2
+ * SFAG-Orchestrator Agent Template v3 (M23.5)
  *
- * Strategic task decomposition with concrete decision trees.
- * Knows when to delegate, to whom, and in what order.
+ * Coordinates the AUTONOMOUS MULTI-AGENT work model:
+ *
+ *  - N concurrent sfag-ticket-implementer workers → N WorkSessions under ONE
+ *    spec-wide ImplementationSession. The FIRST worker's start_work_session
+ *    creates that ImplementationSession (first-write-wins); every later SWS
+ *    attaches its WorkSession to the same session.
+ *  - The orchestrator assigns tickets respecting the DAG (dependency-free
+ *    `ready` tickets only) and dispatches workers up to the configured
+ *    concurrency; as tickets reach `done`, the readiness cascade unblocks
+ *    dependents and the orchestrator dispatches the newly-ready.
+ *  - There is NO review/dismissal coordination in the work chain (the review
+ *    lifecycle is dormant). Blockers/discoveries are RECORDED by workers and
+ *    handed to the sfag-work-resolver agent (human-in-the-loop); the human's
+ *    `resolve_discovery` (web app) unblocks a blocking discovery.
+ *
+ * The orchestrator uses only SHIPPED read ops (get_dependency_tree,
+ * get_critical_path, get_next_actionable_tickets, get_implementation_status,
+ * get_blocked_tickets, get_pending_discoveries). The agent-teams ops
+ * (get_epic_dependency_graph, get_implementation_plan, report_completion) are
+ * deferred to 0.2.0+ and are NOT referenced here.
  */
 import type { AgentTemplate } from '../../../../commands/scaffold/agent-types.js';
 export declare const SFAG_ORCHESTRATOR: AgentTemplate;

package/dist/cli/templates/agents/content/core/sfag-orchestrator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sfag-orchestrator.d.ts","sourceRoot":"","sources":["../../../../../../src/cli/templates/agents/content/core/sfag-orchestrator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8CAA8C,CAAC;AAElF,eAAO,MAAM,iBAAiB,EAAE,aA2J/B,CAAC"}
+{"version":3,"file":"sfag-orchestrator.d.ts","sourceRoot":"","sources":["../../../../../../src/cli/templates/agents/content/core/sfag-orchestrator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8CAA8C,CAAC;AAElF,eAAO,MAAM,iBAAiB,EAAE,aA6N/B,CAAC"}