@pzy560117/codex-harness 0.1.3 → 0.1.5

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 (386) hide show
  1. package/README.md +164 -27
  2. package/bin/harness.js +7 -7
  3. package/lib/commands/doctor.js +12 -12
  4. package/lib/commands/init.js +105 -105
  5. package/lib/commands/run.js +22 -22
  6. package/lib/commands/verify.js +12 -12
  7. package/lib/main.js +62 -62
  8. package/lib/powershell/find-powershell.js +20 -20
  9. package/lib/powershell/invoke-script.js +34 -34
  10. package/lib/project/assert-initialized.js +20 -20
  11. package/lib/project/detect-project-root.js +5 -5
  12. package/lib/release/cache-layout.js +34 -34
  13. package/lib/release/download-release.js +25 -25
  14. package/lib/release/package-source-layout.js +13 -13
  15. package/lib/release/release-config.js +6 -6
  16. package/lib/release/release-manifest.js +76 -76
  17. package/lib/release/resolve-package-source.js +21 -21
  18. package/lib/release/resolve-version.js +26 -26
  19. package/lib/release/unpack-zip.js +25 -25
  20. package/lib/release/verify-sha256.js +16 -16
  21. package/package-source/AGENTS.md +48 -57
  22. package/package-source/PACKAGE.md +7 -7
  23. package/package-source/README.md +85 -81
  24. package/package-source/docs/codex-harness-engineering/templates/AGENTS.md +51 -0
  25. package/package-source/docs/codex-harness-engineering/templates/README.md +21 -20
  26. package/package-source/docs/codex-harness-engineering/templates/bootstrap-codex-harness.ps1 +144 -110
  27. package/package-source/docs/codex-harness-engineering/templates/ci/AGENTS.md +15 -0
  28. package/package-source/docs/codex-harness-engineering/templates/ci/github-action-codex-review.yml +110 -110
  29. package/package-source/docs/codex-harness-engineering/templates/config/AGENTS.md +19 -0
  30. package/package-source/docs/codex-harness-engineering/templates/config/agents/architect.toml +18 -17
  31. package/package-source/docs/codex-harness-engineering/templates/config/agents/backend-worker.toml +15 -14
  32. package/package-source/docs/codex-harness-engineering/templates/config/agents/docs-researcher.toml +13 -12
  33. package/package-source/docs/codex-harness-engineering/templates/config/agents/docs-worker.toml +16 -15
  34. package/package-source/docs/codex-harness-engineering/templates/config/agents/explorer.toml +15 -14
  35. package/package-source/docs/codex-harness-engineering/templates/config/agents/failure-triage.toml +19 -18
  36. package/package-source/docs/codex-harness-engineering/templates/config/agents/frontend-worker.toml +15 -14
  37. package/package-source/docs/codex-harness-engineering/templates/config/agents/harness-writer.toml +16 -15
  38. package/package-source/docs/codex-harness-engineering/templates/config/agents/planner.toml +16 -15
  39. package/package-source/docs/codex-harness-engineering/templates/config/agents/readonly-research.toml +14 -13
  40. package/package-source/docs/codex-harness-engineering/templates/config/agents/reviewer.toml +13 -12
  41. package/package-source/docs/codex-harness-engineering/templates/config/agents/security-reviewer.toml +16 -15
  42. package/package-source/docs/codex-harness-engineering/templates/config/agents/stage1-reviewer.toml +15 -14
  43. package/package-source/docs/codex-harness-engineering/templates/config/agents/stage2-reviewer.toml +16 -15
  44. package/package-source/docs/codex-harness-engineering/templates/config/agents/test-planner.toml +18 -17
  45. package/package-source/docs/codex-harness-engineering/templates/config/agents/test-runner.toml +15 -14
  46. package/package-source/docs/codex-harness-engineering/templates/config/agents/visual-reviewer.toml +16 -15
  47. package/package-source/docs/codex-harness-engineering/templates/config/codex-agent-roles.md +24 -24
  48. package/package-source/docs/codex-harness-engineering/templates/config/codex-config.toml +12 -12
  49. package/package-source/docs/codex-harness-engineering/templates/config/codex-readme.md +6 -6
  50. package/package-source/docs/codex-harness-engineering/templates/config/env-check.ps1 +44 -40
  51. package/package-source/docs/codex-harness-engineering/templates/config/env.example +13 -12
  52. package/package-source/docs/codex-harness-engineering/templates/config/global-AGENTS.md +40 -40
  53. package/package-source/docs/codex-harness-engineering/templates/config/global-config.toml +19 -19
  54. package/package-source/docs/codex-harness-engineering/templates/config/rules/agents.md +118 -115
  55. package/package-source/docs/codex-harness-engineering/templates/config/rules/coding-style.md +57 -74
  56. package/package-source/docs/codex-harness-engineering/templates/config/rules/constitution.md +4 -4
  57. package/package-source/docs/codex-harness-engineering/templates/config/rules/git.rules +41 -41
  58. package/package-source/docs/codex-harness-engineering/templates/config/rules/harness.rules +29 -29
  59. package/package-source/docs/codex-harness-engineering/templates/config/rules/safety.rules +35 -35
  60. package/package-source/docs/codex-harness-engineering/templates/context/AGENTS.md +19 -0
  61. package/package-source/docs/codex-harness-engineering/templates/context/API_MAP.md +18 -0
  62. package/package-source/docs/codex-harness-engineering/templates/context/CHANGELOG_AI.md +11 -0
  63. package/package-source/docs/codex-harness-engineering/templates/context/CURRENT_TASK.md +114 -0
  64. package/package-source/docs/codex-harness-engineering/templates/context/DB_SCHEMA.md +14 -0
  65. package/package-source/docs/codex-harness-engineering/templates/context/DECISIONS.md +12 -0
  66. package/package-source/docs/codex-harness-engineering/templates/context/KNOWN_ISSUES.md +12 -0
  67. package/package-source/docs/codex-harness-engineering/templates/context/PROJECT_CONTEXT.md +14 -0
  68. package/package-source/docs/codex-harness-engineering/templates/context/architecture-brief.md +58 -58
  69. package/package-source/docs/codex-harness-engineering/templates/context/dev-plan.md +89 -83
  70. package/package-source/docs/codex-harness-engineering/templates/context/feature-pack.md +101 -101
  71. package/package-source/docs/codex-harness-engineering/templates/context/repo-map.md +102 -78
  72. package/package-source/docs/codex-harness-engineering/templates/context/service-dependency-matrix.yaml +25 -25
  73. package/package-source/docs/codex-harness-engineering/templates/contracts/AGENTS.md +17 -0
  74. package/package-source/docs/codex-harness-engineering/templates/contracts/README.md +24 -16
  75. package/package-source/docs/codex-harness-engineering/templates/contracts/openapi.yaml +182 -182
  76. package/package-source/docs/codex-harness-engineering/templates/contracts/orval.config.ts +20 -20
  77. package/package-source/docs/codex-harness-engineering/templates/contracts/prism-usage.md +41 -34
  78. package/package-source/docs/codex-harness-engineering/templates/design/AGENTS.md +21 -0
  79. package/package-source/docs/codex-harness-engineering/templates/design/ai-image-brief.md +122 -122
  80. package/package-source/docs/codex-harness-engineering/templates/design/component-map.md +45 -31
  81. package/package-source/docs/codex-harness-engineering/templates/design/design-brief.md +183 -178
  82. package/package-source/docs/codex-harness-engineering/templates/design/design-tokens.json +88 -88
  83. package/package-source/docs/codex-harness-engineering/templates/design/frontend-architecture.md +164 -146
  84. package/package-source/docs/codex-harness-engineering/templates/design/image-to-frontend-spec.md +64 -52
  85. package/package-source/docs/codex-harness-engineering/templates/design/screen-states.md +157 -122
  86. package/package-source/docs/codex-harness-engineering/templates/design/visual-parity-review.md +21 -21
  87. package/package-source/docs/codex-harness-engineering/templates/docs/AGENTS.md +19 -0
  88. package/package-source/docs/codex-harness-engineering/templates/docs/architecture-constraints.md +97 -83
  89. package/package-source/docs/codex-harness-engineering/templates/docs/code-semantics-and-navigation.md +54 -0
  90. package/package-source/docs/codex-harness-engineering/templates/docs/code-style-and-naming.md +116 -0
  91. package/package-source/docs/codex-harness-engineering/templates/docs/directory-structure-template.md +88 -0
  92. package/package-source/docs/codex-harness-engineering/templates/docs/env-and-deployment-template.md +60 -0
  93. package/package-source/docs/codex-harness-engineering/templates/docs/frontend-quality-rules.md +165 -138
  94. package/package-source/docs/codex-harness-engineering/templates/docs/governance-auto-repair.md +82 -80
  95. package/package-source/docs/codex-harness-engineering/templates/docs/harness-architecture.md +78 -78
  96. package/package-source/docs/codex-harness-engineering/templates/docs/install-manifest-governance.md +16 -16
  97. package/package-source/docs/codex-harness-engineering/templates/docs/knowledge-architecture.md +241 -219
  98. package/package-source/docs/codex-harness-engineering/templates/docs/knowledge-import.md +108 -108
  99. package/package-source/docs/codex-harness-engineering/templates/docs/knowledge-lint.md +98 -98
  100. package/package-source/docs/codex-harness-engineering/templates/docs/mcp-knowledge-governance.md +24 -0
  101. package/package-source/docs/codex-harness-engineering/templates/docs/new-project-checklist.md +7 -7
  102. package/package-source/docs/codex-harness-engineering/templates/docs/new-project-usage.md +107 -43
  103. package/package-source/docs/codex-harness-engineering/templates/docs/project-agents-template.md +211 -154
  104. package/package-source/docs/codex-harness-engineering/templates/docs/prompt-knowledge-integration.md +100 -89
  105. package/package-source/docs/codex-harness-engineering/templates/docs/regression-rules.md +47 -45
  106. package/package-source/docs/codex-harness-engineering/templates/docs/requirement-prep-kit/README.md +3 -3
  107. package/package-source/docs/codex-harness-engineering/templates/docs/rule-governance.md +98 -98
  108. package/package-source/docs/codex-harness-engineering/templates/docs/service-dependency-matrix.md +70 -55
  109. package/package-source/docs/codex-harness-engineering/templates/docs/task-session-strategy.md +133 -116
  110. package/package-source/docs/codex-harness-engineering/templates/docs/team-knowledge-sync.md +187 -187
  111. package/package-source/docs/codex-harness-engineering/templates/docs/trace-format.md +44 -32
  112. package/package-source/docs/codex-harness-engineering/templates/governance/AGENTS.md +18 -0
  113. package/package-source/docs/codex-harness-engineering/templates/governance/branch-protection-checklist.md +50 -50
  114. package/package-source/docs/codex-harness-engineering/templates/governance/feedback-evolution-loop.md +55 -55
  115. package/package-source/docs/codex-harness-engineering/templates/governance/retry-budget.yaml +30 -30
  116. package/package-source/docs/codex-harness-engineering/templates/governance/risk-levels.yaml +53 -53
  117. package/package-source/docs/codex-harness-engineering/templates/governance/sandbox-policy.md +13 -13
  118. package/package-source/docs/codex-harness-engineering/templates/hooks/AGENTS.md +15 -0
  119. package/package-source/docs/codex-harness-engineering/templates/hooks/hook-stop-verify.ps1 +171 -118
  120. package/package-source/docs/codex-harness-engineering/templates/hooks/hooks.json +40 -40
  121. package/package-source/docs/codex-harness-engineering/templates/knowledge/AGENTS.md +16 -0
  122. package/package-source/docs/codex-harness-engineering/templates/knowledge/catalog.md +6 -6
  123. package/package-source/docs/codex-harness-engineering/templates/knowledge/decisions/DECISION-HARNESS-001.md +39 -39
  124. package/package-source/docs/codex-harness-engineering/templates/knowledge/guidelines/GUIDELINE-RULES-001.md +30 -30
  125. package/package-source/docs/codex-harness-engineering/templates/knowledge/knowledge-catalog.md +41 -41
  126. package/package-source/docs/codex-harness-engineering/templates/package-assets/.specify/templates/plan-template.md +252 -252
  127. package/package-source/docs/codex-harness-engineering/templates/package-assets/.specify/templates/spec-template.md +145 -145
  128. package/package-source/docs/codex-harness-engineering/templates/package-assets/.specify/templates/tasks-template.md +47 -47
  129. package/package-source/docs/codex-harness-engineering/templates/package-assets/AGENTS.md +19 -0
  130. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/AGENTS.md +25 -0
  131. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/README.md +118 -42
  132. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/START-HERE.md +66 -53
  133. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/agent-ecosystem-practices.md +140 -140
  134. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/best-practices.md +9 -9
  135. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/codex-global-rules-example.md +48 -48
  136. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/examples/AGENTS.md +14 -0
  137. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/examples/goal-templates.md +380 -380
  138. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/examples/ticket-filter-demo/AGENTS.md +14 -0
  139. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/examples/ticket-filter-demo/README.md +64 -64
  140. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/examples/ticket-filter-demo/contracts/openapi.yaml +25 -25
  141. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/examples/ticket-filter-demo/contracts/orval.config.ts +20 -20
  142. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/examples/ticket-filter-demo/docs/design/ai-image-brief.md +44 -44
  143. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/examples/ticket-filter-demo/docs/design/component-map.md +17 -17
  144. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/examples/ticket-filter-demo/docs/design/design-brief.md +58 -58
  145. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/examples/ticket-filter-demo/docs/design/frontend-architecture.md +106 -106
  146. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/examples/ticket-filter-demo/docs/design/image-to-frontend-spec.md +72 -72
  147. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/examples/ticket-filter-demo/docs/design/screen-states.md +25 -25
  148. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/examples/ticket-filter-demo/docs/design/ui-image-review.md +38 -38
  149. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/examples/ticket-filter-demo/docs/product/difficulty-research.md +39 -39
  150. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/examples/ticket-filter-demo/docs/product/page-inventory.md +5 -5
  151. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/examples/ticket-filter-demo/docs/product/prd-lite.md +41 -41
  152. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/examples/ticket-filter-demo/docs/product/requirement-interface-matrix.md +32 -32
  153. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/examples/ticket-filter-demo/docs/product/state-matrix.yaml +14 -14
  154. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/examples/ticket-filter-demo/packages/api-client/generated/model/Ticket.ts +6 -6
  155. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/examples/ticket-filter-demo/packages/api-client/generated/ticket-api.ts +35 -35
  156. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/examples/ticket-filter-demo/packages/api-client/http-client.ts +8 -8
  157. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/examples/ticket-filter-demo/packages/ui/TicketFilterBar.tsx +72 -72
  158. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/examples/ticket-filter-demo/plans/features/ticket-filter.dev-plan.md +48 -48
  159. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/examples/ticket-filter-demo/progress.txt +1 -1
  160. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/examples/ticket-filter-demo/stories/TicketFilterBar.stories.tsx +33 -33
  161. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/examples/ticket-filter-demo/task.json +54 -54
  162. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/examples/ticket-filter-demo/verify.ps1 +42 -42
  163. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/global-rules-and-bootstrap.md +157 -157
  164. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/goal-harness-integration-guide.md +364 -364
  165. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/implementation-flow.md +7 -5
  166. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/implementation-guide.md +25 -25
  167. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/knowledge-surface-map.md +186 -0
  168. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/mode-matrix.md +57 -57
  169. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/new-project-usage.md +176 -0
  170. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/project-agents-template.md +168 -154
  171. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/superpowers-codex-solo-builder-playbook.md +676 -676
  172. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/templates/AGENTS.md +22 -0
  173. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/templates/context/AGENTS.md +14 -0
  174. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/templates/context/API_MAP.md +18 -0
  175. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/templates/context/CURRENT_TASK.md +89 -0
  176. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/templates/context/dev-plan.md +166 -0
  177. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/templates/contracts/AGENTS.md +14 -0
  178. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/templates/contracts/README.md +24 -0
  179. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/templates/contracts/prism-usage.md +41 -0
  180. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/templates/design/AGENTS.md +14 -0
  181. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/templates/design/component-map.md +45 -31
  182. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/templates/design/design-brief.md +183 -178
  183. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/templates/design/design-tokens.json +88 -88
  184. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/templates/design/frontend-architecture.md +164 -146
  185. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/templates/design/image-to-frontend-spec.md +64 -52
  186. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/templates/design/screen-states.md +157 -122
  187. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/templates/design/visual-parity-review.md +21 -21
  188. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/templates/docs/AGENTS.md +14 -0
  189. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/templates/docs/env-and-deployment-template.md +60 -0
  190. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/templates/docs/frontend-quality-rules.md +161 -138
  191. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/templates/docs/regression-rules.md +47 -0
  192. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/templates/docs/trace-format.md +86 -0
  193. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/templates/product/AGENTS.md +14 -0
  194. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/templates/product/prd-lite.md +166 -0
  195. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/templates/product/state-matrix.yaml +116 -0
  196. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/templates/prompts/AGENTS.md +14 -0
  197. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/templates/prompts/implement-one-task.md +150 -0
  198. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/templates/prompts/repair-one-finding.md +70 -0
  199. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/templates/spec/11-security-design.md +43 -0
  200. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/templates/spec/AGENTS.md +14 -0
  201. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/templates/testing/AGENTS.md +14 -0
  202. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/templates/testing/EVIDENCE_PROTOCOL.md +54 -0
  203. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/templates/testing/NATURAL_LANGUAGE_TEST_CASES.md +690 -0
  204. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/templates/testing/REGRESSION_PLAN.md +28 -0
  205. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/templates/testing/TEST_STRATEGY.md +98 -0
  206. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/templates/testing/TRACEABILITY_MATRIX.md +23 -0
  207. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/templates/testing/verify-matrix.md +51 -0
  208. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/ecc-zh-CN/README.md +10 -10
  209. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/ecc-zh-CN/commands/e2e.md +30 -30
  210. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/external-knowledge/README.md +60 -60
  211. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/external-knowledge/app/Mobile_App_Production_Readiness_Framework_/347/247/273/345/212/250/347/253/257/345/205/250/345/271/263/345/217/260/347/224/237/344/272/247/345/217/257/344/270/212/347/272/277/350/247/204/350/214/203.md +2457 -2457
  212. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/external-knowledge/app/catalog.md +33 -33
  213. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/external-knowledge/architecture.md +358 -358
  214. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/external-knowledge/common/AI_Coding_Production_Control_Framework_AI/345/206/231/345/256/214/347/232/204/344/273/243/347/240/201/345/246/202/344/275/225/344/270/215/345/244/261/346/216/247.md +2055 -2055
  215. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/external-knowledge/common/catalog.md +34 -34
  216. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/external-knowledge/initial-content.md +296 -296
  217. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/external-knowledge/integration-roadmap.md +221 -221
  218. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/harness/architecture-constraints.md +95 -83
  219. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/harness/code-semantics-and-navigation.md +17 -0
  220. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/harness/code-style-and-naming.md +116 -0
  221. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/harness/frontend-quality-rules.md +138 -138
  222. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/harness/governance-auto-repair.md +82 -80
  223. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/harness/mcp-knowledge-governance.md +24 -0
  224. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/harness/service-dependency-matrix.md +55 -55
  225. package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/harness/speckit-requirements-gate.md +124 -124
  226. package/package-source/docs/codex-harness-engineering/templates/package-assets/root/PACKAGE.md +7 -7
  227. package/package-source/docs/codex-harness-engineering/templates/package-assets/root/README.md +52 -52
  228. package/package-source/docs/codex-harness-engineering/templates/package-assets/root/install-agent-here.ps1 +57 -57
  229. package/package-source/docs/codex-harness-engineering/templates/package-assets/rules/agents.md +115 -115
  230. package/package-source/docs/codex-harness-engineering/templates/package-assets/rules/coding-style.md +57 -74
  231. package/package-source/docs/codex-harness-engineering/templates/package-assets/rules/constitution.md +4 -4
  232. package/package-source/docs/codex-harness-engineering/templates/package-assets/rules/git.rules +41 -41
  233. package/package-source/docs/codex-harness-engineering/templates/package-assets/rules/harness.rules +29 -29
  234. package/package-source/docs/codex-harness-engineering/templates/package-assets/rules/safety.rules +35 -35
  235. package/package-source/docs/codex-harness-engineering/templates/package-assets/scripts/ai-workflow/check-ai-sync-drift.ps1 +205 -205
  236. package/package-source/docs/codex-harness-engineering/templates/package-assets/scripts/ai-workflow/sync-ai-config-to-targets.ps1 +826 -826
  237. package/package-source/docs/codex-harness-engineering/templates/package-assets/scripts/ai-workflow/sync-targets.example.json +35 -35
  238. package/package-source/docs/codex-harness-engineering/templates/package-assets/scripts/harness/harness-governance-check.ps1 +864 -366
  239. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/HOW_TO_USE_SKILLS.md +79 -79
  240. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/academic-mermaid-diagrams/SKILL.md +172 -172
  241. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/ai-config-git-sync/SKILL.md +152 -152
  242. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/ai-config-git-sync/references/command-recipes.md +92 -92
  243. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/auto-commit/SKILL.md +324 -322
  244. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/better-icons/SKILL.md +3 -3
  245. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/claude-openrouter-clash-debug/SKILL.md +100 -100
  246. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/claude-openrouter-clash-debug/references/windows-openrouter-clash-playbook.md +94 -94
  247. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/claude-openrouter-clash-debug/scripts/diagnose-openrouter-route.ps1 +282 -282
  248. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/claude-openrouter-clash-debug/scripts/ensure-openrouter-rule.ps1 +101 -101
  249. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/fixing-metadata/SKILL.md +6 -6
  250. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/frontend-design/SKILL.md +37 -37
  251. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/git-xianyu-analyzer/SKILL.md +3 -3
  252. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/harness-surface-sync/SKILL.md +204 -188
  253. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/harness-surface-sync/references/current-repo-sync-matrix.md +150 -110
  254. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/harness-surface-sync/references/stale-patterns.md +65 -65
  255. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/init-autopilot/SKILL.md +17 -15
  256. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/log-analysis-optimization/SKILL.md +5 -5
  257. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/prd-writer-skill/SKILL.md +28 -28
  258. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/qa-e2e-planner/SKILL.md +11 -11
  259. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/qa-e2e-runner/SKILL.md +6 -6
  260. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/qa-mock-cleaner/SKILL.md +4 -4
  261. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/qoder-codex-api-config/SKILL.md +67 -67
  262. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/qoder-codex-api-config/agents/openai.yaml +7 -7
  263. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/qoder-codex-api-config/scripts/configure-qoder-codex-api.ps1 +278 -278
  264. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/requirements-design-template/SKILL.md +87 -87
  265. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/skills-index.md +12 -12
  266. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/speckit-analyze/SKILL.md +34 -34
  267. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/speckit-checklist/SKILL.md +8 -8
  268. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/speckit-clarify/SKILL.md +28 -28
  269. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/speckit-e2e-tasks/SKILL.md +12 -12
  270. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/speckit-implement/SKILL.md +37 -37
  271. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/speckit-plan/SKILL.md +140 -138
  272. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/speckit-specify/SKILL.md +100 -100
  273. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/speckit-tasks/SKILL.md +86 -86
  274. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/speckit-verify/SKILL.md +144 -142
  275. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/sync-project-root-docs/SKILL.md +145 -143
  276. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/sync-project-root-docs/references/current-repo-notes.md +42 -41
  277. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/sync-project-root-docs/references/github-samples.md +33 -33
  278. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/sync-project-root-docs/scripts/collect-root-doc-facts.ps1 +174 -145
  279. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/thesis-writing/references/ai-integrity-and-originality.md +191 -191
  280. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/thesis-writing/references/citation-templates.md +99 -99
  281. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/thesis-writing/references/final-checklist.md +60 -60
  282. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/thesis-writing/references/photographer-booking-paper.md +85 -85
  283. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/thesis-writing/references/test-result-templates.md +22 -22
  284. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/thesis-writing/references/thesis-analysis-template.md +63 -63
  285. package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/update-codemaps/SKILL.md +31 -31
  286. package/package-source/docs/codex-harness-engineering/templates/package-assets/workflows/README.md +15 -15
  287. package/package-source/docs/codex-harness-engineering/templates/package-assets/workflows/speckit.analyze.md +60 -60
  288. package/package-source/docs/codex-harness-engineering/templates/package-assets/workflows/speckit.checklist.md +8 -8
  289. package/package-source/docs/codex-harness-engineering/templates/package-assets/workflows/speckit.clarify.md +28 -28
  290. package/package-source/docs/codex-harness-engineering/templates/package-assets/workflows/speckit.e2e-testing.md +10 -10
  291. package/package-source/docs/codex-harness-engineering/templates/package-assets/workflows/speckit.implement.md +56 -56
  292. package/package-source/docs/codex-harness-engineering/templates/package-assets/workflows/speckit.plan.md +137 -134
  293. package/package-source/docs/codex-harness-engineering/templates/package-assets/workflows/speckit.specify.md +100 -100
  294. package/package-source/docs/codex-harness-engineering/templates/package-assets/workflows/speckit.tasks.md +86 -86
  295. package/package-source/docs/codex-harness-engineering/templates/package-assets/workflows/speckit.verify.md +130 -130
  296. package/package-source/docs/codex-harness-engineering/templates/product/AGENTS.md +19 -0
  297. package/package-source/docs/codex-harness-engineering/templates/product/acceptance-criteria.md +47 -47
  298. package/package-source/docs/codex-harness-engineering/templates/product/difficulty-research.md +47 -47
  299. package/package-source/docs/codex-harness-engineering/templates/product/page-inventory.md +21 -21
  300. package/package-source/docs/codex-harness-engineering/templates/product/prd-lite.md +166 -158
  301. package/package-source/docs/codex-harness-engineering/templates/product/requirement-interface-matrix.md +37 -37
  302. package/package-source/docs/codex-harness-engineering/templates/product/state-matrix.yaml +116 -105
  303. package/package-source/docs/codex-harness-engineering/templates/prompts/AGENTS.md +15 -0
  304. package/package-source/docs/codex-harness-engineering/templates/prompts/controller-loop.md +88 -88
  305. package/package-source/docs/codex-harness-engineering/templates/prompts/failure-triage.md +71 -69
  306. package/package-source/docs/codex-harness-engineering/templates/prompts/harness-audit.md +54 -52
  307. package/package-source/docs/codex-harness-engineering/templates/prompts/implement-one-task.md +150 -148
  308. package/package-source/docs/codex-harness-engineering/templates/prompts/repair-one-finding.md +70 -67
  309. package/package-source/docs/codex-harness-engineering/templates/prompts/review-one-task.md +45 -43
  310. package/package-source/docs/codex-harness-engineering/templates/prompts/review-stage1-spec.md +111 -109
  311. package/package-source/docs/codex-harness-engineering/templates/prompts/review-stage2-quality.md +82 -80
  312. package/package-source/docs/codex-harness-engineering/templates/prompts/visual-evaluator.md +80 -78
  313. package/package-source/docs/codex-harness-engineering/templates/prompts/worker-role/backend-worker.md +41 -41
  314. package/package-source/docs/codex-harness-engineering/templates/prompts/worker-role/docs-worker.md +28 -28
  315. package/package-source/docs/codex-harness-engineering/templates/prompts/worker-role/frontend-worker.md +46 -46
  316. package/package-source/docs/codex-harness-engineering/templates/prompts/worker-role/harness-writer.md +40 -40
  317. package/package-source/docs/codex-harness-engineering/templates/prompts/worker-role/test-runner.md +27 -27
  318. package/package-source/docs/codex-harness-engineering/templates/runtime/AGENTS.md +66 -50
  319. package/package-source/docs/codex-harness-engineering/templates/runtime/codex-loop.ps1 +2129 -231
  320. package/package-source/docs/codex-harness-engineering/templates/runtime/doctor.ps1 +224 -224
  321. package/package-source/docs/codex-harness-engineering/templates/runtime/project-task-template.json +42 -39
  322. package/package-source/docs/codex-harness-engineering/templates/runtime/scripts/test-install-modes.ps1 +2 -2
  323. package/package-source/docs/codex-harness-engineering/templates/runtime/smoke-task.json +52 -52
  324. package/package-source/docs/codex-harness-engineering/templates/runtime/task-run-profile.json +86 -86
  325. package/package-source/docs/codex-harness-engineering/templates/runtime/task.json +11 -8
  326. package/package-source/docs/codex-harness-engineering/templates/runtime/verify.ps1 +21 -21
  327. package/package-source/docs/codex-harness-engineering/templates/scripts/AGENTS.md +15 -0
  328. package/package-source/docs/codex-harness-engineering/templates/scripts/ai-workflow/check-ai-sync-drift.ps1 +205 -205
  329. package/package-source/docs/codex-harness-engineering/templates/scripts/harness/harness-governance-check.ps1 +864 -366
  330. package/package-source/docs/codex-harness-engineering/templates/spec/10-data-model.md +23 -7
  331. package/package-source/docs/codex-harness-engineering/templates/spec/11-security-design.md +30 -13
  332. package/package-source/docs/codex-harness-engineering/templates/spec/AGENTS.md +15 -0
  333. package/package-source/docs/codex-harness-engineering/templates/testing/ACCEPTANCE_CRITERIA.md +39 -39
  334. package/package-source/docs/codex-harness-engineering/templates/testing/ACCEPTANCE_EXAMPLES.md +37 -37
  335. package/package-source/docs/codex-harness-engineering/templates/testing/AGENTS.md +19 -0
  336. package/package-source/docs/codex-harness-engineering/templates/testing/EVIDENCE_PROTOCOL.md +54 -48
  337. package/package-source/docs/codex-harness-engineering/templates/testing/NATURAL_LANGUAGE_TEST_CASES.md +5 -4
  338. package/package-source/docs/codex-harness-engineering/templates/testing/REGRESSION_PLAN.md +28 -20
  339. package/package-source/docs/codex-harness-engineering/templates/testing/RISK_BASED_TEST_PLAN.md +16 -16
  340. package/package-source/docs/codex-harness-engineering/templates/testing/TEST_STRATEGY.md +98 -97
  341. package/package-source/docs/codex-harness-engineering/templates/testing/TRACEABILITY_MATRIX.md +6 -5
  342. package/package-source/docs/codex-harness-engineering/templates/testing/coverage-policy.md +25 -25
  343. package/package-source/docs/codex-harness-engineering/templates/testing/e2e-plan.md +139 -139
  344. package/package-source/docs/codex-harness-engineering/templates/testing/failure-findings.example.json +3 -3
  345. package/package-source/docs/codex-harness-engineering/templates/testing/failure-triage.md +62 -62
  346. package/package-source/docs/codex-harness-engineering/templates/testing/test-data-plan.md +36 -36
  347. package/package-source/docs/codex-harness-engineering/templates/testing/test-report.md +85 -41
  348. package/package-source/docs/codex-harness-engineering/templates/testing/verify-matrix.md +15 -5
  349. package/package-source/docs/codex-harness-engineering/templates/tools/AGENTS.md +14 -0
  350. package/package-source/docs/codex-harness-engineering/templates/tools/harness/acceptance-lint.ps1 +37 -0
  351. package/package-source/docs/codex-harness-engineering/templates/tools/harness/architecture-lint.ps1 +150 -0
  352. package/package-source/docs/codex-harness-engineering/templates/tools/harness/backend-lint.ps1 +137 -0
  353. package/package-source/docs/codex-harness-engineering/templates/tools/harness/business-lint.ps1 +148 -0
  354. package/package-source/docs/codex-harness-engineering/templates/tools/harness/component-lint.ps1 +148 -0
  355. package/package-source/docs/codex-harness-engineering/templates/tools/harness/config-lint.ps1 +159 -0
  356. package/package-source/docs/codex-harness-engineering/templates/tools/harness/context-lint.ps1 +187 -0
  357. package/package-source/docs/codex-harness-engineering/templates/tools/harness/contract-lint.ps1 +148 -0
  358. package/package-source/docs/codex-harness-engineering/templates/tools/harness/data-lint.ps1 +37 -0
  359. package/package-source/docs/codex-harness-engineering/templates/tools/harness/directory-lint.ps1 +152 -0
  360. package/package-source/docs/codex-harness-engineering/templates/tools/harness/docs-lint.ps1 +40 -0
  361. package/package-source/docs/codex-harness-engineering/templates/tools/harness/impact-lint.ps1 +148 -0
  362. package/package-source/docs/codex-harness-engineering/templates/tools/harness/integration-lint.ps1 +37 -0
  363. package/package-source/docs/codex-harness-engineering/templates/tools/harness/mobile-lint.ps1 +37 -0
  364. package/package-source/docs/codex-harness-engineering/templates/tools/harness/observability-lint.ps1 +137 -0
  365. package/package-source/docs/codex-harness-engineering/templates/tools/harness/performance-lint.ps1 +148 -0
  366. package/package-source/docs/codex-harness-engineering/templates/tools/harness/refactor-lint.ps1 +137 -0
  367. package/package-source/docs/codex-harness-engineering/templates/tools/harness/security-lint.ps1 +159 -0
  368. package/package-source/docs/codex-harness-engineering/templates/tools/harness/session-lint.ps1 +126 -0
  369. package/package-source/docs/codex-harness-engineering/templates/tools/harness/spec-lint.ps1 +285 -0
  370. package/package-source/docs/codex-harness-engineering/templates/tools/harness/state-lint.ps1 +137 -0
  371. package/package-source/docs/codex-harness-engineering/templates/tools/harness/style-lint.ps1 +155 -0
  372. package/package-source/docs/codex-harness-engineering/templates/tools/harness/testing-lint.ps1 +192 -0
  373. package/package-source/docs/codex-harness-engineering/templates/tools/harness/ui-lint.ps1 +148 -0
  374. package/package-source/docs/codex-harness-engineering/templates/trace/AGENTS.md +16 -0
  375. package/package-source/docs/codex-harness-engineering/templates/trace/eval-case.yaml +24 -24
  376. package/package-source/docs/codex-harness-engineering/templates/trace/trace.schema.json +101 -101
  377. package/package-source/install-manifest.json +149 -79
  378. package/package-source/tools/install/ai-workflow/check-ai-sync-drift.ps1 +205 -205
  379. package/package-source/tools/install/ai-workflow/sync-ai-config-to-targets.ps1 +826 -826
  380. package/package-source/tools/install/ai-workflow/sync-targets.example.json +35 -35
  381. package/package-source/tools/install/bootstrap-codex-harness.ps1 +145 -129
  382. package/package-source/tools/install/env-check.ps1 +40 -40
  383. package/package-source/tools/install/init-project.ps1 +1 -1
  384. package/package-source/tools/install/install-agent-here.ps1 +57 -57
  385. package/package-source/tools/install/install-agent.ps1 +33 -31
  386. package/package.json +23 -23
@@ -1,20 +1,20 @@
1
- import { spawnSync } from "node:child_process";
2
-
3
- function commandExists(command) {
4
- const result = spawnSync(command, ["-NoProfile", "-Command", "$PSVersionTable.PSVersion.ToString()"], {
5
- stdio: "ignore",
6
- windowsHide: true
7
- });
8
-
9
- return result.status === 0;
10
- }
11
-
12
- export function findPowerShell() {
13
- for (const candidate of ["pwsh", "powershell"]) {
14
- if (commandExists(candidate)) {
15
- return candidate;
16
- }
17
- }
18
-
19
- return "powershell";
20
- }
1
+ import { spawnSync } from "node:child_process";
2
+
3
+ function commandExists(command) {
4
+ const result = spawnSync(command, ["-NoProfile", "-Command", "$PSVersionTable.PSVersion.ToString()"], {
5
+ stdio: "ignore",
6
+ windowsHide: true
7
+ });
8
+
9
+ return result.status === 0;
10
+ }
11
+
12
+ export function findPowerShell() {
13
+ for (const candidate of ["pwsh", "powershell"]) {
14
+ if (commandExists(candidate)) {
15
+ return candidate;
16
+ }
17
+ }
18
+
19
+ return "powershell";
20
+ }
@@ -1,34 +1,34 @@
1
- import { spawn } from "node:child_process";
2
-
3
- import { findPowerShell } from "./find-powershell.js";
4
-
5
- export function invokePowerShellScript(scriptPath, args = [], options = {}) {
6
- const powershell = findPowerShell();
7
- const commandArgs = [
8
- "-NoProfile",
9
- "-ExecutionPolicy",
10
- "Bypass",
11
- "-File",
12
- scriptPath,
13
- ...args
14
- ];
15
-
16
- return new Promise((resolve, reject) => {
17
- const child = spawn(powershell, commandArgs, {
18
- cwd: options.cwd,
19
- stdio: "inherit"
20
- });
21
-
22
- child.on("error", reject);
23
- child.on("exit", (code) => {
24
- if (code === 0) {
25
- resolve();
26
- return;
27
- }
28
-
29
- const error = new Error(`PowerShell script failed with exit code ${code}: ${scriptPath}`);
30
- error.exitCode = code || 1;
31
- reject(error);
32
- });
33
- });
34
- }
1
+ import { spawn } from "node:child_process";
2
+
3
+ import { findPowerShell } from "./find-powershell.js";
4
+
5
+ export function invokePowerShellScript(scriptPath, args = [], options = {}) {
6
+ const powershell = findPowerShell();
7
+ const commandArgs = [
8
+ "-NoProfile",
9
+ "-ExecutionPolicy",
10
+ "Bypass",
11
+ "-File",
12
+ scriptPath,
13
+ ...args
14
+ ];
15
+
16
+ return new Promise((resolve, reject) => {
17
+ const child = spawn(powershell, commandArgs, {
18
+ cwd: options.cwd,
19
+ stdio: "inherit"
20
+ });
21
+
22
+ child.on("error", reject);
23
+ child.on("exit", (code) => {
24
+ if (code === 0) {
25
+ resolve();
26
+ return;
27
+ }
28
+
29
+ const error = new Error(`PowerShell script failed with exit code ${code}: ${scriptPath}`);
30
+ error.exitCode = code || 1;
31
+ reject(error);
32
+ });
33
+ });
34
+ }
@@ -1,20 +1,20 @@
1
- import fs from "node:fs";
2
- import path from "node:path";
3
-
4
- export function assertInitialized(projectRoot) {
5
- const requiredPaths = [
6
- "tools/harness/doctor.ps1",
7
- "tools/harness/verify.ps1",
8
- "tools/harness/codex-loop.ps1",
9
- "task.json"
10
- ];
11
-
12
- for (const relativePath of requiredPaths) {
13
- const fullPath = path.join(projectRoot, relativePath);
14
- if (!fs.existsSync(fullPath)) {
15
- const error = new Error(`Project is not initialized. Missing: ${relativePath}. Run 'harness init'.`);
16
- error.exitCode = 2;
17
- throw error;
18
- }
19
- }
20
- }
1
+ import fs from "node:fs";
2
+ import path from "node:path";
3
+
4
+ export function assertInitialized(projectRoot) {
5
+ const requiredPaths = [
6
+ "tools/harness/doctor.ps1",
7
+ "tools/harness/verify.ps1",
8
+ "tools/harness/codex-loop.ps1",
9
+ "task.json"
10
+ ];
11
+
12
+ for (const relativePath of requiredPaths) {
13
+ const fullPath = path.join(projectRoot, relativePath);
14
+ if (!fs.existsSync(fullPath)) {
15
+ const error = new Error(`Project is not initialized. Missing: ${relativePath}. Run 'harness init'.`);
16
+ error.exitCode = 2;
17
+ throw error;
18
+ }
19
+ }
20
+ }
@@ -1,5 +1,5 @@
1
- import process from "node:process";
2
-
3
- export function detectProjectRoot(projectRoot) {
4
- return projectRoot || process.cwd();
5
- }
1
+ import process from "node:process";
2
+
3
+ export function detectProjectRoot(projectRoot) {
4
+ return projectRoot || process.cwd();
5
+ }
@@ -1,34 +1,34 @@
1
- import path from "node:path";
2
- import { RELEASE_MANIFEST_FILE } from "./release-manifest.js";
3
-
4
- export function getPackageCacheRoot(userProfile) {
5
- return path.win32.join(userProfile, ".codex", "packages", "codex-harness");
6
- }
7
-
8
- export function getPackageInstallRoot(userProfile, version) {
9
- return path.win32.join(getPackageCacheRoot(userProfile), version);
10
- }
11
-
12
- export function getUserPackageLockPath(userProfile) {
13
- return path.win32.join(getPackageCacheRoot(userProfile), "package.lock.json");
14
- }
15
-
16
- export function getReleaseAssetNames(version) {
17
- return {
18
- zip: `codex-harness-${version}-win.zip`,
19
- sha256: `codex-harness-${version}-win.sha256`,
20
- manifest: RELEASE_MANIFEST_FILE
21
- };
22
- }
23
-
24
- export function getDownloadedZipPath(userProfile, version) {
25
- return path.win32.join(getPackageCacheRoot(userProfile), getReleaseAssetNames(version).zip);
26
- }
27
-
28
- export function getDownloadedShaPath(userProfile, version) {
29
- return path.win32.join(getPackageCacheRoot(userProfile), getReleaseAssetNames(version).sha256);
30
- }
31
-
32
- export function getDownloadedManifestPath(userProfile, version) {
33
- return path.win32.join(getPackageCacheRoot(userProfile), `release-manifest-${version}.json`);
34
- }
1
+ import path from "node:path";
2
+ import { RELEASE_MANIFEST_FILE } from "./release-manifest.js";
3
+
4
+ export function getPackageCacheRoot(userProfile) {
5
+ return path.win32.join(userProfile, ".codex", "packages", "codex-harness");
6
+ }
7
+
8
+ export function getPackageInstallRoot(userProfile, version) {
9
+ return path.win32.join(getPackageCacheRoot(userProfile), version);
10
+ }
11
+
12
+ export function getUserPackageLockPath(userProfile) {
13
+ return path.win32.join(getPackageCacheRoot(userProfile), "package.lock.json");
14
+ }
15
+
16
+ export function getReleaseAssetNames(version) {
17
+ return {
18
+ zip: `codex-harness-${version}-win.zip`,
19
+ sha256: `codex-harness-${version}-win.sha256`,
20
+ manifest: RELEASE_MANIFEST_FILE
21
+ };
22
+ }
23
+
24
+ export function getDownloadedZipPath(userProfile, version) {
25
+ return path.win32.join(getPackageCacheRoot(userProfile), getReleaseAssetNames(version).zip);
26
+ }
27
+
28
+ export function getDownloadedShaPath(userProfile, version) {
29
+ return path.win32.join(getPackageCacheRoot(userProfile), getReleaseAssetNames(version).sha256);
30
+ }
31
+
32
+ export function getDownloadedManifestPath(userProfile, version) {
33
+ return path.win32.join(getPackageCacheRoot(userProfile), `release-manifest-${version}.json`);
34
+ }
@@ -1,25 +1,25 @@
1
- import fs from "node:fs";
2
- import path from "node:path";
3
- import { mkdir, writeFile } from "node:fs/promises";
4
-
5
- export async function downloadToFile(url, destinationPath) {
6
- const response = await fetch(url, {
7
- headers: {
8
- "User-Agent": "codex-harness-cli"
9
- },
10
- redirect: "follow"
11
- });
12
-
13
- if (!response.ok) {
14
- throw new Error(`Failed to download ${url}: ${response.status} ${response.statusText}`);
15
- }
16
-
17
- await mkdir(path.dirname(destinationPath), { recursive: true });
18
- const buffer = Buffer.from(await response.arrayBuffer());
19
- await writeFile(destinationPath, buffer);
20
- return destinationPath;
21
- }
22
-
23
- export function fileExists(pathLike) {
24
- return fs.existsSync(pathLike);
25
- }
1
+ import fs from "node:fs";
2
+ import path from "node:path";
3
+ import { mkdir, writeFile } from "node:fs/promises";
4
+
5
+ export async function downloadToFile(url, destinationPath) {
6
+ const response = await fetch(url, {
7
+ headers: {
8
+ "User-Agent": "codex-harness-cli"
9
+ },
10
+ redirect: "follow"
11
+ });
12
+
13
+ if (!response.ok) {
14
+ throw new Error(`Failed to download ${url}: ${response.status} ${response.statusText}`);
15
+ }
16
+
17
+ await mkdir(path.dirname(destinationPath), { recursive: true });
18
+ const buffer = Buffer.from(await response.arrayBuffer());
19
+ await writeFile(destinationPath, buffer);
20
+ return destinationPath;
21
+ }
22
+
23
+ export function fileExists(pathLike) {
24
+ return fs.existsSync(pathLike);
25
+ }
@@ -1,13 +1,13 @@
1
- export const RELEASE_SOURCE_ENTRIES = [
2
- "AGENTS.md",
3
- "README.md",
4
- "PACKAGE.md",
5
- "install-manifest.json",
6
- "install-manifest.schema.json",
7
- "tools/install",
8
- "docs/codex-harness-engineering/templates"
9
- ];
10
-
11
- export function shouldIncludeReleaseSource(relativePath) {
12
- return RELEASE_SOURCE_ENTRIES.includes(relativePath);
13
- }
1
+ export const RELEASE_SOURCE_ENTRIES = [
2
+ "AGENTS.md",
3
+ "README.md",
4
+ "PACKAGE.md",
5
+ "install-manifest.json",
6
+ "install-manifest.schema.json",
7
+ "tools/install",
8
+ "docs/codex-harness-engineering/templates"
9
+ ];
10
+
11
+ export function shouldIncludeReleaseSource(relativePath) {
12
+ return RELEASE_SOURCE_ENTRIES.includes(relativePath);
13
+ }
@@ -1,6 +1,6 @@
1
- export const DEFAULT_RELEASE_OWNER = "pzy560117";
2
- export const DEFAULT_RELEASE_REPO = "codex-herness-agent";
3
-
4
- export function buildReleaseAssetUrl({ owner = DEFAULT_RELEASE_OWNER, repo = DEFAULT_RELEASE_REPO, version, assetName }) {
5
- return `https://github.com/${owner}/${repo}/releases/download/v${version}/${assetName}`;
6
- }
1
+ export const DEFAULT_RELEASE_OWNER = "pzy560117";
2
+ export const DEFAULT_RELEASE_REPO = "codex-herness-agent";
3
+
4
+ export function buildReleaseAssetUrl({ owner = DEFAULT_RELEASE_OWNER, repo = DEFAULT_RELEASE_REPO, version, assetName }) {
5
+ return `https://github.com/${owner}/${repo}/releases/download/v${version}/${assetName}`;
6
+ }
@@ -1,76 +1,76 @@
1
- export const RELEASE_MANIFEST_FILE = "release-manifest.json";
2
- export const DEFAULT_RELEASE_PLATFORM = "win32-x64";
3
-
4
- export function createReleaseManifest({
5
- packageName = "codex-harness",
6
- version,
7
- zipFile,
8
- sha256File,
9
- sha256,
10
- size,
11
- releaseTag = `v${version}`,
12
- generatedAt,
13
- owner = "",
14
- repo = "",
15
- sourceCommit = ""
16
- }) {
17
- if (!version) {
18
- throw new Error("release manifest version is required.");
19
- }
20
-
21
- if (!zipFile || !sha256File || !sha256) {
22
- throw new Error("release manifest assets are incomplete.");
23
- }
24
-
25
- return {
26
- package: packageName,
27
- version,
28
- releaseTag,
29
- generatedAt: generatedAt ?? new Date().toISOString(),
30
- source: {
31
- owner,
32
- repo,
33
- commit: sourceCommit
34
- },
35
- platforms: {
36
- [DEFAULT_RELEASE_PLATFORM]: {
37
- zip: zipFile,
38
- sha256File,
39
- sha256,
40
- size
41
- }
42
- }
43
- };
44
- }
45
-
46
- export function getReleasePlatformEntry(manifest, platform = DEFAULT_RELEASE_PLATFORM) {
47
- if (!manifest || typeof manifest !== "object") {
48
- throw new Error("release manifest is missing.");
49
- }
50
-
51
- if (String(manifest.package || "").trim() !== "codex-harness") {
52
- throw new Error("release manifest package must be codex-harness.");
53
- }
54
-
55
- const version = String(manifest.version || "").trim();
56
- if (!version) {
57
- throw new Error("release manifest version is missing.");
58
- }
59
-
60
- const entry = manifest.platforms?.[platform];
61
- if (!entry) {
62
- throw new Error(`release manifest does not include platform ${platform}.`);
63
- }
64
-
65
- if (!entry.zip || !entry.sha256File || !entry.sha256) {
66
- throw new Error(`release manifest platform ${platform} is incomplete.`);
67
- }
68
-
69
- return {
70
- version,
71
- zip: entry.zip,
72
- sha256File: entry.sha256File,
73
- sha256: entry.sha256,
74
- size: entry.size ?? null
75
- };
76
- }
1
+ export const RELEASE_MANIFEST_FILE = "release-manifest.json";
2
+ export const DEFAULT_RELEASE_PLATFORM = "win32-x64";
3
+
4
+ export function createReleaseManifest({
5
+ packageName = "codex-harness",
6
+ version,
7
+ zipFile,
8
+ sha256File,
9
+ sha256,
10
+ size,
11
+ releaseTag = `v${version}`,
12
+ generatedAt,
13
+ owner = "",
14
+ repo = "",
15
+ sourceCommit = ""
16
+ }) {
17
+ if (!version) {
18
+ throw new Error("release manifest version is required.");
19
+ }
20
+
21
+ if (!zipFile || !sha256File || !sha256) {
22
+ throw new Error("release manifest assets are incomplete.");
23
+ }
24
+
25
+ return {
26
+ package: packageName,
27
+ version,
28
+ releaseTag,
29
+ generatedAt: generatedAt ?? new Date().toISOString(),
30
+ source: {
31
+ owner,
32
+ repo,
33
+ commit: sourceCommit
34
+ },
35
+ platforms: {
36
+ [DEFAULT_RELEASE_PLATFORM]: {
37
+ zip: zipFile,
38
+ sha256File,
39
+ sha256,
40
+ size
41
+ }
42
+ }
43
+ };
44
+ }
45
+
46
+ export function getReleasePlatformEntry(manifest, platform = DEFAULT_RELEASE_PLATFORM) {
47
+ if (!manifest || typeof manifest !== "object") {
48
+ throw new Error("release manifest is missing.");
49
+ }
50
+
51
+ if (String(manifest.package || "").trim() !== "codex-harness") {
52
+ throw new Error("release manifest package must be codex-harness.");
53
+ }
54
+
55
+ const version = String(manifest.version || "").trim();
56
+ if (!version) {
57
+ throw new Error("release manifest version is missing.");
58
+ }
59
+
60
+ const entry = manifest.platforms?.[platform];
61
+ if (!entry) {
62
+ throw new Error(`release manifest does not include platform ${platform}.`);
63
+ }
64
+
65
+ if (!entry.zip || !entry.sha256File || !entry.sha256) {
66
+ throw new Error(`release manifest platform ${platform} is incomplete.`);
67
+ }
68
+
69
+ return {
70
+ version,
71
+ zip: entry.zip,
72
+ sha256File: entry.sha256File,
73
+ sha256: entry.sha256,
74
+ size: entry.size ?? null
75
+ };
76
+ }
@@ -1,21 +1,21 @@
1
- import path from "node:path";
2
-
3
- export function resolvePackageSourceRoot({ packageRoot, embeddedRoot = "", cachedRoot, fsLike }) {
4
- const existsSync = fsLike?.existsSync ?? (() => false);
5
- const localScript = path.win32.join(packageRoot, "tools", "install", "install-agent.ps1");
6
- if (existsSync(localScript)) {
7
- return packageRoot;
8
- }
9
-
10
- const embeddedScript = path.win32.join(embeddedRoot, "tools", "install", "install-agent.ps1");
11
- if (embeddedRoot && existsSync(embeddedScript)) {
12
- return embeddedRoot;
13
- }
14
-
15
- const cachedScript = path.win32.join(cachedRoot, "tools", "install", "install-agent.ps1");
16
- if (existsSync(cachedScript)) {
17
- return cachedRoot;
18
- }
19
-
20
- return "";
21
- }
1
+ import path from "node:path";
2
+
3
+ export function resolvePackageSourceRoot({ packageRoot, embeddedRoot = "", cachedRoot, fsLike }) {
4
+ const existsSync = fsLike?.existsSync ?? (() => false);
5
+ const localScript = path.win32.join(packageRoot, "tools", "install", "install-agent.ps1");
6
+ if (existsSync(localScript)) {
7
+ return packageRoot;
8
+ }
9
+
10
+ const embeddedScript = path.win32.join(embeddedRoot, "tools", "install", "install-agent.ps1");
11
+ if (embeddedRoot && existsSync(embeddedScript)) {
12
+ return embeddedRoot;
13
+ }
14
+
15
+ const cachedScript = path.win32.join(cachedRoot, "tools", "install", "install-agent.ps1");
16
+ if (existsSync(cachedScript)) {
17
+ return cachedRoot;
18
+ }
19
+
20
+ return "";
21
+ }
@@ -1,26 +1,26 @@
1
- import { DEFAULT_RELEASE_OWNER, DEFAULT_RELEASE_REPO } from "./release-config.js";
2
-
3
- export async function resolveVersion(requestedVersion) {
4
- if (requestedVersion && requestedVersion !== "latest") {
5
- return requestedVersion;
6
- }
7
-
8
- const apiUrl = `https://api.github.com/repos/${DEFAULT_RELEASE_OWNER}/${DEFAULT_RELEASE_REPO}/releases/latest`;
9
- const response = await fetch(apiUrl, {
10
- headers: {
11
- "User-Agent": "codex-harness-cli"
12
- }
13
- });
14
-
15
- if (!response.ok) {
16
- throw new Error(`Failed to resolve latest release version: ${response.status} ${response.statusText}`);
17
- }
18
-
19
- const json = await response.json();
20
- const tag = String(json.tag_name || "").trim();
21
- if (!tag) {
22
- throw new Error("Latest release did not include tag_name.");
23
- }
24
-
25
- return tag.startsWith("v") ? tag.slice(1) : tag;
26
- }
1
+ import { DEFAULT_RELEASE_OWNER, DEFAULT_RELEASE_REPO } from "./release-config.js";
2
+
3
+ export async function resolveVersion(requestedVersion) {
4
+ if (requestedVersion && requestedVersion !== "latest") {
5
+ return requestedVersion;
6
+ }
7
+
8
+ const apiUrl = `https://api.github.com/repos/${DEFAULT_RELEASE_OWNER}/${DEFAULT_RELEASE_REPO}/releases/latest`;
9
+ const response = await fetch(apiUrl, {
10
+ headers: {
11
+ "User-Agent": "codex-harness-cli"
12
+ }
13
+ });
14
+
15
+ if (!response.ok) {
16
+ throw new Error(`Failed to resolve latest release version: ${response.status} ${response.statusText}`);
17
+ }
18
+
19
+ const json = await response.json();
20
+ const tag = String(json.tag_name || "").trim();
21
+ if (!tag) {
22
+ throw new Error("Latest release did not include tag_name.");
23
+ }
24
+
25
+ return tag.startsWith("v") ? tag.slice(1) : tag;
26
+ }
@@ -1,25 +1,25 @@
1
- import fs from "node:fs";
2
- import path from "node:path";
3
-
4
- import { invokePowerShellScript } from "../powershell/invoke-script.js";
5
-
6
- export async function unpackZip(zipPath, destinationRoot) {
7
- if (!fs.existsSync(destinationRoot)) {
8
- fs.mkdirSync(destinationRoot, { recursive: true });
9
- }
10
-
11
- const scriptPath = path.join(destinationRoot, "__expand-archive.ps1");
12
- fs.writeFileSync(
13
- scriptPath,
14
- `Expand-Archive -LiteralPath '${zipPath.replace(/'/g, "''")}' -DestinationPath '${destinationRoot.replace(/'/g, "''")}' -Force`,
15
- "utf8"
16
- );
17
-
18
- try {
19
- await invokePowerShellScript(scriptPath, [], { cwd: destinationRoot });
20
- } finally {
21
- if (fs.existsSync(scriptPath)) {
22
- fs.unlinkSync(scriptPath);
23
- }
24
- }
25
- }
1
+ import fs from "node:fs";
2
+ import path from "node:path";
3
+
4
+ import { invokePowerShellScript } from "../powershell/invoke-script.js";
5
+
6
+ export async function unpackZip(zipPath, destinationRoot) {
7
+ if (!fs.existsSync(destinationRoot)) {
8
+ fs.mkdirSync(destinationRoot, { recursive: true });
9
+ }
10
+
11
+ const scriptPath = path.join(destinationRoot, "__expand-archive.ps1");
12
+ fs.writeFileSync(
13
+ scriptPath,
14
+ `Expand-Archive -LiteralPath '${zipPath.replace(/'/g, "''")}' -DestinationPath '${destinationRoot.replace(/'/g, "''")}' -Force`,
15
+ "utf8"
16
+ );
17
+
18
+ try {
19
+ await invokePowerShellScript(scriptPath, [], { cwd: destinationRoot });
20
+ } finally {
21
+ if (fs.existsSync(scriptPath)) {
22
+ fs.unlinkSync(scriptPath);
23
+ }
24
+ }
25
+ }
@@ -1,16 +1,16 @@
1
- import crypto from "node:crypto";
2
- import fs from "node:fs/promises";
3
-
4
- export async function verifyFileSha256(filePath, shaFilePath, expectedSha256 = "") {
5
- const fileBuffer = await fs.readFile(filePath);
6
- const expected = (await fs.readFile(shaFilePath, "utf8")).trim().split(/\s+/)[0];
7
- const actual = crypto.createHash("sha256").update(fileBuffer).digest("hex");
8
-
9
- if (expected.toLowerCase() !== actual.toLowerCase()) {
10
- throw new Error(`SHA256 mismatch for ${filePath}`);
11
- }
12
-
13
- if (expectedSha256 && expectedSha256.toLowerCase() !== actual.toLowerCase()) {
14
- throw new Error(`Release manifest SHA256 mismatch for ${filePath}`);
15
- }
16
- }
1
+ import crypto from "node:crypto";
2
+ import fs from "node:fs/promises";
3
+
4
+ export async function verifyFileSha256(filePath, shaFilePath, expectedSha256 = "") {
5
+ const fileBuffer = await fs.readFile(filePath);
6
+ const expected = (await fs.readFile(shaFilePath, "utf8")).trim().split(/\s+/)[0];
7
+ const actual = crypto.createHash("sha256").update(fileBuffer).digest("hex");
8
+
9
+ if (expected.toLowerCase() !== actual.toLowerCase()) {
10
+ throw new Error(`SHA256 mismatch for ${filePath}`);
11
+ }
12
+
13
+ if (expectedSha256 && expectedSha256.toLowerCase() !== actual.toLowerCase()) {
14
+ throw new Error(`Release manifest SHA256 mismatch for ${filePath}`);
15
+ }
16
+ }