@specforge/mcp 3.0.7 → 3.1.0

package/dist/lib/monorepo-detector.js

@@ -0,0 +1,271 @@
+/**
+ * Monorepo Detection Utility
+ *
+ * Detects monorepo setups by checking for tool-specific config files.
+ * Returns the detected tool, workspace globs, resolved workspace paths,
+ * and package manager. Returns null for single-project repos.
+ *
+ * Detection priority: turborepo → nx → lerna → pnpm → npm → yarn
+ *
+ * This runs locally (MCP stdio transport only). For SSE/cloud transport
+ * the caller should skip detection and return null.
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { minimatch } from 'minimatch';
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Detect monorepo configuration from a project root directory.
+ *
+ * @param projectRoot Absolute or relative path to the project root.
+ * @returns MonorepoInfo if a monorepo setup is detected, null otherwise.
+ */
+export function detectMonorepo(projectRoot) {
+    if (!fs.existsSync(projectRoot)) {
+        return null;
+    }
+    const rootStats = fs.statSync(projectRoot);
+    if (!rootStats.isDirectory()) {
+        return null;
+    }
+    // Try each detector in priority order.
+    const detectors = [
+        () => detectTurborepo(projectRoot),
+        () => detectNx(projectRoot),
+        () => detectLerna(projectRoot),
+        () => detectPnpmWorkspaces(projectRoot),
+        () => detectNpmYarnWorkspaces(projectRoot),
+    ];
+    for (const detect of detectors) {
+        const result = detect();
+        if (result !== null) {
+            return result;
+        }
+    }
+    return null;
+}
+// ---------------------------------------------------------------------------
+// Detectors
+// ---------------------------------------------------------------------------
+function detectTurborepo(root) {
+    const turboPath = path.join(root, 'turbo.json');
+    if (!fs.existsSync(turboPath))
+        return null;
+    // Turborepo reads workspaces from package.json, not turbo.json.
+    const workspaces = readPackageJsonWorkspaces(root);
+    if (workspaces.length === 0)
+        return null;
+    return {
+        type: 'turborepo',
+        workspaces,
+        resolvedPaths: resolveWorkspaceGlobs(root, workspaces),
+        packageManager: detectPackageManager(root),
+    };
+}
+function detectNx(root) {
+    const nxPath = path.join(root, 'nx.json');
+    if (!fs.existsSync(nxPath))
+        return null;
+    // Nx can use package.json workspaces or its own project structure.
+    let workspaces = readPackageJsonWorkspaces(root);
+    // If no workspaces in package.json, check for common Nx patterns.
+    if (workspaces.length === 0) {
+        const defaults = ['packages/*', 'apps/*', 'libs/*'];
+        const existing = defaults.filter(g => {
+            const prefix = g.replace('/*', '');
+            return fs.existsSync(path.join(root, prefix));
+        });
+        if (existing.length === 0)
+            return null;
+        workspaces = existing;
+    }
+    return {
+        type: 'nx',
+        workspaces,
+        resolvedPaths: resolveWorkspaceGlobs(root, workspaces),
+        packageManager: detectPackageManager(root),
+    };
+}
+function detectLerna(root) {
+    const lernaPath = path.join(root, 'lerna.json');
+    if (!fs.existsSync(lernaPath))
+        return null;
+    try {
+        const lernaConfig = JSON.parse(fs.readFileSync(lernaPath, 'utf-8'));
+        let workspaces = lernaConfig.packages ?? [];
+        // Fallback to package.json workspaces if lerna.json has no packages.
+        if (workspaces.length === 0) {
+            workspaces = readPackageJsonWorkspaces(root);
+        }
+        if (workspaces.length === 0) {
+            // Lerna default
+            workspaces = ['packages/*'];
+        }
+        return {
+            type: 'lerna',
+            workspaces,
+            resolvedPaths: resolveWorkspaceGlobs(root, workspaces),
+            packageManager: detectPackageManager(root),
+        };
+    }
+    catch {
+        return null;
+    }
+}
+function detectPnpmWorkspaces(root) {
+    const yamlPath = path.join(root, 'pnpm-workspace.yaml');
+    if (!fs.existsSync(yamlPath))
+        return null;
+    try {
+        const content = fs.readFileSync(yamlPath, 'utf-8');
+        const workspaces = parsePnpmWorkspaceYaml(content);
+        if (workspaces.length === 0)
+            return null;
+        return {
+            type: 'pnpm',
+            workspaces,
+            resolvedPaths: resolveWorkspaceGlobs(root, workspaces),
+            packageManager: 'pnpm',
+        };
+    }
+    catch {
+        return null;
+    }
+}
+function detectNpmYarnWorkspaces(root) {
+    const workspaces = readPackageJsonWorkspaces(root);
+    if (workspaces.length === 0)
+        return null;
+    const isYarn = fs.existsSync(path.join(root, 'yarn.lock'));
+    return {
+        type: isYarn ? 'yarn' : 'npm',
+        workspaces,
+        resolvedPaths: resolveWorkspaceGlobs(root, workspaces),
+        packageManager: isYarn ? 'yarn' : 'npm',
+    };
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/**
+ * Read the "workspaces" field from root package.json.
+ * Handles both array format and object format ({ packages: [...] }).
+ */
+function readPackageJsonWorkspaces(root) {
+    try {
+        const pkgPath = path.join(root, 'package.json');
+        const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf-8'));
+        const workspaces = pkg.workspaces;
+        if (Array.isArray(workspaces)) {
+            return workspaces;
+        }
+        if (workspaces && Array.isArray(workspaces.packages)) {
+            return workspaces.packages;
+        }
+        return [];
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Parse pnpm-workspace.yaml without a YAML library.
+ * Extracts entries under the `packages:` key.
+ *
+ * Expected format:
+ *   packages:
+ *     - 'packages/*'
+ *     - 'apps/*'
+ */
+function parsePnpmWorkspaceYaml(content) {
+    const lines = content.split('\n');
+    const workspaces = [];
+    let inPackages = false;
+    for (const line of lines) {
+        const trimmed = line.trim();
+        if (trimmed === 'packages:') {
+            inPackages = true;
+            continue;
+        }
+        // Exit the packages block on a new top-level key.
+        if (inPackages && trimmed.length > 0 && !trimmed.startsWith('-') && !trimmed.startsWith('#')) {
+            break;
+        }
+        if (inPackages && trimmed.startsWith('-')) {
+            // Strip "- ", then strip surrounding quotes.
+            const value = trimmed
+                .slice(1)
+                .trim()
+                .replace(/^['"]/, '')
+                .replace(/['"]$/, '');
+            if (value) {
+                workspaces.push(value);
+            }
+        }
+    }
+    return workspaces;
+}
+/**
+ * Resolve workspace glob patterns to actual directory paths.
+ * Uses minimatch for pattern matching against directory entries.
+ */
+function resolveWorkspaceGlobs(root, globs) {
+    const resolved = [];
+    for (const glob of globs) {
+        // Skip negated patterns (e.g., "!packages/internal").
+        if (glob.startsWith('!'))
+            continue;
+        // Simple case: "packages/*" → list dirs in "packages/".
+        const parts = glob.split('/');
+        const prefix = parts.slice(0, -1).join('/');
+        const prefixDir = prefix ? path.join(root, prefix) : root;
+        if (!fs.existsSync(prefixDir) || !fs.statSync(prefixDir).isDirectory()) {
+            continue;
+        }
+        try {
+            const entries = fs.readdirSync(prefixDir, { withFileTypes: true });
+            for (const entry of entries) {
+                if (!entry.isDirectory())
+                    continue;
+                const relativePath = prefix ? `${prefix}/${entry.name}` : entry.name;
+                if (minimatch(relativePath, glob)) {
+                    resolved.push(relativePath);
+                }
+            }
+        }
+        catch {
+            // Skip unreadable directories.
+        }
+    }
+    return resolved.sort();
+}
+/**
+ * Detect the package manager from lockfiles or the package.json
+ * "packageManager" field.
+ */
+function detectPackageManager(root) {
+    // Check package.json "packageManager" field first (corepack).
+    try {
+        const pkg = JSON.parse(fs.readFileSync(path.join(root, 'package.json'), 'utf-8'));
+        if (typeof pkg.packageManager === 'string') {
+            // Format: "pnpm@9.0.0" → extract name.
+            const name = pkg.packageManager.split('@')[0];
+            if (name)
+                return name;
+        }
+    }
+    catch {
+        // Ignore.
+    }
+    // Lockfile detection.
+    if (fs.existsSync(path.join(root, 'pnpm-lock.yaml')))
+        return 'pnpm';
+    if (fs.existsSync(path.join(root, 'yarn.lock')))
+        return 'yarn';
+    if (fs.existsSync(path.join(root, 'bun.lockb')))
+        return 'bun';
+    return 'npm';
+}
+//# sourceMappingURL=monorepo-detector.js.map

package/dist/lib/monorepo-detector.js.map

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

package/dist/lib/prompt-generator.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Workspace-Scoped Worker Prompt Generator
+ *
+ * Generates context-rich prompts for Agent Teams workers and validators.
+ * Follows the Worker Initial Prompt and Validation Watcher Prompt templates
+ * from the design doc.
+ *
+ * Prompts are kept concise (~2000-4000 tokens) for worker context efficiency.
+ * Sections with no data are omitted entirely.
+ */
+export interface TicketContext {
+    id: string;
+    ticketNumber: number;
+    title: string;
+    description: string;
+    implementation?: {
+        steps?: string[];
+        filesToCreate?: string[];
+        filesToModify?: string[];
+    } | null;
+    acceptanceCriteria?: Array<{
+        description: string;
+    }> | null;
+    technicalDetails?: Record<string, unknown> | null;
+}
+export interface EpicContext {
+    title: string;
+    objective?: string | null;
+}
+export interface SpecContext {
+    title: string;
+    techStack?: string[] | null;
+    codeStandards?: string | null;
+}
+export interface WorkspaceContext {
+    /** Relative path from project root (e.g., "apps/web") */
+    path: string;
+    /** Detected framework (e.g., "Next.js", "Express") */
+    framework?: string | null;
+    /** Package name from package.json */
+    name?: string | null;
+    /** Key dependency names */
+    dependencies?: string[] | null;
+}
+export interface ConventionsContext {
+    /** Free-form conventions text (e.g., from CLAUDE.md) */
+    content?: string | null;
+}
+export interface ValidationCommands {
+    test?: string | null;
+    lint?: string | null;
+    typeCheck?: string | null;
+    build?: string | null;
+}
+/**
+ * Generate a context-rich prompt for an Agent Teams worker.
+ *
+ * Omits entire sections when the corresponding data is missing.
+ */
+export declare function generateWorkerPrompt(ticket: TicketContext, epic: EpicContext, spec: SpecContext, workspace?: WorkspaceContext | null, conventions?: ConventionsContext | null): string;
+/**
+ * Generate a prompt for an Agent Teams validation watcher.
+ */
+export declare function generateValidatorPrompt(epic: EpicContext, validationCommands?: ValidationCommands | null, workspace?: WorkspaceContext | null): string;
+//# sourceMappingURL=prompt-generator.d.ts.map

package/dist/lib/prompt-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-generator.d.ts","sourceRoot":"","sources":["../../src/lib/prompt-generator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAMH,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE;QACf,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;QACjB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;QACzB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;KAC1B,GAAG,IAAI,CAAC;IACT,kBAAkB,CAAC,EAAE,KAAK,CAAC;QAAE,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,IAAI,CAAC;IAC3D,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CACnD;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAC5B,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED,MAAM,WAAW,gBAAgB;IAC/B,yDAAyD;IACzD,IAAI,EAAE,MAAM,CAAC;IACb,sDAAsD;IACtD,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,qCAAqC;IACrC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,2BAA2B;IAC3B,YAAY,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;CAChC;AAED,MAAM,WAAW,kBAAkB;IACjC,wDAAwD;IACxD,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAMD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,aAAa,EACrB,IAAI,EAAE,WAAW,EACjB,IAAI,EAAE,WAAW,EACjB,SAAS,CAAC,EAAE,gBAAgB,GAAG,IAAI,EACnC,WAAW,CAAC,EAAE,kBAAkB,GAAG,IAAI,GACtC,MAAM,CA+GR;AAMD;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,WAAW,EACjB,kBAAkB,CAAC,EAAE,kBAAkB,GAAG,IAAI,EAC9C,SAAS,CAAC,EAAE,gBAAgB,GAAG,IAAI,GAClC,MAAM,CAiER"}

package/dist/lib/prompt-generator.js

@@ -0,0 +1,172 @@
+/**
+ * Workspace-Scoped Worker Prompt Generator
+ *
+ * Generates context-rich prompts for Agent Teams workers and validators.
+ * Follows the Worker Initial Prompt and Validation Watcher Prompt templates
+ * from the design doc.
+ *
+ * Prompts are kept concise (~2000-4000 tokens) for worker context efficiency.
+ * Sections with no data are omitted entirely.
+ */
+// ---------------------------------------------------------------------------
+// Worker prompt
+// ---------------------------------------------------------------------------
+/**
+ * Generate a context-rich prompt for an Agent Teams worker.
+ *
+ * Omits entire sections when the corresponding data is missing.
+ */
+export function generateWorkerPrompt(ticket, epic, spec, workspace, conventions) {
+    const sections = [];
+    // Header
+    sections.push(`# SpecForge Worker: Implementing E-T${ticket.ticketNumber}`, '', `**Epic:** ${epic.title}`, `**Spec:** ${spec.title}`, '');
+    // Ticket details
+    sections.push(`## Ticket: ${ticket.title}`, '');
+    sections.push('### Description', ticket.description, '');
+    // Implementation guide
+    const impl = ticket.implementation;
+    if (impl) {
+        const hasSteps = impl.steps && impl.steps.length > 0;
+        const hasCreate = impl.filesToCreate && impl.filesToCreate.length > 0;
+        const hasModify = impl.filesToModify && impl.filesToModify.length > 0;
+        if (hasSteps || hasCreate || hasModify) {
+            sections.push('### Implementation Guide', '');
+            if (hasSteps) {
+                sections.push(...impl.steps.map((step, i) => `${i + 1}. ${step}`), '');
+            }
+            if (hasCreate) {
+                sections.push('**Files to create:**');
+                sections.push(...impl.filesToCreate.map(f => `- \`${f}\``), '');
+            }
+            if (hasModify) {
+                sections.push('**Files to modify:**');
+                sections.push(...impl.filesToModify.map(f => `- \`${f}\``), '');
+            }
+        }
+    }
+    // Acceptance criteria
+    if (ticket.acceptanceCriteria && ticket.acceptanceCriteria.length > 0) {
+        sections.push('### Acceptance Criteria');
+        sections.push(...ticket.acceptanceCriteria.map(ac => `- [ ] ${ac.description}`), '');
+    }
+    // Technical details
+    if (ticket.technicalDetails && Object.keys(ticket.technicalDetails).length > 0) {
+        sections.push('### Technical Details');
+        sections.push(formatTechnicalDetails(ticket.technicalDetails), '');
+    }
+    // Tech stack from spec
+    if (spec.techStack && spec.techStack.length > 0) {
+        sections.push('### Tech Stack');
+        sections.push(spec.techStack.join(', '), '');
+    }
+    // Workspace info (monorepo)
+    if (workspace) {
+        sections.push('### Workspace');
+        sections.push(`- **Path:** ${workspace.path}`);
+        if (workspace.name) {
+            sections.push(`- **Package:** ${workspace.name}`);
+        }
+        if (workspace.framework) {
+            sections.push(`- **Framework:** ${workspace.framework}`);
+        }
+        if (workspace.dependencies && workspace.dependencies.length > 0) {
+            sections.push(`- **Key dependencies:** ${workspace.dependencies.join(', ')}`);
+        }
+        sections.push('');
+    }
+    // Conventions
+    if (conventions?.content) {
+        sections.push('### Conventions', conventions.content, '');
+    }
+    // Code standards from spec
+    if (spec.codeStandards) {
+        sections.push('### Code Standards', spec.codeStandards, '');
+    }
+    // Rules
+    sections.push('### Rules');
+    const rules = [
+        'Only modify files listed in the implementation guide unless necessary',
+        "Follow the project's coding conventions",
+        'Write tests for new functionality',
+        'Update ticket status via SpecForge MCP after each milestone',
+        'Report any blockers or discoveries to team-lead immediately',
+    ];
+    if (workspace) {
+        rules.unshift(`Only modify files within \`${workspace.path}/\` unless the ticket explicitly requires cross-workspace changes`);
+    }
+    sections.push(...rules.map(r => `- ${r}`), '');
+    return sections.join('\n').trimEnd();
+}
+// ---------------------------------------------------------------------------
+// Validator prompt
+// ---------------------------------------------------------------------------
+/**
+ * Generate a prompt for an Agent Teams validation watcher.
+ */
+export function generateValidatorPrompt(epic, validationCommands, workspace) {
+    const sections = [];
+    sections.push(`# SpecForge Validator: ${epic.title}`, '');
+    sections.push('## Your Role');
+    sections.push('You are the validation watcher for this epic.', 'After each teammate reports a ticket as complete:', '');
+    // Validation commands
+    const steps = [];
+    steps.push('1. Pull their changes');
+    if (validationCommands?.test) {
+        steps.push(`2. Run tests: \`${validationCommands.test}\``);
+    }
+    if (validationCommands?.lint) {
+        steps.push(`${steps.length + 1}. Run lint: \`${validationCommands.lint}\``);
+    }
+    if (validationCommands?.typeCheck) {
+        steps.push(`${steps.length + 1}. Run type check: \`${validationCommands.typeCheck}\``);
+    }
+    if (validationCommands?.build) {
+        steps.push(`${steps.length + 1}. Run build: \`${validationCommands.build}\``);
+    }
+    steps.push(`${steps.length + 1}. Report results to team-lead`);
+    sections.push(...steps, '');
+    // Workspace scope
+    if (workspace) {
+        sections.push('## Workspace');
+        sections.push(`- **Path:** ${workspace.path}`);
+        if (workspace.framework) {
+            sections.push(`- **Framework:** ${workspace.framework}`);
+        }
+        sections.push('');
+    }
+    // Rules
+    sections.push('## Rules');
+    sections.push('- Do NOT modify code yourself', '- If tests fail, message the worker with specific errors and file:line references', '- If all checks pass, confirm to team-lead', '- Run validations in the correct workspace directory', '');
+    // Reporting format
+    sections.push('## Reporting Format');
+    sections.push('**On success:**', '> Ticket E-T{n} validated. All checks passed.', '', '**On failure:**', '> Ticket E-T{n} failed validation:', '> - {check}: {error message} ({file}:{line})', '');
+    return sections.join('\n').trimEnd();
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/**
+ * Format technical details as a readable key-value list.
+ * Handles nested objects and arrays.
+ */
+function formatTechnicalDetails(details) {
+    const lines = [];
+    for (const [key, value] of Object.entries(details)) {
+        if (value === null || value === undefined)
+            continue;
+        const label = key.replace(/([A-Z])/g, ' $1').replace(/^./, s => s.toUpperCase());
+        if (Array.isArray(value)) {
+            if (value.length > 0) {
+                lines.push(`- **${label}:** ${value.join(', ')}`);
+            }
+        }
+        else if (typeof value === 'object') {
+            lines.push(`- **${label}:** ${JSON.stringify(value)}`);
+        }
+        else {
+            lines.push(`- **${label}:** ${String(value)}`);
+        }
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=prompt-generator.js.map

package/dist/lib/prompt-generator.js.map

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

package/dist/lib/strategy-analyzer.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Strategy Auto-Detection Analyzer
+ *
+ * Pure function that determines the optimal Agent Teams strategy
+ * based on a specification's structure: epic count, ticket distribution,
+ * and cross-epic dependency density.
+ *
+ * Decision matrix (from design doc):
+ *   - 1 epic, ≤3 tickets           → single-session
+ *   - 1 epic, >3 tickets           → spec-as-team
+ *   - N epics, 0 cross-deps        → epic-as-team
+ *   - N epics, >50% cross-deps     → spec-as-team
+ *   - N epics, moderate cross-deps  → epic-as-team with merged pairs
+ */
+/** Tickets with cross-epic deps / total tickets. Above this → spec-as-team. */
+export declare const CROSS_DEP_THRESHOLD = 0.5;
+/** Max tickets for a single-session recommendation (single epic only). */
+export declare const SINGLE_SESSION_MAX_TICKETS = 3;
+export interface SpecSummary {
+    id: string;
+    title: string;
+    epicCount: number;
+}
+export interface EpicSummary {
+    id: string;
+    title: string;
+    ticketCount: number;
+}
+export interface TicketSummary {
+    id: string;
+    epicId: string;
+    dependencies: string[];
+}
+/**
+ * A dependency edge between two tickets in different epics.
+ */
+export interface DependencyEdge {
+    fromEpicId: string;
+    toEpicId: string;
+    fromTicketId: string;
+    toTicketId: string;
+}
+export type Strategy = 'single-session' | 'spec-as-team' | 'epic-as-team';
+export interface StrategyRecommendation {
+    strategy: Strategy;
+    reasoning: string;
+    /** Epic ID groups that should be merged into a single team (for moderate cross-deps). */
+    mergedEpics?: string[][];
+}
+/**
+ * Analyze a specification's structure and recommend an Agent Teams strategy.
+ *
+ * This is a **pure function** — no side effects, no API calls.
+ * All data must be pre-fetched and passed in.
+ *
+ * @throws {Error} If the specification has no epics or no tickets.
+ */
+export declare function analyzeStrategy(spec: SpecSummary, epics: EpicSummary[], ticketsByEpic: Map<string, TicketSummary[]>, dependencyEdges: DependencyEdge[]): StrategyRecommendation;
+//# sourceMappingURL=strategy-analyzer.d.ts.map

package/dist/lib/strategy-analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"strategy-analyzer.d.ts","sourceRoot":"","sources":["../../src/lib/strategy-analyzer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAMH,+EAA+E;AAC/E,eAAO,MAAM,mBAAmB,MAAM,CAAC;AAEvC,0EAA0E;AAC1E,eAAO,MAAM,0BAA0B,IAAI,CAAC;AAM5C,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;CACpB;AAMD,MAAM,MAAM,QAAQ,GAAG,gBAAgB,GAAG,cAAc,GAAG,cAAc,CAAC;AAE1E,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,QAAQ,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,yFAAyF;IACzF,WAAW,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC;CAC1B;AAMD;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,WAAW,EACjB,KAAK,EAAE,WAAW,EAAE,EACpB,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,EAAE,CAAC,EAC3C,eAAe,EAAE,cAAc,EAAE,GAChC,sBAAsB,CA+DxB"}