@gong-ym/ai-spec-auto 0.2.3

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 (640) hide show
  1. package/.agents/commands/README.md +33 -0
  2. package/.agents/commands/claude/spec-start-review.md +88 -0
  3. package/.agents/commands/codex/spec-continue.md +74 -0
  4. package/.agents/commands/codex/spec-orchestrate.md +35 -0
  5. package/.agents/commands/codex/spec-start-review.md +88 -0
  6. package/.agents/commands/codex/spec-start.md +67 -0
  7. package/.agents/commands/codex/spec-status.md +22 -0
  8. package/.agents/commands/codex/spec-stop.md +29 -0
  9. package/.agents/commands/codex/spec-update.md +40 -0
  10. package/.agents/commands/common/branch-review.md +117 -0
  11. package/.agents/commands/common/project-init.md +25 -0
  12. package/.agents/commands/common/spec-continue.md +74 -0
  13. package/.agents/commands/common/spec-orchestrate.md +35 -0
  14. package/.agents/commands/common/spec-start-review.md +82 -0
  15. package/.agents/commands/common/spec-start.md +67 -0
  16. package/.agents/commands/common/spec-status.md +22 -0
  17. package/.agents/commands/common/spec-stop.md +29 -0
  18. package/.agents/commands/common/spec-update.md +40 -0
  19. package/.agents/commands/cursor/opsx-apply.md +55 -0
  20. package/.agents/commands/cursor/opsx-archive.md +48 -0
  21. package/.agents/commands/cursor/opsx-explore.md +45 -0
  22. package/.agents/commands/cursor/opsx-propose.md +59 -0
  23. package/.agents/commands/cursor/spec-continue.md +63 -0
  24. package/.agents/commands/cursor/spec-orchestrate.md +53 -0
  25. package/.agents/commands/cursor/spec-start-review.md +78 -0
  26. package/.agents/commands/cursor/spec-start.md +59 -0
  27. package/.agents/commands/cursor/spec-status.md +30 -0
  28. package/.agents/commands/cursor/spec-stop.md +29 -0
  29. package/.agents/commands/cursor/spec-update.md +41 -0
  30. package/.agents/flows/FRONTMATTER.md +263 -0
  31. package/.agents/flows/RUN_OUTPUT.md +263 -0
  32. package/.agents/flows/common/README.md +29 -0
  33. package/.agents/flows/common/bugfix-to-verification.md +95 -0
  34. package/.agents/flows/common/change-to-architecture-review.md +89 -0
  35. package/.agents/flows/common/change-to-release.md +94 -0
  36. package/.agents/flows/common/prd-to-delivery.md +184 -0
  37. package/.agents/flows/common/requirement-to-observability.md +97 -0
  38. package/.agents/orchestration/README.md +22 -0
  39. package/.agents/orchestration/expert-dispatch-spec.md +155 -0
  40. package/.agents/orchestration/expert-executor-spec.md +84 -0
  41. package/.agents/orchestration/expert-runtime-action-spec.md +73 -0
  42. package/.agents/orchestration/runtime-state-handoff-spec.md +264 -0
  43. package/.agents/orchestration/task-anchor-spec.md +212 -0
  44. package/.agents/orchestration/task-orchestrator-adapter-payload.md +153 -0
  45. package/.agents/orchestration/task-orchestrator-bootstrap-payload.md +145 -0
  46. package/.agents/orchestration/task-orchestrator-output-extractor-spec.md +93 -0
  47. package/.agents/orchestration/task-orchestrator-run-plan-template.md +312 -0
  48. package/.agents/orchestration/task-orchestrator-runtime-hooks.md +214 -0
  49. package/.agents/registry/README.md +63 -0
  50. package/.agents/registry/flows.json +125 -0
  51. package/.agents/registry/profiles.json +101 -0
  52. package/.agents/registry/roles.json +1266 -0
  53. package/.agents/registry/rules.json +148 -0
  54. package/.agents/registry/scenario-packages.json +123 -0
  55. package/.agents/registry/skills.json +130 -0
  56. package/.agents/roles/INDEX.md +346 -0
  57. package/.agents/roles/common/README.md +76 -0
  58. package/.agents/roles/common/archive-change.md +80 -0
  59. package/.agents/roles/common/backend-implementer.md +92 -0
  60. package/.agents/roles/common/code-guardian.md +151 -0
  61. package/.agents/roles/common/frontend-implementer.md +146 -0
  62. package/.agents/roles/common/requirement-analyst.md +138 -0
  63. package/.agents/roles/common/task-orchestrator-routing.md +301 -0
  64. package/.agents/roles/common/task-orchestrator.md +224 -0
  65. package/.agents/roles/common/tooling-implementer.md +92 -0
  66. package/.agents/roles/domains/README.md +35 -0
  67. package/.agents/roles/domains/delivery/README.md +11 -0
  68. package/.agents/roles/domains/delivery/container-specialist.md +50 -0
  69. package/.agents/roles/domains/delivery/deployment-specialist.md +50 -0
  70. package/.agents/roles/domains/delivery/pipeline-specialist.md +50 -0
  71. package/.agents/roles/domains/demand-design/README.md +16 -0
  72. package/.agents/roles/domains/demand-design/api-contract-specialist.md +52 -0
  73. package/.agents/roles/domains/demand-design/design-collaborator.md +58 -0
  74. package/.agents/roles/domains/documentation/README.md +11 -0
  75. package/.agents/roles/domains/documentation/api-doc-specialist.md +50 -0
  76. package/.agents/roles/domains/documentation/component-doc-specialist.md +49 -0
  77. package/.agents/roles/domains/documentation/technical-writing-specialist.md +48 -0
  78. package/.agents/roles/domains/engineering/README.md +17 -0
  79. package/.agents/roles/domains/engineering/architecture-advisor.md +53 -0
  80. package/.agents/roles/domains/engineering/build-specialist.md +51 -0
  81. package/.agents/roles/domains/engineering/dependency-governor.md +52 -0
  82. package/.agents/roles/domains/governance/README.md +17 -0
  83. package/.agents/roles/domains/governance/api-governance-specialist.md +51 -0
  84. package/.agents/roles/domains/governance/lint-policy-specialist.md +49 -0
  85. package/.agents/roles/domains/governance/route-governance-specialist.md +52 -0
  86. package/.agents/roles/domains/observability/README.md +11 -0
  87. package/.agents/roles/domains/observability/error-tracker.md +50 -0
  88. package/.agents/roles/domains/observability/event-instrumentation-specialist.md +51 -0
  89. package/.agents/roles/domains/observability/rum-analyst.md +50 -0
  90. package/.agents/roles/domains/performance/README.md +11 -0
  91. package/.agents/roles/domains/performance/asset-optimizer.md +50 -0
  92. package/.agents/roles/domains/performance/performance-auditor.md +56 -0
  93. package/.agents/roles/domains/performance/vitals-analyst.md +50 -0
  94. package/.agents/roles/domains/security-a11y/README.md +11 -0
  95. package/.agents/roles/domains/security-a11y/a11y-auditor.md +50 -0
  96. package/.agents/roles/domains/security-a11y/aria-specialist.md +51 -0
  97. package/.agents/roles/domains/security-a11y/security-reviewer.md +49 -0
  98. package/.agents/roles/domains/testing/README.md +12 -0
  99. package/.agents/roles/domains/testing/coverage-analyst.md +50 -0
  100. package/.agents/roles/domains/testing/e2e-test-specialist.md +51 -0
  101. package/.agents/roles/domains/testing/unit-test-specialist.md +56 -0
  102. package/.agents/roles/domains/testing/verification-reviewer.md +67 -0
  103. package/.agents/rules/README.md +87 -0
  104. package/.agents/rules/common/02-/347/274/226/347/240/201/350/247/204/350/214/203.md +45 -0
  105. package/.agents/rules/common/08-/351/200/232/347/224/250/347/272/246/346/235/237.md +63 -0
  106. package/.agents/rules/common/10-/346/226/207/346/241/243/350/247/204/350/214/203.md +101 -0
  107. package/.agents/rules/common/12-Superpowers/346/211/247/350/241/214/350/247/204/350/214/203.md +46 -0
  108. package/.agents/rules/common/14-/345/256/241/350/256/241/346/261/207/346/212/245/350/247/204/350/214/203.md +107 -0
  109. package/.agents/rules/common/15-visual-gate-wait.md +90 -0
  110. package/.agents/rules/profiles/nestjs/01-/351/241/271/347/233/256/346/246/202/350/277/260.md +27 -0
  111. package/.agents/rules/profiles/nestjs/03-/351/241/271/347/233/256/347/273/223/346/236/204.md +20 -0
  112. package/.agents/rules/profiles/nestjs/04-/346/250/241/345/235/227/347/273/223/346/236/204/350/247/204/350/214/203.md +24 -0
  113. package/.agents/rules/profiles/nestjs/05-/346/216/245/345/217/243/344/270/216/345/245/221/347/272/246/350/247/204/350/214/203.md +24 -0
  114. package/.agents/rules/profiles/nestjs/06-/346/225/260/346/215/256/350/256/277/351/227/256/350/247/204/350/214/203.md +24 -0
  115. package/.agents/rules/profiles/nestjs/07-/351/205/215/347/275/256/344/270/216/350/277/220/350/241/214/346/227/266/350/247/204/350/214/203.md +20 -0
  116. package/.agents/rules/profiles/nestjs/09-/345/274/202/345/270/270/344/270/216/346/227/245/345/277/227/350/247/204/350/214/203.md +20 -0
  117. package/.agents/rules/profiles/nestjs/11-/346/265/213/350/257/225/350/247/204/350/214/203.md +24 -0
  118. package/.agents/rules/profiles/nestjs/13-/344/273/243/347/240/201/346/240/274/345/274/217/345/214/226/344/270/216/346/243/200/346/237/245.md +20 -0
  119. package/.agents/rules/profiles/node-tooling/01-/351/241/271/347/233/256/346/246/202/350/277/260.md +30 -0
  120. package/.agents/rules/profiles/node-tooling/03-/351/241/271/347/233/256/347/273/223/346/236/204.md +37 -0
  121. package/.agents/rules/profiles/node-tooling/04-CLI/344/270/216/346/250/241/345/235/227/350/247/204/350/214/203.md +42 -0
  122. package/.agents/rules/profiles/node-tooling/05-Contract/344/270/216Schema/350/247/204/350/214/203.md +42 -0
  123. package/.agents/rules/profiles/node-tooling/06-/350/277/220/350/241/214/346/227/266/346/226/207/344/273/266/350/247/204/350/214/203.md +30 -0
  124. package/.agents/rules/profiles/node-tooling/07-/346/227/245/345/277/227/344/270/216/351/224/231/350/257/257/345/244/204/347/220/206/350/247/204/350/214/203.md +60 -0
  125. package/.agents/rules/profiles/node-tooling/09-/350/204/232/346/234/254/344/270/216/345/205/245/345/217/243/350/247/204/350/214/203.md +45 -0
  126. package/.agents/rules/profiles/node-tooling/11-/346/265/213/350/257/225/350/247/204/350/214/203.md +41 -0
  127. package/.agents/rules/profiles/node-tooling/13-/344/273/243/347/240/201/346/240/274/345/274/217/345/214/226/344/270/216/346/243/200/346/237/245.md +55 -0
  128. package/.agents/rules/profiles/react/01-/351/241/271/347/233/256/346/246/202/350/277/260.md +29 -0
  129. package/.agents/rules/profiles/react/03-/351/241/271/347/233/256/347/273/223/346/236/204.md +104 -0
  130. package/.agents/rules/profiles/react/04-/347/273/204/344/273/266/350/247/204/350/214/203.md +46 -0
  131. package/.agents/rules/profiles/react/05-API/350/247/204/350/214/203.md +67 -0
  132. package/.agents/rules/profiles/react/06-/350/267/257/347/224/261/350/247/204/350/214/203.md +54 -0
  133. package/.agents/rules/profiles/react/07-/347/212/266/346/200/201/347/256/241/347/220/206.md +226 -0
  134. package/.agents/rules/profiles/react/09-/346/240/267/345/274/217/350/247/204/350/214/203.md +71 -0
  135. package/.agents/rules/profiles/react/11-/346/265/213/350/257/225/350/247/204/350/214/203.md +80 -0
  136. package/.agents/rules/profiles/react/13-/344/273/243/347/240/201/346/240/274/345/274/217/345/214/226/344/270/216/346/243/200/346/237/245.md +159 -0
  137. package/.agents/rules/profiles/springboot/01-/351/241/271/347/233/256/346/246/202/350/277/260.md +31 -0
  138. package/.agents/rules/profiles/springboot/03-/351/241/271/347/233/256/347/273/223/346/236/204.md +37 -0
  139. package/.agents/rules/profiles/springboot/04-/345/210/206/345/261/202/350/247/204/350/214/203.md +33 -0
  140. package/.agents/rules/profiles/springboot/05-/346/216/245/345/217/243/344/270/216/345/245/221/347/272/246/350/247/204/350/214/203.md +51 -0
  141. package/.agents/rules/profiles/springboot/06-/346/225/260/346/215/256/350/256/277/351/227/256/350/247/204/350/214/203.md +34 -0
  142. package/.agents/rules/profiles/springboot/07-/351/205/215/347/275/256/344/270/216/350/277/220/350/241/214/346/227/266/350/247/204/350/214/203.md +38 -0
  143. package/.agents/rules/profiles/springboot/09-/345/274/202/345/270/270/344/270/216/346/227/245/345/277/227/350/247/204/350/214/203.md +48 -0
  144. package/.agents/rules/profiles/springboot/11-/346/265/213/350/257/225/350/247/204/350/214/203.md +43 -0
  145. package/.agents/rules/profiles/springboot/13-/344/273/243/347/240/201/346/240/274/345/274/217/345/214/226/344/270/216/346/243/200/346/237/245.md +48 -0
  146. package/.agents/rules/profiles/vue/01-/351/241/271/347/233/256/346/246/202/350/277/260.md +47 -0
  147. package/.agents/rules/profiles/vue/03-/351/241/271/347/233/256/347/273/223/346/236/204.md +106 -0
  148. package/.agents/rules/profiles/vue/04-/347/273/204/344/273/266/350/247/204/350/214/203.md +61 -0
  149. package/.agents/rules/profiles/vue/05-API/350/247/204/350/214/203.md +67 -0
  150. package/.agents/rules/profiles/vue/06-/350/267/257/347/224/261/350/247/204/350/214/203.md +69 -0
  151. package/.agents/rules/profiles/vue/07-/347/212/266/346/200/201/347/256/241/347/220/206.md +93 -0
  152. package/.agents/rules/profiles/vue/09-/346/240/267/345/274/217/350/247/204/350/214/203.md +67 -0
  153. package/.agents/rules/profiles/vue/11-/346/265/213/350/257/225/350/247/204/350/214/203.md +80 -0
  154. package/.agents/rules/profiles/vue/13-/344/273/243/347/240/201/346/240/274/345/274/217/345/214/226/344/270/216/346/243/200/346/237/245.md +159 -0
  155. package/.agents/skills/README.md +171 -0
  156. package/.agents/skills/common/archive-change/SKILL.md +180 -0
  157. package/.agents/skills/common/branch-code-reviewer/SKILL.md +459 -0
  158. package/.agents/skills/common/branch-code-reviewer/references/business-risk-guide.md +293 -0
  159. package/.agents/skills/common/branch-code-reviewer/references/html-template-guide.md +121 -0
  160. package/.agents/skills/common/config-and-secret-scan/SKILL.md +99 -0
  161. package/.agents/skills/common/create-proposal/SKILL.md +192 -0
  162. package/.agents/skills/common/create-proposal/evals/evals.json +16 -0
  163. package/.agents/skills/common/create-proposal/evals/train_queries.json +18 -0
  164. package/.agents/skills/common/create-proposal/evals/validation_queries.json +18 -0
  165. package/.agents/skills/common/create-proposal/references/interaction-spec-template.md +42 -0
  166. package/.agents/skills/common/create-test/SKILL.md +292 -0
  167. package/.agents/skills/common/dependency-impact-graph/SKILL.md +80 -0
  168. package/.agents/skills/common/execute-task/SKILL.md +206 -0
  169. package/.agents/skills/common/execute-task/evals/evals.json +16 -0
  170. package/.agents/skills/common/execute-task/evals/train_queries.json +18 -0
  171. package/.agents/skills/common/execute-task/evals/validation_queries.json +18 -0
  172. package/.agents/skills/common/find-skills/SKILL.md +144 -0
  173. package/.agents/skills/common/install-ai-spec-auto/SKILL.md +260 -0
  174. package/.agents/skills/common/install-ai-spec-auto/evals/evals.json +17 -0
  175. package/.agents/skills/common/install-ai-spec-auto/evals/train_queries.json +18 -0
  176. package/.agents/skills/common/install-ai-spec-auto/evals/validation_queries.json +18 -0
  177. package/.agents/skills/common/project-init/SKILL.md +178 -0
  178. package/.agents/skills/common/project-init/evals/evals.json +16 -0
  179. package/.agents/skills/common/project-init/evals/train_queries.json +18 -0
  180. package/.agents/skills/common/project-init/evals/validation_queries.json +18 -0
  181. package/.agents/skills/common/project-init/references/custom-rule-generation.md +89 -0
  182. package/.agents/skills/common/project-init/references/deep-scan-rules.md +67 -0
  183. package/.agents/skills/common/project-init/references/output-contracts.md +71 -0
  184. package/.agents/skills/common/project-init/references/repo-fact-gathering.md +83 -0
  185. package/.agents/skills/common/project-init/references/scope-resolution.md +76 -0
  186. package/.agents/skills/common/project-init/scripts/inspect-project.js +112 -0
  187. package/.agents/skills/common/skill-creator/LICENSE.txt +202 -0
  188. package/.agents/skills/common/skill-creator/SKILL.md +370 -0
  189. package/.agents/skills/common/skill-creator/evals/evals.json +16 -0
  190. package/.agents/skills/common/skill-creator/evals/train_queries.json +18 -0
  191. package/.agents/skills/common/skill-creator/evals/validation_queries.json +18 -0
  192. package/.agents/skills/common/skill-creator/references/output-patterns.md +82 -0
  193. package/.agents/skills/common/skill-creator/references/workflows.md +28 -0
  194. package/.agents/skills/common/skill-creator/scripts/init_skill.py +209 -0
  195. package/.agents/skills/common/skill-creator/scripts/package_skill.py +110 -0
  196. package/.agents/skills/common/skill-creator/scripts/quick_validate.py +51 -0
  197. package/.agents/skills/common/skill-optimizer/SKILL.md +102 -0
  198. package/.agents/skills/common/skill-optimizer/evals/evals.json +16 -0
  199. package/.agents/skills/common/skill-optimizer/evals/train_queries.json +18 -0
  200. package/.agents/skills/common/skill-optimizer/evals/validation_queries.json +18 -0
  201. package/.agents/skills/common/skill-optimizer/references/design-patterns.md +26 -0
  202. package/.agents/skills/common/skill-optimizer/references/review-checklist.md +22 -0
  203. package/.agents/skills/common/using-superpowers/SKILL.md +151 -0
  204. package/.agents/skills/common/wait-for-gate-signal/SKILL.md +85 -0
  205. package/.agents/skills/domains/README.md +19 -0
  206. package/.agents/skills/domains/ui-ux-pro-max/SKILL.md +58 -0
  207. package/.agents/skills/domains/web/design-analysis/SKILL.md +89 -0
  208. package/.agents/skills/domains/web/design-analysis/rules/analysis-order.md +61 -0
  209. package/.agents/skills/domains/web/design-analysis/rules/analysis-priorities.md +136 -0
  210. package/.agents/skills/domains/web/design-analysis/rules/checklist-common-misses.md +107 -0
  211. package/.agents/skills/domains/web/design-analysis/rules/implementation-common-errors.md +204 -0
  212. package/.agents/skills/domains/web/design-analysis/rules/implementation-guidelines.md +211 -0
  213. package/.agents/skills/domains/web/design-analysis/rules/output-analysis-checklist.md +247 -0
  214. package/.agents/skills/domains/web/design-analysis/rules/tools-design-guidelines.md +108 -0
  215. package/.agents/skills/domains/web/design-analysis/rules/workflow-element-extraction.md +162 -0
  216. package/.agents/skills/domains/web/design-analysis/rules/workflow-layout-map.md +131 -0
  217. package/.agents/skills/domains/web/design-analysis/rules/workflow-output-checklist.md +70 -0
  218. package/.agents/skills/domains/web/design-analysis/rules/workflow-style-summary.md +91 -0
  219. package/.agents/skills/domains/web/route-permission-map/SKILL.md +103 -0
  220. package/.agents/skills/domains/web/ui-verification/SKILL.md +114 -0
  221. package/.agents/skills/domains/web/ui-verification/evals/evals.json +16 -0
  222. package/.agents/skills/domains/web/ui-verification/evals/train_queries.json +18 -0
  223. package/.agents/skills/domains/web/ui-verification/evals/validation_queries.json +18 -0
  224. package/.agents/skills/domains/web/ui-verification/rules/comparison-content-image.md +34 -0
  225. package/.agents/skills/domains/web/ui-verification/rules/comparison-content-text.md +30 -0
  226. package/.agents/skills/domains/web/ui-verification/rules/comparison-hierarchy.md +33 -0
  227. package/.agents/skills/domains/web/ui-verification/rules/comparison-layout.md +35 -0
  228. package/.agents/skills/domains/web/ui-verification/rules/errors-alignment.md +42 -0
  229. package/.agents/skills/domains/web/ui-verification/rules/errors-button-dimensions.md +28 -0
  230. package/.agents/skills/domains/web/ui-verification/rules/errors-button-position.md +25 -0
  231. package/.agents/skills/domains/web/ui-verification/rules/errors-css-priority.md +50 -0
  232. package/.agents/skills/domains/web/ui-verification/rules/errors-flex-column-width.md +46 -0
  233. package/.agents/skills/domains/web/ui-verification/rules/errors-flex-layout.md +46 -0
  234. package/.agents/skills/domains/web/ui-verification/rules/errors-grid-container-width.md +44 -0
  235. package/.agents/skills/domains/web/ui-verification/rules/errors-page-container-width.md +39 -0
  236. package/.agents/skills/domains/web/ui-verification/rules/tools-browser-navigation.md +53 -0
  237. package/.agents/skills/domains/web/ui-verification/rules/tools-design-guidelines.md +53 -0
  238. package/.agents/skills/domains/web/ui-verification/rules/workflow-checklist.md +27 -0
  239. package/.agents/skills/domains/web/ui-verification/rules/workflow-problem-list.md +56 -0
  240. package/.agents/skills/domains/web/ui-verification/rules/workflow-reflection.md +44 -0
  241. package/.agents/skills/domains/web/ui-verification/rules/writing-alignment.md +44 -0
  242. package/.agents/skills/domains/web/ui-verification/rules/writing-element-completeness.md +63 -0
  243. package/.agents/skills/domains/web/ui-verification/rules/writing-list-layout.md +75 -0
  244. package/.agents/skills/domains/web/ui-verification/rules/writing-page-container-width.md +37 -0
  245. package/.agents/skills/domains/web/web-design-guidelines/SKILL.md +40 -0
  246. package/.agents/skills/profiles/nestjs/README.md +4 -0
  247. package/.agents/skills/profiles/node-tooling/README.md +9 -0
  248. package/.agents/skills/profiles/react/create-api/SKILL.md +145 -0
  249. package/.agents/skills/profiles/react/create-component/SKILL.md +160 -0
  250. package/.agents/skills/profiles/react/create-route/SKILL.md +168 -0
  251. package/.agents/skills/profiles/react/create-store/SKILL.md +262 -0
  252. package/.agents/skills/profiles/react/theme-variables/SKILL.md +82 -0
  253. package/.agents/skills/profiles/react/vercel-composition-patterns/AGENTS.md +899 -0
  254. package/.agents/skills/profiles/react/vercel-composition-patterns/SKILL.md +81 -0
  255. package/.agents/skills/profiles/react/vercel-composition-patterns/rules/architecture-avoid-boolean-props.md +100 -0
  256. package/.agents/skills/profiles/react/vercel-composition-patterns/rules/architecture-compound-components.md +112 -0
  257. package/.agents/skills/profiles/react/vercel-composition-patterns/rules/patterns-children-over-render-props.md +87 -0
  258. package/.agents/skills/profiles/react/vercel-composition-patterns/rules/patterns-explicit-variants.md +100 -0
  259. package/.agents/skills/profiles/react/vercel-composition-patterns/rules/state-context-interface.md +191 -0
  260. package/.agents/skills/profiles/react/vercel-composition-patterns/rules/state-decouple-implementation.md +113 -0
  261. package/.agents/skills/profiles/react/vercel-composition-patterns/rules/state-lift-state.md +125 -0
  262. package/.agents/skills/profiles/react/vercel-react-best-practices/AGENTS.md +2934 -0
  263. package/.agents/skills/profiles/react/vercel-react-best-practices/SKILL.md +136 -0
  264. package/.agents/skills/profiles/react/vercel-react-best-practices/rules/advanced-event-handler-refs.md +55 -0
  265. package/.agents/skills/profiles/react/vercel-react-best-practices/rules/advanced-init-once.md +42 -0
  266. package/.agents/skills/profiles/react/vercel-react-best-practices/rules/advanced-use-latest.md +39 -0
  267. package/.agents/skills/profiles/react/vercel-react-best-practices/rules/async-api-routes.md +38 -0
  268. package/.agents/skills/profiles/react/vercel-react-best-practices/rules/async-defer-await.md +80 -0
  269. package/.agents/skills/profiles/react/vercel-react-best-practices/rules/async-dependencies.md +51 -0
  270. package/.agents/skills/profiles/react/vercel-react-best-practices/rules/async-parallel.md +28 -0
  271. package/.agents/skills/profiles/react/vercel-react-best-practices/rules/async-suspense-boundaries.md +99 -0
  272. package/.agents/skills/profiles/react/vercel-react-best-practices/rules/bundle-barrel-imports.md +59 -0
  273. package/.agents/skills/profiles/react/vercel-react-best-practices/rules/bundle-conditional.md +31 -0
  274. package/.agents/skills/profiles/react/vercel-react-best-practices/rules/bundle-defer-third-party.md +49 -0
  275. package/.agents/skills/profiles/react/vercel-react-best-practices/rules/bundle-dynamic-imports.md +35 -0
  276. package/.agents/skills/profiles/react/vercel-react-best-practices/rules/bundle-preload.md +50 -0
  277. package/.agents/skills/profiles/react/vercel-react-best-practices/rules/client-event-listeners.md +74 -0
  278. package/.agents/skills/profiles/react/vercel-react-best-practices/rules/client-localstorage-schema.md +71 -0
  279. package/.agents/skills/profiles/react/vercel-react-best-practices/rules/client-passive-event-listeners.md +48 -0
  280. package/.agents/skills/profiles/react/vercel-react-best-practices/rules/client-swr-dedup.md +56 -0
  281. package/.agents/skills/profiles/react/vercel-react-best-practices/rules/js-batch-dom-css.md +107 -0
  282. package/.agents/skills/profiles/react/vercel-react-best-practices/rules/js-cache-function-results.md +80 -0
  283. package/.agents/skills/profiles/react/vercel-react-best-practices/rules/js-cache-property-access.md +28 -0
  284. package/.agents/skills/profiles/react/vercel-react-best-practices/rules/js-cache-storage.md +70 -0
  285. package/.agents/skills/profiles/react/vercel-react-best-practices/rules/js-combine-iterations.md +32 -0
  286. package/.agents/skills/profiles/react/vercel-react-best-practices/rules/js-early-exit.md +50 -0
  287. package/.agents/skills/profiles/react/vercel-react-best-practices/rules/js-hoist-regexp.md +45 -0
  288. package/.agents/skills/profiles/react/vercel-react-best-practices/rules/js-index-maps.md +37 -0
  289. package/.agents/skills/profiles/react/vercel-react-best-practices/rules/js-length-check-first.md +49 -0
  290. package/.agents/skills/profiles/react/vercel-react-best-practices/rules/js-min-max-loop.md +82 -0
  291. package/.agents/skills/profiles/react/vercel-react-best-practices/rules/js-set-map-lookups.md +24 -0
  292. package/.agents/skills/profiles/react/vercel-react-best-practices/rules/js-tosorted-immutable.md +57 -0
  293. package/.agents/skills/profiles/react/vercel-react-best-practices/rules/rendering-activity.md +26 -0
  294. package/.agents/skills/profiles/react/vercel-react-best-practices/rules/rendering-animate-svg-wrapper.md +47 -0
  295. package/.agents/skills/profiles/react/vercel-react-best-practices/rules/rendering-conditional-render.md +40 -0
  296. package/.agents/skills/profiles/react/vercel-react-best-practices/rules/rendering-content-visibility.md +38 -0
  297. package/.agents/skills/profiles/react/vercel-react-best-practices/rules/rendering-hoist-jsx.md +46 -0
  298. package/.agents/skills/profiles/react/vercel-react-best-practices/rules/rendering-hydration-no-flicker.md +82 -0
  299. package/.agents/skills/profiles/react/vercel-react-best-practices/rules/rendering-hydration-suppress-warning.md +30 -0
  300. package/.agents/skills/profiles/react/vercel-react-best-practices/rules/rendering-svg-precision.md +28 -0
  301. package/.agents/skills/profiles/react/vercel-react-best-practices/rules/rendering-usetransition-loading.md +75 -0
  302. package/.agents/skills/profiles/react/vercel-react-best-practices/rules/rerender-defer-reads.md +39 -0
  303. package/.agents/skills/profiles/react/vercel-react-best-practices/rules/rerender-dependencies.md +45 -0
  304. package/.agents/skills/profiles/react/vercel-react-best-practices/rules/rerender-derived-state-no-effect.md +40 -0
  305. package/.agents/skills/profiles/react/vercel-react-best-practices/rules/rerender-derived-state.md +29 -0
  306. package/.agents/skills/profiles/react/vercel-react-best-practices/rules/rerender-functional-setstate.md +74 -0
  307. package/.agents/skills/profiles/react/vercel-react-best-practices/rules/rerender-lazy-state-init.md +58 -0
  308. package/.agents/skills/profiles/react/vercel-react-best-practices/rules/rerender-memo-with-default-value.md +38 -0
  309. package/.agents/skills/profiles/react/vercel-react-best-practices/rules/rerender-memo.md +44 -0
  310. package/.agents/skills/profiles/react/vercel-react-best-practices/rules/rerender-move-effect-to-event.md +45 -0
  311. package/.agents/skills/profiles/react/vercel-react-best-practices/rules/rerender-simple-expression-in-memo.md +35 -0
  312. package/.agents/skills/profiles/react/vercel-react-best-practices/rules/rerender-transitions.md +40 -0
  313. package/.agents/skills/profiles/react/vercel-react-best-practices/rules/rerender-use-ref-transient-values.md +73 -0
  314. package/.agents/skills/profiles/react/vercel-react-best-practices/rules/server-after-nonblocking.md +73 -0
  315. package/.agents/skills/profiles/react/vercel-react-best-practices/rules/server-auth-actions.md +96 -0
  316. package/.agents/skills/profiles/react/vercel-react-best-practices/rules/server-cache-lru.md +41 -0
  317. package/.agents/skills/profiles/react/vercel-react-best-practices/rules/server-cache-react.md +76 -0
  318. package/.agents/skills/profiles/react/vercel-react-best-practices/rules/server-dedup-props.md +65 -0
  319. package/.agents/skills/profiles/react/vercel-react-best-practices/rules/server-parallel-fetching.md +83 -0
  320. package/.agents/skills/profiles/react/vercel-react-best-practices/rules/server-serialization.md +38 -0
  321. package/.agents/skills/profiles/springboot/README.md +10 -0
  322. package/.agents/skills/profiles/vue/create-api/SKILL.md +105 -0
  323. package/.agents/skills/profiles/vue/create-component/SKILL.md +76 -0
  324. package/.agents/skills/profiles/vue/create-route/SKILL.md +141 -0
  325. package/.agents/skills/profiles/vue/create-store/SKILL.md +97 -0
  326. package/.agents/skills/profiles/vue/create-view/SKILL.md +81 -0
  327. package/.agents/skills/profiles/vue/theme-variables/SKILL.md +73 -0
  328. package/.agents/skills/profiles/vue/vue-best-practices/SKILL.md +166 -0
  329. package/.agents/skills/profiles/vue/vue-best-practices/references/animation-class-based-technique.md +254 -0
  330. package/.agents/skills/profiles/vue/vue-best-practices/references/animation-state-driven-technique.md +291 -0
  331. package/.agents/skills/profiles/vue/vue-best-practices/references/component-async.md +97 -0
  332. package/.agents/skills/profiles/vue/vue-best-practices/references/component-data-flow.md +307 -0
  333. package/.agents/skills/profiles/vue/vue-best-practices/references/component-fallthrough-attrs.md +174 -0
  334. package/.agents/skills/profiles/vue/vue-best-practices/references/component-keep-alive.md +137 -0
  335. package/.agents/skills/profiles/vue/vue-best-practices/references/component-slots.md +216 -0
  336. package/.agents/skills/profiles/vue/vue-best-practices/references/component-suspense.md +228 -0
  337. package/.agents/skills/profiles/vue/vue-best-practices/references/component-teleport.md +108 -0
  338. package/.agents/skills/profiles/vue/vue-best-practices/references/component-transition-group.md +128 -0
  339. package/.agents/skills/profiles/vue/vue-best-practices/references/component-transition.md +125 -0
  340. package/.agents/skills/profiles/vue/vue-best-practices/references/composables.md +290 -0
  341. package/.agents/skills/profiles/vue/vue-best-practices/references/directives.md +162 -0
  342. package/.agents/skills/profiles/vue/vue-best-practices/references/perf-avoid-component-abstraction-in-lists.md +159 -0
  343. package/.agents/skills/profiles/vue/vue-best-practices/references/perf-v-once-v-memo-directives.md +182 -0
  344. package/.agents/skills/profiles/vue/vue-best-practices/references/perf-virtualize-large-lists.md +187 -0
  345. package/.agents/skills/profiles/vue/vue-best-practices/references/plugins.md +166 -0
  346. package/.agents/skills/profiles/vue/vue-best-practices/references/reactivity.md +344 -0
  347. package/.agents/skills/profiles/vue/vue-best-practices/references/render-functions.md +201 -0
  348. package/.agents/skills/profiles/vue/vue-best-practices/references/sfc.md +310 -0
  349. package/.agents/skills/profiles/vue/vue-best-practices/references/state-management.md +135 -0
  350. package/.agents/skills/profiles/vue/vue-best-practices/references/updated-hook-performance.md +187 -0
  351. package/.agents/templates/common/README.md +23 -0
  352. package/.agents/templates/common/bugfix.md +22 -0
  353. package/.agents/templates/common/create-expert-package.md +458 -0
  354. package/.agents/templates/common/mock-page.md +28 -0
  355. package/.agents/templates/common/new-component.md +25 -0
  356. package/.agents/templates/common/new-page.md +31 -0
  357. package/.cursor/mcp.json +36 -0
  358. package/.qoder/README.md +114 -0
  359. package/.qoder/commands +1 -0
  360. package/.qoder/mcp.json +26 -0
  361. package/.qoder/rules +1 -0
  362. package/.qoder/skills +1 -0
  363. package/LICENSE +21 -0
  364. package/README.md +433 -0
  365. package/bin/archive-change.js +474 -0
  366. package/bin/check-command.js +62 -0
  367. package/bin/cli.js +295 -0
  368. package/bin/command-template-renderer.js +40 -0
  369. package/bin/context-command.js +102 -0
  370. package/bin/demo-runtime-smoke.js +760 -0
  371. package/bin/execution-semantics.js +821 -0
  372. package/bin/executor-command.js +93 -0
  373. package/bin/expert-dispatch.js +334 -0
  374. package/bin/expert-executor.js +1148 -0
  375. package/bin/guard-command.js +52 -0
  376. package/bin/hub-command.js +876 -0
  377. package/bin/ide-command.js +242 -0
  378. package/bin/init-command.js +193 -0
  379. package/bin/install-workflow.js +2983 -0
  380. package/bin/manifest-export.js +34 -0
  381. package/bin/profile-registry.js +90 -0
  382. package/bin/protocol-workflow.js +446 -0
  383. package/bin/repair-command.js +161 -0
  384. package/bin/repo-map.js +177 -0
  385. package/bin/report-command.js +236 -0
  386. package/bin/runtime-bootstrap.js +428 -0
  387. package/bin/runtime-embedded.js +101 -0
  388. package/bin/runtime-fallback.js +106 -0
  389. package/bin/runtime-launcher.js +116 -0
  390. package/bin/runtime-paths.js +177 -0
  391. package/bin/runtime-registry.js +289 -0
  392. package/bin/runtime-state.js +2541 -0
  393. package/bin/scan.js +96 -0
  394. package/bin/self-upgrade.js +206 -0
  395. package/bin/skill-spec-validator.js +457 -0
  396. package/bin/spec-command.js +366 -0
  397. package/bin/superpowers.js +384 -0
  398. package/bin/sync-command.js +59 -0
  399. package/bin/sync.js +1904 -0
  400. package/bin/task-orchestrator-adapter.js +341 -0
  401. package/bin/task-orchestrator-extractor.js +274 -0
  402. package/bin/task-orchestrator-runner.js +1208 -0
  403. package/bin/telemetry/README.md +66 -0
  404. package/bin/telemetry/aspect.js +153 -0
  405. package/bin/telemetry/collect.js +67 -0
  406. package/bin/telemetry/config.js +114 -0
  407. package/bin/telemetry/defaults.json +5 -0
  408. package/bin/telemetry/healthcheck.js +195 -0
  409. package/bin/telemetry/identity.js +53 -0
  410. package/bin/telemetry/index.js +25 -0
  411. package/bin/telemetry/reporter.js +83 -0
  412. package/bin/telemetry/safe.js +39 -0
  413. package/bin/validate-registry.js +740 -0
  414. package/bin/visual-bridge-config.js +117 -0
  415. package/bin/visual-bridge.js +287 -0
  416. package/bin/visual-command.js +432 -0
  417. package/bin/worktree-command.js +194 -0
  418. package/configs/common/.editorconfig +15 -0
  419. package/configs/common/.husky/commit-msg +4 -0
  420. package/configs/common/.husky/pre-commit +4 -0
  421. package/configs/common/.lintstagedrc +11 -0
  422. package/configs/common/.prettierignore +11 -0
  423. package/configs/common/.prettierrc.json +11 -0
  424. package/configs/common/.stylelintignore +14 -0
  425. package/configs/common/.stylelintrc.json +21 -0
  426. package/configs/common/commitlint.config.js +3 -0
  427. package/configs/profiles/nestjs/.gitkeep +1 -0
  428. package/configs/profiles/node-tooling/.gitkeep +1 -0
  429. package/configs/profiles/react/.eslintignore +6 -0
  430. package/configs/profiles/react/.eslintrc.js +16 -0
  431. package/configs/profiles/react/.stylelintrc.json +18 -0
  432. package/configs/profiles/springboot/.gitkeep +1 -0
  433. package/configs/profiles/vue/.eslintignore +7 -0
  434. package/configs/profiles/vue/.eslintrc.cjs +17 -0
  435. package/contracts/README.md +28 -0
  436. package/contracts/fixtures/asset-package.fixture.json +26 -0
  437. package/contracts/fixtures/asset-usage-feedback.fixture.json +14 -0
  438. package/contracts/fixtures/evidence-report.fixture.json +28 -0
  439. package/contracts/fixtures/manifest.fixture.json +20 -0
  440. package/contracts/fixtures/run-event.fixture.json +15 -0
  441. package/contracts/schemas/asset-package.schema.json +76 -0
  442. package/contracts/schemas/asset-usage-feedback.schema.json +57 -0
  443. package/contracts/schemas/evidence-report.schema.json +60 -0
  444. package/contracts/schemas/manifest.schema.json +63 -0
  445. package/contracts/schemas/run-event.schema.json +72 -0
  446. package/install.ps1 +35 -0
  447. package/install.sh +17 -0
  448. package/internal/ai-protocol-workflow.js +5600 -0
  449. package/internal/hub-client.js +98 -0
  450. package/internal/hub-sync-selection.js +69 -0
  451. package/internal/visual-hooks/README.md +481 -0
  452. package/internal/visual-hooks/config-loader.js +218 -0
  453. package/internal/visual-hooks/control-puller.js +206 -0
  454. package/internal/visual-hooks/gate-signal.js +150 -0
  455. package/internal/visual-hooks/inbox-consumer.js +469 -0
  456. package/internal/visual-hooks/index.js +197 -0
  457. package/internal/visual-hooks/push-client.js +189 -0
  458. package/internal/visual-hooks/receipt-pusher.js +176 -0
  459. package/internal/visual-hooks/runtime-state-pusher.js +128 -0
  460. package/openspec/changes/.gitkeep +0 -0
  461. package/openspec/changes/archive/.gitkeep +0 -0
  462. package/openspec/config.yaml.template +52 -0
  463. package/openspec/schemas/expert-delivery/schema.yaml +68 -0
  464. package/openspec/schemas/expert-delivery/templates/checklist.md +39 -0
  465. package/openspec/schemas/expert-delivery/templates/design.md +61 -0
  466. package/openspec/schemas/expert-delivery/templates/iterations.md +25 -0
  467. package/openspec/schemas/expert-delivery/templates/proposal.md +45 -0
  468. package/openspec/schemas/expert-delivery/templates/spec.md +29 -0
  469. package/openspec/schemas/expert-delivery/templates/tasks.md +24 -0
  470. package/openspec/specs/.gitkeep +0 -0
  471. package/package.json +73 -0
  472. package/scripts/acceptance-zero-intrusion.sh +168 -0
  473. package/scripts/hub-sync-assets.config.example.json +296 -0
  474. package/scripts/hub-sync-assets.js +2038 -0
  475. package/scripts/local-verify.sh +280 -0
  476. package/scripts/post-publish-auto-fix-check.js +404 -0
  477. package/scripts/post-publish-verify.sh +175 -0
  478. package/scripts/setup-cursor-manual-test.sh +107 -0
  479. package/scripts/setup-cursor-spec-archive-test.sh +111 -0
  480. package/scripts/setup-visual-integration.sh +225 -0
  481. package/scripts/test-integration.sh +176 -0
  482. package/scripts/update-test-project.sh +93 -0
  483. package/scripts/upload-four-web.sh +57 -0
  484. package/scripts/verify-install-ps1-bom.js +26 -0
  485. package/src/agent/agent-context.js +259 -0
  486. package/src/agent/agent-profile.js +185 -0
  487. package/src/agent/agent-templates.js +161 -0
  488. package/src/agent/agent-types.js +108 -0
  489. package/src/agent/collaboration-protocol.js +333 -0
  490. package/src/agent/conflict-handler.js +364 -0
  491. package/src/agent/file-permission.js +121 -0
  492. package/src/agent/index.js +38 -0
  493. package/src/agent/permission-audit.js +151 -0
  494. package/src/agent/review-repair-loop.js +270 -0
  495. package/src/agent/tool-permission.js +101 -0
  496. package/src/asset/asset-dependency.js +322 -0
  497. package/src/asset/asset-feedback.js +350 -0
  498. package/src/asset/asset-fork.js +300 -0
  499. package/src/asset/asset-install.js +278 -0
  500. package/src/asset/asset-installer.js +497 -0
  501. package/src/asset/asset-lifecycle.js +324 -0
  502. package/src/asset/asset-manager.js +245 -0
  503. package/src/asset/asset-package-manager.js +349 -0
  504. package/src/asset/asset-package.js +186 -0
  505. package/src/asset/asset-quality.js +262 -0
  506. package/src/asset/asset-registry.js +387 -0
  507. package/src/asset/asset-version.js +293 -0
  508. package/src/asset/index.js +86 -0
  509. package/src/cache/agent-profile-cache.js +59 -0
  510. package/src/cache/asset-cache.js +63 -0
  511. package/src/cache/global-cache.js +61 -0
  512. package/src/cache/manifest-cache.js +30 -0
  513. package/src/check/check-service.js +32 -0
  514. package/src/config/config-layer.js +343 -0
  515. package/src/config/config-loader.js +60 -0
  516. package/src/config/defaults.js +49 -0
  517. package/src/connectors/hub/asset-package.js +72 -0
  518. package/src/connectors/hub/asset-usage-feedback.js +46 -0
  519. package/src/connectors/hub/hub-connector.js +44 -0
  520. package/src/connectors/hub/index.js +21 -0
  521. package/src/connectors/visual/evidence-report.js +49 -0
  522. package/src/connectors/visual/index.js +15 -0
  523. package/src/connectors/visual/queue.js +41 -0
  524. package/src/connectors/visual/run-event.js +81 -0
  525. package/src/connectors/visual/visual-connector.js +77 -0
  526. package/src/context/context-budget.js +59 -0
  527. package/src/context/context-builder.js +285 -0
  528. package/src/context/context-loader.js +116 -0
  529. package/src/context/context-planner.js +158 -0
  530. package/src/context/types.js +96 -0
  531. package/src/contracts/index.js +63 -0
  532. package/src/executor/executor-registry.js +78 -0
  533. package/src/executor/executor-result-parser.js +44 -0
  534. package/src/executor/executor-runner.js +141 -0
  535. package/src/executor/executor-selector.js +139 -0
  536. package/src/executor/executor-timeout.js +36 -0
  537. package/src/executor/providers/base-provider-utils.js +189 -0
  538. package/src/executor/providers/claude-code-executor-provider.js +128 -0
  539. package/src/executor/providers/codex-executor-provider.js +126 -0
  540. package/src/executor/providers/cursor-executor-provider.js +99 -0
  541. package/src/executor/types.js +137 -0
  542. package/src/git/branch-manager.js +71 -0
  543. package/src/git/dirty-checker.js +43 -0
  544. package/src/git/dirty-strategy-handler.js +29 -0
  545. package/src/git/git-command.js +37 -0
  546. package/src/git/git-repository-detector.js +45 -0
  547. package/src/git/multi-repo-worktree-planner.js +88 -0
  548. package/src/git/policy.js +19 -0
  549. package/src/git/strategies/block-dirty-strategy.js +34 -0
  550. package/src/git/strategies/ignore-dirty-strategy.js +33 -0
  551. package/src/git/strategies/patch-snapshot-strategy.js +53 -0
  552. package/src/git/strategies/wip-commit-strategy.js +38 -0
  553. package/src/git/types.js +71 -0
  554. package/src/git/worktree-manager.js +85 -0
  555. package/src/governance/asset-review.js +351 -0
  556. package/src/governance/audit-log.js +368 -0
  557. package/src/governance/gray-release.js +312 -0
  558. package/src/governance/index.js +31 -0
  559. package/src/governance/policy-types.js +56 -0
  560. package/src/governance/rbac-types.js +171 -0
  561. package/src/governance/rbac.js +382 -0
  562. package/src/governance/rollback.js +360 -0
  563. package/src/governance/security-policy.js +354 -0
  564. package/src/hook/hook-config-writer.js +125 -0
  565. package/src/hub/hub-client.js +186 -0
  566. package/src/hub/hub-config.js +39 -0
  567. package/src/hub/project-facts.js +31 -0
  568. package/src/hub/runtime-feedback-reporter.js +55 -0
  569. package/src/ide/adapters/adapter-protocol.js +385 -0
  570. package/src/ide/adapters/claude-adapter.js +419 -0
  571. package/src/ide/adapters/codex-adapter.js +60 -0
  572. package/src/ide/adapters/cursor-adapter.js +484 -0
  573. package/src/ide/adapters/index.js +24 -0
  574. package/src/ide/anchors/markdown-anchor-writer.js +152 -0
  575. package/src/ide/ide-service.js +270 -0
  576. package/src/ide/ide-types.js +94 -0
  577. package/src/ide/links/link-mode-resolver.js +160 -0
  578. package/src/ide/registry/ide-registry-builder.js +165 -0
  579. package/src/incident/incident-writer.js +47 -0
  580. package/src/incident/types.js +22 -0
  581. package/src/init/ide-linker.js +126 -0
  582. package/src/init/ide-pointer-injector.js +75 -0
  583. package/src/init/init-applier.js +197 -0
  584. package/src/init/init-plan.js +294 -0
  585. package/src/init/init-service.js +65 -0
  586. package/src/init/manifest-installer.js +302 -0
  587. package/src/init/types.js +26 -0
  588. package/src/project/config-writer.js +83 -0
  589. package/src/project/context-index-writer.js +82 -0
  590. package/src/project/json-utils.js +72 -0
  591. package/src/project/local-state-writer.js +50 -0
  592. package/src/project/lock-file-writer.js +98 -0
  593. package/src/project/manifest-writer.js +126 -0
  594. package/src/project/policy-config-writer.js +91 -0
  595. package/src/project/project-config-writer.js +74 -0
  596. package/src/project/project-files.js +39 -0
  597. package/src/project/registry-index-writer.js +43 -0
  598. package/src/project/workspace-config-writer.js +63 -0
  599. package/src/run/index.js +11 -0
  600. package/src/run/run-id.js +32 -0
  601. package/src/run/run-service.js +269 -0
  602. package/src/run/run-store.js +80 -0
  603. package/src/scanner/aggregator/detection-aggregator.js +23 -0
  604. package/src/scanner/boundary/boundary-resolver.js +229 -0
  605. package/src/scanner/detectors/detector-registry.js +44 -0
  606. package/src/scanner/detectors/fastapi-detector.js +46 -0
  607. package/src/scanner/detectors/go-detector.js +46 -0
  608. package/src/scanner/detectors/nestjs-detector.js +57 -0
  609. package/src/scanner/detectors/nextjs-detector.js +52 -0
  610. package/src/scanner/detectors/react-vite-detector.js +52 -0
  611. package/src/scanner/detectors/react-webpack-detector.js +57 -0
  612. package/src/scanner/detectors/springboot-detector.js +46 -0
  613. package/src/scanner/detectors/springcloud-detector.js +46 -0
  614. package/src/scanner/detectors/springmvc-detector.js +46 -0
  615. package/src/scanner/detectors/vue-vite-detector.js +52 -0
  616. package/src/scanner/engine.js +72 -0
  617. package/src/scanner/facts/fact-extractor.js +211 -0
  618. package/src/scanner/types.js +30 -0
  619. package/src/security/asset-tamper-checker.js +188 -0
  620. package/src/security/checksum.js +40 -0
  621. package/src/spec/spec-writer.js +302 -0
  622. package/src/state-machine/circuit-breaker.js +112 -0
  623. package/src/state-machine/escape-hatch.js +49 -0
  624. package/src/state-machine/stage-runner.js +281 -0
  625. package/src/state-machine/state-machine.js +24 -0
  626. package/src/state-machine/transition-guard.js +36 -0
  627. package/src/state-machine/types.js +37 -0
  628. package/src/sync/sync-service.js +192 -0
  629. package/src/visual/agent-visual.js +142 -0
  630. package/src/visual/event-gateway.js +357 -0
  631. package/src/visual/event-mapper.js +128 -0
  632. package/src/visual/hook-dashboard.js +216 -0
  633. package/src/visual/index.js +27 -0
  634. package/src/visual/metrics.js +287 -0
  635. package/src/visual/privacy-filter.js +100 -0
  636. package/src/visual/risk-board.js +252 -0
  637. package/src/visual/timeline.js +245 -0
  638. package/src/visual/visual-client.js +94 -0
  639. package/src/visual/visual-config.js +40 -0
  640. package/src/visual/visual-reporter.js +88 -0
@@ -0,0 +1,432 @@
1
+ /**
2
+ * ai-spec-auto visual <subcmd>
3
+ *
4
+ * Opt-in 接入入口,完全不参与 init / sync 主链。仅在用户主动调用时才落盘
5
+ * .ai-spec/visual-bridge.json,并提供连通性自检。
6
+ *
7
+ * 子命令:
8
+ * - init 交互式生成 visual-bridge.json
9
+ * - disable 关闭 enabled
10
+ * - status 显示当前桥接配置 + inbox 状态
11
+ * - test 单次 ping visual + 拉取 pending + 推送一条 receipt 探针
12
+ */
13
+
14
+ const fs = require('fs');
15
+ const http = require('http');
16
+ const https = require('https');
17
+ const path = require('path');
18
+ const readline = require('readline');
19
+ const crypto = require('crypto');
20
+ const { URL } = require('url');
21
+
22
+ const BRIDGE_REL_PATH = '.ai-spec/visual-bridge.json';
23
+ const INBOX_REL_PATH = '.ai-spec/inbox';
24
+
25
+ function bridgePath(targetDir) {
26
+ return path.join(targetDir, BRIDGE_REL_PATH);
27
+ }
28
+
29
+ function inboxPath(targetDir) {
30
+ return path.join(targetDir, INBOX_REL_PATH);
31
+ }
32
+
33
+ function ensureDir(dir) {
34
+ try {
35
+ fs.mkdirSync(dir, { recursive: true });
36
+ } catch (_err) {
37
+ // noop
38
+ }
39
+ }
40
+
41
+ function safeReadJson(filePath) {
42
+ try {
43
+ return JSON.parse(fs.readFileSync(filePath, 'utf-8'));
44
+ } catch (_err) {
45
+ return null;
46
+ }
47
+ }
48
+
49
+ function loadBridge(targetDir) {
50
+ return safeReadJson(bridgePath(targetDir));
51
+ }
52
+
53
+ function writeBridge(targetDir, data) {
54
+ const file = bridgePath(targetDir);
55
+ ensureDir(path.dirname(file));
56
+ fs.writeFileSync(file, `${JSON.stringify(data, null, 2)}\n`, 'utf-8');
57
+ return file;
58
+ }
59
+
60
+ function ask(rl, question, defaultValue) {
61
+ return new Promise((resolve) => {
62
+ const suffix = defaultValue ? ` [${defaultValue}]` : '';
63
+ rl.question(`${question}${suffix}: `, (answer) => {
64
+ const trimmed = String(answer || '').trim();
65
+ resolve(trimmed || defaultValue || '');
66
+ });
67
+ });
68
+ }
69
+
70
+ function generateConnectToken() {
71
+ return crypto.randomBytes(24).toString('hex');
72
+ }
73
+
74
+ /** 读取 `--flag value`(value 不能是另一个以 `--` 开头的开关) */
75
+ function readArgValue(argv, flag) {
76
+ const idx = argv.indexOf(flag);
77
+ if (idx === -1) return null;
78
+ const v = argv[idx + 1];
79
+ if (v == null || String(v).startsWith('--')) return null;
80
+ return String(v).trim();
81
+ }
82
+
83
+ /**
84
+ * `visual test` 里拉 pending / 推 receipt 的 HTTP 超时(毫秒)。
85
+ * 默认 15s:本地 Next dev 首次打 /api/internal/ingest/raw 时编译 + DB 往往超过 1.5s。
86
+ * 与 internal/visual-hooks/config-loader 相同环境变量名。
87
+ */
88
+ function resolveVisualTestHttpTimeoutMs() {
89
+ const raw = process.env.AI_SPEC_VISUAL_PUSH_TIMEOUT_MS;
90
+ const n = raw ? parseInt(raw, 10) : NaN;
91
+ if (Number.isFinite(n) && n >= 500 && n <= 120000) {
92
+ return n;
93
+ }
94
+ return 15000;
95
+ }
96
+
97
+ async function runInit(targetDir, args) {
98
+ const yes = args.includes('--yes') || args.includes('-y');
99
+ const existing = loadBridge(targetDir) || {};
100
+
101
+ const fromCliServer = readArgValue(args, '--server');
102
+ const fromCliWorkspaceId =
103
+ readArgValue(args, '--workspace-id') || readArgValue(args, '--workspace_id');
104
+ const fromCliAgentId =
105
+ readArgValue(args, '--agent-id') || readArgValue(args, '--agent_id');
106
+ const fromCliConnectToken =
107
+ readArgValue(args, '--connect-token') || readArgValue(args, '--connect_token');
108
+
109
+ let serverUrl = fromCliServer || existing.server_url || 'http://localhost:3000';
110
+ let workspaceId = fromCliWorkspaceId || existing.workspace_id || path.basename(targetDir);
111
+ let agentId = fromCliAgentId || existing.agent_id || 'ai-spec-auto';
112
+ let pushMode = existing.push_mode || 'hook';
113
+ let inboxTransport = existing.inbox_transport || 'http-pull';
114
+ let pollHint = existing.poll_interval_hint || 'on-cli-tick';
115
+ let connectToken = fromCliConnectToken || existing.connect_token || generateConnectToken();
116
+
117
+ if (!yes) {
118
+ const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
119
+ try {
120
+ serverUrl = await ask(rl, 'Visual server URL', serverUrl);
121
+ workspaceId = await ask(rl, 'Workspace ID', workspaceId);
122
+ agentId = await ask(rl, 'Agent ID', agentId);
123
+ pushMode = await ask(rl, 'Push mode (hook|collector)', pushMode);
124
+ inboxTransport = await ask(rl, 'Inbox transport (http-pull|file-inbox)', inboxTransport);
125
+ pollHint = await ask(rl, 'Poll interval hint', pollHint);
126
+ const useToken = await ask(rl, 'Connect token (leave empty to keep generated)', '');
127
+ if (useToken) connectToken = useToken;
128
+ } finally {
129
+ rl.close();
130
+ }
131
+ }
132
+
133
+ const data = {
134
+ schema_version: 1,
135
+ enabled: true,
136
+ server_url: serverUrl,
137
+ workspace_id: workspaceId,
138
+ agent_id: agentId,
139
+ connect_token: connectToken,
140
+ push_mode: pushMode,
141
+ inbox_transport: inboxTransport,
142
+ poll_interval_hint: pollHint,
143
+ updated_at: new Date().toISOString(),
144
+ };
145
+ const file = writeBridge(targetDir, data);
146
+
147
+ if (inboxTransport === 'file-inbox' || inboxTransport === 'http-pull') {
148
+ ensureDir(inboxPath(targetDir));
149
+ }
150
+
151
+ console.log(`[visual] bridge written: ${file}`);
152
+ console.log('[visual] connect_token (share with visual UI):');
153
+ console.log(` ${connectToken}`);
154
+ return 0;
155
+ }
156
+
157
+ function runDisable(targetDir) {
158
+ const existing = loadBridge(targetDir);
159
+ if (!existing) {
160
+ console.log('[visual] bridge not configured; nothing to disable');
161
+ return 0;
162
+ }
163
+ const next = { ...existing, enabled: false, updated_at: new Date().toISOString() };
164
+ writeBridge(targetDir, next);
165
+ console.log('[visual] bridge disabled');
166
+ return 0;
167
+ }
168
+
169
+ function runStatus(targetDir) {
170
+ const bridge = loadBridge(targetDir);
171
+ if (!bridge) {
172
+ console.log('[visual] not configured (.ai-spec/visual-bridge.json absent)');
173
+ return 0;
174
+ }
175
+ const inboxDir = inboxPath(targetDir);
176
+ let pending = 0;
177
+ let applied = 0;
178
+ if (fs.existsSync(inboxDir)) {
179
+ try {
180
+ const items = fs.readdirSync(inboxDir);
181
+ pending = items.filter((name) => /^control-.*\.json$/.test(name)).length;
182
+ const appliedDir = path.join(inboxDir, '.applied');
183
+ if (fs.existsSync(appliedDir)) {
184
+ applied = fs.readdirSync(appliedDir).length;
185
+ }
186
+ } catch (_err) {
187
+ // noop
188
+ }
189
+ }
190
+
191
+ console.log(JSON.stringify({
192
+ enabled: !!bridge.enabled,
193
+ server_url: bridge.server_url || null,
194
+ workspace_id: bridge.workspace_id || null,
195
+ agent_id: bridge.agent_id || null,
196
+ push_mode: bridge.push_mode || null,
197
+ inbox_transport: bridge.inbox_transport || 'http-pull',
198
+ inbox: { pending, applied },
199
+ updated_at: bridge.updated_at || null,
200
+ }, null, 2));
201
+ return 0;
202
+ }
203
+
204
+ function httpPing(url, timeoutMs = 1500) {
205
+ return new Promise((resolve) => {
206
+ let parsed;
207
+ try {
208
+ parsed = new URL(url);
209
+ } catch (err) {
210
+ resolve({ ok: false, error: `invalid url: ${err.message}` });
211
+ return;
212
+ }
213
+ const protocol = parsed.protocol === 'https:' ? https : http;
214
+ const req = protocol.request(parsed, { method: 'GET' }, (res) => {
215
+ const chunks = [];
216
+ res.on('data', (chunk) => chunks.push(chunk));
217
+ res.on('end', () => {
218
+ const body = Buffer.concat(chunks).toString('utf-8');
219
+ resolve({ ok: res.statusCode >= 200 && res.statusCode < 500, statusCode: res.statusCode, body: body.slice(0, 200) });
220
+ });
221
+ });
222
+ const timer = setTimeout(() => req.destroy(new Error('timeout')), timeoutMs);
223
+ req.on('error', (err) => {
224
+ clearTimeout(timer);
225
+ resolve({ ok: false, error: err.message });
226
+ });
227
+ req.on('close', () => clearTimeout(timer));
228
+ req.end();
229
+ });
230
+ }
231
+
232
+ async function runTest(targetDir) {
233
+ const bridge = loadBridge(targetDir);
234
+ if (!bridge || !bridge.enabled) {
235
+ console.log('[visual] bridge disabled or missing; nothing to test');
236
+ return 0;
237
+ }
238
+ const serverUrl = bridge.server_url;
239
+ if (!serverUrl) {
240
+ console.error('[visual] missing server_url');
241
+ return 1;
242
+ }
243
+
244
+ const ping = await httpPing(serverUrl);
245
+ console.log(`[visual] ping ${serverUrl} → ${ping.ok ? 'ok' : 'fail'}${ping.statusCode ? ` (status ${ping.statusCode})` : ''}${ping.error ? ` (${ping.error})` : ''}`);
246
+
247
+ const testHttpMs = resolveVisualTestHttpTimeoutMs();
248
+
249
+ let pulled = 0;
250
+ try {
251
+ const { pullPendingControls } = require('../internal/visual-hooks/control-puller');
252
+ const result = await pullPendingControls({ targetDir, timeoutMs: testHttpMs });
253
+ pulled = result.written || 0;
254
+ console.log(`[visual] pull pending → ${pulled} written (transport=${result.transport})`);
255
+ } catch (err) {
256
+ console.log(`[visual] pull pending failed: ${err.message}`);
257
+ }
258
+
259
+ try {
260
+ const { pushReceipts } = require('../internal/visual-hooks/receipt-pusher');
261
+ const probe = [{
262
+ eventType: 'control.receipt',
263
+ outbox_id: `probe_${Date.now()}`,
264
+ command: 'approve_gate',
265
+ result: 'applied',
266
+ reason: 'visual test probe',
267
+ applied_state_snapshot: null,
268
+ received_at: new Date().toISOString(),
269
+ }];
270
+ const pushResult = await pushReceipts({ targetDir, receipts: probe, timeoutMs: testHttpMs });
271
+ console.log(`[visual] push probe receipt → ${pushResult.pushed ? 'ok' : 'fail'}${pushResult.error ? ` (${pushResult.error})` : ''}`);
272
+ } catch (err) {
273
+ console.log(`[visual] push probe failed: ${err.message}`);
274
+ }
275
+
276
+ return 0;
277
+ }
278
+
279
+ /**
280
+ * `visual watch`:长驻守护,周期性消费 `.ai-spec/inbox/` 并拉取 visual 侧 outbox。
281
+ *
282
+ * 完全复用 `internal/visual-hooks/inbox-consumer.js` 的 `consumeInbox` 实现,
283
+ * 不引入新状态机。任何异常都只写日志,不退出;连续失败指数退避到上限。
284
+ *
285
+ * 严格与 init / update / protocol-* 主链解耦:本子命令只在用户手动启动时运行。
286
+ */
287
+ async function runWatch(targetDir, args) {
288
+ const bridge = loadBridge(targetDir);
289
+ if (!bridge) {
290
+ console.error(
291
+ '[visual watch] bridge 未配置(.ai-spec/visual-bridge.json 缺失)。请先运行 `visual init`。',
292
+ );
293
+ return 1;
294
+ }
295
+ if (bridge.enabled === false) {
296
+ console.error('[visual watch] bridge enabled=false;请先 `visual init` 或手动改 enabled=true。');
297
+ return 1;
298
+ }
299
+
300
+ const intervalRaw = readArgValue(args, '--interval');
301
+ let intervalMs = Number.parseInt(intervalRaw || '2000', 10);
302
+ if (!Number.isFinite(intervalMs) || intervalMs < 500) intervalMs = 2000;
303
+ if (intervalMs > 60000) intervalMs = 60000;
304
+
305
+ const maxBackoffMs = 30000;
306
+ const logDir = path.join(targetDir, '.ai-spec', 'logs');
307
+ const logFile = path.join(logDir, 'visual-watch.log');
308
+ ensureDir(logDir);
309
+
310
+ const writeLog = (level, message, extra) => {
311
+ const line = JSON.stringify({
312
+ ts: new Date().toISOString(),
313
+ level,
314
+ message,
315
+ ...(extra && typeof extra === 'object' ? extra : {}),
316
+ });
317
+ try {
318
+ fs.appendFileSync(logFile, `${line}\n`, 'utf-8');
319
+ } catch (_err) {
320
+ /* silent */
321
+ }
322
+ // stdout 方便 tmux / launchd 里直接观察
323
+ const prefix = level === 'error' ? '[visual watch][ERR]' : '[visual watch]';
324
+ console.log(`${prefix} ${message}${extra ? ` ${JSON.stringify(extra)}` : ''}`);
325
+ };
326
+
327
+ writeLog('info', 'start', {
328
+ target: targetDir,
329
+ server_url: bridge.server_url || null,
330
+ workspace_id: bridge.workspace_id || null,
331
+ interval_ms: intervalMs,
332
+ });
333
+
334
+ let running = true;
335
+ let failureStreak = 0;
336
+ const stop = (signal) => {
337
+ if (!running) return;
338
+ running = false;
339
+ writeLog('info', 'stop', { signal: signal || 'manual' });
340
+ };
341
+ process.on('SIGINT', () => {
342
+ stop('SIGINT');
343
+ process.exit(0);
344
+ });
345
+ process.on('SIGTERM', () => {
346
+ stop('SIGTERM');
347
+ process.exit(0);
348
+ });
349
+
350
+ const { consumeInbox } = require('../internal/visual-hooks/inbox-consumer');
351
+
352
+ const tickTimeoutMs = Math.max(1000, Math.floor(intervalMs * 2));
353
+
354
+ while (running) {
355
+ try {
356
+ const result = await consumeInbox({
357
+ targetDir,
358
+ timeoutMs: tickTimeoutMs,
359
+ });
360
+ const processed = result?.processed || 0;
361
+ const pulled = result?.pulled || 0;
362
+ if (processed > 0 || pulled > 0) {
363
+ writeLog('info', 'tick', {
364
+ processed,
365
+ pulled,
366
+ receipts: Array.isArray(result?.receipts)
367
+ ? result.receipts.map((r) => ({ outbox_id: r.outbox_id, result: r.result }))
368
+ : [],
369
+ });
370
+ }
371
+ failureStreak = 0;
372
+ } catch (err) {
373
+ failureStreak += 1;
374
+ writeLog('error', 'tick_failed', {
375
+ error: String(err?.message || err),
376
+ streak: failureStreak,
377
+ });
378
+ }
379
+
380
+ const backoff = failureStreak === 0
381
+ ? intervalMs
382
+ : Math.min(maxBackoffMs, intervalMs * Math.pow(2, Math.min(failureStreak, 5)));
383
+
384
+ await new Promise((resolve) => setTimeout(resolve, backoff));
385
+ }
386
+
387
+ return 0;
388
+ }
389
+
390
+ function printUsage() {
391
+ console.log(
392
+ 'Usage: ai-spec-auto visual <init|disable|status|test|watch> [--target <dir>] [init: --server <url> --workspace-id <id> --agent-id <id> --connect-token <token> --yes] [watch: --interval <ms>]',
393
+ );
394
+ }
395
+
396
+ async function main(argv) {
397
+ const args = [...argv];
398
+ let target = process.cwd();
399
+ const remaining = [];
400
+ while (args.length > 0) {
401
+ const arg = args.shift();
402
+ if (arg === '--target') {
403
+ target = path.resolve(process.cwd(), args.shift() || '.');
404
+ } else {
405
+ remaining.push(arg);
406
+ }
407
+ }
408
+
409
+ const sub = remaining.shift();
410
+ if (!sub || sub === '-h' || sub === '--help') {
411
+ printUsage();
412
+ return 0;
413
+ }
414
+
415
+ switch (sub) {
416
+ case 'init':
417
+ return runInit(target, remaining);
418
+ case 'disable':
419
+ return runDisable(target);
420
+ case 'status':
421
+ return runStatus(target);
422
+ case 'test':
423
+ return runTest(target);
424
+ case 'watch':
425
+ return runWatch(target, remaining);
426
+ default:
427
+ printUsage();
428
+ return 1;
429
+ }
430
+ }
431
+
432
+ module.exports = { main };
@@ -0,0 +1,194 @@
1
+ const path = require('path');
2
+ const { BranchManager } = require('../src/git/branch-manager');
3
+ const { DirtyChecker } = require('../src/git/dirty-checker');
4
+ const { DirtyStrategyHandler } = require('../src/git/dirty-strategy-handler');
5
+ const { GitRepositoryDetector } = require('../src/git/git-repository-detector');
6
+ const { readBranchPolicy } = require('../src/git/policy');
7
+ const { createBranchName, createWorktreeName, normalizeDirtyStrategy } = require('../src/git/types');
8
+ const { WorktreeManager, resolveWorktreeRoot } = require('../src/git/worktree-manager');
9
+
10
+ function parseArgs(argv) {
11
+ const options = {
12
+ command: argv[0],
13
+ target: '.',
14
+ summary: '',
15
+ runId: `run-${Date.now()}`,
16
+ dirtyStrategy: null,
17
+ };
18
+
19
+ for (let index = 1; index < argv.length; index += 1) {
20
+ const arg = argv[index];
21
+ if (arg === '--help' || arg === '-h') {
22
+ options.help = true;
23
+ } else if (arg === '--summary') {
24
+ const value = argv[index + 1];
25
+ if (!value || value.startsWith('-')) throw new Error('缺少 --summary 参数值');
26
+ options.summary = value;
27
+ index += 1;
28
+ } else if (arg === '--run-id') {
29
+ const value = argv[index + 1];
30
+ if (!value || value.startsWith('-')) throw new Error('缺少 --run-id 参数值');
31
+ options.runId = value;
32
+ index += 1;
33
+ } else if (arg === '--dirty-strategy') {
34
+ const value = argv[index + 1];
35
+ if (!value || value.startsWith('-')) throw new Error('缺少 --dirty-strategy 参数值');
36
+ options.dirtyStrategy = normalizeDirtyStrategy(value);
37
+ index += 1;
38
+ } else if (arg === '--base-branch') {
39
+ const value = argv[index + 1];
40
+ if (!value || value.startsWith('-')) throw new Error('缺少 --base-branch 参数值');
41
+ options.baseBranch = value;
42
+ index += 1;
43
+ } else if (arg === '--branch-prefix') {
44
+ const value = argv[index + 1];
45
+ if (!value || value.startsWith('-')) throw new Error('缺少 --branch-prefix 参数值');
46
+ options.branchPrefix = value;
47
+ index += 1;
48
+ } else if (arg === '--worktree-root') {
49
+ const value = argv[index + 1];
50
+ if (!value || value.startsWith('-')) throw new Error('缺少 --worktree-root 参数值');
51
+ options.worktreeRoot = value;
52
+ index += 1;
53
+ } else if (!arg.startsWith('-')) {
54
+ options.target = arg;
55
+ } else {
56
+ throw new Error(`未知 worktree 参数:${arg}`);
57
+ }
58
+ }
59
+ return options;
60
+ }
61
+
62
+ function printUsage() {
63
+ console.log(`ai-spec-auto worktree <dirty|plan|create> <目录>
64
+
65
+ 说明:
66
+ 调试 Git branch / worktree 隔离能力。
67
+
68
+ 示例:
69
+ ai-spec-auto worktree dirty .
70
+ ai-spec-auto worktree plan . --summary "新增用户列表"
71
+ ai-spec-auto worktree create . --summary "新增用户列表" --dirty-strategy block`);
72
+ }
73
+
74
+ function resolveExecutionContext(options) {
75
+ const targetDir = path.resolve(process.cwd(), options.target || '.');
76
+ const detector = new GitRepositoryDetector().detect({ rootDir: targetDir });
77
+ if (!detector.isGitRepository) {
78
+ return { targetDir, detector, policy: null };
79
+ }
80
+ const policy = readBranchPolicy(detector.repoRoot);
81
+ return { targetDir, detector, policy };
82
+ }
83
+
84
+ function printDirty(result) {
85
+ console.log('dirty 检测完成:');
86
+ console.log(`- clean:${result.clean ? '是' : '否'}`);
87
+ console.log(`- staged:${result.summary.stagedCount}`);
88
+ console.log(`- unstaged:${result.summary.unstagedCount}`);
89
+ console.log(`- untracked:${result.summary.untrackedCount}`);
90
+ if (result.changedFiles.length > 0) {
91
+ console.log('变更文件:');
92
+ for (const file of result.changedFiles) {
93
+ console.log(`- ${file.status} ${file.path}`);
94
+ }
95
+ }
96
+ }
97
+
98
+ function createPlan(options, detector, policy) {
99
+ const baseBranch = options.baseBranch || policy.baseBranch || detector.currentBranch;
100
+ const branchPrefix = options.branchPrefix || policy.branchPrefix || 'ai';
101
+ const worktreeRoot = options.worktreeRoot || policy.worktreeRoot || '../.ai-worktrees';
102
+ const requirementSummary = options.summary || '需求执行';
103
+ const branchName = createBranchName({
104
+ branchPrefix,
105
+ runId: options.runId,
106
+ requirementSummary,
107
+ });
108
+ const worktreePath = path.join(resolveWorktreeRoot(detector.repoRoot, worktreeRoot), createWorktreeName({
109
+ runId: options.runId,
110
+ requirementSummary,
111
+ }));
112
+ return {
113
+ runId: options.runId,
114
+ repoRoot: detector.repoRoot,
115
+ baseBranch,
116
+ branchName,
117
+ worktreePath,
118
+ dirtyStrategy: options.dirtyStrategy || policy.dirtyStrategy || 'block',
119
+ };
120
+ }
121
+
122
+ function printPlan(plan) {
123
+ console.log('worktree 规划完成:');
124
+ console.log(`- runId:${plan.runId}`);
125
+ console.log(`- baseBranch:${plan.baseBranch}`);
126
+ console.log(`- branch:${plan.branchName}`);
127
+ console.log(`- worktreePath:${plan.worktreePath}`);
128
+ console.log(`- dirtyStrategy:${plan.dirtyStrategy}`);
129
+ }
130
+
131
+ async function main(argv) {
132
+ const options = parseArgs(argv);
133
+ if (options.help || !options.command) {
134
+ printUsage();
135
+ return 0;
136
+ }
137
+
138
+ const { detector, policy } = resolveExecutionContext(options);
139
+ if (!detector.isGitRepository) {
140
+ console.log('目标目录不是 Git 仓库,无法执行 worktree 命令');
141
+ return 1;
142
+ }
143
+
144
+ if (options.command === 'dirty') {
145
+ const result = new DirtyChecker().check({ repoRoot: detector.repoRoot });
146
+ printDirty(result);
147
+ return 0;
148
+ }
149
+
150
+ if (options.command === 'plan') {
151
+ const plan = createPlan(options, detector, policy);
152
+ printPlan(plan);
153
+ return 0;
154
+ }
155
+
156
+ if (options.command === 'create') {
157
+ const plan = createPlan(options, detector, policy);
158
+ const dirtyResult = await new DirtyStrategyHandler().handle({
159
+ repoRoot: detector.repoRoot,
160
+ strategy: plan.dirtyStrategy,
161
+ runId: plan.runId,
162
+ requirementSummary: options.summary || '需求执行',
163
+ });
164
+ console.log(dirtyResult.message);
165
+ if (dirtyResult.warning) console.log(`警告:${dirtyResult.warning}`);
166
+ if (!dirtyResult.canContinue) return 1;
167
+
168
+ const result = await new WorktreeManager({ branchManager: new BranchManager() }).create({
169
+ repoRoot: detector.repoRoot,
170
+ baseBranch: plan.baseBranch,
171
+ branchPrefix: options.branchPrefix || policy.branchPrefix || 'ai',
172
+ worktreeRoot: options.worktreeRoot || policy.worktreeRoot || '../.ai-worktrees',
173
+ runId: plan.runId,
174
+ requirementSummary: options.summary || '需求执行',
175
+ });
176
+ if (!result.created) {
177
+ console.log('worktree 创建失败:');
178
+ for (const item of result.errors) console.log(`- [${item.code}] ${item.message}`);
179
+ return 1;
180
+ }
181
+ console.log('worktree 创建完成:');
182
+ console.log(`- branch:${result.branchName}`);
183
+ console.log(`- worktreePath:${result.worktreePath}`);
184
+ return 0;
185
+ }
186
+
187
+ throw new Error(`未知 worktree 子命令:${options.command}`);
188
+ }
189
+
190
+ module.exports = {
191
+ createPlan,
192
+ main,
193
+ parseArgs,
194
+ };
@@ -0,0 +1,15 @@
1
+ root = true
2
+
3
+ [*]
4
+ charset = utf-8
5
+ indent_style = space
6
+ indent_size = 2
7
+ end_of_line = lf
8
+ trim_trailing_whitespace = true
9
+ insert_final_newline = true
10
+
11
+ [*.md]
12
+ trim_trailing_whitespace = false
13
+
14
+ [Makefile]
15
+ indent_style = tab
@@ -0,0 +1,4 @@
1
+ #!/usr/bin/env sh
2
+ . "$(dirname -- "$0")/_/husky.sh"
3
+
4
+ npx commitlint --edit $1
@@ -0,0 +1,4 @@
1
+ #!/usr/bin/env sh
2
+ . "$(dirname -- "$0")/_/husky.sh"
3
+
4
+ npx lint-staged
@@ -0,0 +1,11 @@
1
+ {
2
+ "src/**/*.{vue,less,scss,css}": [
3
+ "stylelint --fix"
4
+ ],
5
+ "src/**/*.{js,ts,jsx,tsx,json,vue}": [
6
+ "eslint --fix"
7
+ ],
8
+ "src/**/*.{js,ts,jsx,tsx,json,vue,css,scss,less,md}": [
9
+ "prettier --write"
10
+ ]
11
+ }
@@ -0,0 +1,11 @@
1
+ node_modules
2
+ dist
3
+ lib
4
+ assets
5
+ public
6
+ .eslintrc.js
7
+ .eslintrc.cjs
8
+ .prettierignore
9
+ .stylelintrc
10
+ .stylelintrc.cjs
11
+ .stylelintrc.json
@@ -0,0 +1,11 @@
1
+ {
2
+ "$schema": "https://json.schemastore.org/prettierrc",
3
+ "semi": true,
4
+ "tabWidth": 2,
5
+ "singleQuote": true,
6
+ "printWidth": 100,
7
+ "trailingComma": "es5",
8
+ "endOfLine": "auto",
9
+ "arrowParens": "avoid",
10
+ "proseWrap": "never"
11
+ }
@@ -0,0 +1,14 @@
1
+ *.js
2
+ *.ts
3
+ *.tsx
4
+ *.png
5
+ *.eot
6
+ *.ttf
7
+ *.woff
8
+ *.puml
9
+ *.md
10
+ node_modules
11
+ dist
12
+ lib
13
+ assets
14
+ public