@loomhelm/multi-task-flow 0.2.6 → 0.2.8

package/toolkit/skills/multi-task-flow/web/app.ts

@@ -585,7 +585,15 @@ function render(): void {
   if (restoreClosedDetailsOnNextRender) { restoreClosedDetailsOnNextRender = false; restoreClosedDetails(); }
   if (phaseTransition) { $("phase-notice").hidden = false; $("phase-notice-text").textContent = "已有真实任务开始执行，阶段已切换；当前视图和筛选保持不变。"; } else $("phase-notice").hidden = true;
 }
-function setTabAria(tab: DashboardTab): void { for (const button of document.querySelectorAll<HTMLButtonElement>("[data-tab]")) button.setAttribute("aria-selected", String(button.dataset.tab === tab)); for (const name of ["graph", "planned", "actual", "tasks"]) $(`${name}-view`).hidden = name !== tab; $("workspace").dataset.viewTab = tab; }
+function setTabAria(tab: DashboardTab): void {
+  for (const button of document.querySelectorAll<HTMLButtonElement>("[data-tab]")) button.setAttribute("aria-selected", String(button.dataset.tab === tab));
+  const graphView = $("graph-view");
+  const graphVisible = ["graph", "atomic"].includes(tab);
+  graphView.hidden = !graphVisible;
+  graphView.setAttribute("aria-labelledby", tab === "atomic" ? "tab-atomic" : "tab-graph");
+  for (const name of ["planned", "actual", "tasks"]) $(`${name}-view`).hidden = name !== tab;
+  $("workspace").dataset.viewTab = tab;
+}
 
 function renderAtomicGraph(): void {
   if (!data) return;
@@ -638,7 +646,7 @@ async function refresh(): Promise<void> {
     taskNotice.textContent = missingTask ? `任务 ${requestedTask} 不存在或已不可用。` : "";
     if (!hydrated && requestedTask && !missingTask && viewState.detail) viewState = { ...viewState, query: "", group: "", kind: "", state: "" };
     viewState = sanitizeViewState(viewState, stateValidation()); selectedTask = viewState.selected?.kind === "task" ? viewState.selected.id : null; selectedGroup = viewState.selected?.kind === "group" ? viewState.selected.id : null; selectedMilestone = viewState.selected?.kind === "milestone" ? viewState.selected.id : null; activePlan = viewState.plan ?? data.selected_plan_id;
-    if (previousPhase === "planning" && currentPhase === "execution") phaseTransition = true; phase = currentPhase; const shouldFocusRestoredDetails = !hydrated && viewState.detail; hydrated = true; if (shouldFocusRestoredDetails) focusDetailsOnNextRender = true; syncUrl(); connection(deriveConnectionStatus(connected, result.watching)); $("load-error").hidden = true; render();
+    if (previousPhase === "planning" && currentPhase === "execution") phaseTransition = true; phase = currentPhase; const shouldFocusRestoredDetails = !hydrated && viewState.detail; hydrated = true; if (shouldFocusRestoredDetails) focusDetailsOnNextRender = true; syncUrl(); connection(result.watching ? "live" : "stale"); $("load-error").hidden = true; render();
     if (shouldFocusRestoredDetails && selectedTask) {
       const card = document.querySelector<HTMLElement>(`[data-task-id="${CSS.escape(selectedTask)}"]`);
       card?.scrollIntoView({ block: "center", inline: "center" });
@@ -671,7 +679,7 @@ window.addEventListener("resize", () => { refreshResponsiveDetails(); syncPlanIn
 anyHoverCapability.addEventListener("change", refreshResponsiveDetails); anyFinePointerCapability.addEventListener("change", refreshResponsiveDetails);
 const stream = new EventSource("api/events"); stream.addEventListener("open", () => { connected = true; connection("live"); void refresh(); }); stream.addEventListener("revision", () => void refresh()); stream.addEventListener("stale", () => { connected = false; connection("stale"); }); stream.addEventListener("heartbeat", (event) => { try { if (JSON.parse((event as MessageEvent).data).watching && !connected) { connected = true; void refresh(); } } catch { connection("stale"); } }); stream.addEventListener("error", () => { connected = false; connection("stale"); });
 hoverBridge = createHoverPreviewBridge($("hover-preview"), dismissHoverPreview);
-window.setInterval(refreshCardDurations, 60_000);
+window.setInterval(refreshCardDurations, 60_000); window.setInterval(() => { if (!connected) void refresh(); }, 5_000);
 connection("connecting"); void loadTheme(); void refresh();
 
 stream.addEventListener("agent-output", event => {

package/toolkit/skills/multi-task-flow/web/atomic-graph-view.tsx

@@ -11,7 +11,7 @@ type AtomicCardData = { title: string; kind: string; state: string; scope: strin
 
 const AtomicCard = memo(function AtomicCard({ data }: NodeProps) {
   const value = data as unknown as AtomicCardData;
-  return <div className="dependency-card atomic-dependency-card" data-context-kind={value.taskId ? "task" : undefined} data-context-id={value.taskId ?? value.nodeId}>
+  return <div className="dependency-card atomic-dependency-card" data-context-kind={value.taskId ? "task" : undefined} data-context-id={value.taskId ?? value.nodeId} data-state={value.state} style={{ "--node-color": value.color } as React.CSSProperties}>
     <div className="dependency-card-meta"><span>{value.kind}</span><span>{value.state}</span></div>
     <div className="dependency-card-title">{value.title}</div>
     <div className="atomic-dependency-scope">{value.scope}</div>

package/toolkit/skills/multi-task-flow/web/details-content.ts

@@ -50,6 +50,11 @@ function field(container: HTMLElement, name: string, value: HTMLElement | string
   container.append(row);
 }
 
+function requirementsValue(path: string | null, kind: "task" | "group", id: string): HTMLElement {
+  if (path) return link("查看 Markdown", `api/document/${kind}-${encodeURIComponent(id)}`);
+  return text("span", kind === "task" ? "未配置任务文档" : "未配置交付单元文档", "detail-placeholder");
+}
+
 function emptyOutput(): HTMLElement {
   const value = text("span", "", "detail-empty-output");
   value.dataset.emptyLabel = "尚无 Agent 输出";
@@ -223,7 +228,7 @@ export function createDetailContent(context: DetailContentContext) {
     field(container, "调度状态", task.dispatch_readiness === "blocked" ? `不可调度：${task.dispatch_diagnostics?.map((item) => item.message).join("；") || "未知原因"}` : task.dispatch_readiness === "ready" ? "可调度" : "未知");
     const pr = context.safeExternal(task.pr?.url ?? null);
     if (pr) field(container, "子 PR", link("查看 PR", pr));
-    if (task.requirements_path) field(container, "任务要求", link("查看 Markdown", `api/document/task-${encodeURIComponent(task.id)}`));
+    field(container, "任务要求", requirementsValue(task.requirements_path, "task", task.id));
     for (const follow of data.follow_prs.filter((item) => item.origin_task_id === task.id)) {
       const url = context.safeExternal(follow.pr.url);
       field(container, "Follow PR", url ? link(context.labels[follow.state] ?? follow.state, url) : context.labels[follow.state] ?? follow.state);
@@ -266,7 +271,7 @@ export function createDetailContent(context: DetailContentContext) {
     field(container, "调度状态", group.dispatch_readiness === "blocked" ? `不可调度：${group.dispatch_diagnostics?.map((item) => item.message).join("；") || "未知原因"}` : group.dispatch_readiness === "ready" ? "可调度" : "未知");
     const pr = context.safeExternal(group.parent_pr?.url ?? null);
     field(container, "父 PR", pr ? link("查看 PR", pr) : "尚未创建");
-    if (group.requirements_path) field(container, "交付单元要求", link("查看 Markdown", `api/document/group-${encodeURIComponent(group.id)}`));
+    field(container, "交付单元要求", requirementsValue(group.requirements_path, "group", group.id));
     restore();
   };
 

package/toolkit/skills/multi-task-flow/web/graph-layout.ts

@@ -1,5 +1,5 @@
 import ELK, { type ElkNode, type ElkExtendedEdge } from 'elkjs/lib/elk.bundled.js';
-import type { GraphProjection, GraphProjectionNode } from './graph-projection';
+import type { GraphDependencyPath, GraphProjection, GraphProjectionNode } from './graph-projection';
 
 export const CARD_WIDTH = 184;
 export const CARD_HEIGHT = 76;
@@ -14,7 +14,7 @@ export function cardSize(title: string): {width:number;height:number} {
 }
 export type Direction = 'DOWN' | 'RIGHT';
 export type PlacedNode = { node: GraphProjectionNode; x: number; y: number; width: number; height: number };
-export type RoutedEdge = { id: string; source: string; target: string; path: string };
+export type RoutedEdge = { id: string; source: string; target: string; path: string; paths: GraphDependencyPath[] };
 export type GraphLayout = { nodes: PlacedNode[]; edges: RoutedEdge[]; width: number; height: number };
 const elk = new ELK();
 
@@ -74,7 +74,7 @@ export async function layoutProjection(projection: GraphProjection, direction: D
         return points.map((p, i) => `${i ? 'L' : 'M'} ${p.x + origin.x} ${p.y + origin.y}`).join(' ');
       }).join(' ');
       if (!path) throw new Error(`No route for dependency ${e.id}`);
-      routed.push({ id: e.id, source: edge.source, target: edge.target, path });
+      routed.push({ id: e.id, source: edge.source, target: edge.target, path, paths: edge.paths });
     }
     for (const child of container.children ?? []) {
       const px = x + (child.x ?? 0), py = y + (child.y ?? 0);

package/toolkit/skills/source-manifest.json

@@ -4783,7 +4783,7 @@
       "path": "skills/docs-migrate/scripts/gen_legacy_spec_id.ts",
       "sourceBlob": "6bcf8926418380aafe14afabd512a010faafdf40",
       "sourceSha256": "b70dad1c77198005f963ed9920f2a33179feebcd9ad10aa5656109fe096674dc",
-      "installedSha256": "c72026d4319fca4f6f27fc396d57702d162642c1b7f9a4a148aefb47ebdb272b",
+      "installedSha256": "c9d4a1504c7a5094db8363eadb0cf74456956defffa2e399a8c339d88f88f123",
       "adaptation": "loomhelm-runtime-path-or-contract-adaptation"
     },
     {
@@ -4791,7 +4791,7 @@
       "path": "skills/docs-migrate/scripts/specs_migrate_guard.ts",
       "sourceBlob": "5ce28b4bbe3d07397b7114778a77f536d0ffb0bb",
       "sourceSha256": "33882907d111bfc45275e363f37689113a41a5029fe03969e3d4e33b00b9f7c3",
-      "installedSha256": "31f0435d3d2cec6a235aa9b5bcda0db4c6760c5147418a8b648b7fce6baee90d",
+      "installedSha256": "4d24cc436c53dc31da652298a91acc88eb70d1d10efa6128e3b91d797ee530cf",
       "adaptation": "loomhelm-runtime-path-or-contract-adaptation"
     },
     {
@@ -5279,7 +5279,7 @@
       "path": "skills/docs/vendor/dot-codex/design/multi-task-flow/data-and-scripts.md",
       "sourceBlob": "d74ef9fd234727b0c4d986b7d42c8183b0ca429c",
       "sourceSha256": "f7303b567bc0ca47e54d362c3ddbf8ea429ff1279069280b18eb2ae1138f53fe",
-      "installedSha256": "11f06cd18b6c6b68883baea248130f7960d88e5f87f58d10b848b8dc26acdd9a",
+      "installedSha256": "89509dce386ad6dca3846aecec554f6abfb53ccd428e1e0d1f33a2322b75985d",
       "adaptation": "loomhelm-runtime-path-or-contract-adaptation"
     },
     {
@@ -13639,7 +13639,7 @@
       "path": "skills/find-next-plan/scripts/find_next_plan.ts",
       "sourceBlob": "68728b262d1ca7acf1d53679764f9e1ee73e8c56",
       "sourceSha256": "3e4cc07c6153d708b36c5adeb558a4908a986bbcd13c91ab8ed79426dcd5df1a",
-      "installedSha256": "158191fed490ba633eb5e6d0b1401f3c76fc715846c0da911063541b89a5cee0",
+      "installedSha256": "d04443d9d3149edb89df0a5fc4f403d1afcd64e6725c01c921aa439d54daa09b",
       "adaptation": "loomhelm-runtime-path-or-contract-adaptation"
     },
     {
@@ -13823,7 +13823,7 @@
       "path": "skills/hardware-doc-ingest/scripts/ingest_mineru_extract.ts",
       "sourceBlob": "1074e6c64e0d03efe7fbc7155efc16fcc5351df5",
       "sourceSha256": "d648b7cb63b5c483713bdc1d7431c25ee2d8f8e182f3a2594c8407d4826bf003",
-      "installedSha256": "348f5eccb4c26b2cab90c72d5b1142e47c06594f66037b26e8953423f81de222",
+      "installedSha256": "adec761af4c672eb765213d6240d7c5a0362a4c3ca6d7e4ad674873ef091309e",
       "adaptation": "loomhelm-runtime-path-or-contract-adaptation"
     },
     {
@@ -13831,7 +13831,7 @@
       "path": "skills/hardware-doc-ingest/scripts/verify_doc_locks.ts",
       "sourceBlob": "95ed496227be9431235072e649148b51e0befbf7",
       "sourceSha256": "8b4cf4fac788e5e881584e44bfe6ff1398698788bc93dc72ea7bc0c696c253ff",
-      "installedSha256": "55ee706f272fc49b0d625354442355321f3610293dcfe8fab699b7484565aa1f",
+      "installedSha256": "51d59ff3de744de6fe645e3c55d88cf4588df0b7f35d4b106521acb368854edb",
       "adaptation": "loomhelm-runtime-path-or-contract-adaptation"
     },
     {
@@ -14143,7 +14143,7 @@
       "path": "skills/multi-task-flow/lib/engine.ts",
       "sourceBlob": "ffd435e1e2211f7aecadab3004a909ff2828df07",
       "sourceSha256": "a4d00c849601abdbe2e08ccb26978fba04ca4042b33213e46c1206aa47273a8b",
-      "installedSha256": "83b2137396dc3685065329384bc9032c31edfc8bd8492017d50f08f5187e6a99",
+      "installedSha256": "672948317de596e24712f03fd4a317a5bd16d152adf2de0a28296b1ef875eb2e",
       "adaptation": "loomhelm-runtime-path-or-contract-adaptation"
     },
     {
@@ -14199,7 +14199,7 @@
       "path": "skills/multi-task-flow/scripts/preview-source.ts",
       "sourceBlob": "b981ff666ba822f9fc4621c9feb74fa731a5a3fb",
       "sourceSha256": "ccff74579eb134f44efcb4322883c5c3a0a25d1d1aa0552b0d4835d6e000441c",
-      "installedSha256": "3cc1b74ac65267b932deb1c7289caeb0095b21b67908be66e4690927603579ef",
+      "installedSha256": "ee6c9e545ef6548d0f4c58cfe07d631f7bdbab5f69f3e7aacce7096eb04521f3",
       "adaptation": "loomhelm-runtime-path-or-contract-adaptation"
     },
     {
@@ -14447,7 +14447,7 @@
       "path": "skills/multi-task-flow/lib/view.ts",
       "sourceBlob": "b00e4b31ea1ae1dce408e0c2f45cd103bf958299",
       "sourceSha256": "0a2018fac0ed8b824e1d8c5c709d0ed6e7a851035950e8ed74aa5e846f6be80f",
-      "installedSha256": "be52009ff2efc06399df0363d2797df327191be3f4b1b8c61b71c253c72d4d73",
+      "installedSha256": "e8476e4192cb5e8cca19332c6019169e22f2c374d36f1e1285e14a396cf85168",
       "adaptation": "loomhelm-runtime-path-or-contract-adaptation"
     },
     {
@@ -14511,7 +14511,7 @@
       "path": "skills/multi-task-flow/scripts/preview-source.ts",
       "sourceBlob": "b981ff666ba822f9fc4621c9feb74fa731a5a3fb",
       "sourceSha256": "ccff74579eb134f44efcb4322883c5c3a0a25d1d1aa0552b0d4835d6e000441c",
-      "installedSha256": "3cc1b74ac65267b932deb1c7289caeb0095b21b67908be66e4690927603579ef",
+      "installedSha256": "ee6c9e545ef6548d0f4c58cfe07d631f7bdbab5f69f3e7aacce7096eb04521f3",
       "adaptation": "loomhelm-runtime-path-or-contract-adaptation"
     },
     {
@@ -14631,7 +14631,7 @@
       "path": "skills/multi-task-flow/tests/engine.test.ts",
       "sourceBlob": "211c5f1c5aa29985081f46b57abafdd3fa6b754a",
       "sourceSha256": "d5b24f927769c659fad43d83bf3ef9dd6e2df68339ccdc29be7cfa695c817361",
-      "installedSha256": "2b8fdbc256f261482351c23490393c8ad88332985abd8ac6221cbea0323acf3c",
+      "installedSha256": "34d4662ff19a0d36b7386885c16fff750a51f8812a9f817e60a8ec8b7a90e39e",
       "adaptation": "loomhelm-runtime-path-or-contract-adaptation"
     },
     {
@@ -14775,7 +14775,7 @@
       "path": "skills/multi-task-flow/tests/source-preview.test.ts",
       "sourceBlob": "759489ffa2d2ea0cf4411e747046e8f7dc017815",
       "sourceSha256": "e5a019831e074091806f37346aa7a7dee0db5467c236a1cf9a5c2c8fc4870329",
-      "installedSha256": "b823535aade9c6daddd5e3f5b555c50b89229935473ebf130e0cbfdb997f933e",
+      "installedSha256": "eb560c232142e7aa3ff7e6d2ebba5aebeb60e302ec333cff549a35009d59fc3f",
       "adaptation": "loomhelm-runtime-path-or-contract-adaptation"
     },
     {
@@ -14831,7 +14831,7 @@
       "path": "skills/multi-task-flow/tests/ui/details-content.test.ts",
       "sourceBlob": "bd05dc0398e199e9b5a5010ea4329af4ebf4991f",
       "sourceSha256": "e03962e6cdf54fd31b7c1d788a8b906f93fb3aaa4b8dc501733984d5a4e99bf3",
-      "installedSha256": "f66dc310c4429e56e8be6fbda8786bba7432df8af9dc284edc0b7e8f6e5b3d4b",
+      "installedSha256": "bb7037a8db984c01c3ffaea254c57607dbdfc550c32c7457f3f92130aa98725a",
       "adaptation": "loomhelm-runtime-path-or-contract-adaptation"
     },
     {
@@ -14927,7 +14927,7 @@
       "path": "skills/multi-task-flow/tests/view.test.ts",
       "sourceBlob": "81ef081c97958bfa0dbb2af589b093759b84a580",
       "sourceSha256": "a43f02f3ff17082a838ca3b15d112e2d973ec8b9588b670e796333aa19795979",
-      "installedSha256": "4dc952f552ddb45d0e8c181a05fd0bdbfb51c6db1cb891a6c85bf080ef3e57c0",
+      "installedSha256": "5e50fa29c29d9d87461c2ba4760523b5f3fccf4892a7418d86c27e01e3a2beac",
       "adaptation": "loomhelm-runtime-path-or-contract-adaptation"
     },
     {
@@ -14943,7 +14943,7 @@
       "path": "skills/multi-task-flow/web/app.css",
       "sourceBlob": "d780bf6377130ac519e4b7f2441da710b8767401",
       "sourceSha256": "1f59981d582f4ea2b4e012e16792075e82a2036cc05d6227159f487935f28e84",
-      "installedSha256": "56723f2e1aa687c2fc7d2160d14c5c567ef664837c017e485c9fd36d3b02becb",
+      "installedSha256": "b7ab3c0588f692800bbd7e26ef4c10a943d37984984a98314910721383fb9084",
       "adaptation": "loomhelm-runtime-path-or-contract-adaptation"
     },
     {
@@ -14951,7 +14951,7 @@
       "path": "skills/multi-task-flow/web/app.ts",
       "sourceBlob": "ad0cd71bd39e30cda7091c443db26e7b00452d56",
       "sourceSha256": "7de5958eda17175d1e68f79f07093bdd6f545228eb9fadd4b7e21c43a9a25940",
-      "installedSha256": "a3bb5a07419ce78c096b5e55c4b4d28aef2c731b5abc41146fc8a033e993834a",
+      "installedSha256": "229f2a7c6a5c6ed0e8e8ad06dc70318508ffb4f8008c9b3045de60b9abc25f57",
       "adaptation": "loomhelm-runtime-path-or-contract-adaptation"
     },
     {
@@ -14983,7 +14983,7 @@
       "path": "skills/multi-task-flow/web/details-content.ts",
       "sourceBlob": "45e9378337970c2ecbb86811d54c69224555792a",
       "sourceSha256": "e0b8c7aefe55105b49debc173dbe3e0922bbe35db435b3be8b3476fa35594ff1",
-      "installedSha256": "e09ab054b687bc50c03c72295123a8d7215dd3d59336b31f030d4385a3ae8fee",
+      "installedSha256": "9620be071169d9a4f551717f3add1c05ffd47cc4b9d123a4eb7526cea95c9643",
       "adaptation": "loomhelm-runtime-path-or-contract-adaptation"
     },
     {
@@ -15383,7 +15383,7 @@
       "path": "skills/spec-sync/SKILL.md",
       "sourceBlob": "1c058da70a873a7d1425f19337d38c22787ce307",
       "sourceSha256": "074704e78693e5750d5b99b4bbe6ff8e67d93be5ab4c8cb8f3da76efe25ca449",
-      "installedSha256": "101142f40a1e7945f9d8422a60be4e159390ec52d958710c8eb823f43adcabfd",
+      "installedSha256": "61903ef699acec12246e5c728652e69e075672fd25f34f06b076cadcb568f34d",
       "adaptation": "loomhelm-runtime-path-or-contract-adaptation"
     },
     {
@@ -15407,7 +15407,7 @@
       "path": "skills/spec-sync/scripts/spec_drift_check.ts",
       "sourceBlob": "780164ae33fcdd77be2083556e65f255ef74dc1b",
       "sourceSha256": "52a22b230acb70c7a860815761ab25d073b8d3503318cbe96237ce799e2c318e",
-      "installedSha256": "132e6d35869e25f4f7c1acba2e716483e433b1ac597b7c1e52dd36271e58cb97",
+      "installedSha256": "d6f381d2f5834350af28e097bc02d608d445a1ea55f384f3ea2037c0f6f115b8",
       "adaptation": "loomhelm-runtime-path-or-contract-adaptation"
     },
     {
@@ -15814,7 +15814,7 @@
     },
     {
       "path": "skills/multi-task-flow/web/graph-layout.ts",
-      "installedSha256": "8531cdaf5f22eb64836ae89274daf62c5f1cab5bdcd85306aab41b20811fb2a6"
+      "installedSha256": "9ad5f77628c365b9c8a7f6332287fd6d2a37eef48cb3f46b808dcaad5e6c9c3b"
     },
     {
       "path": "skills/multi-task-flow/web/graph-view.tsx",
@@ -15858,8 +15858,8 @@
     },
     {
       "path": "skills/multi-task-flow/scripts/package-client-skills.ts",
-      "installedSha256": "cc2b75ed0584f4d4bb6714fbbd2b4e22d60751f519b13135df8004248c97dc5b",
-      "sha256": "cc2b75ed0584f4d4bb6714fbbd2b4e22d60751f519b13135df8004248c97dc5b"
+      "installedSha256": "e78f054198f728d8296752de9ac5a1a8b93dafdd94cb688e76492c8850999622",
+      "sha256": "e78f054198f728d8296752de9ac5a1a8b93dafdd94cb688e76492c8850999622"
     },
     {
       "path": "skills/multi-task-flow/lib/package-source.ts",
@@ -15899,7 +15899,7 @@
     },
     {
       "path": "skills/support-manifest.json",
-      "installedSha256": "bab89370c2877d854cbff187eb3c96e67f103d182c0cb1e69289c7d4b50203d8"
+      "installedSha256": "be3e17b0311084e508b199210aa4b5b93eda803ecc684fe4c7cef9098ee6b6e8"
     },
     {
       "path": "skills/docs/vendor/dot-codex/specs/multi-task-flow/assets/output-tooltip-boundary.png",
@@ -15967,19 +15967,323 @@
     },
     {
       "path": "skills/multi-task-flow/lib/atomic-orchestration.ts",
-      "installedSha256": "f132c6814401b82abe0cbd2d52bb409c483ff5f3095c83eb7007bae70b3c8834"
+      "installedSha256": "718e199ad63ae3ae12f0c947bec3ec196c417c8664c512b3141851bc903bc406"
     },
     {
       "path": "skills/multi-task-flow/tests/atomic-orchestration-schema.test.ts",
-      "installedSha256": "719f03add0990d73b4303745766b51ae2ee545c18883c9c8a9f11fc3a0d9f66d"
+      "installedSha256": "0a7785f8a819e044087180fa81b5a2e4df56e9fe3aeb7fcfc2be8025f61666e5"
     },
     {
       "path": "skills/multi-task-flow/web/atomic-graph-view.tsx",
-      "installedSha256": "6c157adb3cd47c6812b9e06dc7d7ed21486a8ccf7a334a934c9e4aef62745a50"
+      "installedSha256": "c124d99254e6c88039e5720e0fc97cc60b41a4fb8e7a2cfeb8e0accea112cf09"
     },
     {
       "path": "skills/multi-task-flow/tests/task-kind.test.ts",
       "installedSha256": "9ec45fe7dd7209cec6cac9b392071c052f9d3f97533bcaf380fc1bfc2c5c8df3"
+    },
+    {
+      "path": "skills/docs-migrate/scripts/_runtime/compatibility_docs.ts",
+      "installedSha256": "9667a37ae7704fce28b7d967ac671f2d02d39309acad2d906b28849b91fa6420"
+    },
+    {
+      "path": "skills/docs-migrate/scripts/_runtime/compatibility_shared.ts",
+      "installedSha256": "dac757da193b15f7b8c5c31cae0f44acc5eb370336bcbd31dce3c26b710e39e3"
+    },
+    {
+      "path": "skills/docs-migrate/scripts/_runtime/compatibility_cli.ts",
+      "installedSha256": "01ec1aebde5a63a5e0c8d125583bc3ab7e2efa81e36fb6690822dd8f31c244f0"
+    },
+    {
+      "path": "skills/docs-migrate/scripts/_runtime/modules/checks/replay.ts",
+      "installedSha256": "22905c9504bf3a304618f582ea15ecfae5e9c6e51599d2839d32965e21fadef8"
+    },
+    {
+      "path": "skills/docs-migrate/scripts/_runtime/modules/docs/spec_drift_helpers.ts",
+      "installedSha256": "039f0928fe42365ef380091ca8f5a8c72d5127c23f6870072ad4f2fce7d0b3de"
+    },
+    {
+      "path": "skills/docs-migrate/scripts/_runtime/modules/docs/hardware_ingest.ts",
+      "installedSha256": "b84b43ae3c33a8d5e056a92b550769a9347b5c1af631a9ac56c3369e53c671c7"
+    },
+    {
+      "path": "skills/docs-migrate/scripts/_runtime/modules/docs/next_plan.ts",
+      "installedSha256": "e14addce4a45a25bbea58fad9aa5e41c513735130b4df5ba9f37a66176b72337"
+    },
+    {
+      "path": "skills/docs-migrate/scripts/_runtime/modules/docs/spec_contract.ts",
+      "installedSha256": "1e3cf99cb7bfa63baf8dae3f3d8d37fbf8eee846e8262af61dfbfcdfe1c7c075"
+    },
+    {
+      "path": "skills/docs-migrate/scripts/_runtime/modules/docs/spec_drift.ts",
+      "installedSha256": "74e348ed8e97a77cb3d7e4d3fe4bfffec0f4b29aa49086767c0f3f50a4d29b81"
+    },
+    {
+      "path": "skills/docs-migrate/scripts/_runtime/modules/docs/next_plan_support.ts",
+      "installedSha256": "da64c49f508a31b720d80c84eb1fadf7b7cd51a59e6b25a2d1f9cd222b535f4f"
+    },
+    {
+      "path": "skills/docs-migrate/scripts/_runtime/modules/docs/spec_drift_types.ts",
+      "installedSha256": "d1bd27dd615b78b882a662a5f2366ddaca710ff803e68dd368a1791aaea47189"
+    },
+    {
+      "path": "skills/docs-migrate/scripts/_runtime/modules/docs/spec_drift_legacy.ts",
+      "installedSha256": "2dc7e8319afdd2ad50a05d0b8af45f6dfdcee08990bcff06be11098113366e6d"
+    },
+    {
+      "path": "skills/docs-migrate/scripts/_runtime/modules/docs/spec_migration.ts",
+      "installedSha256": "06094de16ee7fefbd34b2022be16649a98af52347a1dd750f8fbfd27a6ceb4d5"
+    },
+    {
+      "path": "skills/docs-migrate/scripts/_runtime/modules/docs/migration_common.ts",
+      "installedSha256": "db4a608795b98718fc2ca0cc9e326f071cf80c842fee88137227cf2c6a623f21"
+    },
+    {
+      "path": "skills/docs-migrate/scripts/_runtime/modules/docs/spec_drift_validation.ts",
+      "installedSha256": "32eaaa686239c47f16f87ae677c8c806cfb43d4763bb5b3f7d48b0e8573823e2"
+    },
+    {
+      "path": "skills/docs-migrate/scripts/_runtime/modules/docs/legacy_spec_id.ts",
+      "installedSha256": "04b130ea1d696f8c4f0e77efc7587615a9fcf37ebda86a797035f250b8fde8c2"
+    },
+    {
+      "path": "skills/docs-migrate/scripts/_runtime/modules/docs/hardware_locks.ts",
+      "installedSha256": "5b9e4211b5c5537a88dc6f06482f6d689e043c642bb676a8c640f3814f164d16"
+    },
+    {
+      "path": "skills/docs-migrate/scripts/_runtime/modules/docs/git.ts",
+      "installedSha256": "c9800c610e230f0ab274885e0ee927680d9c2062ec203c556117f06c8e74d0d3"
+    },
+    {
+      "path": "skills/docs-migrate/scripts/_runtime/modules/docs/spec_drift_paths.ts",
+      "installedSha256": "58df37350488de3e85906d22bc461a00de17293f57d73cfc126012df25d0d187"
+    },
+    {
+      "path": "skills/hardware-doc-ingest/scripts/_runtime/compatibility_docs.ts",
+      "installedSha256": "9667a37ae7704fce28b7d967ac671f2d02d39309acad2d906b28849b91fa6420"
+    },
+    {
+      "path": "skills/hardware-doc-ingest/scripts/_runtime/compatibility_shared.ts",
+      "installedSha256": "dac757da193b15f7b8c5c31cae0f44acc5eb370336bcbd31dce3c26b710e39e3"
+    },
+    {
+      "path": "skills/hardware-doc-ingest/scripts/_runtime/compatibility_cli.ts",
+      "installedSha256": "01ec1aebde5a63a5e0c8d125583bc3ab7e2efa81e36fb6690822dd8f31c244f0"
+    },
+    {
+      "path": "skills/hardware-doc-ingest/scripts/_runtime/modules/checks/replay.ts",
+      "installedSha256": "22905c9504bf3a304618f582ea15ecfae5e9c6e51599d2839d32965e21fadef8"
+    },
+    {
+      "path": "skills/hardware-doc-ingest/scripts/_runtime/modules/docs/spec_drift_helpers.ts",
+      "installedSha256": "039f0928fe42365ef380091ca8f5a8c72d5127c23f6870072ad4f2fce7d0b3de"
+    },
+    {
+      "path": "skills/hardware-doc-ingest/scripts/_runtime/modules/docs/hardware_ingest.ts",
+      "installedSha256": "b84b43ae3c33a8d5e056a92b550769a9347b5c1af631a9ac56c3369e53c671c7"
+    },
+    {
+      "path": "skills/hardware-doc-ingest/scripts/_runtime/modules/docs/next_plan.ts",
+      "installedSha256": "e14addce4a45a25bbea58fad9aa5e41c513735130b4df5ba9f37a66176b72337"
+    },
+    {
+      "path": "skills/hardware-doc-ingest/scripts/_runtime/modules/docs/spec_contract.ts",
+      "installedSha256": "1e3cf99cb7bfa63baf8dae3f3d8d37fbf8eee846e8262af61dfbfcdfe1c7c075"
+    },
+    {
+      "path": "skills/hardware-doc-ingest/scripts/_runtime/modules/docs/spec_drift.ts",
+      "installedSha256": "74e348ed8e97a77cb3d7e4d3fe4bfffec0f4b29aa49086767c0f3f50a4d29b81"
+    },
+    {
+      "path": "skills/hardware-doc-ingest/scripts/_runtime/modules/docs/next_plan_support.ts",
+      "installedSha256": "da64c49f508a31b720d80c84eb1fadf7b7cd51a59e6b25a2d1f9cd222b535f4f"
+    },
+    {
+      "path": "skills/hardware-doc-ingest/scripts/_runtime/modules/docs/spec_drift_types.ts",
+      "installedSha256": "d1bd27dd615b78b882a662a5f2366ddaca710ff803e68dd368a1791aaea47189"
+    },
+    {
+      "path": "skills/hardware-doc-ingest/scripts/_runtime/modules/docs/spec_drift_legacy.ts",
+      "installedSha256": "2dc7e8319afdd2ad50a05d0b8af45f6dfdcee08990bcff06be11098113366e6d"
+    },
+    {
+      "path": "skills/hardware-doc-ingest/scripts/_runtime/modules/docs/spec_migration.ts",
+      "installedSha256": "06094de16ee7fefbd34b2022be16649a98af52347a1dd750f8fbfd27a6ceb4d5"
+    },
+    {
+      "path": "skills/hardware-doc-ingest/scripts/_runtime/modules/docs/migration_common.ts",
+      "installedSha256": "db4a608795b98718fc2ca0cc9e326f071cf80c842fee88137227cf2c6a623f21"
+    },
+    {
+      "path": "skills/hardware-doc-ingest/scripts/_runtime/modules/docs/spec_drift_validation.ts",
+      "installedSha256": "32eaaa686239c47f16f87ae677c8c806cfb43d4763bb5b3f7d48b0e8573823e2"
+    },
+    {
+      "path": "skills/hardware-doc-ingest/scripts/_runtime/modules/docs/legacy_spec_id.ts",
+      "installedSha256": "04b130ea1d696f8c4f0e77efc7587615a9fcf37ebda86a797035f250b8fde8c2"
+    },
+    {
+      "path": "skills/hardware-doc-ingest/scripts/_runtime/modules/docs/hardware_locks.ts",
+      "installedSha256": "5b9e4211b5c5537a88dc6f06482f6d689e043c642bb676a8c640f3814f164d16"
+    },
+    {
+      "path": "skills/hardware-doc-ingest/scripts/_runtime/modules/docs/git.ts",
+      "installedSha256": "c9800c610e230f0ab274885e0ee927680d9c2062ec203c556117f06c8e74d0d3"
+    },
+    {
+      "path": "skills/hardware-doc-ingest/scripts/_runtime/modules/docs/spec_drift_paths.ts",
+      "installedSha256": "58df37350488de3e85906d22bc461a00de17293f57d73cfc126012df25d0d187"
+    },
+    {
+      "path": "skills/spec-sync/scripts/_runtime/compatibility_docs.ts",
+      "installedSha256": "9667a37ae7704fce28b7d967ac671f2d02d39309acad2d906b28849b91fa6420"
+    },
+    {
+      "path": "skills/spec-sync/scripts/_runtime/compatibility_shared.ts",
+      "installedSha256": "dac757da193b15f7b8c5c31cae0f44acc5eb370336bcbd31dce3c26b710e39e3"
+    },
+    {
+      "path": "skills/spec-sync/scripts/_runtime/compatibility_cli.ts",
+      "installedSha256": "01ec1aebde5a63a5e0c8d125583bc3ab7e2efa81e36fb6690822dd8f31c244f0"
+    },
+    {
+      "path": "skills/spec-sync/scripts/_runtime/modules/checks/replay.ts",
+      "installedSha256": "22905c9504bf3a304618f582ea15ecfae5e9c6e51599d2839d32965e21fadef8"
+    },
+    {
+      "path": "skills/spec-sync/scripts/_runtime/modules/docs/spec_drift_helpers.ts",
+      "installedSha256": "039f0928fe42365ef380091ca8f5a8c72d5127c23f6870072ad4f2fce7d0b3de"
+    },
+    {
+      "path": "skills/spec-sync/scripts/_runtime/modules/docs/hardware_ingest.ts",
+      "installedSha256": "b84b43ae3c33a8d5e056a92b550769a9347b5c1af631a9ac56c3369e53c671c7"
+    },
+    {
+      "path": "skills/spec-sync/scripts/_runtime/modules/docs/next_plan.ts",
+      "installedSha256": "e14addce4a45a25bbea58fad9aa5e41c513735130b4df5ba9f37a66176b72337"
+    },
+    {
+      "path": "skills/spec-sync/scripts/_runtime/modules/docs/spec_contract.ts",
+      "installedSha256": "1e3cf99cb7bfa63baf8dae3f3d8d37fbf8eee846e8262af61dfbfcdfe1c7c075"
+    },
+    {
+      "path": "skills/spec-sync/scripts/_runtime/modules/docs/spec_drift.ts",
+      "installedSha256": "74e348ed8e97a77cb3d7e4d3fe4bfffec0f4b29aa49086767c0f3f50a4d29b81"
+    },
+    {
+      "path": "skills/spec-sync/scripts/_runtime/modules/docs/next_plan_support.ts",
+      "installedSha256": "da64c49f508a31b720d80c84eb1fadf7b7cd51a59e6b25a2d1f9cd222b535f4f"
+    },
+    {
+      "path": "skills/spec-sync/scripts/_runtime/modules/docs/spec_drift_types.ts",
+      "installedSha256": "d1bd27dd615b78b882a662a5f2366ddaca710ff803e68dd368a1791aaea47189"
+    },
+    {
+      "path": "skills/spec-sync/scripts/_runtime/modules/docs/spec_drift_legacy.ts",
+      "installedSha256": "2dc7e8319afdd2ad50a05d0b8af45f6dfdcee08990bcff06be11098113366e6d"
+    },
+    {
+      "path": "skills/spec-sync/scripts/_runtime/modules/docs/spec_migration.ts",
+      "installedSha256": "06094de16ee7fefbd34b2022be16649a98af52347a1dd750f8fbfd27a6ceb4d5"
+    },
+    {
+      "path": "skills/spec-sync/scripts/_runtime/modules/docs/migration_common.ts",
+      "installedSha256": "db4a608795b98718fc2ca0cc9e326f071cf80c842fee88137227cf2c6a623f21"
+    },
+    {
+      "path": "skills/spec-sync/scripts/_runtime/modules/docs/spec_drift_validation.ts",
+      "installedSha256": "32eaaa686239c47f16f87ae677c8c806cfb43d4763bb5b3f7d48b0e8573823e2"
+    },
+    {
+      "path": "skills/spec-sync/scripts/_runtime/modules/docs/legacy_spec_id.ts",
+      "installedSha256": "04b130ea1d696f8c4f0e77efc7587615a9fcf37ebda86a797035f250b8fde8c2"
+    },
+    {
+      "path": "skills/spec-sync/scripts/_runtime/modules/docs/hardware_locks.ts",
+      "installedSha256": "5b9e4211b5c5537a88dc6f06482f6d689e043c642bb676a8c640f3814f164d16"
+    },
+    {
+      "path": "skills/spec-sync/scripts/_runtime/modules/docs/git.ts",
+      "installedSha256": "c9800c610e230f0ab274885e0ee927680d9c2062ec203c556117f06c8e74d0d3"
+    },
+    {
+      "path": "skills/spec-sync/scripts/_runtime/modules/docs/spec_drift_paths.ts",
+      "installedSha256": "58df37350488de3e85906d22bc461a00de17293f57d73cfc126012df25d0d187"
+    },
+    {
+      "path": "skills/find-next-plan/scripts/_runtime/compatibility_docs.ts",
+      "installedSha256": "9667a37ae7704fce28b7d967ac671f2d02d39309acad2d906b28849b91fa6420"
+    },
+    {
+      "path": "skills/find-next-plan/scripts/_runtime/compatibility_shared.ts",
+      "installedSha256": "dac757da193b15f7b8c5c31cae0f44acc5eb370336bcbd31dce3c26b710e39e3"
+    },
+    {
+      "path": "skills/find-next-plan/scripts/_runtime/compatibility_cli.ts",
+      "installedSha256": "01ec1aebde5a63a5e0c8d125583bc3ab7e2efa81e36fb6690822dd8f31c244f0"
+    },
+    {
+      "path": "skills/find-next-plan/scripts/_runtime/modules/checks/replay.ts",
+      "installedSha256": "22905c9504bf3a304618f582ea15ecfae5e9c6e51599d2839d32965e21fadef8"
+    },
+    {
+      "path": "skills/find-next-plan/scripts/_runtime/modules/docs/spec_drift_helpers.ts",
+      "installedSha256": "039f0928fe42365ef380091ca8f5a8c72d5127c23f6870072ad4f2fce7d0b3de"
+    },
+    {
+      "path": "skills/find-next-plan/scripts/_runtime/modules/docs/hardware_ingest.ts",
+      "installedSha256": "b84b43ae3c33a8d5e056a92b550769a9347b5c1af631a9ac56c3369e53c671c7"
+    },
+    {
+      "path": "skills/find-next-plan/scripts/_runtime/modules/docs/next_plan.ts",
+      "installedSha256": "e14addce4a45a25bbea58fad9aa5e41c513735130b4df5ba9f37a66176b72337"
+    },
+    {
+      "path": "skills/find-next-plan/scripts/_runtime/modules/docs/spec_contract.ts",
+      "installedSha256": "1e3cf99cb7bfa63baf8dae3f3d8d37fbf8eee846e8262af61dfbfcdfe1c7c075"
+    },
+    {
+      "path": "skills/find-next-plan/scripts/_runtime/modules/docs/spec_drift.ts",
+      "installedSha256": "74e348ed8e97a77cb3d7e4d3fe4bfffec0f4b29aa49086767c0f3f50a4d29b81"
+    },
+    {
+      "path": "skills/find-next-plan/scripts/_runtime/modules/docs/next_plan_support.ts",
+      "installedSha256": "da64c49f508a31b720d80c84eb1fadf7b7cd51a59e6b25a2d1f9cd222b535f4f"
+    },
+    {
+      "path": "skills/find-next-plan/scripts/_runtime/modules/docs/spec_drift_types.ts",
+      "installedSha256": "d1bd27dd615b78b882a662a5f2366ddaca710ff803e68dd368a1791aaea47189"
+    },
+    {
+      "path": "skills/find-next-plan/scripts/_runtime/modules/docs/spec_drift_legacy.ts",
+      "installedSha256": "2dc7e8319afdd2ad50a05d0b8af45f6dfdcee08990bcff06be11098113366e6d"
+    },
+    {
+      "path": "skills/find-next-plan/scripts/_runtime/modules/docs/spec_migration.ts",
+      "installedSha256": "06094de16ee7fefbd34b2022be16649a98af52347a1dd750f8fbfd27a6ceb4d5"
+    },
+    {
+      "path": "skills/find-next-plan/scripts/_runtime/modules/docs/migration_common.ts",
+      "installedSha256": "db4a608795b98718fc2ca0cc9e326f071cf80c842fee88137227cf2c6a623f21"
+    },
+    {
+      "path": "skills/find-next-plan/scripts/_runtime/modules/docs/spec_drift_validation.ts",
+      "installedSha256": "32eaaa686239c47f16f87ae677c8c806cfb43d4763bb5b3f7d48b0e8573823e2"
+    },
+    {
+      "path": "skills/find-next-plan/scripts/_runtime/modules/docs/legacy_spec_id.ts",
+      "installedSha256": "04b130ea1d696f8c4f0e77efc7587615a9fcf37ebda86a797035f250b8fde8c2"
+    },
+    {
+      "path": "skills/find-next-plan/scripts/_runtime/modules/docs/hardware_locks.ts",
+      "installedSha256": "5b9e4211b5c5537a88dc6f06482f6d689e043c642bb676a8c640f3814f164d16"
+    },
+    {
+      "path": "skills/find-next-plan/scripts/_runtime/modules/docs/git.ts",
+      "installedSha256": "c9800c610e230f0ab274885e0ee927680d9c2062ec203c556117f06c8e74d0d3"
+    },
+    {
+      "path": "skills/find-next-plan/scripts/_runtime/modules/docs/spec_drift_paths.ts",
+      "installedSha256": "58df37350488de3e85906d22bc461a00de17293f57d73cfc126012df25d0d187"
     }
   ],
   "exclusions": [

package/toolkit/skills/spec-sync/SKILL.md

@@ -35,7 +35,7 @@ Keep topic-level specs in `docs/specs/` aligned with behavior, contracts, and ac
   - `Spec同步证据=<spec_paths@sha_csv|未检查>`
   - `结束原因=<one-line>`
 - When a canonical `SPEC.md` contains `## Related ADRs`, the detector validates that the section is either exactly `None` or path-sorted, duplicate-free Markdown links to existing `docs/adr/<NNNN>-<slug>.md` files. A missing ADR status is compatible with `accepted`; explicit `superseded` or `deprecated`, another non-accepted status, or an invalid target blocks sync. Specs without the section remain readable compatibility inputs.
-- When a canonical `SPEC.md` is new or modified, run `bun --no-install skills/bin/spec_contract_check.ts --path <SPEC.md>` in addition to the drift detector. Untouched legacy and external Specs remain readable compatibility inputs.
+- When a canonical `SPEC.md` is new or modified, run `bun --no-install skills/spec-sync/scripts/spec_contract_check.ts --path <SPEC.md>` in addition to the drift detector. Untouched legacy and external Specs remain readable compatibility inputs.
 
 ## Workflow