@beyondwork/docx-react-component 1.0.0 → 1.0.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (560) hide show
  1. package/README.md +44 -104
  2. package/package.json +66 -15
  3. package/src/api/public-types.ts +1 -1
  4. package/src/compare/diff-engine.ts +530 -0
  5. package/src/compare/export-redlines.ts +162 -0
  6. package/src/compare/snapshot.ts +37 -0
  7. package/src/core/commands/index.ts +1 -1
  8. package/src/core/state/editor-state.ts +2 -2
  9. package/src/index.ts +45 -0
  10. package/src/legal/bookmarks.ts +196 -0
  11. package/src/legal/cross-references.ts +356 -0
  12. package/src/legal/defined-terms.ts +203 -0
  13. package/src/runtime/document-runtime.ts +3 -5
  14. package/src/runtime/table-commands.ts +4 -1
  15. package/src/runtime/table-schema.ts +17 -2
  16. package/src/runtime/virtualized-rendering.ts +258 -0
  17. package/src/ui/WordReviewEditor.tsx +256 -35
  18. package/src/ui-tailwind/editor-surface/tw-editor-surface.tsx +2 -2
  19. package/src/ui-tailwind/editor-surface/tw-table-node-view.tsx +16 -2
  20. package/.codex/config.toml +0 -5
  21. package/.corepack/v1/pnpm/10.30.3/.corepack +0 -1
  22. package/.corepack/v1/pnpm/10.30.3/LICENSE +0 -22
  23. package/.corepack/v1/pnpm/10.30.3/README.md +0 -240
  24. package/.corepack/v1/pnpm/10.30.3/dist/node-gyp-bin/node-gyp +0 -6
  25. package/.corepack/v1/pnpm/10.30.3/dist/node-gyp-bin/node-gyp.cmd +0 -5
  26. package/.corepack/v1/pnpm/10.30.3/dist/pnpm.cjs +0 -195400
  27. package/.corepack/v1/pnpm/10.30.3/dist/pnpmrc +0 -2
  28. package/.corepack/v1/pnpm/10.30.3/dist/reflink.darwin-arm64-2HJ4WGO6.node +0 -0
  29. package/.corepack/v1/pnpm/10.30.3/dist/reflink.darwin-x64-3G3H6IW4.node +0 -0
  30. package/.corepack/v1/pnpm/10.30.3/dist/reflink.win32-arm64-msvc-Q6BARPPB.node +0 -0
  31. package/.corepack/v1/pnpm/10.30.3/dist/reflink.win32-x64-msvc-J2TZHRQI.node +0 -0
  32. package/.corepack/v1/pnpm/10.30.3/dist/templates/completion.bash +0 -31
  33. package/.corepack/v1/pnpm/10.30.3/dist/templates/completion.fish +0 -22
  34. package/.corepack/v1/pnpm/10.30.3/dist/templates/completion.ps1 +0 -193
  35. package/.corepack/v1/pnpm/10.30.3/dist/templates/completion.zsh +0 -27
  36. package/.corepack/v1/pnpm/10.30.3/dist/vendor/fastlist-0.3.0-x64.exe +0 -0
  37. package/.corepack/v1/pnpm/10.30.3/dist/vendor/fastlist-0.3.0-x86.exe +0 -0
  38. package/.corepack/v1/pnpm/10.30.3/dist/worker.js +0 -10119
  39. package/.corepack/v1/pnpm/10.30.3/package.json +0 -192
  40. package/.cursor/mcp.json +0 -7
  41. package/.github/workflows/ci.yml +0 -35
  42. package/.mcp.json +0 -7
  43. package/.openclaw/workspace-state.json +0 -4
  44. package/.pnpmrc.json +0 -1
  45. package/.wave-launch.sh +0 -7
  46. package/.workspace-marker +0 -1
  47. package/AGENTS.md +0 -78
  48. package/CHANGELOG.md +0 -177
  49. package/DESIGN.md +0 -929
  50. package/HEARTBEAT.md +0 -7
  51. package/IDENTITY.md +0 -23
  52. package/SOUL.md +0 -36
  53. package/TOOLS.md +0 -40
  54. package/USER.md +0 -17
  55. package/docs/README.md +0 -107
  56. package/docs/agents/wave-cont-eval-role.md +0 -36
  57. package/docs/agents/wave-cont-qa-role.md +0 -52
  58. package/docs/agents/wave-deploy-verifier-role.md +0 -34
  59. package/docs/agents/wave-design-role.md +0 -47
  60. package/docs/agents/wave-documentation-role.md +0 -34
  61. package/docs/agents/wave-infra-role.md +0 -34
  62. package/docs/agents/wave-integration-role.md +0 -37
  63. package/docs/agents/wave-launcher-role.md +0 -41
  64. package/docs/agents/wave-orchestrator-role.md +0 -52
  65. package/docs/agents/wave-planner-role.md +0 -39
  66. package/docs/agents/wave-security-role.md +0 -40
  67. package/docs/architecture/docx/README.md +0 -10
  68. package/docs/architecture/future/README.md +0 -8
  69. package/docs/architecture/ooxml-upgrade-analysis.md +0 -134
  70. package/docs/architecture/platform/shared-openxml-editor-platform.md +0 -153
  71. package/docs/architecture/xlsx/canonical-workbook-model-and-commands.md +0 -187
  72. package/docs/architecture/xlsx/spreadsheet-editor-frontend-architecture.md +0 -150
  73. package/docs/comment-redline-overview.md +0 -350
  74. package/docs/concepts/context7-vs-skills.md +0 -118
  75. package/docs/concepts/operating-modes.md +0 -91
  76. package/docs/concepts/runtime-agnostic-orchestration.md +0 -111
  77. package/docs/concepts/what-is-a-wave.md +0 -217
  78. package/docs/context7/bundles.json +0 -222
  79. package/docs/context7/planner-agent/README.md +0 -28
  80. package/docs/context7/planner-agent/manifest.json +0 -83
  81. package/docs/context7/planner-agent/papers/cooperbench-why-coding-agents-cannot-be-your-teammates-yet.md +0 -3283
  82. package/docs/context7/planner-agent/papers/dova-deliberation-first-multi-agent-orchestration-for-autonomous-research-automation.md +0 -1699
  83. package/docs/context7/planner-agent/papers/dpbench-large-language-models-struggle-with-simultaneous-coordination.md +0 -2251
  84. package/docs/context7/planner-agent/papers/incremental-planning-to-control-a-blackboard-based-problem-solver.md +0 -1729
  85. package/docs/context7/planner-agent/papers/silo-bench-a-scalable-environment-for-evaluating-distributed-coordination-in-multi-agent-llm-systems.md +0 -3747
  86. package/docs/context7/planner-agent/papers/todoevolve-learning-to-architect-agent-planning-systems.md +0 -1675
  87. package/docs/context7/planner-agent/papers/verified-multi-agent-orchestration-a-plan-execute-verify-replan-framework-for-complex-query-resolution.md +0 -1173
  88. package/docs/context7/planner-agent/papers/why-do-multi-agent-llm-systems-fail.md +0 -5211
  89. package/docs/context7/planner-agent/topics/planning-and-orchestration.md +0 -24
  90. package/docs/evals/arm-templates/README.md +0 -13
  91. package/docs/evals/arm-templates/full-wave.json +0 -15
  92. package/docs/evals/arm-templates/single-agent.json +0 -15
  93. package/docs/evals/benchmark-catalog.json +0 -670
  94. package/docs/evals/cases/README.md +0 -47
  95. package/docs/evals/cases/wave-blackboard-inbox-targeting.json +0 -73
  96. package/docs/evals/cases/wave-contradiction-conflict.json +0 -104
  97. package/docs/evals/cases/wave-expert-routing-preservation.json +0 -69
  98. package/docs/evals/cases/wave-hidden-profile-private-evidence.json +0 -81
  99. package/docs/evals/cases/wave-premature-closure-guard.json +0 -71
  100. package/docs/evals/cases/wave-silo-cross-agent-state.json +0 -77
  101. package/docs/evals/cases/wave-simultaneous-lockstep.json +0 -92
  102. package/docs/evals/external-benchmarks.json +0 -85
  103. package/docs/evals/external-command-config.sample.json +0 -9
  104. package/docs/evals/external-command-config.swe-bench-pro.json +0 -8
  105. package/docs/evals/pilots/README.md +0 -47
  106. package/docs/evals/pilots/swe-bench-pro-public-full-wave-review-10.json +0 -64
  107. package/docs/evals/pilots/swe-bench-pro-public-pilot.json +0 -111
  108. package/docs/evals/wave-benchmark-program.md +0 -302
  109. package/docs/guides/planner.md +0 -220
  110. package/docs/guides/recommendations-0.8.9.md +0 -133
  111. package/docs/guides/signal-wrappers.md +0 -165
  112. package/docs/guides/terminal-surfaces.md +0 -96
  113. package/docs/image copy.png +0 -0
  114. package/docs/image.png +0 -0
  115. package/docs/images/image.png +0 -0
  116. package/docs/legal-feedback-architecture.md +0 -498
  117. package/docs/plans/component-cutover-matrix.json +0 -1072
  118. package/docs/plans/component-cutover-matrix.md +0 -307
  119. package/docs/plans/context7-wave-orchestrator.md +0 -155
  120. package/docs/plans/current-state.md +0 -198
  121. package/docs/plans/docx/README.md +0 -9
  122. package/docs/plans/examples/wave-benchmark-improvement.md +0 -108
  123. package/docs/plans/examples/wave-example-live-proof.md +0 -435
  124. package/docs/plans/master-plan.md +0 -224
  125. package/docs/plans/migration.md +0 -538
  126. package/docs/plans/operations/README.md +0 -7
  127. package/docs/plans/operations/wave-10-word-certification.md +0 -87
  128. package/docs/plans/operations/wave-8-railway-staging.md +0 -153
  129. package/docs/plans/operations/wave-9-manual-certification.md +0 -73
  130. package/docs/plans/platform/README.md +0 -9
  131. package/docs/plans/reference/legal-checklist-coverage.md +0 -258
  132. package/docs/plans/wave-orchestrator.md +0 -423
  133. package/docs/plans/waves/README.md +0 -75
  134. package/docs/plans/waves/completed/wave-0.md +0 -195
  135. package/docs/plans/waves/completed/wave-1.md +0 -379
  136. package/docs/plans/waves/completed/wave-10.md +0 -670
  137. package/docs/plans/waves/completed/wave-11.md +0 -335
  138. package/docs/plans/waves/completed/wave-12.md +0 -417
  139. package/docs/plans/waves/completed/wave-13.md +0 -316
  140. package/docs/plans/waves/completed/wave-14.md +0 -319
  141. package/docs/plans/waves/completed/wave-15.md +0 -321
  142. package/docs/plans/waves/completed/wave-16.md +0 -316
  143. package/docs/plans/waves/completed/wave-17.md +0 -331
  144. package/docs/plans/waves/completed/wave-18.md +0 -328
  145. package/docs/plans/waves/completed/wave-2.md +0 -438
  146. package/docs/plans/waves/completed/wave-3.md +0 -435
  147. package/docs/plans/waves/completed/wave-4.md +0 -430
  148. package/docs/plans/waves/completed/wave-5.md +0 -430
  149. package/docs/plans/waves/completed/wave-6.md +0 -430
  150. package/docs/plans/waves/completed/wave-7.md +0 -526
  151. package/docs/plans/waves/completed/wave-8.md +0 -596
  152. package/docs/plans/waves/completed/wave-9.md +0 -552
  153. package/docs/plans/waves/deferred/README.md +0 -14
  154. package/docs/plans/waves/deferred/encrypted-intake-contracts.md +0 -282
  155. package/docs/plans/waves/deferred/legal-feedback-wave-expansion.md +0 -308
  156. package/docs/plans/waves/deferred/wave-encrypted-intake.md +0 -451
  157. package/docs/plans/waves/design/README.md +0 -5
  158. package/docs/plans/waves/design/wave-1-a1.md +0 -309
  159. package/docs/plans/waves/reviews/README.md +0 -5
  160. package/docs/plans/waves/reviews/wave-0-cont-qa.md +0 -151
  161. package/docs/plans/waves/reviews/wave-1-cont-qa.md +0 -46
  162. package/docs/plans/waves/reviews/wave-10-accessibility-and-design.md +0 -51
  163. package/docs/plans/waves/reviews/wave-10-cont-qa.md +0 -24
  164. package/docs/plans/waves/reviews/wave-10-dashboard-proof.md +0 -46
  165. package/docs/plans/waves/reviews/wave-10-performance-signoff.md +0 -55
  166. package/docs/plans/waves/reviews/wave-10-regression-proof.md +0 -23
  167. package/docs/plans/waves/reviews/wave-10-release-audit.md +0 -31
  168. package/docs/plans/waves/reviews/wave-10-service-proof.md +0 -83
  169. package/docs/plans/waves/reviews/wave-10-word-certification.md +0 -31
  170. package/docs/plans/waves/reviews/wave-18-ai-contract-closure.md +0 -277
  171. package/docs/plans/waves/reviews/wave-18-cont-qa.md +0 -255
  172. package/docs/plans/waves/reviews/wave-18-parity-proof.md +0 -271
  173. package/docs/plans/waves/reviews/wave-19-cont-qa.md +0 -59
  174. package/docs/plans/waves/reviews/wave-2-cont-qa.md +0 -72
  175. package/docs/plans/waves/reviews/wave-20-cont-qa.md +0 -60
  176. package/docs/plans/waves/reviews/wave-25-cont-qa.md +0 -48
  177. package/docs/plans/waves/reviews/wave-28-cont-qa.md +0 -46
  178. package/docs/plans/waves/reviews/wave-29-cont-qa.md +0 -53
  179. package/docs/plans/waves/reviews/wave-3-cont-qa.md +0 -53
  180. package/docs/plans/waves/reviews/wave-3-core-proof.md +0 -77
  181. package/docs/plans/waves/reviews/wave-3-validator-proof.md +0 -73
  182. package/docs/plans/waves/reviews/wave-32-cont-qa.md +0 -43
  183. package/docs/plans/waves/reviews/wave-33-cont-qa.md +0 -526
  184. package/docs/plans/waves/reviews/wave-34-cont-qa.md +0 -100
  185. package/docs/plans/waves/reviews/wave-35-cont-qa.md +0 -145
  186. package/docs/plans/waves/reviews/wave-4-cont-qa.md +0 -47
  187. package/docs/plans/waves/reviews/wave-4-structure-proof.md +0 -69
  188. package/docs/plans/waves/reviews/wave-5-comment-proof.md +0 -158
  189. package/docs/plans/waves/reviews/wave-5-cont-qa.md +0 -68
  190. package/docs/plans/waves/reviews/wave-6-cont-qa.md +0 -416
  191. package/docs/plans/waves/reviews/wave-6-redline-proof.md +0 -130
  192. package/docs/plans/waves/reviews/wave-7-cont-qa.md +0 -82
  193. package/docs/plans/waves/reviews/wave-7-ooxml-compliance.md +0 -85
  194. package/docs/plans/waves/reviews/wave-7-preservation-proof.md +0 -119
  195. package/docs/plans/waves/reviews/wave-7-trust-ux.md +0 -87
  196. package/docs/plans/waves/reviews/wave-8-accessibility-and-design.md +0 -128
  197. package/docs/plans/waves/reviews/wave-8-cont-qa.md +0 -92
  198. package/docs/plans/waves/reviews/wave-8-live-proof.md +0 -140
  199. package/docs/plans/waves/reviews/wave-8-security.md +0 -47
  200. package/docs/plans/waves/reviews/wave-9-editor-embedding.md +0 -39
  201. package/docs/plans/waves/reviews/wave-9-fixture-runner.md +0 -56
  202. package/docs/plans/waves/reviews/wave-9-live-proof.md +0 -105
  203. package/docs/plans/waves/reviews/wave-9-usability-and-performance.md +0 -152
  204. package/docs/plans/waves/specs/README.md +0 -5
  205. package/docs/plans/waves/specs/wave-1-component-boundaries.md +0 -322
  206. package/docs/plans/waves/specs/wave-1-ooxml-contracts.md +0 -323
  207. package/docs/plans/waves/specs/wave-1-review-and-ui-contracts.md +0 -339
  208. package/docs/plans/waves/specs/wave-1-runtime-contracts.md +0 -509
  209. package/docs/plans/waves/wave-19.md +0 -341
  210. package/docs/plans/waves/wave-20.md +0 -308
  211. package/docs/plans/waves/wave-21.md +0 -289
  212. package/docs/plans/waves/wave-22.md +0 -221
  213. package/docs/plans/waves/wave-23.md +0 -295
  214. package/docs/plans/waves/wave-24.md +0 -286
  215. package/docs/plans/waves/wave-25.md +0 -313
  216. package/docs/plans/waves/wave-26.md +0 -300
  217. package/docs/plans/waves/wave-27.md +0 -299
  218. package/docs/plans/waves/wave-28.md +0 -368
  219. package/docs/plans/waves/wave-29.md +0 -303
  220. package/docs/plans/waves/wave-30.md +0 -307
  221. package/docs/plans/waves/wave-31.md +0 -231
  222. package/docs/plans/waves/wave-32.md +0 -152
  223. package/docs/plans/waves/wave-33.md +0 -147
  224. package/docs/plans/waves/wave-34.md +0 -148
  225. package/docs/plans/waves/wave-35.md +0 -141
  226. package/docs/plans/waves/wave-36.md +0 -146
  227. package/docs/plans/xlsx/README.md +0 -14
  228. package/docs/plans/xlsx/xlsx-fixture-corpus-and-certification-plan.md +0 -126
  229. package/docs/reference/cli-reference.md +0 -600
  230. package/docs/reference/coordination-and-closure.md +0 -487
  231. package/docs/reference/deep-research-report (15).md +0 -25
  232. package/docs/reference/docx/README.md +0 -10
  233. package/docs/reference/legal-checklist.md +0 -445
  234. package/docs/reference/live-proof-waves.md +0 -199
  235. package/docs/reference/ooxml-compliance.md +0 -129
  236. package/docs/reference/ooxml-feature-parity-matrix.md +0 -172
  237. package/docs/reference/platform/shared-ooxml-platform-guidance.md +0 -77
  238. package/docs/reference/prototype-agent-prompt-legal-fidelity.md +0 -155
  239. package/docs/reference/public-api.md +0 -456
  240. package/docs/reference/repository-guidance.md +0 -58
  241. package/docs/reference/runtime-config/README.md +0 -182
  242. package/docs/reference/runtime-config/claude.md +0 -110
  243. package/docs/reference/runtime-config/codex.md +0 -82
  244. package/docs/reference/runtime-config/opencode.md +0 -93
  245. package/docs/reference/sample-waves.md +0 -105
  246. package/docs/reference/skills.md +0 -237
  247. package/docs/reference/templates/AGENTS.md +0 -78
  248. package/docs/reference/templates/HEARTBEAT.md +0 -7
  249. package/docs/reference/templates/IDENTITY.md +0 -23
  250. package/docs/reference/templates/SOUL.md +0 -36
  251. package/docs/reference/templates/TOOLS.md +0 -40
  252. package/docs/reference/templates/USER.md +0 -17
  253. package/docs/reference/wave-control.md +0 -184
  254. package/docs/reference/wave-planning-lessons.md +0 -167
  255. package/docs/reference/word-review-editor-frontend-architecture.md +0 -479
  256. package/docs/reference/word-review-editor-ux-guide.md +0 -253
  257. package/docs/reference/xlsx/xlsx-ooxml-compliance.md +0 -137
  258. package/docs/research/agent-context-sources.md +0 -178
  259. package/docs/research/coordination-failure-review.md +0 -290
  260. package/docs/research/docx-react-component/Canonical Document Schema Specification for a React-based Word-compatible Editor.md +0 -2317
  261. package/docs/research/docx-react-component/Feature Compatibility Matrix for a React Word Compatible Legal Editor v1.md +0 -219
  262. package/docs/research/docx-react-component/React Component Architecture and Front-End Structure Specification for a Word-Compatible Legal Review Editor.md +0 -1112
  263. package/docs/research/docx-react-component/document_compatibility_and_testing_spec.md +0 -751
  264. package/docs/research/xlsx/raw/README.md +0 -13
  265. package/docs/roadmap.md +0 -174
  266. package/docs/superpowers/plans/2026-03-28-harness-control-bar.md +0 -677
  267. package/docs/superpowers/specs/2026-03-28-harness-control-bar-design.md +0 -274
  268. package/docs/xlsx-react/README.md +0 -38
  269. package/docs/xlsx-react/agent-llm-interaction-layer-docx-xlsx.md +0 -621
  270. package/docs/xlsx-react/canonical-workbook-model-and-commands.md +0 -948
  271. package/docs/xlsx-react/shared-openxml-editor-platform-docx-xlsx.md +0 -228
  272. package/docs/xlsx-react/spreadsheet-editor-component-architecture.md +0 -809
  273. package/docs/xlsx-react/spreadsheet-editor-frontend-architecture.md +0 -537
  274. package/docs/xlsx-react/spreadsheet-editor-ux-guide.md +0 -520
  275. package/docs/xlsx-react/xlsx-editor-research-pack.md +0 -871
  276. package/docs/xlsx-react/xlsx-fixture-corpus-and-certification-plan.md +0 -436
  277. package/docs/xlsx-react/xlsx-ooxml-compliance.md +0 -320
  278. package/examples/README.md +0 -16
  279. package/memory/MEMORY.md +0 -24
  280. package/pnpm-workspace.yaml +0 -4
  281. package/scripts/check-no-authored-js.sh +0 -13
  282. package/scripts/context7-api-check.sh +0 -65
  283. package/scripts/context7-export-env.sh +0 -42
  284. package/scripts/run-context7-mcp.sh +0 -8
  285. package/scripts/run-workspace-tests.sh +0 -15
  286. package/scripts/start-wave-10-local.sh +0 -189
  287. package/scripts/wave-agent-attach.sh +0 -47
  288. package/scripts/wave-auto-answer.sh +0 -118
  289. package/scripts/wave-dashboard-attach.sh +0 -13
  290. package/scripts/wave-launch.sh +0 -273
  291. package/scripts/wave-overnight-supervisor.sh +0 -145
  292. package/scripts/wave-status.sh +0 -379
  293. package/scripts/wave-watch.sh +0 -231
  294. package/services/README.md +0 -17
  295. package/services/openxml-validator/Dockerfile +0 -29
  296. package/services/openxml-validator/OpenXmlValidator.Api.csproj +0 -12
  297. package/services/openxml-validator/Program.cs +0 -436
  298. package/services/openxml-validator/README.md +0 -152
  299. package/services/openxml-validator/railway.json +0 -16
  300. package/services/react-word-editor/.tmp-a4/src/api/public-types.ts +0 -318
  301. package/services/react-word-editor/.tmp-a4/src/ui/WordReviewEditor.tsx +0 -1302
  302. package/services/react-word-editor/.tmp-a4/src/ui/editor-surface/editor-surface.tsx +0 -546
  303. package/services/react-word-editor/.tmp-a4/test/ui/word-review-editor.test.tsx +0 -146
  304. package/services/react-word-editor/.tmp-a4-build/src/api/public-types.js +0 -2
  305. package/services/react-word-editor/.tmp-a4-build/src/ui/WordReviewEditor.js +0 -818
  306. package/services/react-word-editor/.tmp-a4-build/src/ui/editor-surface/editor-surface.js +0 -229
  307. package/services/react-word-editor/.tmp-a4-build/test/ui/word-review-editor.test.js +0 -121
  308. package/services/react-word-editor/.tmp-wave-4-a3-tsconfig.json +0 -21
  309. package/services/react-word-editor/.tmp-wave-4-a3-tsconfig.tsbuildinfo +0 -1
  310. package/services/react-word-editor/Dockerfile +0 -26
  311. package/services/react-word-editor/README.md +0 -254
  312. package/services/react-word-editor/app/api/certification/route.ts +0 -79
  313. package/services/react-word-editor/app/api/demo-sessions/route.ts +0 -109
  314. package/services/react-word-editor/app/api/deploy-health/route.ts +0 -23
  315. package/services/react-word-editor/app/api/exports/[exportId]/route.ts +0 -34
  316. package/services/react-word-editor/app/api/exports/route.ts +0 -81
  317. package/services/react-word-editor/app/api/fixtures/[fixtureId]/run/route.ts +0 -100
  318. package/services/react-word-editor/app/api/health/route.ts +0 -70
  319. package/services/react-word-editor/app/api/runs/[runId]/route.ts +0 -36
  320. package/services/react-word-editor/app/api/scenarios/[scenarioId]/run/route.ts +0 -85
  321. package/services/react-word-editor/app/api/sessions/[sessionId]/route.ts +0 -199
  322. package/services/react-word-editor/app/api/sessions/[sessionId]/source/route.ts +0 -45
  323. package/services/react-word-editor/app/api/uploads/route.ts +0 -70
  324. package/services/react-word-editor/app/api/validate/route.ts +0 -310
  325. package/services/react-word-editor/app/certification/[runId]/page.tsx +0 -14
  326. package/services/react-word-editor/app/certification/page.tsx +0 -32
  327. package/services/react-word-editor/app/dashboard/page.tsx +0 -7
  328. package/services/react-word-editor/app/demo/page.tsx +0 -30
  329. package/services/react-word-editor/app/demo/prototype-client.tsx +0 -1080
  330. package/services/react-word-editor/app/editor/[sessionId]/page.tsx +0 -33
  331. package/services/react-word-editor/app/fixtures/page.tsx +0 -7
  332. package/services/react-word-editor/app/globals.css +0 -121
  333. package/services/react-word-editor/app/layout.tsx +0 -32
  334. package/services/react-word-editor/app/page.tsx +0 -30
  335. package/services/react-word-editor/app/runs/[runId]/page.tsx +0 -34
  336. package/services/react-word-editor/app/wave-10-word-review/page.tsx +0 -7
  337. package/services/react-word-editor/components/harness-control-bar.tsx +0 -289
  338. package/services/react-word-editor/components/harness-editor-session-client.tsx +0 -1214
  339. package/services/react-word-editor/components/harness-workspace-page.tsx +0 -715
  340. package/services/react-word-editor/components/reduced-motion-toggle.tsx +0 -79
  341. package/services/react-word-editor/components/workspace-certification-panel.tsx +0 -307
  342. package/services/react-word-editor/lib/certification-bundle.ts +0 -796
  343. package/services/react-word-editor/lib/certification-store.ts +0 -661
  344. package/services/react-word-editor/lib/demo-fixtures.test.mjs +0 -195
  345. package/services/react-word-editor/lib/demo-fixtures.ts +0 -1519
  346. package/services/react-word-editor/lib/editor-session-summary.test.mjs +0 -68
  347. package/services/react-word-editor/lib/editor-session-summary.ts +0 -14
  348. package/services/react-word-editor/lib/editor-session.ts +0 -228
  349. package/services/react-word-editor/lib/exports-route.test.mjs +0 -32
  350. package/services/react-word-editor/lib/harness-client.ts +0 -347
  351. package/services/react-word-editor/lib/harness-config.json +0 -30
  352. package/services/react-word-editor/lib/harness-config.test.mjs +0 -31
  353. package/services/react-word-editor/lib/harness-config.ts +0 -21
  354. package/services/react-word-editor/lib/harness-editor-datastore.test.mjs +0 -220
  355. package/services/react-word-editor/lib/harness-editor-datastore.ts +0 -161
  356. package/services/react-word-editor/lib/private-mode.test.mjs +0 -42
  357. package/services/react-word-editor/lib/private-mode.ts +0 -61
  358. package/services/react-word-editor/lib/regression-report.test.mjs +0 -352
  359. package/services/react-word-editor/lib/regression-report.ts +0 -896
  360. package/services/react-word-editor/lib/run-artifacts.ts +0 -934
  361. package/services/react-word-editor/lib/run-history.ts +0 -755
  362. package/services/react-word-editor/lib/scenario-artifacts.test.mjs +0 -41
  363. package/services/react-word-editor/lib/scenario-artifacts.ts +0 -44
  364. package/services/react-word-editor/lib/storage.ts +0 -953
  365. package/services/react-word-editor/lib/validator-client.test.mjs +0 -54
  366. package/services/react-word-editor/lib/validator-client.ts +0 -95
  367. package/services/react-word-editor/lib/workspace-navigation.ts +0 -79
  368. package/services/react-word-editor/middleware.ts +0 -35
  369. package/services/react-word-editor/next-env.d.ts +0 -6
  370. package/services/react-word-editor/next.config.mjs +0 -15
  371. package/services/react-word-editor/package.json +0 -38
  372. package/services/react-word-editor/postcss.config.mjs +0 -8
  373. package/services/react-word-editor/railway.json +0 -21
  374. package/services/react-word-editor/scripts/wave-10-certification.mjs +0 -101
  375. package/services/react-word-editor/scripts/wave-9-live-usability-pilot.mjs +0 -911
  376. package/services/react-word-editor/tsconfig.json +0 -39
  377. package/services/react-word-editor/tsconfig.tsbuildinfo +0 -1
  378. package/skills/README.md +0 -48
  379. package/skills/domain-docx-compatibility/SKILL.md +0 -44
  380. package/skills/domain-docx-compatibility/skill.json +0 -19
  381. package/skills/domain-editor-architecture/SKILL.md +0 -49
  382. package/skills/domain-editor-architecture/skill.json +0 -19
  383. package/skills/domain-legal-review/SKILL.md +0 -39
  384. package/skills/domain-legal-review/skill.json +0 -19
  385. package/skills/provider-aws/SKILL.md +0 -117
  386. package/skills/provider-aws/adapters/claude.md +0 -1
  387. package/skills/provider-aws/adapters/codex.md +0 -1
  388. package/skills/provider-aws/references/service-verification.md +0 -39
  389. package/skills/provider-aws/skill.json +0 -54
  390. package/skills/provider-custom-deploy/SKILL.md +0 -64
  391. package/skills/provider-custom-deploy/skill.json +0 -50
  392. package/skills/provider-docker-compose/SKILL.md +0 -96
  393. package/skills/provider-docker-compose/adapters/local.md +0 -1
  394. package/skills/provider-docker-compose/skill.json +0 -53
  395. package/skills/provider-github-release/SKILL.md +0 -121
  396. package/skills/provider-github-release/adapters/claude.md +0 -1
  397. package/skills/provider-github-release/adapters/codex.md +0 -1
  398. package/skills/provider-github-release/skill.json +0 -55
  399. package/skills/provider-kubernetes/SKILL.md +0 -143
  400. package/skills/provider-kubernetes/adapters/claude.md +0 -1
  401. package/skills/provider-kubernetes/adapters/codex.md +0 -1
  402. package/skills/provider-kubernetes/references/kubectl-patterns.md +0 -58
  403. package/skills/provider-kubernetes/skill.json +0 -52
  404. package/skills/provider-railway/SKILL.md +0 -123
  405. package/skills/provider-railway/adapters/claude.md +0 -1
  406. package/skills/provider-railway/adapters/codex.md +0 -1
  407. package/skills/provider-railway/adapters/local.md +0 -1
  408. package/skills/provider-railway/adapters/opencode.md +0 -1
  409. package/skills/provider-railway/references/verification-commands.md +0 -39
  410. package/skills/provider-railway/skill.json +0 -71
  411. package/skills/provider-ssh-manual/SKILL.md +0 -97
  412. package/skills/provider-ssh-manual/skill.json +0 -54
  413. package/skills/repo-coding-rules/SKILL.md +0 -55
  414. package/skills/repo-coding-rules/skill.json +0 -34
  415. package/skills/role-cont-eval/SKILL.md +0 -91
  416. package/skills/role-cont-eval/adapters/codex.md +0 -1
  417. package/skills/role-cont-eval/skill.json +0 -36
  418. package/skills/role-cont-qa/SKILL.md +0 -100
  419. package/skills/role-cont-qa/adapters/claude.md +0 -1
  420. package/skills/role-cont-qa/skill.json +0 -36
  421. package/skills/role-deploy/SKILL.md +0 -97
  422. package/skills/role-deploy/skill.json +0 -36
  423. package/skills/role-design/SKILL.md +0 -50
  424. package/skills/role-design/skill.json +0 -36
  425. package/skills/role-documentation/SKILL.md +0 -76
  426. package/skills/role-documentation/skill.json +0 -36
  427. package/skills/role-implementation/SKILL.md +0 -45
  428. package/skills/role-implementation/skill.json +0 -36
  429. package/skills/role-infra/SKILL.md +0 -81
  430. package/skills/role-infra/skill.json +0 -36
  431. package/skills/role-integration/SKILL.md +0 -91
  432. package/skills/role-integration/skill.json +0 -36
  433. package/skills/role-planner/SKILL.md +0 -39
  434. package/skills/role-planner/skill.json +0 -21
  435. package/skills/role-research/SKILL.md +0 -65
  436. package/skills/role-research/skill.json +0 -36
  437. package/skills/role-security/SKILL.md +0 -60
  438. package/skills/role-security/skill.json +0 -36
  439. package/skills/runtime-claude/SKILL.md +0 -66
  440. package/skills/runtime-claude/skill.json +0 -36
  441. package/skills/runtime-codex/SKILL.md +0 -58
  442. package/skills/runtime-codex/skill.json +0 -36
  443. package/skills/runtime-local/SKILL.md +0 -46
  444. package/skills/runtime-local/skill.json +0 -36
  445. package/skills/runtime-opencode/SKILL.md +0 -58
  446. package/skills/runtime-opencode/skill.json +0 -36
  447. package/skills/signal-hygiene/SKILL.md +0 -51
  448. package/skills/signal-hygiene/skill.json +0 -20
  449. package/skills/tui-design/SKILL.md +0 -77
  450. package/skills/tui-design/references/tui-design.md +0 -259
  451. package/skills/tui-design/skill.json +0 -36
  452. package/skills/wave-core/SKILL.md +0 -141
  453. package/skills/wave-core/references/marker-syntax.md +0 -70
  454. package/skills/wave-core/skill.json +0 -35
  455. package/test/README.md +0 -16
  456. package/test/core/formatting-commands.test.ts +0 -285
  457. package/test/core/image-commands.test.ts +0 -298
  458. package/test/core/mapping.test.ts +0 -186
  459. package/test/core/text-commands.test.ts +0 -176
  460. package/test/fixtures/docx/F01-basic-contract.docx +0 -0
  461. package/test/fixtures/docx/F01-basic-contract.md +0 -33
  462. package/test/fixtures/docx/F02-headings-styles.docx +0 -0
  463. package/test/fixtures/docx/F02-headings-styles.md +0 -33
  464. package/test/fixtures/docx/F03-legal-outline-numbering.docx +0 -0
  465. package/test/fixtures/docx/F03-legal-outline-numbering.md +0 -34
  466. package/test/fixtures/docx/F04-restart-numbering-schedules.docx +0 -0
  467. package/test/fixtures/docx/F04-restart-numbering-schedules.md +0 -33
  468. package/test/fixtures/docx/F05-table-heavy-agreement.docx +0 -0
  469. package/test/fixtures/docx/F05-table-heavy-agreement.md +0 -34
  470. package/test/fixtures/docx/F06-merged-cells-signature-table.docx +0 -0
  471. package/test/fixtures/docx/F06-merged-cells-signature-table.md +0 -34
  472. package/test/fixtures/docx/F07-inline-images-exhibit.docx +0 -0
  473. package/test/fixtures/docx/F07-inline-images-exhibit.md +0 -34
  474. package/test/fixtures/docx/F08-hyperlinks.docx +0 -0
  475. package/test/fixtures/docx/F08-hyperlinks.md +0 -33
  476. package/test/fixtures/docx/F09-comments-single-paragraph.docx +0 -0
  477. package/test/fixtures/docx/F09-comments-single-paragraph.md +0 -33
  478. package/test/fixtures/docx/F10-threaded-comments-resolve.docx +0 -0
  479. package/test/fixtures/docx/F10-threaded-comments-resolve.md +0 -33
  480. package/test/fixtures/docx/F11-redlines-basic.docx +0 -0
  481. package/test/fixtures/docx/F11-redlines-basic.md +0 -33
  482. package/test/fixtures/docx/F12-redlines-paragraph-joins-splits.docx +0 -0
  483. package/test/fixtures/docx/F12-redlines-paragraph-joins-splits.md +0 -33
  484. package/test/fixtures/docx/F13-comments-on-deleted-text.docx +0 -0
  485. package/test/fixtures/docx/F13-comments-on-deleted-text.md +0 -33
  486. package/test/fixtures/docx/F14-revisions-in-tables-and-lists.docx +0 -0
  487. package/test/fixtures/docx/F14-revisions-in-tables-and-lists.md +0 -33
  488. package/test/fixtures/docx/F15-sections-headers-footers.docx +0 -0
  489. package/test/fixtures/docx/F15-sections-headers-footers.md +0 -33
  490. package/test/fixtures/docx/F16-footnotes-endnotes.docx +0 -0
  491. package/test/fixtures/docx/F16-footnotes-endnotes.md +0 -33
  492. package/test/fixtures/docx/F17-fields-and-toc.docx +0 -0
  493. package/test/fixtures/docx/F17-fields-and-toc.md +0 -33
  494. package/test/fixtures/docx/F18-content-controls-template.docx +0 -0
  495. package/test/fixtures/docx/F18-content-controls-template.md +0 -33
  496. package/test/fixtures/docx/F19-custom-xml-doc-assembly.docx +0 -0
  497. package/test/fixtures/docx/F19-custom-xml-doc-assembly.md +0 -35
  498. package/test/fixtures/docx/F20-unknown-ooxml-and-alternatecontent.docx +0 -0
  499. package/test/fixtures/docx/F20-unknown-ooxml-and-alternatecontent.md +0 -33
  500. package/test/fixtures/docx/F21-malformed-broken-docx.docx +0 -0
  501. package/test/fixtures/docx/F21-malformed-broken-docx.md +0 -33
  502. package/test/fixtures/docx/README.md +0 -74
  503. package/test/fixtures/docx/certification-manifest.json +0 -104
  504. package/test/fixtures/docx/fixtures.manifest.json +0 -196
  505. package/test/fixtures/encrypted-docx/README.md +0 -27
  506. package/test/fixtures/encrypted-docx/certification-manifest.json +0 -9
  507. package/test/fixtures/encrypted-docx/fixtures.manifest.json +0 -47
  508. package/test/fixtures/scenarios/docx/README.md +0 -25
  509. package/test/fixtures/scenarios/docx/S01-sow-template.docx +0 -0
  510. package/test/fixtures/scenarios/docx/S01-sow-template.md +0 -30
  511. package/test/fixtures/scenarios/docx/S02-bw-partner-user-licence-agreement-redlines.docx +0 -0
  512. package/test/fixtures/scenarios/docx/S02-bw-partner-user-licence-agreement-redlines.md +0 -32
  513. package/test/fixtures/scenarios/docx/scenario-manifest.json +0 -53
  514. package/test/formats/xlsx/io/xlsx-import.test.ts +0 -766
  515. package/test/formats/xlsx/model/workbook.test.ts +0 -669
  516. package/test/helpers/dom-setup.ts +0 -124
  517. package/test/io/comment-roundtrip.test.ts +0 -272
  518. package/test/io/complex-content-roundtrip.test.ts +0 -632
  519. package/test/io/docx-compatibility-regression.test.ts +0 -199
  520. package/test/io/docx-session.test.ts +0 -1495
  521. package/test/io/footnotes-roundtrip.test.ts +0 -318
  522. package/test/io/headers-footers-roundtrip.test.ts +0 -547
  523. package/test/io/numbering-roundtrip.test.ts +0 -234
  524. package/test/io/package-reader.test.ts +0 -199
  525. package/test/io/paragraph-properties-roundtrip.test.ts +0 -129
  526. package/test/io/preserved-package-roundtrip.test.ts +0 -365
  527. package/test/io/property-completeness.test.ts +0 -292
  528. package/test/io/revision-roundtrip.test.ts +0 -347
  529. package/test/io/structural-blocks.test.ts +0 -202
  530. package/test/io/table-media-roundtrip.test.ts +0 -448
  531. package/test/io/table-properties-roundtrip.test.ts +0 -569
  532. package/test/io/table-roundtrip.test.ts +0 -302
  533. package/test/io/text-roundtrip.test.ts +0 -344
  534. package/test/model/canonical-document.test.ts +0 -285
  535. package/test/preservation/opaque-fragment-store.test.ts +0 -121
  536. package/test/preservation/package-preservation.test.ts +0 -395
  537. package/test/preservation/store.test.ts +0 -84
  538. package/test/review/comment-remapping.test.ts +0 -220
  539. package/test/review/comment-store.test.ts +0 -180
  540. package/test/review/move-revisions.test.ts +0 -143
  541. package/test/review/property-change-revisions.test.ts +0 -225
  542. package/test/review/revision-actions.test.ts +0 -330
  543. package/test/review/revision-store.test.ts +0 -193
  544. package/test/runtime/session-capabilities.test.ts +0 -260
  545. package/test/runtime/table-commands.test.ts +0 -356
  546. package/test/runtime/table-schema.test.ts +0 -221
  547. package/test/runtime/tracked-changes-toggle.test.ts +0 -107
  548. package/test/ui/comment-review-surface.test.tsx +0 -114
  549. package/test/ui/reduced-motion-toggle.test.tsx +0 -137
  550. package/test/ui/word-review-editor.imported-scenarios.test.tsx +0 -169
  551. package/test/ui/word-review-editor.interaction.test.tsx +0 -1198
  552. package/test/ui/word-review-editor.test.js +0 -188
  553. package/test/ui/word-review-editor.test.tsx +0 -280
  554. package/test/ui-tailwind/search-plugin.test.ts +0 -286
  555. package/test/validation/compatibility-engine.test.ts +0 -336
  556. package/test/validation/compatibility-report.test.ts +0 -189
  557. package/test/validation/low-priority-word-surfaces.test.ts +0 -282
  558. package/test/validation/malformed-doc.test.ts +0 -113
  559. package/test-results/.last-run.json +0 -4
  560. package/wave.config.json +0 -406
@@ -1,111 +0,0 @@
1
- # Runtime-Agnostic Orchestration
2
-
3
- In short: one orchestrator, many runtimes.
4
-
5
- Wave is runtime agnostic at the orchestration layer.
6
-
7
- That means planning, skills, evaluation, proof, coordination, closure, and traces do not depend on whether the selected executor is Codex, Claude Code, OpenCode, or the local smoke executor.
8
-
9
- Wave abstracts the runtime away without flattening everything to the lowest common denominator. The wave contract stays stable while the executor adapter preserves the useful runtime-native features.
10
-
11
- ## What Stays The Same Across Runtimes
12
-
13
- These layers are runtime-neutral:
14
-
15
- - wave parsing and validation
16
- - planner-produced wave specs and authored wave markdown
17
- - reducer state and phase-engine decisions
18
- - eval targets, deliverables, and proof artifacts
19
- - component and closure gates
20
- - skill resolution and attachment policy
21
- - compiled shared summaries and per-agent inboxes
22
- - canonical authority-set state plus rendered projections
23
- - helper assignments and dependency handling
24
- - integration summaries, docs queues, and ledgers
25
- - dry-run previews
26
- - trace bundles and replay metadata
27
-
28
- The runtime only changes at the last step, when the session supervisor and executor adapter translate the resolved assignment into an executor-specific invocation.
29
-
30
- ## Where Runtime-Specific Logic Lives
31
-
32
- Runtime-specific behavior is isolated to the executor adapter layer:
33
-
34
- - Codex
35
- `codex exec` invocation, sandbox flags, `--add-dir`, JSON mode, search, images, and other `exec` flags.
36
- - Claude
37
- `claude -p` plus system-prompt overlay, settings merge, hooks, and permission surface.
38
- - OpenCode
39
- `opencode run` plus generated `opencode.json`, attached files, and runtime instruction overlays.
40
- - Local
41
- A smoke executor used for prompt and closure verification without a real hosted runtime.
42
-
43
- The orchestration substrate above those adapters does not need to know how the runtime transports prompts.
44
-
45
- This is the important distinction:
46
-
47
- - the orchestration layer owns goals, ownership, proof, and shared state
48
- - the executor adapter owns prompt transport, runtime-native flags, files, and settings
49
-
50
- That split is what lets Wave stay portable without giving up runtime-specific leverage.
51
-
52
- ## Why This Matters
53
-
54
- Runtime agnosticism gives you:
55
-
56
- - the same plan, skill, and closure model across vendors
57
- - the same eval and proof model across vendors
58
- - replay and audit surfaces that do not care which runtime produced the work
59
- - per-role runtime choice without rewriting authoring conventions
60
- - retry-time fallback without inventing a second planning model
61
-
62
- ## Runtime Resolution
63
-
64
- Executor choice resolves in a fixed order:
65
-
66
- 1. explicit agent `### Executor` id
67
- 2. executor profile id
68
- 3. lane role default
69
- 4. CLI `--executor`
70
- 5. global default
71
-
72
- After that choice is final, the orchestrator resolves runtime-specific overlays and any runtime-attached skill packs.
73
-
74
- ## Fallback And Mix Policy
75
-
76
- Wave is not runtime blind. It is runtime agnostic, but still runtime aware.
77
-
78
- - runtime mix targets can cap how many agents use a given executor
79
- - executor profiles can declare fallbacks
80
- - lane policy can supply default executor choices by role
81
- - retries can reassign an agent to a policy-safe fallback runtime
82
-
83
- The important part is that fallback does not change the higher-level wave contract. The runtime changes, but the ownership, closure, and trace model remain the same.
84
-
85
- ## Skills Across Runtimes
86
-
87
- The skill system follows the same pattern:
88
-
89
- - `skills/` is the canonical repo-owned source
90
- - the orchestrator resolves skill ids without caring which runtime will consume them
91
- - the executor adapter projects those skills into the surface each runtime understands
92
-
93
- Examples:
94
-
95
- - Codex receives skill bundle directories through `--add-dir`
96
- - Claude receives merged skill text through the generated system prompt overlay
97
- - OpenCode receives skill instructions and attached files through `opencode.json` and `--file`
98
- - Local receives prompt-only projections
99
-
100
- The bundle is shared. The projection is runtime specific.
101
-
102
- ## Best Practice
103
-
104
- Keep planning, ownership, and proof requirements runtime neutral whenever possible. Use runtime-specific settings only for:
105
-
106
- - transport details
107
- - model or budget selection
108
- - safety and permission settings
109
- - runtime-native adapter instructions
110
-
111
- That separation is what keeps the orchestrator portable instead of turning it into a Codex-only or Claude-only harness.
@@ -1,217 +0,0 @@
1
- # What Is A Wave?
2
-
3
- A wave is the main planning and execution unit in Wave Orchestration.
4
-
5
- It turns free-form agent runs into a bounded blackboard-style work package with shared state, explicit ownership, dynamic context, goal-driven execution, and proof-bounded closure.
6
-
7
- It is not just a prompt file. A wave is a bounded slice of repository work with:
8
-
9
- - explicit scope
10
- - named owners
11
- - runtime and context requirements
12
- - proof and closure rules
13
- - durable coordination state
14
- - replayable execution artifacts
15
-
16
- ## Core Terms
17
-
18
- - Lane
19
- An ordered sequence of waves. The default lane in this repo is `main`.
20
- - Wave
21
- One numbered work package inside a lane, usually stored as `docs/plans/waves/wave-<n>.md`.
22
- - Agent
23
- One role inside the wave, such as design, implementation, `cont-EVAL`, security review, integration, documentation, cont-QA, infra, or deploy.
24
- - Attempt
25
- One execution pass of a wave. A wave can have multiple attempts due to retries or fallback.
26
- - Closure
27
- The final proof pass that decides whether the wave is actually done, not just partially implemented.
28
-
29
- ## Why Waves Exist
30
-
31
- Waves force a higher planning bar than ad hoc prompts. A good wave answers:
32
-
33
- - What is changing now, and why now?
34
- - Which components or docs are in scope?
35
- - Which agent owns each slice?
36
- - What evidence closes the wave?
37
- - Which dependencies, helper requests, or escalations can still block completion?
38
-
39
- ## Why This Is A Blackboard-Style Model
40
-
41
- Wave is blackboard-style because agents work against shared canonical state instead of treating chat output as the system of record.
42
-
43
- - wave definitions, the coordination log, and the control-plane log form the canonical authority set
44
- - attempt-scoped result envelopes are the immutable structured outcome surface for completed agent work
45
- - the rolling board is a human projection over that state, not a decision input
46
- - shared summaries and per-agent inboxes are compiled views over the same authority set
47
- - helper assignments, clarification flow, dependencies, and integration all operate on that shared state
48
- - closure depends on the integrated state, not on whether an agent says "done"
49
-
50
- ## Wave Anatomy
51
-
52
- Wave markdown is one authored declaration surface today. A typical wave can include:
53
-
54
- - title and commit message
55
- - project profile details such as oversight mode and lane
56
- - sequencing note
57
- - reference rule
58
- - deploy environments
59
- - component promotions
60
- - eval targets
61
- - Context7 defaults
62
- - one `## Agent ...` block per role
63
-
64
- Inside each agent block, the important sections are:
65
-
66
- - `### Role prompts`
67
- Standing role identity imported from `docs/agents/*.md`.
68
- - `### Executor`
69
- Runtime selection, profile, model, fallbacks, and budgets.
70
- - `## Eval targets`
71
- Optional wave-level contract for `cont-EVAL`, including benchmark family or pinned benchmarks, objective, and stop condition.
72
- See [docs/evals/README.md](../evals/README.md) for guidance on delegated versus pinned targets and the coordination benchmark families.
73
- - `### Proof artifacts`
74
- Optional machine-visible local evidence required for proof-centric waves, especially `pilot-live` and above.
75
- - `### Context7`
76
- External library truth to prefetch and inject.
77
- - `### Skills`
78
- Reusable repo-owned environment or workflow guidance resolved after runtime selection.
79
- - `### Components`
80
- The components that agent is responsible for proving or promoting.
81
- - `### Capabilities`
82
- Optional routing hints for follow-up work.
83
- - `### Deliverables`
84
- Exact repo-relative outputs that must exist before closure can pass.
85
- - `### Prompt`
86
- The specific task, file ownership, requirements, and validation instructions.
87
- - `### Exit contract`
88
- The completion, durability, proof, and documentation expectations that gate closure.
89
-
90
- ## Standard Roles
91
-
92
- The starter runtime ships with three default closure roles plus optional specialists. A wave may override the role ids, but the closure semantics stay the same:
93
-
94
- - `A8`
95
- Integration steward
96
- - `A9`
97
- Documentation steward
98
- - `A0`
99
- cont-QA
100
- - `E0`
101
- Optional `cont-EVAL` for iterative benchmark or output tuning; report-only by default, implementation-owning only when explicitly assigned non-report files
102
- - `A7`
103
- Optional security reviewer; report-only by default and used to publish a threat-model-first security review before integration closure
104
- - `D1` or another custom id
105
- Optional design steward; report-first and docs/spec-owned by default, used to publish a design packet before code-owning implementation fans out. If the wave explicitly gives that same agent source-code ownership, it becomes a hybrid design steward that rejoins the later implementation fan-out.
106
-
107
- Implementation or specialist agents own the actual work slices. Closure roles do not replace implementation ownership; they decide whether the combined result is closure-ready. `cont-EVAL` is the one hybrid role: most waves keep it report-only, but human-authored waves may assign explicit tuning files to `E0`, in which case it must satisfy both implementation proof and eval proof.
108
-
109
- ## Lifecycle Of A Wave
110
-
111
- 1. Author or draft the wave.
112
- 2. Run `wave launch --dry-run --no-dashboard`.
113
- 3. The launcher parses the wave, resolves executors and skills, rebuilds reducer state, and materializes operator surfaces.
114
- 4. A live run launches design agents first when the wave declares them.
115
- 5. Code-owning implementation agents start only after every design packet is `ready-for-implementation`; hybrid design stewards rejoin that implementation fan-out once the design gate clears.
116
- 6. Agents write structured coordination events instead of relying on ad hoc terminal output.
117
- 7. The reducer, gate engine, and retry or closure engines evaluate design readiness, implementation contracts, promoted-component proof, helper assignments, dependencies, contradictions, and clarification state.
118
- 8. If implementation is ready, closure runs in order: optional `cont-EVAL`, optional security review, integration, documentation, then cont-QA.
119
- 9. The attempt is captured in per-wave traces, ledgers, inboxes, summaries, and copied artifacts.
120
-
121
- ## Runtime And Operating Posture
122
-
123
- Wave is runtime agnostic at the orchestration layer.
124
-
125
- Planning, ownership, closure, durable state, and traces do not depend on whether an agent runs on Codex, Claude Code, OpenCode, or the local smoke executor. Runtime-specific behavior is isolated to executor adapters and overlays.
126
-
127
- That means a wave should usually be authored in runtime-neutral terms:
128
-
129
- - ownership and deliverables
130
- - proof and validation
131
- - closure order
132
- - dependencies and helper flow
133
- - promoted component expectations
134
-
135
- The runtime choice resolves later, from the agent executor block, profile defaults, lane defaults, CLI overrides, and fallback policy.
136
-
137
- Wave also has an execution posture:
138
-
139
- - `oversight`
140
- Human review or intervention is expected for risky or ambiguous work.
141
- - `dark-factory`
142
- The wave is authored for routine execution without normal human intervention.
143
-
144
- Today these postures are planning vocabulary and saved project defaults, not two separate execution engines. Human feedback is still an escalation mechanism inside the orchestration loop, not the definition of the operating mode itself.
145
-
146
- If you need the narrower supporting pages, see [runtime-agnostic-orchestration.md](./runtime-agnostic-orchestration.md) and [operating-modes.md](./operating-modes.md).
147
-
148
- Current live waves are strict about closure artifacts:
149
-
150
- - `cont-EVAL` must emit a structured `[wave-eval]` marker whose `target_ids` matches the declared eval targets and whose `benchmark_ids` enumerates the executed benchmark set.
151
- - Security reviewers must leave a security review report and emit a final `[wave-security]` marker with `state=<clear|concerns|blocked>`, finding count, and approval count.
152
- - `cont-QA` must emit both a final `Verdict:` line and a final `[wave-gate]` marker.
153
- - Replay keeps read-only compatibility with older traces and older evaluator-era artifacts, but live waves do not pass on verdict-only or underspecified closure markers.
154
-
155
- ## Context Is Compiled At Runtime
156
-
157
- Wave also treats context as something to compile for the current task, not something humans should hand-maintain separately for each runtime.
158
-
159
- The active context for an agent is assembled from:
160
-
161
- - repository source and owned files
162
- - wave markdown and shared plan docs
163
- - saved project defaults such as `.wave/project-profile.json`
164
- - the generated shared summary and the agent's inbox
165
- - resolved skills and runtime-specific skill projections
166
- - selected Context7 snippets for external library truth
167
- - generated executor overlays and launch artifacts
168
-
169
- That is why switching an agent between Codex, Claude, or OpenCode does not require maintaining separate parallel context files. The orchestrator recomputes the context package for the selected runtime and the current wave state.
170
-
171
- ## What Makes A Wave "Done"
172
-
173
- A wave is not done because an agent said so. It is done only when the runtime surfaces agree:
174
-
175
- - implementation exit contracts pass
176
- - if present, design packets are complete and every design worker reports `ready-for-implementation`
177
- - required deliverables exist and stay within ownership boundaries
178
- - required proof artifacts exist when the wave declares proof-first live evidence
179
- - required component proof and promotions pass
180
- - helper assignments are resolved
181
- - required dependency tickets are resolved
182
- - clarification follow-ups or escalations are resolved
183
- - if present, `cont-EVAL` satisfies its declared eval targets
184
- - if present, the security reviewer publishes a report plus a final `[wave-security]` marker; `blocked` stops closure while `concerns` stays advisory
185
- - integration recommends closure
186
- - documentation and cont-QA closure pass
187
-
188
- For proof-first live-wave examples, see [docs/reference/live-proof-waves.md](../reference/live-proof-waves.md).
189
-
190
- ## Where The State Lives
191
-
192
- The wave file is only part of the story. The runtime writes durable state under `.tmp/<lane>-wave-launcher/`, including:
193
-
194
- - prompts and logs
195
- - result envelopes
196
- - status summaries
197
- - coordination logs
198
- - rendered message boards
199
- - compiled inboxes
200
- - ledger and docs queue
201
- - security summaries
202
- - integration summaries
203
- - dependency snapshots
204
- - executor overlays
205
- - trace bundles
206
-
207
- That is why a wave is better understood as a bounded execution record, not just a markdown file.
208
-
209
- ## Planner Specs vs Markdown
210
-
211
- The planner foundation adds a JSON draft spec at `docs/plans/waves/specs/wave-<n>.json`.
212
-
213
- - The JSON spec is the canonical planner artifact.
214
- - The rendered markdown stays compatible with the current parser and operator workflow.
215
- - Live execution decisions come from parsed wave definitions plus canonical state, not from treating markdown as the only execution authority.
216
-
217
- This split keeps authoring structured while preserving the established declaration surface.
@@ -1,222 +0,0 @@
1
- {
2
- "version": 1,
3
- "defaultBundle": "none",
4
- "laneDefaults": {
5
- "main": "none"
6
- },
7
- "bundles": {
8
- "none": {
9
- "description": "Disable Context7 prefetch for this run.",
10
- "libraries": []
11
- },
12
- "node-typescript": {
13
- "description": "Node.js and TypeScript runtime docs for JavaScript service and tooling work.",
14
- "libraries": [
15
- {
16
- "libraryId": "/nodejs/node",
17
- "queryHint": "runtime APIs, child processes, streams, filesystem behavior, and process lifecycle"
18
- },
19
- {
20
- "libraryId": "/microsoft/typescript",
21
- "queryHint": "types, declarations, module resolution, tsconfig, and compiler behavior"
22
- }
23
- ]
24
- },
25
- "planner-agentic": {
26
- "description": "Placeholder bundle for the repo-local planner corpus. Keep this empty until the corpus is published to Context7 and an exact libraryId is known.",
27
- "libraries": []
28
- },
29
- "word-editor-contracts": {
30
- "description": "Precise docs for canonical schema, ProseMirror transaction semantics, and React host contracts.",
31
- "libraries": [
32
- {
33
- "libraryId": "/prosemirror/website",
34
- "queryHint": "schema design, positions, mappings, transactions, marks, and node contracts"
35
- },
36
- {
37
- "libraryId": "/microsoft/typescript",
38
- "queryHint": "discriminated unions, declaration files, strict typing, and module boundaries"
39
- },
40
- {
41
- "libraryId": "/reactjs/react.dev",
42
- "queryHint": "imperative handles, uncontrolled components, refs, and host integration boundaries"
43
- }
44
- ]
45
- },
46
- "word-editor-runtime": {
47
- "description": "Runtime docs for ProseMirror-driven editor state, Node-based processing, and TypeScript contracts.",
48
- "libraries": [
49
- {
50
- "libraryId": "/prosemirror/website",
51
- "queryHint": "editor state, transaction application, decorations, plugin state, and mapping"
52
- },
53
- {
54
- "libraryId": "/nodejs/node",
55
- "queryHint": "buffers, streams, filesystem, child processes, and process behavior"
56
- },
57
- {
58
- "libraryId": "/microsoft/typescript",
59
- "queryHint": "type narrowing, generics, module resolution, and compiler behavior"
60
- }
61
- ]
62
- },
63
- "word-editor-ooxml": {
64
- "description": "Precise OOXML and Open XML SDK docs for package handling, relationships, and validation behavior.",
65
- "libraries": [
66
- {
67
- "libraryId": "/dotnet/open-xml-sdk",
68
- "queryHint": "OpenXmlValidator, package parts, relationships, comments, revisions, and WordprocessingML"
69
- },
70
- {
71
- "libraryId": "/websites/officeopenxml",
72
- "queryHint": "OOXML packaging, markup compatibility, AlternateContent, and WordprocessingML structure"
73
- },
74
- {
75
- "libraryId": "/nodejs/node",
76
- "queryHint": "zip handling, buffers, streams, and filesystem operations for document processing"
77
- }
78
- ]
79
- },
80
- "word-editor-ui": {
81
- "description": "UI-shell docs for React, Next.js, and TypeScript around host embedding and interaction surfaces.",
82
- "libraries": [
83
- {
84
- "libraryId": "/reactjs/react.dev",
85
- "queryHint": "refs, transitions, event handling, rendering, and component composition"
86
- },
87
- {
88
- "libraryId": "/websites/nextjs",
89
- "queryHint": "app router, server and client components, routing, and build behavior"
90
- },
91
- {
92
- "libraryId": "/microsoft/typescript",
93
- "queryHint": "JSX typing, declarations, and strict component prop contracts"
94
- }
95
- ]
96
- },
97
- "word-editor-testing": {
98
- "description": "Precise testing docs for unit, integration, and browser-proof flows.",
99
- "libraries": [
100
- {
101
- "libraryId": "/vitest-dev/vitest",
102
- "queryHint": "unit tests, snapshots, mocking, coverage, and configuration"
103
- },
104
- {
105
- "libraryId": "/microsoft/playwright",
106
- "queryHint": "browser automation, fixtures, test isolation, and assertions"
107
- },
108
- {
109
- "libraryId": "/reactjs/react.dev",
110
- "queryHint": "testing interaction assumptions, forms, refs, and rendering expectations"
111
- }
112
- ]
113
- },
114
- "railway-harness": {
115
- "description": "Precise docs for the internal Railway harness and its local persistence/runtime setup.",
116
- "libraries": [
117
- {
118
- "libraryId": "/websites/nextjs",
119
- "queryHint": "app router, route handlers, metadata, and production build behavior"
120
- },
121
- {
122
- "libraryId": "/websites/railway",
123
- "queryHint": "private networking, Dockerfile deploys, service variables, and volumes"
124
- },
125
- {
126
- "libraryId": "/docker/docs",
127
- "queryHint": "Dockerfile builds, multi-stage images, runtime env vars, and container networking"
128
- },
129
- {
130
- "libraryId": "/websites/sqlite_docs",
131
- "queryHint": "lightweight persistence, file-backed databases, schema basics, and transactions"
132
- }
133
- ]
134
- },
135
- "validator-dotnet": {
136
- "description": "Precise docs for the .NET-based Open XML validator service.",
137
- "libraries": [
138
- {
139
- "libraryId": "/dotnet/aspnetcore.docs",
140
- "queryHint": "ASP.NET Core minimal APIs, multipart uploads, JSON responses, and hosting"
141
- },
142
- {
143
- "libraryId": "/dotnet/open-xml-sdk",
144
- "queryHint": "OpenXmlValidator, WordprocessingDocument, package inspection, and validation errors"
145
- },
146
- {
147
- "libraryId": "/docker/docs",
148
- "queryHint": "multi-stage .NET container builds, ports, and runtime images"
149
- }
150
- ]
151
- },
152
- "react-web": {
153
- "description": "React and Next.js docs for frontend work.",
154
- "libraries": [
155
- {
156
- "libraryId": "/reactjs/react.dev",
157
- "queryHint": "components, hooks, rendering, forms, and data flow"
158
- },
159
- {
160
- "libraryId": "/websites/nextjs",
161
- "queryHint": "routing, server components, data fetching, and app router behavior"
162
- }
163
- ]
164
- },
165
- "python-services": {
166
- "description": "Python backend docs for API and worker services.",
167
- "libraries": [
168
- {
169
- "libraryId": "/websites/python_3",
170
- "queryHint": "language features, packaging, typing, and standard library behavior"
171
- },
172
- {
173
- "libraryId": "/fastapi/fastapi",
174
- "queryHint": "routing, request validation, dependency injection, and OpenAPI behavior"
175
- }
176
- ]
177
- },
178
- "go-services": {
179
- "description": "Go service and workflow docs for backend work.",
180
- "libraries": [
181
- {
182
- "libraryId": "/websites/go_dev_ref_spec",
183
- "queryHint": "language syntax, testing, concurrency, errors, and module semantics"
184
- },
185
- {
186
- "libraryId": "/websites/pkg_go_dev",
187
- "queryHint": "standard packages, modules, package layout, and reference behavior"
188
- },
189
- {
190
- "libraryId": "/temporalio/documentation",
191
- "queryHint": "workflow setup, activities, schedules, retries, and worker bootstrap"
192
- }
193
- ]
194
- },
195
- "persistence": {
196
- "description": "Database and storage docs for persistence work.",
197
- "libraries": [
198
- {
199
- "libraryId": "/websites/postgresql_current",
200
- "queryHint": "schema changes, indexes, transactions, constraints, and query behavior"
201
- },
202
- {
203
- "libraryId": "/websites/sqlite_docs",
204
- "queryHint": "local persistence, fts, schema migration, and durability patterns"
205
- }
206
- ]
207
- },
208
- "infra-ops": {
209
- "description": "Infrastructure and service-manager docs for deployment and operations work.",
210
- "libraries": [
211
- {
212
- "libraryId": "/docker/docs",
213
- "queryHint": "images, builds, volumes, networking, and runtime configuration"
214
- },
215
- {
216
- "libraryId": "/websites/systemd_io",
217
- "queryHint": "units, dependencies, restart policies, readiness, and service management"
218
- }
219
- ]
220
- }
221
- }
222
- }
@@ -1,28 +0,0 @@
1
- # Planner Agent Context7 Corpus
2
-
3
- This folder contains the tracked planner corpus that can be published as a
4
- custom Context7 library for the agentic planner.
5
-
6
- Why it exists:
7
-
8
- - the original planning research cache lives under `docs/research/agent-context-cache/`
9
- - that cache is intentionally ignored in repository workspaces
10
- - the planner feature needs a shippable, reviewable, repo-local copy of the
11
- exact subset we want to publish and consume
12
-
13
- Publish target:
14
-
15
- - bundle id: `planner-agentic`
16
- - committed repo config should stay empty until the planner corpus is published
17
- and Context7 returns an exact `libraryId`
18
- - once published, record that returned `libraryId` in
19
- `docs/context7/bundles.json` instead of committing a guessed library name
20
-
21
- Refresh the copied corpus after updating the agent-context cache:
22
-
23
- ```bash
24
- pnpm research:sync-planner-context7
25
- ```
26
-
27
- The generated `manifest.json` records the copied files, their source paths, and
28
- their hashes so drift is reviewable in git.
@@ -1,83 +0,0 @@
1
- {
2
- "version": 1,
3
- "generatedAt": "2026-03-22T21:14:01.636Z",
4
- "bundleId": "planner-agentic",
5
- "libraryName": "wave-planner-agentic",
6
- "defaultQuery": "Wave planning best practices, maturity alignment, closure gates, proof surfaces, rollout evidence, and coordination failure prevention",
7
- "sourceRoot": "docs/research/agent-context-cache",
8
- "targetRoot": "docs/context7/planner-agent",
9
- "files": [
10
- {
11
- "kind": "paper",
12
- "sourcePath": "docs/research/agent-context-cache/papers/verified-multi-agent-orchestration-a-plan-execute-verify-replan-framework-for-complex-query-resolution.md",
13
- "targetPath": "docs/context7/planner-agent/papers/verified-multi-agent-orchestration-a-plan-execute-verify-replan-framework-for-complex-query-resolution.md",
14
- "title": "Verified Multi-Agent Orchestration: A Plan-Execute-Verify-Replan Framework for Complex Query Resolution",
15
- "bytes": 35443,
16
- "sha256": "7fecced650f5268e25ef10c10c46bc9b53ea334a39e7b04315c7d72cf663870b"
17
- },
18
- {
19
- "kind": "paper",
20
- "sourcePath": "docs/research/agent-context-cache/papers/todoevolve-learning-to-architect-agent-planning-systems.md",
21
- "targetPath": "docs/context7/planner-agent/papers/todoevolve-learning-to-architect-agent-planning-systems.md",
22
- "title": "TodoEvolve: Learning to Architect Agent Planning Systems",
23
- "bytes": 67584,
24
- "sha256": "e2e18bd732105115d3cb3eb226e8033f421634c790b2c3bbc576cefaeff92165"
25
- },
26
- {
27
- "kind": "paper",
28
- "sourcePath": "docs/research/agent-context-cache/papers/dova-deliberation-first-multi-agent-orchestration-for-autonomous-research-automation.md",
29
- "targetPath": "docs/context7/planner-agent/papers/dova-deliberation-first-multi-agent-orchestration-for-autonomous-research-automation.md",
30
- "title": "DOVA: Deliberation-First Multi-Agent Orchestration for Autonomous Research Automation",
31
- "bytes": 36202,
32
- "sha256": "d54ad0d331942cd62bd6e5cf2ed44edc577eceee6c5dadbfb88e072a96df06c0"
33
- },
34
- {
35
- "kind": "paper",
36
- "sourcePath": "docs/research/agent-context-cache/papers/why-do-multi-agent-llm-systems-fail.md",
37
- "targetPath": "docs/context7/planner-agent/papers/why-do-multi-agent-llm-systems-fail.md",
38
- "title": "Why Do Multi-Agent LLM Systems Fail?",
39
- "bytes": 141179,
40
- "sha256": "faaf6dd51ab9eb612b58bd00c9b0d13595daabd4b34078a24ed135e28b12868d"
41
- },
42
- {
43
- "kind": "paper",
44
- "sourcePath": "docs/research/agent-context-cache/papers/silo-bench-a-scalable-environment-for-evaluating-distributed-coordination-in-multi-agent-llm-systems.md",
45
- "targetPath": "docs/context7/planner-agent/papers/silo-bench-a-scalable-environment-for-evaluating-distributed-coordination-in-multi-agent-llm-systems.md",
46
- "title": "Silo-Bench: A Scalable Environment for Evaluating Distributed Coordination in Multi-Agent LLM Systems",
47
- "bytes": 76435,
48
- "sha256": "e28334cd0891773f7044c7e29bbcc6c3ae79b701838a6b8526fffdf2c5e4c41d"
49
- },
50
- {
51
- "kind": "paper",
52
- "sourcePath": "docs/research/agent-context-cache/papers/dpbench-large-language-models-struggle-with-simultaneous-coordination.md",
53
- "targetPath": "docs/context7/planner-agent/papers/dpbench-large-language-models-struggle-with-simultaneous-coordination.md",
54
- "title": "DPBench: Large Language Models Struggle with Simultaneous Coordination",
55
- "bytes": 54309,
56
- "sha256": "22a37fd0fbcf5e21b89d9dba9e7d51298c93ad8baefd17dc3373373105f01f07"
57
- },
58
- {
59
- "kind": "paper",
60
- "sourcePath": "docs/research/agent-context-cache/papers/cooperbench-why-coding-agents-cannot-be-your-teammates-yet.md",
61
- "targetPath": "docs/context7/planner-agent/papers/cooperbench-why-coding-agents-cannot-be-your-teammates-yet.md",
62
- "title": "CooperBench: Why Coding Agents Cannot be Your Teammates Yet",
63
- "bytes": 104926,
64
- "sha256": "463a2f7129ad2869a80f2a697682fa57407a76d3d5cadf7a94234bfd55ef1992"
65
- },
66
- {
67
- "kind": "paper",
68
- "sourcePath": "docs/research/agent-context-cache/papers/incremental-planning-to-control-a-blackboard-based-problem-solver.md",
69
- "targetPath": "docs/context7/planner-agent/papers/incremental-planning-to-control-a-blackboard-based-problem-solver.md",
70
- "title": "Incremental Planning to Control a Blackboard-Based Problem Solver",
71
- "bytes": 44369,
72
- "sha256": "568fe7236b214fe0a24e0530513776ee5579e0366b9f277e8c0ebd49daea7b67"
73
- },
74
- {
75
- "kind": "topic",
76
- "sourcePath": "docs/research/agent-context-cache/topics/planning-and-orchestration.md",
77
- "targetPath": "docs/context7/planner-agent/topics/planning-and-orchestration.md",
78
- "title": "Planner Agentic Context7 Corpus",
79
- "bytes": 1858,
80
- "sha256": "5c8c00bc2c4b72330267ca8cce2889b2eaa3bbf02db49e90a1fb7b0eb9d0ef44"
81
- }
82
- ]
83
- }