coding-agent-harness 1.0.6 → 1.0.8

package/presets/release-closeout/scripts/generate-release-package.mjs

@@ -0,0 +1,210 @@
+#!/usr/bin/env node
+
+import fs from "node:fs";
+import path from "node:path";
+
+const context = JSON.parse(fs.readFileSync(process.env.HARNESS_PRESET_CONTEXT, "utf8"));
+const release = safeRelease(context.inputs.release);
+if (!release) {
+  console.error("release-closeout requires inputs.release");
+  process.exit(2);
+}
+
+const tasksRoot = path.join(context.targetRoot, "coding-agent-harness/planning/tasks");
+const releaseRoot = path.join(context.outputRoot, "release");
+fs.mkdirSync(releaseRoot, { recursive: true });
+
+const tasks = collectTasks(tasksRoot)
+  .filter((task) => task.id !== context.task.id && task.preset !== "release-closeout")
+  .sort((a, b) => a.id.localeCompare(b.id));
+const eligibleArchive = tasks.filter((task) => task.state === "done" && task.deletionState !== "superseded");
+const blockedArchive = tasks.filter((task) => task.state === "blocked" || task.queue === "blocked");
+
+const aggregate = {
+  schemaVersion: "release-closeout-aggregate/v1",
+  release,
+  generatedAt: new Date().toISOString(),
+  summary: {
+    totalTasks: tasks.length,
+    doneTasks: tasks.filter((task) => task.state === "done").length,
+    blockedTasks: tasks.filter((task) => task.state === "blocked").length,
+    archiveEligibleTasks: eligibleArchive.length,
+  },
+  tasks: tasks.map((task) => ({
+    id: task.id,
+    title: task.title,
+    state: task.state,
+    preset: task.preset || "none",
+    deletionState: task.deletionState,
+    archiveEligible: eligibleArchive.some((candidate) => candidate.id === task.id),
+    archiveBlockedReason: task.state === "blocked" ? "blocked tasks cannot be archived" : "",
+  })),
+};
+
+const index = `# Release Closeout Package: ${release}
+
+Generated by \`presets/release-closeout\` through the generic preset runner.
+
+| Document | Purpose |
+| --- | --- |
+| \`task-aggregate.json\` | Machine-readable task inventory for this release closeout. |
+| \`task-archive-plan.md\` | Preset-owned archive eligibility plan. |
+| \`public-summary.md\` | Redacted public-facing summary. |
+| \`public-redaction-report.json\` | Redaction evidence for public materialization. |
+
+## Summary
+
+- Total tasks: ${aggregate.summary.totalTasks}
+- Done tasks: ${aggregate.summary.doneTasks}
+- Blocked tasks: ${aggregate.summary.blockedTasks}
+- Archive eligible tasks: ${aggregate.summary.archiveEligibleTasks}
+`;
+
+const archivePlan = `# Release ${release} Task Archive Plan
+
+This plan is generated by the release-closeout preset. It does not archive tasks by itself.
+
+## Eligible Tasks
+
+${eligibleArchive.length ? eligibleArchive.map((task) => `- ${task.id} - ${task.title}`).join("\n") : "- none"}
+
+## Not Eligible
+
+${blockedArchive.length ? blockedArchive.map((task) => `- ${task.id} - blocked tasks cannot be archived`).join("\n") : "- none"}
+`;
+
+const publicSummaryRaw = `# Release ${release} Public Summary
+
+This release closeout aggregates ${aggregate.summary.totalTasks} tasks, including ${aggregate.summary.doneTasks} done tasks and ${aggregate.summary.blockedTasks} blocked tasks.
+
+Recent evidence snippets:
+
+${tasks.slice(0, 20).map((task) => `- ${task.id}: ${task.evidenceSnippet || "no evidence snippet"}`).join("\n")}
+`;
+const publicSummary = redactPublic(publicSummaryRaw);
+const redactionReport = {
+  schemaVersion: "public-redaction-report/v1",
+  status: leaksLocalPath(publicSummary) ? "fail" : "pass",
+  rules: ["local-absolute-paths", "file-urls"],
+  checkedFiles: ["public-summary.md"],
+  findings: leaksLocalPath(publicSummary) ? ["public-summary contains local absolute path"] : [],
+  generatedAt: new Date().toISOString(),
+};
+if (redactionReport.status !== "pass") {
+  console.error("public redaction failed");
+  process.exit(3);
+}
+
+write("INDEX.md", index);
+write("task-archive-plan.md", archivePlan);
+write("task-aggregate.json", `${JSON.stringify(aggregate, null, 2)}\n`);
+write("public-summary.md", publicSummary);
+write("public-redaction-report.json", `${JSON.stringify(redactionReport, null, 2)}\n`);
+
+const destinationRoot = `coding-agent-harness/governance/releases/${release}`;
+fs.writeFileSync(context.materializationManifestPath, `${JSON.stringify({
+  schemaVersion: "preset-materialization/v1",
+  status: "ok",
+  publicRedactionReport: { source: "release/public-redaction-report.json" },
+  writes: [
+    { source: "release/INDEX.md", destination: `${destinationRoot}/INDEX.md`, type: "text" },
+    { source: "release/task-archive-plan.md", destination: `${destinationRoot}/task-archive-plan.md`, type: "text" },
+    { source: "release/task-aggregate.json", destination: `${destinationRoot}/task-aggregate.json`, type: "json" },
+    { source: "release/public-summary.md", destination: `${destinationRoot}/public-summary.md`, type: "text", visibility: "public" },
+    { source: "release/public-redaction-report.json", destination: `${destinationRoot}/public-redaction-report.json`, type: "json" },
+  ],
+}, null, 2)}\n`);
+
+function write(name, content) {
+  fs.writeFileSync(path.join(releaseRoot, name), content.endsWith("\n") ? content : `${content}\n`);
+}
+
+function collectTasks(root) {
+  if (!fs.existsSync(root)) return [];
+  const taskPlans = walk(root).filter((file) => path.basename(file) === "task_plan.md");
+  return taskPlans.map((taskPlanPath) => {
+    const taskDir = path.dirname(taskPlanPath);
+    const taskPlan = read(taskPlanPath);
+    const progress = read(path.join(taskDir, "progress.md"));
+    const tombstone = parseTombstone(taskPlan);
+    return {
+      id: path.basename(taskDir),
+      title: titleFrom(taskPlan, path.basename(taskDir)),
+      preset: metadataLine(taskPlan, ["Task Preset", "Preset"]).toLowerCase(),
+      state: parseState(progress),
+      deletionState: tombstone.state || "active",
+      queue: parseState(progress) === "blocked" ? "blocked" : "active",
+      evidenceSnippet: progress.split(/\r?\n/).find((line) => /\/Users\/|\/Volumes\/|file:\/\//.test(line)) || "",
+      tombstone,
+    };
+  });
+}
+
+function walk(root) {
+  const files = [];
+  for (const entry of fs.readdirSync(root, { withFileTypes: true })) {
+    const full = path.join(root, entry.name);
+    if (entry.isDirectory()) files.push(...walk(full));
+    else if (entry.isFile()) files.push(full);
+  }
+  return files;
+}
+
+function read(filePath) {
+  try {
+    return fs.readFileSync(filePath, "utf8");
+  } catch {
+    return "";
+  }
+}
+
+function titleFrom(content, fallback) {
+  const match = String(content || "").match(/^#\s+(.+)$/m);
+  return match ? match[1].trim() : fallback;
+}
+
+function metadataLine(content, labels) {
+  const escaped = labels.map((label) => label.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")).join("|");
+  const match = String(content || "").match(new RegExp(`^(?:${escaped})\\s*[:：]\\s*([^\\n]+)`, "im"));
+  return match ? match[1].replace(/`/g, "").trim() : "";
+}
+
+function parseState(progress) {
+  const match = String(progress || "").match(/^##\s*(?:Current Status|Status|状态)\s*[:：]?\s*(?:\n\s*)?([^\n]+)/im);
+  const raw = (match ? match[1] : "").trim().toLowerCase().replaceAll("-", "_").replaceAll(" ", "_");
+  return ["not_started", "planned", "in_progress", "review", "blocked", "done"].includes(raw) ? raw : "unknown";
+}
+
+function parseTombstone(content) {
+  const match = String(content || "").match(/^##\s*(?:Task Tombstone|任务墓碑)\s*$([\s\S]*?)(?=^##\s+|(?![\s\S]))/im);
+  if (!match) return { state: "active", fields: {} };
+  const fields = {};
+  for (const line of match[1].split(/\r?\n/)) {
+    const row = line.trim();
+    if (!row.startsWith("|") || /---/.test(row) || /Field\s*\|\s*Value/i.test(row)) continue;
+    const cells = row.slice(1, -1).split("|").map((cell) => cell.trim().toLowerCase());
+    if (cells.length >= 2) fields[cells[0]] = cells.slice(1).join("|").trim();
+  }
+  return { state: fields.state || "soft-deleted", fields };
+}
+
+function safeRelease(value) {
+  const release = String(value || "").trim();
+  return /^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$/.test(release) ? release : "";
+}
+
+function redactPublic(value) {
+  return String(value || "")
+    .replace(/file:\/\/\/[^\s)"'`<>\]]+/g, "LOCAL_FILE_URL_REDACTED")
+    .replaceAll("file://", "LOCAL_FILE_URL_REDACTED")
+    .replace(/\/Users\/[^/\s)"'`<>\]]+(?:\/[^\s)"'`<>\]]*)*/g, "LOCAL_PATH_REDACTED")
+    .replace(/\/Volumes\/[^\s)"'`<>\]]+(?:\/[^\s)"'`<>\]]*)*/g, "LOCAL_PATH_REDACTED")
+    .replace(/\/(?:private\/)?tmp\/[^\s)"'`<>\]]+(?:\/[^\s)"'`<>\]]*)*/g, "LOCAL_PATH_REDACTED")
+    .replace(/\/var\/folders\/[^\s)"'`<>\]]+(?:\/[^\s)"'`<>\]]*)*/g, "LOCAL_PATH_REDACTED")
+    .replace(/\/home\/[^/\s)"'`<>\]]+(?:\/[^\s)"'`<>\]]*)*/g, "LOCAL_PATH_REDACTED")
+    .replace(/[A-Za-z]:\\[^\s)"'`<>\]]+(?:\\[^\s)"'`<>\]]*)*/g, "LOCAL_PATH_REDACTED");
+}
+
+function leaksLocalPath(value) {
+  return /(?:^|[\s"'(])(?:\/Users\/|\/Volumes\/|\/tmp\/|\/private\/tmp\/|\/var\/folders\/|\/home\/|[A-Za-z]:\\|file:\/\/)/.test(String(value || ""));
+}

package/presets/release-closeout/templates/execution_strategy.append.md

@@ -0,0 +1,7 @@
+## Release Closeout Strategy
+
+| Phase ID | Depends On | State | Completion | Output | Required Evidence | Evidence Status | Blocking Risk | Owner / Handoff |
+| --- | --- | --- | ---: | --- | --- | --- | --- | --- |
+| RC-PLAN | none | planned | 0 | Release task inventory and archive eligibility plan | `harness preset run release-closeout plan --task {{taskId}} .` | missing | none | coordinator |
+| RC-SCAFFOLD | RC-PLAN | planned | 0 | Version package materialized under governance releases | `harness preset run release-closeout scaffold --task {{taskId}} .` | missing | none | coordinator |
+| RC-CHECK | RC-SCAFFOLD | planned | 0 | Release package validation report | `harness preset run release-closeout check --task {{taskId}} .` | missing | none | coordinator |

package/presets/release-closeout/templates/findings.seed.md

@@ -0,0 +1,5 @@
+## Release Closeout Findings
+
+| Severity | Finding | Open | Blocks Release | Disposition | Waiver By |
+| --- | --- | --- | --- | --- | --- |
+| P2 | Release package has not been generated yet. | yes | no | pending `release-closeout scaffold` | n/a |

package/presets/release-closeout/templates/review.seed.md

@@ -0,0 +1,3 @@
+## Release Closeout Review
+
+Review the generated release package, archive plan, and public redaction report before marking this task complete.

package/presets/release-closeout/templates/task_plan.append.md

@@ -0,0 +1,24 @@
+## Release Closeout
+
+Release Version: {{release}}
+Previous Release: {{previousRelease}}
+Next Release: {{nextRelease}}
+Task Query: {{taskQuery}}
+
+## Release Package Workflow
+
+Run these preset entrypoints from the target root. The task scaffold only records the release intent; version package files are generated by the generic preset runner.
+
+1. `harness preset run release-closeout plan --task {{taskId}} .`
+2. `harness preset run release-closeout scaffold --task {{taskId}} .`
+3. `harness preset run release-closeout check --task {{taskId}} .`
+
+## Release Package Outputs
+
+| Output | Owner |
+| --- | --- |
+| `coding-agent-harness/governance/releases/{{release}}/INDEX.md` | `presets/release-closeout` |
+| `coding-agent-harness/governance/releases/{{release}}/task-aggregate.json` | `presets/release-closeout` |
+| `coding-agent-harness/governance/releases/{{release}}/task-archive-plan.md` | `presets/release-closeout` |
+| `coding-agent-harness/governance/releases/{{release}}/public-summary.md` | `presets/release-closeout` |
+| `coding-agent-harness/governance/releases/{{release}}/public-redaction-report.json` | `presets/release-closeout` |

package/references/pull-request-standard.md

@@ -25,8 +25,8 @@ The PR body must include:
 
 ## Content Rules
 
-- State the target version explicitly. If `package.json` changes from `1.0.3`
-  to `1.0.4`, say so in Version Impact.
+- State the target version explicitly. If `package.json` changes from one
+  version to another, say so in Version Impact.
 - List changed surfaces by user-visible area or module, not by dumping every
   file path.
 - Verification must name the real commands, browser checks, CI runs, or

package/templates/reference/pull-request-standard.md

@@ -25,8 +25,8 @@ then the localized section follows after the English section.
 
 ## Content Rules
 
-- State the target version explicitly. If `package.json` changes from `1.0.3`
-  to `1.0.4`, say so in Version Impact.
+- State the target version explicitly. If `package.json` changes from one
+  version to another, say so in Version Impact.
 - List changed surfaces by user-visible area or module, not by dumping every
   file path.
 - Verification must name the real commands, browser checks, CI runs, or

package/templates-zh-CN/reference/pull-request-standard.md

@@ -20,7 +20,7 @@ PR body 必须包含：
 
 ## 内容规则
 
-- 必须明确目标版本。如果 `package.json` 从 `1.0.2` 变为 `1.0.3`，就在版本影响里写清楚。
+- 必须明确目标版本。如果 `package.json` 从一个版本变为另一个版本，就在版本影响里写清楚。
 - 改动内容按用户可见面或模块总结，不要只堆文件路径。
 - 验证必须列真实命令、浏览器检查、CI run 或证据产物。没有跑的检查必须说明原因。
 - 审查证据必须说明自查、subagent 审查、人工审查或代码质量审查状态。release-blocking finding 必须在 merge 前关闭或路由。