easy-coding-harness 1.0.1 → 1.1.0-beta.1

package/dist/cli.js

@@ -103,8 +103,9 @@ 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 CONFIGURED_WORKFLOW_MODES = ["adaptive", "fast", "standard", "strict"];
 function createDefaultConfig(params) {
@@ -127,8 +128,8 @@ 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
     }
   };
   if (params.supermodule) {
@@ -182,43 +183,65 @@ 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) {
+  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;
     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 = "";
@@ -664,97 +687,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 path7 from "path";
 
 // src/utils/task-json.ts
 import { readdir } from "fs/promises";
-import path7 from "path";
+import path5 from "path";
 var LEGACY_STAGE_MAP = {
   WAITING_CONFIRM: "ANALYSIS",
   MEMORY_SHORT: "MEMORY",
@@ -781,7 +718,7 @@ function createProjectInitTask(params) {
   };
 }
 function getTaskJsonPath(cwd, taskId) {
-  return path7.join(cwd, EASY_CODING_DIR, TASKS_DIR, taskId, "task.json");
+  return path5.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 +943,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 +955,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 +1031,16 @@ function migrationWorkflowMode(task, candidates, projectWorkflowMode) {
   );
 }
 async function taskFiles(cwd) {
-  const tasksDir = path7.join(cwd, EASY_CODING_DIR, TASKS_DIR);
+  const tasksDir = path5.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) => path5.join(tasksDir, entry.name, "task.json"));
 }
 async function sessionFiles(cwd) {
-  const sessionsDir = path7.join(cwd, EASY_CODING_DIR, SESSIONS_DIR);
+  const sessionsDir = path5.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) => path5.join(sessionsDir, entry.name));
 }
 async function readJsonRecord(filePath) {
   try {
@@ -1116,7 +1055,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 +1067,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 +1078,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 = path5.join(cwd, EASY_CODING_DIR, "config.yaml");
   if (await pathExists(configPath2)) {
     try {
       const config2 = await readConfigYaml(configPath2);
@@ -1194,7 +1133,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 = path5.basename(path5.dirname(filePath));
     const mode = migrationWorkflowMode(
       task,
       candidatesByTask.get(taskId) ?? [],
@@ -1229,7 +1168,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 = path5.join(cwd, EASY_CODING_DIR, TASKS_DIR);
   if (!await pathExists(tasksDir)) {
     return [];
   }
@@ -1260,6 +1199,105 @@ function isActiveTask(task) {
   return task.status !== "COMPLETE" && task.status !== "CLOSED";
 }
 
+// src/utils/template-paths.ts
+import { existsSync } from "fs";
+import path6 from "path";
+import { fileURLToPath as fileURLToPath2 } from "url";
+function getTemplateRoot() {
+  const here = path6.dirname(fileURLToPath2(import.meta.url));
+  const candidates = [
+    path6.resolve(here, "../templates"),
+    path6.resolve(here, "../../templates"),
+    path6.resolve(process.cwd(), "src/templates"),
+    path6.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 path6.join(getTemplateRoot(), ...segments);
+}
+
+// src/utils/runtime-scaffold.ts
+async function writeRuntimeScaffold(cwd, agents, opts = {}) {
+  const easyCodingDir = path7.join(cwd, EASY_CODING_DIR);
+  await ensureDir(easyCodingDir);
+  const configPath2 = path7.join(easyCodingDir, CONFIG_FILE);
+  let projectId = opts.projectId ?? createProjectId();
+  if (!await pathExists(configPath2)) {
+    const projectName = path7.basename(cwd);
+    await writeConfigYaml(
+      configPath2,
+      createDefaultConfig({
+        projectName,
+        projectId,
+        harnessVersion: VERSION,
+        agents,
+        supermodule: opts.supermodule
+      })
+    );
+  } else {
+    projectId = await ensureProjectId(configPath2);
+  }
+  await ensureDir(path7.join(easyCodingDir, "tasks"));
+  await ensureDir(path7.join(easyCodingDir, SESSIONS_DIR));
+  await ensureDir(path7.join(easyCodingDir, SPEC_DIR, MAIN_SPEC_DIR));
+  await ensureDir(path7.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 = path7.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 = path7.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 = path7.join(easyCodingDir, TEMPLATES_DIR);
+  await ensureDir(templatesDir);
+  const src = getTemplatePath("runtime", "templates", "dev-spec-skeleton.md");
+  const dest = path7.join(templatesDir, "dev-spec-skeleton.md");
+  await writeTextFile(dest, await readTextFile(src));
+}
+async function writeMemoryScaffold(easyCodingDir) {
+  const memoryDir = path7.join(easyCodingDir, MEMORY_DIR);
+  await ensureDir(path7.join(memoryDir, "short"));
+  await ensureDir(path7.join(memoryDir, "long"));
+  for (const file of ["MEMORY.md", "BUSINESS.md", "TECHNICAL.md"]) {
+    const destination = path7.join(memoryDir, "long", file);
+    if (await pathExists(destination)) {
+      continue;
+    }
+    const templatePath = getTemplatePath("runtime", "memory", "long", file);
+    await writeTextFile(destination, await readTextFile(templatePath));
+  }
+  const shortTemplateDest = path7.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";
 
@@ -3181,94 +3219,66 @@ async function config() {
     cancel4("Configuration cancelled.");
     return;
   }
-  const workflowMode = await select({
-    message: `Select project workflow mode (current: ${current.workflowMode})`,
-    initialValue: current.workflowMode,
+  const workflowMode = "adaptive";
+  const unitTestMode = await select({
+    message: `Select Java unit test strategy (current: ${current.unitTestMode})`,
+    initialValue: current.unitTestMode,
     options: [
-      {
-        value: "adaptive",
-        label: "adaptive \u2014 choose by task risk (default)",
-        hint: "freezes to fast, standard, or strict after ANALYSIS"
-      },
-      {
-        value: "fast",
-        label: "fast \u2014 compact execution for low-risk tasks",
-        hint: "all workflow stages still run"
-      },
-      {
-        value: "standard",
-        label: "standard \u2014 balanced execution",
-        hint: "independent review and impacted verification"
-      },
-      {
-        value: "strict",
-        label: "strict \u2014 maximum assurance",
-        hint: "multi-dimensional review and full verification"
-      }
+      { 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 workflowMode === "symbol") {
+  if (typeof unitTestMode === "symbol") {
     cancel4("Configuration cancelled.");
     return;
   }
-  const tddEnabled = await select({
-    message: `Enable Java TDD for this project (current: ${current.tddEnabled ? "enabled" : "disabled"})`,
-    initialValue: current.tddEnabled,
-    options: [
-      { value: false, label: "disabled \u2014 preserve current test depth (default)" },
-      { value: true, label: "enabled \u2014 require TDD evidence and changed-line coverage" }
-    ]
-  });
-  if (typeof tddEnabled === "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 shouldSave = await confirm3({
-    message: `Set approval=${approvalMode}, workflow=${workflowMode}, TDD=${tddEnabled ? `enabled (${tddCoverageThreshold}%)` : "disabled"}?`,
+    message: `Set approval=${approvalMode}, workflow=${workflowMode}, 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);
   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}%)`}.`
     )
   );
 }
@@ -3559,9 +3569,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) {
@@ -3703,7 +3715,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}`);
@@ -3719,27 +3730,29 @@ 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 needsCoverage = projectUnitTestMode !== "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(`  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(`  project_unit_test_mode: ${projectUnitTestMode}`);
+  console.log(`  project_ut_coverage_threshold: ${projectUtCoverageThreshold}`);
   console.log(`  effective_approval_mode: ${projectApprovalMode} (without a session override)`);
   console.log(`  configured_workflow_mode: ${projectWorkflowMode} (without a session override)`);
-  console.log(`  effective_tdd_enabled: ${projectTddEnabled} (without a session override)`);
+  console.log(`  effective_unit_test_mode: ${projectUnitTestMode} (without a session override)`);
   console.log(
-    `  effective_tdd_coverage_threshold: ${projectTddCoverageThreshold} (without a session override)`
+    `  effective_ut_coverage_threshold: ${projectUtCoverageThreshold} (without a session override)`
   );
   if (sessions.length === 0) {
     console.log("  no session files");
@@ -3751,20 +3764,20 @@ 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;
     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(`    workflow_mode: ${sessionWorkflowMode ?? "project default"}`);
-    console.log(`    tdd_enabled: ${sessionTddEnabled ?? "project default"}`);
-    console.log(`    tdd_coverage_threshold: ${sessionTddCoverageThreshold ?? "project default"}`);
+    console.log(`    unit_test_mode: ${sessionUnitTestMode ?? "project default"}`);
+    console.log(`    ut_coverage_threshold: ${sessionUtCoverageThreshold ?? "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(`    effective_unit_test_mode: ${sessionUnitTestMode ?? projectUnitTestMode}`);
     console.log(
-      `    effective_tdd_coverage_threshold: ${sessionTddCoverageThreshold ?? projectTddCoverageThreshold}`
+      `    effective_ut_coverage_threshold: ${sessionUtCoverageThreshold ?? projectUtCoverageThreshold}`
     );
     console.log(
       `    harness: ${session.harness_disabled ? "disabled for this session" : "enabled"}`
@@ -3785,10 +3798,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)`);
@@ -3903,10 +3914,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);
@@ -3924,7 +3936,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(
@@ -3997,7 +4011,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 });
     }
   }