@bradygaster/squad-sdk 0.7.0 → 0.8.2

package/dist/config/init.js

@@ -0,0 +1,376 @@
+/**
+ * Squad Initialization Module (M2-6, PRD #98)
+ *
+ * Creates new Squad projects with typed configuration.
+ * Generates squad.config.ts or squad.config.json with agent definitions.
+ *
+ * @module config/init
+ */
+import { mkdir, writeFile } from 'fs/promises';
+import { join } from 'path';
+import { existsSync } from 'fs';
+import { MODELS } from '../runtime/constants.js';
+// ============================================================================
+// Default Agent Templates
+// ============================================================================
+/**
+ * Default agent templates for common roles.
+ */
+const AGENT_TEMPLATES = {
+    'lead': {
+        displayName: 'Lead',
+        description: 'Technical lead responsible for architecture, delegation, and project coordination.'
+    },
+    'developer': {
+        displayName: 'Developer',
+        description: 'Software developer focused on feature implementation and code quality.'
+    },
+    'tester': {
+        displayName: 'Tester',
+        description: 'Quality assurance specialist responsible for test coverage and validation.'
+    },
+    'scribe': {
+        displayName: 'Scribe',
+        description: 'Documentation specialist maintaining history, decisions, and technical records.'
+    },
+    'ralph': {
+        displayName: 'Ralph',
+        description: 'Persistent memory agent that maintains context across sessions.'
+    }
+};
+// ============================================================================
+// Configuration Templates
+// ============================================================================
+/**
+ * Format a readonly string array as a single-quoted TypeScript array literal.
+ */
+function formatModelArray(chain) {
+    return `[${chain.map(m => `'${m}'`).join(', ')}]`;
+}
+/**
+ * Generate TypeScript config file content.
+ */
+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;
+`;
+}
+/**
+ * Generate JSON config file content.
+ */
+function generateJsonConfig(options) {
+    const { agents } = options;
+    const config = {
+        version: '1.0.0',
+        models: {
+            defaultModel: MODELS.DEFAULT,
+            defaultTier: 'standard',
+            fallbackChains: {
+                premium: [...MODELS.FALLBACK_CHAINS.premium],
+                standard: [...MODELS.FALLBACK_CHAINS.standard],
+                fast: [...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'
+            }
+        }
+    };
+    return JSON.stringify(config, null, 2);
+}
+// ============================================================================
+// Agent Template Generation
+// ============================================================================
+/**
+ * Generate charter.md content for an agent.
+ */
+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
+`;
+}
+/**
+ * Generate initial history.md content for an agent.
+ */
+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.
+`;
+}
+/**
+ * Convert kebab-case or snake_case to Title Case.
+ */
+function titleCase(str) {
+    return str
+        .split(/[-_]/)
+        .map(word => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase())
+        .join(' ');
+}
+// ============================================================================
+// Initialization Functions
+// ============================================================================
+/**
+ * Initialize a new Squad project.
+ *
+ * Creates:
+ * - .squad/ directory structure
+ * - squad.config.ts or squad.config.json
+ * - Agent directories with charter.md and history.md
+ * - .gitattributes for merge drivers
+ *
+ * @param options - Initialization options
+ * @returns Result with created file paths
+ */
+export async function initSquad(options) {
+    const { teamRoot, projectName, projectDescription, agents, configFormat = 'typescript', userName } = options;
+    const createdFiles = [];
+    const agentDirs = [];
+    // Validate inputs
+    if (!teamRoot) {
+        throw new Error('teamRoot is required');
+    }
+    if (!projectName) {
+        throw new Error('projectName is required');
+    }
+    if (!agents || agents.length === 0) {
+        throw new Error('At least one agent is required');
+    }
+    // Create .squad directory
+    const squadDir = join(teamRoot, '.squad');
+    if (!existsSync(squadDir)) {
+        await mkdir(squadDir, { recursive: true });
+    }
+    // Create agents directory
+    const agentsDir = join(squadDir, 'agents');
+    if (!existsSync(agentsDir)) {
+        await mkdir(agentsDir, { recursive: true });
+    }
+    // Create casting directory (for future casting system)
+    const castingDir = join(squadDir, 'casting');
+    if (!existsSync(castingDir)) {
+        await mkdir(castingDir, { recursive: true });
+    }
+    // Create decisions directory
+    const decisionsDir = join(squadDir, 'decisions');
+    if (!existsSync(decisionsDir)) {
+        await mkdir(decisionsDir, { recursive: true });
+    }
+    // Create skills directory
+    const skillsDir = join(squadDir, 'skills');
+    if (!existsSync(skillsDir)) {
+        await mkdir(skillsDir, { recursive: true });
+    }
+    // Generate configuration file
+    const configFileName = configFormat === 'typescript' ? 'squad.config.ts' : 'squad.config.json';
+    const configPath = join(teamRoot, configFileName);
+    const configContent = configFormat === 'typescript'
+        ? generateTypeScriptConfig(options)
+        : generateJsonConfig(options);
+    await writeFile(configPath, configContent, 'utf-8');
+    createdFiles.push(configPath);
+    // Create agent directories and files
+    for (const agent of agents) {
+        const agentDir = join(agentsDir, agent.name);
+        await mkdir(agentDir, { recursive: true });
+        agentDirs.push(agentDir);
+        // Create charter.md
+        const charterPath = join(agentDir, 'charter.md');
+        const charterContent = generateCharter(agent, projectName, projectDescription);
+        await writeFile(charterPath, charterContent, 'utf-8');
+        createdFiles.push(charterPath);
+        // Create history.md
+        const historyPath = join(agentDir, 'history.md');
+        const historyContent = generateInitialHistory(agent, projectName, projectDescription, userName);
+        await writeFile(historyPath, historyContent, 'utf-8');
+        createdFiles.push(historyPath);
+    }
+    // Create .gitattributes for merge drivers
+    const gitattributesPath = join(teamRoot, '.gitattributes');
+    const gitattributesContent = `.squad/agents/*/history.md merge=union
+.squad/decisions/*.md merge=union
+`;
+    await writeFile(gitattributesPath, gitattributesContent, 'utf-8');
+    createdFiles.push(gitattributesPath);
+    // Create initial decisions.md
+    const decisionsPath = join(decisionsDir, '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
+`;
+    await writeFile(decisionsPath, decisionsContent, 'utf-8');
+    createdFiles.push(decisionsPath);
+    return {
+        createdFiles,
+        configPath,
+        agentDirs
+    };
+}
+//# sourceMappingURL=init.js.map

package/dist/config/init.js.map

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

package/dist/config/legacy-fallback.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Legacy Fallback — Backwards Compatibility (M3-9, Issue #150)
+ *
+ * Reads legacy squad.agent.md files and .ai-team/ directory structures,
+ * maps them to typed SquadConfig, and merges with any existing config
+ * (typed config always wins, legacy fills gaps).
+ *
+ * @module config/legacy-fallback
+ */
+import type { SquadConfig, RoutingRule } from '../runtime/config.js';
+/**
+ * Legacy configuration extracted from squad.agent.md and .ai-team/ files.
+ */
+export interface LegacyConfig {
+    /** System prompt extracted from the agent doc */
+    systemPrompt?: string;
+    /** Tool names referenced in the agent doc */
+    tools: string[];
+    /** Agent definitions extracted from agent sections */
+    agents: LegacyAgentDef[];
+    /** Routing hints extracted from routing sections */
+    routingHints: string[];
+    /** Routing rules parsed from routing.md */
+    routingRules: RoutingRule[];
+    /** Model preferences found in the document */
+    modelPreferences: string[];
+    /** Source path that was loaded */
+    sourcePath: string;
+    /** Whether .ai-team/ directory was found */
+    hasAiTeamDir: boolean;
+}
+/**
+ * Agent definition extracted from a legacy squad.agent.md.
+ */
+export interface LegacyAgentDef {
+    name: string;
+    role?: string;
+    description?: string;
+    tools?: string[];
+    model?: string;
+}
+/**
+ * Detect whether a project uses the legacy squad.agent.md format.
+ *
+ * Checks for:
+ * - .github/agents/squad.agent.md
+ * - .ai-team/squad.agent.md
+ * - .ai-team/ directory with team.md or routing.md
+ *
+ * @param dir - Project root directory
+ * @returns true if legacy format is detected
+ */
+export declare function detectLegacySetup(dir: string): boolean;
+/**
+ * Load and parse a legacy squad.agent.md file from the given directory.
+ *
+ * Search order:
+ *  1. .github/agents/squad.agent.md
+ *  2. .ai-team/squad.agent.md
+ *
+ * Also loads routing.md and team.md if present in .ai-team/ or .github/agents/.
+ *
+ * @param dir - Project root directory
+ * @returns Parsed LegacyConfig, or undefined if no legacy file found
+ */
+export declare function loadLegacyAgentMd(dir: string): LegacyConfig | undefined;
+/**
+ * Merge a legacy configuration with a typed SquadConfig.
+ *
+ * The typed config **always wins** on conflict. Legacy values fill gaps
+ * where the typed config has no data.
+ *
+ * @param legacy - Legacy configuration from squad.agent.md
+ * @param config - Typed Squad configuration (takes precedence)
+ * @returns Merged configuration
+ */
+export declare function mergeLegacyWithConfig(legacy: LegacyConfig, config: SquadConfig): SquadConfig;
+/**
+ * Emit a deprecation warning when legacy format is detected.
+ * Uses console.warn so it's visible but non-blocking.
+ */
+export declare function emitDeprecationWarning(sourcePath: string): void;
+//# sourceMappingURL=legacy-fallback.d.ts.map

package/dist/config/legacy-fallback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"legacy-fallback.d.ts","sourceRoot":"","sources":["../../src/config/legacy-fallback.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EACV,WAAW,EAEX,WAAW,EAEZ,MAAM,sBAAsB,CAAC;AAS9B;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,iDAAiD;IACjD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,6CAA6C;IAC7C,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,sDAAsD;IACtD,MAAM,EAAE,cAAc,EAAE,CAAC;IACzB,oDAAoD;IACpD,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,2CAA2C;IAC3C,YAAY,EAAE,WAAW,EAAE,CAAC;IAC5B,8CAA8C;IAC9C,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,kCAAkC;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,4CAA4C;IAC5C,YAAY,EAAE,OAAO,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAwBD;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAStD;AAMD;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAoDvE;AAMD;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,YAAY,EACpB,MAAM,EAAE,WAAW,GAClB,WAAW,CAuCb;AAMD;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAM/D"}

package/dist/config/legacy-fallback.js

@@ -0,0 +1,212 @@
+/**
+ * Legacy Fallback — Backwards Compatibility (M3-9, Issue #150)
+ *
+ * Reads legacy squad.agent.md files and .ai-team/ directory structures,
+ * maps them to typed SquadConfig, and merges with any existing config
+ * (typed config always wins, legacy fills gaps).
+ *
+ * @module config/legacy-fallback
+ */
+import { existsSync, readFileSync } from 'fs';
+import { join } from 'path';
+import { DEFAULT_CONFIG } from '../runtime/config.js';
+import { parseAgentDoc } from './agent-doc.js';
+import { parseRoutingMarkdown } from './routing.js';
+// ============================================================================
+// Detection
+// ============================================================================
+/** Paths to search for legacy agent files, in priority order. */
+const LEGACY_AGENT_PATHS = [
+    join('.github', 'agents', 'squad.agent.md'),
+    join('.ai-team', 'squad.agent.md'),
+];
+/** Paths to search for legacy routing files. */
+const LEGACY_ROUTING_PATHS = [
+    join('.ai-team', 'routing.md'),
+    join('.github', 'agents', 'routing.md'),
+];
+/** Paths to search for legacy team files. */
+const LEGACY_TEAM_PATHS = [
+    join('.ai-team', 'team.md'),
+    join('.github', 'agents', 'team.md'),
+];
+/**
+ * Detect whether a project uses the legacy squad.agent.md format.
+ *
+ * Checks for:
+ * - .github/agents/squad.agent.md
+ * - .ai-team/squad.agent.md
+ * - .ai-team/ directory with team.md or routing.md
+ *
+ * @param dir - Project root directory
+ * @returns true if legacy format is detected
+ */
+export function detectLegacySetup(dir) {
+    for (const relPath of LEGACY_AGENT_PATHS) {
+        if (existsSync(join(dir, relPath)))
+            return true;
+    }
+    // Also detect bare .ai-team/ directories with team or routing files
+    for (const relPath of [...LEGACY_ROUTING_PATHS, ...LEGACY_TEAM_PATHS]) {
+        if (existsSync(join(dir, relPath)))
+            return true;
+    }
+    return false;
+}
+// ============================================================================
+// Loading
+// ============================================================================
+/**
+ * Load and parse a legacy squad.agent.md file from the given directory.
+ *
+ * Search order:
+ *  1. .github/agents/squad.agent.md
+ *  2. .ai-team/squad.agent.md
+ *
+ * Also loads routing.md and team.md if present in .ai-team/ or .github/agents/.
+ *
+ * @param dir - Project root directory
+ * @returns Parsed LegacyConfig, or undefined if no legacy file found
+ */
+export function loadLegacyAgentMd(dir) {
+    // Find the agent doc
+    let agentMdPath;
+    let agentMdContent;
+    for (const relPath of LEGACY_AGENT_PATHS) {
+        const fullPath = join(dir, relPath);
+        if (existsSync(fullPath)) {
+            agentMdPath = fullPath;
+            agentMdContent = readFileSync(fullPath, 'utf-8');
+            break;
+        }
+    }
+    if (!agentMdPath || !agentMdContent) {
+        return undefined;
+    }
+    // Parse the agent doc
+    const parsed = parseAgentDoc(agentMdContent);
+    // Extract agent definitions from the document
+    const agents = extractAgentDefs(agentMdContent, parsed);
+    // Try to load routing.md
+    let routingRules = [];
+    for (const relPath of LEGACY_ROUTING_PATHS) {
+        const fullPath = join(dir, relPath);
+        if (existsSync(fullPath)) {
+            const routingContent = readFileSync(fullPath, 'utf-8');
+            const routingConfig = parseRoutingMarkdown(routingContent);
+            routingRules = routingConfig.rules;
+            break;
+        }
+    }
+    // Check for .ai-team directory
+    const hasAiTeamDir = existsSync(join(dir, '.ai-team')) &&
+        (existsSync(join(dir, '.ai-team', 'team.md')) ||
+            existsSync(join(dir, '.ai-team', 'routing.md')));
+    return {
+        systemPrompt: agentMdContent,
+        tools: parsed.tools,
+        agents,
+        routingHints: parsed.routingHints,
+        routingRules,
+        modelPreferences: parsed.modelPreferences,
+        sourcePath: agentMdPath,
+        hasAiTeamDir,
+    };
+}
+// ============================================================================
+// Merging
+// ============================================================================
+/**
+ * Merge a legacy configuration with a typed SquadConfig.
+ *
+ * The typed config **always wins** on conflict. Legacy values fill gaps
+ * where the typed config has no data.
+ *
+ * @param legacy - Legacy configuration from squad.agent.md
+ * @param config - Typed Squad configuration (takes precedence)
+ * @returns Merged configuration
+ */
+export function mergeLegacyWithConfig(legacy, config) {
+    // Emit deprecation warning
+    emitDeprecationWarning(legacy.sourcePath);
+    // Merge routing rules: config wins, legacy fills gaps
+    const configWorkTypes = new Set((config.routing?.rules ?? []).map((r) => r.workType));
+    const legacyRulesFiltered = legacy.routingRules.filter((r) => !configWorkTypes.has(r.workType));
+    const mergedRoutingRules = [
+        ...(config.routing?.rules ?? []),
+        ...legacyRulesFiltered,
+    ];
+    // Merge model preferences: config wins
+    const mergedModels = {
+        ...config.models,
+    };
+    if (legacy.modelPreferences.length > 0 &&
+        config.models.defaultModel === DEFAULT_CONFIG.models.defaultModel) {
+        // Only use legacy model if config still has the default
+        mergedModels.defaultModel = legacy.modelPreferences[0];
+    }
+    // Build merged routing
+    const mergedRouting = {
+        ...config.routing,
+        rules: mergedRoutingRules,
+    };
+    return {
+        ...config,
+        models: mergedModels,
+        routing: mergedRouting,
+    };
+}
+// ============================================================================
+// Deprecation Warning
+// ============================================================================
+/**
+ * Emit a deprecation warning when legacy format is detected.
+ * Uses console.warn so it's visible but non-blocking.
+ */
+export function emitDeprecationWarning(sourcePath) {
+    console.warn(`[squad] DEPRECATION: Legacy squad.agent.md detected at "${sourcePath}". ` +
+        'Migrate to squad.config.ts for typed configuration. ' +
+        'Run `squad init --migrate` to auto-convert.');
+}
+// ============================================================================
+// Internal Helpers
+// ============================================================================
+/**
+ * Extract agent definitions from squad.agent.md content.
+ * Looks for patterns like "**AgentName** — Role" or "### AgentName" sections.
+ */
+function extractAgentDefs(content, parsed) {
+    const agents = [];
+    const seen = new Set();
+    // Pattern 1: ### Agent sections (common in squad.agent.md)
+    const sectionPattern = /^###\s+(\w+)\s*(?:[-—]\s*(.+))?$/gm;
+    let match;
+    while ((match = sectionPattern.exec(content)) !== null) {
+        const name = match[1].toLowerCase();
+        const role = match[2]?.trim();
+        if (!seen.has(name) && name.length > 1) {
+            seen.add(name);
+            agents.push({ name, role });
+        }
+    }
+    // Pattern 2: **Name** — Role (bold name with dash)
+    const boldPattern = /\*\*(\w+)\*\*\s*[-—]\s*(.+)/g;
+    while ((match = boldPattern.exec(content)) !== null) {
+        const name = match[1].toLowerCase();
+        const role = match[2].trim();
+        if (!seen.has(name) && name.length > 1) {
+            seen.add(name);
+            agents.push({ name, role });
+        }
+    }
+    // If the parsed doc itself has a name, add it as the coordinator
+    if (parsed.name && !seen.has(parsed.name.toLowerCase())) {
+        agents.unshift({
+            name: parsed.name.toLowerCase(),
+            role: parsed.description ?? 'coordinator',
+            tools: parsed.tools,
+        });
+    }
+    return agents;
+}
+//# sourceMappingURL=legacy-fallback.js.map