easy-coding-harness 1.1.0-beta.0 → 1.1.0-beta.2

package/dist/cli.js

@@ -63,6 +63,8 @@ function colorizeBanner(art) {
 // src/utils/config-yaml.ts
 import { randomUUID } from "crypto";
 import { readFile as readFile2 } from "fs/promises";
+import os from "os";
+import path3 from "path";
 import YAML, { isScalar, isSeq, parseDocument } from "yaml";
 
 // src/utils/file-writer.ts
@@ -103,10 +105,75 @@ async function isDirectory(filePath) {
 }
 
 // src/utils/config-yaml.ts
-var CONFIG_SCHEMA_VERSION = 5;
-var DEFAULT_TDD_COVERAGE_THRESHOLD = 90;
+var CONFIG_SCHEMA_VERSION = 6;
+var DEFAULT_UT_COVERAGE_THRESHOLD = 90;
+var UNIT_TEST_MODES = ["none", "ut", "tdd"];
 var APPROVAL_MODES = ["approve", "guard", "confirm", "auto"];
+var COOPERATE_MODES = ["default", "dispatch"];
 var CONFIGURED_WORKFLOW_MODES = ["adaptive", "fast", "standard", "strict"];
+var BEHAVIOR_DEFAULTS = {
+  approval_mode: "guard",
+  cooperate_mode: "default",
+  unit_test_mode: "none",
+  ut_coverage_threshold: DEFAULT_UT_COVERAGE_THRESHOLD
+};
+var BEHAVIOR_KEYS = Object.keys(BEHAVIOR_DEFAULTS);
+function localConfigPath() {
+  return path3.join(os.homedir(), ".easy-coding", "config.yaml");
+}
+function validateBehaviorValue(key, value) {
+  const valid = key === "approval_mode" ? isApprovalMode(value) : key === "cooperate_mode" ? COOPERATE_MODES.includes(value) : key === "unit_test_mode" ? isUnitTestMode(value) : isUtCoverageThreshold(value);
+  if (!valid) throw new Error(`Invalid behavior.${key}: ${String(value)}`);
+}
+async function readLocalBehavior() {
+  let content;
+  try {
+    content = await readFile2(localConfigPath(), "utf8");
+  } catch (error) {
+    if (error.code === "ENOENT") return {};
+    throw error;
+  }
+  const settings = YAML.parse(content)?.behavior ?? {};
+  for (const key of BEHAVIOR_KEYS) {
+    if (settings[key] !== void 0) validateBehaviorValue(key, settings[key]);
+  }
+  return Object.fromEntries(
+    BEHAVIOR_KEYS.filter((key) => settings[key] !== void 0).map((key) => [key, settings[key]])
+  );
+}
+function resolveBehaviorSettings(project, local = {}, session = {}) {
+  const values = { ...BEHAVIOR_DEFAULTS };
+  const sources = {};
+  for (const key of BEHAVIOR_KEYS) {
+    const layer = session[key] !== void 0 ? "session" : local[key] !== void 0 ? "local" : project[key] !== void 0 ? "project" : "default";
+    const value = layer === "session" ? session[key] : layer === "local" ? local[key] : layer === "project" ? project[key] : BEHAVIOR_DEFAULTS[key];
+    validateBehaviorValue(key, value);
+    Object.assign(values, { [key]: value });
+    sources[key] = layer;
+  }
+  return { values, sources };
+}
+async function writeBehaviorOverrides(filePath, changes) {
+  let content = "";
+  try {
+    content = await readFile2(filePath, "utf8");
+  } catch (error) {
+    if (error.code !== "ENOENT") throw error;
+  }
+  const document = parseDocument(content);
+  for (const key of BEHAVIOR_KEYS) {
+    const value = changes[key];
+    if (value === void 0) continue;
+    if (value === null) {
+      if (document.hasIn(["behavior", key])) document.deleteIn(["behavior", key]);
+    } else {
+      validateBehaviorValue(key, value);
+      document.setIn(["behavior", key], value);
+    }
+  }
+  if (!content && !document.has("behavior")) return;
+  await writeTextFile(filePath, document.toString());
+}
 function createDefaultConfig(params) {
   const config2 = {
     version: CONFIG_SCHEMA_VERSION,
@@ -127,8 +194,9 @@ function createDefaultConfig(params) {
     behavior: {
       approval_mode: "guard",
       workflow_mode: "adaptive",
-      tdd_enabled: false,
-      tdd_coverage_threshold: DEFAULT_TDD_COVERAGE_THRESHOLD
+      unit_test_mode: "none",
+      ut_coverage_threshold: DEFAULT_UT_COVERAGE_THRESHOLD,
+      cooperate_mode: "default"
     }
   };
   if (params.supermodule) {
@@ -182,43 +250,66 @@ function isApprovalMode(value) {
 function isConfiguredWorkflowMode(value) {
   return typeof value === "string" && CONFIGURED_WORKFLOW_MODES.includes(value);
 }
-function isTddCoverageThreshold(value) {
+function isUtCoverageThreshold(value) {
   return Number.isInteger(value) && Number(value) >= 1 && Number(value) <= 100;
 }
+function isUnitTestMode(value) {
+  return typeof value === "string" && UNIT_TEST_MODES.includes(value);
+}
+function migrateUnitTestSettings(record) {
+  let changed = false;
+  if ("tdd_enabled" in record) {
+    if (!("unit_test_mode" in record) && typeof record.tdd_enabled === "boolean") {
+      record.unit_test_mode = record.tdd_enabled ? "tdd" : "none";
+    }
+    Reflect.deleteProperty(record, "tdd_enabled");
+    changed = true;
+  }
+  if ("tdd_coverage_threshold" in record) {
+    record.ut_coverage_threshold ??= record.tdd_coverage_threshold;
+    Reflect.deleteProperty(record, "tdd_coverage_threshold");
+    changed = true;
+  }
+  return changed;
+}
 function resolveLegacyBehavior(config2) {
   const behavior = config2.behavior ?? {};
   const legacyLite = behavior.confirm_mode === "lite";
   const approvalMode = isApprovalMode(behavior.approval_mode) ? behavior.approval_mode : isApprovalMode(behavior.confirm_mode) ? behavior.confirm_mode : behavior.auto_mode === true ? "auto" : behavior.strict_confirm === true ? "approve" : "guard";
   const workflowMode = isConfiguredWorkflowMode(behavior.workflow_mode) ? behavior.workflow_mode : legacyLite ? "fast" : "adaptive";
-  const supportsTddThreshold = Number(config2.version) >= 4;
-  const tddEnabled = supportsTddThreshold && behavior.tdd_enabled === true;
-  const tddCoverageThreshold = supportsTddThreshold && isTddCoverageThreshold(behavior.tdd_coverage_threshold) ? behavior.tdd_coverage_threshold : DEFAULT_TDD_COVERAGE_THRESHOLD;
-  return { approvalMode, workflowMode, tddEnabled, tddCoverageThreshold };
+  const unitTestMode = isUnitTestMode(behavior.unit_test_mode) ? behavior.unit_test_mode : Number(config2.version) >= 4 && behavior.tdd_enabled === true ? "tdd" : "none";
+  const configuredThreshold = behavior.ut_coverage_threshold ?? (Number(config2.version) >= 4 ? behavior.tdd_coverage_threshold : void 0);
+  const utCoverageThreshold = isUtCoverageThreshold(configuredThreshold) ? configuredThreshold : DEFAULT_UT_COVERAGE_THRESHOLD;
+  return { approvalMode, workflowMode, unitTestMode, utCoverageThreshold };
 }
-async function setBehaviorModes(filePath, approvalMode, workflowMode, tddEnabled, tddCoverageThreshold) {
-  if (tddCoverageThreshold !== void 0 && !isTddCoverageThreshold(tddCoverageThreshold)) {
-    throw new Error("TDD coverage threshold must be an integer from 1 to 100.");
+async function setBehaviorModes(filePath, approvalMode, workflowMode, unitTestMode, utCoverageThreshold, cooperateMode) {
+  if (unitTestMode !== void 0 && !isUnitTestMode(unitTestMode)) {
+    throw new Error("Unit test mode must be none, ut, or tdd.");
+  }
+  if (utCoverageThreshold !== void 0 && !isUtCoverageThreshold(utCoverageThreshold)) {
+    throw new Error("Unit test coverage threshold must be an integer from 1 to 100.");
   }
   return updateConfigYaml(filePath, (config2) => {
     const legacyBehavior = config2.behavior ?? {};
     const resolvedBehavior = resolveLegacyBehavior(config2);
     const behavior = Object.fromEntries(
       Object.entries(legacyBehavior).filter(
-        ([key]) => key !== "strict_confirm" && key !== "auto_mode" && key !== "confirm_mode" && key !== "approval_mode" && key !== "workflow_mode" && key !== "tdd_enabled" && key !== "tdd_coverage_threshold"
+        ([key]) => key !== "strict_confirm" && key !== "auto_mode" && key !== "confirm_mode" && key !== "approval_mode" && key !== "workflow_mode" && key !== "tdd_enabled" && key !== "tdd_coverage_threshold" && key !== "unit_test_mode" && key !== "ut_coverage_threshold"
       )
     );
     behavior.approval_mode = approvalMode;
     behavior.workflow_mode = workflowMode;
-    behavior.tdd_enabled = tddEnabled ?? resolvedBehavior.tddEnabled;
-    behavior.tdd_coverage_threshold = tddCoverageThreshold ?? resolvedBehavior.tddCoverageThreshold;
+    behavior.unit_test_mode = unitTestMode ?? resolvedBehavior.unitTestMode;
+    behavior.ut_coverage_threshold = utCoverageThreshold ?? resolvedBehavior.utCoverageThreshold;
+    behavior.cooperate_mode = cooperateMode ?? legacyBehavior.cooperate_mode ?? "default";
     config2.behavior = behavior;
     config2.version = CONFIG_SCHEMA_VERSION;
   });
 }
 async function migrateBehaviorConfig(filePath) {
   const config2 = await readConfigYaml(filePath);
-  const { approvalMode, workflowMode, tddEnabled, tddCoverageThreshold } = resolveLegacyBehavior(config2);
-  return setBehaviorModes(filePath, approvalMode, workflowMode, tddEnabled, tddCoverageThreshold);
+  const { approvalMode, workflowMode, unitTestMode, utCoverageThreshold } = resolveLegacyBehavior(config2);
+  return setBehaviorModes(filePath, approvalMode, workflowMode, unitTestMode, utCoverageThreshold);
 }
 async function ensureProjectId(filePath) {
   let projectId = "";
@@ -243,7 +334,7 @@ function createProjectId() {
 }
 
 // src/utils/gitignore.ts
-import path3 from "path";
+import path4 from "path";
 
 // src/constants/paths.ts
 var EASY_CODING_DIR = ".easy-coding";
@@ -267,7 +358,7 @@ var GENERATED_REGION_END = "<!-- \u2550\u2550\u2550 end easy-coding-harness gene
 
 // src/utils/gitignore.ts
 async function ensureGitignoreEntry(cwd, entry, heading = "# \u2550\u2550\u2550 easy-coding-harness (auto-generated) \u2550\u2550\u2550\n# Personal runtime state; do not commit") {
-  const gitignorePath = path3.join(cwd, ".gitignore");
+  const gitignorePath = path4.join(cwd, ".gitignore");
   const current = await readTextIfExists(gitignorePath) ?? "";
   const lines = current.split(/\r?\n/).map((line) => line.trim());
   if (lines.includes(entry)) {
@@ -292,7 +383,7 @@ async function ensureHookBytecodeIgnored(cwd) {
 // src/utils/install-manifest.ts
 import { createHash } from "crypto";
 import { readFile as readFile3, rmdir, unlink } from "fs/promises";
-import path4 from "path";
+import path5 from "path";
 
 // src/types/platform.ts
 var pythonCmd = process.platform === "win32" ? "python" : "python3";
@@ -464,12 +555,12 @@ async function writeInstallManifest(cwd, params) {
     constraint_regions: [...constraintRegions.values()].sort(byPath)
   };
   await writeTextFile(
-    path4.join(cwd, EASY_CODING_DIR, INSTALL_MANIFEST_FILE),
+    path5.join(cwd, EASY_CODING_DIR, INSTALL_MANIFEST_FILE),
     JSON.stringify(manifest, null, 2)
   );
 }
 async function readInstallManifest(cwd) {
-  const manifestPath2 = path4.join(cwd, EASY_CODING_DIR, INSTALL_MANIFEST_FILE);
+  const manifestPath2 = path5.join(cwd, EASY_CODING_DIR, INSTALL_MANIFEST_FILE);
   const content = await readTextIfExists(manifestPath2);
   if (content === null) {
     return null;
@@ -511,7 +602,7 @@ async function pruneRetiredManagedFiles(cwd, previous, artifacts) {
     await unlink(filePath);
     removed.push(file.path);
     try {
-      await rmdir(path4.dirname(filePath));
+      await rmdir(path5.dirname(filePath));
     } catch (error) {
       if (!["ENOENT", "ENOTEMPTY"].includes(error.code ?? "")) {
         throw error;
@@ -530,10 +621,10 @@ function manifestPath(cwd, projectPath) {
   return resolveProjectPath(cwd, projectPath);
 }
 function toProjectPath(cwd, filePath) {
-  const root = path4.resolve(cwd);
-  const resolved = path4.resolve(filePath);
+  const root = path5.resolve(cwd);
+  const resolved = path5.resolve(filePath);
   assertPathInsideProject(root, resolved, filePath);
-  return path4.relative(root, resolved).split(path4.sep).join("/");
+  return path5.relative(root, resolved).split(path5.sep).join("/");
 }
 function normalizeCommand(command) {
   return command.replace(/\\/g, "/").trim().replace(/\s+/g, " ");
@@ -545,17 +636,17 @@ async function sha256File(filePath) {
 function resolveProjectPath(cwd, projectPath) {
   const normalized = projectPath.replace(/\\/g, "/");
   const parts = normalized.split("/");
-  if (normalized.trim() === "" || path4.isAbsolute(projectPath) || path4.posix.isAbsolute(normalized) || path4.win32.isAbsolute(projectPath) || /^[A-Za-z]:/.test(projectPath) || parts.some((part) => part === "..")) {
+  if (normalized.trim() === "" || path5.isAbsolute(projectPath) || path5.posix.isAbsolute(normalized) || path5.win32.isAbsolute(projectPath) || /^[A-Za-z]:/.test(projectPath) || parts.some((part) => part === "..")) {
     throw new Error(`Unsafe install manifest path: ${projectPath}`);
   }
-  const root = path4.resolve(cwd);
-  const resolved = path4.resolve(root, normalized);
+  const root = path5.resolve(cwd);
+  const resolved = path5.resolve(root, normalized);
   assertPathInsideProject(root, resolved, projectPath);
   return resolved;
 }
 function assertPathInsideProject(root, resolvedPath, sourcePath) {
-  const relative = path4.relative(root, resolvedPath);
-  if (!relative || relative.startsWith("..") || path4.isAbsolute(relative)) {
+  const relative = path5.relative(root, resolvedPath);
+  if (!relative || relative.startsWith("..") || path5.isAbsolute(relative)) {
     throw new Error(`Unsafe install manifest path: ${sourcePath}`);
   }
 }
@@ -654,7 +745,7 @@ function isHookPythonPath(candidate) {
 }
 function normalizeHookPath(cwd, hookPath) {
   const normalized = hookPath.replace(/\\/g, "/").replace(/^\.\//, "");
-  if (path4.isAbsolute(hookPath) || path4.posix.isAbsolute(normalized) || path4.win32.isAbsolute(hookPath)) {
+  if (path5.isAbsolute(hookPath) || path5.posix.isAbsolute(normalized) || path5.win32.isAbsolute(hookPath)) {
     return toProjectPath(cwd, hookPath);
   }
   return normalized;
@@ -664,97 +755,11 @@ function byPath(a, b) {
 }
 
 // src/utils/runtime-scaffold.ts
-import path6 from "path";
-
-// src/utils/template-paths.ts
-import { existsSync } from "fs";
-import path5 from "path";
-import { fileURLToPath as fileURLToPath2 } from "url";
-function getTemplateRoot() {
-  const here = path5.dirname(fileURLToPath2(import.meta.url));
-  const candidates = [
-    path5.resolve(here, "../templates"),
-    path5.resolve(here, "../../templates"),
-    path5.resolve(process.cwd(), "src/templates"),
-    path5.resolve(process.cwd(), "templates")
-  ];
-  const found = candidates.find((candidate) => existsSync(candidate));
-  if (!found) {
-    throw new Error(`Unable to locate templates directory. Tried: ${candidates.join(", ")}`);
-  }
-  return found;
-}
-function getTemplatePath(...segments) {
-  return path5.join(getTemplateRoot(), ...segments);
-}
-
-// src/utils/runtime-scaffold.ts
-async function writeRuntimeScaffold(cwd, agents, opts = {}) {
-  const easyCodingDir = path6.join(cwd, EASY_CODING_DIR);
-  await ensureDir(easyCodingDir);
-  const configPath2 = path6.join(easyCodingDir, CONFIG_FILE);
-  let projectId = opts.projectId ?? createProjectId();
-  if (!await pathExists(configPath2)) {
-    const projectName = path6.basename(cwd);
-    await writeConfigYaml(
-      configPath2,
-      createDefaultConfig({
-        projectName,
-        projectId,
-        harnessVersion: VERSION,
-        agents,
-        supermodule: opts.supermodule
-      })
-    );
-  } else {
-    projectId = await ensureProjectId(configPath2);
-  }
-  await ensureDir(path6.join(easyCodingDir, "tasks"));
-  await ensureDir(path6.join(easyCodingDir, SESSIONS_DIR));
-  await ensureDir(path6.join(easyCodingDir, SPEC_DIR, MAIN_SPEC_DIR));
-  await ensureDir(path6.join(easyCodingDir, SPEC_DIR, DEV_SPEC_DIR));
-  await writeMemoryScaffold(easyCodingDir);
-  await writeTemplatesScaffold(easyCodingDir);
-  await writeToolsScaffold(easyCodingDir);
-  return projectId;
-}
-async function writeToolsScaffold(easyCodingDir) {
-  const toolsDir = path6.join(easyCodingDir, TOOLS_DIR);
-  await ensureDir(toolsDir);
-  for (const file of ["easy_coding_java_coverage.py", "easy_coding_tdd_readiness.py"]) {
-    const src = getTemplatePath("runtime", "tools", file);
-    await writeTextFile(path6.join(toolsDir, file), await readTextFile(src));
-  }
-}
-async function writeTemplatesScaffold(easyCodingDir) {
-  const templatesDir = path6.join(easyCodingDir, TEMPLATES_DIR);
-  await ensureDir(templatesDir);
-  const src = getTemplatePath("runtime", "templates", "dev-spec-skeleton.md");
-  const dest = path6.join(templatesDir, "dev-spec-skeleton.md");
-  await writeTextFile(dest, await readTextFile(src));
-}
-async function writeMemoryScaffold(easyCodingDir) {
-  const memoryDir = path6.join(easyCodingDir, MEMORY_DIR);
-  await ensureDir(path6.join(memoryDir, "short"));
-  await ensureDir(path6.join(memoryDir, "long"));
-  for (const file of ["MEMORY.md", "BUSINESS.md", "TECHNICAL.md"]) {
-    const destination = path6.join(memoryDir, "long", file);
-    if (await pathExists(destination)) {
-      continue;
-    }
-    const templatePath = getTemplatePath("runtime", "memory", "long", file);
-    await writeTextFile(destination, await readTextFile(templatePath));
-  }
-  const shortTemplateDest = path6.join(memoryDir, "SHORT_MEMORY_TEMPLATE.md");
-  if (!await pathExists(shortTemplateDest)) {
-    const templatePath = getTemplatePath("runtime", "memory", "SHORT_MEMORY_TEMPLATE.md");
-    await writeTextFile(shortTemplateDest, await readTextFile(templatePath));
-  }
-}
+import path8 from "path";
 
 // src/utils/task-json.ts
 import { readdir } from "fs/promises";
-import path7 from "path";
+import path6 from "path";
 var LEGACY_STAGE_MAP = {
   WAITING_CONFIRM: "ANALYSIS",
   MEMORY_SHORT: "MEMORY",
@@ -781,7 +786,7 @@ function createProjectInitTask(params) {
   };
 }
 function getTaskJsonPath(cwd, taskId) {
-  return path7.join(cwd, EASY_CODING_DIR, TASKS_DIR, taskId, "task.json");
+  return path6.join(cwd, EASY_CODING_DIR, TASKS_DIR, taskId, "task.json");
 }
 async function writeTaskJson(filePath, task) {
   await writeTextFile(filePath, JSON.stringify(task, null, 2));
@@ -1006,9 +1011,10 @@ function migrateTaskWorkflowState(task) {
     task.workflow_mode_legacy = true;
     changed = true;
   }
-  if (isActive && taskType !== "project-init" && typeof task.tdd_enabled !== "boolean") {
-    task.tdd_enabled = false;
-    task.tdd_coverage_threshold ??= DEFAULT_TDD_COVERAGE_THRESHOLD;
+  changed = migrateUnitTestSettings(task) || changed;
+  if (isActive && taskType !== "project-init" && task.unit_test_mode === void 0) {
+    task.unit_test_mode = "none";
+    task.ut_coverage_threshold ??= DEFAULT_UT_COVERAGE_THRESHOLD;
     task.tdd_confirmed_at = (/* @__PURE__ */ new Date()).toISOString();
     task.tdd_confirmed_by = "upgrade-migration";
     changed = true;
@@ -1017,6 +1023,7 @@ function migrateTaskWorkflowState(task) {
 }
 function migrateSessionBehavior(session) {
   let changed = migrateAgentFields(session, ["agent", "last_agent"]);
+  changed = migrateUnitTestSettings(session) || changed;
   const legacyMode = session.confirm_mode;
   const legacyLite = legacyMode === "lite";
   if (!["approve", "guard", "confirm", "auto"].includes(String(session.approval_mode ?? ""))) {
@@ -1092,16 +1099,16 @@ function migrationWorkflowMode(task, candidates, projectWorkflowMode) {
   );
 }
 async function taskFiles(cwd) {
-  const tasksDir = path7.join(cwd, EASY_CODING_DIR, TASKS_DIR);
+  const tasksDir = path6.join(cwd, EASY_CODING_DIR, TASKS_DIR);
   if (!await pathExists(tasksDir)) return [];
   const entries = await readdir(tasksDir, { withFileTypes: true });
-  return entries.filter((entry) => entry.isDirectory()).map((entry) => path7.join(tasksDir, entry.name, "task.json"));
+  return entries.filter((entry) => entry.isDirectory()).map((entry) => path6.join(tasksDir, entry.name, "task.json"));
 }
 async function sessionFiles(cwd) {
-  const sessionsDir = path7.join(cwd, EASY_CODING_DIR, SESSIONS_DIR);
+  const sessionsDir = path6.join(cwd, EASY_CODING_DIR, SESSIONS_DIR);
   if (!await pathExists(sessionsDir)) return [];
   const entries = await readdir(sessionsDir, { withFileTypes: true });
-  return entries.filter((entry) => entry.isFile() && entry.name.endsWith(".json")).map((entry) => path7.join(sessionsDir, entry.name));
+  return entries.filter((entry) => entry.isFile() && entry.name.endsWith(".json")).map((entry) => path6.join(sessionsDir, entry.name));
 }
 async function readJsonRecord(filePath) {
   try {
@@ -1116,7 +1123,7 @@ async function hasLegacyWorkflowState(cwd) {
     if (!await pathExists(filePath)) continue;
     const task = await readJsonRecord(filePath);
     if (!task) continue;
-    if (hasLegacyTaskAgentIdentities(task) || isLegacyStage(task.status) || "verification_checkpoint" in task || !["PENDING", "COMPLETE", "CLOSED"].includes(String(task.status ?? "")) && ["analysis", "doc", "report"].includes(String(task.type ?? "").toLowerCase()) || !["PENDING", "COMPLETE", "CLOSED"].includes(String(task.status ?? "")) && String(task.type ?? "") !== "project-init" && !["fast", "standard", "strict"].includes(String(task.workflow_mode ?? "")) || Array.isArray(task.stage_history) && task.stage_history.some(
+    if (hasLegacyTaskAgentIdentities(task) || isLegacyStage(task.status) || "verification_checkpoint" in task || "tdd_enabled" in task || "tdd_coverage_threshold" in task || !["PENDING", "COMPLETE", "CLOSED"].includes(String(task.status ?? "")) && ["analysis", "doc", "report"].includes(String(task.type ?? "").toLowerCase()) || !["PENDING", "COMPLETE", "CLOSED"].includes(String(task.status ?? "")) && String(task.type ?? "") !== "project-init" && !["fast", "standard", "strict"].includes(String(task.workflow_mode ?? "")) || Array.isArray(task.stage_history) && task.stage_history.some(
       (entry) => entry && typeof entry === "object" && !Array.isArray(entry) && isLegacyStage(entry.stage)
     )) {
       return true;
@@ -1128,7 +1135,7 @@ async function hasLegacyWorkflowState(cwd) {
     if (["agent", "last_agent"].some((field) => {
       const migrated = migratedAgentIdentity(session[field]);
       return migrated !== void 0 && migrated !== session[field];
-    }) || isLegacyStage(session.last_seen_stage) || "confirm_mode" in session) {
+    }) || isLegacyStage(session.last_seen_stage) || "confirm_mode" in session || "tdd_enabled" in session || "tdd_coverage_threshold" in session) {
       return true;
     }
   }
@@ -1139,7 +1146,7 @@ async function migrateLegacyWorkflowState(cwd) {
   let sessionsUpdated = 0;
   const updatedTaskPaths = /* @__PURE__ */ new Set();
   let projectWorkflowMode = "adaptive";
-  const configPath2 = path7.join(cwd, EASY_CODING_DIR, "config.yaml");
+  const configPath2 = path6.join(cwd, EASY_CODING_DIR, "config.yaml");
   if (await pathExists(configPath2)) {
     try {
       const config2 = await readConfigYaml(configPath2);
@@ -1194,7 +1201,7 @@ async function migrateLegacyWorkflowState(cwd) {
     if (!task) continue;
     const migrationOwned = task.workflow_mode_legacy === true && task.workflow_mode_confirmed_by === "upgrade-migration";
     if (!migrationOwned) continue;
-    const taskId = path7.basename(path7.dirname(filePath));
+    const taskId = path6.basename(path6.dirname(filePath));
     const mode = migrationWorkflowMode(
       task,
       candidatesByTask.get(taskId) ?? [],
@@ -1229,7 +1236,7 @@ async function setPendingInitSince(cwd, version) {
   await writeTaskJson(filePath, task);
 }
 async function listTasks(cwd) {
-  const tasksDir = path7.join(cwd, EASY_CODING_DIR, TASKS_DIR);
+  const tasksDir = path6.join(cwd, EASY_CODING_DIR, TASKS_DIR);
   if (!await pathExists(tasksDir)) {
     return [];
   }
@@ -1260,15 +1267,114 @@ function isActiveTask(task) {
   return task.status !== "COMPLETE" && task.status !== "CLOSED";
 }
 
+// src/utils/template-paths.ts
+import { existsSync } from "fs";
+import path7 from "path";
+import { fileURLToPath as fileURLToPath2 } from "url";
+function getTemplateRoot() {
+  const here = path7.dirname(fileURLToPath2(import.meta.url));
+  const candidates = [
+    path7.resolve(here, "../templates"),
+    path7.resolve(here, "../../templates"),
+    path7.resolve(process.cwd(), "src/templates"),
+    path7.resolve(process.cwd(), "templates")
+  ];
+  const found = candidates.find((candidate) => existsSync(candidate));
+  if (!found) {
+    throw new Error(`Unable to locate templates directory. Tried: ${candidates.join(", ")}`);
+  }
+  return found;
+}
+function getTemplatePath(...segments) {
+  return path7.join(getTemplateRoot(), ...segments);
+}
+
+// src/utils/runtime-scaffold.ts
+async function writeRuntimeScaffold(cwd, agents, opts = {}) {
+  const easyCodingDir = path8.join(cwd, EASY_CODING_DIR);
+  await ensureDir(easyCodingDir);
+  const configPath2 = path8.join(easyCodingDir, CONFIG_FILE);
+  let projectId = opts.projectId ?? createProjectId();
+  if (!await pathExists(configPath2)) {
+    const projectName = path8.basename(cwd);
+    await writeConfigYaml(
+      configPath2,
+      createDefaultConfig({
+        projectName,
+        projectId,
+        harnessVersion: VERSION,
+        agents,
+        supermodule: opts.supermodule
+      })
+    );
+  } else {
+    projectId = await ensureProjectId(configPath2);
+  }
+  await ensureDir(path8.join(easyCodingDir, "tasks"));
+  await ensureDir(path8.join(easyCodingDir, SESSIONS_DIR));
+  await ensureDir(path8.join(easyCodingDir, SPEC_DIR, MAIN_SPEC_DIR));
+  await ensureDir(path8.join(easyCodingDir, SPEC_DIR, DEV_SPEC_DIR));
+  await writeMemoryScaffold(easyCodingDir);
+  await writeTemplatesScaffold(easyCodingDir);
+  await writeToolsScaffold(cwd);
+  return projectId;
+}
+async function runtimeToolUpdates(cwd) {
+  const frozen = (await listTasks(cwd)).some(
+    ({ task }) => isActiveTask(task) && (task.unit_test_mode === "ut" || task.unit_test_mode === "tdd" || task.tdd_enabled === true)
+  );
+  const updates = [];
+  for (const file of ["easy_coding_java_coverage.py", "easy_coding_tdd_readiness.py"]) {
+    const target = path8.join(cwd, EASY_CODING_DIR, TOOLS_DIR, file);
+    const current = await readTextIfExists(target);
+    if (frozen && current !== null) continue;
+    const content = await readTextFile(getTemplatePath("runtime", "tools", file));
+    if (content !== current) updates.push({ path: target, content });
+  }
+  return updates;
+}
+async function writeToolsScaffold(cwd) {
+  const toolsDir = path8.join(cwd, EASY_CODING_DIR, TOOLS_DIR);
+  await ensureDir(toolsDir);
+  for (const update2 of await runtimeToolUpdates(cwd)) {
+    await writeTextFile(update2.path, update2.content);
+  }
+}
+async function writeTemplatesScaffold(easyCodingDir) {
+  const templatesDir = path8.join(easyCodingDir, TEMPLATES_DIR);
+  await ensureDir(templatesDir);
+  const src = getTemplatePath("runtime", "templates", "dev-spec-skeleton.md");
+  const dest = path8.join(templatesDir, "dev-spec-skeleton.md");
+  await writeTextFile(dest, await readTextFile(src));
+}
+async function writeMemoryScaffold(easyCodingDir) {
+  const memoryDir = path8.join(easyCodingDir, MEMORY_DIR);
+  await ensureDir(path8.join(memoryDir, "short"));
+  await ensureDir(path8.join(memoryDir, "long"));
+  for (const file of ["MEMORY.md", "BUSINESS.md", "TECHNICAL.md"]) {
+    const destination = path8.join(memoryDir, "long", file);
+    if (await pathExists(destination)) {
+      continue;
+    }
+    const templatePath = getTemplatePath("runtime", "memory", "long", file);
+    await writeTextFile(destination, await readTextFile(templatePath));
+  }
+  const shortTemplateDest = path8.join(memoryDir, "SHORT_MEMORY_TEMPLATE.md");
+  if (!await pathExists(shortTemplateDest)) {
+    const templatePath = getTemplatePath("runtime", "memory", "SHORT_MEMORY_TEMPLATE.md");
+    await writeTextFile(shortTemplateDest, await readTextFile(templatePath));
+  }
+}
+
 // src/commands/install-harness.ts
-import path13 from "path";
+import path14 from "path";
 
 // src/configurators/claude.ts
-import path9 from "path";
+import path10 from "path";
 
 // src/configurators/shared.ts
 import { readdir as readdir2, stat as stat2 } from "fs/promises";
-import path8 from "path";
+import path9 from "path";
 
 // src/utils/marked-region.ts
 var MarkedRegionError = class extends Error {
@@ -1327,7 +1433,7 @@ function resolvePlaceholders(content, ctx, contentName = "template") {
   return resolved;
 }
 async function withProjectInstallPaths(cwd, ctx, projectId) {
-  const resolvedProjectId = projectId ?? await readProjectIdIfExists(path8.join(cwd, EASY_CODING_DIR, CONFIG_FILE));
+  const resolvedProjectId = projectId ?? await readProjectIdIfExists(path9.join(cwd, EASY_CODING_DIR, CONFIG_FILE));
   return withInstallPaths(cwd, ctx, resolvedProjectId ?? void 0);
 }
 function withInstallPaths(cwd, ctx, projectId) {
@@ -1415,11 +1521,11 @@ async function resolveSkills(ctx) {
   const entries = await readdir2(skillsRoot);
   const skills = [];
   for (const entry of entries.sort()) {
-    const skillDir = path8.join(skillsRoot, entry);
+    const skillDir = path9.join(skillsRoot, entry);
     if (!await isDirectory(skillDir)) {
       continue;
     }
-    const content = await readTextFile(path8.join(skillDir, "SKILL.md"));
+    const content = await readTextFile(path9.join(skillDir, "SKILL.md"));
     skills.push({
       name: entry,
       content: resolvePlaceholders(content, ctx, `common/skills/${entry}/SKILL.md`)
@@ -1435,7 +1541,7 @@ async function resolveBundledSkills(ctx) {
   const entries = await readdir2(bundledRoot);
   const bundled = [];
   for (const entry of entries.sort()) {
-    const sourceDir = path8.join(bundledRoot, entry);
+    const sourceDir = path9.join(bundledRoot, entry);
     if (await isDirectory(sourceDir)) {
       bundled.push({ name: entry, sourceDir, context: ctx });
     }
@@ -1446,13 +1552,13 @@ async function writeSkills(dir, skills, bundled) {
   await ensureDir(dir);
   const written = [];
   for (const skill of skills) {
-    const destination = path8.join(dir, skill.name, "SKILL.md");
+    const destination = path9.join(dir, skill.name, "SKILL.md");
     await writeTextFile(destination, skill.content);
     written.push(destination);
   }
   for (const skill of bundled) {
     written.push(
-      ...await copyTemplateDirectory(skill.sourceDir, path8.join(dir, skill.name), skill.context)
+      ...await copyTemplateDirectory(skill.sourceDir, path9.join(dir, skill.name), skill.context)
     );
   }
   return written;
@@ -1467,7 +1573,7 @@ async function writeSharedHooks(dir, platform, opts = {}) {
     if (opts.skipSubagentContext && entry === "inject-subagent-context.py") {
       continue;
     }
-    const sourcePath = path8.join(hooksRoot, entry);
+    const sourcePath = path9.join(hooksRoot, entry);
     if ((await stat2(sourcePath)).isDirectory()) {
       continue;
     }
@@ -1476,7 +1582,7 @@ async function writeSharedHooks(dir, platform, opts = {}) {
       ctx,
       `shared-hooks/${entry}`
     );
-    const destination = path8.join(dir, entry);
+    const destination = path9.join(dir, entry);
     await writeTextFile(destination, content);
     await import("fs/promises").then(({ chmod }) => chmod(destination, 493));
     written.push(destination);
@@ -1499,7 +1605,7 @@ async function writeMainConstraint(cwd, platform, opts = {}) {
   if (!generated.includes(GENERATED_REGION_START) || !generated.includes(GENERATED_REGION_END)) {
     throw new Error(`Main constraint template ${templateName} does not contain generated markers.`);
   }
-  const destination = path8.join(cwd, meta.mainConstraint);
+  const destination = path9.join(cwd, meta.mainConstraint);
   const current = await readTextIfExists(destination);
   if (current) {
     const markerContent = extractMarkedRegion(generated);
@@ -1541,8 +1647,8 @@ async function copyTemplateDirectory(source, destination, ctx, skipDirs = /* @__
     if (skipDirs.has(entry) || shouldSkipTemplateEntry(entry)) {
       continue;
     }
-    const sourcePath = path8.join(source, entry);
-    const destinationPath = path8.join(destination, stripTemplateExtension(entry));
+    const sourcePath = path9.join(source, entry);
+    const destinationPath = path9.join(destination, stripTemplateExtension(entry));
     const sourceStat = await stat2(sourcePath);
     if (sourceStat.isDirectory()) {
       written.push(...await copyTemplateDirectory(sourcePath, destinationPath, ctx, skipDirs));
@@ -1566,28 +1672,28 @@ async function configureClaude(cwd, opts = {}) {
   const platform = "claude-code";
   const meta = PLATFORM_META[platform];
   const ctx = await withProjectInstallPaths(cwd, meta.templateContext, opts.projectId);
-  const dest = path9.join(cwd, ".claude");
-  const hookConfigPath = path9.join(cwd, meta.hookConfigFile);
+  const dest = path10.join(cwd, ".claude");
+  const hookConfigPath = path10.join(cwd, meta.hookConfigFile);
   const artifacts = [];
   const platformFiles = await copyPlatformTemplates("claude", dest, ["hooks"], ctx);
   artifacts.push(
     ...platformFiles.filter((filePath) => filePath !== hookConfigPath).map(
       (filePath) => fileArtifact(
         filePath,
-        filePath.startsWith(path9.join(cwd, meta.agentsDir)) ? "agent" : "platform-config",
+        filePath.startsWith(path10.join(cwd, meta.agentsDir)) ? "agent" : "platform-config",
         platform
       )
     )
   );
   artifacts.push(...await hookRegistrationArtifacts(hookConfigPath, platform));
   artifacts.push(
-    ...(await writeSharedHooks(path9.join(dest, "hooks"), platform)).map(
+    ...(await writeSharedHooks(path10.join(dest, "hooks"), platform)).map(
       (filePath) => fileArtifact(filePath, "hook", platform)
     )
   );
   artifacts.push(
     ...(await writeSkills(
-      path9.join(cwd, meta.skillsDir),
+      path10.join(cwd, meta.skillsDir),
       await resolveSkills(ctx),
       await resolveBundledSkills(ctx)
     )).map((filePath) => fileArtifact(filePath, "skill", platform))
@@ -1599,28 +1705,28 @@ async function configureClaude(cwd, opts = {}) {
 }
 
 // src/configurators/codex.ts
-import path10 from "path";
+import path11 from "path";
 async function configureCodex(cwd, opts = {}) {
   const platform = "codex";
   const meta = PLATFORM_META[platform];
   const ctx = await withProjectInstallPaths(cwd, meta.templateContext, opts.projectId);
-  const hookConfigPath = path10.join(cwd, meta.hookConfigFile);
+  const hookConfigPath = path11.join(cwd, meta.hookConfigFile);
   const artifacts = [];
   artifacts.push(
     ...(await writeSkills(
-      path10.join(cwd, meta.skillsDir),
+      path11.join(cwd, meta.skillsDir),
       await resolveSkills(ctx),
       await resolveBundledSkills(ctx)
     )).map((filePath) => fileArtifact(filePath, "skill", platform))
   );
   artifacts.push(
-    ...(await writeSharedHooks(path10.join(cwd, meta.hooksDir), platform, {
+    ...(await writeSharedHooks(path11.join(cwd, meta.hooksDir), platform, {
       skipSubagentContext: true
     })).map((filePath) => fileArtifact(filePath, "hook", platform))
   );
   const platformFiles = await copyPlatformTemplates(
     "codex",
-    path10.join(cwd, ".codex"),
+    path11.join(cwd, ".codex"),
     ["hooks"],
     ctx
   );
@@ -1628,7 +1734,7 @@ async function configureCodex(cwd, opts = {}) {
     ...platformFiles.filter((filePath) => filePath !== hookConfigPath).map(
       (filePath) => fileArtifact(
         filePath,
-        filePath.startsWith(path10.join(cwd, meta.agentsDir)) ? "agent" : "platform-config",
+        filePath.startsWith(path11.join(cwd, meta.agentsDir)) ? "agent" : "platform-config",
         platform
       )
     )
@@ -1642,16 +1748,16 @@ async function configureCodex(cwd, opts = {}) {
 
 // src/configurators/qoder.ts
 import { readdir as readdir3 } from "fs/promises";
-import path12 from "path";
+import path13 from "path";
 
 // src/utils/platform-paths.ts
 import { existsSync as existsSync2 } from "fs";
-import path11 from "path";
+import path12 from "path";
 function detectQoderCnVariant(cwd) {
   if (process.env.EC_QODER_VARIANT === "cn" || process.env.QODER_VARIANT === "cn") {
     return true;
   }
-  return existsSync2(path11.join(cwd, PLATFORM_META.qoder.cnVariant ?? ".qodercn"));
+  return existsSync2(path12.join(cwd, PLATFORM_META.qoder.cnVariant ?? ".qodercn"));
 }
 function resolvePlatformMeta(cwd, platform) {
   const meta = PLATFORM_META[platform];
@@ -1682,7 +1788,7 @@ function resolveQoderMetaForBaseDir(baseDir) {
 
 // src/configurators/qoder.ts
 async function claudeHarnessSkillsExist(cwd) {
-  return pathExists(path12.join(cwd, ".claude", "skills", "ec-workflow", "SKILL.md"));
+  return pathExists(path13.join(cwd, ".claude", "skills", "ec-workflow", "SKILL.md"));
 }
 async function listFilesRecursive(dir) {
   let entries;
@@ -1696,7 +1802,7 @@ async function listFilesRecursive(dir) {
   }
   const files = [];
   for (const entry of entries.sort((a, b) => a.name.localeCompare(b.name))) {
-    const entryPath = path12.join(dir, entry.name);
+    const entryPath = path13.join(dir, entry.name);
     if (entry.isDirectory()) {
       files.push(...await listFilesRecursive(entryPath));
       continue;
@@ -1710,7 +1816,7 @@ async function listFilesRecursive(dir) {
 async function existingManagedSkillArtifacts(skillsDir, skillNames, platform) {
   const artifacts = [];
   for (const skillName of skillNames) {
-    for (const filePath of await listFilesRecursive(path12.join(skillsDir, skillName))) {
+    for (const filePath of await listFilesRecursive(path13.join(skillsDir, skillName))) {
       artifacts.push(fileArtifact(filePath, "skill", platform));
     }
   }
@@ -1720,22 +1826,22 @@ async function configureQoder(cwd, opts = {}) {
   const platform = "qoder";
   const meta = resolvePlatformMeta(cwd, platform);
   const ctx = await withProjectInstallPaths(cwd, meta.templateContext, opts.projectId);
-  const dest = path12.join(cwd, ctx.platform_config_dir);
-  const hookConfigPath = path12.join(cwd, meta.hookConfigFile);
+  const dest = path13.join(cwd, ctx.platform_config_dir);
+  const hookConfigPath = path13.join(cwd, meta.hookConfigFile);
   const artifacts = [];
   const platformFiles = await copyPlatformTemplates("qoder", dest, ["hooks"], ctx);
   artifacts.push(
     ...platformFiles.filter((filePath) => filePath !== hookConfigPath).map(
       (filePath) => fileArtifact(
         filePath,
-        filePath.startsWith(path12.join(cwd, meta.agentsDir)) ? "agent" : "platform-config",
+        filePath.startsWith(path13.join(cwd, meta.agentsDir)) ? "agent" : "platform-config",
         platform
       )
     )
   );
   artifacts.push(...await hookRegistrationArtifacts(hookConfigPath, platform));
   artifacts.push(
-    ...(await writeSharedHooks(path12.join(dest, "hooks"), platform)).map(
+    ...(await writeSharedHooks(path13.join(dest, "hooks"), platform)).map(
       (filePath) => fileArtifact(filePath, "hook", platform)
     )
   );
@@ -1743,14 +1849,14 @@ async function configureQoder(cwd, opts = {}) {
   const bundledSkills = await resolveBundledSkills(ctx);
   if (!await claudeHarnessSkillsExist(cwd)) {
     artifacts.push(
-      ...(await writeSkills(path12.join(dest, "skills"), skills, bundledSkills)).map(
+      ...(await writeSkills(path13.join(dest, "skills"), skills, bundledSkills)).map(
         (filePath) => fileArtifact(filePath, "skill", platform)
       )
     );
   } else {
     artifacts.push(
       ...await existingManagedSkillArtifacts(
-        path12.join(dest, "skills"),
+        path13.join(dest, "skills"),
         [...skills.map((skill) => skill.name), ...bundledSkills.map((skill) => skill.name)],
         platform
       )
@@ -1821,7 +1927,7 @@ async function refreshSupermoduleParent(targetDir, platforms, submodulePaths) {
     role: "super-parent",
     submodules: submodulePaths
   };
-  await updateSupermoduleConfig(path13.join(targetDir, EASY_CODING_DIR, CONFIG_FILE), supermodule);
+  await updateSupermoduleConfig(path14.join(targetDir, EASY_CODING_DIR, CONFIG_FILE), supermodule);
   for (const platform of platforms) {
     await writeMainConstraint(targetDir, platform, {
       supermodule: { submodulePaths }
@@ -1943,14 +2049,14 @@ async function resolveSubmodules(opts, available, defaultSelection = available)
 }
 
 // src/commands/supermodule-targets.ts
-import path15 from "path";
+import path16 from "path";
 import { cancel as cancel2, multiselect as multiselect2 } from "@clack/prompts";
 
 // src/utils/gitmodules.ts
 import { lstat, realpath } from "fs/promises";
-import path14 from "path";
+import path15 from "path";
 async function parseGitmodules(rootDir) {
-  const content = await readTextIfExists(path14.join(rootDir, ".gitmodules"));
+  const content = await readTextIfExists(path15.join(rootDir, ".gitmodules"));
   if (content === null) {
     return [];
   }
@@ -2009,7 +2115,7 @@ async function listInstallableSubmodules(rootDir) {
 function normalizeSubmodulePath(value) {
   const normalized = value.replace(/\\/g, "/").replace(/^\.\/+/, "").trim();
   const parts = normalized.split("/").filter(Boolean);
-  if (normalized === "" || path14.posix.isAbsolute(normalized) || path14.win32.isAbsolute(value) || parts.some((part) => part === "..")) {
+  if (normalized === "" || path15.posix.isAbsolute(normalized) || path15.win32.isAbsolute(value) || parts.some((part) => part === "..")) {
     throw new Error(`Unsafe submodule path in .gitmodules: ${value}`);
   }
   return parts.join("/");
@@ -2047,7 +2153,7 @@ function isCommentStart(value, index) {
   return index === 0 || /\s/.test(value[index - 1]);
 }
 async function isSubmoduleWorktree(rootDir, submodulePath) {
-  const dir = path14.join(rootDir, submodulePath);
+  const dir = path15.join(rootDir, submodulePath);
   try {
     if (!await pathHasNoSymlinkSegments(rootDir, submodulePath)) {
       return false;
@@ -2061,7 +2167,7 @@ async function isSubmoduleWorktree(rootDir, submodulePath) {
     if (!dirStat.isDirectory()) {
       return false;
     }
-    const gitMarkerStat = await lstat(path14.join(dir, ".git"));
+    const gitMarkerStat = await lstat(path15.join(dir, ".git"));
     return !gitMarkerStat.isSymbolicLink() && (gitMarkerStat.isFile() || gitMarkerStat.isDirectory());
   } catch (error) {
     if (error.code === "ENOENT") {
@@ -2073,7 +2179,7 @@ async function isSubmoduleWorktree(rootDir, submodulePath) {
 async function pathHasNoSymlinkSegments(rootDir, submodulePath) {
   let current = rootDir;
   for (const part of submodulePath.split("/")) {
-    current = path14.join(current, part);
+    current = path15.join(current, part);
     const partStat = await lstat(current);
     if (partStat.isSymbolicLink()) {
       return false;
@@ -2082,8 +2188,8 @@ async function pathHasNoSymlinkSegments(rootDir, submodulePath) {
   return true;
 }
 function isInsideDirectory(parent, child) {
-  const relative = path14.relative(parent, child);
-  return Boolean(relative) && !relative.startsWith("..") && !path14.isAbsolute(relative);
+  const relative = path15.relative(parent, child);
+  return Boolean(relative) && !relative.startsWith("..") && !path15.isAbsolute(relative);
 }
 
 // src/commands/supermodule-targets.ts
@@ -2135,7 +2241,7 @@ async function resolveClearTargets(cwd, opts) {
     return [standaloneTarget(cwd)];
   }
   const installedSubmodules = await listInstalledSubmodules(cwd);
-  const parent = await pathExists(path15.join(cwd, EASY_CODING_DIR)) ? parentTarget(cwd, installedSubmodules) : null;
+  const parent = await pathExists(path16.join(cwd, EASY_CODING_DIR)) ? parentTarget(cwd, installedSubmodules) : null;
   const children = installedSubmodules.map((entry) => childTarget(cwd, entry));
   if (opts.submodules === false) {
     return parent ? [parent] : [];
@@ -2175,7 +2281,7 @@ async function listInstalledSubmodules(cwd) {
   const entries = await listInstallableSubmodules(cwd);
   const installed = [];
   for (const entry of entries) {
-    if (await pathExists(configPath(path15.join(cwd, entry.path)))) {
+    if (await pathExists(configPath(path16.join(cwd, entry.path)))) {
       installed.push(entry);
     }
   }
@@ -2218,7 +2324,7 @@ function parentTargetFromPaths(cwd, submodulePaths) {
   };
 }
 function childTarget(cwd, entry) {
-  const dir = path15.join(cwd, entry.path);
+  const dir = path16.join(cwd, entry.path);
   return {
     dir,
     label: entry.path,
@@ -2254,11 +2360,11 @@ function parseSubmoduleSelection(submoduleList, available) {
   return selected.sort((a, b) => a.path.localeCompare(b.path));
 }
 function configPath(cwd) {
-  return path15.join(cwd, EASY_CODING_DIR, CONFIG_FILE);
+  return path16.join(cwd, EASY_CODING_DIR, CONFIG_FILE);
 }
 function toPosixRelative(from, to) {
-  const relative = path15.relative(from, to);
-  return relative ? relative.split(path15.sep).join("/") : ".";
+  const relative = path16.relative(from, to);
+  return relative ? relative.split(path16.sep).join("/") : ".";
 }
 
 // src/commands/add-agent.ts
@@ -2334,7 +2440,7 @@ ${installedLabels.join("\n")}`));
 
 // src/commands/clear.ts
 import { readdir as readdir4, rm, writeFile } from "fs/promises";
-import path16 from "path";
+import path17 from "path";
 import { cancel as cancel3, confirm as confirm2, outro as outro2 } from "@clack/prompts";
 import chalk3 from "chalk";
 var PLATFORM_TEMPLATE_DIR = {
@@ -2373,7 +2479,7 @@ async function clear(opts) {
 async function buildTargetClearPlans(targets) {
   const plans = [];
   for (const target of targets) {
-    const easyCodingDir = path16.join(target.dir, EASY_CODING_DIR);
+    const easyCodingDir = path17.join(target.dir, EASY_CODING_DIR);
     if (!await pathExists(easyCodingDir)) {
       continue;
     }
@@ -2390,7 +2496,7 @@ async function refreshParentAfterChildClear(cwd, targetPlans) {
   if (targetPlans.some((targetPlan) => targetPlan.target.label === ".")) {
     return;
   }
-  if (!await pathExists(path16.join(cwd, EASY_CODING_DIR, CONFIG_FILE))) {
+  if (!await pathExists(path17.join(cwd, EASY_CODING_DIR, CONFIG_FILE))) {
     return;
   }
   const [parent] = await resolveUpgradeTargets(cwd);
@@ -2404,7 +2510,7 @@ async function refreshParentAfterChildClear(cwd, targetPlans) {
   await refreshSupermoduleParent(cwd, config2.agents, parent.supermodule.submodules ?? []);
 }
 async function resolveInstalledAgents(cwd) {
-  const configPath2 = path16.join(cwd, EASY_CODING_DIR, CONFIG_FILE);
+  const configPath2 = path17.join(cwd, EASY_CODING_DIR, CONFIG_FILE);
   if (await pathExists(configPath2)) {
     try {
       const config2 = await readConfigYaml(configPath2);
@@ -2435,7 +2541,7 @@ async function hasPlatformInstall(cwd, platform) {
 async function hasInstallMarkers(cwd, meta) {
   const markers = [meta.skillsDir, meta.hooksDir, meta.agentsDir, meta.hookConfigFile];
   for (const marker of markers) {
-    if (await pathExists(path16.join(cwd, marker))) {
+    if (await pathExists(path17.join(cwd, marker))) {
       return true;
     }
   }
@@ -2491,7 +2597,7 @@ async function buildManifestClearPlan(cwd, agents, manifest) {
     }
     if (await manifestFileMatches(filePath, file.sha256)) {
       plan.removeFiles.push({ filePath, expectedSha256: file.sha256 });
-      addEmptyDirChain(plan.emptyDirs, path16.dirname(filePath), cwd);
+      addEmptyDirChain(plan.emptyDirs, path17.dirname(filePath), cwd);
     } else {
       plan.skippedModified.push(filePath);
     }
@@ -2541,28 +2647,28 @@ async function addTemplateClearEntries(plan, cwd, platform, metas, managedSkills
   );
   for (const meta of metas) {
     for (const name of managedSkills) {
-      plan.remove.add(path16.join(cwd, meta.skillsDir, name));
+      plan.remove.add(path17.join(cwd, meta.skillsDir, name));
     }
     for (const name of hookFileNames) {
-      plan.remove.add(path16.join(cwd, meta.hooksDir, name));
+      plan.remove.add(path17.join(cwd, meta.hooksDir, name));
     }
     for (const name of agentFileNames) {
-      plan.remove.add(path16.join(cwd, meta.agentsDir, name));
+      plan.remove.add(path17.join(cwd, meta.agentsDir, name));
     }
     addHookConfigPrune(
       plan.pruneHookConfigs,
       plan.pruneHookCommands,
-      path16.join(cwd, meta.hookConfigFile),
+      path17.join(cwd, meta.hookConfigFile),
       managedHookPathsForTemplate(cwd, meta, hookFileNames),
       []
     );
-    plan.constraints.add(path16.join(cwd, meta.mainConstraint));
+    plan.constraints.add(path17.join(cwd, meta.mainConstraint));
     if (platform === "codex") {
-      plan.remove.add(path16.join(cwd, meta.templateContext.platform_config_dir, "config.toml"));
+      plan.remove.add(path17.join(cwd, meta.templateContext.platform_config_dir, "config.toml"));
     }
-    plan.emptyDirs.add(path16.join(cwd, meta.skillsDir));
-    plan.emptyDirs.add(path16.join(cwd, meta.hooksDir));
-    plan.emptyDirs.add(path16.join(cwd, meta.agentsDir));
+    plan.emptyDirs.add(path17.join(cwd, meta.skillsDir));
+    plan.emptyDirs.add(path17.join(cwd, meta.hooksDir));
+    plan.emptyDirs.add(path17.join(cwd, meta.agentsDir));
   }
 }
 async function resolveManifestUncoveredQoderMetas(cwd, manifest) {
@@ -2609,7 +2715,7 @@ function managedHookPathsForRegistration(cwd, hookPath) {
   try {
     paths.push(...managedHookPathTokens(manifestPath(cwd, hookPath)));
   } catch {
-    if (path16.isAbsolute(hookPath)) {
+    if (path17.isAbsolute(hookPath)) {
       paths.push(...managedHookPathTokens(hookPath));
     }
   }
@@ -2620,7 +2726,7 @@ function managedHookPathsForTemplate(cwd, meta, hookFileNames) {
     (name) => `${meta.templateContext.platform_config_dir}/hooks/${name}`
   );
   const absolutePaths = hookFileNames.flatMap(
-    (name) => managedHookPathTokens(path16.join(cwd, meta.hooksDir, name))
+    (name) => managedHookPathTokens(path17.join(cwd, meta.hooksDir, name))
   );
   return [...relativePaths, ...absolutePaths];
 }
@@ -2628,8 +2734,8 @@ function managedHookPathTokens(filePath) {
   const tokens = /* @__PURE__ */ new Set();
   for (const equivalentPath of equivalentAbsolutePaths(filePath)) {
     const normalized = equivalentPath.replace(/\\/g, "/");
-    const dir = path16.posix.dirname(normalized);
-    const basename = path16.posix.basename(normalized);
+    const dir = path17.posix.dirname(normalized);
+    const basename = path17.posix.basename(normalized);
     tokens.add(normalized);
     tokens.add(shellDoubleQuoteArg2(normalized));
     tokens.add(`${shellDoubleQuoteArg2(dir)}/${basename}`);
@@ -2637,7 +2743,7 @@ function managedHookPathTokens(filePath) {
   return [...tokens];
 }
 function equivalentAbsolutePaths(filePath) {
-  const normalized = path16.resolve(filePath).replace(/\\/g, "/");
+  const normalized = path17.resolve(filePath).replace(/\\/g, "/");
   const equivalents = [normalized];
   if (normalized.startsWith("/private/var/")) {
     equivalents.push(normalized.replace(/^\/private\/var\//, "/var/"));
@@ -2711,11 +2817,11 @@ function addRuntimeClearEntries(plan, cwd) {
   plan.remove = [
     .../* @__PURE__ */ new Set([
       ...plan.remove,
-      path16.join(cwd, EASY_CODING_DIR, CONFIG_FILE),
-      path16.join(cwd, EASY_CODING_DIR, SESSIONS_DIR),
-      path16.join(cwd, EASY_CODING_DIR, TEMPLATES_DIR),
-      path16.join(cwd, EASY_CODING_DIR, TOOLS_DIR),
-      path16.join(cwd, EASY_CODING_DIR, INSTALL_MANIFEST_FILE)
+      path17.join(cwd, EASY_CODING_DIR, CONFIG_FILE),
+      path17.join(cwd, EASY_CODING_DIR, SESSIONS_DIR),
+      path17.join(cwd, EASY_CODING_DIR, TEMPLATES_DIR),
+      path17.join(cwd, EASY_CODING_DIR, TOOLS_DIR),
+      path17.join(cwd, EASY_CODING_DIR, INSTALL_MANIFEST_FILE)
     ])
   ];
 }
@@ -2723,7 +2829,7 @@ function addEmptyDirChain(emptyDirs, startDir, cwd) {
   let current = startDir;
   while (current !== cwd && isInsideDirectory2(cwd, current)) {
     emptyDirs.add(current);
-    const parent = path16.dirname(current);
+    const parent = path17.dirname(current);
     if (parent === current) {
       break;
     }
@@ -2731,8 +2837,8 @@ function addEmptyDirChain(emptyDirs, startDir, cwd) {
   }
 }
 function isInsideDirectory2(parent, child) {
-  const relative = path16.relative(parent, child);
-  return Boolean(relative) && !relative.startsWith("..") && !path16.isAbsolute(relative);
+  const relative = path17.relative(parent, child);
+  return Boolean(relative) && !relative.startsWith("..") && !path17.isAbsolute(relative);
 }
 async function listSharedHookNamesForPlatform(platform) {
   const names = await listFileNames(getTemplatePath("shared-hooks"));
@@ -2869,7 +2975,7 @@ function sortDirsDeepestFirst(dirs) {
   });
 }
 function pathDepth(dir) {
-  return path16.normalize(dir).split(path16.sep).filter(Boolean).length;
+  return path17.normalize(dir).split(path17.sep).filter(Boolean).length;
 }
 async function listDirNames(dir) {
   try {
@@ -2888,7 +2994,7 @@ async function listFileNames(dir) {
   }
 }
 function renderPlan(cwd, agents, plan) {
-  const rel = (target) => path16.relative(cwd, target) || target;
+  const rel = (target) => path17.relative(cwd, target) || target;
   const lines = [];
   lines.push(chalk3.bold("easy-coding clear"));
   lines.push(`Platforms: ${agents.length > 0 ? agents.join(", ") : "(none detected)"}`);
@@ -2937,12 +3043,12 @@ function renderTargetPlans(targetPlans) {
 }
 
 // src/commands/config.ts
-import path19 from "path";
+import path20 from "path";
 import { cancel as cancel4, confirm as confirm3, outro as outro3, select, text } from "@clack/prompts";
 import chalk4 from "chalk";
 
 // src/utils/compare-versions.ts
-import path17 from "path";
+import path18 from "path";
 function parseVersion(version) {
   const withoutBuild = String(version ?? "").split("+", 1)[0];
   const separator = withoutBuild.indexOf("-");
@@ -2997,7 +3103,7 @@ function isVersionBehind(installed, current = VERSION) {
   return compareVersions(installed, current) === -1;
 }
 async function checkForUpgrade(cwd) {
-  const configPath2 = path17.join(cwd, EASY_CODING_DIR, CONFIG_FILE);
+  const configPath2 = path18.join(cwd, EASY_CODING_DIR, CONFIG_FILE);
   if (!await pathExists(configPath2)) {
     return;
   }
@@ -3018,7 +3124,7 @@ async function checkForUpgrade(cwd) {
 
 // src/utils/tdd-readiness.ts
 import { readFile as readFile4, realpath as realpath2 } from "fs/promises";
-import path18 from "path";
+import path19 from "path";
 var TDD_READINESS_SCHEMA = "easy-coding/tdd-readiness-v1";
 var TDD_READINESS_SCOPE = "changed-production-lines";
 var TDD_BASE_VARIABLE = "EASY_CODING_TDD_BASE_SHA";
@@ -3026,7 +3132,7 @@ var TDD_THRESHOLD_VARIABLE = "EASY_CODING_TDD_THRESHOLD";
 var COVERAGE_TOOL_PATH = ".easy-coding/tools/easy_coding_java_coverage.py";
 var JAVA_BUILD_FILE_NAMES = /* @__PURE__ */ new Set(["pom.xml", "build.gradle", "build.gradle.kts"]);
 function readinessPath(root) {
-  return path18.join(root, EASY_CODING_DIR, TDD_DIR, TDD_READINESS_FILE);
+  return path19.join(root, EASY_CODING_DIR, TDD_DIR, TDD_READINESS_FILE);
 }
 function parseFileRecords(value, field, reasons) {
   if (!Array.isArray(value) || value.length === 0) {
@@ -3040,7 +3146,7 @@ function parseFileRecords(value, field, reasons) {
       continue;
     }
     const record = item;
-    if (typeof record.path !== "string" || !record.path.trim() || path18.isAbsolute(record.path)) {
+    if (typeof record.path !== "string" || !record.path.trim() || path19.isAbsolute(record.path)) {
       reasons.push(`${field} contains an invalid path`);
       continue;
     }
@@ -3054,15 +3160,15 @@ function usesRequiredGateVariables(command) {
 }
 function isSafeReportPattern(value) {
   const normalized = value.replaceAll("\\", "/");
-  return !path18.isAbsolute(value) && !normalized.split("/").includes("..");
+  return !path19.isAbsolute(value) && !normalized.split("/").includes("..");
 }
 async function validateFiles(root, records, reasons) {
   const resolvedRoot = await realpath2(root);
   for (const record of records) {
-    const absolute = path18.resolve(root, record.path);
+    const absolute = path19.resolve(root, record.path);
     try {
       const resolved = await realpath2(absolute);
-      if (resolved !== resolvedRoot && !resolved.startsWith(`${resolvedRoot}${path18.sep}`)) {
+      if (resolved !== resolvedRoot && !resolved.startsWith(`${resolvedRoot}${path19.sep}`)) {
         reasons.push(`readiness file escapes project root: ${record.path}`);
         continue;
       }
@@ -3111,7 +3217,7 @@ async function inspectTddReadiness(root) {
   }
   const buildFiles = parseFileRecords(manifest.build_files, "build_files", reasons);
   const toolFiles = parseFileRecords(manifest.tool_files, "tool_files", reasons);
-  if (!buildFiles.some((record) => JAVA_BUILD_FILE_NAMES.has(path18.basename(record.path)))) {
+  if (!buildFiles.some((record) => JAVA_BUILD_FILE_NAMES.has(path19.basename(record.path)))) {
     reasons.push("build_files must include a Maven or Gradle Java build file");
   }
   if (!toolFiles.some((record) => record.path.replaceAll("\\", "/") === COVERAGE_TOOL_PATH)) {
@@ -3127,9 +3233,17 @@ async function inspectTddReadiness(root) {
 }
 
 // src/commands/config.ts
-async function config() {
+async function config(options = {}) {
   renderBanner();
-  const configPath2 = path19.join(process.cwd(), EASY_CODING_DIR, CONFIG_FILE);
+  const scope = options.scope ?? "project";
+  if (scope !== "project" && scope !== "local")
+    throw new Error("Config scope must be project or local.");
+  const explicit = options.approvalMode !== void 0 || options.cooperateMode !== void 0 || options.unitTestMode !== void 0 || options.utCoverageThreshold !== void 0 || options.reset !== void 0;
+  if (scope === "local") {
+    await configureOverrides(localConfigPath(), scope, options, explicit);
+    return;
+  }
+  const configPath2 = path20.join(process.cwd(), EASY_CODING_DIR, CONFIG_FILE);
   if (!await pathExists(configPath2)) {
     throw new Error("No easy-coding harness found in this project.");
   }
@@ -3150,6 +3264,10 @@ async function config() {
       `Project harness ${projectConfig.harness_version} does not exactly match CLI ${VERSION}. Upgrade the harness or update the CLI before changing config.`
     );
   }
+  if (explicit) {
+    await configureOverrides(configPath2, scope, options, true);
+    return;
+  }
   const current = resolveLegacyBehavior(projectConfig);
   const approvalMode = await select({
     message: `Select project approval mode (current: ${current.approvalMode})`,
@@ -3182,83 +3300,186 @@ async function config() {
     return;
   }
   const workflowMode = "adaptive";
-  const tddEnabled = await select({
-    message: `Enable Java TDD for this project (current: ${current.tddEnabled ? "enabled" : "disabled"})`,
-    initialValue: current.tddEnabled,
+  const unitTestMode = await select({
+    message: `Select Java unit test strategy (current: ${current.unitTestMode})`,
+    initialValue: current.unitTestMode,
     options: [
-      { value: false, label: "disabled \u2014 preserve current test depth (default)" },
-      { value: true, label: "enabled \u2014 require TDD evidence and changed-line coverage" }
+      { value: "none", label: "none \u2014 preserve task-required verification (default)" },
+      { value: "ut", label: "UT \u2014 passing unit tests and changed-line coverage" },
+      { value: "tdd", label: "TDD \u2014 test-first development and changed-line coverage" }
     ]
   });
-  if (typeof tddEnabled === "symbol") {
+  if (typeof unitTestMode === "symbol") {
     cancel4("Configuration cancelled.");
     return;
   }
-  if (tddEnabled) {
+  if (unitTestMode !== "none") {
     const readiness = await inspectTddReadiness(process.cwd());
     if (readiness.status !== "ready") {
       cancel4(
-        `TDD was not enabled. ${readiness.status === "needs_init" ? "Run ec-tdd-init first" : "Repair TDD readiness"}: ${readiness.reasons.join("; ")}. No project modes were changed.`
+        `Unit test strategy was not enabled. ${readiness.status === "needs_init" ? "Run ec-tdd-init first" : "Repair coverage readiness"}: ${readiness.reasons.join("; ")}. No project modes were changed.`
       );
       return;
     }
   }
-  let tddCoverageThreshold = current.tddCoverageThreshold;
-  if (tddEnabled) {
+  let utCoverageThreshold = current.utCoverageThreshold;
+  if (unitTestMode !== "none") {
     const thresholdInput = await text({
       message: "Minimum changed-production-line coverage percentage",
-      initialValue: String(current.tddCoverageThreshold),
+      initialValue: String(current.utCoverageThreshold),
       validate(value) {
         const parsed = Number(value);
-        return isTddCoverageThreshold(parsed) ? void 0 : "Enter an integer from 1 to 100.";
+        return isUtCoverageThreshold(parsed) ? void 0 : "Enter an integer from 1 to 100.";
       }
     });
     if (typeof thresholdInput === "symbol") {
       cancel4("Configuration cancelled.");
       return;
     }
-    tddCoverageThreshold = Number(thresholdInput);
+    utCoverageThreshold = Number(thresholdInput);
+  }
+  const cooperateMode = await select({
+    message: `Select project cooperation (current: ${projectConfig.behavior.cooperate_mode ?? "default"})`,
+    initialValue: projectConfig.behavior.cooperate_mode ?? "default",
+    options: [
+      { value: "default", label: "default \u2014 hand off at stage boundaries" },
+      {
+        value: "dispatch",
+        label: "dispatch \u2014 manually hand off implementation and QUALITY repairs"
+      }
+    ]
+  });
+  if (typeof cooperateMode === "symbol") {
+    cancel4("Configuration cancelled.");
+    return;
   }
   const shouldSave = await confirm3({
-    message: `Set approval=${approvalMode}, workflow=${workflowMode}, TDD=${tddEnabled ? `enabled (${tddCoverageThreshold}%)` : "disabled"}?`,
+    message: `Set approval=${approvalMode}, cooperate=${cooperateMode}, unit-test=${unitTestMode}${unitTestMode === "none" ? "" : ` (${utCoverageThreshold}%)`}?`,
     initialValue: true
   });
   if (typeof shouldSave === "symbol" || !shouldSave) {
     cancel4("Configuration cancelled.");
     return;
   }
-  if (tddEnabled) {
+  if (unitTestMode !== "none") {
     const readiness = await inspectTddReadiness(process.cwd());
     if (readiness.status !== "ready") {
       cancel4(
-        `TDD was not enabled because readiness changed before save: ${readiness.reasons.join("; ")}. No project modes were changed.`
+        `Unit test strategy was not enabled because readiness changed before save: ${readiness.reasons.join("; ")}. No project modes were changed.`
       );
       return;
     }
   }
-  await setBehaviorModes(configPath2, approvalMode, workflowMode, tddEnabled, tddCoverageThreshold);
+  await setBehaviorModes(
+    configPath2,
+    approvalMode,
+    workflowMode,
+    unitTestMode,
+    utCoverageThreshold,
+    cooperateMode
+  );
   outro3(
     chalk4.green(
-      `Project modes updated: approval=${approvalMode}, workflow=${workflowMode}, TDD=${tddEnabled ? `${tddCoverageThreshold}%` : "off"}.`
+      `Project modes updated: approval=${approvalMode}, workflow=${workflowMode}, unit-test=${unitTestMode}${unitTestMode === "none" ? "" : ` (${utCoverageThreshold}%)`}.`
     )
   );
 }
+async function configureOverrides(filePath, scope, options, explicit) {
+  const changes = {};
+  const flags = {
+    approval_mode: options.approvalMode,
+    cooperate_mode: options.cooperateMode,
+    unit_test_mode: options.unitTestMode,
+    ut_coverage_threshold: options.utCoverageThreshold
+  };
+  for (const key of BEHAVIOR_KEYS) {
+    if (flags[key] !== void 0)
+      changes[key] = key === "ut_coverage_threshold" ? Number(flags[key]) : flags[key];
+  }
+  if (options.reset) {
+    if (!BEHAVIOR_KEYS.includes(options.reset))
+      throw new Error("Unknown behavior field to reset.");
+    changes[options.reset] = null;
+  }
+  if (!explicit) {
+    const local = await readLocalBehavior();
+    const key = await select({
+      message: "Select local override to edit",
+      options: BEHAVIOR_KEYS.map((value) => ({
+        value,
+        label: `${value}: ${local[value] ?? "inherit project"}`
+      }))
+    });
+    if (typeof key === "symbol") {
+      cancel4("Configuration cancelled.");
+      return;
+    }
+    if (key === "ut_coverage_threshold") {
+      const value = await text({
+        message: "Coverage threshold 1..100, or inherit",
+        initialValue: String(local[key] ?? "inherit"),
+        validate: (value2) => value2 === "inherit" || isUtCoverageThreshold(Number(value2)) ? void 0 : "Enter 1..100 or inherit."
+      });
+      if (typeof value === "symbol") {
+        cancel4("Configuration cancelled.");
+        return;
+      }
+      changes[key] = value === "inherit" ? null : Number(value);
+    } else {
+      const values = key === "approval_mode" ? APPROVAL_MODES : key === "cooperate_mode" ? COOPERATE_MODES : UNIT_TEST_MODES;
+      const value = await select({
+        message: `Set local ${key}`,
+        initialValue: local[key] ?? "inherit",
+        options: [
+          { value: "inherit", label: "inherit \u2014 use project setting" },
+          ...values.map((value2) => ({ value: value2, label: value2 }))
+        ]
+      });
+      if (typeof value === "symbol") {
+        cancel4("Configuration cancelled.");
+        return;
+      }
+      changes[key] = value === "inherit" ? null : value;
+    }
+  }
+  for (const key of BEHAVIOR_KEYS) {
+    if (changes[key] !== void 0 && changes[key] !== null)
+      validateBehaviorValue(key, changes[key]);
+  }
+  if (!options.yes) {
+    const accepted = await confirm3({
+      message: `Save ${scope} overrides ${JSON.stringify(changes)}?`,
+      initialValue: true
+    });
+    if (accepted !== true) {
+      cancel4("Configuration cancelled.");
+      return;
+    }
+  }
+  if (scope === "project" && changes.unit_test_mode && changes.unit_test_mode !== "none") {
+    const readiness = await inspectTddReadiness(process.cwd());
+    if (readiness.status !== "ready")
+      throw new Error(`Unit test readiness: ${readiness.status}. ${readiness.reasons.join("; ")}`);
+  }
+  await writeBehaviorOverrides(filePath, changes);
+  outro3(chalk4.green(`${scope} behavior overrides saved: ${filePath}`));
+}
 
 // src/commands/init.ts
-import path21 from "path";
+import path22 from "path";
 import { note, outro as outro4 } from "@clack/prompts";
 import chalk5 from "chalk";
 
 // src/utils/install-state.ts
 import { readdir as readdir5 } from "fs/promises";
-import path20 from "path";
+import path21 from "path";
 var LEGACY_ROOT_FILES = ["SOUL.md", "RULES.md", "ABSTRACT.md"];
 async function detectEasyCodingInstallState(cwd) {
-  const easyCodingDir = path20.join(cwd, EASY_CODING_DIR);
+  const easyCodingDir = path21.join(cwd, EASY_CODING_DIR);
   if (!await pathExists(easyCodingDir)) {
     return { kind: "fresh", easyCodingDir };
   }
-  const configPath2 = path20.join(easyCodingDir, CONFIG_FILE);
+  const configPath2 = path21.join(easyCodingDir, CONFIG_FILE);
   if (await pathExists(configPath2)) {
     return { kind: "installed", easyCodingDir, configPath: configPath2 };
   }
@@ -3276,17 +3497,17 @@ async function detectEasyCodingInstallState(cwd) {
 async function detectLegacyAssets(easyCodingDir) {
   const assets = [];
   for (const file of LEGACY_ROOT_FILES) {
-    if (await pathExists(path20.join(easyCodingDir, file))) {
+    if (await pathExists(path21.join(easyCodingDir, file))) {
       assets.push(relativeEasyCodingPath(file));
     }
   }
-  if (await pathExists(path20.join(easyCodingDir, "memory", "long", "MEMORY.md"))) {
+  if (await pathExists(path21.join(easyCodingDir, "memory", "long", "MEMORY.md"))) {
     assets.push(relativeEasyCodingPath("memory", "long", "MEMORY.md"));
   }
-  const shortMemoryFiles = await listMarkdownFiles(path20.join(easyCodingDir, "memory", "short"));
+  const shortMemoryFiles = await listMarkdownFiles(path21.join(easyCodingDir, "memory", "short"));
   assets.push(...shortMemoryFiles.map((file) => relativeEasyCodingPath("memory", "short", file)));
   for (const dir of ["spec", "prototype"]) {
-    if (await hasAnyDirectoryEntry(path20.join(easyCodingDir, dir))) {
+    if (await hasAnyDirectoryEntry(path21.join(easyCodingDir, dir))) {
       assets.push(relativeEasyCodingPath(dir));
     }
   }
@@ -3306,13 +3527,13 @@ async function hasAnyDirectoryEntry(dir) {
   return (await readdir5(dir)).length > 0;
 }
 function relativeEasyCodingPath(...segments) {
-  return path20.posix.join(EASY_CODING_DIR, ...segments);
+  return path21.posix.join(EASY_CODING_DIR, ...segments);
 }
 function relativeConfigPath() {
-  return path20.posix.join(EASY_CODING_DIR, CONFIG_FILE);
+  return path21.posix.join(EASY_CODING_DIR, CONFIG_FILE);
 }
 function relativeProjectInitTaskPath() {
-  return path20.posix.join(EASY_CODING_DIR, TASKS_DIR, PROJECT_INIT_TASK_ID, "task.json");
+  return path21.posix.join(EASY_CODING_DIR, TASKS_DIR, PROJECT_INIT_TASK_ID, "task.json");
 }
 
 // src/commands/init.ts
@@ -3393,7 +3614,7 @@ async function supermoduleTargets(cwd, opts, submodules) {
     if (!targetSubmodulePaths.has(entry.path)) {
       continue;
     }
-    const dir = path21.join(cwd, entry.path);
+    const dir = path22.join(cwd, entry.path);
     targets.push(
       await targetFromState(dir, entry.path, "submodule-child", {
         parent: toPosixRelative2(dir, cwd)
@@ -3440,24 +3661,24 @@ function contextFromState(role, installState) {
   };
 }
 function toPosixRelative2(from, to) {
-  const relative = path21.relative(from, to);
-  return relative ? relative.split(path21.sep).join("/") : ".";
+  const relative = path22.relative(from, to);
+  return relative ? relative.split(path22.sep).join("/") : ".";
 }
 async function resolveInitPlatforms(cwd, opts, parentInstalled) {
   if (opts.agent || !parentInstalled) {
     return resolvePlatforms(opts, ["claude-code"]);
   }
-  const config2 = await readConfigYaml(path21.join(cwd, EASY_CODING_DIR, CONFIG_FILE));
+  const config2 = await readConfigYaml(path22.join(cwd, EASY_CODING_DIR, CONFIG_FILE));
   if (Array.isArray(config2.agents) && config2.agents.length > 0) {
     return config2.agents;
   }
   return resolvePlatforms(opts, ["claude-code"]);
 }
 async function refreshParentTopologyIfNeeded(cwd, parentTarget2, installPlatforms) {
-  if (!await pathExists(path21.join(cwd, EASY_CODING_DIR, CONFIG_FILE))) {
+  if (!await pathExists(path22.join(cwd, EASY_CODING_DIR, CONFIG_FILE))) {
     return;
   }
-  const config2 = parentTarget2.installed ? await readConfigYaml(path21.join(cwd, EASY_CODING_DIR, CONFIG_FILE)) : { agents: installPlatforms };
+  const config2 = parentTarget2.installed ? await readConfigYaml(path22.join(cwd, EASY_CODING_DIR, CONFIG_FILE)) : { agents: installPlatforms };
   const platforms = Array.isArray(config2.agents) && config2.agents.length > 0 ? config2.agents : installPlatforms;
   await refreshSupermoduleParent(cwd, platforms, parentTarget2.context.submodulePaths ?? []);
 }
@@ -3466,7 +3687,7 @@ async function refreshInstalledChildTopologies(targets) {
     if (!target.installed || target.context.role !== "submodule-child") {
       continue;
     }
-    const configPath2 = path21.join(target.dir, EASY_CODING_DIR, CONFIG_FILE);
+    const configPath2 = path22.join(target.dir, EASY_CODING_DIR, CONFIG_FILE);
     if (!await pathExists(configPath2)) {
       continue;
     }
@@ -3475,12 +3696,12 @@ async function refreshInstalledChildTopologies(targets) {
 }
 
 // src/commands/status.ts
-import path23 from "path";
+import path24 from "path";
 import chalk6 from "chalk";
 
 // src/utils/session.ts
 import { readdir as readdir6, stat as stat3, unlink as unlink2 } from "fs/promises";
-import path22 from "path";
+import path23 from "path";
 var DAY_MS = 24 * 60 * 60 * 1e3;
 var IDLE_SESSION_RETENTION_MS = 7 * DAY_MS;
 var ATTACHED_SESSION_RETENTION_MS = 30 * DAY_MS;
@@ -3494,7 +3715,7 @@ function parseSessionFile(content) {
   }
 }
 function getSessionDir(cwd) {
-  return path22.join(cwd, EASY_CODING_DIR, SESSIONS_DIR);
+  return path23.join(cwd, EASY_CODING_DIR, SESSIONS_DIR);
 }
 async function listSessionFiles(cwd) {
   const dir = getSessionDir(cwd);
@@ -3506,7 +3727,7 @@ async function listSessionFiles(cwd) {
     if (!name.endsWith(".json")) {
       continue;
     }
-    const filePath = path22.join(dir, name);
+    const filePath = path23.join(dir, name);
     const content = await readTextIfExists(filePath);
     if (!content) {
       continue;
@@ -3530,9 +3751,11 @@ async function cleanSessionRuntime(cwd, options = {}) {
   const maxSessions = options.maxSessions ?? MAX_SESSION_FILES;
   const reserveSlots = options.reserveSlots ?? 0;
   const candidates = (await listSessionCleanupCandidates(cwd)).filter((candidate) => {
-    if (!options.preserveTddSettings) return true;
+    if (!options.preserveUnitTestSettings) return true;
     const session = parseSessionFile(candidate.content);
-    return !session || !("tdd_enabled" in session || "tdd_coverage_threshold" in session);
+    return !session || !["unit_test_mode", "ut_coverage_threshold", "tdd_enabled", "tdd_coverage_threshold"].some(
+      (key) => key in session
+    );
   });
   const removed = /* @__PURE__ */ new Set();
   for (const candidate of candidates) {
@@ -3569,7 +3792,7 @@ async function listSessionCleanupCandidates(cwd) {
     if (!entry.isFile() || !entry.name.endsWith(".json")) {
       continue;
     }
-    const filePath = path22.join(dir, entry.name);
+    const filePath = path23.join(dir, entry.name);
     try {
       const [content, fileStat] = await Promise.all([readTextFile(filePath), stat3(filePath)]);
       const session = parseSessionFile(content);
@@ -3604,7 +3827,7 @@ async function unlinkIfUnchanged(candidate) {
   }
 }
 async function cleanOrphanAcceptanceSnapshots(cwd) {
-  const acceptanceDir = path22.join(getSessionDir(cwd), "acceptance");
+  const acceptanceDir = path23.join(getSessionDir(cwd), "acceptance");
   if (!await pathExists(acceptanceDir)) {
     return 0;
   }
@@ -3613,7 +3836,7 @@ async function cleanOrphanAcceptanceSnapshots(cwd) {
     if (!entry.isFile() || !entry.name.endsWith(".json")) {
       continue;
     }
-    const snapshotPath = path22.join(acceptanceDir, entry.name);
+    const snapshotPath = path23.join(acceptanceDir, entry.name);
     if (!await isOrphanAcceptanceSnapshot(cwd, snapshotPath, entry.name.slice(0, -5))) {
       continue;
     }
@@ -3632,7 +3855,7 @@ async function isOrphanAcceptanceSnapshot(cwd, snapshotPath, taskId) {
   let taskContent;
   try {
     taskContent = await readTextFile(
-      path22.join(cwd, EASY_CODING_DIR, TASKS_DIR, taskId, "task.json")
+      path23.join(cwd, EASY_CODING_DIR, TASKS_DIR, taskId, "task.json")
     );
   } catch (error) {
     if (isFileNotFound(error)) {
@@ -3654,7 +3877,7 @@ async function isOrphanAcceptanceSnapshot(cwd, snapshotPath, taskId) {
     return true;
   }
   const checkpoint = task.quality_checkpoint ?? task.verification_checkpoint;
-  return typeof checkpoint?.snapshot_file !== "string" || path22.resolve(cwd, checkpoint.snapshot_file) !== path22.resolve(snapshotPath);
+  return typeof checkpoint?.snapshot_file !== "string" || path23.resolve(cwd, checkpoint.snapshot_file) !== path23.resolve(snapshotPath);
 }
 function isFileNotFound(error) {
   return error.code === "ENOENT";
@@ -3664,7 +3887,7 @@ function isFileNotFound(error) {
 async function status() {
   renderBanner();
   const cwd = process.cwd();
-  const configPath2 = path23.join(cwd, EASY_CODING_DIR, CONFIG_FILE);
+  const configPath2 = path24.join(cwd, EASY_CODING_DIR, CONFIG_FILE);
   if (!await pathExists(configPath2)) {
     throw new Error("No easy-coding harness found in this project.");
   }
@@ -3674,7 +3897,6 @@ async function status() {
   const activeTasks = tasks.filter((item) => isActiveTask(item.task));
   const sessions = await listSessionFiles(cwd);
   const versionRelation = compareVersions(config2.harness_version, VERSION);
-  const tddReadiness = await inspectTddReadiness(cwd);
   console.log(chalk6.bold("Harness"));
   console.log(`  version: ${config2.harness_version}`);
   console.log(`  cli: ${VERSION}`);
@@ -3690,27 +3912,45 @@ async function status() {
   const migratedBehavior = resolveLegacyBehavior(config2);
   const projectApprovalMode = isApprovalMode(config2.behavior?.approval_mode) ? config2.behavior.approval_mode : migratedBehavior.approvalMode;
   const projectWorkflowMode = isConfiguredWorkflowMode(config2.behavior?.workflow_mode) ? config2.behavior.workflow_mode : migratedBehavior.workflowMode;
-  const projectTddEnabled = migratedBehavior.tddEnabled;
-  const projectTddCoverageThreshold = migratedBehavior.tddCoverageThreshold;
+  const projectUnitTestMode = migratedBehavior.unitTestMode;
+  const projectUtCoverageThreshold = migratedBehavior.utCoverageThreshold;
+  const localBehavior = await readLocalBehavior();
+  const projectBehavior = {
+    ...config2.behavior,
+    approval_mode: projectApprovalMode,
+    unit_test_mode: projectUnitTestMode,
+    ut_coverage_threshold: projectUtCoverageThreshold
+  };
+  const effective = resolveBehaviorSettings(projectBehavior, localBehavior);
+  const needsCoverage = effective.values.unit_test_mode !== "none" || sessions.some(({ session }) => ["ut", "tdd"].includes(session.unit_test_mode ?? "none")) || activeTasks.some(({ task }) => ["ut", "tdd"].includes(task.unit_test_mode ?? "none"));
+  const readiness = needsCoverage ? await inspectTddReadiness(cwd) : { status: "not_checked", reasons: [] };
   console.log(`  approval_mode: ${projectApprovalMode}`);
+  console.log(
+    `  cooperate_mode: ${effective.values.cooperate_mode} (${effective.sources.cooperate_mode})`
+  );
   console.log(`  workflow_mode: ${projectWorkflowMode}`);
-  console.log(`  tdd_enabled: ${projectTddEnabled}`);
-  console.log(`  tdd_coverage_threshold: ${projectTddCoverageThreshold}`);
-  console.log(`  tdd_readiness: ${tddReadiness.status}`);
-  if (tddReadiness.status !== "ready") {
-    console.log(`  tdd_readiness_reasons: ${tddReadiness.reasons.join("; ")}`);
+  console.log(`  unit_test_mode: ${projectUnitTestMode}`);
+  console.log(`  ut_coverage_threshold: ${projectUtCoverageThreshold}`);
+  console.log(`  unit_test_readiness: ${readiness.status}`);
+  if (readiness.reasons.length > 0) {
+    console.log(`  unit_test_readiness_reasons: ${readiness.reasons.join("; ")}`);
   }
   console.log("");
   console.log(chalk6.bold("Sessions"));
   console.log(`  project_approval_mode: ${projectApprovalMode}`);
   console.log(`  project_workflow_mode: ${projectWorkflowMode}`);
-  console.log(`  project_tdd_enabled: ${projectTddEnabled}`);
-  console.log(`  project_tdd_coverage_threshold: ${projectTddCoverageThreshold}`);
-  console.log(`  effective_approval_mode: ${projectApprovalMode} (without a session override)`);
+  console.log(`  project_unit_test_mode: ${projectUnitTestMode}`);
+  console.log(`  project_ut_coverage_threshold: ${projectUtCoverageThreshold}`);
+  for (const [key, value] of Object.entries(localBehavior)) console.log(`  local_${key}: ${value}`);
+  console.log(
+    `  effective_approval_mode: ${effective.values.approval_mode} (${effective.sources.approval_mode})`
+  );
   console.log(`  configured_workflow_mode: ${projectWorkflowMode} (without a session override)`);
-  console.log(`  effective_tdd_enabled: ${projectTddEnabled} (without a session override)`);
   console.log(
-    `  effective_tdd_coverage_threshold: ${projectTddCoverageThreshold} (without a session override)`
+    `  effective_unit_test_mode: ${effective.values.unit_test_mode} (${effective.sources.unit_test_mode})`
+  );
+  console.log(
+    `  effective_ut_coverage_threshold: ${effective.values.ut_coverage_threshold} (${effective.sources.ut_coverage_threshold})`
   );
   if (sessions.length === 0) {
     console.log("  no session files");
@@ -3722,21 +3962,28 @@ async function status() {
     );
     const sessionApprovalMode = session.approval_mode ?? (legacySessionMode === "lite" ? "guard" : legacySessionMode);
     const sessionWorkflowMode = session.workflow_mode ?? (legacySessionMode === "lite" ? "fast" : hasLegacySessionMode ? "adaptive" : void 0);
-    const sessionTddEnabled = session.tdd_enabled;
-    const sessionTddCoverageThreshold = session.tdd_coverage_threshold;
+    const sessionUnitTestMode = session.unit_test_mode;
+    const sessionUtCoverageThreshold = session.ut_coverage_threshold;
+    const resolved = resolveBehaviorSettings(projectBehavior, localBehavior, {
+      ...session,
+      approval_mode: sessionApprovalMode
+    });
     console.log(`  - ${key}`);
     console.log(`    agent: ${session.agent ?? "legacy/unknown"}`);
     console.log(`    source: ${session.session_source ?? "legacy"}`);
-    console.log(`    approval_mode: ${sessionApprovalMode ?? "project default"}`);
+    console.log(`    approval_mode: ${sessionApprovalMode ?? "inherit local/project"}`);
     console.log(`    workflow_mode: ${sessionWorkflowMode ?? "project default"}`);
-    console.log(`    tdd_enabled: ${sessionTddEnabled ?? "project default"}`);
-    console.log(`    tdd_coverage_threshold: ${sessionTddCoverageThreshold ?? "project default"}`);
-    console.log(`    effective_approval_mode: ${sessionApprovalMode ?? projectApprovalMode}`);
-    console.log(`    configured_workflow_mode: ${sessionWorkflowMode ?? projectWorkflowMode}`);
-    console.log(`    effective_tdd_enabled: ${sessionTddEnabled ?? projectTddEnabled}`);
+    console.log(`    unit_test_mode: ${sessionUnitTestMode ?? "inherit local/project"}`);
+    console.log(
+      `    ut_coverage_threshold: ${sessionUtCoverageThreshold ?? "inherit local/project"}`
+    );
+    console.log(`    effective_approval_mode: ${resolved.values.approval_mode}`);
     console.log(
-      `    effective_tdd_coverage_threshold: ${sessionTddCoverageThreshold ?? projectTddCoverageThreshold}`
+      `    cooperate_mode: ${resolved.values.cooperate_mode} (${resolved.sources.cooperate_mode})`
     );
+    console.log(`    configured_workflow_mode: ${sessionWorkflowMode ?? projectWorkflowMode}`);
+    console.log(`    effective_unit_test_mode: ${resolved.values.unit_test_mode}`);
+    console.log(`    effective_ut_coverage_threshold: ${resolved.values.ut_coverage_threshold}`);
     console.log(
       `    harness: ${session.harness_disabled ? "disabled for this session" : "enabled"}`
     );
@@ -3756,10 +4003,8 @@ async function status() {
       console.log(
         `    task_workflow_mode: ${task.workflow_mode ?? task.workflow_mode_proposal?.selected_mode ?? "not resolved"}`
       );
-      console.log(`    task_tdd_enabled: ${task.tdd_enabled ?? "not frozen"}`);
-      console.log(
-        `    task_tdd_coverage_threshold: ${task.tdd_coverage_threshold ?? "not frozen"}`
-      );
+      console.log(`    task_unit_test_mode: ${task.unit_test_mode ?? "not frozen"}`);
+      console.log(`    task_ut_coverage_threshold: ${task.ut_coverage_threshold ?? "not frozen"}`);
       console.log(`    last_agent: ${task.last_agent}`);
     } else {
       console.log(`    current_task: ${session.current_task} (task.json missing)`);
@@ -3811,7 +4056,7 @@ async function update(opts) {
 }
 
 // src/commands/upgrade.ts
-import path24 from "path";
+import path25 from "path";
 import { cancel as cancel6, confirm as confirm5, outro as outro6 } from "@clack/prompts";
 import chalk8 from "chalk";
 var EXPECTED_HOOK_REGISTRATION_SCRIPTS = {
@@ -3874,10 +4119,11 @@ async function upgrade(opts) {
     "Will overwrite managed skills, hooks, agents, templates, and generated main-constraint regions.",
     "Will remove retired files that still match the previous install manifest and preserve locally modified copies.",
     "Will update project-init task to recommend ec-init re-run for version adaptation.",
-    "Will migrate behavior config to schema 5 while preserving project/session TDD settings and frozen task baselines.",
-    "Will prune expired session bindings without explicit TDD settings and orphan acceptance snapshots in each upgraded target while preserving tasks, memory, spec, and project knowledge.",
+    "Will migrate behavior config to schema 6 while preserving project/session unit test settings and frozen task baselines.",
+    "Will preserve runtime tools used by active UT/TDD tasks; run upgrade after those tasks finish to refresh the tools.",
+    "Will prune expired session bindings without explicit unit test settings and orphan acceptance snapshots in each upgraded target while preserving tasks, memory, spec, and project knowledge.",
     "Will migrate active REVIEW/VERIFICATION tasks to QUALITY, retire active read-only task types as CLOSED, and preserve their artifacts and history.",
-    "Will migrate legacy workflow/TDD task metadata; memory content, spec, and project knowledge files remain untouched."
+    "Will migrate legacy workflow/unit test task metadata; memory content, spec, and project knowledge files remain untouched."
   ].join("\n");
   if (opts.dryRun) {
     console.log(summary);
@@ -3895,7 +4141,9 @@ async function upgrade(opts) {
   }
   for (const { target, config: config2 } of pending) {
     const previousManifest = await readInstallManifest(target.dir);
-    const sessionCleanup = await cleanSessionRuntime(target.dir, { preserveTddSettings: true });
+    const sessionCleanup = await cleanSessionRuntime(target.dir, {
+      preserveUnitTestSettings: true
+    });
     if (sessionCleanup.sessionsRemoved > 0 || sessionCleanup.acceptanceSnapshotsRemoved > 0) {
       console.log(
         chalk8.yellow(
@@ -3968,7 +4216,7 @@ async function resolvePendingUpgradeTargets(targets) {
         `${target.label} harness version ${installedVersion} is newer than CLI ${VERSION}. Update the CLI first.`
       );
     }
-    if (relation === -1 || relation === 0 && (installedVersion !== VERSION || await needsHookConfigRefresh(target, config2) || await hasLegacyWorkflowState(target.dir))) {
+    if (relation === -1 || relation === 0 && (installedVersion !== VERSION || await needsHookConfigRefresh(target, config2) || await hasLegacyWorkflowState(target.dir) || (await runtimeToolUpdates(target.dir)).length > 0)) {
       pending.push({ target, config: config2 });
     }
   }
@@ -3982,7 +4230,7 @@ async function needsHookConfigRefresh(target, config2) {
   const manifest = await readInstallManifest(target.dir);
   for (const agent of config2.agents) {
     const meta = resolvePlatformMeta(target.dir, agent);
-    const configPath2 = path24.join(target.dir, meta.hookConfigFile);
+    const configPath2 = path25.join(target.dir, meta.hookConfigFile);
     const content = await readTextIfExists(configPath2);
     if (content === null) {
       return true;
@@ -4122,7 +4370,7 @@ function isCurrentProjectManagedHookPath(cwd, hookPath, meta, platform) {
       return true;
     }
     return pathAliases(
-      normalizePathForHookComparison(path24.resolve(cwd, relativeHookPath))
+      normalizePathForHookComparison(path25.resolve(cwd, relativeHookPath))
     ).includes(normalizedHookPath);
   });
 }
@@ -4212,7 +4460,7 @@ program.command("init").description("Initialize easy-coding harness in current p
 program.command("add-agent").description("Add agent platform support to an existing project").option("--agent <list>", "Comma-separated platforms to add").option("--submodules <list>", "Comma-separated initialized submodule paths or names to update").option("--no-submodules", "Add the agent only to the current directory").action(withErrorHandling(addAgent));
 program.command("upgrade").description("Upgrade harness files to current CLI version").option("--dry-run", "Preview changes without applying").option("-y, --yes", "Skip confirmation").action(withErrorHandling(upgrade));
 program.command("update").description("Refresh the global CLI to the latest published version").option("--tag <tag>", "npm dist-tag or version to install", "latest").option("--dry-run", "Preview the install command without running it").option("-y, --yes", "Skip confirmation").action(withErrorHandling(update));
-program.command("config").description("Interactively configure project-level harness behavior").action(withErrorHandling(config));
+program.command("config").description("Configure project or local harness behavior").option("--scope <scope>", "project or local", "project").option("--approval-mode <mode>", "approve, guard, confirm, or auto").option("--cooperate-mode <mode>", "default or dispatch").option("--unit-test-mode <mode>", "none, ut, or tdd").option("--ut-coverage-threshold <percent>", "coverage threshold 1..100").option("--reset <field>", "Remove an override to restore inheritance").option("-y, --yes", "Save explicitly selected fields without another prompt").action(withErrorHandling(config));
 program.command("status").description("Show installed agents, version, and tasks").action(withErrorHandling(status));
 program.command("clear").description("Remove installed harness files (skills, hooks, config); keep tasks, spec, memory").option("--submodules <list>", "Comma-separated initialized submodule paths or names to clear").option("--no-submodules", "Clear only the current directory").option("--dry-run", "Preview what would be removed without deleting").option("-y, --yes", "Skip confirmation").action(withErrorHandling(clear));
 program.parse();