coding-agent-harness 1.0.4 → 1.0.6

package/skills/preset-creator/references/preset-package-skeleton.md

@@ -33,7 +33,7 @@ task:
 entrypoints:
   newTask:
     type: template
-    writes: [docs/09-PLANNING/TASKS/**]
+    writes: [docs/coding-agent-harness/planning/tasks/**]
     audit: true
     templates:
       taskPlanAppend: templates/task_plan.append.md
@@ -90,7 +90,7 @@ audit:
   evidenceFiles: [preset-audit.json, preset-manifest.json, write-scope.json]
 writeScopes:
   taskDocs:
-    path: docs/09-PLANNING/TASKS/**
+    path: docs/coding-agent-harness/planning/tasks/**
     access: write
 ```
 
@@ -173,7 +173,7 @@ task:
 entrypoints:
   newTask:
     type: template
-    writes: [docs/09-PLANNING/TASKS/**]
+    writes: [docs/coding-agent-harness/planning/tasks/**]
     audit: true
     templates:
       taskPlanAppend: templates/task_plan.append.md
@@ -196,7 +196,7 @@ audit:
   evidenceFiles: [preset-audit.json, preset-manifest.json, write-scope.json]
 writeScopes:
   taskDocs:
-    path: docs/09-PLANNING/TASKS/**
+    path: docs/coding-agent-harness/planning/tasks/**
     access: write
 ```
 
@@ -267,7 +267,7 @@ Open `references/INDEX.md`, then read these preset-provided references before im
 
 | Reference | Path | Why |
 | --- | --- | --- |
-| REF-001 | TARGET:docs/09-PLANNING/TASKS/<task-folder>/references/upstream-contract.md | [rendered summary] |
+| REF-001 | TARGET:docs/coding-agent-harness/planning/tasks/<task-folder>/references/upstream-contract.md | [rendered summary] |
 ```
 
 The same `REF-001` and exact `TARGET:` path must also appear in `references/INDEX.md`.

package/templates/AGENTS.md.template

@@ -2,7 +2,7 @@
 
 This file is the operating entry point for agents working in this repository.
 Keep it as a charter and routing index. Detailed rules belong in
-`docs/11-REFERENCE/`, not in this file.
+`coding-agent-harness/governance/standards/`, not in this file.
 
 ## Project Profile
 
@@ -14,12 +14,13 @@ Keep it as a charter and routing index. Detailed rules belong in
 
 ## Non-Negotiable Rules
 
-1. Preserve architecture boundaries documented in `docs/11-REFERENCE/engineering-standard.md`.
+1. Preserve architecture boundaries documented in `coding-agent-harness/governance/standards/engineering-standard.md`.
 2. Do not commit secrets, credentials, private endpoints, or user data.
-3. Start non-trivial work with a task directory under `docs/09-PLANNING/TASKS/`.
+3. Start non-trivial work with a Harness CLI-created task directory under `coding-agent-harness/planning/tasks/`.
 4. Record evidence before claiming completion.
 5. Protect unrelated working-tree changes; never revert files outside the assigned scope.
 6. Commit verified, meaningful work slices proactively. Do not leave completed work only as dirty files unless the user explicitly pauses commits, checks fail, dirty ownership is unclear, or a security boundary prevents a clean commit; in those cases record the no-commit reason, owner, and next step in progress, handoff, or closeout notes. Never mix unrelated dirty changes into a task commit.
+7. Before the final response, inspect the current task `visual_map.md` gate phase. If the current `Exit Command` has `Actor: agent`, run it or record the blocker. Never run a `human` gate such as `review-confirm` unless the user has explicitly performed or delegated that human confirmation.
 
 ## Reading Matrix
 
@@ -27,28 +28,28 @@ Read the smallest context that can answer the task.
 
 | Work Type | Read First |
 | --- | --- |
-| Architecture or core module change | `docs/11-REFERENCE/engineering-standard.md` |
-| System map, service responsibility, or external system relationship | `docs/03-ARCHITECTURE/README.md`, `docs/03-ARCHITECTURE/service-catalog.md` |
-| Local development, mocks, stubs, or cross-repo debugging | `docs/04-DEVELOPMENT/README.md`, `docs/04-DEVELOPMENT/codebase-map.md` |
-| API, event, webhook, SDK, or third-party contract | `docs/06-INTEGRATIONS/README.md` and the related contract file |
-| Tests, smoke, or regression | `docs/11-REFERENCE/testing-standard.md`, `docs/05-TEST-QA/Regression-SSoT.md` |
-| Execution, commit, PR, or release work | `docs/11-REFERENCE/execution-workflow-standard.md`, `docs/11-REFERENCE/repo-governance-standard.md`, `docs/11-REFERENCE/pull-request-standard.md`, `docs/11-REFERENCE/ci-cd-standard.md` |
-| Creating or advancing a task | Current task directory under `docs/09-PLANNING/TASKS/`; use the Harness CLI if this project has it configured |
+| Architecture or core module change | `coding-agent-harness/governance/standards/engineering-standard.md` |
+| System map, service responsibility, or external system relationship | `coding-agent-harness/context/architecture/README.md`, `coding-agent-harness/context/architecture/service-catalog.md` |
+| Local development, mocks, stubs, or cross-repo debugging | `coding-agent-harness/context/development/README.md`, `coding-agent-harness/context/development/codebase-map.md` |
+| API, event, webhook, SDK, or third-party contract | `coding-agent-harness/context/integrations/README.md` and the related contract file |
+| Tests, smoke, or regression | `coding-agent-harness/governance/standards/testing-standard.md`, `coding-agent-harness/governance/regression/Regression-SSoT.md` |
+| Execution, commit, PR, or release work | `coding-agent-harness/governance/standards/execution-workflow-standard.md`, `coding-agent-harness/governance/standards/repo-governance-standard.md`, `coding-agent-harness/governance/standards/pull-request-standard.md`, `coding-agent-harness/governance/standards/ci-cd-standard.md` |
+| Creating or advancing a task | Current task directory under `coding-agent-harness/planning/tasks/`; use `harness new-task` / lifecycle commands when this project has the Harness CLI configured |
 | Brief, Execution Strategy, or Visual Map | Current task `brief.md`, `execution_strategy.md`, and `visual_map.md` |
-| Long-running task | `docs/11-REFERENCE/long-running-task-standard.md` |
-| Reviewer, subagent, or adversarial review | `docs/11-REFERENCE/review-routing-standard.md`, `docs/11-REFERENCE/adversarial-review-standard.md` |
-| Team, multi-repo, or staged delivery | `docs/11-REFERENCE/delivery-operating-model-standard.md`, `docs/09-PLANNING/Delivery-SSoT.md` |
-| Module-parallel work | `docs/09-PLANNING/Module-Registry.md` and the related module plan |
-| Documentation governance or Harness update | `docs/11-REFERENCE/docs-library-standard.md`, `.harness-capabilities.json` |
-| External source material intake | `docs/11-REFERENCE/external-source-intake-standard.md` |
-| Regression SSoT maintenance | `docs/11-REFERENCE/regression-ssot-governance.md` |
-| Walkthrough, closeout, or lessons | `docs/11-REFERENCE/walkthrough-standard.md`, `docs/10-WALKTHROUGH/Closeout-SSoT.md`, current task `lesson_candidates.md`, `docs/01-GOVERNANCE/lessons/` |
-| Worktree operations | `docs/11-REFERENCE/worktree-standard.md` |
+| Long-running task | Current task `long-running-task-contract.md` when present |
+| Reviewer, subagent, or adversarial review | Current task `review.md`, `coding-agent-harness/governance/standards/review-routing-standard.md` |
+| Team, multi-repo, or staged delivery | `coding-agent-harness/governance/standards/delivery-operating-model-standard.md`, `coding-agent-harness/planning/Delivery-SSoT.md` |
+| Module-parallel work | `coding-agent-harness/planning/modules/Module-Registry.md` and the related module plan |
+| Documentation governance or Harness update | `coding-agent-harness/governance/standards/docs-library-standard.md`, `coding-agent-harness/harness.yaml` |
+| External source material intake | `coding-agent-harness/governance/standards/external-source-intake-standard.md` |
+| Regression SSoT maintenance | `coding-agent-harness/governance/standards/regression-ssot-governance.md` |
+| Walkthrough, closeout, or lessons | `coding-agent-harness/governance/standards/walkthrough-standard.md`, current task `walkthrough.md`, current task `lesson_candidates.md`, `coding-agent-harness/governance/lessons/` |
+| Worktree operations | `coding-agent-harness/governance/standards/worktree-standard.md` |
 
 ## Standard Execution Flow
 
 1. Confirm the request, scope, and affected files.
-2. For non-trivial work, create or update the task plan before editing code.
+2. For non-trivial work, create or update the task plan before editing code. Use `harness new-task`; if the CLI is unavailable, keep Task Audit Metadata in the task `INDEX.md` and set `Created By` to `manual-exception` with a concrete reason.
 3. Assess delegation from the user's goal; users do not need to know or ask for subagents.
 4. Load only the reference documents required by the Reading Matrix.
 5. Preserve existing project facts; merge new context instead of overwriting history.
@@ -56,8 +57,9 @@ Read the smallest context that can answer the task.
 7. Implement only within the approved scope.
 8. Run the relevant checks and capture evidence in the task records.
 9. Route required review and close blocking findings.
-10. Write or update the walkthrough and closeout records.
-11. Update SSoT / ledger files that the task actually touched.
+10. Follow the current `visual_map.md` lifecycle gate and its `Exit Command` / `Actor`.
+11. Write or update the walkthrough and closeout records.
+12. Update SSoT / ledger files that the task actually touched.
 
 ## Coordination Rules
 
@@ -71,14 +73,14 @@ Read the smallest context that can answer the task.
 
 ## Single Sources Of Truth
 
-- Delivery SSoT: `docs/09-PLANNING/Delivery-SSoT.md`
-- Module Registry: `docs/09-PLANNING/Module-Registry.md`
-- Regression SSoT: `docs/05-TEST-QA/Regression-SSoT.md`
-- Cadence Ledger: `docs/05-TEST-QA/Cadence-Ledger.md`
+- Delivery SSoT: `coding-agent-harness/planning/Delivery-SSoT.md`
+- Module Registry: `coding-agent-harness/planning/modules/Module-Registry.md`
+- Regression SSoT: `coding-agent-harness/governance/regression/Regression-SSoT.md`
+- Cadence Ledger: `coding-agent-harness/governance/regression/Cadence-Ledger.md`
 - Lesson Candidates: current task `lesson_candidates.md`
-- Lesson Detail Docs: `docs/01-GOVERNANCE/lessons/`
-- Closeout SSoT: `docs/10-WALKTHROUGH/Closeout-SSoT.md`
-- Harness Ledger: `docs/Harness-Ledger.md`
+- Lesson Detail Docs: `coding-agent-harness/governance/lessons/`
+- Generated Closeout Index: `coding-agent-harness/governance/generated/Closeout-Index.md`
+- Harness Ledger: `coding-agent-harness/governance/generated/Harness-Ledger.md`
 
 ## Local Commands
 

package/templates/architecture/README.md

@@ -22,8 +22,8 @@ This folder is the system-structure source of truth. It explains what the curren
 ## Boundary
 
 - Put system structure, service responsibility, ownership, and critical flows here.
-- Put payload bodies, endpoint parameters, event schemas, and SDK details in `docs/06-INTEGRATIONS/`.
-- Put local setup, mocks, stubs, and cross-repo debugging notes in `docs/04-DEVELOPMENT/`.
+- Put payload bodies, endpoint parameters, event schemas, and SDK details in `coding-agent-harness/context/integrations/`.
+- Put local setup, mocks, stubs, and cross-repo debugging notes in `coding-agent-harness/context/development/`.
 
 ## Structure Contract
 
@@ -44,6 +44,6 @@ Each `services/<service-key>.md` answers only three questions:
 
 1. What does this service own, including data ownership.
 2. How does it relate to this repository.
-3. Which `04-DEVELOPMENT` and `06-INTEGRATIONS` docs must an agent read before changing this repository.
+3. Which `context/development` and `context/integrations` docs must an agent read before changing this repository.
 
-Do not put interface fields, mock instructions, or temporary debugging notes in `03-ARCHITECTURE`. Those belong in `06-INTEGRATIONS` and `04-DEVELOPMENT`.
+Do not put interface fields, mock instructions, or temporary debugging notes in `context/architecture`. Those belong in `context/integrations` and `context/development`.

package/templates/architecture/service-catalog.md

@@ -12,6 +12,6 @@ Confidence: low
 
 ## Boundary Rule
 
-This catalog gives interface summaries and links only. Put payload bodies, auth rules, error codes, and event schemas in `docs/06-INTEGRATIONS/`.
+This catalog gives interface summaries and links only. Put payload bodies, auth rules, error codes, and event schemas in `coding-agent-harness/context/integrations/`.
 
-Each service or microservice gets one row. If the service affects development or task decisions in this repository, add links to `services/<service-key>.md`, `docs/04-DEVELOPMENT/external-context/<service-key>.md`, and the relevant `docs/06-INTEGRATIONS/<contract>.md`.
+Each service or microservice gets one row. If the service affects development or task decisions in this repository, add links to `services/<service-key>.md`, `coding-agent-harness/context/development/external-context/<service-key>.md`, and the relevant `coding-agent-harness/context/integrations/<contract>.md`.

package/templates/architecture/services/service-template.md

@@ -9,7 +9,7 @@ Confidence: low
 
 | Catalog Row | Development Context | Source Pack | Integration Contracts | Last Verified | Confidence |
 | --- | --- | --- | --- | --- | --- |
-| `docs/03-ARCHITECTURE/service-catalog.md` | `docs/04-DEVELOPMENT/external-context/<service-key>.md` | `docs/04-DEVELOPMENT/external-source-packs/<source-key>/README.md` or N/A | `docs/06-INTEGRATIONS/<contract>.md` | unknown | low |
+| `coding-agent-harness/context/architecture/service-catalog.md` | `coding-agent-harness/context/development/external-context/<service-key>.md` | `coding-agent-harness/context/development/external-source-packs/<source-key>/README.md` or N/A | `coding-agent-harness/context/integrations/<contract>.md` | unknown | low |
 
 ## Responsibility
 

package/templates/dashboard/assets/app-src/00-state.js

@@ -12,6 +12,18 @@ const state = {
   taskGroupPage: 1,
   warningFilter: "all",
   warningPage: 1,
+  presetQuery: "",
+  presetSourceFilter: "all",
+  selectedPresetKey: "",
+  selectedPresetId: "",
+  presetActionResult: null,
+  presetInstallSource: "",
+  presetInstallScope: "project",
+  presetInstallForce: false,
+  presetSeedScope: "project",
+  presetSeedForce: false,
+  presetUninstallScope: "project",
+  presetUninstallConfirm: "",
   renderMode: "rendered",
   theme: localStorage.getItem("harness.theme") || "system",
   taskLayout: localStorage.getItem("harness.taskLayout") || "list",

package/templates/dashboard/assets/app-src/10-router.js

@@ -29,6 +29,7 @@ function shell() {
         ${routeLink("#/tasks", t("taskIndex"), "tasks")}
         ${routeLink("#/review", t("reviewQueue"), "review")}
         ${routeLink("#/modules", t("moduleView"), "modules")}
+        ${routeLink("#/presets", t("presetCatalog"), "presets")}
         <button data-language-toggle>${locale === "zh" ? "EN" : "中文"}</button>
         <button data-theme-toggle>${themeLabel()}</button>
       </div>
@@ -55,6 +56,7 @@ function renderRoute() {
   if (route.name === "reviewTask") return reviewWorkspace(route);
   if (route.name === "review") return reviewQueue();
   if (route.name === "modules") return modulesView(route.id);
+  if (route.name === "presets") return presetsView();
   if (route.name === "tasks") return taskIndex();
   return overview();
 }
@@ -66,6 +68,7 @@ function currentRoute() {
   if (parts[0] === "review" && parts[1]) return { name: "reviewTask", id: parts[1] };
   if (parts[0] === "review") return { name: "review" };
   if (parts[0] === "modules") return { name: "modules", id: parts[1] || "" };
+  if (parts[0] === "presets") return { name: "presets" };
   if (parts[0] === "tasks") return { name: "tasks" };
   return { name: "overview" };
 }

package/templates/dashboard/assets/app-src/20-overview.js

@@ -16,6 +16,9 @@ function overview() {
 
 function statusStrip() {
   const status = bundle.status?.checkState?.status || "unknown";
+  const validationMode = bundle.status?.checkState?.validationMode || "validated";
+  const snapshotOnly = validationMode === "data-only" && !isWorkbenchRuntime();
+  const displayState = snapshotOnly ? "snapshot" : status;
   const failures = bundle.status?.checkState?.failures || 0;
   const warnings = bundle.status?.checkState?.warnings || 0;
   const tasks = bundle.status?.tasks || [];
@@ -23,9 +26,9 @@ function statusStrip() {
   const visual = summary.visualMapCoverage || {};
   const withBrief = tasks.filter((task) => task.briefSource === "standalone").length;
   return `<section class="status-card-group">
-    <div class="status-primary ${status}">
-      <span>${t("readiness")}</span>
-      <strong>${label(status)}</strong>
+    <div class="status-primary ${displayState}">
+      <span>${snapshotOnly ? t("snapshotStatus") : t("readiness")}</span>
+      <strong>${snapshotOnly ? t("snapshot") : label(status)}</strong>
       <p>${nextActionText()}</p>
     </div>
     <div class="metrics-grid">
@@ -46,15 +49,22 @@ function metric(labelText, value) {
 }
 
 function nextActionText() {
+  const dataOnly = (bundle.status?.checkState?.validationMode || "validated") === "data-only";
+  if (dataOnly && !isWorkbenchRuntime()) return t("snapshotNotValidated");
   const failures = bundle.status?.checkState?.failures || 0;
   if (failures > 0) return t("resolveBlockers");
   const missingBriefs = (bundle.status?.tasks || []).filter((task) => task.briefSource !== "standalone").length;
   if (missingBriefs > 0) return `${missingBriefs} ${t("missingBriefs")}`;
   const warnings = bundle.status?.checkState?.warnings || 0;
   if (warnings > 0) return t("reviewAdvice");
+  if (dataOnly) return t("workbenchDataOnly");
   return t("noBlockers");
 }
 
+function isWorkbenchRuntime() {
+  return window.__HARNESS_WORKBENCH__ === true || state.runtime?.mode === "workbench";
+}
+
 function flowPanel() {
   const tasks = bundle.status?.tasks || [];
   const total = tasks.length;

package/templates/dashboard/assets/app-src/35-task-detail.js

@@ -72,17 +72,57 @@ function taskQueueReasonSummary(task) {
 }
 
 function phaseTimeline(task) {
+  const knownKinds = new Set(["init", "execution", "gate"]);
+  const groups = [
+    ["init", "Init"],
+    ["execution", "Execution"],
+    ["gate", "Gate"],
+    ["other", "Other / Invalid"],
+  ];
+  const phases = task.phases || [];
+  const grouped = groups
+    .map(([kind, label]) => {
+      const items = kind === "other"
+        ? phases.filter((phase) => !knownKinds.has(phase.kind || "execution"))
+        : phases.filter((phase) => (phase.kind || "execution") === kind);
+      if (!items.length) return "";
+      return `<div class="phase-kind-group ${escapeAttr(kind)}">
+        <h3>${escapeHtml(label)}</h3>
+        ${items.map(phaseStep).join("")}
+      </div>`;
+    })
+    .join("");
   return `<section class="phase-timeline">
     <h2>${t("phaseTimeline")}</h2>
-    ${(task.phases || []).map((phase) => `<div class="phase-step ${phase.state}">
-      <strong>${escapeHtml(phase.id)}</strong>
-      <span>${phase.completion}%</span>
-      <p>${escapeHtml(phase.output || phase.blockingRisk || phase.state)}</p>
-      ${progressBar(phase.completion)}
-    </div>`).join("") || emptyState(t("noPhaseData"))}
+    ${grouped || emptyState(t("noPhaseData"))}
   </section>`;
 }
 
+function phaseStep(phase) {
+  const kind = phase.kind || "execution";
+  const actor = phase.actor || "agent";
+  const knownKind = ["init", "execution", "gate"].includes(kind);
+  const kindLabel = knownKind ? escapeHtml(kind) : `<span class="tag warn">${escapeHtml(kind)}</span>`;
+  const phaseKindClass = knownKind ? kind : "other";
+  return `<div class="phase-step ${escapeAttr(phase.state)} ${escapeAttr(phaseKindClass)}">
+    <div class="phase-step-head">
+      <strong>${escapeHtml(phase.id)}</strong>
+      <span>${kindLabel} · ${phase.completion}%</span>
+    </div>
+    <p>${escapeHtml(phase.output || phase.blockingRisk || phase.state)}</p>
+    ${progressBar(phase.completion)}
+    <div class="phase-meta">
+      ${phaseMetaTag(actor)}
+      ${tag(phase.evidenceStatus || "missing")}
+    </div>
+    ${phase.exitCommand ? `<code class="phase-exit-command">${escapeHtml(phase.exitCommand)}</code>` : ""}
+  </div>`;
+}
+
+function phaseMetaTag(value) {
+  return `<span class="tag">${escapeHtml(String(value || "unknown").replaceAll("_", " "))}</span>`;
+}
+
 function taskDocSection(task, fileName, title, required) {
   const doc = taskDocument(task, fileName);
   if (!doc && !required) return "";

package/templates/dashboard/assets/app-src/40-modules.js

@@ -35,7 +35,7 @@ function moduleCard(module) {
   const pageCount = Math.ceil(tasks.length / 8) || 1;
   const visibleTasks = tasks.slice((currentPage - 1) * 8, currentPage * 8);
 
-  const brief = findDocument(`TARGET:docs/09-PLANNING/MODULES/${moduleKey}/brief.md`);
+  const brief = findDocument(module.briefPath || `TARGET:coding-agent-harness/planning/modules/${moduleKey}/brief.md`);
 
   let pagerHtml = "";
   if (tasks.length > 8) {