@loomhelm/multi-task-flow 0.2.6 → 0.2.7

package/README.md

@@ -17,16 +17,16 @@ bunx --bun --package @loomhelm/multi-task-flow@compat-v1 multi-task-flow flow vi
 可重复的生产安装必须固定 package version；`@compat-v1` 只用于接收同一兼容线内经过门禁的最新版本，`latest` 不构成身份或兼容性证明。运行前置条件是 `bun --version` 返回 `1.4.4`；Bun 由宿主提供，包不会替换或升级它。
 
 ```sh
-bunx --bun --package @loomhelm/multi-task-flow@0.2.6 multi-task-flow skills list
+bunx --bun --package @loomhelm/multi-task-flow@0.2.7 multi-task-flow skills list
 bunx --bun --package @loomhelm/multi-task-flow@compat-v1 multi-task-flow skills list
-bunx --bun --package @loomhelm/multi-task-flow@0.2.6 multi-task-flow flow view --input - < view-request.json
+bunx --bun --package @loomhelm/multi-task-flow@0.2.7 multi-task-flow flow view --input - < view-request.json
 ```
 
 当前源码投影的内部合同矩阵如下；`source_sha`、`merge_sha`、`build_id` 和 `tarball_digest` 是每个候选构建的独立身份字段，不能由这张静态表推断。
 
 | 维度 | 当前值 |
 | - | - |
-| package | `@loomhelm/multi-task-flow@0.2.6` |
+| package | `@loomhelm/multi-task-flow@0.2.7` |
 | compatibility line | `compat-v1` |
 | Skill | `2.7.6` |
 | ledger contract | `3` |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@loomhelm/multi-task-flow",
-  "version": "0.2.6",
+  "version": "0.2.7",
   "description": "Versioned Bun CLI and complete Multi-task Flow Skill runtime for Loomhelm",
   "type": "module",
   "engines": {

package/toolkit/artifact-manifest.json

@@ -1,22 +1,22 @@
 {
   "schemaVersion": 2,
   "packageName": "@loomhelm/multi-task-flow",
-  "packageVersion": "0.2.6",
+  "packageVersion": "0.2.7",
   "compatibilityLine": "compat-v1",
   "skillVersion": "2.7.6",
   "sourceCommit": "505961771a0d2496155d23132a8c0bd8beac0a24",
-  "sourceSha": "9ceb989d06c612c075974a44e603b964befb9e5e",
-  "mergeSha": "9ceb989d06c612c075974a44e603b964befb9e5e",
-  "candidateSha": "9ceb989d06c612c075974a44e603b964befb9e5e",
+  "sourceSha": "a8468f20f8c70bc46de7c3ef79c456b5aa38fff6",
+  "mergeSha": "a8468f20f8c70bc46de7c3ef79c456b5aa38fff6",
+  "candidateSha": "a8468f20f8c70bc46de7c3ef79c456b5aa38fff6",
   "dirty": false,
   "runtime": "bun@1.4.4",
   "identity": {
     "packageName": "@loomhelm/multi-task-flow",
-    "packageVersion": "0.2.6",
+    "packageVersion": "0.2.7",
     "compatibilityLine": "compat-v1",
     "skillVersion": "2.7.6",
-    "sourceSha": "9ceb989d06c612c075974a44e603b964befb9e5e",
-    "mergeSha": "9ceb989d06c612c075974a44e603b964befb9e5e",
+    "sourceSha": "a8468f20f8c70bc46de7c3ef79c456b5aa38fff6",
+    "mergeSha": "a8468f20f8c70bc46de7c3ef79c456b5aa38fff6",
     "dirty": false,
     "contracts": {
       "ledgerContract": 3,
@@ -25,13 +25,13 @@
       "viewerContract": 5,
       "serviceVersion": "1"
     },
-    "tarballDigest": "d5c42b1368edf76483c34789032217e6d8c8db4be9f5570ea1245db220f88748",
-    "gitTag": "multi-task-flow-v0.2.6",
-    "buildId": "8a67a108547a509f61c70d6ba598a2fe624a3f2474722ed904bb5ad58a23ae8e"
+    "tarballDigest": "21f0168d9f8d3a5c2ab84a6193fa8acb4c90b4d4fc7feeb50482a962e7f32cd1",
+    "gitTag": "multi-task-flow-v0.2.7",
+    "buildId": "531512d2733e5203f3359400a8a8f01d9b162d419719694f09a5d5eb3f260cd9"
   },
-  "buildId": "8a67a108547a509f61c70d6ba598a2fe624a3f2474722ed904bb5ad58a23ae8e",
-  "tarballDigest": "d5c42b1368edf76483c34789032217e6d8c8db4be9f5570ea1245db220f88748",
-  "gitTag": "multi-task-flow-v0.2.6",
+  "buildId": "531512d2733e5203f3359400a8a8f01d9b162d419719694f09a5d5eb3f260cd9",
+  "tarballDigest": "21f0168d9f8d3a5c2ab84a6193fa8acb4c90b4d4fc7feeb50482a962e7f32cd1",
+  "gitTag": "multi-task-flow-v0.2.7",
   "dependenciesBundled": true,
   "dependencies": [
     {
@@ -2446,13 +2446,89 @@
       "path": "skills/docs-migrate/references/specs-mode.md",
       "sha256": "20a996a517d14dbc33f1c061f7a37b718fe0ba2e764ff7c2ca617c55f594f71e"
     },
+    {
+      "path": "skills/docs-migrate/scripts/_runtime/compatibility_cli.ts",
+      "sha256": "01ec1aebde5a63a5e0c8d125583bc3ab7e2efa81e36fb6690822dd8f31c244f0"
+    },
+    {
+      "path": "skills/docs-migrate/scripts/_runtime/compatibility_docs.ts",
+      "sha256": "9667a37ae7704fce28b7d967ac671f2d02d39309acad2d906b28849b91fa6420"
+    },
+    {
+      "path": "skills/docs-migrate/scripts/_runtime/compatibility_shared.ts",
+      "sha256": "dac757da193b15f7b8c5c31cae0f44acc5eb370336bcbd31dce3c26b710e39e3"
+    },
+    {
+      "path": "skills/docs-migrate/scripts/_runtime/modules/checks/replay.ts",
+      "sha256": "22905c9504bf3a304618f582ea15ecfae5e9c6e51599d2839d32965e21fadef8"
+    },
+    {
+      "path": "skills/docs-migrate/scripts/_runtime/modules/docs/git.ts",
+      "sha256": "c9800c610e230f0ab274885e0ee927680d9c2062ec203c556117f06c8e74d0d3"
+    },
+    {
+      "path": "skills/docs-migrate/scripts/_runtime/modules/docs/hardware_ingest.ts",
+      "sha256": "b84b43ae3c33a8d5e056a92b550769a9347b5c1af631a9ac56c3369e53c671c7"
+    },
+    {
+      "path": "skills/docs-migrate/scripts/_runtime/modules/docs/hardware_locks.ts",
+      "sha256": "5b9e4211b5c5537a88dc6f06482f6d689e043c642bb676a8c640f3814f164d16"
+    },
+    {
+      "path": "skills/docs-migrate/scripts/_runtime/modules/docs/legacy_spec_id.ts",
+      "sha256": "04b130ea1d696f8c4f0e77efc7587615a9fcf37ebda86a797035f250b8fde8c2"
+    },
+    {
+      "path": "skills/docs-migrate/scripts/_runtime/modules/docs/migration_common.ts",
+      "sha256": "db4a608795b98718fc2ca0cc9e326f071cf80c842fee88137227cf2c6a623f21"
+    },
+    {
+      "path": "skills/docs-migrate/scripts/_runtime/modules/docs/next_plan.ts",
+      "sha256": "e14addce4a45a25bbea58fad9aa5e41c513735130b4df5ba9f37a66176b72337"
+    },
+    {
+      "path": "skills/docs-migrate/scripts/_runtime/modules/docs/next_plan_support.ts",
+      "sha256": "da64c49f508a31b720d80c84eb1fadf7b7cd51a59e6b25a2d1f9cd222b535f4f"
+    },
+    {
+      "path": "skills/docs-migrate/scripts/_runtime/modules/docs/spec_contract.ts",
+      "sha256": "1e3cf99cb7bfa63baf8dae3f3d8d37fbf8eee846e8262af61dfbfcdfe1c7c075"
+    },
+    {
+      "path": "skills/docs-migrate/scripts/_runtime/modules/docs/spec_drift.ts",
+      "sha256": "74e348ed8e97a77cb3d7e4d3fe4bfffec0f4b29aa49086767c0f3f50a4d29b81"
+    },
+    {
+      "path": "skills/docs-migrate/scripts/_runtime/modules/docs/spec_drift_helpers.ts",
+      "sha256": "039f0928fe42365ef380091ca8f5a8c72d5127c23f6870072ad4f2fce7d0b3de"
+    },
+    {
+      "path": "skills/docs-migrate/scripts/_runtime/modules/docs/spec_drift_legacy.ts",
+      "sha256": "2dc7e8319afdd2ad50a05d0b8af45f6dfdcee08990bcff06be11098113366e6d"
+    },
+    {
+      "path": "skills/docs-migrate/scripts/_runtime/modules/docs/spec_drift_paths.ts",
+      "sha256": "58df37350488de3e85906d22bc461a00de17293f57d73cfc126012df25d0d187"
+    },
+    {
+      "path": "skills/docs-migrate/scripts/_runtime/modules/docs/spec_drift_types.ts",
+      "sha256": "d1bd27dd615b78b882a662a5f2366ddaca710ff803e68dd368a1791aaea47189"
+    },
+    {
+      "path": "skills/docs-migrate/scripts/_runtime/modules/docs/spec_drift_validation.ts",
+      "sha256": "32eaaa686239c47f16f87ae677c8c806cfb43d4763bb5b3f7d48b0e8573823e2"
+    },
+    {
+      "path": "skills/docs-migrate/scripts/_runtime/modules/docs/spec_migration.ts",
+      "sha256": "06094de16ee7fefbd34b2022be16649a98af52347a1dd750f8fbfd27a6ceb4d5"
+    },
     {
       "path": "skills/docs-migrate/scripts/gen_legacy_spec_id.ts",
-      "sha256": "c72026d4319fca4f6f27fc396d57702d162642c1b7f9a4a148aefb47ebdb272b"
+      "sha256": "c9d4a1504c7a5094db8363eadb0cf74456956defffa2e399a8c339d88f88f123"
     },
     {
       "path": "skills/docs-migrate/scripts/specs_migrate_guard.ts",
-      "sha256": "31f0435d3d2cec6a235aa9b5bcda0db4c6760c5147418a8b648b7fce6baee90d"
+      "sha256": "4d24cc436c53dc31da652298a91acc88eb70d1d10efa6128e3b91d797ee530cf"
     },
     {
       "path": "skills/docs-migrate/scripts/test_gen_legacy_spec_id.ts",
@@ -6934,9 +7010,85 @@
       "path": "skills/find-next-plan/agents/openai.yaml",
       "sha256": "a1499d95abd8447558c535fe5554adcc3c9b988a0a39264a6283d430effe1e94"
     },
+    {
+      "path": "skills/find-next-plan/scripts/_runtime/compatibility_cli.ts",
+      "sha256": "01ec1aebde5a63a5e0c8d125583bc3ab7e2efa81e36fb6690822dd8f31c244f0"
+    },
+    {
+      "path": "skills/find-next-plan/scripts/_runtime/compatibility_docs.ts",
+      "sha256": "9667a37ae7704fce28b7d967ac671f2d02d39309acad2d906b28849b91fa6420"
+    },
+    {
+      "path": "skills/find-next-plan/scripts/_runtime/compatibility_shared.ts",
+      "sha256": "dac757da193b15f7b8c5c31cae0f44acc5eb370336bcbd31dce3c26b710e39e3"
+    },
+    {
+      "path": "skills/find-next-plan/scripts/_runtime/modules/checks/replay.ts",
+      "sha256": "22905c9504bf3a304618f582ea15ecfae5e9c6e51599d2839d32965e21fadef8"
+    },
+    {
+      "path": "skills/find-next-plan/scripts/_runtime/modules/docs/git.ts",
+      "sha256": "c9800c610e230f0ab274885e0ee927680d9c2062ec203c556117f06c8e74d0d3"
+    },
+    {
+      "path": "skills/find-next-plan/scripts/_runtime/modules/docs/hardware_ingest.ts",
+      "sha256": "b84b43ae3c33a8d5e056a92b550769a9347b5c1af631a9ac56c3369e53c671c7"
+    },
+    {
+      "path": "skills/find-next-plan/scripts/_runtime/modules/docs/hardware_locks.ts",
+      "sha256": "5b9e4211b5c5537a88dc6f06482f6d689e043c642bb676a8c640f3814f164d16"
+    },
+    {
+      "path": "skills/find-next-plan/scripts/_runtime/modules/docs/legacy_spec_id.ts",
+      "sha256": "04b130ea1d696f8c4f0e77efc7587615a9fcf37ebda86a797035f250b8fde8c2"
+    },
+    {
+      "path": "skills/find-next-plan/scripts/_runtime/modules/docs/migration_common.ts",
+      "sha256": "db4a608795b98718fc2ca0cc9e326f071cf80c842fee88137227cf2c6a623f21"
+    },
+    {
+      "path": "skills/find-next-plan/scripts/_runtime/modules/docs/next_plan.ts",
+      "sha256": "e14addce4a45a25bbea58fad9aa5e41c513735130b4df5ba9f37a66176b72337"
+    },
+    {
+      "path": "skills/find-next-plan/scripts/_runtime/modules/docs/next_plan_support.ts",
+      "sha256": "da64c49f508a31b720d80c84eb1fadf7b7cd51a59e6b25a2d1f9cd222b535f4f"
+    },
+    {
+      "path": "skills/find-next-plan/scripts/_runtime/modules/docs/spec_contract.ts",
+      "sha256": "1e3cf99cb7bfa63baf8dae3f3d8d37fbf8eee846e8262af61dfbfcdfe1c7c075"
+    },
+    {
+      "path": "skills/find-next-plan/scripts/_runtime/modules/docs/spec_drift.ts",
+      "sha256": "74e348ed8e97a77cb3d7e4d3fe4bfffec0f4b29aa49086767c0f3f50a4d29b81"
+    },
+    {
+      "path": "skills/find-next-plan/scripts/_runtime/modules/docs/spec_drift_helpers.ts",
+      "sha256": "039f0928fe42365ef380091ca8f5a8c72d5127c23f6870072ad4f2fce7d0b3de"
+    },
+    {
+      "path": "skills/find-next-plan/scripts/_runtime/modules/docs/spec_drift_legacy.ts",
+      "sha256": "2dc7e8319afdd2ad50a05d0b8af45f6dfdcee08990bcff06be11098113366e6d"
+    },
+    {
+      "path": "skills/find-next-plan/scripts/_runtime/modules/docs/spec_drift_paths.ts",
+      "sha256": "58df37350488de3e85906d22bc461a00de17293f57d73cfc126012df25d0d187"
+    },
+    {
+      "path": "skills/find-next-plan/scripts/_runtime/modules/docs/spec_drift_types.ts",
+      "sha256": "d1bd27dd615b78b882a662a5f2366ddaca710ff803e68dd368a1791aaea47189"
+    },
+    {
+      "path": "skills/find-next-plan/scripts/_runtime/modules/docs/spec_drift_validation.ts",
+      "sha256": "32eaaa686239c47f16f87ae677c8c806cfb43d4763bb5b3f7d48b0e8573823e2"
+    },
+    {
+      "path": "skills/find-next-plan/scripts/_runtime/modules/docs/spec_migration.ts",
+      "sha256": "06094de16ee7fefbd34b2022be16649a98af52347a1dd750f8fbfd27a6ceb4d5"
+    },
     {
       "path": "skills/find-next-plan/scripts/find_next_plan.ts",
-      "sha256": "158191fed490ba633eb5e6d0b1401f3c76fc715846c0da911063541b89a5cee0"
+      "sha256": "d04443d9d3149edb89df0a5fc4f403d1afcd64e6725c01c921aa439d54daa09b"
     },
     {
       "path": "skills/find-next-plan/scripts/test_find_next_plan.ts",
@@ -7026,13 +7178,89 @@
       "path": "skills/hardware-doc-ingest/references/docs-index-format.md",
       "sha256": "8993fcd6d1474ed20cccfb45622b7dacc9cc6384ad84a84dae9f794981adf26d"
     },
+    {
+      "path": "skills/hardware-doc-ingest/scripts/_runtime/compatibility_cli.ts",
+      "sha256": "01ec1aebde5a63a5e0c8d125583bc3ab7e2efa81e36fb6690822dd8f31c244f0"
+    },
+    {
+      "path": "skills/hardware-doc-ingest/scripts/_runtime/compatibility_docs.ts",
+      "sha256": "9667a37ae7704fce28b7d967ac671f2d02d39309acad2d906b28849b91fa6420"
+    },
+    {
+      "path": "skills/hardware-doc-ingest/scripts/_runtime/compatibility_shared.ts",
+      "sha256": "dac757da193b15f7b8c5c31cae0f44acc5eb370336bcbd31dce3c26b710e39e3"
+    },
+    {
+      "path": "skills/hardware-doc-ingest/scripts/_runtime/modules/checks/replay.ts",
+      "sha256": "22905c9504bf3a304618f582ea15ecfae5e9c6e51599d2839d32965e21fadef8"
+    },
+    {
+      "path": "skills/hardware-doc-ingest/scripts/_runtime/modules/docs/git.ts",
+      "sha256": "c9800c610e230f0ab274885e0ee927680d9c2062ec203c556117f06c8e74d0d3"
+    },
+    {
+      "path": "skills/hardware-doc-ingest/scripts/_runtime/modules/docs/hardware_ingest.ts",
+      "sha256": "b84b43ae3c33a8d5e056a92b550769a9347b5c1af631a9ac56c3369e53c671c7"
+    },
+    {
+      "path": "skills/hardware-doc-ingest/scripts/_runtime/modules/docs/hardware_locks.ts",
+      "sha256": "5b9e4211b5c5537a88dc6f06482f6d689e043c642bb676a8c640f3814f164d16"
+    },
+    {
+      "path": "skills/hardware-doc-ingest/scripts/_runtime/modules/docs/legacy_spec_id.ts",
+      "sha256": "04b130ea1d696f8c4f0e77efc7587615a9fcf37ebda86a797035f250b8fde8c2"
+    },
+    {
+      "path": "skills/hardware-doc-ingest/scripts/_runtime/modules/docs/migration_common.ts",
+      "sha256": "db4a608795b98718fc2ca0cc9e326f071cf80c842fee88137227cf2c6a623f21"
+    },
+    {
+      "path": "skills/hardware-doc-ingest/scripts/_runtime/modules/docs/next_plan.ts",
+      "sha256": "e14addce4a45a25bbea58fad9aa5e41c513735130b4df5ba9f37a66176b72337"
+    },
+    {
+      "path": "skills/hardware-doc-ingest/scripts/_runtime/modules/docs/next_plan_support.ts",
+      "sha256": "da64c49f508a31b720d80c84eb1fadf7b7cd51a59e6b25a2d1f9cd222b535f4f"
+    },
+    {
+      "path": "skills/hardware-doc-ingest/scripts/_runtime/modules/docs/spec_contract.ts",
+      "sha256": "1e3cf99cb7bfa63baf8dae3f3d8d37fbf8eee846e8262af61dfbfcdfe1c7c075"
+    },
+    {
+      "path": "skills/hardware-doc-ingest/scripts/_runtime/modules/docs/spec_drift.ts",
+      "sha256": "74e348ed8e97a77cb3d7e4d3fe4bfffec0f4b29aa49086767c0f3f50a4d29b81"
+    },
+    {
+      "path": "skills/hardware-doc-ingest/scripts/_runtime/modules/docs/spec_drift_helpers.ts",
+      "sha256": "039f0928fe42365ef380091ca8f5a8c72d5127c23f6870072ad4f2fce7d0b3de"
+    },
+    {
+      "path": "skills/hardware-doc-ingest/scripts/_runtime/modules/docs/spec_drift_legacy.ts",
+      "sha256": "2dc7e8319afdd2ad50a05d0b8af45f6dfdcee08990bcff06be11098113366e6d"
+    },
+    {
+      "path": "skills/hardware-doc-ingest/scripts/_runtime/modules/docs/spec_drift_paths.ts",
+      "sha256": "58df37350488de3e85906d22bc461a00de17293f57d73cfc126012df25d0d187"
+    },
+    {
+      "path": "skills/hardware-doc-ingest/scripts/_runtime/modules/docs/spec_drift_types.ts",
+      "sha256": "d1bd27dd615b78b882a662a5f2366ddaca710ff803e68dd368a1791aaea47189"
+    },
+    {
+      "path": "skills/hardware-doc-ingest/scripts/_runtime/modules/docs/spec_drift_validation.ts",
+      "sha256": "32eaaa686239c47f16f87ae677c8c806cfb43d4763bb5b3f7d48b0e8573823e2"
+    },
+    {
+      "path": "skills/hardware-doc-ingest/scripts/_runtime/modules/docs/spec_migration.ts",
+      "sha256": "06094de16ee7fefbd34b2022be16649a98af52347a1dd750f8fbfd27a6ceb4d5"
+    },
     {
       "path": "skills/hardware-doc-ingest/scripts/ingest_mineru_extract.ts",
-      "sha256": "348f5eccb4c26b2cab90c72d5b1142e47c06594f66037b26e8953423f81de222"
+      "sha256": "adec761af4c672eb765213d6240d7c5a0362a4c3ca6d7e4ad674873ef091309e"
     },
     {
       "path": "skills/hardware-doc-ingest/scripts/verify_doc_locks.ts",
-      "sha256": "55ee706f272fc49b0d625354442355321f3610293dcfe8fab699b7484565aa1f"
+      "sha256": "51d59ff3de744de6fe645e3c55d88cf4588df0b7f35d4b106521acb368854edb"
     },
     {
       "path": "skills/implement-only-flow/SKILL.md",
@@ -7076,7 +7304,7 @@
     },
     {
       "path": "skills/multi-task-flow/dist/app.js",
-      "sha256": "19e0df436a54c6be7e9a6899b1adc6bcf8d1acef0c80a902397db00ad6269f71"
+      "sha256": "61370d048ecf612ad847cdae28491ff796dc16307a5a60183bc83491aa6c4fc0"
     },
     {
       "path": "skills/multi-task-flow/dist/index.html",
@@ -7400,7 +7628,7 @@
     },
     {
       "path": "skills/multi-task-flow/lib/view.ts",
-      "sha256": "be52009ff2efc06399df0363d2797df327191be3f4b1b8c61b71c253c72d4d73"
+      "sha256": "0d53bfde1b57b74b70e683f9d6e601cf57f51cc94e6a65771ef01b241fd9f16f"
     },
     {
       "path": "skills/multi-task-flow/node_modules/zod/LICENSE",
@@ -11148,7 +11376,7 @@
     },
     {
       "path": "skills/multi-task-flow/web/app.ts",
-      "sha256": "a3bb5a07419ce78c096b5e55c4b4d28aef2c731b5abc41146fc8a033e993834a"
+      "sha256": "2cca4ae9a88b0045ec11094178cfcb5900fb2e0f106c8ddf3ea1c87edc54f088"
     },
     {
       "path": "skills/multi-task-flow/web/atomic-graph-view.tsx",
@@ -11184,7 +11412,7 @@
     },
     {
       "path": "skills/multi-task-flow/web/graph-layout.ts",
-      "sha256": "8531cdaf5f22eb64836ae89274daf62c5f1cab5bdcd85306aab41b20811fb2a6"
+      "sha256": "9ad5f77628c365b9c8a7f6332287fd6d2a37eef48cb3f46b808dcaad5e6c9c3b"
     },
     {
       "path": "skills/multi-task-flow/web/graph-projection.ts",
@@ -11964,23 +12192,99 @@
     },
     {
       "path": "skills/source-manifest.json",
-      "sha256": "613c0bfb32640f212dd8369a0527751804090877c45fc9956545f4f259bd4425"
+      "sha256": "2391f32a4c8177470adce6cdadbd6bbb101b3fb47d5bf6044f9f821c14301aae"
     },
     {
       "path": "skills/spec-sync/SKILL.md",
-      "sha256": "101142f40a1e7945f9d8422a60be4e159390ec52d958710c8eb823f43adcabfd"
+      "sha256": "61903ef699acec12246e5c728652e69e075672fd25f34f06b076cadcb568f34d"
     },
     {
       "path": "skills/spec-sync/agents/openai.yaml",
       "sha256": "b6ffa8a7550b2fe24a405e582c219fb7be7b1103fd76b4c3044083ebb91e2734"
     },
+    {
+      "path": "skills/spec-sync/scripts/_runtime/compatibility_cli.ts",
+      "sha256": "01ec1aebde5a63a5e0c8d125583bc3ab7e2efa81e36fb6690822dd8f31c244f0"
+    },
+    {
+      "path": "skills/spec-sync/scripts/_runtime/compatibility_docs.ts",
+      "sha256": "9667a37ae7704fce28b7d967ac671f2d02d39309acad2d906b28849b91fa6420"
+    },
+    {
+      "path": "skills/spec-sync/scripts/_runtime/compatibility_shared.ts",
+      "sha256": "dac757da193b15f7b8c5c31cae0f44acc5eb370336bcbd31dce3c26b710e39e3"
+    },
+    {
+      "path": "skills/spec-sync/scripts/_runtime/modules/checks/replay.ts",
+      "sha256": "22905c9504bf3a304618f582ea15ecfae5e9c6e51599d2839d32965e21fadef8"
+    },
+    {
+      "path": "skills/spec-sync/scripts/_runtime/modules/docs/git.ts",
+      "sha256": "c9800c610e230f0ab274885e0ee927680d9c2062ec203c556117f06c8e74d0d3"
+    },
+    {
+      "path": "skills/spec-sync/scripts/_runtime/modules/docs/hardware_ingest.ts",
+      "sha256": "b84b43ae3c33a8d5e056a92b550769a9347b5c1af631a9ac56c3369e53c671c7"
+    },
+    {
+      "path": "skills/spec-sync/scripts/_runtime/modules/docs/hardware_locks.ts",
+      "sha256": "5b9e4211b5c5537a88dc6f06482f6d689e043c642bb676a8c640f3814f164d16"
+    },
+    {
+      "path": "skills/spec-sync/scripts/_runtime/modules/docs/legacy_spec_id.ts",
+      "sha256": "04b130ea1d696f8c4f0e77efc7587615a9fcf37ebda86a797035f250b8fde8c2"
+    },
+    {
+      "path": "skills/spec-sync/scripts/_runtime/modules/docs/migration_common.ts",
+      "sha256": "db4a608795b98718fc2ca0cc9e326f071cf80c842fee88137227cf2c6a623f21"
+    },
+    {
+      "path": "skills/spec-sync/scripts/_runtime/modules/docs/next_plan.ts",
+      "sha256": "e14addce4a45a25bbea58fad9aa5e41c513735130b4df5ba9f37a66176b72337"
+    },
+    {
+      "path": "skills/spec-sync/scripts/_runtime/modules/docs/next_plan_support.ts",
+      "sha256": "da64c49f508a31b720d80c84eb1fadf7b7cd51a59e6b25a2d1f9cd222b535f4f"
+    },
+    {
+      "path": "skills/spec-sync/scripts/_runtime/modules/docs/spec_contract.ts",
+      "sha256": "1e3cf99cb7bfa63baf8dae3f3d8d37fbf8eee846e8262af61dfbfcdfe1c7c075"
+    },
+    {
+      "path": "skills/spec-sync/scripts/_runtime/modules/docs/spec_drift.ts",
+      "sha256": "74e348ed8e97a77cb3d7e4d3fe4bfffec0f4b29aa49086767c0f3f50a4d29b81"
+    },
+    {
+      "path": "skills/spec-sync/scripts/_runtime/modules/docs/spec_drift_helpers.ts",
+      "sha256": "039f0928fe42365ef380091ca8f5a8c72d5127c23f6870072ad4f2fce7d0b3de"
+    },
+    {
+      "path": "skills/spec-sync/scripts/_runtime/modules/docs/spec_drift_legacy.ts",
+      "sha256": "2dc7e8319afdd2ad50a05d0b8af45f6dfdcee08990bcff06be11098113366e6d"
+    },
+    {
+      "path": "skills/spec-sync/scripts/_runtime/modules/docs/spec_drift_paths.ts",
+      "sha256": "58df37350488de3e85906d22bc461a00de17293f57d73cfc126012df25d0d187"
+    },
+    {
+      "path": "skills/spec-sync/scripts/_runtime/modules/docs/spec_drift_types.ts",
+      "sha256": "d1bd27dd615b78b882a662a5f2366ddaca710ff803e68dd368a1791aaea47189"
+    },
+    {
+      "path": "skills/spec-sync/scripts/_runtime/modules/docs/spec_drift_validation.ts",
+      "sha256": "32eaaa686239c47f16f87ae677c8c806cfb43d4763bb5b3f7d48b0e8573823e2"
+    },
+    {
+      "path": "skills/spec-sync/scripts/_runtime/modules/docs/spec_migration.ts",
+      "sha256": "06094de16ee7fefbd34b2022be16649a98af52347a1dd750f8fbfd27a6ceb4d5"
+    },
     {
       "path": "skills/spec-sync/scripts/spec_drift_check.sh",
       "sha256": "34c64adfa2a4c80201515e282e3f4938e75f81059814ce58885b101722ac8174"
     },
     {
       "path": "skills/spec-sync/scripts/spec_drift_check.ts",
-      "sha256": "132e6d35869e25f4f7c1acba2e716483e433b1ac597b7c1e52dd36271e58cb97"
+      "sha256": "d6f381d2f5834350af28e097bc02d608d445a1ea55f384f3ea2037c0f6f115b8"
     },
     {
       "path": "skills/spec-sync/scripts/test_spec_drift_check.ts",
@@ -12016,7 +12320,7 @@
     },
     {
       "path": "skills/support-manifest.json",
-      "sha256": "bab89370c2877d854cbff187eb3c96e67f103d182c0cb1e69289c7d4b50203d8"
+      "sha256": "be3e17b0311084e508b199210aa4b5b93eda803ecc684fe4c7cef9098ee6b6e8"
     },
     {
       "path": "skills/topic-spec/SKILL.md",

package/toolkit/package.json

@@ -2,7 +2,7 @@
   "private": true,
   "type": "module",
   "packageName": "@loomhelm/multi-task-flow",
-  "packageVersion": "0.2.6",
+  "packageVersion": "0.2.7",
   "compatibilityLine": "compat-v1",
   "skillVersion": "2.7.6",
   "repository": {

package/toolkit/skills/docs-migrate/scripts/_runtime/compatibility_cli.ts

@@ -0,0 +1,12 @@
+import { basename } from "node:path";
+import { docs } from "./compatibility_docs";
+
+export async function runCompatibilityCli(name: string, argv: string[] = process.argv.slice(2)): Promise<number> {
+  const smoke = argv.includes("--compatibility-smoke");
+  const help = argv.includes("--help") || argv.includes("-h");
+  if (help && !smoke) { console.log(`Usage: bun ${name}.ts [options]`); return 0; }
+  const result = docs(basename(name).replace(/\.ts$/, ""), argv.filter(value => value !== "--compatibility-smoke"));
+  if (smoke && (result === 0 || help)) console.log(`SMOKE dispatched=${basename(name).replace(/\.ts$/, "")}`);
+  if (help) { if (result === 0) return 0; console.log(`Usage: bun ${name}.ts [options]`); return 0; }
+  return result;
+}

package/toolkit/skills/docs-migrate/scripts/_runtime/compatibility_docs.ts

@@ -0,0 +1,115 @@
+import { verifyDocLocks } from "./modules/docs/hardware_locks";
+import { ingestExtract } from "./modules/docs/hardware_ingest";
+import { findNextPlan } from "./modules/docs/next_plan";
+import { generateLegacySpecIds } from "./modules/docs/legacy_spec_id";
+import { parseSpecDriftArgs, runSpecDrift } from "./modules/docs/spec_drift";
+import {
+  planSpecsHygiene,
+  planSpecsMigration,
+} from "./modules/docs/spec_migration";
+import { json, option, rootFor } from "./compatibility_shared";
+
+export function docs(name: string, argv: string[]): number {
+  if (name === "verify_doc_locks") {
+    const result = verifyDocLocks(rootFor(argv), {
+      strictPdf: argv.includes("--strict-pdf"),
+      checkPerms: !argv.includes("--no-check-perms"),
+    });
+    result.lines.forEach((line) => console.log(line));
+    return result.exitCode;
+  }
+  if (name === "find_next_plan") {
+    json(findNextPlan(option(argv, "repo", process.cwd())!));
+    return 0;
+  }
+  if (name === "gen_legacy_spec_id") return legacyId(argv);
+  if (name === "specs_migrate_guard") return migrateGuard(argv);
+  if (name === "spec_drift_check") return drift(argv);
+  if (name === "ingest_mineru_extract") return ingest(argv);
+  return 2;
+}
+
+function legacyId(argv: string[]): number {
+  const args: Parameters<typeof generateLegacySpecIds>[0] = {
+    repoRoot: option(argv, "repo", process.cwd())!,
+    legacyCompat: argv.includes("--legacy-compat"),
+    count: Number(option(argv, "count", "1")),
+    length: Number(option(argv, "length", "5")),
+  };
+  const alphabet = option(argv, "alphabet");
+  if (alphabet !== undefined) args.alphabet = alphabet;
+  const result = generateLegacySpecIds(args);
+  process.stdout.write(result.stdout);
+  process.stderr.write(result.stderr);
+  return result.exitCode;
+}
+
+function migrateGuard(argv: string[]): number {
+  const repo = option(argv, "repo", process.cwd())!;
+  const source = option(argv, "source")!;
+  const branch = option(argv, "branch");
+  const legacyId = option(argv, "legacy-id");
+  const topic = option(argv, "topic");
+  const options = {
+    ...(branch === undefined ? {} : { branch }),
+    ...(legacyId === undefined ? {} : { legacyId }),
+    ...(topic === undefined ? {} : { topic }),
+  };
+  const result =
+    option(argv, "mode") === "specs-hygiene"
+      ? planSpecsHygiene(repo, source, {
+          ...options,
+          renameConfirmed: argv.includes("--rename-confirmed"),
+        })
+      : planSpecsMigration(repo, source, options);
+  json(result);
+  return result.blocked_reason ? 1 : 0;
+}
+
+function drift(argv: string[]): number {
+  const parsed = parseSpecDriftArgs(argv);
+  if (parsed.error) {
+    console.error(parsed.error);
+    return 2;
+  }
+  if (parsed.help) {
+    console.log(
+      "Usage: spec_drift_check.ts [--base-ref <ref>] [--spec-path <path>]...",
+    );
+    return 0;
+  }
+  const result = runSpecDrift(parsed.options);
+  json(result);
+  return result.exitCode;
+}
+
+function ingest(argv: string[]): number {
+  try {
+    const args: Parameters<typeof ingestExtract>[0] = {
+      extractPath: option(argv, "extract-path")!,
+      destDir: option(argv, "dest-dir")!,
+      slug: option(argv, "slug")!,
+      overwrite: argv.includes("--overwrite"),
+      addHeader: argv.includes("--add-header"),
+      keepMineruJson: argv.includes("--keep-mineru-json"),
+      writeLock: !argv.includes("--no-write-lock"),
+      lockGenerated: !argv.includes("--writable-generated"),
+      createReadme: !argv.includes("--no-readme"),
+    };
+    for (const [key, flag] of [
+      ["docSubdir", "doc-subdir"],
+      ["sourceUrl", "source-url"],
+      ["docType", "doc-type"],
+      ["vendor", "vendor"],
+      ["part", "part"],
+    ] as const) {
+      const value = option(argv, flag);
+      if (value !== undefined) args[key] = value;
+    }
+    ingestExtract(args).lines.forEach((line) => console.log(line));
+    return 0;
+  } catch (error) {
+    console.error(error instanceof Error ? error.message : String(error));
+    return 1;
+  }
+}