codex-genesis-harness 0.1.6 → 0.1.7

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 (62) hide show
  1. package/.codebase/CURRENT_STATE.md +8 -7
  2. package/.codebase/RECOVERY_POINTS.md +38 -393
  3. package/.codebase/beads.json +16 -0
  4. package/.codex/skills/genesis-ai-provider/SKILL.md +1 -1
  5. package/.codex/skills/genesis-api-contract/SKILL.md +1 -1
  6. package/.codex/skills/genesis-api-sync/SKILL.md +1 -1
  7. package/.codex/skills/genesis-architecture/SKILL.md +1 -1
  8. package/.codex/skills/genesis-codebase-map/SKILL.md +1 -1
  9. package/.codex/skills/genesis-debug-guide/SKILL.md +1 -1
  10. package/.codex/skills/genesis-design-spec/SKILL.md +3 -3
  11. package/.codex/skills/genesis-harness/SKILL.md +3 -2
  12. package/.codex/skills/genesis-harness-engineering/SKILL.md +1 -1
  13. package/.codex/skills/genesis-new-design/SKILL.md +2 -1
  14. package/.codex/skills/genesis-pipeline-orchestration/SKILL.md +1 -1
  15. package/.codex/skills/genesis-planning/SKILL.md +26 -1
  16. package/.codex/skills/genesis-release/SKILL.md +24 -1
  17. package/.codex/skills/{ui-ux-test-skill → genesis-ui-ux-test}/SKILL.md +1 -1
  18. package/CHANGELOG.md +14 -0
  19. package/README.EN.md +7 -11
  20. package/README.VI.md +9 -13
  21. package/README.md +10 -10
  22. package/VERSION +1 -1
  23. package/bin/genesis-harness.js +606 -6
  24. package/package.json +1 -1
  25. package/scripts/install.sh +2 -6
  26. package/scripts/run-evals.sh +20 -25
  27. package/scripts/uninstall.sh +2 -6
  28. package/scripts/verify.sh +6 -66
  29. package/.codex/skills/genesis-docs/SKILL.md +0 -46
  30. package/.codex/skills/genesis-docs/agents/openai.yaml +0 -7
  31. package/.codex/skills/genesis-mvp-planning/SKILL.md +0 -114
  32. package/.codex/skills/genesis-mvp-planning/agents/openai.yaml +0 -6
  33. package/.codex/skills/genesis-release-orchestration/SKILL.md +0 -653
  34. package/.codex/skills/genesis-release-orchestration/agents/openai.yaml +0 -7
  35. package/.codex/skills/genesis-research/SKILL.md +0 -46
  36. package/.codex/skills/genesis-research/agents/openai.yaml +0 -7
  37. /package/.codex/skills/{genesis-docs/checklists/checklist.md → genesis-docs-automation/checklists/manual-docs-checklist.md} +0 -0
  38. /package/.codex/skills/{genesis-docs/examples/example.md → genesis-docs-automation/examples/manual-docs-example.md} +0 -0
  39. /package/.codex/skills/{genesis-docs → genesis-docs-automation}/templates/docs-update-template.md +0 -0
  40. /package/.codex/skills/{genesis-state-machine/SKILL.md → genesis-harness/references/state-machine.md} +0 -0
  41. /package/.codex/skills/{genesis-mvp-planning → genesis-planning}/checklists/mvp-readiness.md +0 -0
  42. /package/.codex/skills/{genesis-mvp-planning → genesis-planning}/examples/5-phase-roadmap-example.md +0 -0
  43. /package/.codex/skills/{genesis-mvp-planning → genesis-planning}/templates/phase-1-core.md +0 -0
  44. /package/.codex/skills/{genesis-mvp-planning → genesis-planning}/templates/phase-2-auth.md +0 -0
  45. /package/.codex/skills/{genesis-mvp-planning → genesis-planning}/templates/phase-3-features.md +0 -0
  46. /package/.codex/skills/{genesis-mvp-planning → genesis-planning}/templates/phase-4-integrations.md +0 -0
  47. /package/.codex/skills/{genesis-mvp-planning → genesis-planning}/templates/phase-5-readiness.md +0 -0
  48. /package/.codex/skills/{genesis-release-orchestration → genesis-release}/checklists/post-deployment-verification.md +0 -0
  49. /package/.codex/skills/{genesis-release-orchestration → genesis-release}/checklists/pre-release-validation.md +0 -0
  50. /package/.codex/skills/{genesis-release-orchestration/examples/example.md → genesis-release/examples/orchestration-example.md} +0 -0
  51. /package/.codex/skills/{genesis-release-orchestration → genesis-release}/observability/release-tracking.md +0 -0
  52. /package/.codex/skills/{genesis-release-orchestration → genesis-release}/playbooks/canary-deployment-orchestration.md +0 -0
  53. /package/.codex/skills/{genesis-release-orchestration → genesis-release}/playbooks/semantic-versioning-automation.md +0 -0
  54. /package/.codex/skills/{genesis-release-orchestration → genesis-release}/templates/deployment-strategy-template.md +0 -0
  55. /package/.codex/skills/{genesis-release-orchestration → genesis-release}/templates/release-runbook-template.md +0 -0
  56. /package/.codex/skills/{genesis-research → genesis-research-first}/checklists/checklist.md +0 -0
  57. /package/.codex/skills/{genesis-research/examples/example.md → genesis-research-first/examples/manual-research-example.md} +0 -0
  58. /package/.codex/skills/{genesis-research → genesis-research-first}/templates/research-note-template.md +0 -0
  59. /package/.codex/skills/{ui-ux-test-skill → genesis-ui-ux-test}/agents/openai.yaml +0 -0
  60. /package/.codex/skills/{ui-ux-test-skill → genesis-ui-ux-test}/checklists/checklist.md +0 -0
  61. /package/.codex/skills/{ui-ux-test-skill → genesis-ui-ux-test}/examples/example.md +0 -0
  62. /package/.codex/skills/{ui-ux-test-skill → genesis-ui-ux-test}/templates/playwright-test-template.md +0 -0
@@ -10,25 +10,21 @@ skill_names=(
10
10
  genesis-upgrade-design
11
11
  genesis-architecture
12
12
  genesis-planning
13
- genesis-mvp-planning
14
13
  genesis-codebase-map
15
14
  genesis-design-spec
16
15
  genesis-api-contract
17
- ui-ux-test-skill
16
+ genesis-ui-ux-test
18
17
  genesis-harness-engineering
19
18
  genesis-ai-provider
20
19
  genesis-pipeline-orchestration
21
- genesis-research
22
- genesis-docs
23
- genesis-release
24
20
  genesis-api-sync
25
21
  genesis-debug-guide
26
22
  genesis-docs-automation
27
23
  genesis-spec-propagation
28
- genesis-release-orchestration
29
24
  genesis-performance-profiling
30
25
  genesis-observability-automation
31
26
  genesis-research-first
27
+ genesis-release
32
28
  spec-impact-engine
33
29
  )
34
30
 
@@ -59,25 +55,7 @@ done
59
55
  for skill_name in "${skill_names[@]}"; do
60
56
  assert_file "$skill_root/$skill_name/SKILL.md"
61
57
  assert_file "$skill_root/$skill_name/agents/openai.yaml"
62
-
63
- expected_name="$skill_name"
64
- case "$skill_name" in
65
- genesis-architecture) expected_name="architecture-skill" ;;
66
- genesis-planning) expected_name="planning-skill" ;;
67
- genesis-codebase-map) expected_name="codebase-map-skill" ;;
68
- genesis-design-spec) expected_name="design-spec-skill" ;;
69
- genesis-api-contract) expected_name="api-contract-skill" ;;
70
- genesis-harness-engineering) expected_name="harness-engineering-skill" ;;
71
- genesis-ai-provider) expected_name="ai-provider-skill" ;;
72
- genesis-pipeline-orchestration) expected_name="pipeline-orchestration-skill" ;;
73
- genesis-research) expected_name="research-skill" ;;
74
- genesis-docs) expected_name="docs-skill" ;;
75
- genesis-release) expected_name="release-skill" ;;
76
- genesis-api-sync) expected_name="api-sync-skill" ;;
77
- genesis-debug-guide) expected_name="debug-guide-skill" ;;
78
- esac
79
-
80
- assert_contains "$skill_root/$skill_name/SKILL.md" "name: $expected_name"
58
+ assert_contains "$skill_root/$skill_name/SKILL.md" "name: $skill_name"
81
59
  done
82
60
 
83
61
  assert_contains "$repo_root/scripts/install.sh" '--target agents|legacy|both'
@@ -116,4 +94,21 @@ for skill_name in "${skill_names[@]}" project-genesis-harness; do
116
94
  [ ! -e "$tmp/codex/skills/$skill_name" ] || fail "legacy uninstall target remains: $skill_name"
117
95
  done
118
96
 
97
+ assert_contains "$repo_root/bin/genesis-harness.js" "genesis-harness remember"
98
+ assert_contains "$repo_root/bin/genesis-harness.js" "genesis-harness recall"
99
+ assert_contains "$repo_root/bin/genesis-harness.js" "genesis-harness forget"
100
+ assert_contains "$repo_root/bin/genesis-harness.js" "genesis-harness prime"
101
+ assert_contains "$repo_root/bin/genesis-harness.js" "genesis-harness view-mockup"
102
+
103
+ # Test Beads Memory Commands
104
+ node "$repo_root/bin/genesis-harness.js" remember evalsmoke "Verify that evals can store facts." >/dev/null
105
+ node "$repo_root/bin/genesis-harness.js" recall evalsmoke | grep -q "Verify that evals" || fail "recall failed to find test fact"
106
+ node "$repo_root/bin/genesis-harness.js" prime | grep -q "Verify that evals" || fail "prime failed to include test fact"
107
+
108
+ # Find the ID of the stored fact to forget it
109
+ bead_id=$(node "$repo_root/bin/genesis-harness.js" recall evalsmoke | grep -o "\[[0-9a-f]\{6\}\]" | head -n 1 | tr -d '[]')
110
+ node "$repo_root/bin/genesis-harness.js" forget "$bead_id" >/dev/null
111
+ node "$repo_root/bin/genesis-harness.js" recall evalsmoke | grep -q "Verify that evals" && fail "forget failed to delete test fact" || true
112
+
113
+
119
114
  echo "evals passed"
@@ -7,25 +7,21 @@ skill_names=(
7
7
  genesis-upgrade-design
8
8
  genesis-architecture
9
9
  genesis-planning
10
- genesis-mvp-planning
11
10
  genesis-codebase-map
12
11
  genesis-design-spec
13
12
  genesis-api-contract
14
- ui-ux-test-skill
13
+ genesis-ui-ux-test
15
14
  genesis-harness-engineering
16
15
  genesis-ai-provider
17
16
  genesis-pipeline-orchestration
18
- genesis-research
19
- genesis-docs
20
- genesis-release
21
17
  genesis-api-sync
22
18
  genesis-debug-guide
23
19
  genesis-docs-automation
24
20
  genesis-spec-propagation
25
- genesis-release-orchestration
26
21
  genesis-performance-profiling
27
22
  genesis-observability-automation
28
23
  genesis-research-first
24
+ genesis-release
29
25
  spec-impact-engine
30
26
  project-genesis-harness
31
27
  )
package/scripts/verify.sh CHANGED
@@ -9,25 +9,21 @@ skill_names=(
9
9
  genesis-upgrade-design
10
10
  genesis-architecture
11
11
  genesis-planning
12
- genesis-mvp-planning
13
12
  genesis-codebase-map
14
13
  genesis-design-spec
15
14
  genesis-api-contract
16
- ui-ux-test-skill
15
+ genesis-ui-ux-test
17
16
  genesis-harness-engineering
18
17
  genesis-ai-provider
19
18
  genesis-pipeline-orchestration
20
- genesis-research
21
- genesis-docs
22
- genesis-release
23
19
  genesis-api-sync
24
20
  genesis-debug-guide
25
21
  genesis-docs-automation
26
22
  genesis-spec-propagation
27
- genesis-release-orchestration
28
23
  genesis-performance-profiling
29
24
  genesis-observability-automation
30
25
  genesis-research-first
26
+ genesis-release
31
27
  spec-impact-engine
32
28
  )
33
29
 
@@ -195,7 +191,7 @@ verify_harness_skill() {
195
191
  grep -q 'Definition Of Done' "$skill_dir/SKILL.md" || fail "missing Definition Of Done"
196
192
  grep -q 'Quality Rubric' "$skill_dir/SKILL.md" || fail "missing Quality Rubric"
197
193
 
198
- for ref in workflows.md planning-schema.md research-rubric.md quality-rubric.md; do
194
+ for ref in workflows.md planning-schema.md research-rubric.md quality-rubric.md state-machine.md; do
199
195
  [ -f "$skill_dir/references/$ref" ] || fail "missing reference: $ref"
200
196
  grep -q "references/$ref" "$skill_dir/SKILL.md" || fail "SKILL.md does not mention reference: $ref"
201
197
  done
@@ -268,67 +264,11 @@ verify_one() {
268
264
  genesis-new-design|genesis-upgrade-design)
269
265
  verify_design_skill "$skill_dir" "$dir_name"
270
266
  ;;
271
- genesis-architecture)
272
- verify_skill_metadata "$skill_dir" "architecture-skill"
273
- verify_skill_protocol "$skill_dir"
274
- ;;
275
- genesis-planning)
276
- verify_skill_metadata "$skill_dir" "planning-skill"
277
- verify_skill_protocol "$skill_dir"
278
- ;;
279
- genesis-mvp-planning)
280
- verify_skill_metadata "$skill_dir" "genesis-mvp-planning"
281
- verify_minimal_skill "$skill_dir"
282
- ;;
283
- genesis-codebase-map)
284
- verify_skill_metadata "$skill_dir" "codebase-map-skill"
285
- verify_skill_protocol "$skill_dir"
286
- ;;
287
- genesis-design-spec)
288
- verify_skill_metadata "$skill_dir" "design-spec-skill"
289
- verify_skill_protocol "$skill_dir"
290
- ;;
291
- genesis-api-contract)
292
- verify_skill_metadata "$skill_dir" "api-contract-skill"
293
- verify_skill_protocol "$skill_dir"
294
- ;;
295
- ui-ux-test-skill)
296
- verify_skill_metadata "$skill_dir" "ui-ux-test-skill"
297
- verify_skill_protocol "$skill_dir"
298
- ;;
299
- genesis-harness-engineering)
300
- verify_skill_metadata "$skill_dir" "harness-engineering-skill"
301
- verify_skill_protocol "$skill_dir"
302
- ;;
303
- genesis-ai-provider)
304
- verify_skill_metadata "$skill_dir" "ai-provider-skill"
305
- verify_skill_protocol "$skill_dir"
306
- ;;
307
- genesis-pipeline-orchestration)
308
- verify_skill_metadata "$skill_dir" "pipeline-orchestration-skill"
309
- verify_skill_protocol "$skill_dir"
310
- ;;
311
- genesis-research)
312
- verify_skill_metadata "$skill_dir" "research-skill"
313
- verify_skill_protocol "$skill_dir"
314
- ;;
315
- genesis-docs)
316
- verify_skill_metadata "$skill_dir" "docs-skill"
317
- verify_skill_protocol "$skill_dir"
318
- ;;
319
- genesis-release)
320
- verify_skill_metadata "$skill_dir" "release-skill"
321
- verify_skill_protocol "$skill_dir"
322
- ;;
323
- genesis-api-sync)
324
- verify_skill_metadata "$skill_dir" "api-sync-skill"
267
+ genesis-architecture|genesis-planning|genesis-codebase-map|genesis-design-spec|genesis-api-contract|genesis-ui-ux-test|genesis-harness-engineering|genesis-ai-provider|genesis-pipeline-orchestration|genesis-api-sync)
268
+ verify_skill_metadata "$skill_dir" "$dir_name"
325
269
  verify_skill_protocol "$skill_dir"
326
270
  ;;
327
- genesis-debug-guide)
328
- verify_skill_metadata "$skill_dir" "debug-guide-skill"
329
- verify_playbook_skill "$skill_dir"
330
- ;;
331
- genesis-docs-automation|genesis-spec-propagation|genesis-release-orchestration|genesis-performance-profiling|genesis-observability-automation)
271
+ genesis-debug-guide|genesis-docs-automation|genesis-spec-propagation|genesis-performance-profiling|genesis-observability-automation|genesis-release)
332
272
  verify_skill_metadata "$skill_dir" "$dir_name"
333
273
  verify_playbook_skill "$skill_dir"
334
274
  ;;
@@ -1,46 +0,0 @@
1
- ---
2
- name: docs-skill
3
- description: Keep Codex harness docs synchronized with skills, contracts, tests, memory, and release behavior. Use after any workflow, public interface, install, verification, or package behavior change.
4
- ---
5
-
6
- # Docs Skill
7
-
8
- ## Purpose
9
- Keep docs short, accurate, and linked to source-of-truth artifacts.
10
-
11
- ## When to use
12
- Use after changing skills, CLI behavior, contracts, fixtures, tests, repository memory, or publish flow.
13
-
14
- ## When NOT to use
15
- Do not use to duplicate full architecture manuals in `AGENTS.md`.
16
-
17
- ## Inputs required
18
- Changed files, public behavior, verification results, and affected users.
19
-
20
- ## Outputs required
21
- Updated README, AGENTS map, codebase memory, changelog-style summary, and changed docs list.
22
-
23
- ## Required tests
24
- Run docs-related verification and package dry-run when docs affect packaging or install instructions.
25
-
26
- ## Required fixtures
27
- Update templates/examples when docs describe reusable workflows.
28
-
29
- ## Required contract updates
30
- Update contracts when docs describe new interface behavior.
31
-
32
- ## Required codebase map updates
33
- Update `.codebase/CURRENT_STATE.md`, `MODULE_INDEX.md`, or summaries as needed.
34
-
35
- ## Token saving rules
36
- Keep docs concise. Link to templates and contracts instead of repeating them.
37
-
38
- ## Acceptance criteria
39
- Docs match behavior and do not duplicate large internal manuals.
40
-
41
- ## Common mistakes
42
- Letting AGENTS.md grow too large, documenting unverified behavior, and missing install docs.
43
-
44
- ## Recovery workflow
45
- If docs drift, add verify assertions or checklist items that catch the drift next time.
46
-
@@ -1,7 +0,0 @@
1
- interface:
2
- display_name: "Docs Skill"
3
- short_description: "Synchronize harness documentation"
4
- default_prompt: "Use $docs-skill to update concise docs and repository memory after changes."
5
- policy:
6
- allow_implicit_invocation: true
7
-
@@ -1,114 +0,0 @@
1
- ---
2
- name: genesis-mvp-planning
3
- description: "Define, structure, and automate the creation of a standard 5-Phase MVP Roadmap right after project initialization. Guarantees a decision-complete path to production-ready launch."
4
- ---
5
-
6
- # Genesis MVP 5-Phase Planning Skill
7
-
8
- ## Purpose
9
-
10
- The `genesis-mvp-planning` skill is designed to transition a newly initialized project into a structured, decision-complete **5-Phase MVP Roadmap**. Instead of leaving the repository with only a blank generic Phase 0 (Foundation) folder, this skill maps out the entire lifecycle of a production-ready Minimum Viable Product across exactly 5 logical, sequential phases.
11
-
12
- ---
13
-
14
- ## When to use
15
-
16
- Use the `genesis-mvp-planning` skill when:
17
- - You have just run `/genesis-init` (or `/init`) and need to map out the implementation timeline.
18
- - You want to scope an application specifically to its MVP (Minimum Viable Product) boundaries.
19
- - You want to establish clear gates and milestones for each stage of the project lifecycle.
20
-
21
- ---
22
-
23
- ## When NOT to use
24
-
25
- Do NOT use the `genesis-mvp-planning` skill when:
26
- - The project is already midway through development with a pre-existing mature roadmap.
27
- - The task is a minor, single-file bug fix or simple refactoring that doesn't affect the project timeline.
28
- - The roadmap has already been fully approved and is currently active.
29
-
30
- ---
31
-
32
- ## Inputs required
33
-
34
- Before running this planning skill, ensure the following inputs are gathered:
35
- - **Project Brief / Intent**: Clear understanding of what application is being built and target users.
36
- - **Technology Stack**: Backend, frontend, database, auth provider, and deployment target.
37
- - **Core MVP Features List**: The primary business value proposition that must be delivered.
38
-
39
- ---
40
-
41
- ## Outputs required
42
-
43
- Executing this skill creates the following structured deliverables:
44
- - `.planning/ROADMAP.md`: Updated roadmap with 5 distinct phases defined.
45
- - `.planning/phases/PHASE_1_CORE/`: Planning directory for Phase 1 (Foundation & API Core).
46
- - `.planning/phases/PHASE_2_AUTH/`: Planning directory for Phase 2 (Authentication & Security).
47
- - `.planning/phases/PHASE_3_FEATURES/`: Planning directory for Phase 3 (Core MVP Features).
48
- - `.planning/phases/PHASE_4_INTEGRATIONS/`: Planning directory for Phase 4 (Third-Party Integrations).
49
- - `.planning/phases/PHASE_5_READINESS/`: Planning directory for Phase 5 (Production Readiness & Observability).
50
-
51
- ---
52
-
53
- ## Required tests
54
-
55
- The planning deliverables are validated using:
56
- - [ ] `test/planning/roadmap-structure.test.js`: Verifies `ROADMAP.md` contains all 5 phases with valid status checkboxes.
57
- - [ ] `test/planning/phase-completeness.test.js`: Verifies each phase directory contains standard `SPEC.md`, `PLAN.md`, and `TASKS.md`.
58
-
59
- ---
60
-
61
- ## Required fixtures
62
-
63
- - `fixtures/planning/roadmap-expected.md`: The canonical structure of a 5-Phase MVP roadmap.
64
- - `fixtures/planning/phase-config-expected.json`: Complete configuration template mapping out the 5 phases.
65
-
66
- ---
67
-
68
- ## Required contract updates
69
-
70
- Update the following files if phase boundary standards change:
71
- - `contracts/planning/roadmap.schema.json`: Schema validator for `ROADMAP.md` files.
72
- - `contracts/planning/phase.schema.json`: Schema validator for individual phase directories.
73
-
74
- ---
75
-
76
- ## Required codebase map updates
77
-
78
- After mapping out the 5-Phase MVP:
79
- - **`.codebase/CURRENT_STATE.md`**: Update current phase to Phase 1, and add the full 5-phase overview.
80
- - **`.codebase/MODULE_INDEX.md`**: Add references to each of the 5 phase directories.
81
-
82
- ---
83
-
84
- ## Token saving rules
85
-
86
- 1. **Reuse templates**: Do not rewrite the basic structure of the phases. Use the provided phase templates in `templates/`.
87
- 2. **Summarize context**: Do not read every detail of the repository. Use `SUMMARY.md` and module index.
88
- 3. **Draft sequentially**: Plan one phase at a time to keep prompt sizes small.
89
-
90
- ---
91
-
92
- ## Acceptance criteria
93
-
94
- The 5-Phase MVP roadmap is ACCEPTED when:
95
- - [ ] `ROADMAP.md` is updated with 5 clearly defined phases, dates, and success criteria.
96
- - [ ] All 5 phase planning folders (`PHASE_1_CORE` to `PHASE_5_READINESS`) are created and populated.
97
- - [ ] No feature code is written before the 5 phase boundaries are validated.
98
-
99
- ---
100
-
101
- ## Common mistakes
102
-
103
- ### Mistake 1: Starting Phase 3 (Core Features) before Phase 1 (API Core)
104
- - **Problem**: Writing UI screens without verified backend models and schemas leads to massive rework.
105
- - **Fix**: Complete Phase 1 and 2 to establish a solid database and API contract first.
106
-
107
- ---
108
-
109
- ## Recovery workflow
110
-
111
- ### Recovery 1: Phase drift or timeline changes
112
- 1. Mark the affected phase as `[!] blocked` in `ROADMAP.md`.
113
- 2. Document the change in `SPEC_CHANGELOG.md`.
114
- 3. Adjust downstream phase boundaries accordingly.
@@ -1,6 +0,0 @@
1
- interface:
2
- display_name: "Genesis MVP Planning"
3
- short_description: "— Xây dựng lộ trình 5 Phase phát triển sản phẩm MVP"
4
- default_prompt: "Use $genesis-mvp-planning to map out the 5 essential phases of a production-ready MVP."
5
- policy:
6
- allow_implicit_invocation: true