@bradygaster/squad-sdk 0.8.25 → 0.9.1

package/dist/config/init.js

@@ -13,6 +13,7 @@ import { fileURLToPath } from 'url';
 import { existsSync, cpSync, statSync, mkdirSync, readFileSync, readdirSync } from 'fs';
 import { execFileSync } from 'node:child_process';
 import { MODELS } from '../runtime/constants.js';
+import { getRoleById } from '../roles/index.js';
 // ============================================================================
 // Template Resolution
 // ============================================================================
@@ -94,82 +95,82 @@ function formatModelArray(chain) {
  */
 function generateTypeScriptConfig(options) {
     const { projectName, projectDescription, agents } = options;
-    return `import type { SquadConfig } from '@bradygaster/squad';
-
-/**
- * Squad Configuration for ${projectName}
- * ${projectDescription ? `\n * ${projectDescription}` : ''}
- */
-const config: SquadConfig = {
-  version: '1.0.0',
-  
-  models: {
-    defaultModel: '${MODELS.DEFAULT}',
-    defaultTier: 'standard',
-    fallbackChains: {
-      premium: ${formatModelArray(MODELS.FALLBACK_CHAINS.premium)},
-      standard: ${formatModelArray(MODELS.FALLBACK_CHAINS.standard)},
-      fast: ${formatModelArray(MODELS.FALLBACK_CHAINS.fast)}
-    },
-    preferSameProvider: true,
-    respectTierCeiling: true,
-    nuclearFallback: {
-      enabled: false,
-      model: '${MODELS.NUCLEAR_FALLBACK}',
-      maxRetriesBeforeNuclear: ${MODELS.NUCLEAR_MAX_RETRIES}
-    }
-  },
-  
-  routing: {
-    rules: [
-      {
-        workType: 'feature-dev',
-        agents: ['@${agents[0]?.name || 'coordinator'}'],
-        confidence: 'high'
-      },
-      {
-        workType: 'bug-fix',
-        agents: ['@${agents.find(a => a.role === 'developer')?.name || agents[0]?.name || 'coordinator'}'],
-        confidence: 'high'
-      },
-      {
-        workType: 'testing',
-        agents: ['@${agents.find(a => a.role === 'tester')?.name || agents[0]?.name || 'coordinator'}'],
-        confidence: 'high'
-      },
-      {
-        workType: 'documentation',
-        agents: ['@${agents.find(a => a.role === 'scribe')?.name || agents[0]?.name || 'coordinator'}'],
-        confidence: 'high'
-      }
-    ],
-    governance: {
-      eagerByDefault: true,
-      scribeAutoRuns: false,
-      allowRecursiveSpawn: false
-    }
-  },
-  
-  casting: {
-    allowlistUniverses: [
-      'The Usual Suspects',
-      'Breaking Bad',
-      'The Wire',
-      'Firefly'
-    ],
-    overflowStrategy: 'generic',
-    universeCapacity: {}
-  },
-  
-  platforms: {
-    vscode: {
-      disableModelSelection: false,
-      scribeMode: 'sync'
-    }
-  }
-};
-
-export default config;
+    return `import type { SquadConfig } from '@bradygaster/squad';
+
+/**
+ * Squad Configuration for ${projectName}
+ * ${projectDescription ? `\n * ${projectDescription}` : ''}
+ */
+const config: SquadConfig = {
+  version: '1.0.0',
+  
+  models: {
+    defaultModel: '${MODELS.DEFAULT}',
+    defaultTier: 'standard',
+    fallbackChains: {
+      premium: ${formatModelArray(MODELS.FALLBACK_CHAINS.premium)},
+      standard: ${formatModelArray(MODELS.FALLBACK_CHAINS.standard)},
+      fast: ${formatModelArray(MODELS.FALLBACK_CHAINS.fast)}
+    },
+    preferSameProvider: true,
+    respectTierCeiling: true,
+    nuclearFallback: {
+      enabled: false,
+      model: '${MODELS.NUCLEAR_FALLBACK}',
+      maxRetriesBeforeNuclear: ${MODELS.NUCLEAR_MAX_RETRIES}
+    }
+  },
+  
+  routing: {
+    rules: [
+      {
+        workType: 'feature-dev',
+        agents: ['@${agents[0]?.name || 'coordinator'}'],
+        confidence: 'high'
+      },
+      {
+        workType: 'bug-fix',
+        agents: ['@${agents.find(a => a.role === 'developer')?.name || agents[0]?.name || 'coordinator'}'],
+        confidence: 'high'
+      },
+      {
+        workType: 'testing',
+        agents: ['@${agents.find(a => a.role === 'tester')?.name || agents[0]?.name || 'coordinator'}'],
+        confidence: 'high'
+      },
+      {
+        workType: 'documentation',
+        agents: ['@${agents.find(a => a.role === 'scribe')?.name || agents[0]?.name || 'coordinator'}'],
+        confidence: 'high'
+      }
+    ],
+    governance: {
+      eagerByDefault: true,
+      scribeAutoRuns: false,
+      allowRecursiveSpawn: false
+    }
+  },
+  
+  casting: {
+    allowlistUniverses: [
+      'The Usual Suspects',
+      'Breaking Bad',
+      'The Wire',
+      'Firefly'
+    ],
+    overflowStrategy: 'generic',
+    universeCapacity: {}
+  },
+  
+  platforms: {
+    vscode: {
+      disableModelSelection: false,
+      scribeMode: 'sync'
+    }
+  }
+};
+
+export default config;
 `;
 }
 /**
@@ -279,6 +280,83 @@ function generateSDKBuilderConfig(options) {
     code += `});\n`;
     return code;
 }
+/** Default starter roles used when --sdk --roles is specified. */
+const SDK_ROLES_STARTER_TEAM = ['lead', 'backend', 'frontend', 'tester'];
+/**
+ * Generate SDK builder config using useRole() for base roles.
+ *
+ * Produces a squad.config.ts that imports useRole from the SDK and
+ * references built-in base role definitions instead of plain
+ * defineAgent() calls.
+ */
+function generateSDKBuilderConfigWithRoles(options) {
+    const { projectName, projectDescription, agents } = options;
+    // Partition agents into base-role agents and non-role agents
+    const roleAgents = agents.filter(a => getRoleById(a.role));
+    const plainAgents = agents.filter(a => !getRoleById(a.role));
+    // If caller didn't provide any base-role agents, generate a
+    // starter team from the default set.
+    const effectiveRoleAgents = roleAgents.length > 0
+        ? roleAgents
+        : SDK_ROLES_STARTER_TEAM.map(id => {
+            const role = getRoleById(id);
+            return { name: id, role: id, displayName: role.title };
+        });
+    const needsDefineAgent = plainAgents.length > 0;
+    const needsUseRole = effectiveRoleAgents.length > 0;
+    // Build import list
+    const imports = ['defineSquad', 'defineTeam'];
+    if (needsDefineAgent)
+        imports.push('defineAgent');
+    if (needsUseRole)
+        imports.push('useRole');
+    let code = `import {\n${imports.map(i => `  ${i},`).join('\n')}\n} from '@bradygaster/squad-sdk';\n\n`;
+    code += `/**\n * Squad Configuration — ${projectName}\n`;
+    if (projectDescription) {
+        code += ` *\n * ${projectDescription}\n`;
+    }
+    code += ` *\n * Uses built-in base roles from the role catalog.\n`;
+    code += ` * Customize names and overrides for your project.\n`;
+    code += ` */\n\n`;
+    // Generate useRole() definitions
+    for (const agent of effectiveRoleAgents) {
+        const varName = agent.name.replace(/-/g, '_');
+        code += `const ${varName} = useRole('${agent.role}', {\n`;
+        code += `  name: '${agent.name}',\n`;
+        code += `});\n\n`;
+    }
+    // Generate plain defineAgent() definitions (for system agents like scribe/ralph)
+    for (const agent of plainAgents) {
+        const displayName = agent.displayName || titleCase(agent.name);
+        code += `const ${agent.name} = defineAgent({\n`;
+        code += `  name: '${agent.name}',\n`;
+        code += `  role: '${agent.role}',\n`;
+        code += `  description: '${displayName}',\n`;
+        code += `  status: 'active',\n`;
+        code += `});\n\n`;
+    }
+    // All agent variable names in order
+    const allVarNames = [
+        ...effectiveRoleAgents.map(a => a.name.replace(/-/g, '_')),
+        ...plainAgents.map(a => a.name),
+    ];
+    const allNames = [
+        ...effectiveRoleAgents.map(a => `'${a.name}'`),
+        ...plainAgents.map(a => `'${a.name}'`),
+    ];
+    code += `export default defineSquad({\n`;
+    code += `  version: '1.0.0',\n\n`;
+    code += `  team: defineTeam({\n`;
+    code += `    name: '${projectName}',\n`;
+    if (projectDescription) {
+        code += `    description: '${projectDescription.replace(/'/g, "\\'")}',\n`;
+    }
+    code += `    members: [${allNames.join(', ')}],\n`;
+    code += `  }),\n\n`;
+    code += `  agents: [${allVarNames.join(', ')}],\n`;
+    code += `});\n`;
+    return code;
+}
 // ============================================================================
 // Agent Template Generation
 // ============================================================================
@@ -289,26 +367,26 @@ function generateCharter(agent, projectName, projectDescription) {
     const template = AGENT_TEMPLATES[agent.role];
     const displayName = agent.displayName || template?.displayName || titleCase(agent.name);
     const description = template?.description || 'Team member focused on their assigned responsibilities.';
-    return `# ${displayName} — ${titleCase(agent.role)}
-
-${description}
-
-## Project Context
-
-**Project:** ${projectName}
-${projectDescription ? `**Description:** ${projectDescription}\n` : ''}
-
-## Responsibilities
-
-- Collaborate with team members on assigned work
-- Maintain code quality and project standards
-- Document decisions and progress in history
-
-## Work Style
-
-- Read project context and team decisions before starting work
-- Communicate clearly with team members
-- Follow established patterns and conventions
+    return `# ${displayName} — ${titleCase(agent.role)}
+
+${description}
+
+## Project Context
+
+**Project:** ${projectName}
+${projectDescription ? `**Description:** ${projectDescription}\n` : ''}
+
+## Responsibilities
+
+- Collaborate with team members on assigned work
+- Maintain code quality and project standards
+- Document decisions and progress in history
+
+## Work Style
+
+- Read project context and team decisions before starting work
+- Communicate clearly with team members
+- Follow established patterns and conventions
 `;
 }
 /**
@@ -317,22 +395,22 @@ ${projectDescription ? `**Description:** ${projectDescription}\n` : ''}
 function generateInitialHistory(agent, projectName, projectDescription, userName) {
     const displayName = agent.displayName || AGENT_TEMPLATES[agent.role]?.displayName || titleCase(agent.name);
     const now = new Date().toISOString().split('T')[0];
-    return `# Project Context
-
-${userName ? `- **Owner:** ${userName}\n` : ''}- **Project:** ${projectName}
-${projectDescription ? `- **Description:** ${projectDescription}\n` : ''}- **Created:** ${now}
-
-## Core Context
-
-Agent ${displayName} initialized and ready for work.
-
-## Recent Updates
-
-📌 Team initialized on ${now}
-
-## Learnings
-
-Initial setup complete.
+    return `# Project Context
+
+${userName ? `- **Owner:** ${userName}\n` : ''}- **Project:** ${projectName}
+${projectDescription ? `- **Description:** ${projectDescription}\n` : ''}- **Created:** ${now}
+
+## Core Context
+
+Agent ${displayName} initialized and ready for work.
+
+## Recent Updates
+
+📌 Team initialized on ${now}
+
+## Learnings
+
+Initial setup complete.
 `;
 }
 /**
@@ -349,9 +427,16 @@ function titleCase(str) {
 // ============================================================================
 /**
  * Stamp version into squad.agent.md content.
+ * Replaces three locations: HTML comment, Identity Version line, and {version} placeholder.
  */
 function stampVersionInContent(content, version) {
-    return content.replace(/<!-- version: [^>]* -->/, `<!-- version: ${version} -->`);
+    // HTML comment: <!-- version: X.Y.Z -->
+    content = content.replace(/<!-- version: [^>]* -->/, `<!-- version: ${version} -->`);
+    // Identity section: - **Version:** X.Y.Z
+    content = content.replace(/- \*\*Version:\*\* [0-9.]+(?:-[a-z]+(?:\.\d+)?)?/m, `- **Version:** ${version}`);
+    // Greeting placeholder: `Squad v{version}`
+    content = content.replace(/`Squad v\{version\}`/g, `\`Squad v${version}\``);
+    return content;
 }
 /**
  * Initialize a new Squad project.
@@ -442,7 +527,7 @@ export async function initSquad(options) {
         join(squadDir, 'casting'),
         join(squadDir, 'decisions'),
         join(squadDir, 'decisions', 'inbox'),
-        join(squadDir, 'skills'),
+        join(teamRoot, '.copilot', 'skills'),
         join(squadDir, 'plugins'),
         join(squadDir, 'identity'),
         join(squadDir, 'orchestration-log'),
@@ -472,24 +557,49 @@ export async function initSquad(options) {
         }
         const squadConfig = {
             version: 1,
-            teamRoot: teamRoot,
         };
         if (detectedPlatform) {
             squadConfig.platform = detectedPlatform;
         }
         if (detectedPlatform === 'azure-devops') {
-            // ADO work item defaults — users can customize these:
-            // - org/project: set when work items live in a different project than the repo
-            // - defaultWorkItemType: "User Story", "Scenario", "Bug", etc.
-            // - areaPath: e.g. "MyProject\\Team A" (backslash-separated)
-            // - iterationPath: e.g. "MyProject\\Sprint 1"
-            squadConfig.ado = {
-            // org: "my-org",           // uncomment if work items are in a different org
-            // project: "my-project",   // uncomment if work items are in a different project
-            // defaultWorkItemType: "User Story",
-            // areaPath: "",
-            // iterationPath: "",
-            };
+            // ADO work item defaults — attempt to introspect the process template
+            // to discover available work item types for the project.
+            let introspectedTypes;
+            try {
+                const remoteUrl = execFileSync('git', ['remote', 'get-url', 'origin'], { cwd: teamRoot, encoding: 'utf-8' }).trim();
+                // Parse org/project from remote URL for introspection
+                const httpsMatch = remoteUrl.match(/dev\.azure\.com\/([^/]+)\/([^/]+)\/_git/i);
+                const sshMatch = remoteUrl.match(/ssh\.dev\.azure\.com:v3\/([^/]+)\/([^/]+)\//i);
+                const vsMatch = remoteUrl.match(/([^/.]+)\.visualstudio\.com\/([^/]+)\/_git/i);
+                const parsed = httpsMatch ?? sshMatch ?? vsMatch;
+                if (parsed && parsed[1] && parsed[2]) {
+                    const { getAvailableWorkItemTypes } = await import('../platform/azure-devops.js');
+                    const types = getAvailableWorkItemTypes(parsed[1], parsed[2]);
+                    const enabled = types.filter((t) => !t.disabled).map((t) => t.name);
+                    if (enabled.length > 0) {
+                        introspectedTypes = enabled;
+                    }
+                }
+            }
+            catch {
+                // Introspection failed — skip and use commented-out defaults
+            }
+            // Build the ADO config section: explicit options > introspected > commented defaults
+            const adoSection = {};
+            if (options.adoConfig?.defaultWorkItemType) {
+                adoSection.defaultWorkItemType = options.adoConfig.defaultWorkItemType;
+            }
+            if (options.adoConfig?.areaPath) {
+                adoSection.areaPath = options.adoConfig.areaPath;
+            }
+            if (options.adoConfig?.iterationPath) {
+                adoSection.iterationPath = options.adoConfig.iterationPath;
+            }
+            squadConfig.ado = adoSection;
+            // If introspection found types, store them so the user knows what's available
+            if (introspectedTypes?.length) {
+                adoSection._availableTypes = introspectedTypes;
+            }
         }
         // Only include extractionDisabled if explicitly set
         if (options.extractionDisabled) {
@@ -507,9 +617,10 @@ export async function initSquad(options) {
         const configFileName = configFormat === 'sdk' ? 'squad.config.ts' :
             configFormat === 'typescript' ? 'squad.config.ts' : 'squad.config.json';
         configPath = join(teamRoot, configFileName);
-        const configContent = configFormat === 'sdk' ? generateSDKBuilderConfig(options) :
-            configFormat === 'typescript' ? generateTypeScriptConfig(options) :
-                generateJsonConfig(options);
+        const configContent = (configFormat === 'sdk' && options.roles) ? generateSDKBuilderConfigWithRoles(options) :
+            configFormat === 'sdk' ? generateSDKBuilderConfig(options) :
+                configFormat === 'typescript' ? generateTypeScriptConfig(options) :
+                    generateJsonConfig(options);
         await writeIfNotExists(configPath, configContent);
     }
     else {
@@ -539,27 +650,27 @@ export async function initSquad(options) {
     const identityDir = join(squadDir, 'identity');
     const nowMdPath = join(identityDir, 'now.md');
     const wisdomMdPath = join(identityDir, 'wisdom.md');
-    const nowContent = `---
-updated_at: ${new Date().toISOString()}
-focus_area: Initial setup
-active_issues: []
----
-
-# What We're Focused On
-
-Getting started. Updated by coordinator at session start.
+    const nowContent = `---
+updated_at: ${new Date().toISOString()}
+focus_area: Initial setup
+active_issues: []
+---
+
+# What We're Focused On
+
+Getting started. Updated by coordinator at session start.
 `;
-    const wisdomContent = `---
-last_updated: ${new Date().toISOString()}
----
-
-# Team Wisdom
-
-Reusable patterns and heuristics learned through work. NOT transcripts — each entry is a distilled, actionable insight.
-
-## Patterns
-
-<!-- Append entries below. Format: **Pattern:** description. **Context:** when it applies. -->
+    const wisdomContent = `---
+last_updated: ${new Date().toISOString()}
+---
+
+# Team Wisdom
+
+Reusable patterns and heuristics learned through work. NOT transcripts — each entry is a distilled, actionable insight.
+
+## Patterns
+
+<!-- Append entries below. Format: **Pattern:** description. **Context:** when it applies. -->
 `;
     await writeIfNotExists(nowMdPath, nowContent);
     await writeIfNotExists(wisdomMdPath, wisdomContent);
@@ -574,42 +685,42 @@ Reusable patterns and heuristics learned through work. NOT transcripts — each
     // Create decisions.md (canonical location at squad root)
     // -------------------------------------------------------------------------
     const decisionsPath = join(squadDir, 'decisions.md');
-    const decisionsContent = `# Squad Decisions
-
-## Active Decisions
-
-No decisions recorded yet.
-
-## Governance
-
-- All meaningful changes require team consensus
-- Document architectural decisions here
-- Keep history focused on work, decisions focused on direction
+    const decisionsContent = `# Squad Decisions
+
+## Active Decisions
+
+No decisions recorded yet.
+
+## Governance
+
+- All meaningful changes require team consensus
+- Document architectural decisions here
+- Keep history focused on work, decisions focused on direction
 `;
     await writeIfNotExists(decisionsPath, decisionsContent);
     // -------------------------------------------------------------------------
     // Create team.md (required by shell lifecycle)
     // -------------------------------------------------------------------------
     const teamPath = join(squadDir, 'team.md');
-    const teamContent = `# Squad Team
-
-> ${projectDescription || projectName}
-
-## Coordinator
-
-| Name | Role | Notes |
-|------|------|-------|
-| Squad | Coordinator | Routes work, enforces handoffs and reviewer gates. |
-
-## Members
-
-| Name | Role | Charter | Status |
-|------|------|---------|--------|
-
-## Project Context
-
-- **Project:** ${projectName}
-${projectDescription ? `- **Description:** ${projectDescription}\n` : ''}- **Created:** ${new Date().toISOString().split('T')[0]}
+    const teamContent = `# Squad Team
+
+> ${projectDescription || projectName}
+
+## Coordinator
+
+| Name | Role | Notes |
+|------|------|-------|
+| Squad | Coordinator | Routes work, enforces handoffs and reviewer gates. |
+
+## Members
+
+| Name | Role | Charter | Status |
+|------|------|---------|--------|
+
+## Project Context
+
+- **Project:** ${projectName}
+${projectDescription ? `- **Description:** ${projectDescription}\n` : ''}- **Created:** ${new Date().toISOString().split('T')[0]}
 `;
     await writeIfNotExists(teamPath, teamContent);
     // -------------------------------------------------------------------------
@@ -620,30 +731,30 @@ ${projectDescription ? `- **Description:** ${projectDescription}\n` : ''}- **Cre
         await copyIfNotExists(join(templatesDir, 'routing.md'), routingPath);
     }
     else {
-        const routingContent = `# Squad Routing
-
-## Work Type Rules
-
-| Work Type | Primary Agent | Fallback |
-|-----------|---------------|----------|
-
-## Governance
-
-- Route based on work type and agent expertise
-- Update this file as team capabilities evolve
+        const routingContent = `# Squad Routing
+
+## Work Type Rules
+
+| Work Type | Primary Agent | Fallback |
+|-----------|---------------|----------|
+
+## Governance
+
+- Route based on work type and agent expertise
+- Update this file as team capabilities evolve
 `;
         await writeIfNotExists(routingPath, routingContent);
     }
     // -------------------------------------------------------------------------
     // Copy starter skills
     // -------------------------------------------------------------------------
-    const skillsDir = join(squadDir, 'skills');
+    const skillsDir = join(teamRoot, '.copilot', 'skills');
     if (templatesDir && existsSync(join(templatesDir, 'skills'))) {
         const skillsSrc = join(templatesDir, 'skills');
         const existingSkills = existsSync(skillsDir) ? readdirSync(skillsDir) : [];
         if (existingSkills.length === 0) {
             cpSync(skillsSrc, skillsDir, { recursive: true });
-            createdFiles.push('.squad/skills');
+            createdFiles.push('.copilot/skills');
         }
     }
     // -------------------------------------------------------------------------