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,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
+