coding-agent-harness 1.0.4 → 1.0.5

package/scripts/lib/task-scanner.mjs

@@ -1,15 +1,13 @@
 import fs from "node:fs";
 import path from "node:path";
 import {
-  allowedTaskStates,
-  allowedTaskBudgets,
   visualMapFile,
   legacyVisualRoadmapFile,
   lessonCandidatesFile,
   longRunningTaskContractFile,
-  taskContractMarker,
   toPosix,
   readFileSafe,
+  readJsonSafe,
   walkFiles,
   titleFromMarkdown,
 } from "./core-shared.mjs";
@@ -19,6 +17,23 @@ import {
   splitList,
   splitDependencies,
 } from "./markdown-utils.mjs";
+import {
+  normalizePhaseActor,
+  normalizePhaseKind,
+  phaseCompletionAverage,
+} from "./phase-kind.mjs";
+import {
+  legacyAuditIssues,
+  parseTaskAuditMetadata,
+  scaffoldProvenanceSummaryFromTaskAudit,
+  taskAuditMaterialIssues,
+} from "./task-audit-metadata.mjs";
+import {
+  parseTaskBudget,
+  parseTaskContractInfo,
+  parseTaskMetadata,
+  parseTaskStateInfo,
+} from "./task-metadata.mjs";
 import {
   isLessonCandidateDecisionComplete,
   parseLessonCandidateStatus,
@@ -40,6 +55,13 @@ import {
   taskReviewStatus,
   taskScannerVersion,
 } from "./task-review-model.mjs";
+export {
+  parseTaskBudget,
+  parseTaskContractInfo,
+  parseTaskMetadata,
+  parseTaskState,
+  parseTaskStateInfo,
+} from "./task-metadata.mjs";
 export {
   collectReviewRisks,
   deriveLifecycleState,
@@ -53,6 +75,9 @@ export {
   taskReviewStatus,
   taskScannerVersion,
 } from "./task-review-model.mjs";
+export {
+  parseTaskAuditMetadata,
+} from "./task-audit-metadata.mjs";
 export {
   allowedLessonCandidateRowStatuses,
   allowedLessonCandidateTaskStatuses,
@@ -61,139 +86,33 @@ export {
   reviewCompleteLessonCandidateStatuses,
 } from "./task-lesson-candidates.mjs";
 
-export function parseTaskState(progressContent) {
-  return parseTaskStateInfo(progressContent).state;
-}
-
-export function parseTaskBudget(taskPlanContent) {
-  const match =
-    String(taskPlanContent || "").match(/^Selected budget\s*[:：]\s*([^\n]+)/im) ||
-    String(taskPlanContent || "").match(/^选择预算\s*[:：]\s*([^\n]+)/im);
-  if (!match) return "standard";
-  const raw = match[1].replace(/`/g, "").trim().toLowerCase();
-  const normalized = raw.replaceAll("_", "-").replace(/\s+/g, "-");
-  if (allowedTaskBudgets.has(normalized)) return normalized;
-  if (["long-running", "longrunning", "module-parallel"].includes(normalized)) return "complex";
-  return "standard";
-}
-
-function parseMetadataLine(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 normalizeMetadataValue(value, fallback = "") {
-  const normalized = String(value || "")
-    .replace(/`/g, "")
-    .trim()
-    .toLowerCase()
-    .replaceAll("_", "-")
-    .replace(/\s+/g, "-");
-  return normalized || fallback;
-}
-
-export function parseTaskMetadata(taskPlanContent) {
-  const content = String(taskPlanContent || "");
-  const kind = normalizeMetadataValue(parseMetadataLine(content, ["Task Kind", "任务类型"]), "general");
-  const preset = normalizeMetadataValue(parseMetadataLine(content, ["Task Preset", "Preset", "任务预设"]), "none");
-  const presetVersion = parseMetadataLine(content, ["Preset Version", "预设版本"]);
-  const migrationTargetLevel = normalizeMetadataValue(
-    parseMetadataLine(content, ["Migration Target Level", "Target Level", "迁移目标等级", "目标等级"]),
-    "",
-  );
-  const migrationAchievedLevel = normalizeMetadataValue(
-    parseMetadataLine(content, ["Migration Achieved Level", "Achieved Level", "迁移实际完成等级", "实际完成等级"]),
-    "",
-  );
-  const evidenceBundle = parseMetadataLine(content, ["Evidence Bundle", "证据包"]);
-  return {
-    kind,
-    preset,
-    presetVersion,
-    migrationTargetLevel,
-    migrationAchievedLevel,
-    evidenceBundle,
-  };
-}
-
-export function parseTaskContractInfo(taskPlanContent) {
-  const content = String(taskPlanContent || "");
-  const explicit =
-    content.match(/^Task Contract\s*[:：]\s*`?([^`\n]+)`?\s*$/im) ||
-    content.match(/^任务合同\s*[:：]\s*`?([^`\n]+)`?\s*$/im);
-  const version = explicit ? explicit[1].trim() : "";
-  return {
-    version,
-    generated: version === "harness-task/v1" || content.includes(taskContractMarker),
-  };
-}
-
-export function parseTaskStateInfo(progressContent) {
-  const match = progressContent.match(/^##\s*(?:Current Status|Status|状态)\s*[:：]?\s*(?:\n\s*)?([^\n]+)/im);
-  if (!match) return inferLegacyTaskState(progressContent);
-  const raw = match[1].replace(/`/g, "").trim();
-  if (!raw || raw.includes("|") || /^[-*]\s+/.test(raw)) return inferLegacyTaskState(progressContent);
-  const aliases = new Map([
-    ["进行中", "in_progress"],
-    ["已完成", "done"],
-    ["未开始", "not_started"],
-    ["计划中", "planned"],
-    ["审查中", "review"],
-    ["已阻塞", "blocked"],
-    ["pending", "planned"],
-  ]);
-  const normalized = aliases.get(raw) || raw.toLowerCase().replaceAll("-", "_").replaceAll(" ", "_");
-  return allowedTaskStates.has(normalized)
-    ? { state: normalized, source: "explicit", raw }
-    : { state: "unknown", source: "invalid", raw };
-}
-
-function inferLegacyTaskState(progressContent) {
-  const { header, rows } = tableAfterHeading(progressContent, /^(Status|状态)$/i);
-  const statusIndex = firstColumn(header, ["Status", "状态"]);
-  if (statusIndex < 0 || rows.length === 0) return { state: "unknown", source: "missing", raw: "" };
-  const states = rows.map((row) => normalizeLegacyState(row[statusIndex])).filter(Boolean);
-  if (states.includes("blocked")) return { state: "blocked", source: "legacy-table", raw: "blocked" };
-  if (states.includes("in_progress")) return { state: "in_progress", source: "legacy-table", raw: "in_progress" };
-  if (states.includes("review")) return { state: "review", source: "legacy-table", raw: "review" };
-  if (states.length > 0 && states.every((state) => state === "done")) return { state: "done", source: "legacy-table", raw: "done" };
-  if (states.some((state) => ["planned", "not_started"].includes(state))) return { state: "planned", source: "legacy-table", raw: "planned" };
-  return { state: "unknown", source: "missing", raw: "" };
-}
-
-function normalizeLegacyState(value) {
-  const raw = String(value || "").replace(/`/g, "").trim().toLowerCase();
-  if (!raw || /^(none|n\/a|na|-|—|–|无)$/.test(raw)) return "";
-  if (/block|阻塞|blocked/.test(raw)) return "blocked";
-  if (/in[-_\s]?progress|doing|active|进行中|当前|working/.test(raw)) return "in_progress";
-  if (/review|审查|审核|验证中/.test(raw)) return "review";
-  if (/done|complete|completed|merged|closed|完成|已完成/.test(raw)) return "done";
-  if (/pending|planned|todo|not[-_\s]?started|未开始|计划/.test(raw)) return "planned";
-  return "";
-}
-
 export function parsePhases(taskPlanContent) {
   const { header, rows } = tableAfterHeading(taskPlanContent, /^Phase ID$/i);
   if (rows.length === 0) return [];
   const indexes = {
     id: firstColumn(header, ["Phase ID", "阶段 ID"]),
+    kind: firstColumn(header, ["Kind", "阶段类型", "类型"]),
     dependsOn: firstColumn(header, ["Depends On", "依赖"]),
     state: firstColumn(header, ["State", "状态"]),
     completion: firstColumn(header, ["Completion", "完成度"]),
     output: firstColumn(header, ["Output", "产出"]),
     requiredEvidence: firstColumn(header, ["Required Evidence", "必要证据"]),
+    exitCommand: firstColumn(header, ["Exit Command", "出口命令", "退出命令"]),
+    actor: firstColumn(header, ["Actor", "执行者", "角色"]),
     evidenceStatus: firstColumn(header, ["Evidence Status", "证据状态"]),
     blockingRisk: firstColumn(header, ["Blocking Risk", "阻塞风险"]),
     owner: firstColumn(header, ["Owner / Handoff", "负责人 / 交接"]),
   };
   return rows.map((row) => ({
     id: row[indexes.id] || "",
+    kind: normalizePhaseKind(row[indexes.kind]),
     dependsOn: splitDependencies(row[indexes.dependsOn] || ""),
     state: row[indexes.state] || "planned",
     completion: Number.parseInt(String(row[indexes.completion] || "0").replace("%", ""), 10) || 0,
     output: row[indexes.output] || "",
     requiredEvidence: splitList(row[indexes.requiredEvidence] || ""),
+    exitCommand: row[indexes.exitCommand] || "",
+    actor: normalizePhaseActor(row[indexes.actor]),
     evidenceStatus: row[indexes.evidenceStatus] || "missing",
     blockingRisk: row[indexes.blockingRisk] || "",
     owner: row[indexes.owner] || "",
@@ -310,12 +229,15 @@ export function taskCutoverCounters(tasks) {
   };
 }
 
-export function collectTasks(target) {
-  return listTaskPlanPaths(target).map((taskPlanPath) => {
+export function collectTasks(target, { requireGeneratedScaffoldProvenance = false, taskPlanPaths, closeoutContent } = {}) {
+  const paths = taskPlanPaths || listTaskPlanPaths(target);
+  const closeout = closeoutContent ?? readFileSafe(path.join(target.docsRoot, "10-WALKTHROUGH/Closeout-SSoT.md"));
+  return paths.map((taskPlanPath) => {
     const taskDir = path.dirname(taskPlanPath);
     const taskPlan = readFileSafe(taskPlanPath);
     const brief = readTaskContractFile(taskDir, "brief.md", "");
     const executionStrategyPath = path.join(taskDir, "execution_strategy.md");
+    const indexPath = path.join(taskDir, "INDEX.md");
     const progressPath = path.join(taskDir, "progress.md");
     const reviewPath = path.join(taskDir, "review.md");
     const findingsPath = path.join(taskDir, "findings.md");
@@ -324,19 +246,14 @@ export function collectTasks(target) {
     const visualMap = readVisualMapContractFile(taskDir, taskPlan);
     const progress = readFileSafe(progressPath);
     const review = readFileSafe(reviewPath);
+    const indexContent = readFileSafe(indexPath);
     const parsedLessonCandidates = parseLessonCandidateStatus(readFileSafe(lessonCandidatesPath));
     const lessonDetailIssues = validateLessonCandidateDetailArtifacts(target, taskDir, parsedLessonCandidates);
     const lessonCandidates = lessonDetailIssues.length
       ? { ...parsedLessonCandidates, issues: [...parsedLessonCandidates.issues, ...lessonDetailIssues] }
       : parsedLessonCandidates;
     const phases = parsePhases(visualMap.content);
-    const completion =
-      phases.length > 0
-        ? Math.round(
-            phases.filter((phase) => phase.state !== "skipped").reduce((sum, phase) => sum + phase.completion, 0) /
-              Math.max(1, phases.filter((phase) => phase.state !== "skipped").length),
-          )
-        : 0;
+    const completion = phaseCompletionAverage(phases);
     const relative = toPosix(path.relative(target.projectRoot, taskDir));
     const id = taskIdForDirectory(target, taskDir);
     const identity = parseTaskIdentity(taskPlan, id);
@@ -346,6 +263,10 @@ export function collectTasks(target) {
     const budget = parseTaskBudget(taskPlan);
     const metadata = parseTaskMetadata(taskPlan);
     const taskContract = parseTaskContractInfo(taskPlan);
+    const taskAudit = parseTaskAuditMetadata(indexContent, {
+      required: requireGeneratedScaffoldProvenance && taskContract.generated,
+    });
+    const scaffoldProvenance = { summary: scaffoldProvenanceSummaryFromTaskAudit(taskAudit) };
     const explicitModule = id.startsWith("MODULES/") ? id.split("/")[1] : null;
     const legacyCandidate = brief.source !== "standalone" || visualMap.status === "legacy-only" || !fs.existsSync(executionStrategyPath);
     const classification = inferTaskClassification({ id, title, relative, explicitModule, legacyCandidate });
@@ -355,14 +276,19 @@ export function collectTasks(target) {
     const reviewSubmission = parseAgentReviewSubmission(review, { taskKey: identity.taskKey });
     const reviewConfirmation = parseReviewConfirmation(review, {
       taskKey: identity.taskKey,
+      taskAudit,
       projectRoot: target.projectRoot,
       taskDir,
+      indexPath,
       reviewPath,
       progressPath,
     });
     const reviewStatus = taskReviewStatus({ reviewContent: review, risks, confirmation: reviewConfirmation, submission: reviewSubmission });
-    const closeoutInfo = taskCloseoutInfo(target, taskPlanPath);
-    const lifecycleState = deriveLifecycleState({ state: stateInfo.state, reviewStatus, closeoutStatus: closeoutInfo.status });
+    const closeoutInfo = taskCloseoutInfo(target, taskPlanPath, closeout);
+    const effectiveCloseoutStatus = budget === "simple" && stateInfo.state === "done" && completion === 100
+      ? "closed"
+      : closeoutInfo.status;
+    const lifecycleState = deriveLifecycleState({ state: stateInfo.state, reviewStatus, closeoutStatus: effectiveCloseoutStatus, budget });
     const materialReadiness = assessMaterialsReadiness({
       budget,
       taskDir,
@@ -376,19 +302,24 @@ export function collectTasks(target) {
       reviewSurfaceRequired: requiresReviewMaterials({
         state: stateInfo.state,
         lifecycleState,
-        closeoutStatus: closeoutInfo.status,
+        closeoutStatus: effectiveCloseoutStatus,
       }),
     });
-    const stateConflicts = collectStateConflicts({ state: stateInfo.state, reviewStatus, closeoutStatus: closeoutInfo.status, lifecycleState });
+    const materialIssues = [
+      ...materialReadiness.issues,
+      ...taskAuditMaterialIssues(target, taskDir, taskAudit),
+      ...legacyAuditIssues(target, taskDir, { briefContent: brief.content, reviewContent: review }),
+    ];
+    const stateConflicts = collectStateConflicts({ state: stateInfo.state, reviewStatus, closeoutStatus: effectiveCloseoutStatus, lifecycleState, budget });
     const reviewQueueState = deriveReviewQueueState({
       state: stateInfo.state,
       lifecycleState,
       reviewStatus,
-      closeoutStatus: closeoutInfo.status,
+      closeoutStatus: effectiveCloseoutStatus,
       budget,
       walkthroughPath: closeoutInfo.walkthroughPath,
       lessonCandidateDecisionComplete: isLessonCandidateDecisionComplete(lessonCandidates),
-      materialsReady: materialReadiness.ready,
+      materialsReady: materialIssues.length === 0,
       deletionState: tombstone.deletionState,
     });
     const queueModel = deriveTaskQueues({
@@ -400,11 +331,11 @@ export function collectTasks(target) {
       reviewSubmission,
       reviewConfirmation,
       reviewQueueState,
-      materialIssues: materialReadiness.issues,
+      materialIssues,
       risks,
       stateConflicts,
       lessonCandidates,
-      closeoutStatus: closeoutInfo.status,
+      closeoutStatus: effectiveCloseoutStatus,
       tombstone,
       taskDir,
       target,
@@ -450,18 +381,20 @@ export function collectTasks(target) {
       migrationAchievedLevel: metadata.migrationAchievedLevel,
       evidenceBundle: formatEvidenceBundle(metadata.evidenceBundle),
       migrationSnapshot: collectMigrationSnapshot(target, metadata),
+      scaffoldProvenance: scaffoldProvenance.summary,
+      taskAudit: taskAudit.summary,
       lifecycleState,
       reviewStatus,
       reviewSubmitted: Boolean(reviewSubmission?.submitted),
       reviewSubmission,
       reviewQueueState,
       reviewConfirmation,
-      materialsReady: materialReadiness.ready,
-      materialIssues: materialReadiness.issues,
+      materialsReady: materialIssues.length === 0,
+      materialIssues,
       taskQueues: queueModel.taskQueues,
       queueReasons: queueModel.queueReasons,
       repairPrompt: queueModel.repairPrompt,
-      closeoutStatus: closeoutInfo.status,
+      closeoutStatus: effectiveCloseoutStatus,
       walkthroughPath: closeoutInfo.walkthroughPath ? `TARGET:${closeoutInfo.walkthroughPath}` : "",
       lessonCandidatePath: fs.existsSync(lessonCandidatesPath)
         ? `TARGET:${toPosix(path.relative(target.projectRoot, lessonCandidatesPath))}`
@@ -505,12 +438,7 @@ function collectMigrationSnapshot(target, metadata) {
   const evidenceBundle = String(metadata.evidenceBundle || "").replace(/^TARGET:/, "").replace(/^\/+/, "");
   const bundlePath = evidenceBundle ? path.join(target.projectRoot, evidenceBundle) : "";
   const sessionPath = bundlePath ? path.join(bundlePath, "session.json") : "";
-  let session = null;
-  try {
-    session = sessionPath && fs.existsSync(sessionPath) ? JSON.parse(fs.readFileSync(sessionPath, "utf8")) : null;
-  } catch {
-    session = null;
-  }
+  const session = sessionPath && fs.existsSync(sessionPath) ? readJsonSafe(sessionPath, null) : null;
   const summary = session?.plan?.summary || {};
   return {
     targetLevel: metadata.migrationTargetLevel || "",
@@ -536,8 +464,7 @@ function formatEvidenceBundle(value) {
   return normalized ? `TARGET:${normalized}` : "";
 }
 
-function taskCloseoutInfo(target, taskPlanPath) {
-  const closeout = readFileSafe(path.join(target.docsRoot, "10-WALKTHROUGH/Closeout-SSoT.md"));
+function taskCloseoutInfo(target, taskPlanPath, closeout) {
   if (!closeout.trim()) return { status: "missing", walkthroughPath: "" };
   const docsRelative = `docs/${toPosix(path.relative(target.docsRoot, taskPlanPath))}`;
   const projectRelative = toPosix(path.relative(target.projectRoot, taskPlanPath));

package/skills/preset-creator/references/complex-task-skeleton/brief.md

@@ -30,3 +30,14 @@ State the user-visible or project-visible result this task must deliver.
 ## First Next Step
 
 Replace this line with the first concrete action before implementation starts.
+
+## Scaffold Provenance
+
+| Field | Value |
+| --- | --- |
+| Created By | {{SCAFFOLD_CREATED_BY}} |
+| Command Shape | {{SCAFFOLD_COMMAND}} |
+| Created At | {{SCAFFOLD_CREATED_AT}} |
+| Budget | {{SCAFFOLD_BUDGET}} |
+| Template Source | {{SCAFFOLD_TEMPLATE_SOURCE}} |
+| Exception Reason | {{SCAFFOLD_EXCEPTION_REASON}} |

package/templates/AGENTS.md.template

@@ -16,10 +16,11 @@ Keep it as a charter and routing index. Detailed rules belong in
 
 1. Preserve architecture boundaries documented in `docs/11-REFERENCE/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 `docs/09-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
 
@@ -33,7 +34,7 @@ Read the smallest context that can answer the task.
 | 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 |
+| Creating or advancing a task | Current task directory under `docs/09-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` |
@@ -48,7 +49,7 @@ Read the smallest context that can answer the task.
 ## 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
 

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 dataOnly = validationMode === "data-only";
+  const displayState = dataOnly ? "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>${dataOnly ? t("snapshotStatus") : t("readiness")}</span>
+      <strong>${dataOnly ? t("snapshot") : label(status)}</strong>
       <p>${nextActionText()}</p>
     </div>
     <div class="metrics-grid">
@@ -46,6 +49,7 @@ function metric(labelText, value) {
 }
 
 function nextActionText() {
+  if ((bundle.status?.checkState?.validationMode || "validated") === "data-only") 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;

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 "";