@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,97 +0,0 @@
1
- # Deploy Role
2
-
3
- <!-- CUSTOMIZE: Add project-specific deploy targets, health check endpoints, or rollback procedures below. -->
4
-
5
- ## Core Rules
6
-
7
- - Treat deployment verification as first-class proof, not a postscript to coding.
8
- - Name the exact service, package, or runtime surface being rolled out.
9
- - Record health, readiness, failure, and rollback state explicitly.
10
- - If rollout proof is incomplete, downgrade the wave honestly instead of implying success.
11
- - Re-read the compiled shared summary, your inbox, and the board projection before major decisions and before final output. If deployment evidence disagrees with a projection, trust the deployment evidence and canonical state.
12
-
13
- ## Workflow
14
-
15
- Execute these steps for each deploy surface in the wave:
16
-
17
- 1. **Identify surface** -- name the exact service, package, or runtime target being deployed. Record the version or commit being rolled out.
18
- 2. **Verify build** -- confirm the build step completed successfully. Record build output location and any warnings.
19
- 3. **Verify deploy** -- confirm the deploy step completed. Record the deploy mechanism (CI pipeline, manual push, platform deploy) and any output.
20
- 4. **Verify health** -- run health checks against the deployed surface. Record the results.
21
- 5. **Record evidence** -- collect all proof artifacts into a durable summary.
22
- 6. **Emit marker** -- produce one `[deploy-status]` marker per service.
23
-
24
- ## Evidence Gathering
25
-
26
- Collect and record these artifacts for each deploy surface:
27
-
28
- | Evidence type | What to capture |
29
- |---|---|
30
- | **Build logs** | Build command, exit code, output location, warnings or errors. |
31
- | **Deploy logs** | Deploy command or pipeline, exit code, deploy target, timestamp. |
32
- | **Health checks** | Endpoint URL or command, response status, response time, key response fields. |
33
- | **Domain bindings** | Custom domains, DNS state, TLS certificate validity. |
34
- | **Variable state** | Environment variables set (names only, not values), config files deployed, feature flags active. |
35
-
36
- Do not record secret values. Record only the presence and names of secrets, not their contents.
37
-
38
- ## Health Proof
39
-
40
- Classify each deployed service:
41
-
42
- - **Healthy**: health check returns success, service responds to requests, key functionality verified. This is the only state that supports wave closure.
43
- - **Degraded**: service is running but health checks show warnings, elevated latency, or partial functionality. Record which aspects are degraded.
44
- - **Failed**: health check fails, service does not respond, or key functionality is broken. Record the failure mode.
45
-
46
- Health proof must come from actual verification (HTTP requests, CLI commands, log inspection), not from the deployment tool claiming success.
47
-
48
- ## Failure Classification
49
-
50
- When deployment does not succeed fully, classify the failure:
51
-
52
- | Failure type | Description | Next action |
53
- |---|---|---|
54
- | **Build failure** | Build step did not produce deployable artifacts. | Fix build, do not attempt deploy. |
55
- | **Deploy failure** | Build succeeded but deploy step failed. | Check deploy config, permissions, target availability. |
56
- | **Health regression** | Deploy succeeded but health is worse than before. | Compare against baseline, consider rollback. |
57
- | **Config drift** | Deployed config does not match expected state. | Reconcile config, re-deploy if needed. |
58
- | **Rollback needed** | Any failure that cannot be resolved forward in the wave. | Execute rollback, record evidence. |
59
-
60
- ## Rollback Protocol
61
-
62
- When rollback is necessary:
63
-
64
- 1. Record the reason for rollback with exact failure evidence.
65
- 2. Execute the rollback to the last known healthy state.
66
- 3. Verify health after rollback.
67
- 4. Emit a `[deploy-status]` marker with `state=rolled-back`.
68
- 5. Post a coordination record so integration and cont-QA see the rollback.
69
- 6. Do not claim the deploy surface is healthy after a rollback. The wave's deploy exit contract is not met.
70
- 7. If a rollback occurs, any operator-registered proof that relied on the deployed state should be superseded or revoked via `wave control proof supersede` or `wave control proof revoke`.
71
-
72
- ## Marker Format
73
-
74
- Emit one marker per deployed service:
75
-
76
- ```
77
- [deploy-status] state=<deploying|healthy|failed|rolled-back> service=<name> detail=<text>
78
- ```
79
-
80
- - `state`:
81
- - `deploying` -- deploy is in progress.
82
- - `healthy` -- deploy succeeded and health checks pass.
83
- - `failed` -- deploy or health verification failed.
84
- - `rolled-back` -- service was rolled back to a previous state.
85
- - `service`: exact service or package name (e.g., `wave-orchestration-api`, `docs-site`, `@chllming/wave-orchestration`).
86
- - `detail`: concise summary (under 120 characters) including version or commit if available.
87
-
88
- ## Customization
89
-
90
- <!-- CUSTOMIZE: Override or extend any section above. Common additions:
91
- - Platform-specific deploy steps (Vercel, Railway, Fly, Kubernetes)
92
- - Blue-green or canary deployment procedures
93
- - Smoke test scripts to run post-deploy
94
- - Notification channels for deploy events
95
- - Approval gates before production deploy
96
- - Monitoring dashboard links to verify post-deploy
97
- -->
@@ -1,36 +0,0 @@
1
- {
2
- "id": "role-deploy",
3
- "title": "Deploy Role",
4
- "description": "Guides the deploy agent through rollout verification, health proof, failure classification, rollback posture, and deploy status marker emission.",
5
- "activation": {
6
- "when": "Attach when the agent owns rollout verification, status publication, and rollback posture.",
7
- "roles": [
8
- "deploy"
9
- ],
10
- "runtimes": [],
11
- "deployKinds": []
12
- },
13
- "termination": "Stop when deploy evidence is captured and the release state is clearly classified.",
14
- "permissions": {
15
- "network": [],
16
- "shell": [],
17
- "mcpServers": []
18
- },
19
- "trust": {
20
- "tier": "repo-owned"
21
- },
22
- "evalCases": [
23
- {
24
- "id": "deploy-opencode",
25
- "role": "deploy",
26
- "runtime": "opencode",
27
- "expectActive": true
28
- },
29
- {
30
- "id": "documentation-opencode",
31
- "role": "documentation",
32
- "runtime": "opencode",
33
- "expectActive": false
34
- }
35
- ]
36
- }
@@ -1,50 +0,0 @@
1
- # Design Role
2
-
3
- ## Core Rules
4
-
5
- - Produce an implementation-ready design packet, not a vague brainstorm.
6
- - Keep the design packet scoped to the wave's owned surfaces and declared intent.
7
- - Stay docs/spec-owned by default. Route code changes back to implementation owners unless the wave explicitly assigns code ownership.
8
- - Make decisions concrete: exact interfaces, files, fields, contracts, and ownership boundaries.
9
- - Name assumptions explicitly so downstream implementation owners do not mistake them for facts.
10
- - When the wave touches terminal UX, dashboards, or other operator surfaces, use `skills/tui-design/references/tui-design.md` as the deep heuristic reference.
11
- - Fail closed on operator dishonesty. If the current design would hide blockers, fake success, or depend on UI-local truth that the reducer or projections do not expose, stop and say so directly.
12
- - Fail closed when implementation should stop for clarification instead of burying uncertainty in prose.
13
-
14
- ## Workflow
15
-
16
- 1. Read the wave definition, shared summary, inbox, and board projection.
17
- 2. Reconstruct the problem and constraints from repository truth, not only from recent discussion.
18
- 3. If operator-facing or terminal UX work is in scope, read `skills/tui-design/references/tui-design.md` before writing the packet.
19
- 4. Write the design packet in the required section order.
20
- 5. Convert ambiguity into one of:
21
- - a decision
22
- - an assumption
23
- - an open question
24
- - a blocker
25
- 6. Make interface impacts exact enough for implementation owners to start immediately.
26
- 7. End with one final `[wave-design]` marker that matches the packet state.
27
-
28
- ## Packet Standard
29
-
30
- The design packet must contain these sections in order:
31
-
32
- - `Problem`
33
- - `Constraints`
34
- - `Decisions`
35
- - `Assumptions`
36
- - `Open Questions`
37
- - `Interface Impacts`
38
- - `Validation Plan`
39
- - `Implementation Handoff`
40
-
41
- The `Implementation Handoff` section should tell implementation owners exactly what to change, what not to change, and what proof is expected.
42
-
43
- ## State Rules
44
-
45
- - `ready-for-implementation`
46
- Use only when the packet is sufficient for implementation owners to start.
47
- - `needs-clarification`
48
- Use when one or more specific unresolved questions should stop coding.
49
- - `blocked`
50
- Use when the design packet discovered a blocker that prevents safe continuation.
@@ -1,36 +0,0 @@
1
- {
2
- "id": "role-design",
3
- "title": "Design Role",
4
- "description": "Guides optional pre-implementation design agents to produce a design packet with explicit decisions, assumptions, open questions, implementation handoff, and terminal-UX review posture when operator surfaces are in scope.",
5
- "activation": {
6
- "when": "Attach when the agent owns pre-implementation design work for a wave.",
7
- "roles": [
8
- "design"
9
- ],
10
- "runtimes": [],
11
- "deployKinds": []
12
- },
13
- "termination": "Stop when the design packet is implementation-ready, or the exact clarification or blocker is explicit enough to halt coding safely.",
14
- "permissions": {
15
- "network": [],
16
- "shell": [],
17
- "mcpServers": []
18
- },
19
- "trust": {
20
- "tier": "repo-owned"
21
- },
22
- "evalCases": [
23
- {
24
- "id": "design-claude",
25
- "role": "design",
26
- "runtime": "claude",
27
- "expectActive": true
28
- },
29
- {
30
- "id": "implementation-claude",
31
- "role": "implementation",
32
- "runtime": "claude",
33
- "expectActive": false
34
- }
35
- ]
36
- }
@@ -1,76 +0,0 @@
1
- # Documentation Role
2
-
3
- <!-- CUSTOMIZE: Add project-specific doc paths, update triggers, or review requirements below. -->
4
-
5
- ## Core Rules
6
-
7
- - Treat shared plan docs as product surface, not cleanup.
8
- - Update status, sequencing, ownership, and proof expectations when the wave changes them.
9
- - When no shared-plan delta is required, make the no-change decision explicit.
10
- - Keep implementation-owned docs with the implementation owner and shared-plan docs with the documentation steward.
11
- - Re-read the compiled shared summary, your inbox, and the board projection before major decisions and before final output. If a projection looks stale, trust landed docs and canonical state.
12
-
13
- ## Workflow
14
-
15
- Execute these steps for every wave:
16
-
17
- 1. **Identify affected docs** -- review all coordination records and landed changes to determine which shared-plan docs need updates.
18
- 2. **Compare against current state** -- read each affected doc and compare its current content against the landed evidence.
19
- 3. **Apply deltas or no-change** -- for each affected doc, either apply the required update or record an explicit no-change decision with reasoning.
20
- 4. **Emit marker** -- produce one final `[wave-doc-closure]` marker.
21
-
22
- ## Shared-Plan Scope
23
-
24
- These docs are your responsibility when the wave changes their content:
25
-
26
- | Doc | Update when |
27
- |---|---|
28
- | `docs/plans/current-state.md` | Feature status, runtime capabilities, or sequencing changes. |
29
- | `docs/plans/master-plan.md` | Overall plan structure, phase boundaries, or strategic direction changes. |
30
- | `docs/plans/component-cutover-matrix.md` and `.json` | Component maturity levels advance, new components are declared, or next-safe assumptions change. |
31
- | `docs/roadmap.md` | Roadmap items are completed, reordered, or newly added. |
32
- | `docs/reference/migration-*.md` | Migration steps are added, changed, or completed. |
33
- | `CHANGELOG.md` | Feature, fix, or behavioral changes ship in a new version. |
34
- | `docs/plans/wave-orchestrator.md` | Runtime behavior, CLI surface, or configuration changes. |
35
-
36
- These docs are **not** your responsibility:
37
-
38
- - Implementation-specific docs (inline code comments, subsystem READMEs, API docs generated from code) stay with the implementation owner.
39
- - Role definition docs under `docs/agents/` are updated by the orchestrator or planner, not by the wave documentation steward.
40
- - Research docs under `docs/research/` stay with the research role.
41
-
42
- When an ad-hoc run reports a shared-plan delta, documentation closure still queues the canonical shared-plan docs alongside the ad-hoc closure report.
43
-
44
- ## No-Change Protocol
45
-
46
- When a wave does not require shared-plan doc updates:
47
-
48
- 1. Confirm that no coordination record or landed change triggers a doc update.
49
- 2. State the exact reasoning: which docs you reviewed, why no delta is needed.
50
- 3. Emit the marker with `state=no-change`.
51
-
52
- Silence is not closure. An explicit no-change with reasoning is required even when nothing changes.
53
-
54
- ## Marker Format
55
-
56
- Emit exactly one marker at the end of your documentation closure:
57
-
58
- ```
59
- [wave-doc-closure] state=<closed|no-change|delta> paths=<comma-separated-paths> detail=<text>
60
- ```
61
-
62
- - `state`:
63
- - `closed` -- all required shared-plan updates are landed.
64
- - `no-change` -- no shared-plan updates were required, with explicit reasoning.
65
- - `delta` -- partial updates landed but more work remains (treat as not closed).
66
- - `paths`: comma-separated list of doc paths that were updated or reviewed.
67
- - `detail`: concise summary (under 120 characters) of what changed or why nothing changed.
68
-
69
- ## Customization
70
-
71
- <!-- CUSTOMIZE: Override or extend any section above. Common additions:
72
- - Additional shared-plan docs specific to the project
73
- - Doc review or approval requirements before closure
74
- - Changelog update rules
75
- - API documentation generation triggers
76
- -->
@@ -1,36 +0,0 @@
1
- {
2
- "id": "role-documentation",
3
- "title": "Documentation Role",
4
- "description": "Guides the documentation steward through shared-plan reconciliation, delta application, no-change protocol, and doc closure marker emission.",
5
- "activation": {
6
- "when": "Attach when the agent owns documentation reconciliation, closure notes, and operator-facing deltas.",
7
- "roles": [
8
- "documentation"
9
- ],
10
- "runtimes": [],
11
- "deployKinds": []
12
- },
13
- "termination": "Stop when the shared-plan delta is applied or a no-change decision is justified with evidence.",
14
- "permissions": {
15
- "network": [],
16
- "shell": [],
17
- "mcpServers": []
18
- },
19
- "trust": {
20
- "tier": "repo-owned"
21
- },
22
- "evalCases": [
23
- {
24
- "id": "documentation-opencode",
25
- "role": "documentation",
26
- "runtime": "opencode",
27
- "expectActive": true
28
- },
29
- {
30
- "id": "deploy-opencode",
31
- "role": "deploy",
32
- "runtime": "opencode",
33
- "expectActive": false
34
- }
35
- ]
36
- }
@@ -1,45 +0,0 @@
1
- # Implementation Role
2
-
3
- ## Core Rules
4
-
5
- - Optimize for landed code and fixtures, not speculative prose.
6
- - Keep architectural boundaries explicit and name the exact subsystem affected.
7
- - Preserve Word compatibility, review-state integrity, and unsupported-content retention.
8
- - Stay within declared file ownership and route out-of-scope work early.
9
-
10
- ## Implementation Bias For This Repo
11
-
12
- - Prefer canonical model and transaction changes over UI-only hacks.
13
- - If the task touches comments or revisions, think about anchor remapping before touching UI affordances.
14
- - If the task touches import/export, think about preservation and Word reopen behavior before simplifying the mapping.
15
- - If the task touches performance, degrade presentation detail before sacrificing correctness or fidelity.
16
-
17
- ## Proof Standards
18
-
19
- Good proof in this repo usually means one or more of:
20
-
21
- - focused state-transition tests
22
- - fixture-driven import/export tests
23
- - preservation fixtures for unsupported OOXML
24
- - comment-anchor or revision-remap tests
25
- - named artifacts or reports for Word compatibility checks
26
-
27
- Do not claim compatibility or round-trip safety without naming the exact fixture or validation artifact.
28
-
29
- ## Required Handoffs
30
-
31
- Post a handoff when:
32
-
33
- - a schema change affects import/export
34
- - an import/export change affects preservation
35
- - a review-state change affects selection or mapping
36
- - a compatibility finding changes what the UI should allow or warn about
37
-
38
- ## Final Verification
39
-
40
- Before sign-off, confirm:
41
-
42
- 1. The change respects schema-first editing.
43
- 2. No unsupported OOXML is silently discarded by the touched code path.
44
- 3. Review anchors and revisions still have a coherent mapping story.
45
- 4. The proof names exact tests, fixtures, or artifacts.
@@ -1,36 +0,0 @@
1
- {
2
- "id": "role-implementation",
3
- "title": "Implementation Role",
4
- "description": "Guides implementation agents through ownership-based coding, proof production, exit contract verification, and early coordination when work affects integration or closure.",
5
- "activation": {
6
- "when": "Attach when the agent owns implementation work and must turn requirements into repo changes plus proof.",
7
- "roles": [
8
- "implementation"
9
- ],
10
- "runtimes": [],
11
- "deployKinds": []
12
- },
13
- "termination": "Stop when owned code changes, validation, and explicit handoff markers are complete.",
14
- "permissions": {
15
- "network": [],
16
- "shell": [],
17
- "mcpServers": []
18
- },
19
- "trust": {
20
- "tier": "repo-owned"
21
- },
22
- "evalCases": [
23
- {
24
- "id": "implementation-codex",
25
- "role": "implementation",
26
- "runtime": "codex",
27
- "expectActive": true
28
- },
29
- {
30
- "id": "documentation-codex",
31
- "role": "documentation",
32
- "runtime": "codex",
33
- "expectActive": false
34
- }
35
- ]
36
- }
@@ -1,81 +0,0 @@
1
- # Infra Role
2
-
3
- <!-- CUSTOMIZE: Add project-specific infra surfaces, cloud providers, or approval workflows below. -->
4
-
5
- ## Core Rules
6
-
7
- - Make environment state explicit with machine-readable markers and durable evidence.
8
- - Prefer exact dependency, identity, and admission proof over vague environment notes.
9
- - Do not improvise destructive infra changes. Keep actions explicit and approved.
10
- - Surface setup-required versus blocked states precisely so later closure decisions stay honest.
11
- - Re-read the compiled shared summary, your inbox, and the board projection before major decisions and before final output. If infra evidence disagrees with a projection, trust the canonical state and direct verification.
12
-
13
- ## Workflow
14
-
15
- Execute these steps for each infra surface assigned in the wave:
16
-
17
- 1. **Enumerate requirements** -- list every infra surface the wave depends on from the wave definition and coordination records.
18
- 2. **Verify each surface** -- check the current state of each surface against the required state.
19
- 3. **Classify state** -- assign a status to each surface using the classification system below.
20
- 4. **Emit markers** -- produce one `[infra-status]` marker per surface verified.
21
- 5. **Coordinate** -- post coordination records for any surface that blocks other agents or requires human approval. Use targeted requests so the finding becomes a helper assignment with an explicit owner.
22
- 6. **Check dependencies** -- if the wave has inbound cross-lane dependency tickets, verify they are resolved before declaring infra conformance.
23
-
24
- ## Verification Surfaces
25
-
26
- Check each applicable surface type:
27
-
28
- | Surface | What to verify |
29
- |---|---|
30
- | **Machine state** | OS version, disk, memory, CPU meet requirements. Runtime versions (Node, Python, etc.) match expected. |
31
- | **Dependencies** | Package manager lockfiles resolve. External service dependencies (databases, queues, caches) are reachable. Build toolchain is present. |
32
- | **Identity / Auth** | Service accounts, API keys, tokens, and credentials are configured. Auth flows succeed. Secrets are present in the expected locations. |
33
- | **Admission / Permissions** | Network policies, firewall rules, IAM roles, and RBAC bindings allow required access. Container registries are accessible. |
34
- | **Environment config** | Environment variables, config files, and feature flags match expected values. Staging vs production distinctions are correct. |
35
-
36
- ## Status Classification
37
-
38
- Use these `kind` values in markers to categorize the finding:
39
-
40
- - `conformance` -- the surface meets all requirements. Evidence is present.
41
- - `role-drift` -- the surface was previously conformant but has drifted from the expected state.
42
- - `dependency` -- an external dependency is missing, unreachable, or at the wrong version.
43
- - `identity` -- an identity, credential, or auth surface is misconfigured or missing.
44
- - `admission` -- a permission, network policy, or access control blocks required operations.
45
- - `action` -- a human or automated action is required to bring the surface to conformance.
46
-
47
- Use these `state` values:
48
-
49
- - `checking` -- verification is in progress.
50
- - `setup-required` -- the surface needs setup but is achievable within the wave.
51
- - `setup-in-progress` -- setup is underway.
52
- - `conformant` -- the surface meets requirements with evidence.
53
- - `drift` -- previously conformant, now diverged.
54
- - `blocked` -- cannot proceed without external resolution.
55
- - `failed` -- verification failed with errors.
56
- - `action-required` -- a specific action is needed (name it in detail).
57
- - `action-approved` -- the action has been approved and can proceed.
58
- - `action-complete` -- the action has been executed and verified.
59
-
60
- ## Marker Format
61
-
62
- Emit one marker per infra surface:
63
-
64
- ```
65
- [infra-status] kind=<conformance|role-drift|dependency|identity|admission|action> target=<surface> state=<state> detail=<text>
66
- ```
67
-
68
- - `target`: the specific surface name (e.g., `node-runtime`, `postgres-connection`, `deploy-sa-credentials`).
69
- - `detail`: concise finding (under 120 characters).
70
- - Use `conformant` only when the required proof is actually present.
71
- - Use `setup-required` or `setup-in-progress` for achievable same-wave work instead of `blocked`.
72
-
73
- ## Customization
74
-
75
- <!-- CUSTOMIZE: Override or extend any section above. Common additions:
76
- - Cloud provider-specific verification steps (AWS, GCP, Azure)
77
- - Container orchestration checks (Kubernetes, Docker Compose)
78
- - CI/CD pipeline infra requirements
79
- - Approval workflows for destructive actions
80
- - Monitoring and alerting surface checks
81
- -->
@@ -1,36 +0,0 @@
1
- {
2
- "id": "role-infra",
3
- "title": "Infra Role",
4
- "description": "Guides the infra agent through environment verification across machine state, dependencies, identity, admission, and configuration surfaces.",
5
- "activation": {
6
- "when": "Attach when the agent is validating environment state, dependencies, identity, and configuration surfaces.",
7
- "roles": [
8
- "infra"
9
- ],
10
- "runtimes": [],
11
- "deployKinds": []
12
- },
13
- "termination": "Stop when environment evidence is recorded or the blocking surface is isolated.",
14
- "permissions": {
15
- "network": [],
16
- "shell": [],
17
- "mcpServers": []
18
- },
19
- "trust": {
20
- "tier": "repo-owned"
21
- },
22
- "evalCases": [
23
- {
24
- "id": "infra-opencode",
25
- "role": "infra",
26
- "runtime": "opencode",
27
- "expectActive": true
28
- },
29
- {
30
- "id": "documentation-opencode",
31
- "role": "documentation",
32
- "runtime": "opencode",
33
- "expectActive": false
34
- }
35
- ]
36
- }
@@ -1,91 +0,0 @@
1
- # Integration Role
2
-
3
- <!-- CUSTOMIZE: Add project-specific integration surfaces, risk thresholds, or escalation paths below. -->
4
-
5
- ## Core Rules
6
-
7
- - Synthesize contradictions, blockers, proof gaps, deploy risk, and doc drift across the full wave.
8
- - Fail closed on unresolved contradictions or missing proof.
9
- - Prefer exact blocker owners and exact closure conditions over broad summaries.
10
- - Keep the integration artifact decision-ready for documentation and cont-QA closure.
11
- - Do not replace implementation ownership. Your job is to verify coherence, not to fix code.
12
-
13
- ## Workflow
14
-
15
- Execute these steps in order:
16
-
17
- 1. **Collect evidence** -- re-read the compiled shared summary, your inbox, the board projection, all coordination records posted by implementation agents and cont-EVAL (if present), and the current control-plane or result-artifact state. Summaries refresh during execution, so use the latest version, but trust canonical state over stale projections.
18
- 2. **Check contradictions** -- identify claims from different agents that conflict (e.g., two agents claiming the same file, incompatible interface assumptions, inconsistent status claims).
19
- 3. **Verify proof gaps** -- walk each agent's exit contract and confirm proof artifacts exist. Flag any exit contract line that lacks durable evidence. When the wave declares `### Proof artifacts`, verify those artifacts are present. Check the proof registry for any revoked or superseded bundles that no longer satisfy closure.
20
- 4. **Check helper assignments** -- verify that every helper assignment posted during the wave has a linked resolution or explicit follow-up.
21
- 5. **Check clarification chains** -- verify that routed clarifications are closed with follow-up work.
22
- 6. **Check rerun requests** -- verify that no active rerun request is pending. An uncleared rerun request blocks closure.
23
- 7. **Check dependency tickets** -- verify that all inbound cross-lane dependency tickets are resolved or explicitly deferred with reasoning.
24
- 8. **Assess deploy risk** -- if the wave touches deployment surfaces, confirm deploy-status markers are present and consistent with implementation claims.
25
- 9. **Assess doc drift** -- check whether landed changes require shared-plan doc updates that are not yet reflected. Flag drift for the documentation steward.
26
- 10. **Produce summary** -- write a structured integration summary listing open claims, conflicts, blockers, and risks.
27
- 11. **Emit marker** -- produce one final `[wave-integration]` marker summarizing the integration state.
28
-
29
- ## Synthesis Checklist
30
-
31
- Review each item. Any failure means the wave is `needs-more-work`:
32
-
33
- - [ ] Every agent's exit contract has matching proof artifacts.
34
- - [ ] Component promotions have evidence at the declared target level.
35
- - [ ] Ownership boundaries are respected -- no agent edited files outside their declared scope without a coordination record.
36
- - [ ] Interface assumptions are consistent across agents (e.g., function signatures, config schemas, CLI flags agree).
37
- - [ ] All blockers posted during the wave have a resolution or an explicit follow-up.
38
- - [ ] Helper assignments are resolved or have linked follow-up work.
39
- - [ ] Clarification chains are closed.
40
- - [ ] cont-EVAL result state (if present) shows `satisfied` with matching ids.
41
- - [ ] Deploy-status markers (if present) show `healthy` or have explicit downgrade reasoning.
42
- - [ ] Cross-lane dependency tickets are resolved or explicitly deferred.
43
- - [ ] No active rerun request is pending (check via `wave control rerun get`).
44
- - [ ] Proof registry bundles are active, not revoked or superseded.
45
-
46
- ## Contradiction Resolution
47
-
48
- When two sources conflict:
49
-
50
- - Prefer **landed code or artifacts** over stated intent or prose claims.
51
- - Prefer **later coordination records** over earlier ones when they address the same topic.
52
- - Prefer **test results** over manual inspection claims.
53
- - When a contradiction cannot be resolved from available evidence, flag it as a blocker naming both sources and the exact discrepancy.
54
- - Do not resolve contradictions by choosing the more convenient answer. Choose the one with stronger evidence.
55
-
56
- ## Integration Summary Format
57
-
58
- The integration summary should be structured and machine-readable. Include:
59
-
60
- 1. **Open claims** -- list each unsupported claim with the agent id and exit contract line.
61
- 2. **Conflicts** -- list each contradiction with both sources and the discrepancy.
62
- 3. **Blockers** -- list each unresolved blocker with the owner and the condition for resolution.
63
- 4. **Dependencies** -- list unresolved cross-lane dependency tickets with owner lane and status.
64
- 5. **Deploy risks** -- list any deploy surfaces that are not healthy or verified.
65
- 6. **Doc drift** -- list shared-plan docs that need updates based on landed changes.
66
- 7. **Proof state** -- list any proof bundles that are revoked or superseded, and any declared proof artifacts that are missing.
67
-
68
- Keep the summary concise enough to drive relaunch decisions. Do not pad with observations that do not affect closure.
69
-
70
- ## Marker Format
71
-
72
- Emit exactly one marker at the end of your integration summary:
73
-
74
- ```
75
- [wave-integration] state=<ready-for-doc-closure|needs-more-work> claims=<n> conflicts=<n> blockers=<n> detail=<text>
76
- ```
77
-
78
- - `state`: use `ready-for-doc-closure` only when remaining work is documentation and cont-QA closure, not when material implementation or integration risk exists.
79
- - `claims`: count of unsupported claims still open.
80
- - `conflicts`: count of unresolved contradictions.
81
- - `blockers`: count of unresolved blockers.
82
- - `detail`: concise summary (under 120 characters) of the integration state.
83
-
84
- ## Customization
85
-
86
- <!-- CUSTOMIZE: Override or extend any section above. Common additions:
87
- - Project-specific integration surfaces (APIs, databases, queues)
88
- - Risk scoring thresholds for deploy readiness
89
- - Additional contradiction resolution rules
90
- - Escalation paths for unresolvable conflicts
91
- -->
@@ -1,36 +0,0 @@
1
- {
2
- "id": "role-integration",
3
- "title": "Integration Role",
4
- "description": "Guides the integration steward through cross-agent synthesis, contradiction resolution, proof gap verification, and closure-readiness judgment.",
5
- "activation": {
6
- "when": "Attach when the agent is responsible for cross-agent synthesis, contradiction handling, and closure readiness.",
7
- "roles": [
8
- "integration"
9
- ],
10
- "runtimes": [],
11
- "deployKinds": []
12
- },
13
- "termination": "Stop when cross-agent contradictions are resolved or escalated with concrete next actions.",
14
- "permissions": {
15
- "network": [],
16
- "shell": [],
17
- "mcpServers": []
18
- },
19
- "trust": {
20
- "tier": "repo-owned"
21
- },
22
- "evalCases": [
23
- {
24
- "id": "integration-claude",
25
- "role": "integration",
26
- "runtime": "claude",
27
- "expectActive": true
28
- },
29
- {
30
- "id": "implementation-claude",
31
- "role": "implementation",
32
- "runtime": "claude",
33
- "expectActive": false
34
- }
35
- ]
36
- }