infinity-harness 2.8.9 → 2.8.11

package/dist/tests/brief.test.js

@@ -0,0 +1,271 @@
+import assert from "node:assert/strict";
+import { mkdtempSync, rmSync, mkdirSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { buildBrief, renderBrief, renderBriefLine, referencedDocs } from "../src/core/brief.js";
+import { defaultConfig } from "../src/core/config.js";
+function mkTask(id, status, extra = {}) {
+    return { id, description: `Do ${id}`, status, dependsOn: [], subtasks: [], ...extra };
+}
+function plan(tasks, featureCriteria = ["the feature works end to end"]) {
+    return {
+        version: "2.0",
+        baseRevision: 3,
+        goals: [{ id: "goal-001", title: "Ship the infinity harness" }],
+        sprints: [],
+        features: [{ id: "feature-001", name: "The first feature", criteria: featureCriteria, tasks }],
+    };
+}
+function tmpProject(mutate, list) {
+    const d = mkdtempSync(join(tmpdir(), "pi-brief-"));
+    mkdirSync(join(d, "harness", "features"), { recursive: true });
+    const c = defaultConfig();
+    mutate(c);
+    writeFileSync(join(d, "harness", "config.json"), JSON.stringify(c, null, 2), "utf-8");
+    writeFileSync(join(d, "harness", "features", "feature-list.json"), JSON.stringify(list, null, 2), "utf-8");
+    return d;
+}
+// ── buildBrief surfaces the state that answers "what now?" ─────────────────
+{
+    const dir = tmpProject((c) => {
+        c.currentPhase = "build";
+        c.currentRole = "generator";
+        c.taskRetryCount = 1;
+        c.phaseRetryCount = 2;
+    }, plan([
+        mkTask("task-1", "complete"),
+        mkTask("task-2", "in_progress", { criteria: ["the task's own criterion"] }),
+        mkTask("task-3", "pending"),
+        mkTask("task-4", "blocked"),
+    ]));
+    try {
+        const brief = await buildBrief(dir);
+        assert.equal(brief.phase, "build");
+        assert.equal(brief.role, "generator", "the role is derived from the phase");
+        assert.equal(brief.paused, false);
+        assert.equal(brief.complete, false);
+        assert.equal(brief.goal, "Ship the infinity harness");
+        assert.deepEqual(brief.feature, { id: "feature-001", name: "The first feature" });
+        assert.ok(brief.task, "there is work to point at");
+        assert.equal(brief.task.id, "task-2", "the in-progress task is the one to work on");
+        assert.equal(brief.task.key, "feature-001/task-2");
+        assert.equal(brief.task.description, "Do task-2");
+        assert.equal(brief.task.status, "in_progress");
+        assert.deepEqual(brief.criteria, ["the task's own criterion"], "task criteria beat feature criteria");
+        assert.deepEqual(brief.progress, { tasksDone: 1, tasksTotal: 4, featuresDone: 0, featuresTotal: 1 });
+        assert.deepEqual(brief.retries, { task: 1, feature: 0, phase: 2, max: 10 });
+        assert.equal(brief.gate, null, "the gate is not run unless asked — it costs a lint/test run");
+        assert.equal(brief.validateCommand, "infinity_validate", "the brief names a tool that exists");
+        // A blocked task is something the human needs to know about.
+        assert.equal(brief.notes.length, 1, brief.notes.join(" | "));
+        assert.match(brief.notes[0], /1 task\(s\) are blocked: feature-001\/task-4/);
+        console.log("✓ buildBrief surfaces phase, role, task and progress");
+    }
+    finally {
+        rmSync(dir, { recursive: true, force: true });
+    }
+}
+// ── buildBrief falls back to feature criteria, and reports an empty plan ───
+{
+    const dir = tmpProject((c) => {
+        c.currentPhase = "build";
+    }, plan([mkTask("task-1", "pending")]));
+    try {
+        const brief = await buildBrief(dir);
+        assert.deepEqual(brief.criteria, ["the feature works end to end"], "feature criteria fill in for a task with none");
+    }
+    finally {
+        rmSync(dir, { recursive: true, force: true });
+    }
+    const bare = mkdtempSync(join(tmpdir(), "pi-brief-bare-"));
+    try {
+        const brief = await buildBrief(bare);
+        assert.equal(brief.phase, null);
+        assert.equal(brief.role, null);
+        assert.equal(brief.task, null);
+        assert.equal(brief.feature, null);
+        assert.equal(brief.goal, null);
+        assert.deepEqual(brief.progress, { tasksDone: 0, tasksTotal: 0, featuresDone: 0, featuresTotal: 0 });
+        assert.ok(brief.notes.some((n) => /config.json is missing/.test(n)), "an uninitialised project says so instead of pretending");
+        const text = renderBrief(brief);
+        assert.match(text, /NEXT STEP · NOT STARTED/);
+        assert.match(text, /TASK {5}\(none actionable/);
+        console.log("✓ buildBrief on an empty and an uninitialised project");
+    }
+    finally {
+        rmSync(bare, { recursive: true, force: true });
+    }
+}
+// ── renderBrief: the working brief ─────────────────────────────────────────
+{
+    const dir = tmpProject((c) => {
+        c.currentPhase = "build";
+    }, plan([mkTask("task-1", "complete"), mkTask("task-2", "in_progress")]));
+    try {
+        const brief = await buildBrief(dir);
+        const config = defaultConfig();
+        config.currentPhase = "build";
+        const text = renderBrief(brief, config);
+        assert.match(text, /NEXT STEP · BUILD · feature-001 · feature-001\/task-2/, "the header names the phase and task");
+        assert.match(text, /GOAL {5}Ship the infinity harness/);
+        assert.match(text, /ROLE {5}generator — Implement the current task/, "the role comes with its intent");
+        assert.match(text, /FEATURE {2}feature-001 · The first feature/);
+        assert.match(text, /TASK {5}feature-001\/task-2 \[in_progress\]/);
+        assert.match(text, /Do task-2/);
+        assert.match(text, /PROGRESS 1\/2 tasks · 0\/1 features · retries 0\/10/);
+        assert.match(text, /PIPELINE define → plan → \[BUILD\] → verify → review → ship/);
+        assert.match(text, /ACCEPTANCE CRITERIA\n {2}- the feature works end to end/);
+        // The loop instructions are the whole contract with the agent.
+        assert.match(text, /THE LOOP/);
+        assert.match(text, /1\. Do the work described above\./);
+        assert.match(text, /2\. Call the infinity_validate tool/);
+        assert.match(text, /3\. FAIL → fix the listed checks and validate again\./);
+        assert.match(text, /4\. PASS → the harness advances the phase and issues the next brief\./);
+        assert.match(text, /Do not edit harness\/config.json by hand/);
+        assert.match(text, /The gate is the only referee\./);
+        // Without a config there is no pipeline line, but everything else stands.
+        const noConfig = renderBrief(brief);
+        assert.ok(!noConfig.includes("PIPELINE"), "the pipeline rail needs the config to know what is enabled");
+        assert.match(noConfig, /THE LOOP/);
+        console.log("✓ renderBrief contains the phase, the task key and the loop instructions");
+    }
+    finally {
+        rmSync(dir, { recursive: true, force: true });
+    }
+}
+// ── renderBrief: the paused path renders the paused text and nothing else ──
+{
+    const dir = tmpProject((c) => {
+        c.currentPhase = "build";
+        c.paused = true;
+    }, plan([mkTask("task-1", "in_progress")]));
+    try {
+        const brief = await buildBrief(dir);
+        assert.equal(brief.paused, true);
+        const text = renderBrief(brief, defaultConfig());
+        assert.match(text, /HARNESS PAUSED/);
+        assert.match(text, /Do not continue autonomously — tell the human and stop\./);
+        for (const leak of ["NEXT STEP", "THE LOOP", "PROGRESS", "TASK", "PIPELINE", "GOAL"]) {
+            assert.ok(!text.includes(leak), `the paused brief must not also print ${leak}`);
+        }
+        assert.equal(renderBriefLine(brief), "paused");
+        console.log("✓ the paused path renders the paused text and nothing else");
+    }
+    finally {
+        rmSync(dir, { recursive: true, force: true });
+    }
+}
+// ── renderBrief: the complete path ─────────────────────────────────────────
+{
+    const dir = tmpProject((c) => {
+        c.currentPhase = "ship";
+    }, plan([mkTask("task-1", "complete"), mkTask("task-2", "complete")]));
+    try {
+        const brief = await buildBrief(dir);
+        assert.equal(brief.complete, true, "the final phase with every task done is a finished run");
+        const text = renderBrief(brief, defaultConfig());
+        assert.match(text, /PIPELINE COMPLETE/);
+        assert.match(text, /All 2 task\(s\) across 1 feature\(s\) are done/);
+        assert.match(text, /Report to the human; do not start new work\./);
+        assert.ok(!text.includes("THE LOOP"), "there is no next step to describe");
+        assert.equal(renderBriefLine(brief), "complete");
+        // The same plan mid-pipeline is not complete.
+        const midDir = tmpProject((c) => {
+            c.currentPhase = "verify";
+        }, plan([mkTask("task-1", "complete"), mkTask("task-2", "complete")]));
+        try {
+            const mid = await buildBrief(midDir);
+            assert.equal(mid.complete, false, "all tasks done is not enough — the pipeline must be finished too");
+            assert.match(renderBrief(mid), /THE LOOP/);
+        }
+        finally {
+            rmSync(midDir, { recursive: true, force: true });
+        }
+        console.log("✓ the complete path renders the completion text");
+    }
+    finally {
+        rmSync(dir, { recursive: true, force: true });
+    }
+}
+// ── retry exhaustion adds an escalation note ───────────────────────────────
+{
+    const dir = tmpProject((c) => {
+        c.currentPhase = "build";
+        c.maxRetries = 4;
+        c.taskRetryCount = 4;
+    }, plan([mkTask("task-1", "in_progress")]));
+    try {
+        const brief = await buildBrief(dir);
+        assert.ok(brief.notes.some((n) => /Retry budget for task is exhausted/.test(n)), `expected an exhaustion note, got: ${JSON.stringify(brief.notes)}`);
+        assert.ok(brief.notes.some((n) => /escalate to the human/.test(n)));
+        const text = renderBrief(brief, defaultConfig());
+        assert.match(text, /ATTENTION/);
+        assert.match(text, /! Retry budget for task is exhausted/);
+        assert.match(text, /retries 4\/4/);
+        // One retry short of the budget, there is nothing to escalate.
+        const okDir = tmpProject((c) => {
+            c.currentPhase = "build";
+            c.maxRetries = 4;
+            c.taskRetryCount = 3;
+        }, plan([mkTask("task-1", "in_progress")]));
+        try {
+            const ok = await buildBrief(okDir);
+            assert.deepEqual(ok.notes, [], "under budget, no note");
+            assert.ok(!renderBrief(ok).includes("ATTENTION"));
+        }
+        finally {
+            rmSync(okDir, { recursive: true, force: true });
+        }
+        console.log("✓ retry exhaustion adds an escalation note");
+    }
+    finally {
+        rmSync(dir, { recursive: true, force: true });
+    }
+}
+// ── includeGate embeds a live verdict ──────────────────────────────────────
+{
+    const dir = tmpProject((c) => {
+        c.currentPhase = "build";
+    }, plan([mkTask("task-1", "pending")]));
+    try {
+        const brief = await buildBrief(dir, { includeGate: true });
+        assert.ok(brief.gate, "a gate verdict was requested");
+        assert.equal(brief.gate.phase, "build");
+        assert.equal(brief.gate.overall, false, "one task is still open");
+        assert.ok(brief.gate.failures.includes("tasks-complete"));
+        const text = renderBrief(brief);
+        assert.match(text, /GATE {5}FAIL/);
+        assert.match(text, /x tasks-complete: /, "failing checks are marked x");
+        assert.match(text, /· lint: no lint command configured/, "advisory checks are marked ·");
+        console.log("✓ includeGate embeds a live gate verdict");
+    }
+    finally {
+        rmSync(dir, { recursive: true, force: true });
+    }
+}
+// ── renderBriefLine and referencedDocs ─────────────────────────────────────
+{
+    const dir = tmpProject((c) => {
+        c.currentPhase = "build";
+    }, plan([mkTask("task-1", "complete"), mkTask("task-2", "in_progress"), mkTask("task-3", "pending")]));
+    try {
+        const brief = await buildBrief(dir);
+        assert.equal(renderBriefLine(brief), "build · feature-001/task-2 · 1/3");
+        assert.deepEqual(referencedDocs(dir, null), [], "no phase, no docs");
+        assert.deepEqual(referencedDocs(dir, "build"), [], "nothing to point at yet");
+        mkdirSync(join(dir, "harness", "docs", "phases"), { recursive: true });
+        mkdirSync(join(dir, "harness", "docs", "agents"), { recursive: true });
+        writeFileSync(join(dir, "harness", "docs", "phases", "build.md"), "# build", "utf-8");
+        writeFileSync(join(dir, "harness", "docs", "agents", "generator.md"), "# generator", "utf-8");
+        const docs = referencedDocs(dir, "build");
+        assert.equal(docs.length, 2);
+        assert.ok(docs[0].endsWith(join("docs", "phases", "build.md")));
+        assert.ok(docs[1].endsWith(join("docs", "agents", "generator.md")), "the doc follows the phase's role");
+        console.log("✓ renderBriefLine and referencedDocs");
+    }
+    finally {
+        rmSync(dir, { recursive: true, force: true });
+    }
+}
+console.log("All brief tests PASS");
+//# sourceMappingURL=brief.test.js.map

package/dist/tests/brief.test.js.map

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

package/dist/tests/config.test.js

@@ -0,0 +1,320 @@
+import assert from "node:assert/strict";
+import { mkdtempSync, rmSync, mkdirSync, writeFileSync, readFileSync, existsSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { COVERAGE_THRESHOLD_DEFAULT, DEFAULT_FEATURE_RETRIES, DEFAULT_MAX_RETRIES, DEFAULT_PHASE_RETRIES, GATE_HISTORY_LIMIT, currentRoleFor, defaultConfig, getKey, getRetryConfig, incrementFeatureRetry, incrementPhaseRetry, incrementTaskRetry, isHarnessProject, isRetryExhausted, loadConfig, recordGate, resetFeatureRetry, resetPhaseRetry, resetTaskRetry, saveConfig, setKey, trimGateHistory, validateConfig, } from "../src/core/config.js";
+import { DEFAULT_ENABLED_PHASES } from "../src/core/types.js";
+function tmpProject() {
+    const d = mkdtempSync(join(tmpdir(), "pi-config-"));
+    mkdirSync(join(d, "harness"), { recursive: true });
+    return d;
+}
+function configFile(dir) {
+    return join(dir, "harness", "config.json");
+}
+function writeRaw(dir, text) {
+    writeFileSync(configFile(dir), text, "utf-8");
+}
+// ── defaults ───────────────────────────────────────────────────────────────
+{
+    const c = defaultConfig();
+    assert.equal(c.version, "2.0");
+    assert.equal(c.mode, "copilot");
+    assert.equal(c.currentPhase, null, "a fresh project has not entered a phase");
+    assert.equal(c.currentRole, null);
+    assert.equal(c.paused, false);
+    assert.equal(c.gates.enabled, true, "gates are on by default — that is the whole point");
+    assert.deepEqual(c.gates.checks, ["all"]);
+    assert.equal(c.gates.coverage.enabled, false);
+    assert.equal(c.gates.coverage.threshold, COVERAGE_THRESHOLD_DEFAULT);
+    assert.equal(c.gates.antiPlaceholder.enabled, true);
+    assert.deepEqual(c.phases.enabled, DEFAULT_ENABLED_PHASES);
+    assert.ok(!c.phases.enabled.includes("simplify"), "SIMPLIFY is opt-in");
+    assert.equal(c.maxRetries, DEFAULT_MAX_RETRIES);
+    assert.deepEqual(c.gateHistory, []);
+    assert.deepEqual(validateConfig(c), [], "the defaults are themselves valid");
+    // Each call is a fresh object — one caller's mutation cannot leak into another's.
+    const other = defaultConfig();
+    other.gates.checks.push("lint");
+    assert.deepEqual(defaultConfig().gates.checks, ["all"]);
+    assert.notEqual(c.phases.enabled, other.phases.enabled);
+    console.log("✓ defaults");
+}
+// ── deep merge over defaults ───────────────────────────────────────────────
+{
+    const dir = tmpProject();
+    try {
+        writeRaw(dir, JSON.stringify({
+            mode: "autopilot",
+            currentPhase: "build",
+            gates: { coverage: { threshold: 95 }, checks: ["lint", "tests"] },
+            phases: { enabled: ["define", "build"] },
+            retry: { features: { enabled: true } },
+            customFutureKey: { nested: true },
+        }));
+        const { ok, config, seeded, error } = loadConfig(dir);
+        assert.equal(ok, true);
+        assert.equal(seeded, false);
+        assert.equal(error, null);
+        // Supplied values win.
+        assert.equal(config.mode, "autopilot");
+        assert.equal(config.currentPhase, "build");
+        assert.equal(config.gates.coverage.threshold, 95);
+        // Nested defaults the partial never mentioned survive the merge.
+        assert.equal(config.gates.enabled, true, "gates.enabled survives a partial gates block");
+        assert.equal(config.gates.coverage.enabled, false, "sibling key inside a nested object survives");
+        assert.equal(config.gates.antiPlaceholder.enabled, true);
+        assert.equal(config.retry.features.maxRetries, DEFAULT_FEATURE_RETRIES, "sibling of a nested override survives");
+        assert.equal(config.retry.tasks.enabled, true, "untouched nested branches survive");
+        assert.equal(config.maxRetries, DEFAULT_MAX_RETRIES);
+        // Arrays are replaced wholesale, never element-merged.
+        assert.deepEqual(config.gates.checks, ["lint", "tests"]);
+        assert.deepEqual(config.phases.enabled, ["define", "build"]);
+        // Keys the harness does not know about are carried through untouched.
+        assert.deepEqual(config.customFutureKey, { nested: true });
+        console.log("✓ deep merge keeps nested defaults and replaces arrays");
+    }
+    finally {
+        rmSync(dir, { recursive: true, force: true });
+    }
+}
+// ── loadConfig: missing vs empty vs corrupt ────────────────────────────────
+{
+    const dir = tmpProject();
+    try {
+        assert.equal(isHarnessProject(dir), false);
+        const missing = loadConfig(dir);
+        assert.equal(missing.ok, false, "an uninitialised project is not ok");
+        assert.equal(missing.seeded, true, "…but it is seeded with defaults so callers can still read state");
+        assert.match(missing.error ?? "", /no harness\/config.json/);
+        assert.deepEqual(missing.config, defaultConfig());
+        writeRaw(dir, "");
+        assert.equal(isHarnessProject(dir), true, "the file exists even though it says nothing");
+        const empty = loadConfig(dir);
+        assert.equal(empty.ok, false);
+        assert.equal(empty.seeded, true);
+        assert.match(empty.error ?? "", /empty/);
+        // A corrupt file must never throw: every lifecycle hook calls loadConfig,
+        // and a throw there kills the session.
+        writeRaw(dir, '{ "mode": "autopilot", ');
+        let corrupt;
+        assert.doesNotThrow(() => {
+            corrupt = loadConfig(dir);
+        }, "loadConfig must not throw on a corrupt file");
+        assert.equal(corrupt.ok, false);
+        assert.equal(corrupt.seeded, false, "corrupt is not the same as absent — do not claim it was seeded");
+        assert.ok(corrupt.error && corrupt.error.length > 0, "the parse error is reported");
+        assert.match(corrupt.error, /not valid JSON/);
+        assert.deepEqual(corrupt.config, defaultConfig(), "callers still get a usable config object");
+        // The corrupt file is left alone rather than clobbered with defaults.
+        assert.equal(readFileSync(configFile(dir), "utf-8"), '{ "mode": "autopilot", ');
+        console.log("✓ loadConfig: missing, empty and corrupt all degrade without throwing");
+    }
+    finally {
+        rmSync(dir, { recursive: true, force: true });
+    }
+}
+// ── saveConfig round-trip ──────────────────────────────────────────────────
+{
+    const dir = tmpProject();
+    try {
+        const c = defaultConfig();
+        c.currentPhase = "verify";
+        c.currentRole = currentRoleFor("verify");
+        c.currentFeature = "feature-002";
+        c.currentTask = "feature-002/task-3";
+        c.taskRetryCount = 4;
+        c.gates.coverage.threshold = 91;
+        c.commands.test = "npm test";
+        recordGate(c, "build", "pass", { feature: "feature-001", task: "task-1" });
+        const saved = saveConfig(dir, c);
+        assert.equal(saved.ok, true);
+        assert.equal(saved.error, null);
+        assert.ok(existsSync(configFile(dir)));
+        const round = loadConfig(dir);
+        assert.equal(round.ok, true);
+        assert.deepEqual(round.config, c, "everything written comes back identical");
+        assert.equal(round.config.currentRole, "evaluator");
+        assert.equal(round.config.gateHistory.length, 1);
+        assert.equal(round.config.gateHistory[0].feature, "feature-001");
+        // The previous revision is kept beside the file before it is overwritten.
+        assert.equal(existsSync(configFile(dir) + ".bak"), false, "nothing to back up on the first write");
+        round.config.currentPhase = "review";
+        saveConfig(dir, round.config);
+        assert.equal(existsSync(configFile(dir) + ".bak"), true, "the prior revision is kept");
+        assert.equal(JSON.parse(readFileSync(configFile(dir) + ".bak", "utf-8")).currentPhase, "verify");
+        assert.equal(loadConfig(dir).config.currentPhase, "review");
+        console.log("✓ saveConfig round-trip and backup");
+    }
+    finally {
+        rmSync(dir, { recursive: true, force: true });
+    }
+}
+// ── gate history ───────────────────────────────────────────────────────────
+{
+    const c = defaultConfig();
+    recordGate(c, "build", "fail");
+    assert.equal(c.gateHistory.length, 1);
+    const entry = c.gateHistory[0];
+    assert.equal(entry.phase, "build");
+    assert.equal(entry.result, "fail");
+    assert.ok(!Number.isNaN(Date.parse(entry.timestamp)), "the timestamp is an ISO instant");
+    assert.equal("feature" in entry, false, "scope keys are omitted, not written as undefined");
+    assert.equal("task" in entry, false);
+    recordGate(c, "verify", "pass", { feature: "feature-001", task: "task-2" });
+    assert.equal(c.gateHistory[1].feature, "feature-001");
+    assert.equal(c.gateHistory[1].task, "task-2");
+    // A corrupted gateHistory is repaired rather than allowed to throw.
+    c.gateHistory = "not an array";
+    trimGateHistory(c);
+    assert.deepEqual(c.gateHistory, []);
+    c.gateHistory = null;
+    recordGate(c, "ship", "pass");
+    assert.equal(c.gateHistory.length, 1);
+    // Unbounded growth is a real problem on multi-day runs: the newest entries win.
+    const big = defaultConfig();
+    const overflow = GATE_HISTORY_LIMIT + 100;
+    for (let i = 0; i < overflow; i++)
+        recordGate(big, `p${i}`, i % 2 === 0 ? "pass" : "fail");
+    assert.equal(big.gateHistory.length, GATE_HISTORY_LIMIT, "history is capped");
+    assert.equal(big.gateHistory[GATE_HISTORY_LIMIT - 1].phase, `p${overflow - 1}`, "the newest entry is kept");
+    assert.equal(big.gateHistory[0].phase, `p${overflow - GATE_HISTORY_LIMIT}`, "the oldest entries are dropped");
+    // trimGateHistory is idempotent and leaves an under-cap history alone.
+    const before = JSON.stringify(big.gateHistory);
+    trimGateHistory(big);
+    assert.equal(JSON.stringify(big.gateHistory), before);
+    console.log("✓ recordGate and trimGateHistory cap the history at GATE_HISTORY_LIMIT");
+}
+// ── retry budgets ──────────────────────────────────────────────────────────
+{
+    const c = defaultConfig();
+    const r = getRetryConfig(c);
+    assert.equal(r.tasks.enabled, true);
+    assert.equal(r.tasks.max, DEFAULT_MAX_RETRIES);
+    assert.equal(r.features.enabled, false);
+    assert.equal(r.features.max, DEFAULT_FEATURE_RETRIES);
+    assert.equal(r.phases.enabled, false);
+    assert.equal(r.phases.max, DEFAULT_PHASE_RETRIES);
+    assert.equal(r.levels.task.enabled, true);
+    assert.equal(r.levels.subtask.max, 3);
+    assert.equal(r.levels.goal.max, 2);
+    // A null task budget inherits the legacy `maxRetries` knob.
+    c.maxRetries = 3;
+    assert.equal(getRetryConfig(c).tasks.max, 3, "tasks.maxRetries=null falls back to maxRetries");
+    c.retry.tasks.maxRetries = 7;
+    assert.equal(getRetryConfig(c).tasks.max, 7, "an explicit budget wins over the legacy knob");
+    // Counters.
+    const k = defaultConfig();
+    assert.equal(incrementTaskRetry(k), 1);
+    assert.equal(incrementTaskRetry(k), 2);
+    resetTaskRetry(k);
+    assert.equal(k.taskRetryCount, 0);
+    assert.equal(incrementFeatureRetry(k), 1);
+    resetFeatureRetry(k);
+    assert.equal(k.featureRetryCount, 0);
+    assert.equal(incrementPhaseRetry(k), 1);
+    assert.equal(k.retryCount, 1, "the phase counter keeps the legacy retryCount in step");
+    incrementPhaseRetry(k);
+    assert.equal(k.phaseRetryCount, 2);
+    assert.equal(k.retryCount, 2);
+    resetPhaseRetry(k);
+    assert.equal(k.phaseRetryCount, 0);
+    assert.equal(k.retryCount, 0);
+    // Counters survive an absent field (an older config file).
+    const legacy = defaultConfig();
+    delete legacy.taskRetryCount;
+    assert.equal(incrementTaskRetry(legacy), 1);
+    console.log("✓ retry counters");
+}
+// ── isRetryExhausted respects the enabled flags ────────────────────────────
+{
+    const c = defaultConfig();
+    assert.deepEqual(isRetryExhausted(c), { exhausted: false, which: null });
+    c.taskRetryCount = DEFAULT_MAX_RETRIES;
+    assert.deepEqual(isRetryExhausted(c), { exhausted: true, which: "task" }, "task budget is enabled by default");
+    // A disabled bucket is never exhausted, however high the counter goes.
+    c.retry.tasks.enabled = false;
+    c.taskRetryCount = 9999;
+    assert.deepEqual(isRetryExhausted(c), { exhausted: false, which: null }, "a disabled budget cannot stop the run");
+    c.featureRetryCount = 99;
+    assert.equal(isRetryExhausted(c).exhausted, false, "the feature budget is off by default too");
+    c.retry.features.enabled = true;
+    assert.deepEqual(isRetryExhausted(c), { exhausted: true, which: "feature" });
+    const p = defaultConfig();
+    p.retry.tasks.enabled = false;
+    p.retry.phases.enabled = true;
+    p.phaseRetryCount = DEFAULT_PHASE_RETRIES - 1;
+    assert.equal(isRetryExhausted(p).exhausted, false, "one under the limit is not exhausted");
+    p.phaseRetryCount = DEFAULT_PHASE_RETRIES;
+    assert.deepEqual(isRetryExhausted(p), { exhausted: true, which: "phase" }, "the limit itself is exhausted");
+    // Reporting order: the most specific budget is named first.
+    const all = defaultConfig();
+    all.retry.features.enabled = true;
+    all.retry.phases.enabled = true;
+    all.taskRetryCount = 999;
+    all.featureRetryCount = 999;
+    all.phaseRetryCount = 999;
+    assert.equal(isRetryExhausted(all).which, "task");
+    console.log("✓ isRetryExhausted respects the enabled flags");
+}
+// ── dotted get/set ─────────────────────────────────────────────────────────
+{
+    const c = defaultConfig();
+    assert.equal(getKey(c, "mode"), "copilot");
+    assert.equal(getKey(c, "gates.coverage.threshold"), COVERAGE_THRESHOLD_DEFAULT);
+    assert.equal(getKey(c, "retry.tasks.enabled"), true);
+    assert.deepEqual(getKey(c, "gates.checks"), ["all"]);
+    assert.equal(getKey(c, "gates.nope"), undefined, "an unknown leaf is undefined");
+    assert.equal(getKey(c, "nope.nope.nope"), undefined, "an unknown branch is undefined, not a throw");
+    assert.equal(getKey(c, "maxRetries.deeper"), undefined, "descending into a scalar is undefined");
+    setKey(c, "gates.coverage.threshold", 65);
+    assert.equal(c.gates.coverage.threshold, 65);
+    setKey(c, "mode", "autopilot");
+    assert.equal(c.mode, "autopilot");
+    setKey(c, "gates.checks", ["lint"]);
+    assert.deepEqual(c.gates.checks, ["lint"]);
+    // Setting one key in an existing section leaves its siblings alone — the
+    // config TUI writes a single setting at a time and must not blank the rest.
+    setKey(c, "loop.maxIterations", 25);
+    assert.equal(c.loop.maxIterations, 25);
+    assert.equal(c.loop.noProgressLimit, 3, "a sibling in the same section survives");
+    // Missing intermediates are created all the way down.
+    setKey(c, "custom.nested.deep.value", "x");
+    assert.equal(getKey(c, "custom.nested.deep.value"), "x");
+    setKey(c, "custom.nested.other", 1);
+    assert.equal(getKey(c, "custom.nested.deep.value"), "x", "creating a sibling does not wipe the branch");
+    // A scalar standing where an object is needed is replaced.
+    setKey(c, "maxRetries.deeper", 1);
+    assert.deepEqual(c.maxRetries, { deeper: 1 });
+    // Dotted writes survive a save/load round-trip.
+    const dir = tmpProject();
+    try {
+        const fresh = defaultConfig();
+        setKey(fresh, "loop.maxWallClockMs", 1234);
+        saveConfig(dir, fresh);
+        assert.equal(getKey(loadConfig(dir).config, "loop.maxWallClockMs"), 1234);
+    }
+    finally {
+        rmSync(dir, { recursive: true, force: true });
+    }
+    console.log("✓ getKey/setKey on dotted paths");
+}
+// ── validateConfig / currentRoleFor ────────────────────────────────────────
+{
+    const c = defaultConfig();
+    delete c.gates;
+    c.mode = null;
+    const missing = validateConfig(c);
+    assert.ok(missing.includes("gates"));
+    assert.ok(missing.includes("mode"));
+    assert.ok(!missing.includes("currentPhase"), "currentPhase is legitimately null before INIT");
+    assert.equal(currentRoleFor(null), null);
+    assert.equal(currentRoleFor("plan"), "planner");
+    assert.equal(currentRoleFor("build"), "generator");
+    assert.equal(currentRoleFor("verify"), "evaluator");
+    assert.equal(currentRoleFor("simplify"), "simplifier");
+    assert.equal(currentRoleFor("ship"), "evaluator");
+    console.log("✓ validateConfig and currentRoleFor");
+}
+console.log("All config tests PASS");
+//# sourceMappingURL=config.test.js.map