@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,282 +1,282 @@
1
- param(
2
- [string]$ClaudeSettingsPath = "C:\Users\pzy666\.claude\settings.json",
3
- [string]$ClashProfilesPath = "C:\Users\pzy666\AppData\Roaming\io.github.clash-verge-rev.clash-verge-rev\profiles.yaml",
4
- [string]$ClashConfigPath = "C:\Users\pzy666\AppData\Roaming\io.github.clash-verge-rev.clash-verge-rev\clash-verge.yaml",
5
- [string]$HysteriaConfigPath = "C:\Users\pzy666\AppData\Roaming\hysteria\config-jp.yaml",
6
- [string]$MixedProxy = "http://127.0.0.1:7897",
7
- [string]$SocksProxy = "127.0.0.1:1082",
8
- [string]$Model = "anthropic/claude-sonnet-4.6",
9
- [switch]$SkipApiProbe
10
- )
11
-
12
- Set-StrictMode -Version Latest
13
- $ErrorActionPreference = "Stop"
14
-
15
- function Get-JsonProbe {
16
- param(
17
- [string]$Uri,
18
- [ValidateSet("direct", "proxy", "socks5")]
19
- [string]$Mode = "direct",
20
- [string]$Proxy
21
- )
22
-
23
- $args = @("-sS")
24
- switch ($Mode) {
25
- "proxy" {
26
- if ($Proxy) {
27
- $args += @("--proxy", $Proxy)
28
- }
29
- }
30
- "socks5" {
31
- if ($Proxy) {
32
- $args += @("--socks5-hostname", $Proxy)
33
- }
34
- }
35
- }
36
- $args += $Uri
37
-
38
- try {
39
- $raw = & curl.exe @args 2>$null
40
- if (-not $raw) {
41
- return $null
42
- }
43
- return $raw | ConvertFrom-Json
44
- } catch {
45
- return [pscustomobject]@{
46
- error = $_.Exception.Message
47
- mode = $Mode
48
- proxy = $Proxy
49
- }
50
- }
51
- }
52
-
53
- function Invoke-OpenRouterProbe {
54
- param(
55
- [ValidateSet("proxy", "socks5")]
56
- [string]$Mode,
57
- [string]$Proxy,
58
- [string]$Token,
59
- [string]$ModelId
60
- )
61
-
62
- if (-not $Token) {
63
- return [pscustomobject]@{
64
- mode = $Mode
65
- proxy = $Proxy
66
- skipped = $true
67
- reason = "Missing OpenRouter token"
68
- }
69
- }
70
-
71
- $headersFile = New-TemporaryFile
72
- $bodyFile = New-TemporaryFile
73
- $payloadFile = New-TemporaryFile
74
-
75
- try {
76
- @{
77
- model = $ModelId
78
- messages = @(
79
- @{
80
- role = "user"
81
- content = "Reply with ok."
82
- }
83
- )
84
- max_tokens = 8
85
- } | ConvertTo-Json -Depth 6 | Set-Content -NoNewline $payloadFile
86
-
87
- $args = @("-sS")
88
- switch ($Mode) {
89
- "proxy" { $args += @("--proxy", $Proxy) }
90
- "socks5" { $args += @("--socks5-hostname", $Proxy) }
91
- }
92
- $args += @(
93
- "-o", $bodyFile,
94
- "-D", $headersFile,
95
- "-X", "POST",
96
- "https://openrouter.ai/api/v1/chat/completions",
97
- "-H", "Authorization: Bearer $Token",
98
- "-H", "Content-Type: application/json",
99
- "--data-binary", "@$payloadFile"
100
- )
101
-
102
- & curl.exe @args | Out-Null
103
-
104
- $headers = Get-Content -Raw $headersFile
105
- $bodyText = Get-Content -Raw $bodyFile
106
- $statusMatches = [regex]::Matches($headers, "HTTP/\d(?:\.\d)?\s+(\d{3})")
107
- $statusCode = if ($statusMatches.Count -gt 0) {
108
- [int]$statusMatches[$statusMatches.Count - 1].Groups[1].Value
109
- } else {
110
- $null
111
- }
112
- $cfRayMatch = [regex]::Match($headers, "(?im)^CF-RAY:\s*([^\r\n]+)")
113
- $cfRay = if ($cfRayMatch.Success) { $cfRayMatch.Groups[1].Value.Trim() } else { $null }
114
-
115
- $bodyJson = $null
116
- try {
117
- $bodyJson = $bodyText | ConvertFrom-Json
118
- } catch {
119
- $bodyJson = $bodyText.Trim()
120
- }
121
-
122
- return [pscustomobject]@{
123
- mode = $Mode
124
- proxy = $Proxy
125
- statusCode = $statusCode
126
- cfRay = $cfRay
127
- body = $bodyJson
128
- }
129
- } catch {
130
- return [pscustomobject]@{
131
- mode = $Mode
132
- proxy = $Proxy
133
- error = $_.Exception.Message
134
- }
135
- } finally {
136
- Remove-Item $headersFile, $bodyFile, $payloadFile -Force -ErrorAction SilentlyContinue
137
- }
138
- }
139
-
140
- function Get-SelectedGroup {
141
- param(
142
- [string]$Path,
143
- [string]$GroupName
144
- )
145
-
146
- if (-not (Test-Path $Path)) {
147
- return $null
148
- }
149
-
150
- $content = Get-Content -Raw $Path
151
- $pattern = "(?ms)- name:\s*" + [regex]::Escape($GroupName) + "\s*\r?\n\s*now:\s*(.+?)\r?$"
152
- $match = [regex]::Match($content, $pattern)
153
- if ($match.Success) {
154
- return $match.Groups[1].Value.Trim()
155
- }
156
-
157
- return $null
158
- }
159
-
160
- function Get-HysteriaFacts {
161
- param([string]$Path)
162
-
163
- if (-not (Test-Path $Path)) {
164
- return $null
165
- }
166
-
167
- $content = Get-Content -Raw $Path
168
- $serverMatch = [regex]::Match($content, "(?m)^server:\s*(.+)$")
169
- $socksMatch = [regex]::Match($content, "(?m)^\s*listen:\s*([0-9\.]+:\d+)$")
170
-
171
- return [pscustomobject]@{
172
- configPath = $Path
173
- server = if ($serverMatch.Success) { $serverMatch.Groups[1].Value.Trim() } else { $null }
174
- socksListen = if ($socksMatch.Success) { $socksMatch.Groups[1].Value.Trim() } else { $null }
175
- }
176
- }
177
-
178
- $settings = $null
179
- if (Test-Path $ClaudeSettingsPath) {
180
- $settings = Get-Content -Raw $ClaudeSettingsPath | ConvertFrom-Json
181
- }
182
-
183
- $openRouterToken = $null
184
- if ($settings -and $settings.env) {
185
- if ($settings.env.ANTHROPIC_AUTH_TOKEN) {
186
- $openRouterToken = [string]$settings.env.ANTHROPIC_AUTH_TOKEN
187
- } elseif ($settings.env.ANTHROPIC_API_KEY) {
188
- $openRouterToken = [string]$settings.env.ANTHROPIC_API_KEY
189
- }
190
- }
191
-
192
- $claudeAuth = $null
193
- try {
194
- $claudeAuth = (& claude auth status 2>$null) | ConvertFrom-Json
195
- } catch {
196
- $claudeAuth = [pscustomobject]@{
197
- error = $_.Exception.Message
198
- }
199
- }
200
-
201
- $geoDirect = Get-JsonProbe -Uri "https://ipinfo.io/json" -Mode "direct"
202
- $geoMixed = Get-JsonProbe -Uri "https://ipinfo.io/json" -Mode "proxy" -Proxy $MixedProxy
203
- $geoSocks = Get-JsonProbe -Uri "https://ipinfo.io/json" -Mode "socks5" -Proxy $SocksProxy
204
-
205
- $openrouterRulePresent = $false
206
- if (Test-Path $ClashConfigPath) {
207
- $openrouterRulePresent = (Get-Content -Raw $ClashConfigPath) -match "DOMAIN-SUFFIX,openrouter\.ai,"
208
- }
209
-
210
- $apiMixed = $null
211
- $apiSocks = $null
212
- if (-not $SkipApiProbe) {
213
- $apiMixed = Invoke-OpenRouterProbe -Mode "proxy" -Proxy $MixedProxy -Token $openRouterToken -ModelId $Model
214
- $apiSocks = Invoke-OpenRouterProbe -Mode "socks5" -Proxy $SocksProxy -Token $openRouterToken -ModelId $Model
215
- }
216
-
217
- $findings = New-Object System.Collections.Generic.List[string]
218
-
219
- if ($settings -and $settings.env.ANTHROPIC_BASE_URL -eq "https://openrouter.ai/api") {
220
- if (-not $settings.env.ANTHROPIC_AUTH_TOKEN) {
221
- $findings.Add("OpenRouter base URL is set but ANTHROPIC_AUTH_TOKEN is missing.")
222
- }
223
- if ($settings.env.ANTHROPIC_API_KEY) {
224
- $findings.Add("ANTHROPIC_API_KEY is still populated. Prefer ANTHROPIC_AUTH_TOKEN and blank ANTHROPIC_API_KEY for this OpenRouter path.")
225
- }
226
- }
227
-
228
- if ($geoMixed -and $geoSocks -and $geoMixed.country -and $geoSocks.country -and $geoMixed.country -ne $geoSocks.country) {
229
- if (-not $openrouterRulePresent) {
230
- $findings.Add("Clash mixed-port egress differs from the dedicated SOCKS node and openrouter.ai has no explicit rule. Expect region mismatch failures.")
231
- } else {
232
- $findings.Add("Generic Clash mixed-port egress differs from the dedicated SOCKS node. This is acceptable only when openrouter.ai has an explicit rule to the intended AI group.")
233
- }
234
- }
235
-
236
- if (-not $openrouterRulePresent) {
237
- $findings.Add("openrouter.ai has no explicit Clash rule and may be falling through to MATCH.")
238
- }
239
-
240
- if ($apiMixed -and $apiMixed.statusCode -eq 403 -and $apiSocks -and $apiSocks.statusCode -eq 200) {
241
- $findings.Add("OpenRouter works through the dedicated SOCKS node but fails through Clash mixed-port. Fix the Clash rule or selected group.")
242
- }
243
-
244
- if ($apiMixed -and $apiMixed.statusCode -eq 200) {
245
- $findings.Add("OpenRouter probe through Clash mixed-port is healthy.")
246
- }
247
-
248
- $result = [pscustomobject]@{
249
- timestamp = (Get-Date).ToString("s")
250
- claudeSettings = [pscustomobject]@{
251
- path = $ClaudeSettingsPath
252
- anthropicBaseUrl = if ($settings) { $settings.env.ANTHROPIC_BASE_URL } else { $null }
253
- anthropicModel = if ($settings) { $settings.env.ANTHROPIC_MODEL } else { $null }
254
- hasAuthToken = if ($settings -and $settings.env.ANTHROPIC_AUTH_TOKEN) { $true } else { $false }
255
- apiKeyBlank = if ($settings -and $settings.env.ANTHROPIC_API_KEY -eq "") { $true } else { $false }
256
- }
257
- claudeAuthStatus = $claudeAuth
258
- selectedGroups = [pscustomobject]@{
259
- aiGithubHy2 = Get-SelectedGroup -Path $ClashProfilesPath -GroupName "AI-GitHub-HY2"
260
- chatgpt = Get-SelectedGroup -Path $ClashProfilesPath -GroupName "๐Ÿ”ฅChatGPT"
261
- defaultGroup = Get-SelectedGroup -Path $ClashProfilesPath -GroupName "็‹—็‹—ๅŠ ้€Ÿ.com"
262
- }
263
- clash = [pscustomobject]@{
264
- profilesPath = $ClashProfilesPath
265
- configPath = $ClashConfigPath
266
- mixedProxy = $MixedProxy
267
- openrouterRulePresent = $openrouterRulePresent
268
- }
269
- hysteria = Get-HysteriaFacts -Path $HysteriaConfigPath
270
- geolocation = [pscustomobject]@{
271
- direct = $geoDirect
272
- mixedProxy = $geoMixed
273
- dedicatedSocks = $geoSocks
274
- }
275
- openrouterProbe = [pscustomobject]@{
276
- mixedProxy = $apiMixed
277
- dedicatedSocks = $apiSocks
278
- }
279
- findings = $findings
280
- }
281
-
282
- $result | ConvertTo-Json -Depth 8
1
+ param(
2
+ [string]$ClaudeSettingsPath = "C:\Users\pzy666\.claude\settings.json",
3
+ [string]$ClashProfilesPath = "C:\Users\pzy666\AppData\Roaming\io.github.clash-verge-rev.clash-verge-rev\profiles.yaml",
4
+ [string]$ClashConfigPath = "C:\Users\pzy666\AppData\Roaming\io.github.clash-verge-rev.clash-verge-rev\clash-verge.yaml",
5
+ [string]$HysteriaConfigPath = "C:\Users\pzy666\AppData\Roaming\hysteria\config-jp.yaml",
6
+ [string]$MixedProxy = "http://127.0.0.1:7897",
7
+ [string]$SocksProxy = "127.0.0.1:1082",
8
+ [string]$Model = "anthropic/claude-sonnet-4.6",
9
+ [switch]$SkipApiProbe
10
+ )
11
+
12
+ Set-StrictMode -Version Latest
13
+ $ErrorActionPreference = "Stop"
14
+
15
+ function Get-JsonProbe {
16
+ param(
17
+ [string]$Uri,
18
+ [ValidateSet("direct", "proxy", "socks5")]
19
+ [string]$Mode = "direct",
20
+ [string]$Proxy
21
+ )
22
+
23
+ $args = @("-sS")
24
+ switch ($Mode) {
25
+ "proxy" {
26
+ if ($Proxy) {
27
+ $args += @("--proxy", $Proxy)
28
+ }
29
+ }
30
+ "socks5" {
31
+ if ($Proxy) {
32
+ $args += @("--socks5-hostname", $Proxy)
33
+ }
34
+ }
35
+ }
36
+ $args += $Uri
37
+
38
+ try {
39
+ $raw = & curl.exe @args 2>$null
40
+ if (-not $raw) {
41
+ return $null
42
+ }
43
+ return $raw | ConvertFrom-Json
44
+ } catch {
45
+ return [pscustomobject]@{
46
+ error = $_.Exception.Message
47
+ mode = $Mode
48
+ proxy = $Proxy
49
+ }
50
+ }
51
+ }
52
+
53
+ function Invoke-OpenRouterProbe {
54
+ param(
55
+ [ValidateSet("proxy", "socks5")]
56
+ [string]$Mode,
57
+ [string]$Proxy,
58
+ [string]$Token,
59
+ [string]$ModelId
60
+ )
61
+
62
+ if (-not $Token) {
63
+ return [pscustomobject]@{
64
+ mode = $Mode
65
+ proxy = $Proxy
66
+ skipped = $true
67
+ reason = "Missing OpenRouter token"
68
+ }
69
+ }
70
+
71
+ $headersFile = New-TemporaryFile
72
+ $bodyFile = New-TemporaryFile
73
+ $payloadFile = New-TemporaryFile
74
+
75
+ try {
76
+ @{
77
+ model = $ModelId
78
+ messages = @(
79
+ @{
80
+ role = "user"
81
+ content = "Reply with ok."
82
+ }
83
+ )
84
+ max_tokens = 8
85
+ } | ConvertTo-Json -Depth 6 | Set-Content -NoNewline $payloadFile
86
+
87
+ $args = @("-sS")
88
+ switch ($Mode) {
89
+ "proxy" { $args += @("--proxy", $Proxy) }
90
+ "socks5" { $args += @("--socks5-hostname", $Proxy) }
91
+ }
92
+ $args += @(
93
+ "-o", $bodyFile,
94
+ "-D", $headersFile,
95
+ "-X", "POST",
96
+ "https://openrouter.ai/api/v1/chat/completions",
97
+ "-H", "Authorization: Bearer $Token",
98
+ "-H", "Content-Type: application/json",
99
+ "--data-binary", "@$payloadFile"
100
+ )
101
+
102
+ & curl.exe @args | Out-Null
103
+
104
+ $headers = Get-Content -Raw $headersFile
105
+ $bodyText = Get-Content -Raw $bodyFile
106
+ $statusMatches = [regex]::Matches($headers, "HTTP/\d(?:\.\d)?\s+(\d{3})")
107
+ $statusCode = if ($statusMatches.Count -gt 0) {
108
+ [int]$statusMatches[$statusMatches.Count - 1].Groups[1].Value
109
+ } else {
110
+ $null
111
+ }
112
+ $cfRayMatch = [regex]::Match($headers, "(?im)^CF-RAY:\s*([^\r\n]+)")
113
+ $cfRay = if ($cfRayMatch.Success) { $cfRayMatch.Groups[1].Value.Trim() } else { $null }
114
+
115
+ $bodyJson = $null
116
+ try {
117
+ $bodyJson = $bodyText | ConvertFrom-Json
118
+ } catch {
119
+ $bodyJson = $bodyText.Trim()
120
+ }
121
+
122
+ return [pscustomobject]@{
123
+ mode = $Mode
124
+ proxy = $Proxy
125
+ statusCode = $statusCode
126
+ cfRay = $cfRay
127
+ body = $bodyJson
128
+ }
129
+ } catch {
130
+ return [pscustomobject]@{
131
+ mode = $Mode
132
+ proxy = $Proxy
133
+ error = $_.Exception.Message
134
+ }
135
+ } finally {
136
+ Remove-Item $headersFile, $bodyFile, $payloadFile -Force -ErrorAction SilentlyContinue
137
+ }
138
+ }
139
+
140
+ function Get-SelectedGroup {
141
+ param(
142
+ [string]$Path,
143
+ [string]$GroupName
144
+ )
145
+
146
+ if (-not (Test-Path $Path)) {
147
+ return $null
148
+ }
149
+
150
+ $content = Get-Content -Raw $Path
151
+ $pattern = "(?ms)- name:\s*" + [regex]::Escape($GroupName) + "\s*\r?\n\s*now:\s*(.+?)\r?$"
152
+ $match = [regex]::Match($content, $pattern)
153
+ if ($match.Success) {
154
+ return $match.Groups[1].Value.Trim()
155
+ }
156
+
157
+ return $null
158
+ }
159
+
160
+ function Get-HysteriaFacts {
161
+ param([string]$Path)
162
+
163
+ if (-not (Test-Path $Path)) {
164
+ return $null
165
+ }
166
+
167
+ $content = Get-Content -Raw $Path
168
+ $serverMatch = [regex]::Match($content, "(?m)^server:\s*(.+)$")
169
+ $socksMatch = [regex]::Match($content, "(?m)^\s*listen:\s*([0-9\.]+:\d+)$")
170
+
171
+ return [pscustomobject]@{
172
+ configPath = $Path
173
+ server = if ($serverMatch.Success) { $serverMatch.Groups[1].Value.Trim() } else { $null }
174
+ socksListen = if ($socksMatch.Success) { $socksMatch.Groups[1].Value.Trim() } else { $null }
175
+ }
176
+ }
177
+
178
+ $settings = $null
179
+ if (Test-Path $ClaudeSettingsPath) {
180
+ $settings = Get-Content -Raw $ClaudeSettingsPath | ConvertFrom-Json
181
+ }
182
+
183
+ $openRouterToken = $null
184
+ if ($settings -and $settings.env) {
185
+ if ($settings.env.ANTHROPIC_AUTH_TOKEN) {
186
+ $openRouterToken = [string]$settings.env.ANTHROPIC_AUTH_TOKEN
187
+ } elseif ($settings.env.ANTHROPIC_API_KEY) {
188
+ $openRouterToken = [string]$settings.env.ANTHROPIC_API_KEY
189
+ }
190
+ }
191
+
192
+ $claudeAuth = $null
193
+ try {
194
+ $claudeAuth = (& claude auth status 2>$null) | ConvertFrom-Json
195
+ } catch {
196
+ $claudeAuth = [pscustomobject]@{
197
+ error = $_.Exception.Message
198
+ }
199
+ }
200
+
201
+ $geoDirect = Get-JsonProbe -Uri "https://ipinfo.io/json" -Mode "direct"
202
+ $geoMixed = Get-JsonProbe -Uri "https://ipinfo.io/json" -Mode "proxy" -Proxy $MixedProxy
203
+ $geoSocks = Get-JsonProbe -Uri "https://ipinfo.io/json" -Mode "socks5" -Proxy $SocksProxy
204
+
205
+ $openrouterRulePresent = $false
206
+ if (Test-Path $ClashConfigPath) {
207
+ $openrouterRulePresent = (Get-Content -Raw $ClashConfigPath) -match "DOMAIN-SUFFIX,openrouter\.ai,"
208
+ }
209
+
210
+ $apiMixed = $null
211
+ $apiSocks = $null
212
+ if (-not $SkipApiProbe) {
213
+ $apiMixed = Invoke-OpenRouterProbe -Mode "proxy" -Proxy $MixedProxy -Token $openRouterToken -ModelId $Model
214
+ $apiSocks = Invoke-OpenRouterProbe -Mode "socks5" -Proxy $SocksProxy -Token $openRouterToken -ModelId $Model
215
+ }
216
+
217
+ $findings = New-Object System.Collections.Generic.List[string]
218
+
219
+ if ($settings -and $settings.env.ANTHROPIC_BASE_URL -eq "https://openrouter.ai/api") {
220
+ if (-not $settings.env.ANTHROPIC_AUTH_TOKEN) {
221
+ $findings.Add("OpenRouter base URL is set but ANTHROPIC_AUTH_TOKEN is missing.")
222
+ }
223
+ if ($settings.env.ANTHROPIC_API_KEY) {
224
+ $findings.Add("ANTHROPIC_API_KEY is still populated. Prefer ANTHROPIC_AUTH_TOKEN and blank ANTHROPIC_API_KEY for this OpenRouter path.")
225
+ }
226
+ }
227
+
228
+ if ($geoMixed -and $geoSocks -and $geoMixed.country -and $geoSocks.country -and $geoMixed.country -ne $geoSocks.country) {
229
+ if (-not $openrouterRulePresent) {
230
+ $findings.Add("Clash mixed-port egress differs from the dedicated SOCKS node and openrouter.ai has no explicit rule. Expect region mismatch failures.")
231
+ } else {
232
+ $findings.Add("Generic Clash mixed-port egress differs from the dedicated SOCKS node. This is acceptable only when openrouter.ai has an explicit rule to the intended AI group.")
233
+ }
234
+ }
235
+
236
+ if (-not $openrouterRulePresent) {
237
+ $findings.Add("openrouter.ai has no explicit Clash rule and may be falling through to MATCH.")
238
+ }
239
+
240
+ if ($apiMixed -and $apiMixed.statusCode -eq 403 -and $apiSocks -and $apiSocks.statusCode -eq 200) {
241
+ $findings.Add("OpenRouter works through the dedicated SOCKS node but fails through Clash mixed-port. Fix the Clash rule or selected group.")
242
+ }
243
+
244
+ if ($apiMixed -and $apiMixed.statusCode -eq 200) {
245
+ $findings.Add("OpenRouter probe through Clash mixed-port is healthy.")
246
+ }
247
+
248
+ $result = [pscustomobject]@{
249
+ timestamp = (Get-Date).ToString("s")
250
+ claudeSettings = [pscustomobject]@{
251
+ path = $ClaudeSettingsPath
252
+ anthropicBaseUrl = if ($settings) { $settings.env.ANTHROPIC_BASE_URL } else { $null }
253
+ anthropicModel = if ($settings) { $settings.env.ANTHROPIC_MODEL } else { $null }
254
+ hasAuthToken = if ($settings -and $settings.env.ANTHROPIC_AUTH_TOKEN) { $true } else { $false }
255
+ apiKeyBlank = if ($settings -and $settings.env.ANTHROPIC_API_KEY -eq "") { $true } else { $false }
256
+ }
257
+ claudeAuthStatus = $claudeAuth
258
+ selectedGroups = [pscustomobject]@{
259
+ aiGithubHy2 = Get-SelectedGroup -Path $ClashProfilesPath -GroupName "AI-GitHub-HY2"
260
+ chatgpt = Get-SelectedGroup -Path $ClashProfilesPath -GroupName "๐Ÿ”ฅChatGPT"
261
+ defaultGroup = Get-SelectedGroup -Path $ClashProfilesPath -GroupName "็‹—็‹—ๅŠ ้€Ÿ.com"
262
+ }
263
+ clash = [pscustomobject]@{
264
+ profilesPath = $ClashProfilesPath
265
+ configPath = $ClashConfigPath
266
+ mixedProxy = $MixedProxy
267
+ openrouterRulePresent = $openrouterRulePresent
268
+ }
269
+ hysteria = Get-HysteriaFacts -Path $HysteriaConfigPath
270
+ geolocation = [pscustomobject]@{
271
+ direct = $geoDirect
272
+ mixedProxy = $geoMixed
273
+ dedicatedSocks = $geoSocks
274
+ }
275
+ openrouterProbe = [pscustomobject]@{
276
+ mixedProxy = $apiMixed
277
+ dedicatedSocks = $apiSocks
278
+ }
279
+ findings = $findings
280
+ }
281
+
282
+ $result | ConvertTo-Json -Depth 8