@specforge/mcp 3.0.7 → 3.1.1

package/dist/tools/core/workspace-files.js

@@ -0,0 +1,259 @@
+// mcp/src/tools/core/workspace-files.ts
+/**
+ * Workspace Files Tool
+ *
+ * Local filesystem operation that returns workspace metadata needed by workers.
+ * Given a workspace path (or auto-detected from project root), returns parsed
+ * configuration files, framework detection, and key dependency information.
+ *
+ * NOTE: This runs locally in the MCP server (stdio transport). It requires
+ * filesystem access and will not work over SSE/cloud transports.
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { findProjectRoot } from '../../cli/config/paths.js';
+// ============================================================================
+// Framework detection mapping
+// ============================================================================
+const FRAMEWORK_DETECTION = {
+    'next': 'Next.js',
+    'nuxt': 'Nuxt',
+    '@nestjs/core': 'NestJS',
+    'express': 'Express',
+    'fastify': 'Fastify',
+    '@angular/core': 'Angular',
+    'react': 'React',
+    'vue': 'Vue',
+    'svelte': 'Svelte',
+    '@remix-run/react': 'Remix',
+    'gatsby': 'Gatsby',
+    'hono': 'Hono',
+    'elysia': 'Elysia',
+};
+/**
+ * Well-known dependencies that are useful context for workers.
+ * Only included if present in the workspace.
+ */
+const KEY_DEPENDENCY_NAMES = new Set([
+    // Frameworks
+    'next', 'react', 'react-dom', 'vue', 'angular', 'svelte', 'express', 'fastify', '@nestjs/core',
+    // State management
+    'redux', '@reduxjs/toolkit', 'zustand', 'mobx', 'jotai', 'recoil',
+    // UI
+    '@mui/material', '@chakra-ui/react', 'tailwindcss', 'styled-components', '@emotion/react',
+    // Data fetching
+    'axios', '@tanstack/react-query', 'swr', '@apollo/client', 'graphql',
+    // Database
+    'prisma', '@prisma/client', 'drizzle-orm', 'typeorm', 'sequelize', 'mongoose', 'knex',
+    // Auth
+    'next-auth', 'passport', 'jsonwebtoken', '@auth/core',
+    // Testing
+    'jest', 'vitest', '@testing-library/react', 'playwright', 'cypress', 'mocha',
+    // AWS
+    'aws-amplify', '@aws-sdk/client-s3', '@aws-sdk/client-dynamodb', 'aws-cdk-lib',
+    // Build tools
+    'typescript', 'vite', 'webpack', 'esbuild', 'turbo',
+    // Linting
+    'eslint', 'prettier', 'biome',
+]);
+// ============================================================================
+// Implementation
+// ============================================================================
+/**
+ * Read and parse a JSON file. Returns null if file is missing or invalid.
+ */
+function readJsonFile(filePath) {
+    try {
+        const content = fs.readFileSync(filePath, 'utf-8');
+        return JSON.parse(content);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Read a text file. Returns null if file is missing.
+ */
+function readTextFile(filePath) {
+    try {
+        return fs.readFileSync(filePath, 'utf-8');
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Read the first N lines of a text file. Returns null if file is missing.
+ */
+function readFirstLines(filePath, maxLines) {
+    try {
+        const content = fs.readFileSync(filePath, 'utf-8');
+        const lines = content.split('\n').slice(0, maxLines);
+        return lines.join('\n');
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Detect framework from dependencies.
+ * Checks in priority order (more specific frameworks first).
+ */
+function detectFramework(deps) {
+    for (const [pkg, name] of Object.entries(FRAMEWORK_DETECTION)) {
+        if (pkg in deps) {
+            return name;
+        }
+    }
+    return null;
+}
+/**
+ * Extract key dependencies from package.json deps/devDeps.
+ */
+function extractKeyDependencies(deps, devDeps) {
+    const result = {};
+    const all = { ...deps, ...devDeps };
+    for (const [name, version] of Object.entries(all)) {
+        if (KEY_DEPENDENCY_NAMES.has(name)) {
+            result[name] = version;
+        }
+    }
+    return result;
+}
+/**
+ * Check if the workspace has tests by looking at scripts and directories.
+ */
+function detectHasTests(workspacePath, scripts) {
+    // Check for test script
+    if (scripts.test && scripts.test !== 'echo "Error: no test specified" && exit 1') {
+        return true;
+    }
+    // Check for common test directories
+    const testDirs = ['__tests__', 'test', 'tests', 'spec'];
+    for (const dir of testDirs) {
+        const dirPath = path.join(workspacePath, dir);
+        try {
+            if (fs.statSync(dirPath).isDirectory()) {
+                return true;
+            }
+        }
+        catch {
+            // Directory doesn't exist
+        }
+    }
+    // Check for test files in src
+    const srcDir = path.join(workspacePath, 'src');
+    try {
+        if (fs.statSync(srcDir).isDirectory()) {
+            const srcTestDir = path.join(srcDir, '__tests__');
+            if (fs.statSync(srcTestDir).isDirectory()) {
+                return true;
+            }
+        }
+    }
+    catch {
+        // Directory doesn't exist
+    }
+    return false;
+}
+/**
+ * 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 async function getWorkspaceFiles(args) {
+    let workspacePath = args.workspacePath;
+    const projectRoot = args.projectRoot || findProjectRoot() || process.cwd();
+    // Resolve workspace path
+    if (workspacePath) {
+        workspacePath = path.resolve(projectRoot, workspacePath);
+    }
+    else {
+        workspacePath = projectRoot;
+    }
+    // Verify directory exists
+    try {
+        const stat = fs.statSync(workspacePath);
+        if (!stat.isDirectory()) {
+            throw new Error(`Path is not a directory: ${workspacePath}`);
+        }
+    }
+    catch (err) {
+        if (err.code === 'ENOENT') {
+            throw new Error(`Workspace directory not found: ${workspacePath}`);
+        }
+        throw err;
+    }
+    // Read package.json
+    const pkgJsonPath = path.join(workspacePath, 'package.json');
+    const rawPkg = readJsonFile(pkgJsonPath);
+    let packageJson = null;
+    let name = null;
+    let framework = null;
+    let scripts = {};
+    let deps = {};
+    let devDeps = {};
+    let keyDependencies = {};
+    if (rawPkg) {
+        name = rawPkg.name || null;
+        scripts = rawPkg.scripts || {};
+        deps = rawPkg.dependencies || {};
+        devDeps = rawPkg.devDependencies || {};
+        packageJson = {
+            name: name || '',
+            version: rawPkg.version,
+            scripts,
+            dependencies: deps,
+            devDependencies: devDeps,
+        };
+        framework = detectFramework({ ...deps, ...devDeps });
+        keyDependencies = extractKeyDependencies(deps, devDeps);
+    }
+    // Read tsconfig.json
+    const tsconfigPath = path.join(workspacePath, 'tsconfig.json');
+    const rawTsConfig = readJsonFile(tsconfigPath);
+    let tsConfig = null;
+    if (rawTsConfig) {
+        const compilerOptions = rawTsConfig.compilerOptions || null;
+        const paths = compilerOptions?.paths;
+        tsConfig = {
+            compilerOptions,
+            paths: paths || null,
+        };
+    }
+    // Read README.md (first 50 lines)
+    const readmePath = path.join(workspacePath, 'README.md');
+    const readme = readFirstLines(readmePath, 50);
+    // Read .env.example
+    const envExamplePath = path.join(workspacePath, '.env.example');
+    const envExample = readTextFile(envExamplePath);
+    // Detect test/lint/typecheck commands
+    const hasTests = detectHasTests(workspacePath, scripts);
+    const testCommand = scripts.test || null;
+    const lintCommand = scripts.lint || null;
+    const buildCommand = scripts.build || null;
+    // Detect typecheck command
+    let typecheckCommand = scripts.typecheck || scripts['type-check'] || null;
+    if (!typecheckCommand && rawTsConfig) {
+        // If tsconfig exists but no typecheck script, suggest one
+        typecheckCommand = 'npx tsc --noEmit';
+    }
+    return {
+        path: workspacePath,
+        name,
+        framework,
+        hasTests,
+        testCommand,
+        lintCommand,
+        typecheckCommand,
+        buildCommand,
+        packageJson,
+        tsConfig,
+        readme,
+        envExample,
+        keyDependencies,
+    };
+}
+//# sourceMappingURL=workspace-files.js.map

package/dist/tools/core/workspace-files.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-files.js","sourceRoot":"","sources":["../../../src/tools/core/workspace-files.ts"],"names":[],"mappings":"AAAA,wCAAwC;AAExC;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAgD5D,+EAA+E;AAC/E,8BAA8B;AAC9B,+EAA+E;AAE/E,MAAM,mBAAmB,GAA2B;IAClD,MAAM,EAAE,SAAS;IACjB,MAAM,EAAE,MAAM;IACd,cAAc,EAAE,QAAQ;IACxB,SAAS,EAAE,SAAS;IACpB,SAAS,EAAE,SAAS;IACpB,eAAe,EAAE,SAAS;IAC1B,OAAO,EAAE,OAAO;IAChB,KAAK,EAAE,KAAK;IACZ,QAAQ,EAAE,QAAQ;IAClB,kBAAkB,EAAE,OAAO;IAC3B,QAAQ,EAAE,QAAQ;IAClB,MAAM,EAAE,MAAM;IACd,QAAQ,EAAE,QAAQ;CACnB,CAAC;AAEF;;;GAGG;AACH,MAAM,oBAAoB,GAAG,IAAI,GAAG,CAAC;IACnC,aAAa;IACb,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,cAAc;IAC9F,mBAAmB;IACnB,OAAO,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ;IACjE,KAAK;IACL,eAAe,EAAE,kBAAkB,EAAE,aAAa,EAAE,mBAAmB,EAAE,gBAAgB;IACzF,gBAAgB;IAChB,OAAO,EAAE,uBAAuB,EAAE,KAAK,EAAE,gBAAgB,EAAE,SAAS;IACpE,WAAW;IACX,QAAQ,EAAE,gBAAgB,EAAE,aAAa,EAAE,SAAS,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM;IACrF,OAAO;IACP,WAAW,EAAE,UAAU,EAAE,cAAc,EAAE,YAAY;IACrD,UAAU;IACV,MAAM,EAAE,QAAQ,EAAE,wBAAwB,EAAE,YAAY,EAAE,SAAS,EAAE,OAAO;IAC5E,MAAM;IACN,aAAa,EAAE,oBAAoB,EAAE,0BAA0B,EAAE,aAAa;IAC9E,cAAc;IACd,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,OAAO;IACnD,UAAU;IACV,QAAQ,EAAE,UAAU,EAAE,OAAO;CAC9B,CAAC,CAAC;AAEH,+EAA+E;AAC/E,iBAAiB;AACjB,+EAA+E;AAE/E;;GAEG;AACH,SAAS,YAAY,CAAI,QAAgB;IACvC,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACnD,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAM,CAAC;IAClC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAS,YAAY,CAAC,QAAgB;IACpC,IAAI,CAAC;QACH,OAAO,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC5C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAS,cAAc,CAAC,QAAgB,EAAE,QAAgB;IACxD,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACnD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;QACrD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,SAAS,eAAe,CAAC,IAA4B;IACnD,KAAK,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,mBAAmB,CAAC,EAAE,CAAC;QAC9D,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC;YAChB,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;GAEG;AACH,SAAS,sBAAsB,CAC7B,IAA4B,EAC5B,OAA+B;IAE/B,MAAM,MAAM,GAA2B,EAAE,CAAC;IAC1C,MAAM,GAAG,GAAG,EAAE,GAAG,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC;IAEpC,KAAK,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QAClD,IAAI,oBAAoB,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YACnC,MAAM,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC;QACzB,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,SAAS,cAAc,CACrB,aAAqB,EACrB,OAA+B;IAE/B,wBAAwB;IACxB,IAAI,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,IAAI,KAAK,2CAA2C,EAAE,CAAC;QACjF,OAAO,IAAI,CAAC;IACd,CAAC;IAED,oCAAoC;IACpC,MAAM,QAAQ,GAAG,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;IACxD,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;QAC3B,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC;QAC9C,IAAI,CAAC;YACH,IAAI,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC;gBACvC,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,0BAA0B;QAC5B,CAAC;IACH,CAAC;IAED,8BAA8B;IAC9B,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,KAAK,CAAC,CAAC;IAC/C,IAAI,CAAC;QACH,IAAI,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC;YACtC,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;YAClD,IAAI,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC;gBAC1C,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,0BAA0B;IAC5B,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,IAA6B;IAE7B,IAAI,aAAa,GAAG,IAAI,CAAC,aAAmC,CAAC;IAC7D,MAAM,WAAW,GAAI,IAAI,CAAC,WAAkC,IAAI,eAAe,EAAE,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IAEnG,yBAAyB;IACzB,IAAI,aAAa,EAAE,CAAC;QAClB,aAAa,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC;IAC3D,CAAC;SAAM,CAAC;QACN,aAAa,GAAG,WAAW,CAAC;IAC9B,CAAC;IAED,0BAA0B;IAC1B,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,EAAE,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC;QACxC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,4BAA4B,aAAa,EAAE,CAAC,CAAC;QAC/D,CAAC;IACH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAK,GAA6B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACrD,MAAM,IAAI,KAAK,CAAC,kCAAkC,aAAa,EAAE,CAAC,CAAC;QACrE,CAAC;QACD,MAAM,GAAG,CAAC;IACZ,CAAC;IAED,oBAAoB;IACpB,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,cAAc,CAAC,CAAC;IAC7D,MAAM,MAAM,GAAG,YAAY,CAA0B,WAAW,CAAC,CAAC;IAElE,IAAI,WAAW,GAA8B,IAAI,CAAC;IAClD,IAAI,IAAI,GAAkB,IAAI,CAAC;IAC/B,IAAI,SAAS,GAAkB,IAAI,CAAC;IACpC,IAAI,OAAO,GAA2B,EAAE,CAAC;IACzC,IAAI,IAAI,GAA2B,EAAE,CAAC;IACtC,IAAI,OAAO,GAA2B,EAAE,CAAC;IACzC,IAAI,eAAe,GAA2B,EAAE,CAAC;IAEjD,IAAI,MAAM,EAAE,CAAC;QACX,IAAI,GAAI,MAAM,CAAC,IAAe,IAAI,IAAI,CAAC;QACvC,OAAO,GAAI,MAAM,CAAC,OAAkC,IAAI,EAAE,CAAC;QAC3D,IAAI,GAAI,MAAM,CAAC,YAAuC,IAAI,EAAE,CAAC;QAC7D,OAAO,GAAI,MAAM,CAAC,eAA0C,IAAI,EAAE,CAAC;QAEnE,WAAW,GAAG;YACZ,IAAI,EAAE,IAAI,IAAI,EAAE;YAChB,OAAO,EAAE,MAAM,CAAC,OAA6B;YAC7C,OAAO;YACP,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,OAAO;SACzB,CAAC;QAEF,SAAS,GAAG,eAAe,CAAC,EAAE,GAAG,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;QACrD,eAAe,GAAG,sBAAsB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC1D,CAAC;IAED,qBAAqB;IACrB,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,eAAe,CAAC,CAAC;IAC/D,MAAM,WAAW,GAAG,YAAY,CAA0B,YAAY,CAAC,CAAC;IAExE,IAAI,QAAQ,GAA2B,IAAI,CAAC;IAC5C,IAAI,WAAW,EAAE,CAAC;QAChB,MAAM,eAAe,GAAI,WAAW,CAAC,eAA2C,IAAI,IAAI,CAAC;QACzF,MAAM,KAAK,GAAG,eAAe,EAAE,KAA6C,CAAC;QAE7E,QAAQ,GAAG;YACT,eAAe;YACf,KAAK,EAAE,KAAK,IAAI,IAAI;SACrB,CAAC;IACJ,CAAC;IAED,kCAAkC;IAClC,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,WAAW,CAAC,CAAC;IACzD,MAAM,MAAM,GAAG,cAAc,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IAE9C,oBAAoB;IACpB,MAAM,cAAc,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,cAAc,CAAC,CAAC;IAChE,MAAM,UAAU,GAAG,YAAY,CAAC,cAAc,CAAC,CAAC;IAEhD,sCAAsC;IACtC,MAAM,QAAQ,GAAG,cAAc,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;IACxD,MAAM,WAAW,GAAG,OAAO,CAAC,IAAI,IAAI,IAAI,CAAC;IACzC,MAAM,WAAW,GAAG,OAAO,CAAC,IAAI,IAAI,IAAI,CAAC;IACzC,MAAM,YAAY,GAAG,OAAO,CAAC,KAAK,IAAI,IAAI,CAAC;IAE3C,2BAA2B;IAC3B,IAAI,gBAAgB,GAAkB,OAAO,CAAC,SAAS,IAAI,OAAO,CAAC,YAAY,CAAC,IAAI,IAAI,CAAC;IACzF,IAAI,CAAC,gBAAgB,IAAI,WAAW,EAAE,CAAC;QACrC,0DAA0D;QAC1D,gBAAgB,GAAG,kBAAkB,CAAC;IACxC,CAAC;IAED,OAAO;QACL,IAAI,EAAE,aAAa;QACnB,IAAI;QACJ,SAAS;QACT,QAAQ;QACR,WAAW;QACX,WAAW;QACX,gBAAgB;QAChB,YAAY;QACZ,WAAW;QACX,QAAQ;QACR,MAAM;QACN,UAAU;QACV,eAAe;KAChB,CAAC;AACJ,CAAC"}

package/dist/tools/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACpD,OAAO,EAML,gBAAgB,EAKjB,MAAM,wBAAwB,CAAC;AAwBhC;;GAEG;AACH,MAAM,WAAW,IAAI;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ,CAAC;QACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACpC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;KACrB,CAAC;CACH;AAgFD,wBAAgB,QAAQ,IAAI,IAAI,EAAE,CAugFjC;AAED;;GAEG;AACH,KAAK,WAAW,GAAG,CACjB,SAAS,EAAE,SAAS,EACpB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC1B,OAAO,CAAC,OAAO,CAAC,CAAC;AA6EtB;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,SAAS,GACnB,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAmoC7B;AAqCD;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAExC;AAED;;;;;;;;GAQG;AACH,wBAAsB,cAAc,CAClC,SAAS,EAAE,SAAS,EACpB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,KAAK,GAAE,OAAe,GACrB,OAAO,CAAC,OAAO,CAAC,CA4DlB;AAED;;;;;;;;;GASG;AACH,wBAAsB,kBAAkB,CACtC,SAAS,EAAE,SAAS,EACpB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,KAAK,GAAE,OAAe,GACrB,OAAO,CAAC,OAAO,GAAG,gBAAgB,CAAC,CAOrC;AAGD,OAAO,EACL,eAAe,EACf,QAAQ,EACR,gBAAgB,EAChB,cAAc,EACd,cAAc,EACd,KAAK,gBAAgB,GACtB,MAAM,wBAAwB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACpD,OAAO,EAML,gBAAgB,EAKjB,MAAM,wBAAwB,CAAC;AA2BhC;;GAEG;AACH,MAAM,WAAW,IAAI;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ,CAAC;QACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACpC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;KACrB,CAAC;CACH;AAmFD,wBAAgB,QAAQ,IAAI,IAAI,EAAE,CAsmFjC;AAED;;GAEG;AACH,KAAK,WAAW,GAAG,CACjB,SAAS,EAAE,SAAS,EACpB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC1B,OAAO,CAAC,OAAO,CAAC,CAAC;AA6EtB;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,SAAS,GACnB,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAsrC7B;AAqCD;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAExC;AAED;;;;;;;;GAQG;AACH,wBAAsB,cAAc,CAClC,SAAS,EAAE,SAAS,EACpB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,KAAK,GAAE,OAAe,GACrB,OAAO,CAAC,OAAO,CAAC,CA4DlB;AAED;;;;;;;;;GASG;AACH,wBAAsB,kBAAkB,CACtC,SAAS,EAAE,SAAS,EACpB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,KAAK,GAAE,OAAe,GACrB,OAAO,CAAC,OAAO,GAAG,gBAAgB,CAAC,CAOrC;AAGD,OAAO,EACL,eAAe,EACf,QAAQ,EACR,gBAAgB,EAChB,cAAc,EACd,cAAc,EACd,KAAK,gBAAgB,GACtB,MAAM,wBAAwB,CAAC"}

package/dist/tools/index.js

@@ -22,6 +22,9 @@ import { createWorkflowGuideHandler } from './core/workflow-guide.js';
 import { blueprintTool, createBlueprintHandler } from './core/blueprint.js';
 import { WORKFLOW_TYPES } from '../lib/workflow-definitions.js';
 import { injectContext, injectContextRequired } from './core/context-helper.js';
+import { getWorkspaceFiles } from './core/workspace-files.js';
+import { detectMonorepo } from '../lib/monorepo-detector.js';
+import { findProjectRoot } from '../cli/config/paths.js';
 /**
  * Get list of all available tools
  *
@@ -81,6 +84,9 @@ const READ_TOOL_NAMES = new Set([
     'get_working_context',
     // Job status
     'get_job_status',
+    // Agent Teams (read operations)
+    'get_epic_dependency_graph',
+    'get_implementation_plan',
 ]);
 /**
  * Add format parameter to a tool's input schema
@@ -2631,6 +2637,101 @@ At least one scope filter (projectId, specificationId, or epicId) is required.`,
                 required: ['specificationId'],
             },
         },
+        // ========================================================================
+        // Agent Teams Operations
+        // ========================================================================
+        {
+            name: 'get_epic_dependency_graph',
+            description: 'Analyze cross-epic dependencies for a specification. Returns an epic-level dependency graph with topological phase ordering. Use this to understand which epics can run in parallel and which must be sequenced.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    specificationId: {
+                        type: 'string',
+                        description: 'The ID of the specification to analyze',
+                    },
+                },
+                required: ['specificationId'],
+            },
+        },
+        {
+            name: 'get_implementation_plan',
+            description: 'Generate a team-worker mapping for parallel implementation of a specification. Analyzes the spec structure and produces teams (one per epic), execution phases, and suggested worker counts. Supports strategies: epic-as-team (multiple epics), spec-as-team (single epic, multiple workers), single-session (small scope).',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    specificationId: {
+                        type: 'string',
+                        description: 'The ID of the specification to plan',
+                    },
+                    strategy: {
+                        type: 'string',
+                        enum: ['epic-as-team', 'spec-as-team', 'single-session', 'auto'],
+                        description: "Strategy for team formation. 'auto' (default) selects based on spec structure. 'epic-as-team' creates one team per epic. 'spec-as-team' creates a single team. 'single-session' for small sequential work.",
+                        default: 'auto',
+                    },
+                    maxWorkersPerTeam: {
+                        type: 'number',
+                        description: 'Maximum number of parallel workers per team (default: 3)',
+                        default: 3,
+                    },
+                },
+                required: ['specificationId'],
+            },
+        },
+        {
+            name: 'report_completion',
+            description: "Report completion of an epic or specification. Updates the entity status to 'completed', stores the completion summary, and returns metrics. Supports partial completion (not all tickets/epics done). Idempotent: calling on an already-completed entity returns current state.",
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    entityType: {
+                        type: 'string',
+                        enum: ['epic', 'specification'],
+                        description: "Type of entity to mark as completed: 'epic' or 'specification'",
+                    },
+                    entityId: {
+                        type: 'string',
+                        description: 'The ID of the epic or specification to complete',
+                    },
+                    summary: {
+                        type: 'string',
+                        description: 'Completion summary describing what was accomplished',
+                    },
+                    metrics: {
+                        type: 'object',
+                        description: 'Optional completion metrics (auto-calculated from tickets if not provided)',
+                        properties: {
+                            completedTickets: { type: 'number', description: 'Number of tickets completed' },
+                            totalTickets: { type: 'number', description: 'Total number of tickets' },
+                            failedTickets: { type: 'number', description: 'Number of tickets that failed' },
+                            totalHours: { type: 'number', description: 'Total hours spent' },
+                        },
+                    },
+                },
+                required: ['entityType', 'entityId', 'summary'],
+            },
+        },
+        // ========================================================================
+        // Agent Teams - Workspace Files (Local-only)
+        // ========================================================================
+        {
+            name: 'get_workspace_files',
+            description: 'Get workspace metadata for agent workers. Returns parsed package.json, tsconfig.json, framework detection, key dependencies, and validation commands. Runs locally (requires stdio transport).',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    workspacePath: {
+                        type: 'string',
+                        description: 'Path to the workspace directory (absolute or relative to project root). Defaults to project root if not provided.',
+                    },
+                    projectRoot: {
+                        type: 'string',
+                        description: 'Override project root for resolving relative workspacePath. Auto-detected from .specforge.json if not provided.',
+                    },
+                },
+            },
+        },
     ];
     // Apply format parameter to all read operations
     return tools.map(tool => READ_TOOL_NAMES.has(tool.name) ? addFormatParameter(tool) : tool);
@@ -3750,6 +3851,52 @@ export function createToolHandlers(apiClient) {
                 specificationId: args.specificationId,
             });
         },
+        // ========================================================================
+        // Agent Teams Operations
+        // ========================================================================
+        get_epic_dependency_graph: async (_client, args) => {
+            validateRequired(args, 'specificationId');
+            return await apiClient.call('get_epic_dependency_graph', {
+                specificationId: args.specificationId,
+                ...injectContext(args, ['specificationId']),
+            });
+        },
+        get_implementation_plan: async (_client, args) => {
+            validateRequired(args, 'specificationId');
+            // Detect monorepo locally (local-only feature, graceful degradation)
+            let monorepoInfo = null;
+            try {
+                const projectRoot = findProjectRoot();
+                if (projectRoot) {
+                    monorepoInfo = detectMonorepo(projectRoot);
+                }
+            }
+            catch {
+                // Skip monorepo detection on failure
+            }
+            return await apiClient.call('get_implementation_plan', {
+                specificationId: args.specificationId,
+                strategy: args.strategy,
+                maxWorkersPerTeam: args.maxWorkersPerTeam,
+                monorepoInfo,
+                ...injectContext(args, ['specificationId']),
+            });
+        },
+        report_completion: async (_client, args) => {
+            validateRequired(args, 'entityType', 'entityId', 'summary');
+            return await apiClient.call('report_completion', {
+                entityType: args.entityType,
+                entityId: args.entityId,
+                summary: args.summary,
+                metrics: args.metrics,
+            });
+        },
+        // ========================================================================
+        // Agent Teams - Workspace Files (Local-only)
+        // ========================================================================
+        get_workspace_files: async (_client, args) => {
+            return await getWorkspaceFiles(args);
+        },
     };
 }
 /**