@chllming/wave-orchestration 0.5.2 → 0.5.4

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 (79) hide show
  1. package/CHANGELOG.md +15 -0
  2. package/README.md +56 -501
  3. package/docs/README.md +39 -0
  4. package/docs/concepts/context7-vs-skills.md +94 -0
  5. package/docs/concepts/operating-modes.md +91 -0
  6. package/docs/concepts/runtime-agnostic-orchestration.md +95 -0
  7. package/docs/concepts/what-is-a-wave.md +133 -0
  8. package/docs/guides/planner.md +113 -0
  9. package/docs/guides/terminal-surfaces.md +80 -0
  10. package/docs/image.png +0 -0
  11. package/docs/plans/context7-wave-orchestrator.md +2 -0
  12. package/docs/plans/current-state.md +10 -0
  13. package/docs/plans/master-plan.md +3 -3
  14. package/docs/plans/migration.md +4 -3
  15. package/docs/plans/wave-orchestrator.md +27 -3
  16. package/docs/reference/runtime-config/README.md +19 -0
  17. package/docs/reference/skills.md +156 -0
  18. package/docs/roadmap.md +160 -564
  19. package/package.json +2 -1
  20. package/releases/manifest.json +32 -0
  21. package/scripts/wave-orchestrator/config.mjs +17 -0
  22. package/scripts/wave-orchestrator/context7.mjs +9 -0
  23. package/scripts/wave-orchestrator/coordination.mjs +16 -0
  24. package/scripts/wave-orchestrator/executors.mjs +24 -11
  25. package/scripts/wave-orchestrator/install.mjs +41 -2
  26. package/scripts/wave-orchestrator/launcher.mjs +131 -25
  27. package/scripts/wave-orchestrator/planner.mjs +1328 -0
  28. package/scripts/wave-orchestrator/project-profile.mjs +190 -0
  29. package/scripts/wave-orchestrator/shared.mjs +2 -0
  30. package/scripts/wave-orchestrator/skills.mjs +448 -0
  31. package/scripts/wave-orchestrator/terminals.mjs +16 -0
  32. package/scripts/wave-orchestrator/traces.mjs +23 -0
  33. package/scripts/wave-orchestrator/wave-files.mjs +299 -84
  34. package/scripts/wave.mjs +11 -0
  35. package/skills/provider-aws/SKILL.md +6 -0
  36. package/skills/provider-aws/skill.json +5 -0
  37. package/skills/provider-custom-deploy/SKILL.md +5 -0
  38. package/skills/provider-custom-deploy/skill.json +5 -0
  39. package/skills/provider-docker-compose/SKILL.md +6 -0
  40. package/skills/provider-docker-compose/skill.json +5 -0
  41. package/skills/provider-github-release/SKILL.md +6 -0
  42. package/skills/provider-github-release/skill.json +5 -0
  43. package/skills/provider-kubernetes/SKILL.md +6 -0
  44. package/skills/provider-kubernetes/skill.json +5 -0
  45. package/skills/provider-railway/SKILL.md +6 -0
  46. package/skills/provider-railway/adapters/claude.md +1 -0
  47. package/skills/provider-railway/adapters/codex.md +1 -0
  48. package/skills/provider-railway/adapters/local.md +1 -0
  49. package/skills/provider-railway/adapters/opencode.md +1 -0
  50. package/skills/provider-railway/skill.json +5 -0
  51. package/skills/provider-ssh-manual/SKILL.md +6 -0
  52. package/skills/provider-ssh-manual/skill.json +5 -0
  53. package/skills/repo-coding-rules/SKILL.md +7 -0
  54. package/skills/repo-coding-rules/skill.json +5 -0
  55. package/skills/role-deploy/SKILL.md +6 -0
  56. package/skills/role-deploy/skill.json +5 -0
  57. package/skills/role-documentation/SKILL.md +6 -0
  58. package/skills/role-documentation/skill.json +5 -0
  59. package/skills/role-evaluator/SKILL.md +6 -0
  60. package/skills/role-evaluator/skill.json +5 -0
  61. package/skills/role-implementation/SKILL.md +6 -0
  62. package/skills/role-implementation/skill.json +5 -0
  63. package/skills/role-infra/SKILL.md +6 -0
  64. package/skills/role-infra/skill.json +5 -0
  65. package/skills/role-integration/SKILL.md +6 -0
  66. package/skills/role-integration/skill.json +5 -0
  67. package/skills/role-research/SKILL.md +6 -0
  68. package/skills/role-research/skill.json +5 -0
  69. package/skills/runtime-claude/SKILL.md +6 -0
  70. package/skills/runtime-claude/skill.json +5 -0
  71. package/skills/runtime-codex/SKILL.md +6 -0
  72. package/skills/runtime-codex/skill.json +5 -0
  73. package/skills/runtime-local/SKILL.md +5 -0
  74. package/skills/runtime-local/skill.json +5 -0
  75. package/skills/runtime-opencode/SKILL.md +6 -0
  76. package/skills/runtime-opencode/skill.json +5 -0
  77. package/skills/wave-core/SKILL.md +7 -0
  78. package/skills/wave-core/skill.json +5 -0
  79. package/wave.config.json +27 -0
@@ -0,0 +1,6 @@
1
+ # Deploy Role
2
+
3
+ - Treat deployment verification as first-class proof, not a postscript to coding.
4
+ - Name the exact service, package, or runtime surface being rolled out.
5
+ - Record health, readiness, failure, and rollback state explicitly.
6
+ - If rollout proof is incomplete, downgrade the wave honestly instead of implying success.
@@ -0,0 +1,5 @@
1
+ {
2
+ "id": "role-deploy",
3
+ "title": "Deploy Role",
4
+ "description": "Deploy-agent norms for rollout readiness, health, and rollback posture."
5
+ }
@@ -0,0 +1,6 @@
1
+ # Documentation Role
2
+
3
+ - Treat shared plan docs as product surface, not cleanup.
4
+ - Update status, sequencing, ownership, and proof expectations when the wave changes them.
5
+ - When no shared-plan delta is required, make the no-change decision explicit.
6
+ - Keep implementation-owned docs with the implementation owner and shared-plan docs with the documentation steward.
@@ -0,0 +1,5 @@
1
+ {
2
+ "id": "role-documentation",
3
+ "title": "Documentation Role",
4
+ "description": "Documentation-steward norms for shared plan reconciliation."
5
+ }
@@ -0,0 +1,6 @@
1
+ # Evaluator Role
2
+
3
+ - Judge the wave on landed evidence, not on effort or intent.
4
+ - Require coherence across implementation, integration, documentation, and runtime proof before PASS.
5
+ - Keep the final verdict and gate markers authoritative and internally consistent.
6
+ - Call out the smallest set of blocking issues that must change before the next wave can proceed safely.
@@ -0,0 +1,5 @@
1
+ {
2
+ "id": "role-evaluator",
3
+ "title": "Evaluator Role",
4
+ "description": "Evaluator norms for final gate judgments."
5
+ }
@@ -0,0 +1,6 @@
1
+ # Implementation Role
2
+
3
+ - Optimize for landed repo changes, not speculative notes.
4
+ - Keep interface changes explicit and name the exact files and fields affected.
5
+ - Leave owned proof in tests, generated artifacts, or durable summaries instead of generic claims.
6
+ - Coordinate early when your work changes the integration or documentation closure picture.
@@ -0,0 +1,5 @@
1
+ {
2
+ "id": "role-implementation",
3
+ "title": "Implementation Role",
4
+ "description": "Implementation-agent norms for landing code and proving owned results."
5
+ }
@@ -0,0 +1,6 @@
1
+ # Infra Role
2
+
3
+ - Make environment state explicit with machine-readable markers and durable evidence.
4
+ - Prefer exact dependency, identity, and admission proof over vague environment notes.
5
+ - Do not improvise destructive infra changes. Keep actions explicit and approved.
6
+ - Surface setup-required versus blocked states precisely so later closure decisions stay honest.
@@ -0,0 +1,5 @@
1
+ {
2
+ "id": "role-infra",
3
+ "title": "Infra Role",
4
+ "description": "Infra-agent norms for environment, dependency, and identity proof."
5
+ }
@@ -0,0 +1,6 @@
1
+ # Integration Role
2
+
3
+ - Synthesize contradictions, blockers, proof gaps, deploy risk, and doc drift across the full wave.
4
+ - Fail closed on unresolved contradictions or missing proof.
5
+ - Prefer exact blocker owners and exact closure conditions over broad summaries.
6
+ - Keep the integration artifact decision-ready for documentation and evaluator closure.
@@ -0,0 +1,5 @@
1
+ {
2
+ "id": "role-integration",
3
+ "title": "Integration Role",
4
+ "description": "Integration-steward norms for reconciling cross-agent state."
5
+ }
@@ -0,0 +1,6 @@
1
+ # Research Role
2
+
3
+ - Stay tightly scoped to the assigned question and record sources precisely.
4
+ - Distinguish repository truth from external references and temporary observations.
5
+ - Convert findings into concrete implications for the wave instead of leaving raw notes only.
6
+ - Escalate uncertainty when it changes implementation, deployment, or closure risk.
@@ -0,0 +1,5 @@
1
+ {
2
+ "id": "role-research",
3
+ "title": "Research Role",
4
+ "description": "Research-agent norms for focused evidence gathering."
5
+ }
@@ -0,0 +1,6 @@
1
+ # Claude Runtime
2
+
3
+ - Treat appended system prompt guidance and the compiled task prompt as one combined contract.
4
+ - Keep the final answer aligned with the exact gate or ownership requirement for the run.
5
+ - Preserve Wave marker syntax exactly when emitting structured status lines.
6
+ - Prefer concise, explicit evidence summaries over long narrative explanations.
@@ -0,0 +1,5 @@
1
+ {
2
+ "id": "runtime-claude",
3
+ "title": "Claude Runtime",
4
+ "description": "Claude-specific execution norms inside the Wave harness."
5
+ }
@@ -0,0 +1,6 @@
1
+ # Codex Runtime
2
+
3
+ - Treat the compiled task prompt as the authoritative assignment.
4
+ - Keep terminal work concise and deterministic where possible.
5
+ - Use repo-local files and generated overlays before broad external lookup.
6
+ - Preserve required structured markers exactly in terminal output.
@@ -0,0 +1,5 @@
1
+ {
2
+ "id": "runtime-codex",
3
+ "title": "Codex Runtime",
4
+ "description": "Codex-specific execution norms inside the Wave harness."
5
+ }
@@ -0,0 +1,5 @@
1
+ # Local Runtime
2
+
3
+ - The local executor is a smoke surface, not a substitute for real external integrations.
4
+ - Focus on prompt shape, file ownership, and artifact expectations.
5
+ - Do not claim live deploy or external-environment proof from local smoke execution alone.
@@ -0,0 +1,5 @@
1
+ {
2
+ "id": "runtime-local",
3
+ "title": "Local Runtime",
4
+ "description": "Local smoke-executor norms."
5
+ }
@@ -0,0 +1,6 @@
1
+ # OpenCode Runtime
2
+
3
+ - Treat injected instructions and the selected agent prompt as authoritative.
4
+ - Keep edits and summaries tightly scoped to the assigned files and closure target.
5
+ - Prefer explicit repo files and generated overlays over ad hoc runtime assumptions.
6
+ - Preserve Wave marker syntax exactly in output and logs.
@@ -0,0 +1,5 @@
1
+ {
2
+ "id": "runtime-opencode",
3
+ "title": "OpenCode Runtime",
4
+ "description": "OpenCode-specific execution norms inside the Wave harness."
5
+ }
@@ -0,0 +1,7 @@
1
+ # Wave Core
2
+
3
+ - Re-read the compiled shared summary, inbox, and board projection before major decisions and before final output.
4
+ - Treat file ownership, exit contracts, and structured markers as hard requirements.
5
+ - Post coordination records for meaningful progress, blockers, decisions, and handoffs.
6
+ - Make gaps explicit with exact files, exact fields, and exact follow-up owners.
7
+ - Do not infer closure from intent alone. Closure requires proof artifacts and consistent shared state.
@@ -0,0 +1,5 @@
1
+ {
2
+ "id": "wave-core",
3
+ "title": "Wave Core",
4
+ "description": "Core Wave execution rules for coordination, ownership, proof, and closure."
5
+ }
package/wave.config.json CHANGED
@@ -71,6 +71,33 @@
71
71
  "format": "default"
72
72
  }
73
73
  },
74
+ "skills": {
75
+ "dir": "skills",
76
+ "base": ["wave-core", "repo-coding-rules"],
77
+ "byRole": {
78
+ "implementation": ["role-implementation"],
79
+ "integration": ["role-integration"],
80
+ "documentation": ["role-documentation"],
81
+ "evaluator": ["role-evaluator"],
82
+ "infra": ["role-infra"],
83
+ "deploy": ["role-deploy"],
84
+ "research": ["role-research"]
85
+ },
86
+ "byRuntime": {
87
+ "codex": ["runtime-codex"],
88
+ "claude": ["runtime-claude"],
89
+ "opencode": ["runtime-opencode"],
90
+ "local": ["runtime-local"]
91
+ },
92
+ "byDeployKind": {
93
+ "railway-cli": ["provider-railway"],
94
+ "railway-mcp": ["provider-railway"],
95
+ "docker-compose": ["provider-docker-compose"],
96
+ "kubernetes": ["provider-kubernetes"],
97
+ "ssh-manual": ["provider-ssh-manual"],
98
+ "custom": ["provider-custom-deploy"]
99
+ }
100
+ },
74
101
  "sharedPlanDocs": [
75
102
  "docs/plans/current-state.md",
76
103
  "docs/plans/master-plan.md",