codex-genesis-harness 0.1.5 → 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 (151) hide show
  1. package/.codebase/ARCHITECTURE_REVIEW_COMPLETE.md +216 -216
  2. package/.codebase/CURRENT_STATE.md +7 -2
  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/.codex/skills/genesis-api-sync/SKILL.md +354 -354
  14. package/.codex/skills/genesis-api-sync/checklists/api-sync-checklist.md +101 -101
  15. package/.codex/skills/genesis-api-sync/templates/api-change-template.md +257 -257
  16. package/.codex/skills/genesis-debug-guide/SKILL.md +479 -479
  17. package/.codex/skills/genesis-debug-guide/checklists/flaky-test-investigation.md +339 -339
  18. package/.codex/skills/genesis-debug-guide/checklists/production-bug-debug.md +210 -210
  19. package/.codex/skills/genesis-debug-guide/checklists/test-failure-debug.md +158 -158
  20. package/.codex/skills/genesis-debug-guide/observability/debug-commands.md +365 -365
  21. package/.codex/skills/genesis-debug-guide/playbooks/unit-test-failures.md +289 -289
  22. package/.codex/skills/genesis-debug-guide/templates/debug-investigation-log.md +288 -288
  23. package/.codex/skills/genesis-docs-automation/SKILL.md +1003 -1003
  24. package/.codex/skills/genesis-docs-automation/checklists/docs-validation.md +359 -359
  25. package/.codex/skills/genesis-docs-automation/checklists/spec-alignment.md +312 -312
  26. package/.codex/skills/genesis-docs-automation/observability/docs-tracking.md +382 -382
  27. package/.codex/skills/genesis-docs-automation/playbooks/auto-update-flow.md +851 -851
  28. package/.codex/skills/genesis-docs-automation/playbooks/changelog-generation.md +491 -491
  29. package/.codex/skills/genesis-docs-automation/templates/changelog-entry-template.md +187 -187
  30. package/.codex/skills/genesis-docs-automation/templates/handoff-template.md +297 -297
  31. package/.codex/skills/genesis-harness/SKILL.md +1427 -1427
  32. package/.codex/skills/genesis-harness/agents/openai.yaml +7 -7
  33. package/.codex/skills/genesis-harness/checklists/bug-fix-qa.md +169 -169
  34. package/.codex/skills/genesis-harness/checklists/new-feature-qa.md +157 -157
  35. package/.codex/skills/genesis-harness/checklists/refactor-qa.md +216 -216
  36. package/.codex/skills/genesis-harness/checklists/requirements-validation.md +211 -211
  37. package/.codex/skills/genesis-harness/references/planning-schema.md +35 -35
  38. package/.codex/skills/genesis-harness/references/quality-rubric.md +21 -21
  39. package/.codex/skills/genesis-harness/references/research-rubric.md +41 -41
  40. package/.codex/skills/genesis-harness/references/workflows.md +33 -33
  41. package/.codex/skills/genesis-harness/resources/agents-template.md +27 -27
  42. package/.codex/skills/genesis-harness/resources/api-docs-template.md +32 -32
  43. package/.codex/skills/genesis-harness/resources/architecture-template.md +30 -30
  44. package/.codex/skills/genesis-harness/resources/audit-template.md +26 -26
  45. package/.codex/skills/genesis-harness/resources/bug-template.md +34 -34
  46. package/.codex/skills/genesis-harness/resources/change-impact-matrix-template.md +204 -204
  47. package/.codex/skills/genesis-harness/resources/check-template.md +21 -21
  48. package/.codex/skills/genesis-harness/resources/conventions-template.md +42 -42
  49. package/.codex/skills/genesis-harness/resources/decision-template.md +33 -33
  50. package/.codex/skills/genesis-harness/resources/design-template.md +26 -26
  51. package/.codex/skills/genesis-harness/resources/escalation-template.md +21 -21
  52. package/.codex/skills/genesis-harness/resources/feature-template.md +49 -49
  53. package/.codex/skills/genesis-harness/resources/foundation-phase-template.md +131 -131
  54. package/.codex/skills/genesis-harness/resources/integrations-template.md +32 -32
  55. package/.codex/skills/genesis-harness/resources/journeys-template.md +13 -13
  56. package/.codex/skills/genesis-harness/resources/lessons-learned-template.md +12 -12
  57. package/.codex/skills/genesis-harness/resources/observability-template.md +34 -34
  58. package/.codex/skills/genesis-harness/resources/phase-00-foundation-template.md +76 -76
  59. package/.codex/skills/genesis-harness/resources/phase-template.md +34 -34
  60. package/.codex/skills/genesis-harness/resources/pitfalls-template.md +22 -22
  61. package/.codex/skills/genesis-harness/resources/planning-tree-template.md +39 -39
  62. package/.codex/skills/genesis-harness/resources/post-implementation-guide.md +347 -347
  63. package/.codex/skills/genesis-harness/resources/project-template.md +38 -38
  64. package/.codex/skills/genesis-harness/resources/quality-score-template.md +11 -11
  65. package/.codex/skills/genesis-harness/resources/requirements-template.md +26 -26
  66. package/.codex/skills/genesis-harness/resources/research-template.md +26 -26
  67. package/.codex/skills/genesis-harness/resources/review-template.md +22 -22
  68. package/.codex/skills/genesis-harness/resources/spec-changelog-template.md +6 -6
  69. package/.codex/skills/genesis-harness/resources/stack-template.md +33 -33
  70. package/.codex/skills/genesis-harness/resources/verification-template.md +26 -26
  71. package/.codex/skills/genesis-harness/scripts/check-architecture-boundaries.sh +0 -0
  72. package/.codex/skills/genesis-harness/scripts/check-docs-sync.sh +0 -0
  73. package/.codex/skills/genesis-harness/scripts/check-no-debug-logs.sh +0 -0
  74. package/.codex/skills/genesis-harness/scripts/check-required-planning-files.sh +0 -0
  75. package/.codex/skills/genesis-harness/scripts/check-spec-changelog.sh +0 -0
  76. package/.codex/skills/genesis-harness/scripts/check-task-tracking.sh +0 -0
  77. package/.codex/skills/genesis-harness/scripts/compact-context.sh +0 -0
  78. package/.codex/skills/genesis-harness/scripts/create-adr.sh +0 -0
  79. package/.codex/skills/genesis-harness/scripts/create-bug.sh +0 -0
  80. package/.codex/skills/genesis-harness/scripts/create-feature.sh +0 -0
  81. package/.codex/skills/genesis-harness/scripts/detect-stack.sh +0 -0
  82. package/.codex/skills/genesis-harness/scripts/init-planning.sh +0 -0
  83. package/.codex/skills/genesis-harness/scripts/list-changed-files.sh +0 -0
  84. package/.codex/skills/genesis-harness/scripts/offload-log.sh +0 -0
  85. package/.codex/skills/genesis-harness/scripts/run-verification.sh +0 -0
  86. package/.codex/skills/genesis-harness/scripts/run-verify-loop.sh +0 -0
  87. package/.codex/skills/genesis-harness/scripts/update-state.sh +0 -0
  88. package/.codex/skills/genesis-mvp-planning/SKILL.md +114 -0
  89. package/.codex/skills/genesis-mvp-planning/agents/openai.yaml +6 -0
  90. package/.codex/skills/genesis-mvp-planning/checklists/mvp-readiness.md +18 -0
  91. package/.codex/skills/genesis-mvp-planning/examples/5-phase-roadmap-example.md +43 -0
  92. package/.codex/skills/genesis-mvp-planning/templates/phase-1-core.md +17 -0
  93. package/.codex/skills/genesis-mvp-planning/templates/phase-2-auth.md +17 -0
  94. package/.codex/skills/genesis-mvp-planning/templates/phase-3-features.md +17 -0
  95. package/.codex/skills/genesis-mvp-planning/templates/phase-4-integrations.md +17 -0
  96. package/.codex/skills/genesis-mvp-planning/templates/phase-5-readiness.md +17 -0
  97. package/.codex/skills/genesis-new-design/agents/openai.yaml +3 -3
  98. package/.codex/skills/genesis-observability-automation/checklists/.gitkeep +0 -0
  99. package/.codex/skills/genesis-observability-automation/observability/.gitkeep +0 -0
  100. package/.codex/skills/genesis-observability-automation/playbooks/.gitkeep +0 -0
  101. package/.codex/skills/genesis-observability-automation/templates/.gitkeep +0 -0
  102. package/.codex/skills/genesis-release-orchestration/SKILL.md +653 -653
  103. package/.codex/skills/genesis-release-orchestration/checklists/post-deployment-verification.md +274 -274
  104. package/.codex/skills/genesis-release-orchestration/checklists/pre-release-validation.md +220 -220
  105. package/.codex/skills/genesis-release-orchestration/observability/release-tracking.md +253 -253
  106. package/.codex/skills/genesis-release-orchestration/playbooks/canary-deployment-orchestration.md +472 -472
  107. package/.codex/skills/genesis-release-orchestration/playbooks/semantic-versioning-automation.md +494 -494
  108. package/.codex/skills/genesis-release-orchestration/templates/deployment-strategy-template.md +303 -303
  109. package/.codex/skills/genesis-release-orchestration/templates/release-runbook-template.md +420 -420
  110. package/.codex/skills/genesis-research-first/SKILL.md +237 -237
  111. package/.codex/skills/genesis-research-first/templates/.gitkeep +0 -0
  112. package/.codex/skills/genesis-spec-propagation/SKILL.md +534 -534
  113. package/.codex/skills/genesis-spec-propagation/checklists/phase-update-verification.md +384 -384
  114. package/.codex/skills/genesis-spec-propagation/checklists/spec-change-detection.md +257 -257
  115. package/.codex/skills/genesis-spec-propagation/observability/propagation-tracking.md +373 -373
  116. package/.codex/skills/genesis-spec-propagation/playbooks/breaking-change-propagation.md +692 -692
  117. package/.codex/skills/genesis-spec-propagation/playbooks/feature-change-propagation.md +434 -434
  118. package/.codex/skills/genesis-spec-propagation/templates/migration-guide-template.md +407 -407
  119. package/.codex/skills/genesis-upgrade-design/agents/openai.yaml +3 -3
  120. package/.codex/skills/spec-impact-engine/SKILL.md +504 -504
  121. package/.codex/skills/spec-impact-engine/detect-spec-changes.sh +0 -0
  122. package/.codex-plugin/plugin.json +19 -19
  123. package/CHANGELOG.md +42 -0
  124. package/LICENSE +22 -22
  125. package/README.EN.md +784 -730
  126. package/README.VI.md +776 -723
  127. package/README.md +102 -247
  128. package/VERSION +2 -2
  129. package/bin/genesis-harness.js +90 -87
  130. package/package.json +9 -3
  131. package/scripts/README.md +342 -342
  132. package/scripts/compact-context.sh +0 -0
  133. package/scripts/contract_integrity_gate.js +83 -0
  134. package/scripts/detect-changes.sh +0 -0
  135. package/scripts/healing_telemetry.js +118 -0
  136. package/scripts/install.sh +4 -1
  137. package/scripts/offload-log.sh +0 -0
  138. package/scripts/prompt_sentinel.js +84 -0
  139. package/scripts/run-evals.sh +1 -0
  140. package/scripts/run-verify-loop.sh +11 -0
  141. package/scripts/spec_visual_sync.js +157 -0
  142. package/scripts/test_generator.js +142 -0
  143. package/scripts/transition_state.sh +0 -0
  144. package/scripts/uninstall.sh +1 -0
  145. package/scripts/validation_gates.sh +40 -1
  146. package/scripts/verify.sh +5 -0
  147. package/tests/unit/contract_integrity_gate.test.js +74 -0
  148. package/tests/unit/healing_telemetry.test.js +58 -0
  149. package/tests/unit/prompt_sentinel.test.js +50 -0
  150. package/tests/unit/spec_visual_sync.test.js +77 -0
  151. 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
+