agents-harness 0.1.0

package/dist/defaults/prompts.js

@@ -0,0 +1,123 @@
+import { DEFAULT_CRITERIA } from "./criteria.js";
+const PLANNER_BASE = `You are a product planner. Your job is to convert user descriptions into comprehensive product specifications, break them into sprints, and write sprint contracts.
+
+RULES:
+- Focus on WHAT to build, not HOW to implement it
+- Be ambitious in scope — define the full feature
+- Define user-facing behavior, not internal architecture
+- Break complex features into ordered milestones (sprints)
+- Each sprint must be independently testable
+- Never write code. Never suggest file names or specific implementations.
+- Write your output to the file specified in the task prompt.`;
+const GENERATOR_BASE = `You are a code generator. You implement features based on a sprint contract.
+
+RULES:
+- Read .harness/contract.md for what to build
+- If .harness/evaluation.md exists, read it for feedback from a previous attempt
+- If .harness/handoff.md exists, read it for context from a previous sprint
+- Implement EXACTLY what the contract specifies — no more, no less
+- Follow project conventions from CLAUDE.md
+- Run the test suite before finishing. Fix any test failures.
+- Commit your work with conventional commit messages.
+- Do NOT evaluate your own work. Do NOT say "this looks good" or "everything is working."
+  Your job is to implement, not judge. A separate evaluator will assess your work.`;
+const EVALUATOR_BASE = `You are a critical code evaluator. Your job is to find problems.
+
+MINDSET:
+- Be skeptical. Assume things are broken until proven otherwise.
+- Never give the benefit of the doubt.
+- A feature that "should work" but wasn't tested does NOT pass.
+- Stubbed, mocked, or placeholder implementations in production code are automatic failures.
+- If you can't verify it, it fails.
+
+PROCESS:
+1. Read .harness/contract.md for what was promised
+2. Read the actual code that was written (use Grep and Read)
+3. Run the test suite
+4. Check each success criterion from the contract individually
+5. Write your evaluation to .harness/evaluation.md
+
+YOUR OUTPUT FORMAT (write to .harness/evaluation.md):
+Status: PASS or FAIL
+Failed criteria:
+- (list each criterion that failed, one per line)
+Passed criteria:
+- (list each criterion that passed, one per line)
+Critique: (specific, actionable feedback for each failure — what's wrong and what needs to change)`;
+const BASE_PROMPTS = {
+    planner: PLANNER_BASE,
+    generator: GENERATOR_BASE,
+    evaluator: EVALUATOR_BASE,
+};
+/**
+ * Format a ProjectContext into a readable text block for inclusion in system prompts.
+ */
+export function formatProjectContext(ctx) {
+    const lines = [];
+    lines.push(`Repository type: ${ctx.repoType}`);
+    lines.push(`Root: ${ctx.root}`);
+    if (ctx.scope && ctx.scope.length > 0) {
+        lines.push(`Scope: ${ctx.scope.join(", ")}`);
+    }
+    lines.push("");
+    lines.push("Workspaces:");
+    for (const ws of ctx.workspaces) {
+        lines.push(`  - ${ws.path}`);
+        lines.push(`    Language: ${ws.stack.language}`);
+        if (ws.stack.framework) {
+            lines.push(`    Framework: ${ws.stack.framework}`);
+        }
+        if (ws.stack.testRunner) {
+            lines.push(`    Test runner: ${ws.stack.testRunner}`);
+        }
+        lines.push(`    Test command: ${ws.stack.testCommand}`);
+        if (ws.stack.lintCommand) {
+            lines.push(`    Lint command: ${ws.stack.lintCommand}`);
+        }
+        if (ws.stack.buildCommand) {
+            lines.push(`    Build command: ${ws.stack.buildCommand}`);
+        }
+        if (ws.stack.devServer) {
+            lines.push(`    Dev server: ${ws.stack.devServer}`);
+        }
+        if (ws.claudeMd) {
+            lines.push(`    CLAUDE.md: ${ws.claudeMd}`);
+        }
+    }
+    if (ctx.rootClaudeMd) {
+        lines.push("");
+        lines.push("CLAUDE.md:");
+        lines.push(ctx.rootClaudeMd);
+    }
+    return lines.join("\n");
+}
+/**
+ * Build a full system prompt for an agent role.
+ *
+ * Assembles:
+ * 1. Base prompt for the role
+ * 2. PROJECT CONTEXT section (formatted project context)
+ * 3. EVALUATION CRITERIA section (evaluator only — default + custom criteria)
+ * 4. ADDITIONAL INSTRUCTIONS section (appendPrompt if provided)
+ */
+export function buildSystemPrompt(role, ctx, appendPrompt) {
+    const sections = [];
+    // 1. Base prompt
+    sections.push(BASE_PROMPTS[role]);
+    // 2. Project context
+    sections.push(`\n\n## PROJECT CONTEXT\n\n${formatProjectContext(ctx)}`);
+    // 3. Evaluation criteria (evaluator only)
+    if (role === "evaluator") {
+        let criteriaBlock = DEFAULT_CRITERIA;
+        if (ctx.criteria) {
+            criteriaBlock += `\n\n## Custom Criteria\n\n${ctx.criteria}`;
+        }
+        sections.push(`\n\n## EVALUATION CRITERIA\n\n${criteriaBlock}`);
+    }
+    // 4. Additional instructions
+    if (appendPrompt) {
+        sections.push(`\n\n## ADDITIONAL INSTRUCTIONS\n\n${appendPrompt}`);
+    }
+    return sections.join("");
+}
+//# sourceMappingURL=prompts.js.map

package/dist/defaults/prompts.js.map

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

package/dist/discovery/config-loader.d.ts

@@ -0,0 +1,12 @@
+import type { HarnessConfig } from "../core/types.js";
+/**
+ * Load and parse `.harness/config.yaml` from the given root directory.
+ * Returns null if the file does not exist.
+ * Snake_case YAML keys are normalized to camelCase TypeScript properties.
+ */
+export declare function loadConfig(root: string): HarnessConfig | null;
+/**
+ * Load `.harness/criteria.md` from the given root directory.
+ * Returns null if the file does not exist.
+ */
+export declare function loadCriteria(root: string): string | null;

package/dist/discovery/config-loader.js

@@ -0,0 +1,64 @@
+import { readFileSync, existsSync } from "node:fs";
+import { join } from "node:path";
+import { parse } from "yaml";
+/**
+ * Map of snake_case YAML keys to their camelCase TypeScript equivalents.
+ */
+const SNAKE_TO_CAMEL = {
+    max_turns: "maxTurns",
+    system_prompt_append: "systemPromptAppend",
+    max_attempts_per_sprint: "maxAttemptsPerSprint",
+    max_budget_per_sprint_usd: "maxBudgetPerSprintUsd",
+    max_total_budget_usd: "maxTotalBudgetUsd",
+    test_command: "testCommand",
+    lint_command: "lintCommand",
+    build_command: "buildCommand",
+    dev_server: "devServer",
+};
+/**
+ * Recursively normalize an object's keys from snake_case to camelCase
+ * using the explicit mapping. Keys not in the mapping are kept as-is.
+ */
+function normalizeKeys(obj) {
+    if (obj === null || obj === undefined || typeof obj !== "object") {
+        return obj;
+    }
+    if (Array.isArray(obj)) {
+        return obj.map(normalizeKeys);
+    }
+    const result = {};
+    for (const [key, value] of Object.entries(obj)) {
+        const camelKey = SNAKE_TO_CAMEL[key] ?? key;
+        result[camelKey] = normalizeKeys(value);
+    }
+    return result;
+}
+/**
+ * Load and parse `.harness/config.yaml` from the given root directory.
+ * Returns null if the file does not exist.
+ * Snake_case YAML keys are normalized to camelCase TypeScript properties.
+ */
+export function loadConfig(root) {
+    const configPath = join(root, ".harness", "config.yaml");
+    if (!existsSync(configPath)) {
+        return null;
+    }
+    const raw = readFileSync(configPath, "utf-8");
+    const parsed = parse(raw);
+    if (parsed === null || parsed === undefined || typeof parsed !== "object") {
+        return null;
+    }
+    return normalizeKeys(parsed);
+}
+/**
+ * Load `.harness/criteria.md` from the given root directory.
+ * Returns null if the file does not exist.
+ */
+export function loadCriteria(root) {
+    const criteriaPath = join(root, ".harness", "criteria.md");
+    if (!existsSync(criteriaPath)) {
+        return null;
+    }
+    return readFileSync(criteriaPath, "utf-8");
+}
+//# sourceMappingURL=config-loader.js.map

package/dist/discovery/config-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-loader.js","sourceRoot":"","sources":["../../src/discovery/config-loader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,KAAK,EAAE,MAAM,MAAM,CAAC;AAG7B;;GAEG;AACH,MAAM,cAAc,GAA2B;IAC7C,SAAS,EAAE,UAAU;IACrB,oBAAoB,EAAE,oBAAoB;IAC1C,uBAAuB,EAAE,sBAAsB;IAC/C,yBAAyB,EAAE,uBAAuB;IAClD,oBAAoB,EAAE,mBAAmB;IACzC,YAAY,EAAE,aAAa;IAC3B,YAAY,EAAE,aAAa;IAC3B,aAAa,EAAE,cAAc;IAC7B,UAAU,EAAE,WAAW;CACxB,CAAC;AAEF;;;GAGG;AACH,SAAS,aAAa,CAAC,GAAY;IACjC,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,SAAS,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QACjE,OAAO,GAAG,CAAC;IACb,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACvB,OAAO,GAAG,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;IAChC,CAAC;IAED,MAAM,MAAM,GAA4B,EAAE,CAAC;IAC3C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAA8B,CAAC,EAAE,CAAC;QAC1E,MAAM,QAAQ,GAAG,cAAc,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC;QAC5C,MAAM,CAAC,QAAQ,CAAC,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;IAC1C,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,EAAE,UAAU,EAAE,aAAa,CAAC,CAAC;IACzD,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC5B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,GAAG,GAAG,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IAC9C,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;IAE1B,IAAI,MAAM,KAAK,IAAI,IAAI,MAAM,KAAK,SAAS,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC1E,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,aAAa,CAAC,MAAM,CAAkB,CAAC;AAChD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,EAAE,UAAU,EAAE,aAAa,CAAC,CAAC;IAC3D,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QAC9B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;AAC7C,CAAC"}

package/dist/discovery/project-context.d.ts

@@ -0,0 +1,12 @@
+import type { ProjectContext } from "../core/types.js";
+/**
+ * Build a complete ProjectContext by composing all discovery functions.
+ *
+ * 1. Detect repo type (single vs monorepo)
+ * 2. Discover workspaces with their stacks and per-workspace CLAUDE.md
+ * 3. Read root CLAUDE.md (.claude/CLAUDE.md or CLAUDE.md)
+ * 4. Load .harness/config.yaml
+ * 5. Load .harness/criteria.md
+ * 6. Pass scope through
+ */
+export declare function buildProjectContext(root: string, scope: string[] | null): ProjectContext;

package/dist/discovery/project-context.js

@@ -0,0 +1,56 @@
+import { readFileSync, existsSync } from "node:fs";
+import { join } from "node:path";
+import { detectRepoType, discoverWorkspaces } from "./stack-detector.js";
+import { loadConfig, loadCriteria } from "./config-loader.js";
+/**
+ * Read the root-level CLAUDE.md for the project.
+ * Checks `.claude/CLAUDE.md` first, then `CLAUDE.md` at the root.
+ */
+function readRootClaudeMd(root) {
+    const dotClaudePath = join(root, ".claude", "CLAUDE.md");
+    if (existsSync(dotClaudePath)) {
+        try {
+            return readFileSync(dotClaudePath, "utf-8");
+        }
+        catch {
+            // fall through
+        }
+    }
+    const rootPath = join(root, "CLAUDE.md");
+    if (existsSync(rootPath)) {
+        try {
+            return readFileSync(rootPath, "utf-8");
+        }
+        catch {
+            // fall through
+        }
+    }
+    return null;
+}
+/**
+ * Build a complete ProjectContext by composing all discovery functions.
+ *
+ * 1. Detect repo type (single vs monorepo)
+ * 2. Discover workspaces with their stacks and per-workspace CLAUDE.md
+ * 3. Read root CLAUDE.md (.claude/CLAUDE.md or CLAUDE.md)
+ * 4. Load .harness/config.yaml
+ * 5. Load .harness/criteria.md
+ * 6. Pass scope through
+ */
+export function buildProjectContext(root, scope) {
+    const repoType = detectRepoType(root);
+    const workspaces = discoverWorkspaces(root);
+    const rootClaudeMd = readRootClaudeMd(root);
+    const config = loadConfig(root);
+    const criteria = loadCriteria(root);
+    return {
+        repoType,
+        workspaces,
+        rootClaudeMd,
+        config,
+        criteria,
+        scope,
+        root,
+    };
+}
+//# sourceMappingURL=project-context.js.map

package/dist/discovery/project-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-context.js","sourceRoot":"","sources":["../../src/discovery/project-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzE,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAG9D;;;GAGG;AACH,SAAS,gBAAgB,CAAC,IAAY;IACpC,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC;IACzD,IAAI,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;QAC9B,IAAI,CAAC;YACH,OAAO,YAAY,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;QAC9C,CAAC;QAAC,MAAM,CAAC;YACP,eAAe;QACjB,CAAC;IACH,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;IACzC,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QACzB,IAAI,CAAC;YACH,OAAO,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACzC,CAAC;QAAC,MAAM,CAAC;YACP,eAAe;QACjB,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,mBAAmB,CACjC,IAAY,EACZ,KAAsB;IAEtB,MAAM,QAAQ,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;IACtC,MAAM,UAAU,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;IAC5C,MAAM,YAAY,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;IAC5C,MAAM,MAAM,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;IAChC,MAAM,QAAQ,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IAEpC,OAAO;QACL,QAAQ;QACR,UAAU;QACV,YAAY;QACZ,MAAM;QACN,QAAQ;QACR,KAAK;QACL,IAAI;KACL,CAAC;AACJ,CAAC"}

package/dist/discovery/stack-detector.d.ts

@@ -0,0 +1,15 @@
+import type { Stack, Workspace } from "../core/types.js";
+/**
+ * Detect the technology stack for a project rooted at `root`.
+ */
+export declare function detectStack(root: string): Stack;
+/**
+ * Determine whether the project at `root` is a single repo or a monorepo.
+ */
+export declare function detectRepoType(root: string): "single" | "monorepo";
+/**
+ * Discover workspaces in the project at `root`.
+ * For a single repo, returns a single workspace at ".".
+ * For a monorepo, returns one workspace per detected sub-project.
+ */
+export declare function discoverWorkspaces(root: string): Workspace[];

package/dist/discovery/stack-detector.js

@@ -0,0 +1,372 @@
+import { existsSync, readFileSync, readdirSync, statSync } from "node:fs";
+import { join, relative } from "node:path";
+// --- File helpers ---
+function fileExists(root, ...segments) {
+    return existsSync(join(root, ...segments));
+}
+function readFileSafe(path) {
+    try {
+        return readFileSync(path, "utf-8");
+    }
+    catch {
+        return null;
+    }
+}
+function readJson(path) {
+    const raw = readFileSafe(path);
+    if (raw === null)
+        return null;
+    try {
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+function anyFileExists(root, names) {
+    return names.some((n) => fileExists(root, n));
+}
+// --- Language detection ---
+function detectLanguage(root) {
+    if (fileExists(root, "package.json"))
+        return "typescript";
+    if (fileExists(root, "requirements.txt") || fileExists(root, "pyproject.toml"))
+        return "python";
+    if (fileExists(root, "Cargo.toml"))
+        return "rust";
+    if (fileExists(root, "go.mod"))
+        return "go";
+    return "unknown";
+}
+// --- Framework detection ---
+function detectFramework(root) {
+    if (anyFileExists(root, [
+        "next.config.js",
+        "next.config.mjs",
+        "next.config.ts",
+    ]))
+        return "nextjs";
+    if (anyFileExists(root, [
+        "vite.config.js",
+        "vite.config.ts",
+        "vite.config.mjs",
+    ]))
+        return "vite";
+    if (fileExists(root, "manage.py"))
+        return "django";
+    return null;
+}
+// --- Test runner detection ---
+function detectTestRunner(root, language, pkgJson) {
+    // Config-file-based detection (highest priority)
+    if (anyFileExists(root, [
+        "vitest.config.ts",
+        "vitest.config.js",
+        "vitest.config.mjs",
+    ]))
+        return "vitest";
+    if (anyFileExists(root, [
+        "jest.config.ts",
+        "jest.config.js",
+        "jest.config.mjs",
+        "jest.config.cjs",
+    ]))
+        return "jest";
+    // Python test runners
+    if (fileExists(root, "pytest.ini"))
+        return "pytest";
+    if (fileExists(root, "conftest.py"))
+        return "pytest";
+    // Check pyproject.toml for [tool.pytest] section
+    if (fileExists(root, "pyproject.toml")) {
+        const content = readFileSafe(join(root, "pyproject.toml"));
+        if (content && content.includes("[tool.pytest"))
+            return "pytest";
+    }
+    // Rust and Go have built-in test runners
+    if (language === "rust")
+        return "cargo test";
+    if (language === "go")
+        return "go test";
+    // Fallback: inspect package.json scripts.test
+    if (pkgJson) {
+        const scripts = pkgJson.scripts;
+        const testScript = scripts?.test;
+        if (testScript) {
+            if (testScript.includes("vitest"))
+                return "vitest";
+            if (testScript.includes("jest"))
+                return "jest";
+            if (testScript.includes("mocha"))
+                return "mocha";
+        }
+    }
+    return null;
+}
+// --- Command detection ---
+function detectTestCommand(runner, pkgJson) {
+    // Prefer package.json scripts.test
+    if (pkgJson) {
+        const scripts = pkgJson.scripts;
+        if (scripts?.test)
+            return scripts.test;
+    }
+    // Fallback based on runner
+    if (runner === "pytest")
+        return "pytest";
+    if (runner === "cargo test")
+        return "cargo test";
+    if (runner === "go test")
+        return "go test ./...";
+    return "";
+}
+function detectLintCommand(language, pkgJson) {
+    if (pkgJson) {
+        const scripts = pkgJson.scripts;
+        if (scripts?.lint)
+            return scripts.lint;
+    }
+    if (language === "python")
+        return "ruff check .";
+    if (language === "rust")
+        return "cargo clippy";
+    if (language === "go")
+        return "go vet ./...";
+    return null;
+}
+function detectBuildCommand(language, pkgJson) {
+    if (pkgJson) {
+        const scripts = pkgJson.scripts;
+        if (scripts?.build)
+            return scripts.build;
+    }
+    if (language === "rust")
+        return "cargo build";
+    if (language === "go")
+        return "go build ./...";
+    return null;
+}
+function detectDevServer(root, pkgJson) {
+    if (pkgJson) {
+        const scripts = pkgJson.scripts;
+        if (scripts?.dev)
+            return scripts.dev;
+        if (scripts?.start)
+            return scripts.start;
+    }
+    if (fileExists(root, "manage.py"))
+        return "python manage.py runserver";
+    return null;
+}
+// --- Public API ---
+/**
+ * Detect the technology stack for a project rooted at `root`.
+ */
+export function detectStack(root) {
+    const pkgJson = readJson(join(root, "package.json"));
+    const language = detectLanguage(root);
+    const framework = detectFramework(root);
+    const testRunner = detectTestRunner(root, language, pkgJson);
+    const testCommand = detectTestCommand(testRunner, pkgJson);
+    const lintCommand = detectLintCommand(language, pkgJson);
+    const buildCommand = detectBuildCommand(language, pkgJson);
+    const devServer = detectDevServer(root, pkgJson);
+    return {
+        language,
+        framework,
+        testRunner,
+        testCommand,
+        lintCommand,
+        buildCommand,
+        devServer,
+    };
+}
+/**
+ * Determine whether the project at `root` is a single repo or a monorepo.
+ */
+export function detectRepoType(root) {
+    // Check package.json workspaces
+    const pkgJson = readJson(join(root, "package.json"));
+    if (pkgJson?.workspaces)
+        return "monorepo";
+    // Check pnpm-workspace.yaml
+    if (fileExists(root, "pnpm-workspace.yaml"))
+        return "monorepo";
+    // Check lerna.json
+    if (fileExists(root, "lerna.json"))
+        return "monorepo";
+    // Convention: 2+ subdirectories with their own stack markers
+    const stackMarkers = [
+        "package.json",
+        "requirements.txt",
+        "pyproject.toml",
+        "Cargo.toml",
+        "go.mod",
+    ];
+    try {
+        const entries = readdirSync(root, { withFileTypes: true });
+        let stackDirCount = 0;
+        for (const entry of entries) {
+            if (!entry.isDirectory())
+                continue;
+            if (entry.name.startsWith(".") || entry.name === "node_modules")
+                continue;
+            const subdir = join(root, entry.name);
+            if (stackMarkers.some((marker) => existsSync(join(subdir, marker)))) {
+                stackDirCount++;
+            }
+            if (stackDirCount >= 2)
+                return "monorepo";
+        }
+    }
+    catch {
+        // ignore read errors
+    }
+    return "single";
+}
+/**
+ * Read CLAUDE.md for a given directory.
+ * Checks .claude/CLAUDE.md first, then CLAUDE.md at the directory root.
+ */
+function readClaudeMd(dir) {
+    const dotClaudePath = join(dir, ".claude", "CLAUDE.md");
+    const rootPath = join(dir, "CLAUDE.md");
+    return readFileSafe(dotClaudePath) ?? readFileSafe(rootPath);
+}
+/**
+ * Discover workspaces in the project at `root`.
+ * For a single repo, returns a single workspace at ".".
+ * For a monorepo, returns one workspace per detected sub-project.
+ */
+export function discoverWorkspaces(root) {
+    const repoType = detectRepoType(root);
+    if (repoType === "single") {
+        return [
+            {
+                path: ".",
+                stack: detectStack(root),
+                claudeMd: readClaudeMd(root),
+            },
+        ];
+    }
+    // Monorepo: find workspace directories
+    const workspaceDirs = findWorkspaceDirs(root);
+    return workspaceDirs.map((dir) => ({
+        path: relative(root, dir) || ".",
+        stack: detectStack(dir),
+        claudeMd: readClaudeMd(dir),
+    }));
+}
+/**
+ * Resolve workspace directories for a monorepo.
+ * Tries package.json workspaces globs, then falls back to scanning subdirectories.
+ */
+function findWorkspaceDirs(root) {
+    const pkgJson = readJson(join(root, "package.json"));
+    // Try package.json workspaces (array of globs like ["packages/*"])
+    if (pkgJson?.workspaces) {
+        const patterns = pkgJson.workspaces;
+        return resolveGlobPatterns(root, patterns);
+    }
+    // Try pnpm-workspace.yaml
+    if (fileExists(root, "pnpm-workspace.yaml")) {
+        const content = readFileSafe(join(root, "pnpm-workspace.yaml"));
+        if (content) {
+            const patterns = parsePnpmWorkspacePatterns(content);
+            if (patterns.length > 0)
+                return resolveGlobPatterns(root, patterns);
+        }
+    }
+    // Fallback: scan subdirectories for stack markers
+    return scanForStackDirs(root);
+}
+/**
+ * Resolve simple glob patterns like "packages/*" to actual directories.
+ * Only handles single-level wildcards for simplicity.
+ */
+function resolveGlobPatterns(root, patterns) {
+    const dirs = [];
+    for (const pattern of patterns) {
+        if (pattern.endsWith("/*")) {
+            const parent = join(root, pattern.slice(0, -2));
+            try {
+                const entries = readdirSync(parent, { withFileTypes: true });
+                for (const entry of entries) {
+                    if (entry.isDirectory() && !entry.name.startsWith(".")) {
+                        dirs.push(join(parent, entry.name));
+                    }
+                }
+            }
+            catch {
+                // parent directory doesn't exist, skip
+            }
+        }
+        else {
+            // Direct path
+            const dir = join(root, pattern);
+            if (existsSync(dir) && statSync(dir).isDirectory()) {
+                dirs.push(dir);
+            }
+        }
+    }
+    return dirs;
+}
+/**
+ * Parse pnpm-workspace.yaml to extract package patterns.
+ * Simple line-based parser — no YAML library needed for this format.
+ */
+function parsePnpmWorkspacePatterns(content) {
+    const patterns = [];
+    const lines = content.split("\n");
+    let inPackages = false;
+    for (const line of lines) {
+        const trimmed = line.trim();
+        if (trimmed === "packages:") {
+            inPackages = true;
+            continue;
+        }
+        if (inPackages) {
+            if (trimmed.startsWith("- ")) {
+                const value = trimmed.slice(2).replace(/['"]/g, "").trim();
+                if (value)
+                    patterns.push(value);
+            }
+            else if (trimmed && !trimmed.startsWith("#")) {
+                // New top-level key, stop parsing
+                break;
+            }
+        }
+    }
+    return patterns;
+}
+/**
+ * Scan root's immediate subdirectories for any that contain stack markers.
+ */
+function scanForStackDirs(root) {
+    const stackMarkers = [
+        "package.json",
+        "requirements.txt",
+        "pyproject.toml",
+        "Cargo.toml",
+        "go.mod",
+    ];
+    const dirs = [];
+    try {
+        const entries = readdirSync(root, { withFileTypes: true });
+        for (const entry of entries) {
+            if (!entry.isDirectory())
+                continue;
+            if (entry.name.startsWith(".") || entry.name === "node_modules")
+                continue;
+            const subdir = join(root, entry.name);
+            if (stackMarkers.some((marker) => existsSync(join(subdir, marker)))) {
+                dirs.push(subdir);
+            }
+        }
+    }
+    catch {
+        // ignore read errors
+    }
+    return dirs;
+}
+//# sourceMappingURL=stack-detector.js.map