create-harness-vibe-coding 0.8.17 → 0.8.19

package/templates/common/.harness-version

@@ -1,19 +1,21 @@
 {
-  "generator": "0.8.17",
-  "generated": "2026-07-26T09:26:35.146Z",
+  "generator": "0.8.19",
+  "generated": "2026-07-30T14:31:29.365Z",
   "options": [],
   "autoCheck": true,
   "source": "https://raw.githubusercontent.com/LiWeny16/create-harness-vibe-coding/main/templates/common/",
   "releaseNotes": {
-    "version": "0.8.17",
-    "date": "2026-07-26",
+    "version": "0.8.19",
+    "date": "2026-07-30",
     "highlights": [
-      "Add HarnessBench v0.2 as an external-only lifecycle proof: 15 runs per mode, direct file writes safe in 3/15 runs, Harness safe path safe in 15/15 runs.",
-      "Keep benchmark fixtures, raw results, and scorer scripts out of generated installs and npm package files while publishing the summary in README and README-CN.",
-      "Make `wf-browser` the built-in browser automation entry and retire `browser-e2e` as a warning no-op optional id.",
-      "Add `wf-help` compatibility surfaces for Claude, Codex, and OpenCode with guards against nonexistent OpenCode skill paths.",
-      "Harden WF-MAX fan-out docs and OpenCode manager allowlists while preserving the Codex config guard against unsupported scalar subagent caps.",
-      "Add deterministic task-state/archive reconciliation tooling and validators for active task consistency."
+      "Publish `$wf-ui` as the Harness control panel with task capsule observability, agent workflow hierarchy, runtime detection, real PTY-backed detected CLI launches, and multi-terminal peer sessions.",
+      "Bundle built `wf-ui` assets in the npm package and guard them with pack smoke coverage so installed `wf-ui` can serve the browser UI without a local frontend build.",
+      "Harden OTA updates with `--repair` mode so an already-version-bumped install can still diff and restore missing framework files such as `/wf-task-list`, `/wf-help`, and platform mirrors.",
+      "Add post-update manifest validation: `/wf-update` now requires `validate-harness.mjs --manifest-audit` after apply/finalize to catch missing framework files, stale Harness-owned files, and manifest coverage gaps.",
+      "Add multi-scope `/wf-update` routing: project installs update project + discovered global runtime, while uninstalled projects using global command surfaces update only the global runtime and host copies.",
+      "Add `sync-host-global.mjs` so global Claude/Codex/OpenCode command and skill copies are audited and repaired after runtime updates.",
+      "Keep `--repair` safe by refusing older remote sources and prerelease sources by default; repair can restore missing files but cannot silently downgrade a newer install.",
+      "Regenerate ownership manifests from the template source so `.claude`, `.codex`, `.agents`, `.opencode`, and Harness script/spec files are tracked as updateable framework files while tasks, memory, progress, and project user files remain preserved."
     ]
   },
   "moves": [
@@ -159,17 +161,22 @@
   "checksums": {
     ".agents/skills/subagent-orchestrator/SKILL.md": "sha256-6354018aaafd3d9f546eeecc90f943ef9a94d05747673369586a4a2f45a9464d",
     ".agents/skills/tdd/SKILL.md": "sha256-d6738eca127e0632474db67c25708c9db3feab3b55499c489518502ec8951e3a",
-    ".agents/skills/wf-agents-docs/SKILL.md": "sha256-e0fe333aebae12a3e2cc6355e69237186a410f5d7a650ff5948ec132d9c630c4",
-    ".agents/skills/wf-auto-spark/SKILL.md": "sha256-0afd699c52a45a4071bcecf09ee487adb6002be6c608fdf653fba1c0a00e4ec4",
-    ".agents/skills/wf-auto/SKILL.md": "sha256-e62077d3c54d946f549c781fdf3f765c9a0ced41d0bedc96915b7167c3332987",
+    ".agents/skills/wf-agents-docs/SKILL.md": "sha256-20cd0d52d600ba9a61cbeb7fefea3beed213f77a87f23a1b534e6229949d5b01",
+    ".agents/skills/wf-auto-spark/SKILL.md": "sha256-4693db5b5a62d9385ede824c2ecfa84efbfa1d59a120377e216e4e920ccfc9db",
+    ".agents/skills/wf-auto/SKILL.md": "sha256-e148c86fba7873543afa1963808bf4f3dceab5864bba65665aae075ab8f2f838",
     ".agents/skills/wf-browser/SKILL.md": "sha256-0914538f7ae624b66cede82593f8063716c96c0f7b36adebbcf413c9e2a1d836",
+    ".agents/skills/wf-command-create/SKILL.md": "sha256-b8df91106d4ea161d659d1099a2ae509b8c81e9954946c2f53629ccbc5ffe70a",
     ".agents/skills/wf-help/SKILL.md": "sha256-418564cbe5e2df1e63fccdc9cd1cc12b05df9589836c6ff39ff43610eddf4e56",
     ".agents/skills/wf-learn/SKILL.md": "sha256-39e4bbe2da1261c02e37aa03ade0f9faaf6bc1f89568af1bb70f1af45d5f5bda",
-    ".agents/skills/wf-max/SKILL.md": "sha256-7db71b3356cc442540e96b7931a6cf5c23d71fedfc53eabde8e99dbe4afe2c50",
+    ".agents/skills/wf-max/SKILL.md": "sha256-b3e2fe922c7d7d5effee6a2d51324ff54049e2d419dba2f74dda025ed529c561",
     ".agents/skills/wf-readme/SKILL.md": "sha256-32256ab8e87fc1c2606fd102d85b59fa0b406d88d5639c2f9ff2f02e83f7d81f",
     ".agents/skills/wf-remove/SKILL.md": "sha256-2de3d7b5cba2456a83aaa86487492a627d836526dbd2da1225cec9d7634b625c",
-    ".agents/skills/wf-review/SKILL.md": "sha256-513ac34d7c6025f40f5457ffacf24df95ec248158660f1cd21225e00eda1800c",
-    ".agents/skills/wf-update/SKILL.md": "sha256-98a762d8d13b2ad36331b97c94b0b28b3103ee091814cc2c3710861895611e14",
+    ".agents/skills/wf-review/SKILL.md": "sha256-11117d7de4cd3cfd1616538233487420fff5a5d2a91754a68dc3a3134d06d29e",
+    ".agents/skills/wf-task-archive/SKILL.md": "sha256-f1637ee8c56b1385aed5db9c93f74889c2542a85273fdc68c6a4975a906f1cd5",
+    ".agents/skills/wf-task-list/SKILL.md": "sha256-04bcae617ef70e6b46c267ed726f6e8352d2f0b72aaaa8a486e3a760a8144b48",
+    ".agents/skills/wf-task-record/SKILL.md": "sha256-7afb4a9f04da96e45b9159f596d00c563184a27aff538385519187f2868811f8",
+    ".agents/skills/wf-ui/SKILL.md": "sha256-13c95b09624e93cec1ef4a6ef05dcc6f909edeb13590b28b8acb145233c6eae9",
+    ".agents/skills/wf-update/SKILL.md": "sha256-2efdd15cd8a4a9ec6b239cd5880c19c89c2be5016123342040d178b59b36778f",
     ".agents/skills/wf/SKILL.md": "sha256-78cc8b5be329649508b9fa6856b50c709ae74fbc31a4c7b77a69c6552723e29b",
     ".claude/agents/architect-manager.md": "sha256-21f16d8d5e9d0a88d9663dbe798421501e0de89ccad5f8f3c1ef9db5b79edaf7",
     ".claude/agents/architect.md": "sha256-8a57c6a85ec21d49deaa37a73a81367dabfdb22efd781f58e66b6628e14b218c",
@@ -193,29 +200,39 @@
     ".claude/commands/wf-auto-spark.md": "sha256-503c88eba452f20ca04c32db734eed1c666a381bd6948c3ffe18f5c4a4255729",
     ".claude/commands/wf-auto.md": "sha256-06196a633eb0464ff152e7bfffabd76c09ab32a2aef9d84b82bbb4c204503226",
     ".claude/commands/wf-browser.md": "sha256-1cd46b259cb509af2d0bb1d105912889068611875c008e002598d0e7ed42cf52",
-    ".claude/commands/wf-help.md": "sha256-282aa6162b736466847b82996b2c754afee5a3eaa827d234674315e4acbe6f1c",
+    ".claude/commands/wf-command-create.md": "sha256-b6027172e5d98c44f1ac22747a9ad52b27de15271018a60b10ac5b7c3d96f4a0",
+    ".claude/commands/wf-help.md": "sha256-3b15f9799da469e58a62b3360a7c0c29d15e578be364693e351afef66f6a5800",
     ".claude/commands/wf-learn.md": "sha256-02606f2a91e03056676aa022a060cd4a05a4d3123f8cb6f5e27bc50d90c6448a",
     ".claude/commands/wf-max.md": "sha256-88cdfb4ef8a205483045302b56dec268bdf010debd9c4473b665f5720e4c5697",
     ".claude/commands/wf-readme.md": "sha256-3eee1a6b3f62c22ed46440ed38ecb02999c9a3128d7660e91e7f0a94c59fa463",
     ".claude/commands/wf-remove.md": "sha256-80fe1849412028c9a91120143eeb10e153e6d7c32ec502c0d7ef3599d13fa337",
     ".claude/commands/wf-review.md": "sha256-bb031ffc8e392af2c1b2bb97b2f7605af1dcfa70514c6068312eca01f170e6d9",
-    ".claude/commands/wf-update.md": "sha256-f6aa497209ad6c430771b5621720bca50bb06cf5ae3f40dfe1086f0372c232d7",
+    ".claude/commands/wf-task-archive.md": "sha256-95b7c0a7bb2946b8c6c57506726358e7cc57cc2d9b1b48bd43b102a9a77ca3da",
+    ".claude/commands/wf-task-list.md": "sha256-6d90efb0832a3a3e478c74101458026341f4966f01236c076859c8e562d13951",
+    ".claude/commands/wf-task-record.md": "sha256-e9fa479274bdece66afa631642a87c7e2500f1dc1e58b930660cebeef4eae748",
+    ".claude/commands/wf-ui.md": "sha256-faaef8c2ea6565be36582ce03a7dc9d4238a38b8d776a49e588f8a6df430b2d8",
+    ".claude/commands/wf-update.md": "sha256-48b82e5300cd5422396b8fc06dfaa2dd243e95a0891100e58715274da674e4b9",
     ".claude/commands/wf.md": "sha256-bef81f0404230ff0de64727d46aa947d7434d06fde8ad03c55db9ccf54870cca",
-    ".claude/rules/ecc/common.md": "sha256-c1229d6b3aa34551bfbb3919a5c4cbfaab4c1e9db3d913c75e3a27a2d8d345fa",
+    ".claude/rules/ecc/common.md": "sha256-930bb10a68d38b59b91b2e7cded67e4e99a0bcc3f3c6c928ab033c5670dfd827",
     ".claude/settings.json": "sha256-99e8552584b8e71e3e11b4b760c3bfbf8c1b18dadda7ec3f6e3c46f88d9ea513",
     ".claude/skills/subagent-orchestrator/SKILL.md": "sha256-6354018aaafd3d9f546eeecc90f943ef9a94d05747673369586a4a2f45a9464d",
     ".claude/skills/tdd/SKILL.md": "sha256-d6738eca127e0632474db67c25708c9db3feab3b55499c489518502ec8951e3a",
-    ".claude/skills/wf-agents-docs/SKILL.md": "sha256-e0fe333aebae12a3e2cc6355e69237186a410f5d7a650ff5948ec132d9c630c4",
-    ".claude/skills/wf-auto-spark/SKILL.md": "sha256-0afd699c52a45a4071bcecf09ee487adb6002be6c608fdf653fba1c0a00e4ec4",
-    ".claude/skills/wf-auto/SKILL.md": "sha256-e62077d3c54d946f549c781fdf3f765c9a0ced41d0bedc96915b7167c3332987",
+    ".claude/skills/wf-agents-docs/SKILL.md": "sha256-20cd0d52d600ba9a61cbeb7fefea3beed213f77a87f23a1b534e6229949d5b01",
+    ".claude/skills/wf-auto-spark/SKILL.md": "sha256-4693db5b5a62d9385ede824c2ecfa84efbfa1d59a120377e216e4e920ccfc9db",
+    ".claude/skills/wf-auto/SKILL.md": "sha256-e148c86fba7873543afa1963808bf4f3dceab5864bba65665aae075ab8f2f838",
     ".claude/skills/wf-browser/SKILL.md": "sha256-0914538f7ae624b66cede82593f8063716c96c0f7b36adebbcf413c9e2a1d836",
+    ".claude/skills/wf-command-create/SKILL.md": "sha256-b8df91106d4ea161d659d1099a2ae509b8c81e9954946c2f53629ccbc5ffe70a",
     ".claude/skills/wf-help/SKILL.md": "sha256-418564cbe5e2df1e63fccdc9cd1cc12b05df9589836c6ff39ff43610eddf4e56",
     ".claude/skills/wf-learn/SKILL.md": "sha256-39e4bbe2da1261c02e37aa03ade0f9faaf6bc1f89568af1bb70f1af45d5f5bda",
-    ".claude/skills/wf-max/SKILL.md": "sha256-7db71b3356cc442540e96b7931a6cf5c23d71fedfc53eabde8e99dbe4afe2c50",
+    ".claude/skills/wf-max/SKILL.md": "sha256-b3e2fe922c7d7d5effee6a2d51324ff54049e2d419dba2f74dda025ed529c561",
     ".claude/skills/wf-readme/SKILL.md": "sha256-32256ab8e87fc1c2606fd102d85b59fa0b406d88d5639c2f9ff2f02e83f7d81f",
     ".claude/skills/wf-remove/SKILL.md": "sha256-2de3d7b5cba2456a83aaa86487492a627d836526dbd2da1225cec9d7634b625c",
-    ".claude/skills/wf-review/SKILL.md": "sha256-513ac34d7c6025f40f5457ffacf24df95ec248158660f1cd21225e00eda1800c",
-    ".claude/skills/wf-update/SKILL.md": "sha256-98a762d8d13b2ad36331b97c94b0b28b3103ee091814cc2c3710861895611e14",
+    ".claude/skills/wf-review/SKILL.md": "sha256-11117d7de4cd3cfd1616538233487420fff5a5d2a91754a68dc3a3134d06d29e",
+    ".claude/skills/wf-task-archive/SKILL.md": "sha256-f1637ee8c56b1385aed5db9c93f74889c2542a85273fdc68c6a4975a906f1cd5",
+    ".claude/skills/wf-task-list/SKILL.md": "sha256-04bcae617ef70e6b46c267ed726f6e8352d2f0b72aaaa8a486e3a760a8144b48",
+    ".claude/skills/wf-task-record/SKILL.md": "sha256-7afb4a9f04da96e45b9159f596d00c563184a27aff538385519187f2868811f8",
+    ".claude/skills/wf-ui/SKILL.md": "sha256-13c95b09624e93cec1ef4a6ef05dcc6f909edeb13590b28b8acb145233c6eae9",
+    ".claude/skills/wf-update/SKILL.md": "sha256-2efdd15cd8a4a9ec6b239cd5880c19c89c2be5016123342040d178b59b36778f",
     ".claude/skills/wf/SKILL.md": "sha256-78cc8b5be329649508b9fa6856b50c709ae74fbc31a4c7b77a69c6552723e29b",
     ".codex/config.toml": "sha256-b561d07aaba9bb32df0c48713f6a00be95462af9fa9383efb7cee89f9b24f9ba",
     ".codex/hooks.json": "sha256-3200c42c2da434c07cd6ab1ce86f8845ab46a1ed9a25b65117b2b2b42056c725",
@@ -241,53 +258,66 @@
     ".opencode/commands/wf-auto-spark.md": "sha256-503c88eba452f20ca04c32db734eed1c666a381bd6948c3ffe18f5c4a4255729",
     ".opencode/commands/wf-auto.md": "sha256-06196a633eb0464ff152e7bfffabd76c09ab32a2aef9d84b82bbb4c204503226",
     ".opencode/commands/wf-browser.md": "sha256-1cd46b259cb509af2d0bb1d105912889068611875c008e002598d0e7ed42cf52",
-    ".opencode/commands/wf-help.md": "sha256-2d8c841555ae64ec5be2ad4cf2e126cc8db04ece71cb05948ef029f2e704308e",
+    ".opencode/commands/wf-command-create.md": "sha256-29b597b7c2c3b8a7e131365e1704855bbd2774511ed30cf99e398f77123e2981",
+    ".opencode/commands/wf-help.md": "sha256-05d4d2feca75b1f03eba3b28084504b5314a7fdc131db3f9f8c46c4b1bf7d0fe",
     ".opencode/commands/wf-learn.md": "sha256-02606f2a91e03056676aa022a060cd4a05a4d3123f8cb6f5e27bc50d90c6448a",
     ".opencode/commands/wf-max.md": "sha256-21ddf8d4eff7ce91948a41eb68cbc9d184349ca3a422c72950fc83a5039eb663",
     ".opencode/commands/wf-readme.md": "sha256-3eee1a6b3f62c22ed46440ed38ecb02999c9a3128d7660e91e7f0a94c59fa463",
     ".opencode/commands/wf-remove.md": "sha256-80fe1849412028c9a91120143eeb10e153e6d7c32ec502c0d7ef3599d13fa337",
     ".opencode/commands/wf-review.md": "sha256-bb031ffc8e392af2c1b2bb97b2f7605af1dcfa70514c6068312eca01f170e6d9",
-    ".opencode/commands/wf-update.md": "sha256-f6aa497209ad6c430771b5621720bca50bb06cf5ae3f40dfe1086f0372c232d7",
+    ".opencode/commands/wf-task-archive.md": "sha256-eed9b41bd4fc9c4ca6d0b4aa2cc0492e7695173b6b5487a7a07683dec66de162",
+    ".opencode/commands/wf-task-list.md": "sha256-53e25781b9c9f9b12927f3291613a07029c2dfdef636350b0b779b4f7cca0a7f",
+    ".opencode/commands/wf-task-record.md": "sha256-c71c49e54f568eff816f5eea505d34a139e91f4f18aed504391ab6fa6afd539e",
+    ".opencode/commands/wf-ui.md": "sha256-faaef8c2ea6565be36582ce03a7dc9d4238a38b8d776a49e588f8a6df430b2d8",
+    ".opencode/commands/wf-update.md": "sha256-48b82e5300cd5422396b8fc06dfaa2dd243e95a0891100e58715274da674e4b9",
     ".opencode/commands/wf.md": "sha256-bef81f0404230ff0de64727d46aa947d7434d06fde8ad03c55db9ccf54870cca",
     ".opencode/plugins/harness-wf-status.mjs": "sha256-ee0987cec5530c34784c619a803562d7085ae26fe5d199fde7ce42c2bed4724e",
     "AGENTS.md": "sha256-fad176931742a5080e073d1ddba99a3eabb67e8c42bebb132df99a51ca6a184d",
-    "CLAUDE.md": "sha256-cd6b736bf14b4f526223bf15dc7ec625eb4b3a868a4d5961f26484d6bbfb4dca",
-    "Harness/MEMORY.md": "sha256-3acc3e8a9361765d226c8cd6967f48e3a71137aa6fdd48f20fdd4cdb8e32df68",
-    "Harness/README.md": "sha256-9df70490126ba229c4eb5dee6a59becbd16fb7bce8dc5a1c818a868c40908cd8",
-    "Harness/ownership.manifest.json": "sha256-4d7fa59b87768cd23bf2ca3c9b140cbd936da57586988bc557b0fad31d74794e",
+    "CLAUDE.md": "sha256-d5c527cc412054cbce6edc1c4e9476c001156117562108f5bdaf6f7f8a8827e9",
+    "Harness/MEMORY.md": "sha256-d998ab26fe1932b8bb6b55a4fcb4ba1c54ed4d2a633057ee0442d435c2add376",
+    "Harness/README.md": "sha256-59ea5524eee4a40586d3ebb79e35e1f0e53e8c3fa31a45c7c0d5e66aa339991f",
+    "Harness/a2a/role-graph.json": "sha256-bf4701253b5bfb3f6578eee0777cc10b250130acca2438fac6a5be31e38da34c",
+    "Harness/a2a/runtime-registry.json": "sha256-37b1fa4820ba3a4001b8ec9ec9a03dfdeb132379046792c21d5e1de0794fee90",
+    "Harness/a2a/skills/terminal-control.json": "sha256-07c66989c8a25344ddeabdbfaf1fc86f14750beb48ee8f99a970714ebcd5efb3",
+    "Harness/ownership.manifest.json": "sha256-b6808f7009294aa6a446c1b24f3669659060979148dfd6c30a9caea3b6e6efe7",
     "Harness/project/architecture.md": "sha256-27462306667539d71aecc4a90a778222f61585ef99e8131fb38f866913cac1c4",
     "Harness/research/README.md": "sha256-b7a542c0d919cabc185b6e7a1e6ef265dc5160978d0c1dd804f2c6547d0202a4",
+    "Harness/scripts/README.md": "sha256-b97601aca4c042f09aa387cdf8764a242a3e67d40888fd5eb27c1ff2c86926f6",
+    "Harness/scripts/a2a-terminal.mjs": "sha256-d99864265bf90bef86538b7f5ca10b9debf4fad343aac832d32cc6957605d247",
     "Harness/scripts/archive-tasks.mjs": "sha256-c5891c32d23f0b1bc863753d11116ab593928aa9ebedf2768b68b77e88c9909c",
-    "Harness/scripts/context-budget.mjs": "sha256-079228fa11046c5e4ca7323ac09091b05a78efae03ce655fee0c608c6833c33f",
+    "Harness/scripts/context-budget.mjs": "sha256-7cf88703e55eaaf6abdd1b2bf314e15a94ec41da2d370ce560b60655988b102e",
     "Harness/scripts/l2-cache-telemetry.mjs": "sha256-139b5317eb3917f2ca0acd3cb1164170cc8c1dd60e0dee35f8d1596aed28c22c",
     "Harness/scripts/scan-clean.mjs": "sha256-6c4b2a4d15a8cd758214a360f8d3be11a835368d409c95719242c75ccf466c8a",
-    "Harness/scripts/task-state.mjs": "sha256-409dfac45fb153ed648081bf1a3993c070b05473344fafe524ba2a96b9576934",
-    "Harness/scripts/validate-harness.mjs": "sha256-7d12fcb23aeb70211f4086c6aa5c327ae48c81d4c4fd26c20dc2f16482c6e966",
+    "Harness/scripts/sync-host-global.mjs": "sha256-16bf56a1c348d0225e4093b364166f51b2148a6d75020e49431d9b31d4800518",
+    "Harness/scripts/task-state.mjs": "sha256-e911615ca8a0edea676b840ccf8164eb70cfb14a08871f3121c5ad10692aa657",
+    "Harness/scripts/validate-harness.mjs": "sha256-f511f92d73a78c21de7b6c8de8be8641605e51131f5b2e4e5accb127aa5dfffb",
     "Harness/scripts/wf-auto-update-prompt.mjs": "sha256-14210304dbd8e648b8939fc4c5d3664f943052153e689264c16b05b7b81bd39e",
-    "Harness/scripts/wf-remove.mjs": "sha256-b043f84a69da54d0f137ce0c91ae7b55c0d76711680ee7bc8762a802be1ee8c8",
-    "Harness/scripts/wf-update-check.mjs": "sha256-32e9ed19046ac9b4910a661dae8fc13c03a605912430009cc8f830c1fdab3984",
-    "Harness/settings.json": "sha256-db6a14fcaaba3d2ac9c0c11bd11273bd016bcc16c154895d4c0b2a03ef51786e",
+    "Harness/scripts/wf-remove.mjs": "sha256-ba8711a74b88def50c4f94171d43ff01d6e3d67cd89644f19b701675362afb73",
+    "Harness/scripts/wf-update-check.mjs": "sha256-cfdccaeb8045a772a80f468f8b23fdb753b99bd89d3af72688c4abd241bd85a9",
+    "Harness/scripts/wf-update-runner.mjs": "sha256-2a197a6cd0ab5abbc2ad9359b78cc44db41b5789aabbb503f357ca1135c62444",
+    "Harness/settings.json": "sha256-5455b66125fd67969a6e490d3093ce238f7c16348f69a980a65ce22d99c0c728",
     "Harness/specs/guides/ECC-GUIDE.md": "sha256-eba123cad02dde928317b9347efac45daf33698221d2d91768559a1f0456cc97",
-    "Harness/specs/guides/SETUP.md": "sha256-7747cd6ef3ef81ff15a893d3d4c428dbab9ba0ec8193aedb00d992fd268d7afb",
+    "Harness/specs/guides/SETUP.md": "sha256-2f33b14eec035c9603ad6355cecc109879e9320a7a29aa9e9be6bbc743362b38",
     "Harness/specs/guides/extension.md": "sha256-5bf5895f849b972e5bdd1afd1a6914cd743b88b05668bb72dca7cd835262e8c9",
     "Harness/specs/guides/lifecycle.md": "sha256-3bb2107af2ee569c905ca615d662ba9adfd606a595e45880cfc292779c5f1844",
     "Harness/specs/protocols/ACCEPTANCE_PROTOCOL.md": "sha256-0f7a21a1fbfdca6e5f28f3297b61c3446e3bdd552a2143c7032d6271a4e26103",
     "Harness/specs/protocols/AGENT_ISOLATION.md": "sha256-54abcd4fdaf8810ab42da8a7f2ab5b5f5305f105f93e8764081b10edce053506",
     "Harness/specs/protocols/DEBUG_PROTOCOL.md": "sha256-ed80de0e3e1a40dbb9fd0bdead9174f1650e1833027f3d7fb4bb5884142e03f7",
     "Harness/specs/protocols/HARNESS_BRIDGE.md": "sha256-681dbeca9a590bbeb3a0c01b044e40e642e6d640632d8611064eb897ada8a48d",
-    "Harness/specs/protocols/MEMORY_PROTOCOL.md": "sha256-c8cda68bf25fbf7152c6049959a8bd6d39453976a651a1c4a9d3f7e349f823c4",
-    "Harness/specs/protocols/TASK_ARCHIVE.md": "sha256-6ed563dfd2fea754373fea3905c5cfa9534a650c104783b9bf704d81b44864ba",
+    "Harness/specs/protocols/MEMORY_PROTOCOL.md": "sha256-5542c5007f278e0d83627d831beff4eaa58e2bc256f7962f562050de124e24d9",
+    "Harness/specs/protocols/TASK_ARCHIVE.md": "sha256-93f926df3fdea1510535ac5ab8efeba347c67c1d289afc0e46d4d2175a2e3699",
     "Harness/specs/protocols/TDD-GUIDE.md": "sha256-602084530fd0dea7499a023ce75738351e5d97a0c222b64d405f36da6b59a162",
     "Harness/specs/runtime/agent-workflow.md": "sha256-9e6390715a9c2e404923d17e12369fe5af22c9a615ab14a010a8d6da0974c987",
+    "Harness/specs/runtime/command-surface.json": "sha256-70da5001e2a05a636050f0df9e129ea67c06953b649d2c0b9d2001ccc484c265",
     "Harness/specs/runtime/context-loading.md": "sha256-323e9476486ebf60cfd9fd78834701817f882648749cd548dd7a47670fce0bd6",
     "Harness/specs/runtime/dispatch.md": "sha256-1b1c2681c2722b8d708f8cca48ec1991ee922602c4c7333704f0156f6ffa498f",
-    "Harness/specs/runtime/subagents.md": "sha256-6db97dd3a72c28f4ec24a56ea031de9f6ecb0eb4c72427e6409731cf45dab323",
+    "Harness/specs/runtime/subagents.md": "sha256-bb71ae927dd5f4656f97a78797b1d776618a39b26a7364a256cbcf38db427e71",
     "Harness/specs/workflows/WF-AUTO-ANGLES.md": "sha256-b9641d871f728e8112ad0d8c7f87bcbec0a06aa572c5f3060efdd26496abdf9b",
-    "Harness/specs/workflows/WF-AUTO-SPARK.md": "sha256-dfe7e31373ccc9dea2d552649ec21dff91bca723316655788e82ab37cf0d33e5",
-    "Harness/specs/workflows/WF-AUTO.md": "sha256-742e949bf77259997d662447f5b7c5627d8459f0b7aed96748cdb2de9c3bcfa9",
+    "Harness/specs/workflows/WF-AUTO-SPARK.md": "sha256-49a6272f9c40d9bd0ae22ae39d576bf3c6479bb9cbc56a24e8b62b31cdabf72c",
+    "Harness/specs/workflows/WF-AUTO.md": "sha256-78d1be4bfbc6618acc75d09f1f19016d741552924958ca2739ba9f3fd05c4d19",
     "Harness/specs/workflows/WF-KERNEL.md": "sha256-70d608b12ab977c5dfb7038fb7677123bd39f29fb645b3046abbde7fa28d69a7",
-    "Harness/specs/workflows/WF-MAX.md": "sha256-199756c87024e62f54bc97fbcba255de18f7e2bb45eaa85b7f8658ebea0df6d7",
-    "Harness/specs/workflows/WF-STATE.md": "sha256-d787e61be1a708b46bd5c6dab5ecaf3a668835a1273b1ac4475a3ccc4339f62e",
+    "Harness/specs/workflows/WF-MAX.md": "sha256-4584a0870138db80d507dcfcebb32f34dfb6c9a4a3b154faad15f621b66536e7",
+    "Harness/specs/workflows/WF-STATE.md": "sha256-7108775358b44229302d3271083b349648d44b1c61de89167e4e99346821bf2a",
     "Harness/specs/workflows/WF.md": "sha256-d33e9ff55e67a34a862a896693cb55aeae8f73dd7d0ede561943674dd3e6d212",
     "Harness/templates/ACCEPTANCE.template.md": "sha256-394a6c08b155b1d121f1d51da774f7988bdb891224c6d5f2ca2c131e8c95ffb3",
     "Harness/templates/API_CONTRACT.template.md": "sha256-e11ec9866576624982f35e77359e3f4ef3aea3e3f6b5895f6cc5419d29699fc5",
@@ -305,12 +335,17 @@
     ".agents/skills/wf-auto-spark/SKILL.md": ".claude/skills/wf-auto-spark/SKILL.md",
     ".agents/skills/wf-auto/SKILL.md": ".claude/skills/wf-auto/SKILL.md",
     ".agents/skills/wf-browser/SKILL.md": ".claude/skills/wf-browser/SKILL.md",
+    ".agents/skills/wf-command-create/SKILL.md": ".claude/skills/wf-command-create/SKILL.md",
     ".agents/skills/wf-help/SKILL.md": ".claude/skills/wf-help/SKILL.md",
     ".agents/skills/wf-learn/SKILL.md": ".claude/skills/wf-learn/SKILL.md",
     ".agents/skills/wf-max/SKILL.md": ".claude/skills/wf-max/SKILL.md",
     ".agents/skills/wf-readme/SKILL.md": ".claude/skills/wf-readme/SKILL.md",
     ".agents/skills/wf-remove/SKILL.md": ".claude/skills/wf-remove/SKILL.md",
     ".agents/skills/wf-review/SKILL.md": ".claude/skills/wf-review/SKILL.md",
+    ".agents/skills/wf-task-archive/SKILL.md": ".claude/skills/wf-task-archive/SKILL.md",
+    ".agents/skills/wf-task-list/SKILL.md": ".claude/skills/wf-task-list/SKILL.md",
+    ".agents/skills/wf-task-record/SKILL.md": ".claude/skills/wf-task-record/SKILL.md",
+    ".agents/skills/wf-ui/SKILL.md": ".claude/skills/wf-ui/SKILL.md",
     ".agents/skills/wf-update/SKILL.md": ".claude/skills/wf-update/SKILL.md",
     ".agents/skills/wf/SKILL.md": ".claude/skills/wf/SKILL.md",
     ".claude/agents/architect-manager.md": ".claude/agents/architect-manager.md",
@@ -335,12 +370,17 @@
     ".claude/commands/wf-auto-spark.md": ".claude/commands/wf-auto-spark.md",
     ".claude/commands/wf-auto.md": ".claude/commands/wf-auto.md",
     ".claude/commands/wf-browser.md": ".claude/commands/wf-browser.md",
+    ".claude/commands/wf-command-create.md": ".claude/commands/wf-command-create.md",
     ".claude/commands/wf-help.md": ".claude/commands/wf-help.md",
     ".claude/commands/wf-learn.md": ".claude/commands/wf-learn.md",
     ".claude/commands/wf-max.md": ".claude/commands/wf-max.md",
     ".claude/commands/wf-readme.md": ".claude/commands/wf-readme.md",
     ".claude/commands/wf-remove.md": ".claude/commands/wf-remove.md",
     ".claude/commands/wf-review.md": ".claude/commands/wf-review.md",
+    ".claude/commands/wf-task-archive.md": ".claude/commands/wf-task-archive.md",
+    ".claude/commands/wf-task-list.md": ".claude/commands/wf-task-list.md",
+    ".claude/commands/wf-task-record.md": ".claude/commands/wf-task-record.md",
+    ".claude/commands/wf-ui.md": ".claude/commands/wf-ui.md",
     ".claude/commands/wf-update.md": ".claude/commands/wf-update.md",
     ".claude/commands/wf.md": ".claude/commands/wf.md",
     ".claude/rules/ecc/common.md": ".claude/rules/ecc/common.md",
@@ -351,12 +391,17 @@
     ".claude/skills/wf-auto-spark/SKILL.md": ".claude/skills/wf-auto-spark/SKILL.md",
     ".claude/skills/wf-auto/SKILL.md": ".claude/skills/wf-auto/SKILL.md",
     ".claude/skills/wf-browser/SKILL.md": ".claude/skills/wf-browser/SKILL.md",
+    ".claude/skills/wf-command-create/SKILL.md": ".claude/skills/wf-command-create/SKILL.md",
     ".claude/skills/wf-help/SKILL.md": ".claude/skills/wf-help/SKILL.md",
     ".claude/skills/wf-learn/SKILL.md": ".claude/skills/wf-learn/SKILL.md",
     ".claude/skills/wf-max/SKILL.md": ".claude/skills/wf-max/SKILL.md",
     ".claude/skills/wf-readme/SKILL.md": ".claude/skills/wf-readme/SKILL.md",
     ".claude/skills/wf-remove/SKILL.md": ".claude/skills/wf-remove/SKILL.md",
     ".claude/skills/wf-review/SKILL.md": ".claude/skills/wf-review/SKILL.md",
+    ".claude/skills/wf-task-archive/SKILL.md": ".claude/skills/wf-task-archive/SKILL.md",
+    ".claude/skills/wf-task-list/SKILL.md": ".claude/skills/wf-task-list/SKILL.md",
+    ".claude/skills/wf-task-record/SKILL.md": ".claude/skills/wf-task-record/SKILL.md",
+    ".claude/skills/wf-ui/SKILL.md": ".claude/skills/wf-ui/SKILL.md",
     ".claude/skills/wf-update/SKILL.md": ".claude/skills/wf-update/SKILL.md",
     ".claude/skills/wf/SKILL.md": ".claude/skills/wf/SKILL.md",
     ".codex/config.toml": ".codex/config.toml",
@@ -384,12 +429,17 @@
     ".opencode/commands/wf-auto-spark.md": ".opencode/commands/wf-auto-spark.md",
     ".opencode/commands/wf-auto.md": ".opencode/commands/wf-auto.md",
     ".opencode/commands/wf-browser.md": ".opencode/commands/wf-browser.md",
+    ".opencode/commands/wf-command-create.md": ".opencode/commands/wf-command-create.md",
     ".opencode/commands/wf-help.md": ".opencode/commands/wf-help.md",
     ".opencode/commands/wf-learn.md": ".opencode/commands/wf-learn.md",
     ".opencode/commands/wf-max.md": ".opencode/commands/wf-max.md",
     ".opencode/commands/wf-readme.md": ".opencode/commands/wf-readme.md",
     ".opencode/commands/wf-remove.md": ".opencode/commands/wf-remove.md",
     ".opencode/commands/wf-review.md": ".opencode/commands/wf-review.md",
+    ".opencode/commands/wf-task-archive.md": ".opencode/commands/wf-task-archive.md",
+    ".opencode/commands/wf-task-list.md": ".opencode/commands/wf-task-list.md",
+    ".opencode/commands/wf-task-record.md": ".opencode/commands/wf-task-record.md",
+    ".opencode/commands/wf-ui.md": ".opencode/commands/wf-ui.md",
     ".opencode/commands/wf-update.md": ".opencode/commands/wf-update.md",
     ".opencode/commands/wf.md": ".opencode/commands/wf.md",
     ".opencode/plugins/harness-wf-status.mjs": ".opencode/plugins/harness-wf-status.mjs",
@@ -399,6 +449,9 @@
     "Harness/MEMORY.md": "Harness/MEMORY.md",
     "Harness/PROGRESS.md": "Harness/PROGRESS.md",
     "Harness/README.md": "Harness/README.md",
+    "Harness/a2a/role-graph.json": "Harness/a2a/role-graph.json",
+    "Harness/a2a/runtime-registry.json": "Harness/a2a/runtime-registry.json",
+    "Harness/a2a/skills/terminal-control.json": "Harness/a2a/skills/terminal-control.json",
     "Harness/memory/agent-lessons-patterns.md": "memory/agent-lessons-patterns.md",
     "Harness/memory/routes.md": "memory/routes.md",
     "Harness/memory/startup-hints.md": "memory/startup-hints.md",
@@ -409,15 +462,19 @@
     "Harness/research/PRD.md": "Harness/research/PRD.md",
     "Harness/research/README.md": "Harness/research/README.md",
     "Harness/research/research-results.md": "Harness/research/research-results.md",
+    "Harness/scripts/README.md": "Harness/scripts/README.md",
+    "Harness/scripts/a2a-terminal.mjs": "Harness/scripts/a2a-terminal.mjs",
     "Harness/scripts/archive-tasks.mjs": "Harness/scripts/archive-tasks.mjs",
     "Harness/scripts/context-budget.mjs": "Harness/scripts/context-budget.mjs",
     "Harness/scripts/l2-cache-telemetry.mjs": "Harness/scripts/l2-cache-telemetry.mjs",
     "Harness/scripts/scan-clean.mjs": "Harness/scripts/scan-clean.mjs",
+    "Harness/scripts/sync-host-global.mjs": "Harness/scripts/sync-host-global.mjs",
     "Harness/scripts/task-state.mjs": "Harness/scripts/task-state.mjs",
     "Harness/scripts/validate-harness.mjs": "Harness/scripts/validate-harness.mjs",
     "Harness/scripts/wf-auto-update-prompt.mjs": "Harness/scripts/wf-auto-update-prompt.mjs",
     "Harness/scripts/wf-remove.mjs": "Harness/scripts/wf-remove.mjs",
     "Harness/scripts/wf-update-check.mjs": "Harness/scripts/wf-update-check.mjs",
+    "Harness/scripts/wf-update-runner.mjs": "Harness/scripts/wf-update-runner.mjs",
     "Harness/settings.json": "Harness/settings.json",
     "Harness/specs/guides/ECC-GUIDE.md": "Harness/specs/guides/ECC-GUIDE.md",
     "Harness/specs/guides/SETUP.md": "Harness/specs/guides/SETUP.md",
@@ -431,6 +488,7 @@
     "Harness/specs/protocols/TASK_ARCHIVE.md": "Harness/specs/protocols/TASK_ARCHIVE.md",
     "Harness/specs/protocols/TDD-GUIDE.md": "Harness/specs/protocols/TDD-GUIDE.md",
     "Harness/specs/runtime/agent-workflow.md": "Harness/specs/runtime/agent-workflow.md",
+    "Harness/specs/runtime/command-surface.json": "Harness/specs/runtime/command-surface.json",
     "Harness/specs/runtime/context-loading.md": "Harness/specs/runtime/context-loading.md",
     "Harness/specs/runtime/dispatch.md": "Harness/specs/runtime/dispatch.md",
     "Harness/specs/runtime/subagents.md": "Harness/specs/runtime/subagents.md",
@@ -441,11 +499,11 @@
     "Harness/specs/workflows/WF-MAX.md": "Harness/specs/workflows/WF-MAX.md",
     "Harness/specs/workflows/WF-STATE.md": "Harness/specs/workflows/WF-STATE.md",
     "Harness/specs/workflows/WF.md": "Harness/specs/workflows/WF.md",
-    "Harness/tasks/_template/ARTIFACTS.md": "Harness/tasks/_template/ARTIFACTS.md",
     "Harness/tasks/_template/NAMING.md": "Harness/tasks/_template/NAMING.md",
-    "Harness/tasks/_template/NOTES.md": "Harness/tasks/_template/NOTES.md",
     "Harness/tasks/_template/PLAN.md": "Harness/tasks/_template/PLAN.md",
+    "Harness/tasks/_template/PROBLEM.md": "Harness/tasks/_template/PROBLEM.md",
     "Harness/tasks/_template/PROGRESS.md": "Harness/tasks/_template/PROGRESS.md",
+    "Harness/tasks/_template/REFERENCES.md": "Harness/tasks/_template/REFERENCES.md",
     "Harness/tasks/_template/STATE.json": "Harness/tasks/_template/STATE.json",
     "Harness/templates/ACCEPTANCE.template.md": "Harness/templates/ACCEPTANCE.template.md",
     "Harness/templates/API_CONTRACT.template.md": "Harness/templates/API_CONTRACT.template.md",

package/templates/common/.opencode/commands/wf-command-create.md

@@ -0,0 +1,61 @@
+---
+description: Create or modify a Harness wf-* command surface atomically
+---
+# /wf-command-create
+
+Create or modify a Harness wf-* command surface atomically. Do not invoke a skill or start WF mode.
+
+## Classification
+
+DIRECT command. It is a Harness maintenance command: it must create or resume a task capsule, then update every command surface declared by `Harness/specs/runtime/command-surface.json`. Never loads `Harness/MEMORY.md` as part of command routing.
+
+## Usage
+
+/wf-command-create <wf-command-id> [--direct|--workflow] [--task <task-id>]
+
+- Command id must be `wf` or `wf-*` kebab-case.
+- Use an existing task capsule when `--task` is supplied or when the active task clearly matches.
+- Otherwise create a `task-<verb>-<noun>[-detail]` capsule with `node Harness/scripts/task-state.mjs record <task-id> --create --apply --json`.
+- Record the command id, classification, and validation evidence in the task capsule.
+
+## Required Surface Checklist
+
+Update all applicable files before returning:
+
+- `Harness/specs/runtime/command-surface.json`
+- `.claude/commands/<id>.md`
+- `.opencode/commands/<id>.md`
+- `.claude/skills/<id>/SKILL.md` when Codex compatibility or workflow routing is needed
+- `.agents/skills/<id>/SKILL.md` mirror when a Claude skill exists
+- Matching `templates/common/...` files
+- `CLAUDE.md` and `templates/common/CLAUDE.md`
+- `.claude/rules/ecc/common.md` and template mirror
+- `.claude/commands/wf-help.md`, `.opencode/commands/wf-help.md`, and template mirrors
+- `Harness/README.md`, `Harness/MEMORY.md`, and template mirrors
+- `Harness/scripts/validate-harness.mjs` and template mirror
+- `Harness/scripts/wf-remove.mjs` and template mirror
+- `tests/generator.test.js`, `tests/anti-drift.test.js`, and `tests/validate-harness.test.js`
+- `Harness/.harness-version`, `templates/common/.harness-version`, and ownership manifests via `node scripts/build-version.mjs`
+
+## Validation
+
+Run, at minimum:
+
+```bash
+npm test
+node Harness/scripts/validate-harness.mjs
+node templates/common/Harness/scripts/validate-harness.mjs
+node Harness/scripts/context-budget.mjs --json
+node scripts/build-version.mjs --check
+npm run check:mirrors
+git diff --check
+```
+
+If a check is blocked by an existing unrelated repository issue, record the command, failure, and reason in the task capsule.
+
+## Return
+
+- Command id and classification.
+- Task capsule path.
+- Files changed by surface category.
+- Verification results.

package/templates/common/.opencode/commands/wf-help.md

@@ -22,6 +22,11 @@ which returns this same table without loading `Harness/MEMORY.md` or entering WF
 | `/wf-readme <task>` | workflow skill | `/wf-readme polish quickstart` | Preserve, merge, or improve README docs without trampling existing project documentation. |
 | `/wf-update` | direct command | `/wf-update` | Check/apply Harness scaffold updates with safe file classification and conflict handling. |
 | `/wf-remove` | workflow skill | `/wf-remove` | Safely remove Harness files while preserving project/user data unless explicitly purged. |
+| `/wf-task-record <task-id>` | direct command | `/wf-task-record my-feature --create` | Record user intent into a task capsule (wraps task-state.mjs). |
+| `/wf-task-list` | direct command | `/wf-task-list` | List all task capsules with status, phase, and dependencies. |
+| `/wf-task-archive [--apply]` | direct command | `/wf-task-archive --apply` | Archive completed task capsules (dry-run by default). |
+| `/wf-command-create <wf-command-id>` | direct command | `/wf-command-create wf-report --direct` | Create or modify wf-* command surfaces atomically from the command registry. |
+| `/wf-ui` | direct command | `/wf-ui` | Start the local Harness backend and browser control panel. |
 
 Source of truth: `Harness/README.md#Skill Commands` plus installed skills under
 `.claude/skills/` (Claude Code and OpenCode adapters) or `.agents/skills/`

package/templates/common/.opencode/commands/wf-task-archive.md

@@ -0,0 +1,29 @@
+---
+description: Archive completed/obsolete task capsules to _archive
+---
+# /wf-task-archive
+
+Archive completed/obsolete task capsules to `Harness/tasks/_archive/`. Do not invoke a skill or start WF mode.
+
+## Classification
+
+DIRECT command. Wraps `node Harness/scripts/task-state.mjs archive`. Never loads Harness/MEMORY.md.
+
+## Usage
+
+/wf-task-archive [--dry-run] [--apply] [--task <id>] [--keep <n>]
+
+- Defaults to dry-run (`--dry-run`) without `--apply`.
+- With `--apply`: moves eligible task directories into yearly subdirectories under `_archive/`.
+- With `--task <id>`: targets a specific task for archive eligibility check.
+- With `--keep <n>`: keeps N most recent non-archived task capsules (default 5).
+- Tasks with active, blocked, in_progress, running, pending, or needs-user-decision status are never auto-archived.
+
+## Execution
+
+Run: `node Harness/scripts/task-state.mjs archive [--dry-run] [--apply] [--task <id>] [--keep <n>] [--json]`
+
+## Return
+
+- JSON output with archive plan: scanned, archiveable, toArchive, kept, skipped counts and per-task results.
+- If the command fails, report the error and do not retry.

package/templates/common/.opencode/commands/wf-task-list.md

@@ -0,0 +1,29 @@
+---
+description: List Harness task capsules with state, phase, status, and dependency info
+---
+# /wf-task-list
+
+List Harness task capsules with state, phase, status, and dependency info. Do not invoke a skill or start WF mode.
+
+## Classification
+
+DIRECT command. Wraps `node Harness/scripts/task-state.mjs list --json`. Never loads Harness/MEMORY.md.
+
+## Usage
+
+/wf-task-list [--json]
+
+- By default, returns a human-readable listing of all task capsules.
+- With --json, returns structured JSON output.
+- Shows active, open, blocked, verified tasks with dependency info.
+
+## Execution
+
+Run: `node Harness/scripts/task-state.mjs list --json`
+
+## Return
+
+- JSON output of all task capsules with status, phase, dependencies, and archive eligibility.
+- Includes a `graph` section: roots, dependency edges, block edges, and orphaned dependency warnings.
+- Human-readable mode renders the graph with ASCII arrows: `from ──▶ to` (depends) and `from ▸▸ to` (blocks).
+- If the command fails, report the error and do not retry.

package/templates/common/.opencode/commands/wf-task-record.md

@@ -0,0 +1,27 @@
+---
+description: Record a task into a Harness task capsule
+---
+# /wf-task-record
+
+Record a task into a Harness task capsule. Do not invoke a skill or start WF mode.
+
+## Classification
+
+DIRECT command. Wraps `node Harness/scripts/task-state.mjs record`. Never loads Harness/MEMORY.md.
+
+## Usage
+
+/wf-task-record [<task-id>] [--title <slug>] [--note <text>] [--context <text>] [--new] [--create] [--status <status>] [--mode <mode>] [--text "description"]
+
+- With <task-id>: record to that task (existing semantics).
+- Without <task-id>: --title/--note/--context required. Deterministically matches open tasks; updates if unique match found; creates new if no match; fails if ambiguous unless --new.
+- Never uses LLM or embeddings — slug + keyword overlap only.
+
+## Execution
+
+Run: `node Harness/scripts/task-state.mjs record [<task-id>] [--title <slug>] [--note <text>] [--context <text>] [--new] [--create] [--apply] [--text "..."] [--status <status>] [--mode <mode>] [--json]`
+
+## Return
+
+- Output of `node Harness/scripts/task-state.mjs record ... --json`
+- If the command fails, report the error and do not retry.

package/templates/common/.opencode/commands/wf-ui.md

@@ -0,0 +1,26 @@
+---
+description: Open the Harness browser control panel for task capsules, workflow graphs, agent peers, settings, and terminal observability
+---
+
+# /wf-ui
+
+Start the Harness browser control panel directly. This is a direct command.
+Do not invoke a skill, do not start WF mode, and do not dispatch agents.
+
+Run from the project root:
+
+```bash
+create-harness-vibe-coding wf-ui --project . --host 127.0.0.1 --port 0 --open
+```
+
+If the global binary is not available, use the package fallback:
+
+```bash
+npx create-harness-vibe-coding@0.8.19 wf-ui --project . --host 127.0.0.1 --port 0 --open
+```
+
+Rules:
+- Bind only to `127.0.0.1`.
+- Use port `0` unless the user asks for a fixed port.
+- Leave the server running until the user stops it.
+- Return the local URL printed by the command.

package/templates/common/.opencode/commands/wf-update.md

@@ -22,7 +22,23 @@ targeted inspection.
 
 ## Flow
 
-1. Run `node Harness/scripts/wf-update-check.mjs --json` first and use the
+Scope resolution is deterministic:
+
+- Current project has `Harness/scripts/wf-update-check.mjs`: update the project
+  install from that script.
+- A global runtime is discoverable from `Harness/.harness-version.globalDir`,
+  `HARNESS_GLOBAL_HOME`, or the default `~/.harness/create-harness-vibe-coding`:
+  update that runtime too, then sync its Claude/Codex/OpenCode host-global
+  copies.
+- Current project has no Harness install: update only the global runtime and
+  host-global copies. Do not scaffold or modify the project unless the user
+  explicitly asks to install Harness there.
+`Harness/scripts/wf-update-runner.mjs` implements this multi-scope routing.
+Older installs that do not have the runner fall back to
+`Harness/scripts/wf-update-check.mjs`.
+
+1. Run `node Harness/scripts/wf-update-runner.mjs --json` first when present;
+   otherwise run `node Harness/scripts/wf-update-check.mjs --json`. Use the
    `agent` block as the action plan. Preserve `agent.releaseHighlights` for the
    user-facing update summary. Current updaters try npm
    `create-harness-vibe-coding@latest` first, then the canonical GitHub source
@@ -33,9 +49,11 @@ targeted inspection.
    starter files may be created, and checksum-matching legacy architecture can
    move to `Harness/project/architecture.md`. Harness/README.md is merge-tier,
    not PRESERVE.
-3. If `agent.safeApplyCommand` is present, run it to apply SAFE, NEW, and
-   adopted metadata-only files before spending AI time on conflicts. Default
-   command: `node Harness/scripts/wf-update-check.mjs --apply-safe`.
+3. If `agent.safeApplyCommand` is present, run the runner apply path to apply
+   SAFE, NEW, and adopted metadata-only files across every discovered scope
+   before spending AI time on conflicts. Default multi-scope command:
+   `node Harness/scripts/wf-update-runner.mjs --apply-safe --json`. Single-scope
+   fallback command: `node Harness/scripts/wf-update-check.mjs --apply-safe`.
    Framework-owned templates, commands, skills, agents, and scripts are
    script-owned and should be overwritten by the updater after checksum
    validation.
@@ -53,11 +71,38 @@ targeted inspection.
    `--accept-local <file>`, `--accept-merged <file>`, or
    `--accept-template <file>`; do not hand-edit `Harness/.harness-version`.
    Ask the user only when the intent is ambiguous.
-7. Run `node Harness/scripts/wf-update-check.mjs --finalize` after all
-   conflicts have script-recorded decisions. Use strict `--apply` only when the
-   JSON plan has zero conflicts.
-8. After update, run `node Harness/scripts/validate-harness.mjs` and then
-   `node Harness/scripts/scan-clean.mjs`.
+7. Run `node Harness/scripts/wf-update-runner.mjs --finalize --json` after all
+   conflicts have script-recorded decisions. Single-scope fallback:
+   `node Harness/scripts/wf-update-check.mjs --finalize`. Use strict `--apply` only when
+   the JSON plan has zero conflicts.
+8. After update, sync and validate all machine surfaces:
+   ```
+   node Harness/scripts/sync-host-global.mjs --json
+   node Harness/scripts/sync-host-global.mjs --apply --json
+   node Harness/scripts/validate-harness.mjs
+   node Harness/scripts/validate-harness.mjs --manifest-audit
+   node Harness/scripts/scan-clean.mjs --json
+   ```
+   `sync-host-global.mjs` is a no-op for project-only installs. For global
+   installs it compares host-global files against the runtime sources listed in
+   `.harness-version.hostGlobal.targets`; missing or Harness-marked stale copies
+   are repaired by script, while user-looking files stay conflicts.
+9. If the update reports "Already up to date" but files are missing (e.g.,
+   new commands not showing up on a platform), run:
+   ```
+   node Harness/scripts/wf-update-runner.mjs --repair --json
+   node Harness/scripts/wf-update-runner.mjs --repair --apply-safe --json
+   node Harness/scripts/wf-update-runner.mjs --repair --finalize --json
+   node Harness/scripts/wf-update-check.mjs --repair --json
+   node Harness/scripts/wf-update-check.mjs --repair --apply-safe
+   node Harness/scripts/wf-update-check.mjs --repair --finalize
+   node Harness/scripts/sync-host-global.mjs --apply --json
+   node Harness/scripts/validate-harness.mjs --manifest-audit
+   ```
+   `--repair` bypasses the version check and forces a full file diff against
+   the latest remote template. This catches files that were missed during a
+   previous partial update where the version was bumped but not all files
+   were written.
 
 Codex users without a direct command surface: use `$wf-update` (skill path) or
 `node Harness/scripts/wf-update-check.mjs`.