easy-coding-harness 1.0.0-beta.2 → 1.0.1-beta.0

package/CHANGELOG.md

@@ -6,6 +6,29 @@
 - `y`：常规功能升级
 - `z`：日常 bug 修复
 
+## 1.0.1-beta.0
+
+- TDD 日常 readiness 检查保留初始化入口和参数契约校验，取消构建文件、CI 和工具文件与
+  初始化快照必须逐字一致的要求。Maven 版本、依赖和格式变更不再要求重新初始化；缺少
+  凭据提示首次初始化，已有入口损坏提示具体修复，本地测试和差异覆盖率仍负责最终验收。
+- 升级保留项目/session TDD 开关、覆盖率阈值与进行中任务的冻结配置；readiness 异常和
+  工具更新不再自动关闭 TDD，升级清理保留带有显式 TDD 配置的 session。
+- Canonical Spec 接手恢复绑定原稿的选中消费范围，核对设计版本并公开待同步状态；确认的
+  需求变更先登记到任务，原稿修订与设计同步完成后才能继续实施和验收。
+- 修复跨 Agent 恢复设计同步时把任务负责人改回原事件作者的问题；重放保持原事件归属与
+  幂等键，当前负责人和会话保持为实际接手者。
+
+## 1.0.0
+
+- 首个正式版本，固化统一的 `INIT → ANALYSIS → IMPLEMENT → QUALITY → MEMORY → COMPLETE`
+  状态机；Fast、Standard、Strict 共享状态图，仅按任务复杂度和风险调整执行深度。
+- 正式提供 Canonical Spec 精确消费、持久分析方案回执、双门 QUALITY、`ec-lite` 极简模式、
+  会话清理与用户验收后差异接受等完整能力，并保持 Claude Code、Codex、Qoder 三端一致。
+- 稳定编码约束：遵循最近邻代码风格和最小修改，避免过度设计、冗余校验、碎片方法与无意义
+  常量；接口方法已有完整文档且实现无额外语义时，不重复编写实现方法 Javadoc。
+- 正式版由 `1.0.0-beta.2` 晋升，不新增破坏性变更；默认安装命令将通过 npm `latest` 获取
+  `1.0.0`，预发布用户可直接升级。
+
 ## 1.0.0-beta.2
 
 - 核心 Java Javadoc 规则新增接口文档继承例外：接口方法已有完整、准确且可访问的

package/README.md

@@ -213,16 +213,27 @@ easy-coding upgrade
 `behavior.approval_mode` 与 `behavior.workflow_mode`；旧 `lite` 映射为 `guard + fast`。
 项目级模式用 `easy-coding config` 修改（要求
 项目 Harness 与 CLI 版本完全一致，否则先执行 `easy-coding upgrade` 或更新 CLI）；当前
-session 临时覆盖统一通过 `ec-config` 对话修改。升级到 0.10.0-beta.2 时配置 schema 升至
-5；未完成 `ec-tdd-init` readiness 的项目/session TDD 请求迁移为关闭并保留阈值，同时
-部署共享 Java 差异覆盖率与 readiness 工具。0.10.0-beta.3 起，TDD 业务任务只依赖本地
+session 临时覆盖统一通过 `ec-config` 对话修改。当前配置 schema 为 5；升级保留项目和
+session 的 TDD 开关、阈值及继承关系，也保留任务已经冻结的基线。支持 TDD 的 schema 4
+迁移保留用户配置；readiness 缺失或损坏只报告问题，不自动关闭 TDD。TDD 业务任务只依赖本地
 单测与本地差异覆盖率，历史远程 CI 证据保留但不再参与验收。已经冻结的活动任务合同
 不会被静默改写。0.10.0-beta.4 起，仍停在 ANALYSIS 的旧任务必须补齐决策闭环后才能
 进入 IMPLEMENT；已经进入后续阶段的任务不受影响。
 
 session GC 只在创建新逻辑会话前和实际升级时触发：无任务绑定的会话保留 7 天、仍绑定
 任务的会话保留 30 天，并按最近活动时间将根目录 JSON 控制在 100 个以内。活动任务仍在
-引用的 acceptance 验收快照会被保留；任务、记忆、Spec 和项目知识不参与清理。
+引用的 acceptance 验收快照会被保留；升级时带有显式 TDD 配置的 session 不参与清理。
+任务、记忆、Spec 和项目知识不参与清理。
+
+TDD 凭据中的文件摘要是初始化历史。POM 版本、依赖、插件、CI 或托管工具变化无需重新
+初始化；本轮构建与工具变化会使旧验收证据失效。日常 readiness 只检查必要本地入口和
+参数契约；缺少凭据为 `needs_init`，已有凭据或入口损坏为 `needs_repair`。实际单测与
+增量覆盖率仍须通过。`ec-tdd-init` 的完整校验包含 GitLab CI。
+
+正式绑定的外部 Canonical Spec 在创建和接手时返回选中内容，恢复会话使用
+`resume-spec-context`。需求确认后先用 `begin-spec-change` 登记，再更新绑定原稿、递增
+revision、验证 READY 并执行 `sync-spec-design`；随后恢复上下文并更新派生计划。待同步
+变更会跨 Agent 保留并阻止实施和验收，交接摘要不能代替原稿。
 
 若当前会话不希望 Harness 接管，显式调用 `/ec-no-harness`（Codex 使用
 `$ec-no-harness`）。它只旁路 Easy Coding，不关闭其他 hooks，也不忽略其他 skills；

package/dist/cli.js

@@ -191,8 +191,7 @@ function resolveLegacyBehavior(config2) {
   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 supportsReadyTdd = Number(config2.version) >= CONFIG_SCHEMA_VERSION;
-  const tddEnabled = supportsReadyTdd && behavior.tdd_enabled === true;
+  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 };
 }
@@ -1009,15 +1008,11 @@ function migrateTaskWorkflowState(task) {
   }
   if (isActive && taskType !== "project-init" && typeof task.tdd_enabled !== "boolean") {
     task.tdd_enabled = false;
-    task.tdd_coverage_threshold = DEFAULT_TDD_COVERAGE_THRESHOLD;
+    task.tdd_coverage_threshold ??= DEFAULT_TDD_COVERAGE_THRESHOLD;
     task.tdd_confirmed_at = (/* @__PURE__ */ new Date()).toISOString();
     task.tdd_confirmed_by = "upgrade-migration";
     changed = true;
   }
-  if (task.tdd_enabled === false && "tdd_baselines" in task) {
-    task.tdd_baselines = void 0;
-    changed = true;
-  }
   return changed;
 }
 function migrateSessionBehavior(session) {
@@ -3022,8 +3017,7 @@ async function checkForUpgrade(cwd) {
 }
 
 // src/utils/tdd-readiness.ts
-import { createHash as createHash2 } from "crypto";
-import { readFile as readFile4, readdir as readdir5, realpath as realpath2 } from "fs/promises";
+import { readFile as readFile4, realpath as realpath2 } from "fs/promises";
 import path18 from "path";
 var TDD_READINESS_SCHEMA = "easy-coding/tdd-readiness-v1";
 var TDD_READINESS_SCOPE = "changed-production-lines";
@@ -3031,7 +3025,6 @@ var TDD_BASE_VARIABLE = "EASY_CODING_TDD_BASE_SHA";
 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"]);
-var GITLAB_CI_ENTRY_FILES = /* @__PURE__ */ new Set([".gitlab-ci.yml", ".gitlab-ci.yaml"]);
 function readinessPath(root) {
   return path18.join(root, EASY_CODING_DIR, TDD_DIR, TDD_READINESS_FILE);
 }
@@ -3047,11 +3040,11 @@ function parseFileRecords(value, field, reasons) {
       continue;
     }
     const record = item;
-    if (typeof record.path !== "string" || !record.path.trim() || path18.isAbsolute(record.path) || typeof record.sha256 !== "string" || !/^[a-f0-9]{64}$/.test(record.sha256)) {
-      reasons.push(`${field} contains an invalid path or SHA-256`);
+    if (typeof record.path !== "string" || !record.path.trim() || path18.isAbsolute(record.path)) {
+      reasons.push(`${field} contains an invalid path`);
       continue;
     }
-    records.push({ path: record.path, sha256: record.sha256 });
+    records.push({ path: record.path });
   }
   return records;
 }
@@ -3063,11 +3056,7 @@ function isSafeReportPattern(value) {
   const normalized = value.replaceAll("\\", "/");
   return !path18.isAbsolute(value) && !normalized.split("/").includes("..");
 }
-function activeCiContent(contents) {
-  return contents.join("\n").split("\n").map((line) => line.replace(/^\s*#.*$/, "").replace(/\s+#.*$/, "")).join("\n");
-}
 async function validateFiles(root, records, reasons) {
-  const contents = [];
   const resolvedRoot = await realpath2(root);
   for (const record of records) {
     const absolute = path18.resolve(root, record.path);
@@ -3077,15 +3066,11 @@ async function validateFiles(root, records, reasons) {
         reasons.push(`readiness file escapes project root: ${record.path}`);
         continue;
       }
-      const content = await readFile4(resolved);
-      const digest = createHash2("sha256").update(content).digest("hex");
-      if (digest !== record.sha256) reasons.push(`readiness file changed: ${record.path}`);
-      contents.push(content.toString("utf8"));
+      await readFile4(resolved);
     } catch {
       reasons.push(`readiness file is missing or unreadable: ${record.path}`);
     }
   }
-  return contents;
 }
 async function inspectTddReadiness(root) {
   const manifestPath2 = readinessPath(root);
@@ -3096,7 +3081,14 @@ async function inspectTddReadiness(root) {
   try {
     manifest = JSON.parse(await readFile4(manifestPath2, "utf8"));
   } catch {
-    return { status: "needs_init", reasons: ["TDD readiness receipt is invalid"], manifestPath: manifestPath2 };
+    return { status: "needs_repair", reasons: ["TDD readiness receipt is invalid"], manifestPath: manifestPath2 };
+  }
+  if (!manifest || typeof manifest !== "object" || Array.isArray(manifest)) {
+    return {
+      status: "needs_repair",
+      reasons: ["TDD readiness receipt must be a JSON object"],
+      manifestPath: manifestPath2
+    };
   }
   const reasons = [];
   if (manifest.schema !== TDD_READINESS_SCHEMA) reasons.push("unsupported readiness schema");
@@ -3118,67 +3110,21 @@ async function inspectTddReadiness(root) {
     reasons.push("changed-line coverage gate must use the task baseline and threshold variables");
   }
   const buildFiles = parseFileRecords(manifest.build_files, "build_files", reasons);
-  const ciFiles = parseFileRecords(manifest.ci_files, "ci_files", reasons);
   const toolFiles = parseFileRecords(manifest.tool_files, "tool_files", reasons);
   if (!buildFiles.some((record) => JAVA_BUILD_FILE_NAMES.has(path18.basename(record.path)))) {
     reasons.push("build_files must include a Maven or Gradle Java build file");
   }
-  if (!ciFiles.some((record) => GITLAB_CI_ENTRY_FILES.has(record.path.replaceAll("\\", "/")))) {
-    reasons.push("ci_files must include the project-root GitLab CI entry file");
-  }
   if (!toolFiles.some((record) => record.path.replaceAll("\\", "/") === COVERAGE_TOOL_PATH)) {
     reasons.push(`tool_files must include ${COVERAGE_TOOL_PATH}`);
   }
-  const buildContents = await validateFiles(root, buildFiles, reasons);
-  const ciContents = await validateFiles(root, ciFiles, reasons);
+  await validateFiles(root, buildFiles, reasons);
   await validateFiles(root, toolFiles, reasons);
-  if (!buildContents.some((content) => /jacoco/i.test(content))) {
-    reasons.push("build files do not configure JaCoCo");
-  }
-  const combinedCi = activeCiContent(ciContents);
-  for (const marker of [
-    "jacoco",
-    "artifacts",
-    COVERAGE_TOOL_PATH,
-    TDD_BASE_VARIABLE,
-    TDD_THRESHOLD_VARIABLE
-  ]) {
-    if (!combinedCi.toLowerCase().includes(marker.toLowerCase())) {
-      reasons.push(`CI files do not contain required marker: ${marker}`);
-    }
-  }
-  if (!usesRequiredGateVariables(combinedCi)) {
-    reasons.push("CI changed-line gate must use the task baseline and threshold variables");
-  }
-  if (!/(?:^|\n)\s*stage\s*:\s*['"]?test['"]?\s*(?:#.*)?(?:\n|$)/i.test(combinedCi)) {
-    reasons.push("CI files do not declare a TEST-stage job");
-  }
   return {
-    status: reasons.length === 0 ? "ready" : "needs_init",
+    status: reasons.length === 0 ? "ready" : "needs_repair",
     reasons: [...new Set(reasons)],
     manifestPath: manifestPath2
   };
 }
-async function disableUnreadySessionTddOverrides(root) {
-  if ((await inspectTddReadiness(root)).status === "ready") return 0;
-  const sessionsDir = path18.join(root, EASY_CODING_DIR, SESSIONS_DIR);
-  if (!await pathExists(sessionsDir)) return 0;
-  let updated = 0;
-  for (const entry of await readdir5(sessionsDir, { withFileTypes: true })) {
-    if (!entry.isFile() || !entry.name.endsWith(".json")) continue;
-    const filePath = path18.join(sessionsDir, entry.name);
-    try {
-      const session = JSON.parse(await readFile4(filePath, "utf8"));
-      if (session.tdd_enabled !== true) continue;
-      session.tdd_enabled = false;
-      await writeTextFile(filePath, `${JSON.stringify(session, null, 2)}
-`);
-      updated += 1;
-    } catch {
-    }
-  }
-  return updated;
-}
 
 // src/commands/config.ts
 async function config() {
@@ -3281,7 +3227,7 @@ async function config() {
     const readiness = await inspectTddReadiness(process.cwd());
     if (readiness.status !== "ready") {
       cancel4(
-        `TDD was not enabled. Run ec-tdd-init first: ${readiness.reasons.join("; ")}. No project modes were changed.`
+        `TDD was not enabled. ${readiness.status === "needs_init" ? "Run ec-tdd-init first" : "Repair TDD readiness"}: ${readiness.reasons.join("; ")}. No project modes were changed.`
       );
       return;
     }
@@ -3333,7 +3279,7 @@ import { note, outro as outro4 } from "@clack/prompts";
 import chalk5 from "chalk";
 
 // src/utils/install-state.ts
-import { readdir as readdir6 } from "fs/promises";
+import { readdir as readdir5 } from "fs/promises";
 import path20 from "path";
 var LEGACY_ROOT_FILES = ["SOUL.md", "RULES.md", "ABSTRACT.md"];
 async function detectEasyCodingInstallState(cwd) {
@@ -3379,14 +3325,14 @@ async function listMarkdownFiles(dir) {
   if (!await isDirectory(dir)) {
     return [];
   }
-  const entries = await readdir6(dir, { withFileTypes: true });
+  const entries = await readdir5(dir, { withFileTypes: true });
   return entries.filter((entry) => entry.isFile() && entry.name.endsWith(".md")).map((entry) => entry.name).sort();
 }
 async function hasAnyDirectoryEntry(dir) {
   if (!await isDirectory(dir)) {
     return false;
   }
-  return (await readdir6(dir)).length > 0;
+  return (await readdir5(dir)).length > 0;
 }
 function relativeEasyCodingPath(...segments) {
   return path20.posix.join(EASY_CODING_DIR, ...segments);
@@ -3562,7 +3508,7 @@ import path23 from "path";
 import chalk6 from "chalk";
 
 // src/utils/session.ts
-import { readdir as readdir7, stat as stat3, unlink as unlink2 } from "fs/promises";
+import { readdir as readdir6, stat as stat3, unlink as unlink2 } from "fs/promises";
 import path22 from "path";
 var DAY_MS = 24 * 60 * 60 * 1e3;
 var IDLE_SESSION_RETENTION_MS = 7 * DAY_MS;
@@ -3585,7 +3531,7 @@ async function listSessionFiles(cwd) {
     return [];
   }
   const entries = [];
-  for (const name of await readdir7(dir)) {
+  for (const name of await readdir6(dir)) {
     if (!name.endsWith(".json")) {
       continue;
     }
@@ -3612,7 +3558,11 @@ async function cleanSessionRuntime(cwd, options = {}) {
   const attachedRetentionMs = options.attachedRetentionMs ?? ATTACHED_SESSION_RETENTION_MS;
   const maxSessions = options.maxSessions ?? MAX_SESSION_FILES;
   const reserveSlots = options.reserveSlots ?? 0;
-  const candidates = await listSessionCleanupCandidates(cwd);
+  const candidates = (await listSessionCleanupCandidates(cwd)).filter((candidate) => {
+    if (!options.preserveTddSettings) return true;
+    const session = parseSessionFile(candidate.content);
+    return !session || !("tdd_enabled" in session || "tdd_coverage_threshold" in session);
+  });
   const removed = /* @__PURE__ */ new Set();
   for (const candidate of candidates) {
     const retentionMs = candidate.attached ? attachedRetentionMs : idleRetentionMs;
@@ -3644,7 +3594,7 @@ async function listSessionCleanupCandidates(cwd) {
     return [];
   }
   const candidates = [];
-  for (const entry of await readdir7(dir, { withFileTypes: true })) {
+  for (const entry of await readdir6(dir, { withFileTypes: true })) {
     if (!entry.isFile() || !entry.name.endsWith(".json")) {
       continue;
     }
@@ -3688,7 +3638,7 @@ async function cleanOrphanAcceptanceSnapshots(cwd) {
     return 0;
   }
   let removed = 0;
-  for (const entry of await readdir7(acceptanceDir, { withFileTypes: true })) {
+  for (const entry of await readdir6(acceptanceDir, { withFileTypes: true })) {
     if (!entry.isFile() || !entry.name.endsWith(".json")) {
       continue;
     }
@@ -3953,8 +3903,8 @@ 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 and disable unready project/session TDD settings.",
-    "Will prune expired session bindings and orphan acceptance snapshots in each upgraded target while preserving tasks, memory, spec, and project knowledge.",
+    "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 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."
   ].join("\n");
@@ -3974,7 +3924,7 @@ async function upgrade(opts) {
   }
   for (const { target, config: config2 } of pending) {
     const previousManifest = await readInstallManifest(target.dir);
-    const sessionCleanup = await cleanSessionRuntime(target.dir);
+    const sessionCleanup = await cleanSessionRuntime(target.dir, { preserveTddSettings: true });
     if (sessionCleanup.sessionsRemoved > 0 || sessionCleanup.acceptanceSnapshotsRemoved > 0) {
       console.log(
         chalk8.yellow(
@@ -3982,7 +3932,6 @@ async function upgrade(opts) {
         )
       );
     }
-    const beta1ProjectTddRequested = Number(config2.version) === 4 && config2.behavior?.tdd_enabled === true;
     const projectId = await writeRuntimeScaffold(target.dir, config2.agents, {
       supermodule: target.supermodule
     });
@@ -4007,14 +3956,6 @@ async function upgrade(opts) {
     await ensureHookBytecodeIgnored(target.dir);
     await migrateLegacyWorkflowState(target.dir);
     await migrateBehaviorConfig(target.configPath);
-    const disabledSessionTddOverrides = await disableUnreadySessionTddOverrides(target.dir);
-    if (beta1ProjectTddRequested || disabledSessionTddOverrides > 0) {
-      console.log(
-        chalk8.yellow(
-          `${target.label}: TDD remains off until ec-tdd-init succeeds (project=${beta1ProjectTddRequested ? "disabled" : "unchanged"}, sessions_disabled=${disabledSessionTddOverrides}).`
-        )
-      );
-    }
     await updateHarnessVersion(target.configPath, VERSION);
     await updateSupermoduleConfig(target.configPath, target.supermodule);
     await setPendingInitSince(target.dir, VERSION);