coding-agent-harness 1.0.4 → 1.0.6

package/scripts/lib/task-tombstone-commands.mjs

@@ -1,140 +0,0 @@
-import fs from "node:fs";
-import path from "node:path";
-import {
-  normalizeTarget,
-  nowTimestamp,
-  readFileSafe,
-  toPosix,
-  datePrefix,
-} from "./core-shared.mjs";
-import { collectTasks } from "./task-scanner.mjs";
-import {
-  beginGovernanceSync,
-  commitGovernanceSync,
-  releaseGovernanceSync,
-} from "./governance-sync.mjs";
-
-export function supersedeTask(targetInput, oldRef, { by = "", reason = "" } = {}) {
-  if (!by) throw new Error("task-supersede requires --by <new-task-id>");
-  const target = normalizeTarget(targetInput);
-  const oldTask = resolveTask(target, oldRef);
-  const newTask = resolveTask(target, by);
-  const governanceContext = beginGovernanceSync(target, { operation: `task-supersede ${oldTask.id}` });
-  try {
-    writeTombstone(target, oldTask, {
-      State: "superseded",
-      "Superseded By": newTask.id,
-      Reason: reason || "superseded",
-      Operator: "coordinator",
-      Timestamp: nowTimestamp(),
-      "Reopen Eligible": "yes",
-      "Archive Eligible": "no",
-    });
-    appendProgress(target, oldTask, `task-supersede: superseded by ${newTask.id}`, reason || "superseded");
-    appendSupersedes(target, newTask, oldTask.id);
-    const commit = commitGovernanceSync(contextFor(target, governanceContext), taskPaths(target, oldTask, newTask), {
-      message: `chore(harness): supersede task ${oldTask.id}`,
-    });
-    return { taskId: oldTask.id, supersededBy: newTask.id, reason: reason || "superseded", governance: { commit } };
-  } finally {
-    releaseGovernanceSync(governanceContext);
-  }
-}
-
-export function softDeleteTask(targetInput, taskRef, { reason = "" } = {}) {
-  const target = normalizeTarget(targetInput);
-  const task = resolveTask(target, taskRef);
-  return writeDeletionState(target, task, "soft-deleted", reason || "soft-delete", "task-delete --soft");
-}
-
-export function archiveTask(targetInput, taskRef, { reason = "" } = {}) {
-  const target = normalizeTarget(targetInput);
-  const task = resolveTask(target, taskRef);
-  return writeDeletionState(target, task, "archived", reason || "archive", "task-archive");
-}
-
-export function reopenTask(targetInput, taskRef, { reason = "" } = {}) {
-  const target = normalizeTarget(targetInput);
-  const task = resolveTask(target, taskRef);
-  const governanceContext = beginGovernanceSync(target, { operation: `task-reopen ${task.id}` });
-  try {
-    const taskPlanPath = path.join(target.projectRoot, task.taskPlanPath.replace(/^TARGET:/, ""));
-    const content = readFileSafe(taskPlanPath);
-    const next = content.replace(/\n##\s*(?:Task Tombstone|任务墓碑)\s*$[\s\S]*?(?=^##\s+|(?![\s\S]))/im, "");
-    fs.writeFileSync(taskPlanPath, next.endsWith("\n") ? next : `${next}\n`);
-    appendProgress(target, task, "task-reopen", reason || "reopened");
-    const commit = commitGovernanceSync(governanceContext, taskPaths(target, task), {
-      message: `chore(harness): reopen task ${task.id}`,
-    });
-    return { taskId: task.id, deletionState: "active", reason: reason || "reopened", governance: { commit } };
-  } finally {
-    releaseGovernanceSync(governanceContext);
-  }
-}
-
-function writeDeletionState(target, task, deletionState, reason, action) {
-  const governanceContext = beginGovernanceSync(target, { operation: `${action} ${task.id}` });
-  try {
-    writeTombstone(target, task, {
-      State: deletionState,
-      Reason: reason,
-      Operator: "coordinator",
-      Timestamp: nowTimestamp(),
-      "Reopen Eligible": "yes",
-      "Archive Eligible": deletionState === "archived" ? "yes" : "no",
-    });
-    appendProgress(target, task, action, reason);
-    const commit = commitGovernanceSync(governanceContext, taskPaths(target, task), {
-      message: `chore(harness): ${action.replace(/\s+/g, " ")} ${task.id}`,
-    });
-    return { taskId: task.id, deletionState, reason, governance: { commit } };
-  } finally {
-    releaseGovernanceSync(governanceContext);
-  }
-}
-
-function taskPaths(target, ...tasks) {
-  return [...new Set(tasks.flatMap((task) => [task.taskPlanPath, task.progressPath]).filter(Boolean).map((item) => toPosix(item.replace(/^TARGET:/, ""))))];
-}
-
-function contextFor(_target, context) {
-  return context;
-}
-
-function resolveTask(target, ref) {
-  const normalized = String(ref || "").trim();
-  const matches = collectTasks(target).filter((task) => {
-    const bare = datePrefix.test(task.shortId) ? task.shortId.replace(datePrefix, "") : task.shortId;
-    return task.id === normalized || task.shortId === normalized || task.id.endsWith(`/${normalized}`) || bare === normalized;
-  });
-  if (matches.length === 1) return matches[0];
-  if (matches.length > 1) throw new Error(`Ambiguous task reference: ${ref}`);
-  throw new Error(`Task not found: ${ref}`);
-}
-
-function writeTombstone(target, task, fields) {
-  const taskPlanPath = path.join(target.projectRoot, task.taskPlanPath.replace(/^TARGET:/, ""));
-  const content = readFileSafe(taskPlanPath).replace(/\n##\s*(?:Task Tombstone|任务墓碑)\s*$[\s\S]*?(?=^##\s+|(?![\s\S]))/im, "");
-  const block = ["", "## Task Tombstone", "", "| Field | Value |", "| --- | --- |", ...Object.entries(fields).map(([key, value]) => `| ${key} | ${escapeCell(value)} |`), ""].join("\n");
-  fs.writeFileSync(taskPlanPath, `${content.trimEnd()}\n${block}`);
-}
-
-function appendSupersedes(target, task, oldId) {
-  const taskPlanPath = path.join(target.projectRoot, task.taskPlanPath.replace(/^TARGET:/, ""));
-  const content = readFileSafe(taskPlanPath);
-  if (/^Supersedes\s*[:：]/im.test(content)) {
-    fs.writeFileSync(taskPlanPath, content.replace(/^Supersedes\s*[:：]\s*(.*)$/im, (_m, current) => `Supersedes: ${[current, oldId].filter(Boolean).join(", ")}`));
-    return;
-  }
-  fs.writeFileSync(taskPlanPath, `${content.trimEnd()}\nSupersedes: ${oldId}\n`);
-}
-
-function appendProgress(target, task, action, reason) {
-  const progressPath = path.join(target.projectRoot, task.progressPath.replace(/^TARGET:/, ""));
-  const relative = toPosix(path.relative(target.projectRoot, progressPath));
-  fs.appendFileSync(progressPath, `\n\n## Tombstone Log\n\n- ${nowTimestamp()} ${action}: ${escapeCell(reason)} (${relative})\n`);
-}
-
-function escapeCell(value) {
-  return String(value || "").replace(/\r?\n/g, " ").replaceAll("|", "\\|").trim();
-}

package/scripts/postinstall.mjs

@@ -1,14 +0,0 @@
-#!/usr/bin/env node
-
-import { seedBundledPresets } from "./lib/harness-core.mjs";
-
-if (process.env.CODING_AGENT_HARNESS_SKIP_POSTINSTALL === "1") process.exit(0);
-
-try {
-  const result = seedBundledPresets({ scope: "user" });
-  const changed = result.created + result.overwritten;
-  const summary = changed > 0 ? `${changed} bundled presets installed` : `${result.skipped} bundled presets already present`;
-  console.log(`coding-agent-harness postinstall: ${summary} at ${result.target}`);
-} catch (error) {
-  console.warn(`coding-agent-harness postinstall: preset seed skipped (${error.message})`);
-}

package/templates/walkthrough/Closeout-SSoT.md

@@ -1,43 +0,0 @@
-# Closeout SSoT
-
-## Purpose
-
-Track whether planned work has completed the required closeout contract: implementation evidence, regression evidence, review disposition, walkthrough, residual routing, lessons check, and ledger update.
-
-## Status Legend
-
-| Status | Meaning | Required Next Step |
-| --- | --- | --- |
-| open | Work is not ready for closeout. | Continue implementation or evidence collection. |
-| evidence | Implementation is done but verification is incomplete. | Run required checks and attach evidence. |
-| review | Evidence exists and review is pending. | Resolve findings or record `accepted-risk`. |
-| closing | Final walkthrough and ledger updates are in progress. | Finish lessons check and routing. |
-| closed | Closeout contract is complete. | Archive after the retention window. |
-| blocked | Closeout cannot finish. | Record blocker owner and unblock condition. |
-| archived | Closeout is historical. | Keep archive pointer. |
-
-## Active Closeouts
-
-| ID | Work Item | Owner | Status | Implementation Evidence | Regression Evidence | Review Disposition | Walkthrough | Lessons Check | Harness Ledger | Residual | Updated |
-| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
-| CO-YYYY-MM-DD-001 | F-000 or D-000 title | owner | [open / closed / blocked] | path or pending | RG-000 or pending | pending | pending | pending | HL-000 | none | YYYY-MM-DD |
-
-## Release-Blocking Residuals
-
-| Residual | Source | Owner | Blocks Release? | Decision | Due |
-| --- | --- | --- | --- | --- | --- |
-| risk or unresolved finding | review, regression, or walkthrough | owner | yes / no | fix, accept, defer, or waive | YYYY-MM-DD |
-
-## Routing Rules
-
-1. Every shipped feature, delivery, release, and harness update needs a closeout row.
-2. Move to `closed` only after walkthrough, regression evidence, review disposition, lessons check, and Harness Ledger link are complete.
-3. `not run` verification is a residual, not a pass.
-4. Release-blocking residuals must stay visible until fixed, accepted by an owner, or moved to a follow-up with a due date.
-5. Closeout rows should link durable files rather than summarize chat decisions.
-
-## Archive Rules
-
-- Keep open, evidence, review, closing, and blocked rows in this file.
-- Archive closed rows after the next release or maintenance cycle.
-- Preserve final evidence, walkthrough, lessons check, residual decision, and archive date.

package/templates-zh-CN/walkthrough/Closeout-SSoT.md

@@ -1,42 +0,0 @@
-# 收口 SSoT - [项目名称]
-
-> 任务收口证据的单一事实源。每个已关闭的 Harness Ledger 行都必须在这里有对应记录。
-
-## 活跃收口
-
-| Harness ID | 日期 | 任务 | 任务计划 | 审查报告 | 收口记录 | 证据 | 残余路由 | Lessons 检查 | 收口状态 |
-| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
-| HL-YYYY-MM-DD-001 | YYYY-MM-DD | [任务名称] | `docs/09-PLANNING/TASKS/[task]/task_plan.md` | `review.md` / `n/a: [原因]` | `docs/10-WALKTHROUGH/[file].md` / 允许的跳过原因 | [测试、命令、review、运行时证据] | `none` / [负责人 + 路由] | `checked-created: L-YYYY-MM-DD-001` / `checked-none: [原因]` | [open / closed / blocked] |
-
-## 允许的 walkthrough 跳过原因
-
-- `walkthrough skipped-with-reason: docs-only`
-- `walkthrough skipped-with-reason: no-runtime`
-- `walkthrough skipped-with-reason: superseded`
-- `walkthrough skipped-with-reason: historical-backfill`
-- `walkthrough skipped-with-reason: owner-deferred`
-
-## 状态说明
-
-- `open`：收口材料仍在整理。
-- `closed`：证据、残余和 Lessons 检查已完成。
-- `closed-with-residual`：收口完成，但仍有已路由残余。
-- `blocked`：缺少必要证据或负责人决策，暂不能收口。
-- `superseded`：被后续 closeout 行取代。
-
-## 归档索引
-
-> 活跃收口表超过 50 行，或 release / wave 完成后，将已关闭条目移入 `docs/10-WALKTHROUGH/_archive/Closeout-SSoT-archive-YYYY-QN.md`。
-
-| 归档文件 | 覆盖 Harness ID | 移入日期 | 说明 |
-| --- | --- | --- | --- |
-| `docs/10-WALKTHROUGH/_archive/Closeout-SSoT-archive-YYYY-QN.md` | HL-... 至 HL-... | YYYY-MM-DD | [说明] |
-
-## 路由规则
-
-1. 每个 `closed`、`closed-with-residual` 或 `closed-local-only` 的 Harness Ledger 行都必须在本文件有一行。
-2. 实现类任务应写 walkthrough；跳过原因只用于受限场景，不用于省略收口。
-3. `证据` 必须列出实际检查、冒烟、review、运行时验证或发布证据。
-4. `残余路由` 必须写 `none`，或指向负责人、任务、Regression SSoT、Harness Ledger、issue 或接受风险记录。
-5. `Lessons 检查` 只能写 `checked-candidate: LC-...`、`queued-promotion: LC-...`、`checked-created: L-YYYY-MM-DD-NNN`，或旧任务兼容的 `checked-none: [原因]`。
-6. `checked-created` 必须存在 promoted lesson 详情文档；`queued-promotion` 必须能追溯到任务目录 `lesson_candidates.md`。