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,33 +1,33 @@
1
- # Workflow Reference
2
-
3
- Use this file when the requested work is a feature, bug fix, plan, audit, review, or status check.
4
-
5
- ## Command Mapping
6
-
7
- | Intent | Workflow |
8
- |---|---|
9
- | Initialize planning | `/init` |
10
- | Add behavior | `/new-feature` |
11
- | Fix regression | `/fix-bug` |
12
- | Plan without implementing | `/plan` |
13
- | Inspect quality and drift | `/audit` |
14
- | Review changed files | `/review` |
15
- | Summarize current state | `/status` |
16
-
17
- ## Readiness Gate
18
-
19
- - [ ] Intent is confirmed.
20
- - [ ] Required planning docs are read.
21
- - [ ] Local codebase evidence is recorded.
22
- - [ ] External research is cited or marked unavailable.
23
- - [ ] Impact, tests, docs, diagrams, and rollback are known.
24
- - [ ] Escalation risks are resolved.
25
-
26
- ## Completion Gate
27
-
28
- - [ ] Verification passed.
29
- - [ ] Docs were synchronized or declared unnecessary.
30
- - [ ] Tracking files were updated.
31
- - [ ] Changed files were reviewed.
32
- - [ ] Unnecessary files, debug logs, and unrelated changes were removed.
33
-
1
+ # Workflow Reference
2
+
3
+ Use this file when the requested work is a feature, bug fix, plan, audit, review, or status check.
4
+
5
+ ## Command Mapping
6
+
7
+ | Intent | Workflow |
8
+ |---|---|
9
+ | Initialize planning | `/init` |
10
+ | Add behavior | `/new-feature` |
11
+ | Fix regression | `/fix-bug` |
12
+ | Plan without implementing | `/plan` |
13
+ | Inspect quality and drift | `/audit` |
14
+ | Review changed files | `/review` |
15
+ | Summarize current state | `/status` |
16
+
17
+ ## Readiness Gate
18
+
19
+ - [ ] Intent is confirmed.
20
+ - [ ] Required planning docs are read.
21
+ - [ ] Local codebase evidence is recorded.
22
+ - [ ] External research is cited or marked unavailable.
23
+ - [ ] Impact, tests, docs, diagrams, and rollback are known.
24
+ - [ ] Escalation risks are resolved.
25
+
26
+ ## Completion Gate
27
+
28
+ - [ ] Verification passed.
29
+ - [ ] Docs were synchronized or declared unnecessary.
30
+ - [ ] Tracking files were updated.
31
+ - [ ] Changed files were reviewed.
32
+ - [ ] Unnecessary files, debug logs, and unrelated changes were removed.
33
+
@@ -1,27 +1,27 @@
1
- # AGENTS.md
2
-
3
- This repository uses the Project Genesis Harness.
4
-
5
- Before doing feature work, bug fixes, refactors, or architecture changes, read:
6
-
7
- 1. `.planning/SUMMARY.md`
8
- 2. `.planning/STATE.md`
9
- 3. `.planning/PROJECT.md`
10
- 4. `.planning/REQUIREMENTS.md`
11
- 5. `.planning/STACK.md`
12
- 6. `.planning/ARCHITECTURE.md`
13
- 7. `.planning/CONVENTIONS.md`
14
- 8. `.planning/PITFALLS.md`
15
- 9. `.planning/LESSONS_LEARNED.md`
16
-
17
- For new features, create a folder under `.planning/features/`.
18
- For bug fixes, create a folder under `.planning/bugs/`.
19
- For major decisions, create an ADR under `.planning/decisions/`.
20
-
21
- Do not claim completion unless:
22
-
23
- - verification passed
24
- - docs were synchronized
25
- - task tracking was updated
26
- - changed files were reviewed
27
-
1
+ # AGENTS.md
2
+
3
+ This repository uses the Project Genesis Harness.
4
+
5
+ Before doing feature work, bug fixes, refactors, or architecture changes, read:
6
+
7
+ 1. `.planning/SUMMARY.md`
8
+ 2. `.planning/STATE.md`
9
+ 3. `.planning/PROJECT.md`
10
+ 4. `.planning/REQUIREMENTS.md`
11
+ 5. `.planning/STACK.md`
12
+ 6. `.planning/ARCHITECTURE.md`
13
+ 7. `.planning/CONVENTIONS.md`
14
+ 8. `.planning/PITFALLS.md`
15
+ 9. `.planning/LESSONS_LEARNED.md`
16
+
17
+ For new features, create a folder under `.planning/features/`.
18
+ For bug fixes, create a folder under `.planning/bugs/`.
19
+ For major decisions, create an ADR under `.planning/decisions/`.
20
+
21
+ Do not claim completion unless:
22
+
23
+ - verification passed
24
+ - docs were synchronized
25
+ - task tracking was updated
26
+ - changed files were reviewed
27
+
@@ -1,32 +1,32 @@
1
- # API Docs
2
-
3
- ## Endpoints
4
-
5
- | Method | Path | Purpose | Auth |
6
- |---|---|---|---|
7
- | TBD | TBD | TBD | TBD |
8
-
9
- ## Request Examples
10
-
11
- ```json
12
- {}
13
- ```
14
-
15
- ## Response Examples
16
-
17
- ```json
18
- {}
19
- ```
20
-
21
- ## Error Format
22
-
23
- TBD
24
-
25
- ## Auth Requirements
26
-
27
- TBD
28
-
29
- ## Versioning Rules
30
-
31
- TBD
32
-
1
+ # API Docs
2
+
3
+ ## Endpoints
4
+
5
+ | Method | Path | Purpose | Auth |
6
+ |---|---|---|---|
7
+ | TBD | TBD | TBD | TBD |
8
+
9
+ ## Request Examples
10
+
11
+ ```json
12
+ {}
13
+ ```
14
+
15
+ ## Response Examples
16
+
17
+ ```json
18
+ {}
19
+ ```
20
+
21
+ ## Error Format
22
+
23
+ TBD
24
+
25
+ ## Auth Requirements
26
+
27
+ TBD
28
+
29
+ ## Versioning Rules
30
+
31
+ TBD
32
+
@@ -1,30 +1,30 @@
1
- # Architecture
2
-
3
- ## High-Level Architecture
4
-
5
- TBD
6
-
7
- ## Module Boundaries
8
-
9
- - [ ] TBD
10
-
11
- ## Data Flow
12
-
13
- TBD
14
-
15
- ## Dependency Direction
16
-
17
- TBD
18
-
19
- ## Service Boundaries
20
-
21
- TBD
22
-
23
- ## System Design Principles
24
-
25
- - [ ] TBD
26
-
27
- ## Forbidden Architecture Patterns
28
-
29
- - [ ] TBD
30
-
1
+ # Architecture
2
+
3
+ ## High-Level Architecture
4
+
5
+ TBD
6
+
7
+ ## Module Boundaries
8
+
9
+ - [ ] TBD
10
+
11
+ ## Data Flow
12
+
13
+ TBD
14
+
15
+ ## Dependency Direction
16
+
17
+ TBD
18
+
19
+ ## Service Boundaries
20
+
21
+ TBD
22
+
23
+ ## System Design Principles
24
+
25
+ - [ ] TBD
26
+
27
+ ## Forbidden Architecture Patterns
28
+
29
+ - [ ] TBD
30
+
@@ -1,26 +1,26 @@
1
- # Audit
2
-
3
- ## Scope
4
-
5
- - [ ] architecture drift
6
- - [ ] docs freshness
7
- - [ ] dead code
8
- - [ ] duplicated logic
9
- - [ ] dependency risk
10
- - [ ] security risk
11
- - [ ] missing tests
12
- - [ ] missing diagrams
13
- - [ ] stale decisions
14
- - [ ] stale feature tasks
15
- - [ ] stale phase tasks
16
-
17
- ## Findings
18
-
19
- | Severity | Area | Finding | Follow-Up Task |
20
- |---|---|---|---|
21
- | TBD | TBD | TBD | TBD |
22
-
23
- ## Quality Score Updates
24
-
25
- - [ ] TBD
26
-
1
+ # Audit
2
+
3
+ ## Scope
4
+
5
+ - [ ] architecture drift
6
+ - [ ] docs freshness
7
+ - [ ] dead code
8
+ - [ ] duplicated logic
9
+ - [ ] dependency risk
10
+ - [ ] security risk
11
+ - [ ] missing tests
12
+ - [ ] missing diagrams
13
+ - [ ] stale decisions
14
+ - [ ] stale feature tasks
15
+ - [ ] stale phase tasks
16
+
17
+ ## Findings
18
+
19
+ | Severity | Area | Finding | Follow-Up Task |
20
+ |---|---|---|---|
21
+ | TBD | TBD | TBD | TBD |
22
+
23
+ ## Quality Score Updates
24
+
25
+ - [ ] TBD
26
+
@@ -1,34 +1,34 @@
1
- # Bug
2
-
3
- ## Report
4
-
5
- TBD
6
-
7
- ## Reproduction
8
-
9
- - [ ] TBD
10
-
11
- ## Root Cause
12
-
13
- TBD
14
-
15
- ## Test Contract
16
-
17
- - [ ] Regression test or verification must fail before the fix.
18
- - [ ] Regression test or verification must pass after the fix.
19
-
20
- ## Tasks
21
-
22
- - [ ] Read PITFALLS.md
23
- - [ ] Read LESSONS_LEARNED.md
24
- - [ ] Reproduce bug
25
- - [ ] Identify root cause
26
- - [ ] Write regression test or verification
27
- - [ ] Fix bug
28
- - [ ] Run verification
29
- - [ ] Update LESSONS_LEARNED.md
30
- - [ ] Update docs if behavior changed
31
- - [ ] Review changed files
32
- - [ ] Update STATE.md
33
- - [ ] Update SPEC_CHANGELOG.md if needed
34
-
1
+ # Bug
2
+
3
+ ## Report
4
+
5
+ TBD
6
+
7
+ ## Reproduction
8
+
9
+ - [ ] TBD
10
+
11
+ ## Root Cause
12
+
13
+ TBD
14
+
15
+ ## Test Contract
16
+
17
+ - [ ] Regression test or verification must fail before the fix.
18
+ - [ ] Regression test or verification must pass after the fix.
19
+
20
+ ## Tasks
21
+
22
+ - [ ] Read PITFALLS.md
23
+ - [ ] Read LESSONS_LEARNED.md
24
+ - [ ] Reproduce bug
25
+ - [ ] Identify root cause
26
+ - [ ] Write regression test or verification
27
+ - [ ] Fix bug
28
+ - [ ] Run verification
29
+ - [ ] Update LESSONS_LEARNED.md
30
+ - [ ] Update docs if behavior changed
31
+ - [ ] Review changed files
32
+ - [ ] Update STATE.md
33
+ - [ ] Update SPEC_CHANGELOG.md if needed
34
+