@mstar-harness/dsh 2.4.0 → 3.0.1

package/dist/client.js

@@ -120,6 +120,10 @@ var zh = {
   "zone.tasks.no-plans": "暂无计划",
   "zone.tasks.more": "+{count} 更多",
   "zone.tasks.collapse": "收起",
+  "zone.project.title": "项目汇总",
+  "zone.project.milestones": "里程碑",
+  "zone.project.residuals": "未结残留",
+  "zone.project.none": "无",
   "zone.state.Todo": "待办",
   "zone.state.InProgress": "进行中",
   "zone.state.InReview": "审查中",
@@ -147,6 +151,8 @@ var zh = {
   "flow.advisory": "提示",
   "flow.denied": "拒绝",
   "state.title": "工作区状态",
+  "state.selection": "所选工作流",
+  "state.selection.history": "历史视图（终端快照）",
   "state.plans": "计划",
   "state.residuals": "未决残留",
   "state.policy": "策略",
@@ -235,6 +241,10 @@ var en = {
   "zone.tasks.no-plans": "no plans",
   "zone.tasks.more": "+{count} more",
   "zone.tasks.collapse": "collapse",
+  "zone.project.title": "Project Rollup",
+  "zone.project.milestones": "Milestones",
+  "zone.project.residuals": "Open Residuals",
+  "zone.project.none": "none",
   "zone.state.Todo": "Todo",
   "zone.state.InProgress": "InProgress",
   "zone.state.InReview": "InReview",
@@ -262,6 +272,8 @@ var en = {
   "flow.advisory": "advisory",
   "flow.denied": "denied",
   "state.title": "Workspace state",
+  "state.selection": "Selected workflow",
+  "state.selection.history": "history view (terminal snapshot)",
   "state.plans": "Plans",
   "state.residuals": "Open residuals",
   "state.policy": "Policy",
@@ -962,6 +974,29 @@ var css = `
   overflow-wrap: anywhere;
 }
 
+
+.\\34 364e615_selection {
+  margin: 0;
+  overflow-wrap: anywhere;
+}
+
+.\\30 ae21b10_selectionId {
+  font-weight: 600;
+}
+
+.\\35 e43d3a8_selectionMeta,
+.da64723f_selectionWarning {
+  display: block;
+  color: var(--dsw-alias-label-caption);
+  font: var(--dsw-font-xxxs-11);
+}
+
+.ac988a64_selectionCode {
+  color: var(--dsw-alias-label-secondary);
+  font: var(--dsw-font-xxxs-11);
+  font-weight: 600;
+}
+
 .\\31 8a7beee_empty {
   margin: 0;
   color: var(--dsw-alias-label-caption);
@@ -993,7 +1028,7 @@ if (typeof document !== "undefined" && document.querySelector("style[data-plugin
   tag.textContent = css;
   document.head.appendChild(tag);
 }
-var panel_module_default = { root: "20fd0e45_root", emptyRoot: "f83e09fa_emptyRoot", noHarnessCard: "58245a20_noHarnessCard", noHarnessIcon: "ffb65da7_noHarnessIcon", noHarnessTitle: "81e1817c_noHarnessTitle", noHarnessHint: "a2289da7_noHarnessHint", sidebar: "c87acfc7_sidebar", iterationHeadSplit: "77aea5a6_iterationHeadSplit", iterationBranches: "c3b8dcb0_iterationBranches", main: "ea90e208_main", tabNav: "4bb38bc9_tabNav", tab: "98f72e4c_tab", tabActive: "59e199de_tabActive", content: "90bec3c2_content", iterationPage: "3b1c4147_iterationPage", iterationHead: "8a629a8e_iterationHead", iterationSummary: "2d1bee34_iterationSummary", iterationSummaryId: "17162a99_iterationSummaryId", iterationSummaryVerdict: "d3d74135_iterationSummaryVerdict", iterationSummaryStatus: "d9a886be_iterationSummaryStatus", iterationSummaryStatusMuted: "13bf2f41_iterationSummaryStatusMuted", iterationSummaryHint: "ede5708d_iterationSummaryHint", iterationHeadBody: "64d1da62_iterationHeadBody", iterationStepsRow: "c52f7b85_iterationStepsRow", iterationStepItem: "81013a9d_iterationStepItem", iterationStepBadge: "7befde45_iterationStepBadge", iterationStepPhase: "d6cd23a5_iterationStepPhase", iterationStepChip: "de293024_iterationStepChip", iterationVerdictSeat: "afea5850_iterationVerdictSeat", iterationVerdict: "ebe6bbcd_iterationVerdict", iterationBranchesTitle: "e6921da6_iterationBranchesTitle", iterationBranchList: "8a2cd65c_iterationBranchList", iterationBranchRow: "997b0230_iterationBranchRow", iterationBranchLabel: "6cafc032_iterationBranchLabel", iterationBranchValue: "cdcd06ed_iterationBranchValue", iterationTasks: "87f7efbe_iterationTasks", sidebarScroll: "a0b80516_sidebarScroll", meta: "81fe4f58_meta", metaLine: "0fc275e2_metaLine", section: "fcdd0ccc_section", sectionTitle: "aded23ea_sectionTitle", subTitle: "b7190159_subTitle", defList: "26763614_defList", defTerm: "670df156_defTerm", defValue: "3f1b3a05_defValue", planList: "a129f16e_planList", residualList: "113e0aa2_residualList", leaseList: "33dfcc85_leaseList", violationList: "999efdc0_violationList", planId: "744bf63f_planId", leasePlan: "560663a6_leasePlan", leaseHolder: "a68a6d03_leaseHolder", leaseWorktree: "db027b44_leaseWorktree", findingSeverity: "1797fd51_findingSeverity", findingTitle: "c80b7bb0_findingTitle", findingPlan: "616667ad_findingPlan", violationCode: "e42c0bfd_violationCode", knowledgeCategories: "e2098247_knowledgeCategories", planStatus: "a3021d7c_planStatus", truncated: "1849d129_truncated", knowledge: "3eb5feeb_knowledge", direction: "df6dc76a_direction", empty: "18a7beee_empty", freshness: "c75c59b0_freshness" };
+var panel_module_default = { root: "20fd0e45_root", emptyRoot: "f83e09fa_emptyRoot", noHarnessCard: "58245a20_noHarnessCard", noHarnessIcon: "ffb65da7_noHarnessIcon", noHarnessTitle: "81e1817c_noHarnessTitle", noHarnessHint: "a2289da7_noHarnessHint", sidebar: "c87acfc7_sidebar", iterationHeadSplit: "77aea5a6_iterationHeadSplit", iterationBranches: "c3b8dcb0_iterationBranches", main: "ea90e208_main", tabNav: "4bb38bc9_tabNav", tab: "98f72e4c_tab", tabActive: "59e199de_tabActive", content: "90bec3c2_content", iterationPage: "3b1c4147_iterationPage", iterationHead: "8a629a8e_iterationHead", iterationSummary: "2d1bee34_iterationSummary", iterationSummaryId: "17162a99_iterationSummaryId", iterationSummaryVerdict: "d3d74135_iterationSummaryVerdict", iterationSummaryStatus: "d9a886be_iterationSummaryStatus", iterationSummaryStatusMuted: "13bf2f41_iterationSummaryStatusMuted", iterationSummaryHint: "ede5708d_iterationSummaryHint", iterationHeadBody: "64d1da62_iterationHeadBody", iterationStepsRow: "c52f7b85_iterationStepsRow", iterationStepItem: "81013a9d_iterationStepItem", iterationStepBadge: "7befde45_iterationStepBadge", iterationStepPhase: "d6cd23a5_iterationStepPhase", iterationStepChip: "de293024_iterationStepChip", iterationVerdictSeat: "afea5850_iterationVerdictSeat", iterationVerdict: "ebe6bbcd_iterationVerdict", iterationBranchesTitle: "e6921da6_iterationBranchesTitle", iterationBranchList: "8a2cd65c_iterationBranchList", iterationBranchRow: "997b0230_iterationBranchRow", iterationBranchLabel: "6cafc032_iterationBranchLabel", iterationBranchValue: "cdcd06ed_iterationBranchValue", iterationTasks: "87f7efbe_iterationTasks", sidebarScroll: "a0b80516_sidebarScroll", meta: "81fe4f58_meta", metaLine: "0fc275e2_metaLine", section: "fcdd0ccc_section", sectionTitle: "aded23ea_sectionTitle", subTitle: "b7190159_subTitle", defList: "26763614_defList", defTerm: "670df156_defTerm", defValue: "3f1b3a05_defValue", planList: "a129f16e_planList", residualList: "113e0aa2_residualList", leaseList: "33dfcc85_leaseList", violationList: "999efdc0_violationList", planId: "744bf63f_planId", leasePlan: "560663a6_leasePlan", leaseHolder: "a68a6d03_leaseHolder", leaseWorktree: "db027b44_leaseWorktree", findingSeverity: "1797fd51_findingSeverity", findingTitle: "c80b7bb0_findingTitle", findingPlan: "616667ad_findingPlan", violationCode: "e42c0bfd_violationCode", knowledgeCategories: "e2098247_knowledgeCategories", planStatus: "a3021d7c_planStatus", truncated: "1849d129_truncated", knowledge: "3eb5feeb_knowledge", direction: "df6dc76a_direction", selection: "4364e615_selection", selectionId: "0ae21b10_selectionId", selectionMeta: "5e43d3a8_selectionMeta", selectionWarning: "da64723f_selectionWarning", selectionCode: "ac988a64_selectionCode", empty: "18a7beee_empty", freshness: "c75c59b0_freshness" };
 
 // src/client/panel/guards.ts
 function str(value) {
@@ -1241,6 +1276,7 @@ function projectGraph(source) {
   }
   const agents = projectAgents(source, currentStep);
   const flow = projectFlowEvents(source);
+  const project = projectRollup(source);
   return {
     iteration: {
       active,
@@ -1253,6 +1289,7 @@ function projectGraph(source) {
     },
     tasks: { columns, total, truncated },
     agents,
+    project,
     verdict,
     violations,
     events: flow.events,
@@ -1260,6 +1297,16 @@ function projectGraph(source) {
     degraded
   };
 }
+function projectRollup(source) {
+  const state = stateRow(source);
+  const project = state?.project;
+  const milestones = Array.isArray(project?.milestones) ? project.milestones.filter((milestone) => typeof milestone === "string" && milestone !== "") : [];
+  const openResiduals = Array.isArray(project?.openResiduals) ? project.openResiduals.map((row) => {
+    const r = row;
+    return { severity: str(r?.severity) ?? "", count: count(r?.count) ?? 0 };
+  }) : [];
+  return { milestones, openResiduals };
+}
 function bucketOf(role) {
   if (SDD_BUCKET_ROLES.implementor.includes(role))
     return "implementor";
@@ -1723,6 +1770,7 @@ function StateSection({ t, state, enforcement }) {
   const hiddenFindings = findings === null ? 0 : Math.max(0, findings.length - FINDINGS_CAP);
   const leases = Array.isArray(state?.leases) ? state.leases : [];
   const knowledge = state?.knowledge ?? null;
+  const selection = state?.selection;
   return /* @__PURE__ */ jsx_runtime2.jsxs("section", {
     className: panel_module_default.section,
     "data-mstar-section": "state",
@@ -1731,6 +1779,55 @@ function StateSection({ t, state, enforcement }) {
         className: panel_module_default.sectionTitle,
         children: t("state.title")
       }),
+      /* @__PURE__ */ jsx_runtime2.jsx("h3", {
+        className: panel_module_default.subTitle,
+        children: t("state.selection")
+      }),
+      selection?.kind === "active" ? /* @__PURE__ */ jsx_runtime2.jsxs("p", {
+        className: panel_module_default.selection,
+        "data-selection-kind": "active",
+        "data-selection-workflow": selection.workflowId,
+        children: [
+          /* @__PURE__ */ jsx_runtime2.jsx("span", {
+            className: panel_module_default.selectionId,
+            children: selection.workflowId
+          }),
+          selection.warning !== undefined ? /* @__PURE__ */ jsx_runtime2.jsx("span", {
+            className: panel_module_default.selectionWarning,
+            "data-selection-warning": true,
+            children: selection.warning.message
+          }) : null
+        ]
+      }) : selection?.kind === "terminal" ? /* @__PURE__ */ jsx_runtime2.jsxs("p", {
+        className: panel_module_default.selection,
+        "data-selection-kind": "terminal",
+        "data-selection-workflow": selection.workflowId,
+        children: [
+          /* @__PURE__ */ jsx_runtime2.jsx("span", {
+            className: panel_module_default.selectionId,
+            children: selection.workflowId
+          }),
+          /* @__PURE__ */ jsx_runtime2.jsx("span", {
+            className: panel_module_default.selectionMeta,
+            "data-selection-history": true,
+            children: t("state.selection.history")
+          })
+        ]
+      }) : /* @__PURE__ */ jsx_runtime2.jsxs("p", {
+        className: panel_module_default.selection,
+        "data-selection-kind": "error",
+        "data-selection-code": selection?.code ?? t("panel.unknown"),
+        children: [
+          /* @__PURE__ */ jsx_runtime2.jsx("span", {
+            className: panel_module_default.selectionCode,
+            children: selection?.code ?? t("panel.unknown")
+          }),
+          /* @__PURE__ */ jsx_runtime2.jsx("span", {
+            className: panel_module_default.selectionMeta,
+            children: selection?.message ?? t("state.none")
+          })
+        ]
+      }),
       /* @__PURE__ */ jsx_runtime2.jsx("h3", {
         className: panel_module_default.subTitle,
         children: t("state.plans")
@@ -2237,6 +2334,69 @@ var css2 = `
   color: var(--dsw-alias-label-secondary);
 }
 
+
+
+
+.a2f9476f_zoneTitle {
+  margin: var(--mstar-space-1) 0 0;
+  color: var(--dsw-alias-label-secondary);
+  font: var(--dsw-font-xxxs-11);
+  font-weight: 600;
+  letter-spacing: 0.03em;
+  text-transform: uppercase;
+}
+
+.\\31 ca74b3b_rollupList {
+  display: flex;
+  flex-direction: column;
+  gap: var(--mstar-space-1);
+  margin: 0;
+  padding: 0;
+  list-style: none;
+}
+
+.\\33 71169b4_rollupItem {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: var(--mstar-space-2);
+  min-width: 0;
+}
+
+.\\35 f3f5403_rollupMilestone {
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+  color: var(--dsw-alias-label-primary);
+  font: var(--dsw-font-xxxs-11);
+}
+
+.d87816b2_rollupCount {
+  flex: none;
+  color: var(--dsw-alias-label-secondary);
+  font: var(--dsw-font-xxxs-11);
+  font-variant-numeric: tabular-nums;
+}
+
+
+.\\38 f4e5388_severityChip {
+  align-self: flex-start;
+  padding: 0 var(--mstar-space-1);
+  border: 1px solid var(--dsw-alias-border-l2);
+  border-radius: 999px;
+  color: var(--dsw-alias-label-secondary);
+  font: var(--dsw-font-xxxs-11);
+}
+
+.\\38 f4e5388_severityChip[data-severity='critical'] {
+  border-color: var(--dsw-alias-state-danger-primary);
+  color: var(--dsw-alias-state-danger-primary);
+}
+
+.\\38 f4e5388_severityChip[data-severity='high'] {
+  border-color: var(--dsw-alias-state-warning-primary);
+  color: var(--dsw-alias-state-warning-primary);
+}
 `;
 var tagId2 = "@mstar-harness/dsh/zones.module.css";
 if (typeof document !== "undefined" && document.querySelector("style[data-plugin-css=" + JSON.stringify(tagId2) + "]") === null) {
@@ -2246,7 +2406,7 @@ if (typeof document !== "undefined" && document.querySelector("style[data-plugin
   tag.textContent = css2;
   document.head.appendChild(tag);
 }
-var zones_module_default = { zone: "0390dc47_zone", zoneHeader: "fa5472ae_zoneHeader", zoneEmpty: "2358ca74_zoneEmpty", legend: "0214fc64_legend", legendTitle: "7fdf3af2_legendTitle", legendList: "5751e1ec_legendList", legendItem: "c648f79b_legendItem", legendSwatch: "84f03998_legendSwatch", swatchAgentRunning: "637ae7a1_swatchAgentRunning", swatchAgentSettled: "e8a7988b_swatchAgentSettled", swatchAgentIdle: "d34b3834_swatchAgentIdle", tasksHeader: "9c376db8_tasksHeader", tasksTotal: "b5ad0f15_tasksTotal", kanban: "12dfaa6e_kanban", kanbanColumn: "1f8473a4_kanbanColumn", kanbanColumnHeader: "3b1cc701_kanbanColumnHeader", kanbanColumnTitle: "503b6432_kanbanColumnTitle", kanbanCount: "496af60d_kanbanCount", kanbanCards: "161359fd_kanbanCards", planCard: "73f0e028_planCard", planCardId: "a37c7a75_planCardId", planCardStatus: "11b4fd6a_planCardStatus", kanbanArrow: "63518033_kanbanArrow", kanbanMore: "0c600f2f_kanbanMore", kanbanMoreButton: "d0f95d1f_kanbanMoreButton" };
+var zones_module_default = { zone: "0390dc47_zone", zoneHeader: "fa5472ae_zoneHeader", zoneEmpty: "2358ca74_zoneEmpty", legend: "0214fc64_legend", legendTitle: "7fdf3af2_legendTitle", legendList: "5751e1ec_legendList", legendItem: "c648f79b_legendItem", legendSwatch: "84f03998_legendSwatch", swatchAgentRunning: "637ae7a1_swatchAgentRunning", swatchAgentSettled: "e8a7988b_swatchAgentSettled", swatchAgentIdle: "d34b3834_swatchAgentIdle", tasksHeader: "9c376db8_tasksHeader", tasksTotal: "b5ad0f15_tasksTotal", kanban: "12dfaa6e_kanban", kanbanColumn: "1f8473a4_kanbanColumn", kanbanColumnHeader: "3b1cc701_kanbanColumnHeader", kanbanColumnTitle: "503b6432_kanbanColumnTitle", kanbanCount: "496af60d_kanbanCount", kanbanCards: "161359fd_kanbanCards", planCard: "73f0e028_planCard", planCardId: "a37c7a75_planCardId", planCardStatus: "11b4fd6a_planCardStatus", kanbanArrow: "63518033_kanbanArrow", kanbanMore: "0c600f2f_kanbanMore", kanbanMoreButton: "d0f95d1f_kanbanMoreButton", zoneTitle: "a2f9476f_zoneTitle", rollupList: "1ca74b3b_rollupList", rollupItem: "371169b4_rollupItem", rollupMilestone: "5f3f5403_rollupMilestone", rollupCount: "d87816b2_rollupCount", severityChip: "8f4e5388_severityChip" };
 
 // src/client/panel/zones/Legend.tsx
 var jsx_runtime5 = require("react/jsx-runtime");
@@ -4385,24 +4545,100 @@ function TaskBoard({ view, t }) {
   });
 }
 
-// src/client/panel/pages/IterationTaskPage.tsx
+// src/client/panel/zones/ProjectRollup.tsx
 var jsx_runtime10 = require("react/jsx-runtime");
+function ProjectRollup({ view, t }) {
+  const { milestones, openResiduals } = view;
+  return /* @__PURE__ */ jsx_runtime10.jsxs("section", {
+    className: zones_module_default.zone,
+    "data-zone": "project",
+    children: [
+      /* @__PURE__ */ jsx_runtime10.jsx("header", {
+        className: zones_module_default.tasksHeader,
+        "data-zone-header": true,
+        children: /* @__PURE__ */ jsx_runtime10.jsx("h2", {
+          className: zones_module_default.zoneHeader,
+          children: t("zone.project.title")
+        })
+      }),
+      /* @__PURE__ */ jsx_runtime10.jsx("h3", {
+        className: zones_module_default.zoneTitle,
+        "data-project-milestones-title": true,
+        children: t("zone.project.milestones")
+      }),
+      milestones.length === 0 ? /* @__PURE__ */ jsx_runtime10.jsx("p", {
+        className: zones_module_default.zoneEmpty,
+        "data-mstar-empty": "no-milestones",
+        children: t("zone.project.none")
+      }) : /* @__PURE__ */ jsx_runtime10.jsx("ul", {
+        className: zones_module_default.rollupList,
+        "data-project-milestones": true,
+        children: milestones.map((milestone, i) => /* @__PURE__ */ jsx_runtime10.jsx("li", {
+          className: zones_module_default.rollupItem,
+          "data-project-milestone": true,
+          children: /* @__PURE__ */ jsx_runtime10.jsx("span", {
+            className: zones_module_default.rollupMilestone,
+            children: milestone
+          })
+        }, `${milestone}-${i}`))
+      }),
+      /* @__PURE__ */ jsx_runtime10.jsx("h3", {
+        className: zones_module_default.zoneTitle,
+        "data-project-residuals-title": true,
+        children: t("zone.project.residuals")
+      }),
+      openResiduals.length === 0 ? /* @__PURE__ */ jsx_runtime10.jsx("p", {
+        className: zones_module_default.zoneEmpty,
+        "data-mstar-empty": "no-project-residuals",
+        children: t("zone.project.none")
+      }) : /* @__PURE__ */ jsx_runtime10.jsx("ul", {
+        className: zones_module_default.rollupList,
+        "data-project-residuals": true,
+        children: openResiduals.map((row, i) => /* @__PURE__ */ jsx_runtime10.jsxs("li", {
+          className: zones_module_default.rollupItem,
+          "data-project-residual": true,
+          children: [
+            /* @__PURE__ */ jsx_runtime10.jsx("span", {
+              className: zones_module_default.severityChip,
+              "data-severity": row.severity,
+              children: row.severity
+            }),
+            /* @__PURE__ */ jsx_runtime10.jsx("span", {
+              className: zones_module_default.rollupCount,
+              "data-project-residual-count": row.count,
+              children: row.count
+            })
+          ]
+        }, `${row.severity}-${i}`))
+      })
+    ]
+  });
+}
+
+// src/client/panel/pages/IterationTaskPage.tsx
+var jsx_runtime11 = require("react/jsx-runtime");
 function IterationTaskPage({ view, t }) {
-  return /* @__PURE__ */ jsx_runtime10.jsxs("div", {
+  return /* @__PURE__ */ jsx_runtime11.jsxs("div", {
     className: panel_module_default.iterationPage,
     "data-mstar-page": "tasks",
     children: [
-      /* @__PURE__ */ jsx_runtime10.jsx(IterationInfoSection, {
+      /* @__PURE__ */ jsx_runtime11.jsx(IterationInfoSection, {
         iteration: view.iteration,
         t
       }),
-      /* @__PURE__ */ jsx_runtime10.jsx("div", {
+      /* @__PURE__ */ jsx_runtime11.jsxs("div", {
         className: panel_module_default.iterationTasks,
         "data-mstar-tasks-scroll": true,
-        children: /* @__PURE__ */ jsx_runtime10.jsx(TaskBoard, {
-          view: view.tasks,
-          t
-        })
+        children: [
+          /* @__PURE__ */ jsx_runtime11.jsx(TaskBoard, {
+            view: view.tasks,
+            t
+          }),
+          /* @__PURE__ */ jsx_runtime11.jsx(ProjectRollup, {
+            view: view.project,
+            t
+          })
+        ]
       })
     ]
   });
@@ -4444,25 +4680,25 @@ function useMstarEngineStatus(useSession) {
 }
 
 // src/client/panel/PanelView.tsx
-var jsx_runtime11 = require("react/jsx-runtime");
+var jsx_runtime12 = require("react/jsx-runtime");
 function formatTime(ms) {
   return new Date(ms).toLocaleTimeString("en-GB");
 }
 function PanelContent({ tab, source, t }) {
   if (tab === "agents") {
     const view = projectGraph(source);
-    return /* @__PURE__ */ jsx_runtime11.jsx(AgentCanvasPage, {
+    return /* @__PURE__ */ jsx_runtime12.jsx(AgentCanvasPage, {
       view: view.agents,
       iteration: view.iteration,
       t
     });
   }
   if (tab === "events")
-    return /* @__PURE__ */ jsx_runtime11.jsx(EventLogPage, {
+    return /* @__PURE__ */ jsx_runtime12.jsx(EventLogPage, {
       view: projectGraph(source),
       t
     });
-  return /* @__PURE__ */ jsx_runtime11.jsx(IterationTaskPage, {
+  return /* @__PURE__ */ jsx_runtime12.jsx(IterationTaskPage, {
     view: projectGraph(source),
     t
   });
@@ -4471,11 +4707,11 @@ function PanelView({ t, useSession }) {
   const { source, lastUpdated } = useMstarEngineStatus(useSession);
   const [tab, setTab] = import_react3.useState("tasks");
   if (source === null || source === undefined) {
-    return /* @__PURE__ */ jsx_runtime11.jsx("div", {
+    return /* @__PURE__ */ jsx_runtime12.jsx("div", {
       className: panel_module_default.emptyRoot,
       "data-mstar-panel": "waiting",
       "data-conversation-composer-overlay": "",
-      children: /* @__PURE__ */ jsx_runtime11.jsx("p", {
+      children: /* @__PURE__ */ jsx_runtime12.jsx("p", {
         className: panel_module_default.empty,
         "data-mstar-empty": "waiting",
         children: t("empty.waiting")
@@ -4483,32 +4719,32 @@ function PanelView({ t, useSession }) {
     });
   }
   const noHarness = source.harnessDir === null && source.state === null && source.iteration == null;
-  const freshness = /* @__PURE__ */ jsx_runtime11.jsxs("footer", {
+  const freshness = /* @__PURE__ */ jsx_runtime12.jsxs("footer", {
     className: panel_module_default.freshness,
     "data-mstar-freshness": true,
     children: [
-      typeof lastUpdated === "number" ? /* @__PURE__ */ jsx_runtime11.jsx("span", {
+      typeof lastUpdated === "number" ? /* @__PURE__ */ jsx_runtime12.jsx("span", {
         children: t("freshness.last-updated", { time: formatTime(lastUpdated) })
       }) : null,
-      /* @__PURE__ */ jsx_runtime11.jsx("span", {
+      /* @__PURE__ */ jsx_runtime12.jsx("span", {
         children: t("freshness.refresh-note")
       })
     ]
   });
   if (noHarness) {
-    return /* @__PURE__ */ jsx_runtime11.jsx("div", {
+    return /* @__PURE__ */ jsx_runtime12.jsx("div", {
       className: panel_module_default.root,
       "data-mstar-panel": "no-harness",
       "data-conversation-composer-overlay": "",
-      children: /* @__PURE__ */ jsx_runtime11.jsxs("main", {
+      children: /* @__PURE__ */ jsx_runtime12.jsxs("main", {
         className: panel_module_default.main,
         "data-mstar-graph": true,
         children: [
-          /* @__PURE__ */ jsx_runtime11.jsxs("div", {
+          /* @__PURE__ */ jsx_runtime12.jsxs("div", {
             className: panel_module_default.noHarnessCard,
             "data-mstar-empty-card": true,
             children: [
-              /* @__PURE__ */ jsx_runtime11.jsxs("svg", {
+              /* @__PURE__ */ jsx_runtime12.jsxs("svg", {
                 className: panel_module_default.noHarnessIcon,
                 "data-mstar-empty-icon": true,
                 width: "32",
@@ -4521,25 +4757,25 @@ function PanelView({ t, useSession }) {
                 strokeLinejoin: "round",
                 "aria-hidden": "true",
                 children: [
-                  /* @__PURE__ */ jsx_runtime11.jsx("path", {
+                  /* @__PURE__ */ jsx_runtime12.jsx("path", {
                     d: "M3 7a2 2 0 0 1 2-2h4l2 2h8a2 2 0 0 1 2 2v8a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2z"
                   }),
-                  /* @__PURE__ */ jsx_runtime11.jsx("path", {
+                  /* @__PURE__ */ jsx_runtime12.jsx("path", {
                     d: "M9.7 9.4a2.4 2.4 0 1 1 3.4 2.2c-.7.3-1 .8-1 1.5"
                   }),
-                  /* @__PURE__ */ jsx_runtime11.jsx("circle", {
+                  /* @__PURE__ */ jsx_runtime12.jsx("circle", {
                     cx: "12",
                     cy: "16.4",
                     r: "0.6"
                   })
                 ]
               }),
-              /* @__PURE__ */ jsx_runtime11.jsx("p", {
+              /* @__PURE__ */ jsx_runtime12.jsx("p", {
                 className: panel_module_default.noHarnessTitle,
                 "data-mstar-empty": "no-harness",
                 children: t("empty.no-harness")
               }),
-              /* @__PURE__ */ jsx_runtime11.jsx("p", {
+              /* @__PURE__ */ jsx_runtime12.jsx("p", {
                 className: panel_module_default.noHarnessHint,
                 children: t("empty.no-harness-hint")
               })
@@ -4550,23 +4786,23 @@ function PanelView({ t, useSession }) {
       })
     });
   }
-  return /* @__PURE__ */ jsx_runtime11.jsxs("div", {
+  return /* @__PURE__ */ jsx_runtime12.jsxs("div", {
     className: panel_module_default.root,
     "data-mstar-panel": "panel",
     "data-conversation-composer-overlay": "",
     children: [
-      /* @__PURE__ */ jsx_runtime11.jsxs("main", {
+      /* @__PURE__ */ jsx_runtime12.jsxs("main", {
         className: panel_module_default.main,
         children: [
-          /* @__PURE__ */ jsx_runtime11.jsx(TabNav, {
+          /* @__PURE__ */ jsx_runtime12.jsx(TabNav, {
             active: tab,
             onChange: setTab,
             t
           }),
-          /* @__PURE__ */ jsx_runtime11.jsx("div", {
+          /* @__PURE__ */ jsx_runtime12.jsx("div", {
             className: panel_module_default.content,
             "data-mstar-graph": true,
-            children: /* @__PURE__ */ jsx_runtime11.jsx(PanelContent, {
+            children: /* @__PURE__ */ jsx_runtime12.jsx(PanelContent, {
               tab,
               source,
               t
@@ -4575,7 +4811,7 @@ function PanelView({ t, useSession }) {
           freshness
         ]
       }),
-      /* @__PURE__ */ jsx_runtime11.jsx(Sidebar, {
+      /* @__PURE__ */ jsx_runtime12.jsx(Sidebar, {
         t,
         state: source.state,
         source

package/dist/gates/_shared.d.ts

@@ -11,8 +11,7 @@ export interface Config {
      * `{HARNESS_DIR}` resolution order); when absent the plugin probes from
      * the SESSION workspace root (`agent.session.header.cwd`) — never the
      * process cwd — walking `.mstar/` → `.agents/` → `.plans/`/`plans/`.
-     * Required for repos whose harness root is not a probed name (e.g. a
-     * `.harness/` maintenance root).
+     * Required for repos whose harness root is not a probed name.
      */
     harnessDir?: string;
     /**
@@ -163,8 +162,9 @@ export declare function formatViolation(violation: ValidationResult): string;
 export declare function asRecord(value: unknown): Record<string, unknown> | undefined;
 /**
  * Resolve the hard-enforcement flag for the artifact gates: explicit
- * Config override wins, else the iteration compass frontmatter (when a
- * harness dir resolves), else warn-only. {@link resolveHard} parity with a
+ * Config override wins, else the repo `.mstarc` `[config] enforcement`,
+ * else the iteration compass frontmatter (when a harness dir resolves),
+ * else warn-only. {@link resolveHard} parity with a
  * null-tolerant harness dir — the skill roots and the artifact
  * seams (design-md / audit / compound / roles) do not require
  * `{HARNESS_DIR}` (compound scoping is the only seam that does, and only

package/dist/gates/adapter.d.ts

@@ -2,6 +2,7 @@ import { Service, type Context } from '@deepseek-ai/cordis';
 import type { AssignmentFields, GateResult, HostAdapter, IntegrationMergeLease, ValidationResult } from '@mstar-harness/engine';
 import type { ToolExecution } from '@deepseek-ai/dsh-tools';
 import type { HarnessResolver, Config } from './_shared.ts';
+import { type HarnessDocKind } from './status.ts';
 import type { AgentFlowPairing, WorkflowVerdictInput } from './agent-flow.ts';
 import { WorkflowAskCache } from './workflow-policy.ts';
 /** Options for {@link DshHostAdapter}. */
@@ -50,7 +51,10 @@ export interface DshHostAdapterOptions {
  *   the host provides it (the write's content — the opencode consumer
  *   convention for this engine hook), else the current on-disk document at
  *   `path` via the gate's single-read `validateStatusDoc` semantics (missing
- *   file = first create = pass). Both inputs flow through
+ *   file = first create = pass). The path is classified against the resolved
+ *   harness dir (v2 root / workflow snapshot / project register — the
+ *   P2-fixed `harnessDocKindOfTarget` shape) and validated with the MATCHING
+ *   engine validator; non-coordination paths pass. Both inputs flow through
  *   `validateStatusValue` — the same pipeline the fs-intent gate runs, so
  *   codes match by construction. Returns the FIRST violation: the engine
  *   hook shape is one `ValidationResult`; the gate's full violation list
@@ -95,12 +99,18 @@ export declare class DshHostAdapter extends Service implements HostAdapter {
     /**
      * Shared status-gate core (plugin-internal): the fs-intent listeners and
      * the `beforeStatusWrite` on-disk fallback route through this method —
-     * ONE validation code path. Missing file = first create = pass (the
+     * ONE validation code path, kind-dispatched (v2 root / workflow snapshot
+     * / project register — the matching engine validator per
+     * {@link validateStatusValue}). Missing file = first create = pass (the
      * intent waterfall carries no incoming content, so the vetoable signal is
      * the pre-write on-disk state).
-     * @param statusPath - the canonical `{HARNESS_DIR}/status.json` path.
+     * @param path - the canonical coordination-document path (the caller
+     * classifies it against the resolved harness dir).
+     * @param kind - the target's {@link HarnessDocKind}.
+     * @param harnessDir - the resolved `{HARNESS_DIR}` (the snapshot kind's
+     * cleanup extension needs it to locate the project registers).
      */
-    statusGate(statusPath: string): GateResult;
+    statusGate(path: string, kind: HarnessDocKind, harnessDir: string | null): GateResult;
     /**
      * Shared dispatch-gate core (plugin-internal): the `tools/pre-execute`
      * listener and `beforeDispatch` route through this method — ONE
@@ -133,11 +143,17 @@ export declare class DshHostAdapter extends Service implements HostAdapter {
     recordWorkflowVerdict(input: WorkflowVerdictInput): void;
     /**
      * `HostAdapter.beforeStatusWrite` — see the class doc for the doc-first /
-     * on-disk-fallback semantics. Never throws; a failing gate maps to its
-     * FIRST violation (severity/code/message/fix/aliases preserved — failing
-     * gates always carry ≥1 violation), a passing gate to
+     * on-disk-fallback semantics, now KIND-DISPATCHED: the path is classified
+     * against the resolved harness dir (`harnessDocKindOfTarget` — root
+     * status.json / workflow snapshot / project register, the P2-fixed shape)
+     * and validated with the matching engine validator
+     * (`validateStatusValue`). Non-coordination paths (unclassifiable) pass —
+     * the hook's business is harness coordination documents only. Never
+     * throws; a failing gate maps to its FIRST violation
+     * (severity/code/message/fix/aliases preserved — failing gates always
+     * carry ≥1 violation), a passing gate to
      * `host.beforeStatusWrite.ok` (the engine test convention for this hook).
-     * @param path - the status.json target path.
+     * @param path - the coordination-document target path.
      * @param doc - the document about to be written (undefined → validate the
      * on-disk document at `path`).
      */
@@ -155,10 +171,20 @@ export declare class DshHostAdapter extends Service implements HostAdapter {
     beforeDispatch(assignment: AssignmentFields | string): Promise<GateResult>;
     /**
      * `HostAdapter.beforeMerge` — reserve/validate the integration merge
-     * lease. Thin wrapper over the engine `validateIntegrationMergeLease`
-     * (the engine owns the lease shape; the reservation write into
-     * `{HARNESS_DIR}/status.json` is a P3 seam).
-     * @param lease - the `metadata.integration_merge_lease` object.
+     * lease. v3 relocation (plan `20260819-workflow-dsh-viz` Task 3): the
+     * `integration_merge_lease` home is the ACTIVE workflow snapshot
+     * (`workflows/<id>/snapshot.json` top-level — the v1 root-metadata home
+     * is gone), so the hook READS the snapshot's current lease and validates
+     * it (CLI `lease verify-integration` parity) plus a no-steal comparison
+     * against the passed lease. The passed lease object is still
+     * shape-validated (the hook contract). Degrade edges (never false
+     * positives): no harness dir (exec-less hook — the explicit config
+     * resolves or nothing), no active workflow, an unreadable/missing
+     * snapshot, or a snapshot WITHOUT an `integration_merge_lease`
+     * (unclaimed) all skip the snapshot read — the passed-lease shape gate
+     * stands alone.
+     * @param lease - the `metadata.integration_merge_lease` object being
+     * reserved/validated.
      */
     beforeMerge(lease: IntegrationMergeLease): Promise<GateResult>;
 }