@specforge/mcp 3.0.7 → 3.1.1

package/dist/lib/prompt-generator.js

@@ -0,0 +1,174 @@
+/**
+ * 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',
+        'BEFORE starting implementation: call `start_work_session` with the ticketId to mark it active',
+        'AFTER completing implementation and tests: call `complete_work_session` with ticketId, summary of work done, filesCreated, filesModified, filesDeleted, and validated: true',
+        'If blocked: call `report_progress` with ticketId and a description of the blocker',
+        '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"}

package/dist/lib/strategy-analyzer.js

@@ -0,0 +1,137 @@
+/**
+ * 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
+ */
+// ---------------------------------------------------------------------------
+// Tuning constants
+// ---------------------------------------------------------------------------
+/** Tickets with cross-epic deps / total tickets. Above this → spec-as-team. */
+export const CROSS_DEP_THRESHOLD = 0.5;
+/** Max tickets for a single-session recommendation (single epic only). */
+export const SINGLE_SESSION_MAX_TICKETS = 3;
+// ---------------------------------------------------------------------------
+// Core analyzer
+// ---------------------------------------------------------------------------
+/**
+ * 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 function analyzeStrategy(spec, epics, ticketsByEpic, dependencyEdges) {
+    // --- Guard: empty specification ---
+    const totalTickets = epics.reduce((sum, e) => sum + e.ticketCount, 0);
+    if (epics.length === 0 || totalTickets === 0) {
+        throw new Error('Cannot analyze empty specification');
+    }
+    // --- Single epic path ---
+    if (epics.length === 1) {
+        const epic = epics[0];
+        if (epic.ticketCount <= SINGLE_SESSION_MAX_TICKETS) {
+            return {
+                strategy: 'single-session',
+                reasoning: `Small specification with ${epic.ticketCount} ticket${epic.ticketCount === 1 ? '' : 's'} in single epic`,
+            };
+        }
+        return {
+            strategy: 'spec-as-team',
+            reasoning: `Single epic with ${epic.ticketCount} tickets benefits from parallel workers`,
+        };
+    }
+    // --- Multiple epics path ---
+    // Count tickets that have at least one dependency on a ticket in another epic.
+    const crossDepTicketIds = new Set();
+    for (const edge of dependencyEdges) {
+        crossDepTicketIds.add(edge.fromTicketId);
+        crossDepTicketIds.add(edge.toTicketId);
+    }
+    const crossDepRatio = totalTickets > 0 ? crossDepTicketIds.size / totalTickets : 0;
+    // No cross-epic dependencies → each epic can run independently.
+    if (dependencyEdges.length === 0) {
+        return {
+            strategy: 'epic-as-team',
+            reasoning: `Multiple independent epics (${epics.length}) can be parallelized as separate teams`,
+        };
+    }
+    // Heavy cross-epic dependencies → single unified team.
+    if (crossDepRatio > CROSS_DEP_THRESHOLD) {
+        const pct = Math.round(crossDepRatio * 100);
+        return {
+            strategy: 'spec-as-team',
+            reasoning: `Heavy cross-epic dependencies (${pct}%) require unified team coordination`,
+        };
+    }
+    // Moderate cross-epic dependencies → epic-as-team with merged pairs.
+    const mergedEpics = buildMergedEpicGroups(epics, dependencyEdges);
+    const pct = Math.round(crossDepRatio * 100);
+    return {
+        strategy: 'epic-as-team',
+        reasoning: `Multiple epics with moderate cross-dependencies (${pct}%); tightly coupled epics merged into ${mergedEpics.length} group${mergedEpics.length === 1 ? '' : 's'}`,
+        mergedEpics,
+    };
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/**
+ * Build groups of epics that should be merged into a single team
+ * because they share bidirectional (or dense) dependency edges.
+ *
+ * Uses a simple union-find to cluster epics connected by dependency edges.
+ */
+function buildMergedEpicGroups(epics, edges) {
+    // Union-Find (disjoint set)
+    const parent = new Map();
+    function find(x) {
+        let root = x;
+        while (parent.get(root) !== root) {
+            root = parent.get(root);
+        }
+        // Path compression
+        let current = x;
+        while (current !== root) {
+            const next = parent.get(current);
+            parent.set(current, root);
+            current = next;
+        }
+        return root;
+    }
+    function union(a, b) {
+        const ra = find(a);
+        const rb = find(b);
+        if (ra !== rb) {
+            parent.set(ra, rb);
+        }
+    }
+    // Initialize each epic as its own set.
+    for (const epic of epics) {
+        parent.set(epic.id, epic.id);
+    }
+    // Merge epics that share dependency edges.
+    for (const edge of edges) {
+        union(edge.fromEpicId, edge.toEpicId);
+    }
+    // Collect groups (only groups with >1 epic are meaningful merges).
+    const groups = new Map();
+    for (const epic of epics) {
+        const root = find(epic.id);
+        if (!groups.has(root)) {
+            groups.set(root, []);
+        }
+        groups.get(root).push(epic.id);
+    }
+    return Array.from(groups.values()).filter(g => g.length > 1);
+}
+//# sourceMappingURL=strategy-analyzer.js.map

package/dist/lib/strategy-analyzer.js.map

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

package/dist/tools/core/context-helper.d.ts

@@ -1,4 +1,26 @@
+import type { ResolvedAgentTeamsConfig } from '../../cli/config/loader.js';
+import type { ActiveSpecification, MonorepoConfig } from '../../cli/config/agent-teams.types.js';
 type ContextField = 'projectId' | 'specificationId';
+/**
+ * Get the resolved Agent Teams config from .specforge.json.
+ *
+ * Always returns a fully-resolved config with defaults applied (never null).
+ * Tools like `get_implementation_plan` use this to read the user's preferred
+ * strategy, worker limits, and other settings.
+ */
+export declare function getAgentTeamsContext(): ResolvedAgentTeamsConfig;
+/**
+ * Get the active specification from .specforge.json.
+ *
+ * @returns ActiveSpecification if set, null if no spec is activated
+ */
+export declare function getActiveSpecificationContext(): ActiveSpecification | null;
+/**
+ * Get the monorepo config from .specforge.json.
+ *
+ * @returns MonorepoConfig with defaults applied, or null if section absent
+ */
+export declare function getMonorepoContext(): MonorepoConfig | null;
 /**
  * Inject missing context fields from .specforge.json
  * Explicit args always take precedence over config values

package/dist/tools/core/context-helper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context-helper.d.ts","sourceRoot":"","sources":["../../../src/tools/core/context-helper.ts"],"names":[],"mappings":"AAYA,KAAK,YAAY,GAAG,WAAW,GAAG,iBAAiB,CAAC;AAmBpD;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7D,IAAI,EAAE,CAAC,EACP,MAAM,EAAE,YAAY,EAAE,GACrB,CAAC,CAaH;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACrE,IAAI,EAAE,CAAC,EACP,cAAc,EAAE,YAAY,EAAE,EAC9B,cAAc,GAAE,YAAY,EAAO,GAClC,CAAC,CAWH"}
+{"version":3,"file":"context-helper.d.ts","sourceRoot":"","sources":["../../../src/tools/core/context-helper.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AAC3E,OAAO,KAAK,EACV,mBAAmB,EACnB,cAAc,EACf,MAAM,uCAAuC,CAAC;AAE/C,KAAK,YAAY,GAAG,WAAW,GAAG,iBAAiB,CAAC;AAuBpD;;;;;;GAMG;AACH,wBAAgB,oBAAoB,IAAI,wBAAwB,CAG/D;AAED;;;;GAIG;AACH,wBAAgB,6BAA6B,IAAI,mBAAmB,GAAG,IAAI,CAG1E;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,IAAI,cAAc,GAAG,IAAI,CAG1D;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7D,IAAI,EAAE,CAAC,EACP,MAAM,EAAE,YAAY,EAAE,GACrB,CAAC,CAaH;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACrE,IAAI,EAAE,CAAC,EACP,cAAc,EAAE,YAAY,EAAE,EAC9B,cAAc,GAAE,YAAY,EAAO,GAClC,CAAC,CAWH"}

package/dist/tools/core/context-helper.js

@@ -5,8 +5,12 @@
  * Provides utilities for injecting working context from .specforge.json
  * into tool arguments. This ensures tools scope to the correct project/specification
  * when not explicitly provided.
+ *
+ * Also exposes Agent Teams configuration sections (agentTeams, activeSpecification,
+ * monorepo) so that MCP operations can access user preferences without
+ * re-reading the config file.
  */
-import { loadProjectConfig } from '../../cli/config/loader.js';
+import { loadProjectConfig, getAgentTeamsConfig as resolveAgentTeamsConfig, getActiveSpecification as resolveActiveSpecification, getMonorepoConfig as resolveMonorepoConfig, } from '../../cli/config/loader.js';
 /**
  * Get context from .specforge.json file
  * This is the source of truth for the current project/specification
@@ -18,6 +22,38 @@ function getLocalContext() {
         specificationId: config?.specificationId,
     };
 }
+// ---------------------------------------------------------------------------
+// Agent Teams config accessors
+// ---------------------------------------------------------------------------
+/**
+ * Get the resolved Agent Teams config from .specforge.json.
+ *
+ * Always returns a fully-resolved config with defaults applied (never null).
+ * Tools like `get_implementation_plan` use this to read the user's preferred
+ * strategy, worker limits, and other settings.
+ */
+export function getAgentTeamsContext() {
+    const config = loadProjectConfig();
+    return resolveAgentTeamsConfig(config);
+}
+/**
+ * Get the active specification from .specforge.json.
+ *
+ * @returns ActiveSpecification if set, null if no spec is activated
+ */
+export function getActiveSpecificationContext() {
+    const config = loadProjectConfig();
+    return resolveActiveSpecification(config);
+}
+/**
+ * Get the monorepo config from .specforge.json.
+ *
+ * @returns MonorepoConfig with defaults applied, or null if section absent
+ */
+export function getMonorepoContext() {
+    const config = loadProjectConfig();
+    return resolveMonorepoConfig(config);
+}
 /**
  * Inject missing context fields from .specforge.json
  * Explicit args always take precedence over config values

package/dist/tools/core/context-helper.js.map

@@ -1 +1 @@
-{"version":3,"file":"context-helper.js","sourceRoot":"","sources":["../../../src/tools/core/context-helper.ts"],"names":[],"mappings":"AAAA,uCAAuC;AAEvC;;;;;;GAMG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAS/D;;;GAGG;AACH,SAAS,eAAe;IACtB,MAAM,MAAM,GAAG,iBAAiB,EAAE,CAAC;IACnC,OAAO;QACL,SAAS,EAAE,MAAM,EAAE,SAAS;QAC5B,eAAe,EAAE,MAAM,EAAE,eAAe;KACzC,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa,CAC3B,IAAO,EACP,MAAsB;IAEtB,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IACnD,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAE5C,MAAM,OAAO,GAAG,eAAe,EAAE,CAAC;IAClC,MAAM,MAAM,GAA4B,EAAE,GAAG,IAAI,EAAE,CAAC;IAEpD,KAAK,MAAM,KAAK,IAAI,aAAa,EAAE,CAAC;QAClC,IAAI,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACnB,MAAM,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;QACjC,CAAC;IACH,CAAC;IACD,OAAO,MAAW,CAAC;AACrB,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,qBAAqB,CACnC,IAAO,EACP,cAA8B,EAC9B,iBAAiC,EAAE;IAEnC,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,EAAE,CAAC,GAAG,cAAc,EAAE,GAAG,cAAc,CAAC,CAAC,CAAC;IAE3E,MAAM,OAAO,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IACvD,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CACb,6BAA6B,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI;YACnD,sEAAsE,CACvE,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}
+{"version":3,"file":"context-helper.js","sourceRoot":"","sources":["../../../src/tools/core/context-helper.ts"],"names":[],"mappings":"AAAA,uCAAuC;AAEvC;;;;;;;;;;GAUG;AAEH,OAAO,EACL,iBAAiB,EACjB,mBAAmB,IAAI,uBAAuB,EAC9C,sBAAsB,IAAI,0BAA0B,EACpD,iBAAiB,IAAI,qBAAqB,GAC3C,MAAM,4BAA4B,CAAC;AAcpC;;;GAGG;AACH,SAAS,eAAe;IACtB,MAAM,MAAM,GAAG,iBAAiB,EAAE,CAAC;IACnC,OAAO;QACL,SAAS,EAAE,MAAM,EAAE,SAAS;QAC5B,eAAe,EAAE,MAAM,EAAE,eAAe;KACzC,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,+BAA+B;AAC/B,8EAA8E;AAE9E;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB;IAClC,MAAM,MAAM,GAAG,iBAAiB,EAAE,CAAC;IACnC,OAAO,uBAAuB,CAAC,MAAM,CAAC,CAAC;AACzC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,6BAA6B;IAC3C,MAAM,MAAM,GAAG,iBAAiB,EAAE,CAAC;IACnC,OAAO,0BAA0B,CAAC,MAAM,CAAC,CAAC;AAC5C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB;IAChC,MAAM,MAAM,GAAG,iBAAiB,EAAE,CAAC;IACnC,OAAO,qBAAqB,CAAC,MAAM,CAAC,CAAC;AACvC,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa,CAC3B,IAAO,EACP,MAAsB;IAEtB,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IACnD,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAE5C,MAAM,OAAO,GAAG,eAAe,EAAE,CAAC;IAClC,MAAM,MAAM,GAA4B,EAAE,GAAG,IAAI,EAAE,CAAC;IAEpD,KAAK,MAAM,KAAK,IAAI,aAAa,EAAE,CAAC;QAClC,IAAI,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACnB,MAAM,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;QACjC,CAAC;IACH,CAAC;IACD,OAAO,MAAW,CAAC;AACrB,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,qBAAqB,CACnC,IAAO,EACP,cAA8B,EAC9B,iBAAiC,EAAE;IAEnC,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,EAAE,CAAC,GAAG,cAAc,EAAE,GAAG,cAAc,CAAC,CAAC,CAAC;IAE3E,MAAM,OAAO,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IACvD,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CACb,6BAA6B,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI;YACnD,sEAAsE,CACvE,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/tools/core/workspace-files.d.ts

@@ -0,0 +1,49 @@
+interface PackageJsonSummary {
+    name: string;
+    version?: string;
+    scripts: Record<string, string>;
+    dependencies: Record<string, string>;
+    devDependencies: Record<string, string>;
+}
+interface TsConfigSummary {
+    compilerOptions: Record<string, unknown> | null;
+    paths: Record<string, string[]> | null;
+}
+interface WorkspaceMetadata {
+    /** Absolute path to the workspace */
+    path: string;
+    /** Package name from package.json */
+    name: string | null;
+    /** Detected framework (Next.js, Express, React, etc.) */
+    framework: string | null;
+    /** Whether the workspace has tests */
+    hasTests: boolean;
+    /** Test command from scripts */
+    testCommand: string | null;
+    /** Lint command from scripts */
+    lintCommand: string | null;
+    /** Type check command from scripts */
+    typecheckCommand: string | null;
+    /** Build command from scripts */
+    buildCommand: string | null;
+    /** Parsed package.json summary (null if not found) */
+    packageJson: PackageJsonSummary | null;
+    /** Parsed tsconfig.json summary (null if not found) */
+    tsConfig: TsConfigSummary | null;
+    /** First 50 lines of README.md (null if not found) */
+    readme: string | null;
+    /** Contents of .env.example (null if not found) */
+    envExample: string | null;
+    /** Key dependencies relevant to the workspace */
+    keyDependencies: Record<string, string>;
+}
+/**
+ * Get workspace metadata for a given directory path.
+ *
+ * @param args.workspacePath - Path to the workspace (absolute or relative to projectRoot)
+ * @param args.projectRoot - Optional project root for resolving relative paths
+ * @returns Structured workspace metadata
+ */
+export declare function getWorkspaceFiles(args: Record<string, unknown>): Promise<WorkspaceMetadata>;
+export {};
+//# sourceMappingURL=workspace-files.d.ts.map

package/dist/tools/core/workspace-files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-files.d.ts","sourceRoot":"","sources":["../../../src/tools/core/workspace-files.ts"],"names":[],"mappings":"AAqBA,UAAU,kBAAkB;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACzC;AAED,UAAU,eAAe;IACvB,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAChD,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,GAAG,IAAI,CAAC;CACxC;AAED,UAAU,iBAAiB;IACzB,qCAAqC;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,qCAAqC;IACrC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,yDAAyD;IACzD,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,sCAAsC;IACtC,QAAQ,EAAE,OAAO,CAAC;IAClB,gCAAgC;IAChC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,gCAAgC;IAChC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,sCAAsC;IACtC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,iCAAiC;IACjC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,sDAAsD;IACtD,WAAW,EAAE,kBAAkB,GAAG,IAAI,CAAC;IACvC,uDAAuD;IACvD,QAAQ,EAAE,eAAe,GAAG,IAAI,CAAC;IACjC,sDAAsD;IACtD,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,mDAAmD;IACnD,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,iDAAiD;IACjD,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACzC;AAkKD;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,iBAAiB,CAAC,CAyG5B"}