codex-genesis-harness 0.1.4 → 0.1.6

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 (153) hide show
  1. package/.codebase/ARCHITECTURE_REVIEW_COMPLETE.md +216 -216
  2. package/.codebase/CURRENT_STATE.md +9 -7
  3. package/.codebase/FILE_NAMING_CLARIFICATION.md +161 -161
  4. package/.codebase/HARNESS_COMPLETENESS_AUDIT.md +613 -613
  5. package/.codebase/IMPLEMENTATION_COMPLETE.md +429 -429
  6. package/.codebase/IMPLEMENTATION_HANDOFF.md +351 -351
  7. package/.codebase/IMPROVEMENTS_SUMMARY.md +419 -419
  8. package/.codebase/PHASE3_SKILLS_NAMING_COMPLETE.md +292 -292
  9. package/.codebase/PHASE_DEPENDENCY_MAP.md +486 -486
  10. package/.codebase/QUICK_START_SPEC_IMPACT.md +456 -456
  11. package/.codebase/README.md +139 -139
  12. package/.codebase/RECOVERY_POINTS.md +438 -438
  13. package/.codebase/state.json +37 -0
  14. package/.codex/skills/genesis-api-sync/SKILL.md +354 -354
  15. package/.codex/skills/genesis-api-sync/checklists/api-sync-checklist.md +101 -101
  16. package/.codex/skills/genesis-api-sync/templates/api-change-template.md +257 -257
  17. package/.codex/skills/genesis-debug-guide/SKILL.md +479 -479
  18. package/.codex/skills/genesis-debug-guide/checklists/flaky-test-investigation.md +339 -339
  19. package/.codex/skills/genesis-debug-guide/checklists/production-bug-debug.md +210 -210
  20. package/.codex/skills/genesis-debug-guide/checklists/test-failure-debug.md +158 -158
  21. package/.codex/skills/genesis-debug-guide/observability/debug-commands.md +365 -365
  22. package/.codex/skills/genesis-debug-guide/playbooks/unit-test-failures.md +289 -289
  23. package/.codex/skills/genesis-debug-guide/templates/debug-investigation-log.md +288 -288
  24. package/.codex/skills/genesis-docs-automation/SKILL.md +1003 -1003
  25. package/.codex/skills/genesis-docs-automation/checklists/docs-validation.md +359 -359
  26. package/.codex/skills/genesis-docs-automation/checklists/spec-alignment.md +312 -312
  27. package/.codex/skills/genesis-docs-automation/observability/docs-tracking.md +382 -382
  28. package/.codex/skills/genesis-docs-automation/playbooks/auto-update-flow.md +851 -851
  29. package/.codex/skills/genesis-docs-automation/playbooks/changelog-generation.md +491 -491
  30. package/.codex/skills/genesis-docs-automation/templates/changelog-entry-template.md +187 -187
  31. package/.codex/skills/genesis-docs-automation/templates/handoff-template.md +297 -297
  32. package/.codex/skills/genesis-harness/SKILL.md +1427 -1418
  33. package/.codex/skills/genesis-harness/agents/openai.yaml +7 -7
  34. package/.codex/skills/genesis-harness/checklists/bug-fix-qa.md +169 -169
  35. package/.codex/skills/genesis-harness/checklists/new-feature-qa.md +157 -157
  36. package/.codex/skills/genesis-harness/checklists/refactor-qa.md +216 -216
  37. package/.codex/skills/genesis-harness/checklists/requirements-validation.md +211 -211
  38. package/.codex/skills/genesis-harness/references/planning-schema.md +35 -35
  39. package/.codex/skills/genesis-harness/references/quality-rubric.md +21 -21
  40. package/.codex/skills/genesis-harness/references/research-rubric.md +41 -41
  41. package/.codex/skills/genesis-harness/references/workflows.md +33 -33
  42. package/.codex/skills/genesis-harness/resources/agents-template.md +27 -27
  43. package/.codex/skills/genesis-harness/resources/api-docs-template.md +32 -32
  44. package/.codex/skills/genesis-harness/resources/architecture-template.md +30 -30
  45. package/.codex/skills/genesis-harness/resources/audit-template.md +26 -26
  46. package/.codex/skills/genesis-harness/resources/bug-template.md +34 -34
  47. package/.codex/skills/genesis-harness/resources/change-impact-matrix-template.md +204 -204
  48. package/.codex/skills/genesis-harness/resources/check-template.md +21 -21
  49. package/.codex/skills/genesis-harness/resources/conventions-template.md +42 -42
  50. package/.codex/skills/genesis-harness/resources/decision-template.md +33 -33
  51. package/.codex/skills/genesis-harness/resources/design-template.md +26 -26
  52. package/.codex/skills/genesis-harness/resources/escalation-template.md +21 -21
  53. package/.codex/skills/genesis-harness/resources/feature-template.md +49 -49
  54. package/.codex/skills/genesis-harness/resources/foundation-phase-template.md +131 -131
  55. package/.codex/skills/genesis-harness/resources/integrations-template.md +32 -32
  56. package/.codex/skills/genesis-harness/resources/journeys-template.md +13 -13
  57. package/.codex/skills/genesis-harness/resources/lessons-learned-template.md +12 -12
  58. package/.codex/skills/genesis-harness/resources/observability-template.md +34 -34
  59. package/.codex/skills/genesis-harness/resources/phase-00-foundation-template.md +76 -76
  60. package/.codex/skills/genesis-harness/resources/phase-template.md +34 -34
  61. package/.codex/skills/genesis-harness/resources/pitfalls-template.md +22 -22
  62. package/.codex/skills/genesis-harness/resources/planning-tree-template.md +39 -39
  63. package/.codex/skills/genesis-harness/resources/post-implementation-guide.md +347 -347
  64. package/.codex/skills/genesis-harness/resources/project-template.md +38 -38
  65. package/.codex/skills/genesis-harness/resources/quality-score-template.md +11 -11
  66. package/.codex/skills/genesis-harness/resources/requirements-template.md +26 -26
  67. package/.codex/skills/genesis-harness/resources/research-template.md +26 -26
  68. package/.codex/skills/genesis-harness/resources/review-template.md +22 -22
  69. package/.codex/skills/genesis-harness/resources/spec-changelog-template.md +6 -6
  70. package/.codex/skills/genesis-harness/resources/stack-template.md +33 -33
  71. package/.codex/skills/genesis-harness/resources/verification-template.md +26 -26
  72. package/.codex/skills/genesis-harness/scripts/check-architecture-boundaries.sh +0 -0
  73. package/.codex/skills/genesis-harness/scripts/check-docs-sync.sh +0 -0
  74. package/.codex/skills/genesis-harness/scripts/check-no-debug-logs.sh +0 -0
  75. package/.codex/skills/genesis-harness/scripts/check-required-planning-files.sh +0 -0
  76. package/.codex/skills/genesis-harness/scripts/check-spec-changelog.sh +0 -0
  77. package/.codex/skills/genesis-harness/scripts/check-task-tracking.sh +0 -0
  78. package/.codex/skills/genesis-harness/scripts/compact-context.sh +0 -0
  79. package/.codex/skills/genesis-harness/scripts/create-adr.sh +0 -0
  80. package/.codex/skills/genesis-harness/scripts/create-bug.sh +0 -0
  81. package/.codex/skills/genesis-harness/scripts/create-feature.sh +0 -0
  82. package/.codex/skills/genesis-harness/scripts/detect-stack.sh +0 -0
  83. package/.codex/skills/genesis-harness/scripts/init-planning.sh +0 -0
  84. package/.codex/skills/genesis-harness/scripts/list-changed-files.sh +0 -0
  85. package/.codex/skills/genesis-harness/scripts/offload-log.sh +0 -0
  86. package/.codex/skills/genesis-harness/scripts/run-verification.sh +0 -0
  87. package/.codex/skills/genesis-harness/scripts/run-verify-loop.sh +0 -0
  88. package/.codex/skills/genesis-harness/scripts/update-state.sh +0 -0
  89. package/.codex/skills/genesis-mvp-planning/SKILL.md +114 -0
  90. package/.codex/skills/genesis-mvp-planning/agents/openai.yaml +6 -0
  91. package/.codex/skills/genesis-mvp-planning/checklists/mvp-readiness.md +18 -0
  92. package/.codex/skills/genesis-mvp-planning/examples/5-phase-roadmap-example.md +43 -0
  93. package/.codex/skills/genesis-mvp-planning/templates/phase-1-core.md +17 -0
  94. package/.codex/skills/genesis-mvp-planning/templates/phase-2-auth.md +17 -0
  95. package/.codex/skills/genesis-mvp-planning/templates/phase-3-features.md +17 -0
  96. package/.codex/skills/genesis-mvp-planning/templates/phase-4-integrations.md +17 -0
  97. package/.codex/skills/genesis-mvp-planning/templates/phase-5-readiness.md +17 -0
  98. package/.codex/skills/genesis-new-design/agents/openai.yaml +3 -3
  99. package/.codex/skills/genesis-observability-automation/checklists/.gitkeep +0 -0
  100. package/.codex/skills/genesis-observability-automation/observability/.gitkeep +0 -0
  101. package/.codex/skills/genesis-observability-automation/playbooks/.gitkeep +0 -0
  102. package/.codex/skills/genesis-observability-automation/templates/.gitkeep +0 -0
  103. package/.codex/skills/genesis-release-orchestration/SKILL.md +653 -653
  104. package/.codex/skills/genesis-release-orchestration/checklists/post-deployment-verification.md +274 -274
  105. package/.codex/skills/genesis-release-orchestration/checklists/pre-release-validation.md +220 -220
  106. package/.codex/skills/genesis-release-orchestration/observability/release-tracking.md +253 -253
  107. package/.codex/skills/genesis-release-orchestration/playbooks/canary-deployment-orchestration.md +472 -472
  108. package/.codex/skills/genesis-release-orchestration/playbooks/semantic-versioning-automation.md +494 -494
  109. package/.codex/skills/genesis-release-orchestration/templates/deployment-strategy-template.md +303 -303
  110. package/.codex/skills/genesis-release-orchestration/templates/release-runbook-template.md +420 -420
  111. package/.codex/skills/genesis-research-first/SKILL.md +237 -237
  112. package/.codex/skills/genesis-research-first/templates/.gitkeep +0 -0
  113. package/.codex/skills/genesis-spec-propagation/SKILL.md +534 -534
  114. package/.codex/skills/genesis-spec-propagation/checklists/phase-update-verification.md +384 -384
  115. package/.codex/skills/genesis-spec-propagation/checklists/spec-change-detection.md +257 -257
  116. package/.codex/skills/genesis-spec-propagation/observability/propagation-tracking.md +373 -373
  117. package/.codex/skills/genesis-spec-propagation/playbooks/breaking-change-propagation.md +692 -692
  118. package/.codex/skills/genesis-spec-propagation/playbooks/feature-change-propagation.md +434 -434
  119. package/.codex/skills/genesis-spec-propagation/templates/migration-guide-template.md +407 -407
  120. package/.codex/skills/genesis-state-machine/SKILL.md +34 -0
  121. package/.codex/skills/genesis-upgrade-design/agents/openai.yaml +3 -3
  122. package/.codex/skills/spec-impact-engine/SKILL.md +504 -504
  123. package/.codex/skills/spec-impact-engine/detect-spec-changes.sh +0 -0
  124. package/.codex-plugin/plugin.json +24 -24
  125. package/CHANGELOG.md +42 -0
  126. package/LICENSE +22 -22
  127. package/README.EN.md +784 -719
  128. package/README.VI.md +776 -712
  129. package/README.md +113 -253
  130. package/VERSION +2 -2
  131. package/bin/genesis-harness.js +90 -87
  132. package/package.json +68 -43
  133. package/scripts/README.md +342 -342
  134. package/scripts/compact-context.sh +0 -0
  135. package/scripts/contract_integrity_gate.js +83 -0
  136. package/scripts/detect-changes.sh +0 -0
  137. package/scripts/healing_telemetry.js +118 -0
  138. package/scripts/install.sh +4 -1
  139. package/scripts/offload-log.sh +0 -0
  140. package/scripts/prompt_sentinel.js +84 -0
  141. package/scripts/run-evals.sh +1 -0
  142. package/scripts/run-verify-loop.sh +11 -0
  143. package/scripts/spec_visual_sync.js +157 -0
  144. package/scripts/test_generator.js +142 -0
  145. package/scripts/transition_state.sh +67 -0
  146. package/scripts/uninstall.sh +1 -0
  147. package/scripts/validation_gates.sh +85 -0
  148. package/scripts/verify.sh +5 -0
  149. package/tests/unit/contract_integrity_gate.test.js +74 -0
  150. package/tests/unit/healing_telemetry.test.js +58 -0
  151. package/tests/unit/prompt_sentinel.test.js +50 -0
  152. package/tests/unit/spec_visual_sync.test.js +77 -0
  153. package/tests/unit/test_generator.test.js +62 -0
@@ -1,76 +1,76 @@
1
- # Phase 0: Foundation
2
-
3
- ## Goal
4
-
5
- Complete project documentation, validate product intent, and establish the planning framework. **No feature implementation in this phase.**
6
-
7
- ## Scope
8
-
9
- Documentation only:
10
- - [ ] Confirm PROJECT.md details
11
- - [ ] Complete REQUIREMENTS.md
12
- - [ ] Document ARCHITECTURE.md
13
- - [ ] Document STACK.md
14
- - [ ] Define CONVENTIONS.md
15
- - [ ] Create base diagrams
16
- - [ ] Establish baseline quality score
17
-
18
- ## Dependencies
19
-
20
- None. This is the foundation.
21
-
22
- ## Tasks
23
-
24
- - [ ] Read `.planning/PROJECT.md` - confirm product intent
25
- - [ ] Read `.planning/REQUIREMENTS.md` - validate requirements
26
- - [ ] Complete STACK.md with all tech details and versions
27
- - [ ] Document ARCHITECTURE.md from codebase analysis
28
- - [ ] Extract CONVENTIONS.md from existing code patterns
29
- - [ ] Identify and document PITFALLS.md
30
- - [ ] Create system-context.mmd diagram
31
- - [ ] Create container-architecture.mmd diagram
32
- - [ ] Create database-erd.mmd (if applicable)
33
- - [ ] Create deployment-flow.mmd diagram
34
- - [ ] Create initial QUALITY_SCORE.md
35
- - [ ] Verify all `.planning/` structure exists
36
- - [ ] Run project verification (tests, builds, etc.)
37
- - [ ] Document decision: "Phase 0 complete, ready for Phase 1 planning"
38
-
39
- ## Acceptance Criteria
40
-
41
- - [x] `.planning/` directory structure created
42
- - [ ] PROJECT.md completed with product details
43
- - [ ] REQUIREMENTS.md documented
44
- - [ ] STACK.md has all tech versions
45
- - [ ] ARCHITECTURE.md describes system boundaries
46
- - [ ] Diagrams are created
47
- - [ ] No critical TBDs remain in core docs
48
- - [ ] Team confirms understanding of project scope
49
- - [ ] All verification checks pass
50
-
51
- ## Verification
52
-
53
- ```sh
54
- # Verify structure
55
- test -d .planning/phases/00-foundation && echo "✓ Phase folder exists"
56
-
57
- # Check core docs are not just TBD
58
- for file in PROJECT REQUIREMENTS STACK ARCHITECTURE CONVENTIONS; do
59
- if grep -q "^## " .planning/$file.md && ! grep -q "TBD$" .planning/$file.md; then
60
- echo "✓ .planning/$file.md has content"
61
- fi
62
- done
63
-
64
- # List all diagrams
65
- ls -la .planning/diagrams/*.mmd | wc -l
66
- ```
67
-
68
- ## Risk & Rollback
69
-
70
- **Risk**: Documentation may be incomplete or inaccurate.
71
-
72
- **Rollback**: This is a documentation phase. If docs need revision, simply edit the `.planning/*.md` files directly. No code changes to rollback.
73
-
74
- ## Notes
75
-
76
- This phase is setup only. Feature phases start in Phase 1 after Foundation is complete and requirements are confirmed.
1
+ # Phase 0: Foundation
2
+
3
+ ## Goal
4
+
5
+ Complete project documentation, validate product intent, and establish the planning framework. **No feature implementation in this phase.**
6
+
7
+ ## Scope
8
+
9
+ Documentation only:
10
+ - [ ] Confirm PROJECT.md details
11
+ - [ ] Complete REQUIREMENTS.md
12
+ - [ ] Document ARCHITECTURE.md
13
+ - [ ] Document STACK.md
14
+ - [ ] Define CONVENTIONS.md
15
+ - [ ] Create base diagrams
16
+ - [ ] Establish baseline quality score
17
+
18
+ ## Dependencies
19
+
20
+ None. This is the foundation.
21
+
22
+ ## Tasks
23
+
24
+ - [ ] Read `.planning/PROJECT.md` - confirm product intent
25
+ - [ ] Read `.planning/REQUIREMENTS.md` - validate requirements
26
+ - [ ] Complete STACK.md with all tech details and versions
27
+ - [ ] Document ARCHITECTURE.md from codebase analysis
28
+ - [ ] Extract CONVENTIONS.md from existing code patterns
29
+ - [ ] Identify and document PITFALLS.md
30
+ - [ ] Create system-context.mmd diagram
31
+ - [ ] Create container-architecture.mmd diagram
32
+ - [ ] Create database-erd.mmd (if applicable)
33
+ - [ ] Create deployment-flow.mmd diagram
34
+ - [ ] Create initial QUALITY_SCORE.md
35
+ - [ ] Verify all `.planning/` structure exists
36
+ - [ ] Run project verification (tests, builds, etc.)
37
+ - [ ] Document decision: "Phase 0 complete, ready for Phase 1 planning"
38
+
39
+ ## Acceptance Criteria
40
+
41
+ - [x] `.planning/` directory structure created
42
+ - [ ] PROJECT.md completed with product details
43
+ - [ ] REQUIREMENTS.md documented
44
+ - [ ] STACK.md has all tech versions
45
+ - [ ] ARCHITECTURE.md describes system boundaries
46
+ - [ ] Diagrams are created
47
+ - [ ] No critical TBDs remain in core docs
48
+ - [ ] Team confirms understanding of project scope
49
+ - [ ] All verification checks pass
50
+
51
+ ## Verification
52
+
53
+ ```sh
54
+ # Verify structure
55
+ test -d .planning/phases/00-foundation && echo "✓ Phase folder exists"
56
+
57
+ # Check core docs are not just TBD
58
+ for file in PROJECT REQUIREMENTS STACK ARCHITECTURE CONVENTIONS; do
59
+ if grep -q "^## " .planning/$file.md && ! grep -q "TBD$" .planning/$file.md; then
60
+ echo "✓ .planning/$file.md has content"
61
+ fi
62
+ done
63
+
64
+ # List all diagrams
65
+ ls -la .planning/diagrams/*.mmd | wc -l
66
+ ```
67
+
68
+ ## Risk & Rollback
69
+
70
+ **Risk**: Documentation may be incomplete or inaccurate.
71
+
72
+ **Rollback**: This is a documentation phase. If docs need revision, simply edit the `.planning/*.md` files directly. No code changes to rollback.
73
+
74
+ ## Notes
75
+
76
+ This phase is setup only. Feature phases start in Phase 1 after Foundation is complete and requirements are confirmed.
@@ -1,34 +1,34 @@
1
- # Phase Plan
2
-
3
- ## Goal
4
-
5
- TBD
6
-
7
- ## Scope
8
-
9
- - [ ] TBD
10
-
11
- ## Dependencies
12
-
13
- - [ ] TBD
14
-
15
- ## Tasks
16
-
17
- - [ ] Read required planning docs
18
- - [ ] Research codebase patterns
19
- - [ ] Define test contract
20
- - [ ] Implement planned work
21
- - [ ] Run verification
22
- - [ ] Update docs
23
- - [ ] Review changed files
24
-
25
- ## Acceptance Criteria
26
-
27
- - [ ] TBD
28
-
29
- ## Verification
30
-
31
- ```sh
32
- # TBD
33
- ```
34
-
1
+ # Phase Plan
2
+
3
+ ## Goal
4
+
5
+ TBD
6
+
7
+ ## Scope
8
+
9
+ - [ ] TBD
10
+
11
+ ## Dependencies
12
+
13
+ - [ ] TBD
14
+
15
+ ## Tasks
16
+
17
+ - [ ] Read required planning docs
18
+ - [ ] Research codebase patterns
19
+ - [ ] Define test contract
20
+ - [ ] Implement planned work
21
+ - [ ] Run verification
22
+ - [ ] Update docs
23
+ - [ ] Review changed files
24
+
25
+ ## Acceptance Criteria
26
+
27
+ - [ ] TBD
28
+
29
+ ## Verification
30
+
31
+ ```sh
32
+ # TBD
33
+ ```
34
+
@@ -1,22 +1,22 @@
1
- # Pitfalls
2
-
3
- ## Common Mistakes
4
-
5
- - [ ] TBD
6
-
7
- ## Risky Areas
8
-
9
- - [ ] TBD
10
-
11
- ## Things Not To Do
12
-
13
- - [ ] TBD
14
-
15
- ## Fragile Dependencies
16
-
17
- - [ ] TBD
18
-
19
- ## Historical Warnings
20
-
21
- - [ ] TBD
22
-
1
+ # Pitfalls
2
+
3
+ ## Common Mistakes
4
+
5
+ - [ ] TBD
6
+
7
+ ## Risky Areas
8
+
9
+ - [ ] TBD
10
+
11
+ ## Things Not To Do
12
+
13
+ - [ ] TBD
14
+
15
+ ## Fragile Dependencies
16
+
17
+ - [ ] TBD
18
+
19
+ ## Historical Warnings
20
+
21
+ - [ ] TBD
22
+
@@ -1,39 +1,39 @@
1
- # Planning Tree Template
2
-
3
- ```txt
4
- .planning/
5
- ├── PROJECT.md
6
- ├── REQUIREMENTS.md
7
- ├── ROADMAP.md
8
- ├── STATE.md
9
- ├── STACK.md
10
- ├── ARCHITECTURE.md
11
- ├── DESIGN.md
12
- ├── API_DOCS.md
13
- ├── INTEGRATIONS.md
14
- ├── CONVENTIONS.md
15
- ├── PITFALLS.md
16
- ├── LESSONS_LEARNED.md
17
- ├── SPEC_CHANGELOG.md
18
- ├── FEATURE_INDEX.md
19
- ├── CHANGE_IMPACT_MATRIX.md
20
- ├── QUALITY_SCORE.md
21
- ├── ESCALATION.md
22
- ├── OBSERVABILITY.md
23
- ├── SMOKE_TESTS.md
24
- ├── JOURNEYS.md
25
- ├── SUMMARY.md
26
- ├── config.json
27
- ├── diagrams/
28
- ├── research/
29
- ├── decisions/
30
- ├── phases/
31
- ├── features/
32
- ├── bugs/
33
- ├── audits/
34
- ├── checks/
35
- ├── quick/
36
- ├── codebase/
37
- └── templates/
38
- ```
39
-
1
+ # Planning Tree Template
2
+
3
+ ```txt
4
+ .planning/
5
+ ├── PROJECT.md
6
+ ├── REQUIREMENTS.md
7
+ ├── ROADMAP.md
8
+ ├── STATE.md
9
+ ├── STACK.md
10
+ ├── ARCHITECTURE.md
11
+ ├── DESIGN.md
12
+ ├── API_DOCS.md
13
+ ├── INTEGRATIONS.md
14
+ ├── CONVENTIONS.md
15
+ ├── PITFALLS.md
16
+ ├── LESSONS_LEARNED.md
17
+ ├── SPEC_CHANGELOG.md
18
+ ├── FEATURE_INDEX.md
19
+ ├── CHANGE_IMPACT_MATRIX.md
20
+ ├── QUALITY_SCORE.md
21
+ ├── ESCALATION.md
22
+ ├── OBSERVABILITY.md
23
+ ├── SMOKE_TESTS.md
24
+ ├── JOURNEYS.md
25
+ ├── SUMMARY.md
26
+ ├── config.json
27
+ ├── diagrams/
28
+ ├── research/
29
+ ├── decisions/
30
+ ├── phases/
31
+ ├── features/
32
+ ├── bugs/
33
+ ├── audits/
34
+ ├── checks/
35
+ ├── quick/
36
+ ├── codebase/
37
+ └── templates/
38
+ ```
39
+