@dougharness/cli 1.0.1

package/dist/detect/repo.js

@@ -0,0 +1,102 @@
+import { execFileSync } from "node:child_process";
+import { exists, isDir, listDir, readText } from "./fs.js";
+const MIGRATION_DIR_CANDIDATES = [
+    "prisma/migrations", "drizzle", "drizzle/migrations", "migrations", "db/migrate", "db/migrations",
+    "alembic/versions", "supabase/migrations", "src/migrations", "database/migrations",
+];
+const GENERATED_DIR_CANDIDATES = ["dist", "build", "out", ".next", ".nuxt", ".output", "coverage", "generated", "__generated__", ".turbo", ".svelte-kit"];
+const AGENT_FILES = [
+    "AGENTS.md", ".cursorrules", ".cursor/rules", ".github/copilot-instructions.md", ".windsurfrules", ".clinerules", ".devin/rules",
+];
+const INFRA_SKIP_DIRS = new Set(["node_modules", ".git"]);
+const INFRA_WALK_MAX_LEVEL = 3;
+// Walks the repo (skipping node_modules, .git, and the detected generated dirs, at every level) up to three
+// directory levels deep looking for a *.tfvars or terraform.tfstate file, at the root or nested. glob.mjs's
+// patterns are slash-free basename matches, so *.tfvars and terraform.tfstate already match at any depth: only
+// presence (root or nested) matters, not where. listDir/isDir already fail open (return [] / false) on an
+// unreadable directory, so the walk never throws.
+function collectTfMarkers(dir, generatedDirs) {
+    const skip = new Set([...INFRA_SKIP_DIRS, ...generatedDirs]);
+    let hasTfvars = false;
+    let hasTfstate = false;
+    function walk(rel, level) {
+        for (const name of listDir(dir, rel)) {
+            const relPath = rel === "." ? name : `${rel}/${name}`;
+            if (isDir(dir, relPath)) {
+                if (skip.has(name))
+                    continue;
+                if (level + 1 <= INFRA_WALK_MAX_LEVEL)
+                    walk(relPath, level + 1);
+                continue;
+            }
+            if (/\.tfvars$/.test(name))
+                hasTfvars = true;
+            else if (name === "terraform.tfstate")
+                hasTfstate = true;
+        }
+    }
+    walk(".", 0);
+    return { hasTfvars, hasTfstate };
+}
+function detectInfraPaths(dir, generatedDirs) {
+    const { hasTfvars, hasTfstate } = collectTfMarkers(dir, generatedDirs);
+    const infraPaths = [];
+    if (isDir(dir, "infra/prod"))
+        infraPaths.push("infra/prod/**");
+    if (hasTfvars)
+        infraPaths.push("*.tfvars");
+    if (hasTfstate)
+        infraPaths.push("terraform.tfstate");
+    return infraPaths;
+}
+function git(dir, args) {
+    try {
+        return execFileSync("git", args, { cwd: dir, encoding: "utf8", stdio: ["ignore", "pipe", "ignore"], timeout: 5000 }).trim();
+    }
+    catch {
+        return null;
+    }
+}
+export function detectRepo(dir, notes) {
+    const isGit = git(dir, ["rev-parse", "--is-inside-work-tree"]) === "true";
+    let defaultBranch = null;
+    if (isGit) {
+        const remoteHead = git(dir, ["symbolic-ref", "--short", "refs/remotes/origin/HEAD"]);
+        if (remoteHead)
+            defaultBranch = remoteHead.replace(/^origin\//, "");
+        else {
+            const current = git(dir, ["rev-parse", "--abbrev-ref", "HEAD"]);
+            if (current && current !== "HEAD")
+                defaultBranch = current;
+        }
+    }
+    const ci = [];
+    if (isDir(dir, ".github/workflows"))
+        ci.push(...listDir(dir, ".github/workflows").filter((f) => /\.ya?ml$/.test(f)).map((f) => `.github/workflows/${f}`));
+    for (const f of [".gitlab-ci.yml", ".circleci/config.yml", "Jenkinsfile", "bitbucket-pipelines.yml", "azure-pipelines.yml"])
+        if (exists(dir, f))
+            ci.push(f);
+    const gitHooks = [];
+    if (isDir(dir, ".husky"))
+        gitHooks.push("husky");
+    if (exists(dir, "lefthook.yml") || exists(dir, ".lefthook.yml"))
+        gitHooks.push("lefthook");
+    if (exists(dir, ".pre-commit-config.yaml"))
+        gitHooks.push("pre-commit");
+    if (["commitlint.config.js", "commitlint.config.cjs", "commitlint.config.mjs", "commitlint.config.ts", ".commitlintrc", ".commitlintrc.json", ".commitlintrc.js"].some((f) => exists(dir, f)))
+        gitHooks.push("commitlint");
+    const envFiles = listDir(dir).filter((f) => /^\.env(\..+)?$/.test(f) && !/\.example$|\.sample$|\.template$/.test(f));
+    const gitignore = readText(dir, ".gitignore") || "";
+    if (envFiles.length && !/^\s*\.env/m.test(gitignore))
+        notes.push("Env files exist but .gitignore does not mention .env.");
+    const migrationDirs = MIGRATION_DIR_CANDIDATES.filter((d) => isDir(dir, d));
+    const generatedDirs = GENERATED_DIR_CANDIDATES.filter((d) => isDir(dir, d) || new RegExp(`^/?${d.replace(".", "\\.")}/?$`, "m").test(gitignore));
+    const infraPaths = detectInfraPaths(dir, generatedDirs);
+    const existingAgentFiles = AGENT_FILES.filter((f) => exists(dir, f));
+    const hasClaudeMd = exists(dir, "CLAUDE.md");
+    const hasClaudeSettings = exists(dir, ".claude/settings.json");
+    const readme = readText(dir, "README.md") || "";
+    const readmeHasSetup = /^#+\s*(getting started|setup|installation|install|development|running)/im.test(readme);
+    return { isGit, defaultBranch, ci, gitHooks, envFiles, migrationDirs, generatedDirs, infraPaths, existingAgentFiles, hasClaudeMd, hasClaudeSettings, readmeHasSetup };
+}
+//# sourceMappingURL=repo.js.map

package/dist/detect/repo.js.map

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

package/dist/detect/types.d.ts

@@ -0,0 +1,98 @@
+export type PackageManager = "pnpm" | "npm" | "yarn" | "bun";
+export interface ScriptCommand {
+    /** Name of the package.json script, e.g. "test". */
+    script: string;
+    /** Full shell command to run it, e.g. "pnpm test". */
+    command: string;
+    /** What the script runs, verbatim from package.json. */
+    body: string;
+}
+export interface NodeDetection {
+    present: boolean;
+    packageManager: PackageManager | null;
+    packageManagerSource: "packageManager-field" | "lockfile" | "default" | null;
+    nodeVersion: string | null;
+    nodeVersionSource: string | null;
+    scripts: Record<string, string>;
+    commands: {
+        install: string | null;
+        test: ScriptCommand | null;
+        "test:unit": ScriptCommand | null;
+        lint: ScriptCommand | null;
+        typecheck: ScriptCommand | null;
+        build: ScriptCommand | null;
+        format: ScriptCommand | null;
+    };
+    testFramework: "vitest" | "jest" | "mocha" | "node:test" | null;
+    singleTestCommand: string | null;
+    formatter: {
+        name: "prettier" | "biome";
+        command: string[];
+        extensions: string[];
+    } | null;
+    linter: "eslint" | "biome" | null;
+    typescript: boolean;
+    tsStrict: boolean | null;
+    monorepo: {
+        tool: "pnpm-workspace" | "npm-workspaces" | "turbo" | "nx" | "lerna";
+        packages: string[];
+    }[];
+    lockfile: string | null;
+}
+export type PythonManager = "uv" | "poetry" | "pdm" | "pipenv" | "hatch" | "pip";
+export interface PythonDetection {
+    present: boolean;
+    manager: PythonManager | null;
+    managerSource: string | null;
+    lockfile: string | null;
+    runPrefix: string | null;
+    pythonVersion: string | null;
+    pythonVersionSource: string | null;
+    venvDir: string | null;
+    venvBinDir: string | null;
+    commands: {
+        install: string | null;
+        test: string | null;
+        lint: string | null;
+        format: string | null;
+        formatCheck: string | null;
+        typecheck: string | null;
+    };
+    testFramework: "pytest" | null;
+    testConfigFile: string | null;
+    testDirs: string[];
+    singleTestCommand: string | null;
+    singleTestNodeIdCommand: string | null;
+    linter: "ruff" | null;
+    formatter: {
+        name: "ruff" | "black";
+        command: string;
+    } | null;
+    typeChecker: "mypy" | null;
+    typeCheckerConfigFile: string | null;
+    srcLayout: boolean;
+    migrationDirs: string[];
+    generatedDirs: string[];
+}
+export interface RepoDetection {
+    isGit: boolean;
+    defaultBranch: string | null;
+    ci: string[];
+    gitHooks: ("husky" | "lefthook" | "pre-commit" | "commitlint")[];
+    envFiles: string[];
+    migrationDirs: string[];
+    generatedDirs: string[];
+    infraPaths: string[];
+    existingAgentFiles: string[];
+    hasClaudeMd: boolean;
+    hasClaudeSettings: boolean;
+    readmeHasSetup: boolean;
+}
+export interface Detection {
+    dir: string;
+    node: NodeDetection;
+    python: PythonDetection;
+    repo: RepoDetection;
+    /** Human-readable notes about why a decision was made. Shown in the proposal. */
+    notes: string[];
+}

package/dist/detect/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/detect/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/detect/types.ts"],"names":[],"mappings":""}

package/dist/diff.d.ts

@@ -0,0 +1,12 @@
+export interface FileChange {
+    path: string;
+    before: string | null;
+    after: string | null;
+    /** Why this file is proposed. Shown above the diff. */
+    reason?: string;
+}
+export interface DiffOptions {
+    color?: boolean;
+    context?: number;
+}
+export declare function renderDiff(change: FileChange, opts?: DiffOptions): string;

package/dist/diff.js

@@ -0,0 +1,105 @@
+// Unified diff rendering with no dependencies. Line-based LCS; fine for config-sized files.
+function lcsOps(a, b) {
+    const n = a.length;
+    const m = b.length;
+    const dp = [];
+    for (let i = 0; i <= n; i++)
+        dp.push(new Uint32Array(m + 1));
+    for (let i = n - 1; i >= 0; i--) {
+        for (let j = m - 1; j >= 0; j--) {
+            dp[i][j] = a[i] === b[j] ? dp[i + 1][j + 1] + 1 : Math.max(dp[i + 1][j], dp[i][j + 1]);
+        }
+    }
+    const ops = [];
+    let i = 0;
+    let j = 0;
+    while (i < n && j < m) {
+        if (a[i] === b[j]) {
+            ops.push({ kind: " ", line: a[i] });
+            i++;
+            j++;
+        }
+        else if (dp[i + 1][j] >= dp[i][j + 1]) {
+            ops.push({ kind: "-", line: a[i] });
+            i++;
+        }
+        else {
+            ops.push({ kind: "+", line: b[j] });
+            j++;
+        }
+    }
+    while (i < n)
+        ops.push({ kind: "-", line: a[i++] });
+    while (j < m)
+        ops.push({ kind: "+", line: b[j++] });
+    return ops;
+}
+function splitLines(s) {
+    if (s === null || s === "")
+        return [];
+    const lines = s.split("\n");
+    if (lines[lines.length - 1] === "")
+        lines.pop();
+    return lines;
+}
+export function renderDiff(change, opts = {}) {
+    const color = opts.color ?? false;
+    const ctx = opts.context ?? 3;
+    const c = (code, s) => (color ? `[${code}m${s}` : s);
+    const a = splitLines(change.before);
+    const b = splitLines(change.after);
+    const header = [];
+    const status = change.before === null ? "create" : change.after === null ? "delete" : "modify";
+    header.push(c("1", `${status}  ${change.path}`));
+    if (change.reason)
+        header.push(c("2", `        ${change.reason}`));
+    header.push(c("36", `--- ${change.before === null ? "/dev/null" : "a/" + change.path}`));
+    header.push(c("36", `+++ ${change.after === null ? "/dev/null" : "b/" + change.path}`));
+    const ops = lcsOps(a, b);
+    if (ops.every((o) => o.kind === " "))
+        return header[0] + "\n        (no changes)";
+    // Group into hunks with context.
+    const out = [...header];
+    let i = 0;
+    while (i < ops.length) {
+        if (ops[i].kind === " ") {
+            i++;
+            continue;
+        }
+        const start = Math.max(0, i - ctx);
+        let end = i;
+        let lastChange = i;
+        while (end < ops.length && end - lastChange <= ctx) {
+            if (ops[end].kind !== " ")
+                lastChange = end;
+            end++;
+        }
+        end = Math.min(ops.length, lastChange + ctx + 1);
+        // Compute line numbers for the hunk header.
+        let aLine = 1;
+        let bLine = 1;
+        for (let k = 0; k < start; k++) {
+            if (ops[k].kind !== "+")
+                aLine++;
+            if (ops[k].kind !== "-")
+                bLine++;
+        }
+        let aCount = 0;
+        let bCount = 0;
+        for (let k = start; k < end; k++) {
+            if (ops[k].kind !== "+")
+                aCount++;
+            if (ops[k].kind !== "-")
+                bCount++;
+        }
+        out.push(c("36", `@@ -${aLine},${aCount} +${bLine},${bCount} @@`));
+        for (let k = start; k < end; k++) {
+            const o = ops[k];
+            const text = o.kind + o.line;
+            out.push(o.kind === "+" ? c("32", text) : o.kind === "-" ? c("31", text) : text);
+        }
+        i = end;
+    }
+    return out.join("\n");
+}
+//# sourceMappingURL=diff.js.map

package/dist/diff.js.map

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

package/dist/generate/agents.d.ts

@@ -0,0 +1,19 @@
+import type { Detection } from "../detect/types.js";
+import type { DougConfig } from "./config.js";
+export declare const AGENT_MARK = "doug: generated";
+/** The old HTML-comment marker, kept only so isDougAgent still recognizes files written by the old generator. */
+export declare const LEGACY_AGENT_MARK = "<!-- Generated by doug init. It refreshes this file while this line is present; remove the line to own the file. -->";
+/** The heading that starts the user-owned section every generated agent file ends with. */
+export declare const PROJECT_NOTES_HEADING = "## Project notes";
+export declare function isDougAgent(text: string): boolean;
+/**
+ * Returns `generated` with its (empty) `## Project notes` section replaced by the verbatim section from
+ * `existing`, when `existing` has that heading (as its own line; the first such line if there is more than
+ * one), else returns `generated` unchanged (an old-form file with no such section). Pure: no filesystem.
+ */
+export declare function spliceProjectNotes(generated: string, existing: string): string;
+export interface AgentFile {
+    path: string;
+    content: string;
+}
+export declare function generateAgents(d: Detection, cfg: DougConfig): AgentFile[];

package/dist/generate/agents.js

@@ -0,0 +1,184 @@
+// Generates standard project subagents under .claude/agents/: coder, architect, reviewer, researcher, and
+// (when a test framework is detected) tester. Pure function of its arguments: no filesystem,
+// no clock, no randomness, so the same inputs give byte-identical output.
+export const AGENT_MARK = "doug: generated";
+/** The old HTML-comment marker, kept only so isDougAgent still recognizes files written by the old generator. */
+export const LEGACY_AGENT_MARK = "<!-- Generated by doug init. It refreshes this file while this line is present; remove the line to own the file. -->";
+/** The heading that starts the user-owned section every generated agent file ends with. */
+export const PROJECT_NOTES_HEADING = "## Project notes";
+export function isDougAgent(text) {
+    if (text.includes(LEGACY_AGENT_MARK))
+        return true;
+    const withoutBom = text.startsWith("") ? text.slice(1) : text;
+    const lines = withoutBom.split("\n").map((l) => (l.endsWith("\r") ? l.slice(0, -1) : l));
+    if (lines[0] !== "---")
+        return false;
+    const closingIdx = lines.indexOf("---", 1);
+    if (closingIdx <= 0)
+        return false;
+    return lines.slice(0, closingIdx).includes(AGENT_MARK);
+}
+function escapeRegExp(s) {
+    return s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+// Line-anchored: matches only a line that equals PROJECT_NOTES_HEADING exactly, never a substring
+// (a mid-line mention, or a "### Project notes" heading with an extra "#").
+const PROJECT_NOTES_HEADING_RE = new RegExp(`^${escapeRegExp(PROJECT_NOTES_HEADING)}$`, "m");
+/**
+ * Returns `generated` with its (empty) `## Project notes` section replaced by the verbatim section from
+ * `existing`, when `existing` has that heading (as its own line; the first such line if there is more than
+ * one), else returns `generated` unchanged (an old-form file with no such section). Pure: no filesystem.
+ */
+export function spliceProjectNotes(generated, existing) {
+    const existingMatch = PROJECT_NOTES_HEADING_RE.exec(existing);
+    if (!existingMatch)
+        return generated;
+    const genMatch = PROJECT_NOTES_HEADING_RE.exec(generated);
+    if (!genMatch)
+        return generated;
+    return generated.slice(0, genMatch.index) + existing.slice(existingMatch.index);
+}
+function buildFacts(d, cfg, opts) {
+    const n = d.node;
+    const facts = [];
+    if (opts.pm && n.packageManager)
+        facts.push(`Use ${n.packageManager} only.`);
+    if (opts.pm && d.python.present && d.python.manager)
+        facts.push(`Use ${d.python.manager} only for Python.`);
+    if (opts.singleTest && n.singleTestCommand)
+        facts.push(`Run one test file with: ${n.singleTestCommand}`);
+    if (opts.singleTest && d.python.present && d.python.singleTestCommand) {
+        facts.push(`Run one Python test file with: ${d.python.singleTestCommand}`);
+    }
+    if (opts.gate && cfg.stopGate.commands.length) {
+        facts.push(`Before finishing run: ${cfg.stopGate.commands.map((name) => cfg.commands[name]).join(" then ")}`);
+    }
+    if (opts.monorepo && n.monorepo.length) {
+        facts.push(`Monorepo (${n.monorepo.map((m) => m.tool).join(",")}): run scripts from the package you are changing.`);
+    }
+    if (opts.ci && d.repo.ci.length) {
+        facts.push(`CI: ${d.repo.ci.join(",")}. Mirror its checks locally.`);
+    }
+    return facts;
+}
+function renderAgent(spec) {
+    const lines = [];
+    lines.push("---");
+    lines.push(`name: ${spec.name}`);
+    lines.push(`description: ${JSON.stringify(spec.description)}`);
+    lines.push("model: inherit");
+    if (spec.readOnly) {
+        lines.push(`tools: ${spec.tools ?? "Read, Grep, Glob, Bash"}`);
+        lines.push("disallowedTools: Edit, Write, MultiEdit, NotebookEdit");
+    }
+    else {
+        lines.push("disallowedTools: Agent");
+    }
+    lines.push(AGENT_MARK);
+    lines.push("---");
+    lines.push("");
+    if (spec.facts.length) {
+        lines.push("## Facts");
+        lines.push("");
+        for (const f of spec.facts)
+            lines.push(`- ${f}`);
+        lines.push("");
+    }
+    lines.push("## Rules");
+    lines.push("");
+    for (const r of spec.rules)
+        lines.push(`- ${r}`);
+    lines.push("");
+    lines.push(PROJECT_NOTES_HEADING);
+    return lines.join("\n") + "\n";
+}
+export function generateAgents(d, cfg) {
+    const n = d.node;
+    const coder = {
+        name: "coder",
+        description: "Implements a requested change in this repository, runs its checks, and reports what it ran",
+        readOnly: false,
+        facts: buildFacts(d, cfg, { pm: true, singleTest: true, gate: true, monorepo: true }),
+        rules: [
+            "Do only what was asked, no refactors or renames beyond it.",
+            "Add or update the test with the change.",
+            "Never bypass hooks with --no-verify.",
+            "Do not claim done until the gate passed in this session.",
+            "Report every command run with its exit status.",
+            "Return partial=true only after a hook tells you `[doug] Worker context at <pct>% of <window> tokens`: stop at a boundary (finish the file you are on and its named test, then commit), and say what's done, what's left, what to do next, and how to verify it. Never claim partial to dodge a hard task.",
+            "When a test contradicts the brief or the card's goal, do not change production code to fit the test; stop and report the conflict, quoting both, so the lead can send it back to the tester.",
+            "Apply each mutation in a scratch copy or git worktree under `.doug/.state`, run the one test file there, and remove the copy.",
+            "Scratch files go under `.doug/.state/scratch`; protect-paths keeps refusing the Claude Code session scratchpad, which is outside the project.",
+            "Run any command that can take over 120 s, such as pnpm test:unit, with the Bash timeout set to 600000, and hand back only after it exits.",
+        ],
+    };
+    const architect = {
+        name: "architect",
+        description: "Reads the code and returns a design: files to change, tests to add, and the command that verifies each; writes no code",
+        readOnly: true,
+        facts: buildFacts(d, cfg, { monorepo: true, singleTest: true, gate: true }),
+        rules: [
+            "Read before proposing.",
+            "Return a numbered list of files with what changes in each.",
+            "Name the test file and verify command per item.",
+            "Do not edit.",
+        ],
+    };
+    const reviewer = {
+        name: "reviewer",
+        description: "Reviews a diff against its request, runs the project checks, and reports blocker, major, and minor findings; never edits",
+        readOnly: true,
+        facts: buildFacts(d, cfg, { gate: true, singleTest: true, ci: true }),
+        rules: [
+            "Review `git diff` (or `git diff <base>...HEAD` when a base is named).",
+            "Run the gate commands and report real exit codes.",
+            "When the change's point is that a mechanism exists, mutate or remove it, rerun the test, and confirm it fails before reverting.",
+            "Severity blocker/major/minor with blocker meaning the change must not merge.",
+            "Do not ask for work beyond the request.",
+            "Apply each mutation in a scratch copy or git worktree under `.doug/.state`, run the one test file there, and remove the copy.",
+            "Run any command that can take over 120 s, such as pnpm test:unit, with the Bash timeout set to 600000, and hand back only after it exits.",
+        ],
+    };
+    const researcher = {
+        name: "researcher",
+        description: "Answers one question about a fact outside this repository (a CLI's output, a third-party API, a package's constraints) from primary sources, quoting each fact's URL or command output and marking the rest unverified; never writes",
+        readOnly: true,
+        tools: "Read, Grep, Glob, Bash, WebFetch, WebSearch",
+        facts: buildFacts(d, cfg, { pm: true }),
+        rules: [
+            "Answer the one question asked; leave any other researcher's question alone.",
+            "Primary sources first (official docs, the tool's own --help, the package's repository); quote each fact with its URL or the command and its output, and say whether it was observed or documented.",
+            "Never install, write, or change the machine; a fact that needs an install is unverified, with the command that would show it.",
+            "Mark anything unconfirmed unverified, with what was tried; never guess.",
+            "Budget: at most 6 WebSearch plus WebFetch calls for your question (research.maxFetches; a hook denies the next one). Try sources in the order the question lists them, and write your findings before the budget runs out, marking anything still unanswered unverified.",
+        ],
+    };
+    const files = [
+        { path: ".claude/agents/coder.md", content: renderAgent(coder) },
+        { path: ".claude/agents/architect.md", content: renderAgent(architect) },
+        { path: ".claude/agents/reviewer.md", content: renderAgent(reviewer) },
+        { path: ".claude/agents/researcher.md", content: renderAgent(researcher) },
+    ];
+    if (n.testFramework || d.python.testFramework) {
+        const frameworkName = n.testFramework ?? "pytest";
+        const tester = {
+            name: "tester",
+            description: `Writes and runs tests with ${frameworkName} for a named behavior; edits test files only`,
+            readOnly: false,
+            facts: buildFacts(d, cfg, { pm: true, singleTest: true }),
+            rules: [
+                "A new test must fail without the behavior and pass with it.",
+                "Edit only test files.",
+                "Run each test file you touch with the single-test command.",
+                "Report what ran.",
+                'When your new tests are meant to stay red until the coder\'s change, end your final message with a JSON object {"tests_red_by_design": ["<test file>", ...]} naming every test file you left failing by its repository-relative path, report the red once, and do not rerun the suite to make a gate pass. Put that JSON line either as the last line of your final plain-text message or inside your hand-back message: the SubagentStop gate reads your last plain-text message first and, when that holds no claim, your last hand-back call.',
+                "Scratch files go under `.doug/.state/scratch`; protect-paths keeps refusing the Claude Code session scratchpad, which is outside the project.",
+                "Run any command that can take over 120 s, such as pnpm test:unit, with the Bash timeout set to 600000, and hand back only after it exits.",
+                "On a tests-only card, run the brief's mutation list yourself in a scratch copy or git worktree under `.doug/.state`, run the one test file there, report each result, and remove the copy; never edit a production file in the live checkout.",
+            ],
+        };
+        files.push({ path: ".claude/agents/tester.md", content: renderAgent(tester) });
+    }
+    return files;
+}
+//# sourceMappingURL=agents.js.map

package/dist/generate/agents.js.map

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

package/dist/generate/claude-md.d.ts

@@ -0,0 +1,9 @@
+import type { Detection } from "../detect/types.js";
+import type { DougConfig } from "./config.js";
+export declare function generateClaudeMd(d: Detection, cfg: DougConfig): string;
+/**
+ * The Models table: which model and effort does which work when doug-flow runs a plan.
+ * Parsed deterministically by doug-flow's plan CLI (lib/models.mjs) and resolved into the plan
+ * before the workflow runs. "inherit" keeps the session model or the role's default effort.
+ */
+export declare const MODELS_SECTION: string[];