cgraphx 1.1.0

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 (936) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +243 -0
  3. package/dist/.claude-template/commands/my-commit.md +9 -0
  4. package/dist/.claude-template/commands/my-query.md +4 -0
  5. package/dist/.claude-template/hooks/context-monitor/context-monitor.cjs +216 -0
  6. package/dist/.claude-template/plugins/claude-hud/dist/claude-config-dir.d.ts +4 -0
  7. package/dist/.claude-template/plugins/claude-hud/dist/claude-config-dir.d.ts.map +1 -0
  8. package/dist/.claude-template/plugins/claude-hud/dist/claude-config-dir.js +24 -0
  9. package/dist/.claude-template/plugins/claude-hud/dist/claude-config-dir.js.map +1 -0
  10. package/dist/.claude-template/plugins/claude-hud/dist/config-reader.d.ts +8 -0
  11. package/dist/.claude-template/plugins/claude-hud/dist/config-reader.d.ts.map +1 -0
  12. package/dist/.claude-template/plugins/claude-hud/dist/config-reader.js +204 -0
  13. package/dist/.claude-template/plugins/claude-hud/dist/config-reader.js.map +1 -0
  14. package/dist/.claude-template/plugins/claude-hud/dist/config.d.ts +46 -0
  15. package/dist/.claude-template/plugins/claude-hud/dist/config.d.ts.map +1 -0
  16. package/dist/.claude-template/plugins/claude-hud/dist/config.js +220 -0
  17. package/dist/.claude-template/plugins/claude-hud/dist/config.js.map +1 -0
  18. package/dist/.claude-template/plugins/claude-hud/dist/constants.d.ts +10 -0
  19. package/dist/.claude-template/plugins/claude-hud/dist/constants.d.ts.map +1 -0
  20. package/dist/.claude-template/plugins/claude-hud/dist/constants.js +10 -0
  21. package/dist/.claude-template/plugins/claude-hud/dist/constants.js.map +1 -0
  22. package/dist/.claude-template/plugins/claude-hud/dist/debug.d.ts +6 -0
  23. package/dist/.claude-template/plugins/claude-hud/dist/debug.d.ts.map +1 -0
  24. package/dist/.claude-template/plugins/claude-hud/dist/debug.js +15 -0
  25. package/dist/.claude-template/plugins/claude-hud/dist/debug.js.map +1 -0
  26. package/dist/.claude-template/plugins/claude-hud/dist/extra-cmd.d.ts +23 -0
  27. package/dist/.claude-template/plugins/claude-hud/dist/extra-cmd.d.ts.map +1 -0
  28. package/dist/.claude-template/plugins/claude-hud/dist/extra-cmd.js +103 -0
  29. package/dist/.claude-template/plugins/claude-hud/dist/extra-cmd.js.map +1 -0
  30. package/dist/.claude-template/plugins/claude-hud/dist/git.d.ts +16 -0
  31. package/dist/.claude-template/plugins/claude-hud/dist/git.d.ts.map +1 -0
  32. package/dist/.claude-template/plugins/claude-hud/dist/git.js +86 -0
  33. package/dist/.claude-template/plugins/claude-hud/dist/git.js.map +1 -0
  34. package/dist/.claude-template/plugins/claude-hud/dist/index.d.ts +24 -0
  35. package/dist/.claude-template/plugins/claude-hud/dist/index.d.ts.map +1 -0
  36. package/dist/.claude-template/plugins/claude-hud/dist/index.js +97 -0
  37. package/dist/.claude-template/plugins/claude-hud/dist/index.js.map +1 -0
  38. package/dist/.claude-template/plugins/claude-hud/dist/render/agents-line.d.ts +3 -0
  39. package/dist/.claude-template/plugins/claude-hud/dist/render/agents-line.d.ts.map +1 -0
  40. package/dist/.claude-template/plugins/claude-hud/dist/render/agents-line.js +44 -0
  41. package/dist/.claude-template/plugins/claude-hud/dist/render/agents-line.js.map +1 -0
  42. package/dist/.claude-template/plugins/claude-hud/dist/render/colors.d.ts +12 -0
  43. package/dist/.claude-template/plugins/claude-hud/dist/render/colors.d.ts.map +1 -0
  44. package/dist/.claude-template/plugins/claude-hud/dist/render/colors.js +58 -0
  45. package/dist/.claude-template/plugins/claude-hud/dist/render/colors.js.map +1 -0
  46. package/dist/.claude-template/plugins/claude-hud/dist/render/index.d.ts +3 -0
  47. package/dist/.claude-template/plugins/claude-hud/dist/render/index.d.ts.map +1 -0
  48. package/dist/.claude-template/plugins/claude-hud/dist/render/index.js +379 -0
  49. package/dist/.claude-template/plugins/claude-hud/dist/render/index.js.map +1 -0
  50. package/dist/.claude-template/plugins/claude-hud/dist/render/lines/environment.d.ts +3 -0
  51. package/dist/.claude-template/plugins/claude-hud/dist/render/lines/environment.d.ts.map +1 -0
  52. package/dist/.claude-template/plugins/claude-hud/dist/render/lines/environment.js +30 -0
  53. package/dist/.claude-template/plugins/claude-hud/dist/render/lines/environment.js.map +1 -0
  54. package/dist/.claude-template/plugins/claude-hud/dist/render/lines/identity.d.ts +3 -0
  55. package/dist/.claude-template/plugins/claude-hud/dist/render/lines/identity.d.ts.map +1 -0
  56. package/dist/.claude-template/plugins/claude-hud/dist/render/lines/identity.js +52 -0
  57. package/dist/.claude-template/plugins/claude-hud/dist/render/lines/identity.js.map +1 -0
  58. package/dist/.claude-template/plugins/claude-hud/dist/render/lines/index.d.ts +5 -0
  59. package/dist/.claude-template/plugins/claude-hud/dist/render/lines/index.d.ts.map +1 -0
  60. package/dist/.claude-template/plugins/claude-hud/dist/render/lines/index.js +5 -0
  61. package/dist/.claude-template/plugins/claude-hud/dist/render/lines/index.js.map +1 -0
  62. package/dist/.claude-template/plugins/claude-hud/dist/render/lines/project.d.ts +3 -0
  63. package/dist/.claude-template/plugins/claude-hud/dist/render/lines/project.d.ts.map +1 -0
  64. package/dist/.claude-template/plugins/claude-hud/dist/render/lines/project.js +74 -0
  65. package/dist/.claude-template/plugins/claude-hud/dist/render/lines/project.js.map +1 -0
  66. package/dist/.claude-template/plugins/claude-hud/dist/render/lines/usage.d.ts +3 -0
  67. package/dist/.claude-template/plugins/claude-hud/dist/render/lines/usage.d.ts.map +1 -0
  68. package/dist/.claude-template/plugins/claude-hud/dist/render/lines/usage.js +92 -0
  69. package/dist/.claude-template/plugins/claude-hud/dist/render/lines/usage.js.map +1 -0
  70. package/dist/.claude-template/plugins/claude-hud/dist/render/session-line.d.ts +7 -0
  71. package/dist/.claude-template/plugins/claude-hud/dist/render/session-line.d.ts.map +1 -0
  72. package/dist/.claude-template/plugins/claude-hud/dist/render/session-line.js +247 -0
  73. package/dist/.claude-template/plugins/claude-hud/dist/render/session-line.js.map +1 -0
  74. package/dist/.claude-template/plugins/claude-hud/dist/render/todos-line.d.ts +3 -0
  75. package/dist/.claude-template/plugins/claude-hud/dist/render/todos-line.d.ts.map +1 -0
  76. package/dist/.claude-template/plugins/claude-hud/dist/render/todos-line.js +25 -0
  77. package/dist/.claude-template/plugins/claude-hud/dist/render/todos-line.js.map +1 -0
  78. package/dist/.claude-template/plugins/claude-hud/dist/render/tools-line.d.ts +3 -0
  79. package/dist/.claude-template/plugins/claude-hud/dist/render/tools-line.d.ts.map +1 -0
  80. package/dist/.claude-template/plugins/claude-hud/dist/render/tools-line.js +43 -0
  81. package/dist/.claude-template/plugins/claude-hud/dist/render/tools-line.js.map +1 -0
  82. package/dist/.claude-template/plugins/claude-hud/dist/speed-tracker.d.ts +7 -0
  83. package/dist/.claude-template/plugins/claude-hud/dist/speed-tracker.d.ts.map +1 -0
  84. package/dist/.claude-template/plugins/claude-hud/dist/speed-tracker.js +62 -0
  85. package/dist/.claude-template/plugins/claude-hud/dist/speed-tracker.js.map +1 -0
  86. package/dist/.claude-template/plugins/claude-hud/dist/stdin.d.ts +9 -0
  87. package/dist/.claude-template/plugins/claude-hud/dist/stdin.d.ts.map +1 -0
  88. package/dist/.claude-template/plugins/claude-hud/dist/stdin.js +136 -0
  89. package/dist/.claude-template/plugins/claude-hud/dist/stdin.js.map +1 -0
  90. package/dist/.claude-template/plugins/claude-hud/dist/transcript.d.ts +3 -0
  91. package/dist/.claude-template/plugins/claude-hud/dist/transcript.d.ts.map +1 -0
  92. package/dist/.claude-template/plugins/claude-hud/dist/transcript.js +189 -0
  93. package/dist/.claude-template/plugins/claude-hud/dist/transcript.js.map +1 -0
  94. package/dist/.claude-template/plugins/claude-hud/dist/types.d.ts +79 -0
  95. package/dist/.claude-template/plugins/claude-hud/dist/types.d.ts.map +1 -0
  96. package/dist/.claude-template/plugins/claude-hud/dist/types.js +5 -0
  97. package/dist/.claude-template/plugins/claude-hud/dist/types.js.map +1 -0
  98. package/dist/.claude-template/plugins/claude-hud/dist/usage-api.d.ts +59 -0
  99. package/dist/.claude-template/plugins/claude-hud/dist/usage-api.d.ts.map +1 -0
  100. package/dist/.claude-template/plugins/claude-hud/dist/usage-api.js +733 -0
  101. package/dist/.claude-template/plugins/claude-hud/dist/usage-api.js.map +1 -0
  102. package/dist/.claude-template/skills/cgraphx/SKILL.md +143 -0
  103. package/dist/.claude-template/skills/cgraphx/agent-prompt.md +56 -0
  104. package/dist/.claude-template/skills/clarify-requirements/SKILL.md +425 -0
  105. package/dist/.claude-template/skills/code-impact-api/SKILL.md +143 -0
  106. package/dist/.claude-template/skills/code-impact-api/agent-prompt.md +51 -0
  107. package/dist/.claude-template/skills/code-impact-docgen/SKILL.md +366 -0
  108. package/dist/.claude-template/skills/code-impact-docgen/template-business-html.md +242 -0
  109. package/dist/.claude-template/skills/code-impact-docgen/template-business-md.md +107 -0
  110. package/dist/.claude-template/skills/code-impact-docgen/template-technical-html.md +205 -0
  111. package/dist/.claude-template/skills/code-impact-docgen/template-technical-md.md +155 -0
  112. package/dist/.claude-template/skills/code-impact-init/SKILL.md +800 -0
  113. package/dist/.claude-template/skills/code-impact-markdown/SKILL.md +345 -0
  114. package/dist/.claude-template/skills/code-impact-markdown/template-guide.md +68 -0
  115. package/dist/.claude-template/skills/code-impact-markdown/template-memory.md +82 -0
  116. package/dist/.claude-template/skills/code-impact-markdown/template-runbook.md +58 -0
  117. package/dist/.claude-template/skills/db-query/SKILL.md +166 -0
  118. package/dist/.claude-template/skills/db-query/agent-prompt.md +55 -0
  119. package/dist/.claude-template/skills/developer-timeline/SKILL.md +302 -0
  120. package/dist/.claude-template/skills/developer-timeline/demo-single-page-report.html +657 -0
  121. package/dist/.claude-template/skills/implementation/SKILL.md +136 -0
  122. package/dist/.claude-template/skills/subagent-implement/SKILL.md +225 -0
  123. package/dist/.claude-template/skills/subagent-implement/implementer-prompt.md +127 -0
  124. package/dist/.claude-template/skills/subagent-implement/quality-reviewer-prompt.md +130 -0
  125. package/dist/.claude-template/skills/subagent-implement/spec-reviewer-prompt.md +112 -0
  126. package/dist/.claude-template/skills/write-plan/SKILL.md +322 -0
  127. package/dist/.claude-template/skills/write-plan/plan-document-reviewer-prompt.md +134 -0
  128. package/dist/.claude-template/skills/write-prd/SKILL.md +242 -0
  129. package/dist/.claude-template/skills/write-spec/SKILL.md +278 -0
  130. package/dist/bin/codegraph.d.ts +26 -0
  131. package/dist/bin/codegraph.d.ts.map +1 -0
  132. package/dist/bin/codegraph.js +2014 -0
  133. package/dist/bin/codegraph.js.map +1 -0
  134. package/dist/bin/fatal-handler.d.ts +20 -0
  135. package/dist/bin/fatal-handler.d.ts.map +1 -0
  136. package/dist/bin/fatal-handler.js +118 -0
  137. package/dist/bin/fatal-handler.js.map +1 -0
  138. package/dist/bin/node-version-check.d.ts +51 -0
  139. package/dist/bin/node-version-check.d.ts.map +1 -0
  140. package/dist/bin/node-version-check.js +114 -0
  141. package/dist/bin/node-version-check.js.map +1 -0
  142. package/dist/bin/uninstall.d.ts +14 -0
  143. package/dist/bin/uninstall.d.ts.map +1 -0
  144. package/dist/bin/uninstall.js +36 -0
  145. package/dist/bin/uninstall.js.map +1 -0
  146. package/dist/context/formatter.d.ts +30 -0
  147. package/dist/context/formatter.d.ts.map +1 -0
  148. package/dist/context/formatter.js +263 -0
  149. package/dist/context/formatter.js.map +1 -0
  150. package/dist/context/index.d.ts +119 -0
  151. package/dist/context/index.d.ts.map +1 -0
  152. package/dist/context/index.js +1296 -0
  153. package/dist/context/index.js.map +1 -0
  154. package/dist/context/markers.d.ts +19 -0
  155. package/dist/context/markers.d.ts.map +1 -0
  156. package/dist/context/markers.js +22 -0
  157. package/dist/context/markers.js.map +1 -0
  158. package/dist/db/index.d.ts +122 -0
  159. package/dist/db/index.d.ts.map +1 -0
  160. package/dist/db/index.js +296 -0
  161. package/dist/db/index.js.map +1 -0
  162. package/dist/db/migrations.d.ts +44 -0
  163. package/dist/db/migrations.d.ts.map +1 -0
  164. package/dist/db/migrations.js +140 -0
  165. package/dist/db/migrations.js.map +1 -0
  166. package/dist/db/queries.d.ts +401 -0
  167. package/dist/db/queries.d.ts.map +1 -0
  168. package/dist/db/queries.js +1591 -0
  169. package/dist/db/queries.js.map +1 -0
  170. package/dist/db/schema.sql +152 -0
  171. package/dist/db/sqlite-adapter.d.ts +53 -0
  172. package/dist/db/sqlite-adapter.d.ts.map +1 -0
  173. package/dist/db/sqlite-adapter.js +117 -0
  174. package/dist/db/sqlite-adapter.js.map +1 -0
  175. package/dist/dbquery/cli.d.ts +17 -0
  176. package/dist/dbquery/cli.d.ts.map +1 -0
  177. package/dist/dbquery/cli.js +229 -0
  178. package/dist/dbquery/cli.js.map +1 -0
  179. package/dist/dbquery/config.d.ts +38 -0
  180. package/dist/dbquery/config.d.ts.map +1 -0
  181. package/dist/dbquery/config.js +244 -0
  182. package/dist/dbquery/config.js.map +1 -0
  183. package/dist/dbquery/constants.d.ts +40 -0
  184. package/dist/dbquery/constants.d.ts.map +1 -0
  185. package/dist/dbquery/constants.js +65 -0
  186. package/dist/dbquery/constants.js.map +1 -0
  187. package/dist/dbquery/drivers/mysql.d.ts +15 -0
  188. package/dist/dbquery/drivers/mysql.d.ts.map +1 -0
  189. package/dist/dbquery/drivers/mysql.js +102 -0
  190. package/dist/dbquery/drivers/mysql.js.map +1 -0
  191. package/dist/dbquery/drivers/postgres.d.ts +16 -0
  192. package/dist/dbquery/drivers/postgres.d.ts.map +1 -0
  193. package/dist/dbquery/drivers/postgres.js +105 -0
  194. package/dist/dbquery/drivers/postgres.js.map +1 -0
  195. package/dist/dbquery/errors.d.ts +40 -0
  196. package/dist/dbquery/errors.d.ts.map +1 -0
  197. package/dist/dbquery/errors.js +85 -0
  198. package/dist/dbquery/errors.js.map +1 -0
  199. package/dist/dbquery/executor.d.ts +30 -0
  200. package/dist/dbquery/executor.d.ts.map +1 -0
  201. package/dist/dbquery/executor.js +243 -0
  202. package/dist/dbquery/executor.js.map +1 -0
  203. package/dist/dbquery/format.d.ts +18 -0
  204. package/dist/dbquery/format.d.ts.map +1 -0
  205. package/dist/dbquery/format.js +174 -0
  206. package/dist/dbquery/format.js.map +1 -0
  207. package/dist/dbquery/index.d.ts +10 -0
  208. package/dist/dbquery/index.d.ts.map +1 -0
  209. package/dist/dbquery/index.js +23 -0
  210. package/dist/dbquery/index.js.map +1 -0
  211. package/dist/dbquery/init.d.ts +33 -0
  212. package/dist/dbquery/init.d.ts.map +1 -0
  213. package/dist/dbquery/init.js +125 -0
  214. package/dist/dbquery/init.js.map +1 -0
  215. package/dist/dbquery/logging.d.ts +22 -0
  216. package/dist/dbquery/logging.d.ts.map +1 -0
  217. package/dist/dbquery/logging.js +140 -0
  218. package/dist/dbquery/logging.js.map +1 -0
  219. package/dist/dbquery/mcp-tools.d.ts +29 -0
  220. package/dist/dbquery/mcp-tools.d.ts.map +1 -0
  221. package/dist/dbquery/mcp-tools.js +206 -0
  222. package/dist/dbquery/mcp-tools.js.map +1 -0
  223. package/dist/dbquery/queries.d.ts +31 -0
  224. package/dist/dbquery/queries.d.ts.map +1 -0
  225. package/dist/dbquery/queries.js +160 -0
  226. package/dist/dbquery/queries.js.map +1 -0
  227. package/dist/dbquery/safety.d.ts +35 -0
  228. package/dist/dbquery/safety.d.ts.map +1 -0
  229. package/dist/dbquery/safety.js +306 -0
  230. package/dist/dbquery/safety.js.map +1 -0
  231. package/dist/dbquery/types.d.ts +152 -0
  232. package/dist/dbquery/types.d.ts.map +1 -0
  233. package/dist/dbquery/types.js +10 -0
  234. package/dist/dbquery/types.js.map +1 -0
  235. package/dist/directory.d.ts +147 -0
  236. package/dist/directory.d.ts.map +1 -0
  237. package/dist/directory.js +523 -0
  238. package/dist/directory.js.map +1 -0
  239. package/dist/errors.d.ts +136 -0
  240. package/dist/errors.d.ts.map +1 -0
  241. package/dist/errors.js +219 -0
  242. package/dist/errors.js.map +1 -0
  243. package/dist/extraction/astro-extractor.d.ts +79 -0
  244. package/dist/extraction/astro-extractor.d.ts.map +1 -0
  245. package/dist/extraction/astro-extractor.js +320 -0
  246. package/dist/extraction/astro-extractor.js.map +1 -0
  247. package/dist/extraction/dfm-extractor.d.ts +31 -0
  248. package/dist/extraction/dfm-extractor.d.ts.map +1 -0
  249. package/dist/extraction/dfm-extractor.js +151 -0
  250. package/dist/extraction/dfm-extractor.js.map +1 -0
  251. package/dist/extraction/extraction-version.d.ts +25 -0
  252. package/dist/extraction/extraction-version.d.ts.map +1 -0
  253. package/dist/extraction/extraction-version.js +28 -0
  254. package/dist/extraction/extraction-version.js.map +1 -0
  255. package/dist/extraction/function-ref.d.ts +118 -0
  256. package/dist/extraction/function-ref.d.ts.map +1 -0
  257. package/dist/extraction/function-ref.js +727 -0
  258. package/dist/extraction/function-ref.js.map +1 -0
  259. package/dist/extraction/generated-detection.d.ts +30 -0
  260. package/dist/extraction/generated-detection.d.ts.map +1 -0
  261. package/dist/extraction/generated-detection.js +83 -0
  262. package/dist/extraction/generated-detection.js.map +1 -0
  263. package/dist/extraction/grammars.d.ts +114 -0
  264. package/dist/extraction/grammars.d.ts.map +1 -0
  265. package/dist/extraction/grammars.js +477 -0
  266. package/dist/extraction/grammars.js.map +1 -0
  267. package/dist/extraction/index.d.ts +175 -0
  268. package/dist/extraction/index.d.ts.map +1 -0
  269. package/dist/extraction/index.js +1887 -0
  270. package/dist/extraction/index.js.map +1 -0
  271. package/dist/extraction/languages/c-cpp.d.ts +12 -0
  272. package/dist/extraction/languages/c-cpp.d.ts.map +1 -0
  273. package/dist/extraction/languages/c-cpp.js +275 -0
  274. package/dist/extraction/languages/c-cpp.js.map +1 -0
  275. package/dist/extraction/languages/csharp.d.ts +25 -0
  276. package/dist/extraction/languages/csharp.d.ts.map +1 -0
  277. package/dist/extraction/languages/csharp.js +175 -0
  278. package/dist/extraction/languages/csharp.js.map +1 -0
  279. package/dist/extraction/languages/dart.d.ts +3 -0
  280. package/dist/extraction/languages/dart.d.ts.map +1 -0
  281. package/dist/extraction/languages/dart.js +374 -0
  282. package/dist/extraction/languages/dart.js.map +1 -0
  283. package/dist/extraction/languages/go.d.ts +3 -0
  284. package/dist/extraction/languages/go.d.ts.map +1 -0
  285. package/dist/extraction/languages/go.js +111 -0
  286. package/dist/extraction/languages/go.js.map +1 -0
  287. package/dist/extraction/languages/index.d.ts +10 -0
  288. package/dist/extraction/languages/index.d.ts.map +1 -0
  289. package/dist/extraction/languages/index.js +53 -0
  290. package/dist/extraction/languages/index.js.map +1 -0
  291. package/dist/extraction/languages/java.d.ts +3 -0
  292. package/dist/extraction/languages/java.d.ts.map +1 -0
  293. package/dist/extraction/languages/java.js +315 -0
  294. package/dist/extraction/languages/java.js.map +1 -0
  295. package/dist/extraction/languages/javascript.d.ts +3 -0
  296. package/dist/extraction/languages/javascript.d.ts.map +1 -0
  297. package/dist/extraction/languages/javascript.js +106 -0
  298. package/dist/extraction/languages/javascript.js.map +1 -0
  299. package/dist/extraction/languages/kotlin.d.ts +3 -0
  300. package/dist/extraction/languages/kotlin.d.ts.map +1 -0
  301. package/dist/extraction/languages/kotlin.js +379 -0
  302. package/dist/extraction/languages/kotlin.js.map +1 -0
  303. package/dist/extraction/languages/lua.d.ts +3 -0
  304. package/dist/extraction/languages/lua.d.ts.map +1 -0
  305. package/dist/extraction/languages/lua.js +150 -0
  306. package/dist/extraction/languages/lua.js.map +1 -0
  307. package/dist/extraction/languages/luau.d.ts +3 -0
  308. package/dist/extraction/languages/luau.d.ts.map +1 -0
  309. package/dist/extraction/languages/luau.js +37 -0
  310. package/dist/extraction/languages/luau.js.map +1 -0
  311. package/dist/extraction/languages/objc.d.ts +3 -0
  312. package/dist/extraction/languages/objc.d.ts.map +1 -0
  313. package/dist/extraction/languages/objc.js +175 -0
  314. package/dist/extraction/languages/objc.js.map +1 -0
  315. package/dist/extraction/languages/pascal.d.ts +3 -0
  316. package/dist/extraction/languages/pascal.d.ts.map +1 -0
  317. package/dist/extraction/languages/pascal.js +77 -0
  318. package/dist/extraction/languages/pascal.js.map +1 -0
  319. package/dist/extraction/languages/php.d.ts +3 -0
  320. package/dist/extraction/languages/php.d.ts.map +1 -0
  321. package/dist/extraction/languages/php.js +196 -0
  322. package/dist/extraction/languages/php.js.map +1 -0
  323. package/dist/extraction/languages/python.d.ts +3 -0
  324. package/dist/extraction/languages/python.d.ts.map +1 -0
  325. package/dist/extraction/languages/python.js +56 -0
  326. package/dist/extraction/languages/python.js.map +1 -0
  327. package/dist/extraction/languages/r.d.ts +3 -0
  328. package/dist/extraction/languages/r.d.ts.map +1 -0
  329. package/dist/extraction/languages/r.js +314 -0
  330. package/dist/extraction/languages/r.js.map +1 -0
  331. package/dist/extraction/languages/ruby.d.ts +3 -0
  332. package/dist/extraction/languages/ruby.d.ts.map +1 -0
  333. package/dist/extraction/languages/ruby.js +149 -0
  334. package/dist/extraction/languages/ruby.js.map +1 -0
  335. package/dist/extraction/languages/rust.d.ts +3 -0
  336. package/dist/extraction/languages/rust.d.ts.map +1 -0
  337. package/dist/extraction/languages/rust.js +142 -0
  338. package/dist/extraction/languages/rust.js.map +1 -0
  339. package/dist/extraction/languages/scala.d.ts +3 -0
  340. package/dist/extraction/languages/scala.d.ts.map +1 -0
  341. package/dist/extraction/languages/scala.js +209 -0
  342. package/dist/extraction/languages/scala.js.map +1 -0
  343. package/dist/extraction/languages/swift.d.ts +3 -0
  344. package/dist/extraction/languages/swift.d.ts.map +1 -0
  345. package/dist/extraction/languages/swift.js +152 -0
  346. package/dist/extraction/languages/swift.js.map +1 -0
  347. package/dist/extraction/languages/typescript.d.ts +16 -0
  348. package/dist/extraction/languages/typescript.d.ts.map +1 -0
  349. package/dist/extraction/languages/typescript.js +167 -0
  350. package/dist/extraction/languages/typescript.js.map +1 -0
  351. package/dist/extraction/liquid-extractor.d.ts +59 -0
  352. package/dist/extraction/liquid-extractor.d.ts.map +1 -0
  353. package/dist/extraction/liquid-extractor.js +357 -0
  354. package/dist/extraction/liquid-extractor.js.map +1 -0
  355. package/dist/extraction/mybatis-extractor.d.ts +48 -0
  356. package/dist/extraction/mybatis-extractor.d.ts.map +1 -0
  357. package/dist/extraction/mybatis-extractor.js +198 -0
  358. package/dist/extraction/mybatis-extractor.js.map +1 -0
  359. package/dist/extraction/parse-worker.d.ts +8 -0
  360. package/dist/extraction/parse-worker.d.ts.map +1 -0
  361. package/dist/extraction/parse-worker.js +97 -0
  362. package/dist/extraction/parse-worker.js.map +1 -0
  363. package/dist/extraction/razor-extractor.d.ts +42 -0
  364. package/dist/extraction/razor-extractor.d.ts.map +1 -0
  365. package/dist/extraction/razor-extractor.js +285 -0
  366. package/dist/extraction/razor-extractor.js.map +1 -0
  367. package/dist/extraction/svelte-extractor.d.ts +56 -0
  368. package/dist/extraction/svelte-extractor.d.ts.map +1 -0
  369. package/dist/extraction/svelte-extractor.js +275 -0
  370. package/dist/extraction/svelte-extractor.js.map +1 -0
  371. package/dist/extraction/tree-sitter-helpers.d.ts +28 -0
  372. package/dist/extraction/tree-sitter-helpers.d.ts.map +1 -0
  373. package/dist/extraction/tree-sitter-helpers.js +152 -0
  374. package/dist/extraction/tree-sitter-helpers.js.map +1 -0
  375. package/dist/extraction/tree-sitter-types.d.ts +239 -0
  376. package/dist/extraction/tree-sitter-types.d.ts.map +1 -0
  377. package/dist/extraction/tree-sitter-types.js +10 -0
  378. package/dist/extraction/tree-sitter-types.js.map +1 -0
  379. package/dist/extraction/tree-sitter.d.ts +647 -0
  380. package/dist/extraction/tree-sitter.d.ts.map +1 -0
  381. package/dist/extraction/tree-sitter.js +5592 -0
  382. package/dist/extraction/tree-sitter.js.map +1 -0
  383. package/dist/extraction/vue-extractor.d.ts +51 -0
  384. package/dist/extraction/vue-extractor.d.ts.map +1 -0
  385. package/dist/extraction/vue-extractor.js +254 -0
  386. package/dist/extraction/vue-extractor.js.map +1 -0
  387. package/dist/extraction/wasm/tree-sitter-c_sharp.wasm +0 -0
  388. package/dist/extraction/wasm/tree-sitter-lua.wasm +0 -0
  389. package/dist/extraction/wasm/tree-sitter-luau.wasm +0 -0
  390. package/dist/extraction/wasm/tree-sitter-pascal.wasm +0 -0
  391. package/dist/extraction/wasm/tree-sitter-r.wasm +0 -0
  392. package/dist/extraction/wasm/tree-sitter-scala.wasm +0 -0
  393. package/dist/extraction/wasm-runtime-flags.d.ts +38 -0
  394. package/dist/extraction/wasm-runtime-flags.d.ts.map +1 -0
  395. package/dist/extraction/wasm-runtime-flags.js +106 -0
  396. package/dist/extraction/wasm-runtime-flags.js.map +1 -0
  397. package/dist/graph/index.d.ts +8 -0
  398. package/dist/graph/index.d.ts.map +1 -0
  399. package/dist/graph/index.js +13 -0
  400. package/dist/graph/index.js.map +1 -0
  401. package/dist/graph/queries.d.ts +106 -0
  402. package/dist/graph/queries.d.ts.map +1 -0
  403. package/dist/graph/queries.js +339 -0
  404. package/dist/graph/queries.js.map +1 -0
  405. package/dist/graph/traversal.d.ts +127 -0
  406. package/dist/graph/traversal.d.ts.map +1 -0
  407. package/dist/graph/traversal.js +540 -0
  408. package/dist/graph/traversal.js.map +1 -0
  409. package/dist/index.d.ts +563 -0
  410. package/dist/index.d.ts.map +1 -0
  411. package/dist/index.js +1041 -0
  412. package/dist/index.js.map +1 -0
  413. package/dist/installer/claude-assets.d.ts +45 -0
  414. package/dist/installer/claude-assets.d.ts.map +1 -0
  415. package/dist/installer/claude-assets.js +144 -0
  416. package/dist/installer/claude-assets.js.map +1 -0
  417. package/dist/installer/config-writer.d.ts +28 -0
  418. package/dist/installer/config-writer.d.ts.map +1 -0
  419. package/dist/installer/config-writer.js +91 -0
  420. package/dist/installer/config-writer.js.map +1 -0
  421. package/dist/installer/index.d.ts +101 -0
  422. package/dist/installer/index.d.ts.map +1 -0
  423. package/dist/installer/index.js +692 -0
  424. package/dist/installer/index.js.map +1 -0
  425. package/dist/installer/instructions-template.d.ts +41 -0
  426. package/dist/installer/instructions-template.d.ts.map +1 -0
  427. package/dist/installer/instructions-template.js +53 -0
  428. package/dist/installer/instructions-template.js.map +1 -0
  429. package/dist/installer/targets/antigravity.d.ts +57 -0
  430. package/dist/installer/targets/antigravity.d.ts.map +1 -0
  431. package/dist/installer/targets/antigravity.js +308 -0
  432. package/dist/installer/targets/antigravity.js.map +1 -0
  433. package/dist/installer/targets/claude.d.ts +66 -0
  434. package/dist/installer/targets/claude.d.ts.map +1 -0
  435. package/dist/installer/targets/claude.js +564 -0
  436. package/dist/installer/targets/claude.js.map +1 -0
  437. package/dist/installer/targets/codex.d.ts +18 -0
  438. package/dist/installer/targets/codex.d.ts.map +1 -0
  439. package/dist/installer/targets/codex.js +185 -0
  440. package/dist/installer/targets/codex.js.map +1 -0
  441. package/dist/installer/targets/cursor.d.ts +35 -0
  442. package/dist/installer/targets/cursor.d.ts.map +1 -0
  443. package/dist/installer/targets/cursor.js +254 -0
  444. package/dist/installer/targets/cursor.js.map +1 -0
  445. package/dist/installer/targets/gemini.d.ts +26 -0
  446. package/dist/installer/targets/gemini.d.ts.map +1 -0
  447. package/dist/installer/targets/gemini.js +165 -0
  448. package/dist/installer/targets/gemini.js.map +1 -0
  449. package/dist/installer/targets/hermes.d.ts +18 -0
  450. package/dist/installer/targets/hermes.d.ts.map +1 -0
  451. package/dist/installer/targets/hermes.js +359 -0
  452. package/dist/installer/targets/hermes.js.map +1 -0
  453. package/dist/installer/targets/kiro.d.ts +27 -0
  454. package/dist/installer/targets/kiro.d.ts.map +1 -0
  455. package/dist/installer/targets/kiro.js +178 -0
  456. package/dist/installer/targets/kiro.js.map +1 -0
  457. package/dist/installer/targets/opencode.d.ts +38 -0
  458. package/dist/installer/targets/opencode.d.ts.map +1 -0
  459. package/dist/installer/targets/opencode.js +288 -0
  460. package/dist/installer/targets/opencode.js.map +1 -0
  461. package/dist/installer/targets/registry.d.ts +35 -0
  462. package/dist/installer/targets/registry.d.ts.map +1 -0
  463. package/dist/installer/targets/registry.js +91 -0
  464. package/dist/installer/targets/registry.js.map +1 -0
  465. package/dist/installer/targets/shared.d.ts +101 -0
  466. package/dist/installer/targets/shared.d.ts.map +1 -0
  467. package/dist/installer/targets/shared.js +264 -0
  468. package/dist/installer/targets/shared.js.map +1 -0
  469. package/dist/installer/targets/toml.d.ts +52 -0
  470. package/dist/installer/targets/toml.d.ts.map +1 -0
  471. package/dist/installer/targets/toml.js +147 -0
  472. package/dist/installer/targets/toml.js.map +1 -0
  473. package/dist/installer/targets/types.d.ts +108 -0
  474. package/dist/installer/targets/types.d.ts.map +1 -0
  475. package/dist/installer/targets/types.js +16 -0
  476. package/dist/installer/targets/types.js.map +1 -0
  477. package/dist/markdown/cli.d.ts +16 -0
  478. package/dist/markdown/cli.d.ts.map +1 -0
  479. package/dist/markdown/cli.js +533 -0
  480. package/dist/markdown/cli.js.map +1 -0
  481. package/dist/markdown/constants.d.ts +22 -0
  482. package/dist/markdown/constants.d.ts.map +1 -0
  483. package/dist/markdown/constants.js +71 -0
  484. package/dist/markdown/constants.js.map +1 -0
  485. package/dist/markdown/dedup.d.ts +20 -0
  486. package/dist/markdown/dedup.d.ts.map +1 -0
  487. package/dist/markdown/dedup.js +64 -0
  488. package/dist/markdown/dedup.js.map +1 -0
  489. package/dist/markdown/errors.d.ts +22 -0
  490. package/dist/markdown/errors.d.ts.map +1 -0
  491. package/dist/markdown/errors.js +45 -0
  492. package/dist/markdown/errors.js.map +1 -0
  493. package/dist/markdown/extractor.d.ts +43 -0
  494. package/dist/markdown/extractor.d.ts.map +1 -0
  495. package/dist/markdown/extractor.js +152 -0
  496. package/dist/markdown/extractor.js.map +1 -0
  497. package/dist/markdown/frontmatter-parser.d.ts +47 -0
  498. package/dist/markdown/frontmatter-parser.d.ts.map +1 -0
  499. package/dist/markdown/frontmatter-parser.js +199 -0
  500. package/dist/markdown/frontmatter-parser.js.map +1 -0
  501. package/dist/markdown/indexer.d.ts +34 -0
  502. package/dist/markdown/indexer.d.ts.map +1 -0
  503. package/dist/markdown/indexer.js +256 -0
  504. package/dist/markdown/indexer.js.map +1 -0
  505. package/dist/markdown/mcp-tools.d.ts +33 -0
  506. package/dist/markdown/mcp-tools.d.ts.map +1 -0
  507. package/dist/markdown/mcp-tools.js +300 -0
  508. package/dist/markdown/mcp-tools.js.map +1 -0
  509. package/dist/markdown/query.d.ts +108 -0
  510. package/dist/markdown/query.d.ts.map +1 -0
  511. package/dist/markdown/query.js +570 -0
  512. package/dist/markdown/query.js.map +1 -0
  513. package/dist/markdown/schema-bootstrap.d.ts +40 -0
  514. package/dist/markdown/schema-bootstrap.d.ts.map +1 -0
  515. package/dist/markdown/schema-bootstrap.js +85 -0
  516. package/dist/markdown/schema-bootstrap.js.map +1 -0
  517. package/dist/markdown/schema.sql +124 -0
  518. package/dist/markdown/store.d.ts +77 -0
  519. package/dist/markdown/store.d.ts.map +1 -0
  520. package/dist/markdown/store.js +194 -0
  521. package/dist/markdown/store.js.map +1 -0
  522. package/dist/markdown/summary-extractor.d.ts +22 -0
  523. package/dist/markdown/summary-extractor.d.ts.map +1 -0
  524. package/dist/markdown/summary-extractor.js +66 -0
  525. package/dist/markdown/summary-extractor.js.map +1 -0
  526. package/dist/markdown/types.d.ts +159 -0
  527. package/dist/markdown/types.d.ts.map +1 -0
  528. package/dist/markdown/types.js +9 -0
  529. package/dist/markdown/types.js.map +1 -0
  530. package/dist/markdown/validator.d.ts +44 -0
  531. package/dist/markdown/validator.d.ts.map +1 -0
  532. package/dist/markdown/validator.js +95 -0
  533. package/dist/markdown/validator.js.map +1 -0
  534. package/dist/mcp/daemon-manager.d.ts +42 -0
  535. package/dist/mcp/daemon-manager.d.ts.map +1 -0
  536. package/dist/mcp/daemon-manager.js +129 -0
  537. package/dist/mcp/daemon-manager.js.map +1 -0
  538. package/dist/mcp/daemon-paths.d.ts +46 -0
  539. package/dist/mcp/daemon-paths.d.ts.map +1 -0
  540. package/dist/mcp/daemon-paths.js +125 -0
  541. package/dist/mcp/daemon-paths.js.map +1 -0
  542. package/dist/mcp/daemon-registry.d.ts +47 -0
  543. package/dist/mcp/daemon-registry.d.ts.map +1 -0
  544. package/dist/mcp/daemon-registry.js +229 -0
  545. package/dist/mcp/daemon-registry.js.map +1 -0
  546. package/dist/mcp/daemon.d.ts +220 -0
  547. package/dist/mcp/daemon.d.ts.map +1 -0
  548. package/dist/mcp/daemon.js +637 -0
  549. package/dist/mcp/daemon.js.map +1 -0
  550. package/dist/mcp/dynamic-boundaries.d.ts +41 -0
  551. package/dist/mcp/dynamic-boundaries.d.ts.map +1 -0
  552. package/dist/mcp/dynamic-boundaries.js +359 -0
  553. package/dist/mcp/dynamic-boundaries.js.map +1 -0
  554. package/dist/mcp/engine.d.ts +105 -0
  555. package/dist/mcp/engine.d.ts.map +1 -0
  556. package/dist/mcp/engine.js +278 -0
  557. package/dist/mcp/engine.js.map +1 -0
  558. package/dist/mcp/index.d.ts +113 -0
  559. package/dist/mcp/index.d.ts.map +1 -0
  560. package/dist/mcp/index.js +499 -0
  561. package/dist/mcp/index.js.map +1 -0
  562. package/dist/mcp/liveness-watchdog.d.ts +18 -0
  563. package/dist/mcp/liveness-watchdog.d.ts.map +1 -0
  564. package/dist/mcp/liveness-watchdog.js +207 -0
  565. package/dist/mcp/liveness-watchdog.js.map +1 -0
  566. package/dist/mcp/ppid-watchdog.d.ts +44 -0
  567. package/dist/mcp/ppid-watchdog.d.ts.map +1 -0
  568. package/dist/mcp/ppid-watchdog.js +27 -0
  569. package/dist/mcp/ppid-watchdog.js.map +1 -0
  570. package/dist/mcp/proxy.d.ts +87 -0
  571. package/dist/mcp/proxy.d.ts.map +1 -0
  572. package/dist/mcp/proxy.js +641 -0
  573. package/dist/mcp/proxy.js.map +1 -0
  574. package/dist/mcp/server-instructions.d.ts +34 -0
  575. package/dist/mcp/server-instructions.d.ts.map +1 -0
  576. package/dist/mcp/server-instructions.js +106 -0
  577. package/dist/mcp/server-instructions.js.map +1 -0
  578. package/dist/mcp/session.d.ts +79 -0
  579. package/dist/mcp/session.d.ts.map +1 -0
  580. package/dist/mcp/session.js +330 -0
  581. package/dist/mcp/session.js.map +1 -0
  582. package/dist/mcp/stdin-teardown.d.ts +27 -0
  583. package/dist/mcp/stdin-teardown.d.ts.map +1 -0
  584. package/dist/mcp/stdin-teardown.js +49 -0
  585. package/dist/mcp/stdin-teardown.js.map +1 -0
  586. package/dist/mcp/tools.d.ts +547 -0
  587. package/dist/mcp/tools.d.ts.map +1 -0
  588. package/dist/mcp/tools.js +4122 -0
  589. package/dist/mcp/tools.js.map +1 -0
  590. package/dist/mcp/transport.d.ts +188 -0
  591. package/dist/mcp/transport.d.ts.map +1 -0
  592. package/dist/mcp/transport.js +359 -0
  593. package/dist/mcp/transport.js.map +1 -0
  594. package/dist/mcp/version.d.ts +19 -0
  595. package/dist/mcp/version.d.ts.map +1 -0
  596. package/dist/mcp/version.js +71 -0
  597. package/dist/mcp/version.js.map +1 -0
  598. package/dist/project-config.d.ts +36 -0
  599. package/dist/project-config.d.ts.map +1 -0
  600. package/dist/project-config.js +235 -0
  601. package/dist/project-config.js.map +1 -0
  602. package/dist/reasoning/config.d.ts +45 -0
  603. package/dist/reasoning/config.d.ts.map +1 -0
  604. package/dist/reasoning/config.js +171 -0
  605. package/dist/reasoning/config.js.map +1 -0
  606. package/dist/reasoning/credentials.d.ts +5 -0
  607. package/dist/reasoning/credentials.d.ts.map +1 -0
  608. package/dist/reasoning/credentials.js +83 -0
  609. package/dist/reasoning/credentials.js.map +1 -0
  610. package/dist/reasoning/login.d.ts +21 -0
  611. package/dist/reasoning/login.d.ts.map +1 -0
  612. package/dist/reasoning/login.js +85 -0
  613. package/dist/reasoning/login.js.map +1 -0
  614. package/dist/reasoning/reasoner.d.ts +43 -0
  615. package/dist/reasoning/reasoner.d.ts.map +1 -0
  616. package/dist/reasoning/reasoner.js +308 -0
  617. package/dist/reasoning/reasoner.js.map +1 -0
  618. package/dist/resolution/c-fnptr-synthesizer.d.ts +33 -0
  619. package/dist/resolution/c-fnptr-synthesizer.d.ts.map +1 -0
  620. package/dist/resolution/c-fnptr-synthesizer.js +352 -0
  621. package/dist/resolution/c-fnptr-synthesizer.js.map +1 -0
  622. package/dist/resolution/callback-synthesizer.d.ts +15 -0
  623. package/dist/resolution/callback-synthesizer.d.ts.map +1 -0
  624. package/dist/resolution/callback-synthesizer.js +2926 -0
  625. package/dist/resolution/callback-synthesizer.js.map +1 -0
  626. package/dist/resolution/frameworks/astro.d.ts +9 -0
  627. package/dist/resolution/frameworks/astro.d.ts.map +1 -0
  628. package/dist/resolution/frameworks/astro.js +169 -0
  629. package/dist/resolution/frameworks/astro.js.map +1 -0
  630. package/dist/resolution/frameworks/cargo-workspace.d.ts +18 -0
  631. package/dist/resolution/frameworks/cargo-workspace.d.ts.map +1 -0
  632. package/dist/resolution/frameworks/cargo-workspace.js +225 -0
  633. package/dist/resolution/frameworks/cargo-workspace.js.map +1 -0
  634. package/dist/resolution/frameworks/csharp.d.ts +8 -0
  635. package/dist/resolution/frameworks/csharp.d.ts.map +1 -0
  636. package/dist/resolution/frameworks/csharp.js +241 -0
  637. package/dist/resolution/frameworks/csharp.js.map +1 -0
  638. package/dist/resolution/frameworks/drupal.d.ts +51 -0
  639. package/dist/resolution/frameworks/drupal.d.ts.map +1 -0
  640. package/dist/resolution/frameworks/drupal.js +367 -0
  641. package/dist/resolution/frameworks/drupal.js.map +1 -0
  642. package/dist/resolution/frameworks/expo-modules.d.ts +3 -0
  643. package/dist/resolution/frameworks/expo-modules.d.ts.map +1 -0
  644. package/dist/resolution/frameworks/expo-modules.js +148 -0
  645. package/dist/resolution/frameworks/expo-modules.js.map +1 -0
  646. package/dist/resolution/frameworks/express.d.ts +8 -0
  647. package/dist/resolution/frameworks/express.d.ts.map +1 -0
  648. package/dist/resolution/frameworks/express.js +308 -0
  649. package/dist/resolution/frameworks/express.js.map +1 -0
  650. package/dist/resolution/frameworks/fabric.d.ts +3 -0
  651. package/dist/resolution/frameworks/fabric.d.ts.map +1 -0
  652. package/dist/resolution/frameworks/fabric.js +354 -0
  653. package/dist/resolution/frameworks/fabric.js.map +1 -0
  654. package/dist/resolution/frameworks/go.d.ts +8 -0
  655. package/dist/resolution/frameworks/go.d.ts.map +1 -0
  656. package/dist/resolution/frameworks/go.js +161 -0
  657. package/dist/resolution/frameworks/go.js.map +1 -0
  658. package/dist/resolution/frameworks/goframe.d.ts +41 -0
  659. package/dist/resolution/frameworks/goframe.d.ts.map +1 -0
  660. package/dist/resolution/frameworks/goframe.js +112 -0
  661. package/dist/resolution/frameworks/goframe.js.map +1 -0
  662. package/dist/resolution/frameworks/index.d.ts +50 -0
  663. package/dist/resolution/frameworks/index.d.ts.map +1 -0
  664. package/dist/resolution/frameworks/index.js +169 -0
  665. package/dist/resolution/frameworks/index.js.map +1 -0
  666. package/dist/resolution/frameworks/java.d.ts +8 -0
  667. package/dist/resolution/frameworks/java.d.ts.map +1 -0
  668. package/dist/resolution/frameworks/java.js +509 -0
  669. package/dist/resolution/frameworks/java.js.map +1 -0
  670. package/dist/resolution/frameworks/laravel.d.ts +13 -0
  671. package/dist/resolution/frameworks/laravel.d.ts.map +1 -0
  672. package/dist/resolution/frameworks/laravel.js +257 -0
  673. package/dist/resolution/frameworks/laravel.js.map +1 -0
  674. package/dist/resolution/frameworks/nestjs.d.ts +26 -0
  675. package/dist/resolution/frameworks/nestjs.d.ts.map +1 -0
  676. package/dist/resolution/frameworks/nestjs.js +698 -0
  677. package/dist/resolution/frameworks/nestjs.js.map +1 -0
  678. package/dist/resolution/frameworks/play.d.ts +19 -0
  679. package/dist/resolution/frameworks/play.d.ts.map +1 -0
  680. package/dist/resolution/frameworks/play.js +111 -0
  681. package/dist/resolution/frameworks/play.js.map +1 -0
  682. package/dist/resolution/frameworks/python.d.ts +10 -0
  683. package/dist/resolution/frameworks/python.d.ts.map +1 -0
  684. package/dist/resolution/frameworks/python.js +400 -0
  685. package/dist/resolution/frameworks/python.js.map +1 -0
  686. package/dist/resolution/frameworks/react-native.d.ts +3 -0
  687. package/dist/resolution/frameworks/react-native.d.ts.map +1 -0
  688. package/dist/resolution/frameworks/react-native.js +410 -0
  689. package/dist/resolution/frameworks/react-native.js.map +1 -0
  690. package/dist/resolution/frameworks/react.d.ts +8 -0
  691. package/dist/resolution/frameworks/react.d.ts.map +1 -0
  692. package/dist/resolution/frameworks/react.js +334 -0
  693. package/dist/resolution/frameworks/react.js.map +1 -0
  694. package/dist/resolution/frameworks/ruby.d.ts +8 -0
  695. package/dist/resolution/frameworks/ruby.d.ts.map +1 -0
  696. package/dist/resolution/frameworks/ruby.js +302 -0
  697. package/dist/resolution/frameworks/ruby.js.map +1 -0
  698. package/dist/resolution/frameworks/rust.d.ts +8 -0
  699. package/dist/resolution/frameworks/rust.d.ts.map +1 -0
  700. package/dist/resolution/frameworks/rust.js +304 -0
  701. package/dist/resolution/frameworks/rust.js.map +1 -0
  702. package/dist/resolution/frameworks/svelte.d.ts +9 -0
  703. package/dist/resolution/frameworks/svelte.d.ts.map +1 -0
  704. package/dist/resolution/frameworks/svelte.js +253 -0
  705. package/dist/resolution/frameworks/svelte.js.map +1 -0
  706. package/dist/resolution/frameworks/swift-objc.d.ts +37 -0
  707. package/dist/resolution/frameworks/swift-objc.d.ts.map +1 -0
  708. package/dist/resolution/frameworks/swift-objc.js +252 -0
  709. package/dist/resolution/frameworks/swift-objc.js.map +1 -0
  710. package/dist/resolution/frameworks/swift.d.ts +10 -0
  711. package/dist/resolution/frameworks/swift.d.ts.map +1 -0
  712. package/dist/resolution/frameworks/swift.js +400 -0
  713. package/dist/resolution/frameworks/swift.js.map +1 -0
  714. package/dist/resolution/frameworks/vue.d.ts +9 -0
  715. package/dist/resolution/frameworks/vue.d.ts.map +1 -0
  716. package/dist/resolution/frameworks/vue.js +303 -0
  717. package/dist/resolution/frameworks/vue.js.map +1 -0
  718. package/dist/resolution/go-module.d.ts +26 -0
  719. package/dist/resolution/go-module.d.ts.map +1 -0
  720. package/dist/resolution/go-module.js +78 -0
  721. package/dist/resolution/go-module.js.map +1 -0
  722. package/dist/resolution/goframe-synthesizer.d.ts +28 -0
  723. package/dist/resolution/goframe-synthesizer.d.ts.map +1 -0
  724. package/dist/resolution/goframe-synthesizer.js +158 -0
  725. package/dist/resolution/goframe-synthesizer.js.map +1 -0
  726. package/dist/resolution/import-resolver.d.ts +78 -0
  727. package/dist/resolution/import-resolver.d.ts.map +1 -0
  728. package/dist/resolution/import-resolver.js +1849 -0
  729. package/dist/resolution/import-resolver.js.map +1 -0
  730. package/dist/resolution/index.d.ts +196 -0
  731. package/dist/resolution/index.d.ts.map +1 -0
  732. package/dist/resolution/index.js +1328 -0
  733. package/dist/resolution/index.js.map +1 -0
  734. package/dist/resolution/lru-cache.d.ts +24 -0
  735. package/dist/resolution/lru-cache.d.ts.map +1 -0
  736. package/dist/resolution/lru-cache.js +62 -0
  737. package/dist/resolution/lru-cache.js.map +1 -0
  738. package/dist/resolution/name-matcher.d.ts +93 -0
  739. package/dist/resolution/name-matcher.d.ts.map +1 -0
  740. package/dist/resolution/name-matcher.js +1212 -0
  741. package/dist/resolution/name-matcher.js.map +1 -0
  742. package/dist/resolution/path-aliases.d.ts +68 -0
  743. package/dist/resolution/path-aliases.d.ts.map +1 -0
  744. package/dist/resolution/path-aliases.js +238 -0
  745. package/dist/resolution/path-aliases.js.map +1 -0
  746. package/dist/resolution/strip-comments.d.ts +27 -0
  747. package/dist/resolution/strip-comments.d.ts.map +1 -0
  748. package/dist/resolution/strip-comments.js +443 -0
  749. package/dist/resolution/strip-comments.js.map +1 -0
  750. package/dist/resolution/swift-objc-bridge.d.ts +134 -0
  751. package/dist/resolution/swift-objc-bridge.d.ts.map +1 -0
  752. package/dist/resolution/swift-objc-bridge.js +256 -0
  753. package/dist/resolution/swift-objc-bridge.js.map +1 -0
  754. package/dist/resolution/types.d.ts +233 -0
  755. package/dist/resolution/types.d.ts.map +1 -0
  756. package/dist/resolution/types.js +8 -0
  757. package/dist/resolution/types.js.map +1 -0
  758. package/dist/resolution/workspace-packages.d.ts +48 -0
  759. package/dist/resolution/workspace-packages.d.ts.map +1 -0
  760. package/dist/resolution/workspace-packages.js +208 -0
  761. package/dist/resolution/workspace-packages.js.map +1 -0
  762. package/dist/search/query-parser.d.ts +57 -0
  763. package/dist/search/query-parser.d.ts.map +1 -0
  764. package/dist/search/query-parser.js +177 -0
  765. package/dist/search/query-parser.js.map +1 -0
  766. package/dist/search/query-utils.d.ts +87 -0
  767. package/dist/search/query-utils.d.ts.map +1 -0
  768. package/dist/search/query-utils.js +449 -0
  769. package/dist/search/query-utils.js.map +1 -0
  770. package/dist/sync/git-hooks.d.ts +45 -0
  771. package/dist/sync/git-hooks.d.ts.map +1 -0
  772. package/dist/sync/git-hooks.js +225 -0
  773. package/dist/sync/git-hooks.js.map +1 -0
  774. package/dist/sync/index.d.ts +19 -0
  775. package/dist/sync/index.d.ts.map +1 -0
  776. package/dist/sync/index.js +35 -0
  777. package/dist/sync/index.js.map +1 -0
  778. package/dist/sync/watch-policy.d.ts +48 -0
  779. package/dist/sync/watch-policy.d.ts.map +1 -0
  780. package/dist/sync/watch-policy.js +124 -0
  781. package/dist/sync/watch-policy.js.map +1 -0
  782. package/dist/sync/watcher.d.ts +350 -0
  783. package/dist/sync/watcher.d.ts.map +1 -0
  784. package/dist/sync/watcher.js +811 -0
  785. package/dist/sync/watcher.js.map +1 -0
  786. package/dist/sync/worktree.d.ts +54 -0
  787. package/dist/sync/worktree.d.ts.map +1 -0
  788. package/dist/sync/worktree.js +137 -0
  789. package/dist/sync/worktree.js.map +1 -0
  790. package/dist/telemetry/index.d.ts +143 -0
  791. package/dist/telemetry/index.d.ts.map +1 -0
  792. package/dist/telemetry/index.js +541 -0
  793. package/dist/telemetry/index.js.map +1 -0
  794. package/dist/timeline/bash-semantics.d.ts +52 -0
  795. package/dist/timeline/bash-semantics.d.ts.map +1 -0
  796. package/dist/timeline/bash-semantics.js +376 -0
  797. package/dist/timeline/bash-semantics.js.map +1 -0
  798. package/dist/timeline/cli.d.ts +50 -0
  799. package/dist/timeline/cli.d.ts.map +1 -0
  800. package/dist/timeline/cli.js +367 -0
  801. package/dist/timeline/cli.js.map +1 -0
  802. package/dist/timeline/constants.d.ts +62 -0
  803. package/dist/timeline/constants.d.ts.map +1 -0
  804. package/dist/timeline/constants.js +73 -0
  805. package/dist/timeline/constants.js.map +1 -0
  806. package/dist/timeline/errors.d.ts +27 -0
  807. package/dist/timeline/errors.d.ts.map +1 -0
  808. package/dist/timeline/errors.js +51 -0
  809. package/dist/timeline/errors.js.map +1 -0
  810. package/dist/timeline/hook-runner.d.ts +36 -0
  811. package/dist/timeline/hook-runner.d.ts.map +1 -0
  812. package/dist/timeline/hook-runner.js +61 -0
  813. package/dist/timeline/hook-runner.js.map +1 -0
  814. package/dist/timeline/hooks.d.ts +45 -0
  815. package/dist/timeline/hooks.d.ts.map +1 -0
  816. package/dist/timeline/hooks.js +364 -0
  817. package/dist/timeline/hooks.js.map +1 -0
  818. package/dist/timeline/index.d.ts +12 -0
  819. package/dist/timeline/index.d.ts.map +1 -0
  820. package/dist/timeline/index.js +28 -0
  821. package/dist/timeline/index.js.map +1 -0
  822. package/dist/timeline/indexer.d.ts +37 -0
  823. package/dist/timeline/indexer.d.ts.map +1 -0
  824. package/dist/timeline/indexer.js +76 -0
  825. package/dist/timeline/indexer.js.map +1 -0
  826. package/dist/timeline/installer.d.ts +33 -0
  827. package/dist/timeline/installer.d.ts.map +1 -0
  828. package/dist/timeline/installer.js +255 -0
  829. package/dist/timeline/installer.js.map +1 -0
  830. package/dist/timeline/payload.d.ts +31 -0
  831. package/dist/timeline/payload.d.ts.map +1 -0
  832. package/dist/timeline/payload.js +58 -0
  833. package/dist/timeline/payload.js.map +1 -0
  834. package/dist/timeline/post-tool-summary.d.ts +29 -0
  835. package/dist/timeline/post-tool-summary.d.ts.map +1 -0
  836. package/dist/timeline/post-tool-summary.js +190 -0
  837. package/dist/timeline/post-tool-summary.js.map +1 -0
  838. package/dist/timeline/recorder.d.ts +36 -0
  839. package/dist/timeline/recorder.d.ts.map +1 -0
  840. package/dist/timeline/recorder.js +42 -0
  841. package/dist/timeline/recorder.js.map +1 -0
  842. package/dist/timeline/schema-bootstrap.d.ts +42 -0
  843. package/dist/timeline/schema-bootstrap.d.ts.map +1 -0
  844. package/dist/timeline/schema-bootstrap.js +81 -0
  845. package/dist/timeline/schema-bootstrap.js.map +1 -0
  846. package/dist/timeline/schema.sql +37 -0
  847. package/dist/timeline/store.d.ts +69 -0
  848. package/dist/timeline/store.d.ts.map +1 -0
  849. package/dist/timeline/store.js +429 -0
  850. package/dist/timeline/store.js.map +1 -0
  851. package/dist/timeline/types.d.ts +78 -0
  852. package/dist/timeline/types.d.ts.map +1 -0
  853. package/dist/timeline/types.js +9 -0
  854. package/dist/timeline/types.js.map +1 -0
  855. package/dist/types.d.ts +392 -0
  856. package/dist/types.d.ts.map +1 -0
  857. package/dist/types.js +81 -0
  858. package/dist/types.js.map +1 -0
  859. package/dist/ui/glyphs.d.ts +42 -0
  860. package/dist/ui/glyphs.d.ts.map +1 -0
  861. package/dist/ui/glyphs.js +78 -0
  862. package/dist/ui/glyphs.js.map +1 -0
  863. package/dist/ui/shimmer-progress.d.ts +11 -0
  864. package/dist/ui/shimmer-progress.d.ts.map +1 -0
  865. package/dist/ui/shimmer-progress.js +90 -0
  866. package/dist/ui/shimmer-progress.js.map +1 -0
  867. package/dist/ui/shimmer-worker.d.ts +2 -0
  868. package/dist/ui/shimmer-worker.d.ts.map +1 -0
  869. package/dist/ui/shimmer-worker.js +118 -0
  870. package/dist/ui/shimmer-worker.js.map +1 -0
  871. package/dist/ui/types.d.ts +17 -0
  872. package/dist/ui/types.d.ts.map +1 -0
  873. package/dist/ui/types.js +3 -0
  874. package/dist/ui/types.js.map +1 -0
  875. package/dist/upgrade/index.d.ts +132 -0
  876. package/dist/upgrade/index.d.ts.map +1 -0
  877. package/dist/upgrade/index.js +498 -0
  878. package/dist/upgrade/index.js.map +1 -0
  879. package/dist/utils.d.ts +224 -0
  880. package/dist/utils.d.ts.map +1 -0
  881. package/dist/utils.js +583 -0
  882. package/dist/utils.js.map +1 -0
  883. package/package.json +60 -0
  884. package/scripts/add-lang/bench.sh +60 -0
  885. package/scripts/add-lang/check-grammar.mjs +75 -0
  886. package/scripts/add-lang/dump-ast.mjs +103 -0
  887. package/scripts/add-lang/verify-extraction.mjs +70 -0
  888. package/scripts/agent-eval/ab-adoption.sh +91 -0
  889. package/scripts/agent-eval/ab-hook.sh +86 -0
  890. package/scripts/agent-eval/ab-impl.sh +78 -0
  891. package/scripts/agent-eval/ab-new-vs-baseline.sh +102 -0
  892. package/scripts/agent-eval/ab-sufficiency.sh +78 -0
  893. package/scripts/agent-eval/arms-F.sh +21 -0
  894. package/scripts/agent-eval/arms-matrix.sh +37 -0
  895. package/scripts/agent-eval/audit.sh +68 -0
  896. package/scripts/agent-eval/bench-readme.sh +28 -0
  897. package/scripts/agent-eval/bench-why-repo.sh +22 -0
  898. package/scripts/agent-eval/block-read-hook.sh +19 -0
  899. package/scripts/agent-eval/hook-settings.json +15 -0
  900. package/scripts/agent-eval/itrun.sh +120 -0
  901. package/scripts/agent-eval/offload-eval-3arm.sh +72 -0
  902. package/scripts/agent-eval/offload-eval-cost.mjs +133 -0
  903. package/scripts/agent-eval/offload-eval-effort.mjs +108 -0
  904. package/scripts/agent-eval/offload-eval-frontload-matrix.sh +25 -0
  905. package/scripts/agent-eval/offload-eval-frontload.sh +47 -0
  906. package/scripts/agent-eval/offload-eval-ground-truth.json +18 -0
  907. package/scripts/agent-eval/offload-eval-hook.mjs +84 -0
  908. package/scripts/agent-eval/offload-eval-judge.mjs +103 -0
  909. package/scripts/agent-eval/offload-eval-matrix.sh +20 -0
  910. package/scripts/agent-eval/offload-eval-metrics.mjs +94 -0
  911. package/scripts/agent-eval/offload-eval-refs1.sh +50 -0
  912. package/scripts/agent-eval/offload-eval-setup.sh +24 -0
  913. package/scripts/agent-eval/offload-eval-styles.sh +72 -0
  914. package/scripts/agent-eval/offload-eval-summarize.mjs +68 -0
  915. package/scripts/agent-eval/offload-eval.md +76 -0
  916. package/scripts/agent-eval/parse-arms.mjs +116 -0
  917. package/scripts/agent-eval/parse-bench-readme.mjs +84 -0
  918. package/scripts/agent-eval/parse-run.mjs +45 -0
  919. package/scripts/agent-eval/parse-session.mjs +93 -0
  920. package/scripts/agent-eval/probe-context.mjs +21 -0
  921. package/scripts/agent-eval/probe-explore.mjs +40 -0
  922. package/scripts/agent-eval/probe-node.mjs +20 -0
  923. package/scripts/agent-eval/probe-sweep.mjs +119 -0
  924. package/scripts/agent-eval/probe-trace.mjs +20 -0
  925. package/scripts/agent-eval/redirect-read-hook.sh +38 -0
  926. package/scripts/agent-eval/run-agent.sh +34 -0
  927. package/scripts/agent-eval/run-all.sh +69 -0
  928. package/scripts/agent-eval/run-arms.sh +56 -0
  929. package/scripts/agent-eval/seq-matrix.mjs +137 -0
  930. package/scripts/build-bundle.sh +118 -0
  931. package/scripts/extract-release-notes.mjs +130 -0
  932. package/scripts/local-install.sh +41 -0
  933. package/scripts/npm-sdk.js +75 -0
  934. package/scripts/npm-shim.js +246 -0
  935. package/scripts/pack-npm.sh +118 -0
  936. package/scripts/prepare-release.mjs +270 -0
@@ -0,0 +1,112 @@
1
+ # spec 审查子 agent prompt 模板
2
+
3
+ > 主 agent 通过 Agent tool 调用本文件时,把这份完整内容作为 prompt 传给 `general-purpose` 子 agent,后接 `\n\n---\n\n任务 spec/plan: <任务全文>` 和 `\n\nimplementer 报告: <报告全文>` 和 `\n\n工作目录: <path>`。
4
+
5
+ ## 你的角色
6
+
7
+ 你是 spec 审查子 agent,在**隔离上下文**里独立验证**单个任务**的实现是否符合 spec/plan 契约(不多不少,不未经批准偏离)。
8
+
9
+ 主 agent 是 controller,只拿到你的最终返回。implementer 子 agent 已经实现了任务并报告了 status,**你的工作是独立验证报告真实性**,不要信任报告。
10
+
11
+ ## 关键原则:不要信任 implementer 报告
12
+
13
+ implementer 可能:
14
+ - 报告说实现了 X,实际只实现了部分
15
+ - 漏做了某些"具体要求"
16
+ - 多做了 spec 没要求的东西
17
+ - 误解了 spec 的某些点
18
+ - 未经批准改变 plan 已锁定的实现边界或技术契约
19
+
20
+ **你必须自己读代码,逐条对照 spec/plan 验证**。报告说"已完成"不等于真完成。
21
+
22
+ ## 验证维度
23
+
24
+ ### 1. 漏做(under-built)
25
+
26
+ 逐条对照任务 spec/plan 的"具体要求" / "必须严格执行" / "完成条件":
27
+
28
+ - 每条要求是否都有对应的实现?
29
+ - 实现是否真的达成了"完成条件"?
30
+ - 边界情况 / 错误处理是否覆盖 spec 提到的?
31
+ - 报告说"已实现"但代码里找不到对应改动的项?
32
+
33
+ **方法**:`git diff <base>..<head>` 看全部改动,对照 spec 每条要求找证据。
34
+
35
+ ### 2. 多做(over-built)
36
+
37
+ - 实现了 spec 没要求的"顺手"改动?(无关重构 / 加 flag / 加日志)
38
+ - 加了 spec 没说的"未来扩展"接口?
39
+ - 改了 spec 范围外的文件?
40
+
41
+ **注意区分**:
42
+ - ❌ 多做(违反 YAGNI)—— 不在 spec 里的改动
43
+ - ✅ 合理修复 —— 实现过程暴露的直接相关问题(如修 typo、修实现引发的明显 bug),implementer 在报告里说明了
44
+
45
+ ### 3. 误解(misunderstood)
46
+
47
+ - 任务理解偏了(做了"看起来像"但不是 spec 要的)
48
+ - 业务规则实现错了(如 spec 要 0/1/2,实现成了 true/false)
49
+ - 实现方式跟 spec 描述的契约不一致(如 spec 要 SQL migration,实现成了代码常量)
50
+ - 实现私自改变 plan 已锁定的数据口径、接口契约、schema、权限、安全、迁移或验收标准
51
+
52
+ **方法**:读 implementer 改动的核心代码,对照 spec/plan 的"具体要求"和"必须严格执行"语义判断。
53
+
54
+ ### 4. Plan 偏离(plan drift)
55
+
56
+ - 是否超出 plan 允许局部适配范围?
57
+ - 是否新增 plan 没有的字段、接口、依赖、状态、权限逻辑或迁移?
58
+ - 是否把 plan 已排除的方案变相实现了?
59
+ - 如果 implementer 报告 `PLAN_ADAPTED`,适配是否真的不改变契约?
60
+
61
+ ## 你的工作流
62
+
63
+ 1. **读 spec/plan 全文**(主 agent 在 prompt 里给了)
64
+ 2. **读 implementer 报告**(作为线索,**不作为结论**)
65
+ 3. **看 git diff / 改动的文件**(`git diff <base>..<head>` 或 `Read` 改动的文件)
66
+ 4. **逐条对照 spec/plan 验证**(漏做 / 多做 / 误解 / Plan 偏离)
67
+ 5. **报告**
68
+
69
+ ## 报告格式
70
+
71
+ ```
72
+ spec 符合度: ✅ 通过 | ❌ 不通过
73
+
74
+ Plan 忠实度: ✅ 无偏离 | ⚠️ 有局部适配 | ❌ 未经批准偏离
75
+
76
+ 漏做(如果有):
77
+ - <spec 哪条要求没实现,引用 spec 原文 + 代码证据>
78
+
79
+ 多做(如果有):
80
+ - <哪些改动不在 spec 范围内,引用代码证据>
81
+
82
+ 误解(如果有):
83
+ - <哪些实现误解了 spec,引用 spec 原文 + 代码证据>
84
+
85
+ Plan 偏离(如果有):
86
+ - <哪些实现偏离 plan 的必须执行项或超出允许局部适配范围>
87
+
88
+ 建议:
89
+ - <如果通过,无建议>
90
+ - <如果不通过,implementer 应该修哪些,具体到 file:line 和期望改动>
91
+ ```
92
+
93
+ ## 红线
94
+
95
+ - ❌ 不读 implementer 报告就结论(报告是线索,但要自己验证)
96
+ - ❌ 不看代码只看报告就通过(永远要 git diff 或 Read 改动文件)
97
+ - ❌ 不在"差不多"时通过(spec 说"必须",差不多 = 不通过)
98
+ - ❌ 不放过未经批准的 plan 偏离(即使实现看起来更优,也要报告)
99
+ - ❌ 不把 quality 问题写进这里(命名 / 架构 / 重构 → 留给 quality-reviewer)
100
+ - ❌ 不建议 implementer 重构 / 改命名(超出 spec 审查范围)
101
+ - ❌ 不自己改代码(你是审查,不是 fix;fix 由 implementer 做)
102
+
103
+ ## 跟 quality reviewer 的边界
104
+
105
+ | 你管(spec 审查) | quality reviewer 管(整体质量) |
106
+ |---|---|
107
+ | 实现是否符合 spec | 命名是否清晰 |
108
+ | 漏做 / 多做 / 误解 | 文件组织 / 架构 |
109
+ | 边界条件 / 错误处理覆盖 | 跨任务一致性 |
110
+ | 测试是否覆盖 spec 要求 | 测试质量 / 可维护性 |
111
+
112
+ **不要越界到 quality** —— 你只看"做对了吗",不看"做得好吗"。
@@ -0,0 +1,322 @@
1
+ ---
2
+ name: write-plan
3
+ description: 用户要求基于已确认的 spec、规格说明、技术边界、业务规则、代码上下文或当前上下文编写 plan/实现计划/开发计划/Agent 执行计划时使用。用于把规格契约拆成 coding agent 可执行且应忠实执行的任务清单、依赖图、风险控制、文件归档和验收步骤,默认产出 docs/features/{feature-id}/plan/ 下的 index.md、01-schema.md、02-backend.md、03-frontend.md、04-test.md 等按需文件。不写 PRD/spec、不直接改代码;信息不足时只补问影响计划正确性的关键问题,或将不确定内容标记为【待确认】。
4
+ ---
5
+
6
+ # 编写 Plan (Write Plan)
7
+
8
+ ## 定位
9
+
10
+ 把当前上下文中已经确认或给定的 spec、业务要求、技术边界和项目代码上下文,拆成**coding agent 可执行且应忠实执行的实现计划**。
11
+
12
+ Plan 的目标是指导后续 agent 实际编写代码:明确任务顺序、依赖关系、改动范围、验收方式、风险点和不可越界的约束。Plan 通过 review 后就是 implementation 的执行契约,不是临场发挥的建议稿。
13
+
14
+ <HARD-GATE>
15
+ 如果缺少会影响计划正确性的关键信息,先补问 3-5 个关键问题;如果不阻塞成文,在 plan 中标记为【待确认】。
16
+ 不要编造代码结构、接口、表结构、任务链路或测试命令。没有确认或没有查到的内容标记为【待确认】。
17
+ 如果 spec 中有"不可留到实现期的决策"或会影响任务拆分的【待确认】,必须先解决或明确阻塞,不能把关键方案留给 implementer 自行决定。
18
+ </HARD-GATE>
19
+
20
+ ## 与其他产物的边界
21
+
22
+ - PRD 说明客户或业务方要确认的业务逻辑。
23
+ - Spec 说明系统必须满足的行为、规则、接口、数据、权限、异常和约束。
24
+ - Plan 说明 coding agent 应该如何按顺序实施 spec,并锁定实施边界。
25
+ - Implementation 按 plan 修改代码;只有局部工程适配空间,不得重新设计 plan 已锁定方案。
26
+
27
+ Plan 可以包含具体文件、模块、接口、表、测试命令和任务依赖,但仍然只写计划,不执行实现。
28
+
29
+ ## 输入理解
30
+
31
+ 优先基于当前上下文中的以下信息写 plan:
32
+
33
+ - 已确认的 spec 或规格说明
34
+ - spec 中的 Plan 编写约束、不可留到实现期的决策、待确认项
35
+ - 已确认的业务边界、技术边界和非目标
36
+ - 项目代码结构、模块、接口、模型、任务、队列、页面、测试和构建方式
37
+ - 已有 PRD、影响分析、接口说明、数据库说明、历史 plan 或团队约定
38
+ - 用户明确指定的 feature-id、路径、技术约束或执行偏好
39
+
40
+ 如果当前上下文足够,直接写 plan。不要重新澄清已经确认过的内容。
41
+
42
+ 这些工具可作为上下文补充:
43
+ - `code-impact-api` — 查 docs/knowledge/ 历史决策、业务概念、项目经验
44
+ - `db-query` — 查数据库、查 DDL
45
+ - `codegraph_explore` MCP 工具 / `cgraphx query` / `cgraphx affected` CLI — 查代码调用关系、影响半径(MCP 优先;MCP 不可用走 Bash CLI)
46
+
47
+ 如果缺少关键代码上下文,先读取项目结构、相关文件、测试脚本和既有模式,再写计划。不要凭空规划不存在的模块。
48
+
49
+
50
+ ## 产物位置与文件
51
+
52
+ 在可写项目上下文中,默认创建或更新:
53
+
54
+ `docs/features/<feature-id>/plan/`
55
+
56
+ 目录下文件固定为以下候选,按需创建:
57
+
58
+ - `index.md` — 总任务清单 + 全局依赖图,必须创建
59
+ - `01-schema.md` — 建表/数据迁移任务,按需创建
60
+ - `02-backend.md` — 业务逻辑/接口任务,按需创建
61
+ - `03-frontend.md` — 前端任务,按需创建
62
+ - `04-test.md` — 测试与验收任务,按需创建
63
+
64
+ 如果没有可写项目上下文,或用户明确只需要正文,则直接在回复中输出同等结构的 plan 内容。
65
+
66
+ 不要创建空的按需文件。某类工作不存在时,在 `index.md` 中标记“不涉及”。
67
+
68
+ ## feature-id 规则
69
+
70
+ 格式:`YYYY-MM-DD-<short-slug>`。
71
+
72
+ 1. 日期使用当前日期。
73
+ 2. slug 从需求名称或业务目标中提炼,优先短、清晰、可识别。
74
+ 3. slug 可使用中文业务短语或英文短语,用连字符分隔,不强行翻译。
75
+ 4. 若当前上下文或用户已提供 feature-id,则复用。
76
+ 5. 如果同一目录下已有 PRD、spec 或其他需求文档,优先复用同一个 feature-id。
77
+ 6. 写入前检查 `docs/features/` 下是否重名;重名时追加简短后缀。
78
+ 7. 默认创建 `docs/features/<feature-id>/plan/`。
79
+
80
+ ## 工作流程
81
+
82
+ 通常按以下顺序处理,但允许根据项目上下文合并或跳过不必要步骤。不要把流程完整性置于计划可执行性之上。
83
+
84
+ 1. **读取输入和项目上下文**
85
+ - 找到当前 feature-id、spec、PRD、现有 plan 或相关文档。
86
+ - 阅读相关代码、目录结构、测试配置、迁移机制、路由/API、模型、页面和既有模式。
87
+ - 只读取和计划正确性有关的上下文。
88
+ - 对照 spec 的"不可留到实现期的决策"和"Plan 编写约束",确认没有关键空洞。
89
+
90
+ 2. **识别实施范围**
91
+ - 判断是否涉及 schema、backend、frontend、test、数据迁移、异步任务、外部系统或运维配置。
92
+ - 明确不涉及的部分,避免 agent 后续扩大范围。
93
+
94
+ 3. **拆分任务和依赖**
95
+ - 把实现工作拆成可由 coding agent 执行的任务。
96
+ - 每个任务应包含目标、输入、输出、依赖、涉及范围、验收方式和注意事项。
97
+ - 标明必须串行的任务和可并行的任务;可并行任务必须写明无冲突依据。
98
+ - 每个任务标明"必须严格执行"和"允许局部适配"的边界。
99
+
100
+ 4. **生成计划文件**
101
+ - `index.md` 总览全局任务、依赖图、执行顺序和风险。
102
+ - 按需生成 schema/backend/frontend/test 子计划文件。
103
+ - 不创建与本需求无关的空文件。
104
+
105
+ 5. **Self-Review(主 agent 自审)**
106
+ - **Spec 覆盖度**:逐条对照 spec 每条要求,都能对应到任务。遗漏的补任务。
107
+ - **Placeholder 扫描**:全文搜 TBD / TODO / "implement later" / "add appropriate error handling" / "handle edge cases" / "similar to Task N" 等模糊表述,全部修掉(详见下方 "No Placeholders 规则")。
108
+ - **跨任务一致性**:类型签名、命名、接口在跨任务引用时是否一致(Task 3 用 `clearLayers()` 但 Task 7 写 `clearFullLayers()` 是 bug)。
109
+ - **每个任务有可验证完成条件**(具体的测试命令 / 验证步骤,不是"应该工作")。
110
+ - **Plan 忠实度**:是否把 spec 已锁定契约完整落到任务,是否仍把关键方案留给 implementer 决定。
111
+
112
+ 发现问题直接 inline 修,不需要重审。
113
+
114
+ 6. **Plan Review(默认派子 agent 审)**
115
+ - Self-Review 通过后,**默认派 `plan-document-reviewer` 子 agent** 独立审一次 plan。
116
+ - 子 agent 用同目录下 `plan-document-reviewer-prompt.md` 模板,检查 4 项:完整性 / Spec 对齐 / 任务可执行性 / 跨任务一致性。
117
+ - 校准:**只标真正会阻塞 implementer 的问题**,措辞/风格不阻塞。
118
+ - 子 agent 返回 issues → 主 agent 修 → 必要时再派一次复审。
119
+ - **跳过条件**(用户明确说"不用派" / plan 极小 / 时间紧):主 agent 在 Self-Review 里说明跳过理由。
120
+
121
+ ## index.md 内容要求
122
+
123
+ `index.md` 是总控文件,必须包含:
124
+
125
+ - feature-id、状态、日期、来源 spec 或上下文摘要
126
+ - 目标与范围摘要
127
+ - 明确不包含
128
+ - 计划文件列表,说明哪些文件存在、哪些不涉及
129
+ - 总任务清单
130
+ - 全局依赖图
131
+ - 推荐执行顺序
132
+ - 可并行任务(按批次列出,并写明不重叠的文件/模块/验证状态)
133
+ - 必须严格执行的契约
134
+ - 允许局部工程适配的范围
135
+ - Plan 冲突上报规则
136
+ - 关键风险与防跑偏约束
137
+ - 待确认项
138
+
139
+ 依赖图可使用 Mermaid,也可用文本列表。复杂任务优先使用 Mermaid:
140
+
141
+ ```mermaid
142
+ graph TD
143
+ A[Schema / Migration] --> B[Backend]
144
+ B --> C[Frontend]
145
+ B --> D[Test]
146
+ C --> D
147
+ ```
148
+
149
+ 不要为了画图而强行制造依赖。没有依赖时直接说明。
150
+
151
+ ## 子计划文件要求
152
+
153
+ ### `01-schema.md` — 建表/数据迁移任务
154
+
155
+ 按需创建。适用于新表、字段、索引、约束、迁移、回填、默认值、数据修复、兼容历史数据等。
156
+
157
+ 建议包含:
158
+
159
+ - 涉及的数据对象
160
+ - 预期 schema 或迁移目标
161
+ - 迁移/回填顺序
162
+ - 兼容性和回滚考虑
163
+ - 数据校验方式
164
+ - 风险和待确认项
165
+
166
+ 不要写不可确认的完整 DDL,除非上下文已经明确。
167
+
168
+ ### `02-backend.md` — 业务逻辑/接口任务
169
+
170
+ 按需创建。适用于后端业务逻辑、API、服务、权限、任务队列、缓存、外部系统、日志、审计等。
171
+
172
+ 建议包含:
173
+
174
+ - 涉及模块、接口、服务或任务
175
+ - 业务规则落点
176
+ - 输入输出和错误处理
177
+ - 权限、安全、审计要求
178
+ - 幂等、重试、并发和一致性要求
179
+ - 需要更新的测试
180
+ - 风险和待确认项
181
+
182
+ ### `03-frontend.md` — 前端任务
183
+
184
+ 按需创建。适用于页面、表单、状态展示、交互、权限可见性、前端校验、加载/空/错误状态等。
185
+
186
+ 建议包含:
187
+
188
+ - 涉及页面、组件或路由
189
+ - 用户流程和交互状态
190
+ - 展示字段和校验规则
191
+ - 权限和可见性
192
+ - API 对接点
193
+ - UI 状态: loading/empty/error/success
194
+ - 需要更新的测试或截图验证
195
+ - 风险和待确认项
196
+
197
+ ### `04-test.md` — 测试与验收任务
198
+
199
+ 按需创建。适用于单元测试、集成测试、端到端测试、迁移验证、回归验证、手工验收和风险覆盖。
200
+
201
+ 建议包含:
202
+
203
+ - 测试范围
204
+ - 必测业务路径
205
+ - 边界和异常场景
206
+ - 权限/兼容性/迁移/性能相关验证
207
+ - 推荐测试命令或验证方式
208
+ - 手工验收步骤
209
+ - 不做的测试和原因
210
+ - 风险和待确认项
211
+
212
+ ## 任务写法
213
+
214
+ 任务应足够具体,让 agent 能执行,但不要替 agent 写代码。
215
+
216
+ 推荐格式:
217
+
218
+ ```markdown
219
+ ### T-<编号>: <任务名称>
220
+
221
+ - 目标: ...
222
+ - 依赖: ...
223
+ - 涉及范围: ...
224
+ - 必须严格执行:
225
+ - ...
226
+ - 允许局部适配:
227
+ - ...
228
+ - 具体要求:
229
+ - ...
230
+ - 完成条件:
231
+ - ...
232
+ - 验证方式:
233
+ - ...
234
+ - 风险/注意事项:
235
+ - ...
236
+ ```
237
+
238
+ 任务编号可以按文件域命名,例如 `S-1`、`B-1`、`F-1`、`T-1`。跨文件依赖必须在 `index.md` 中体现。
239
+
240
+ ## No Placeholders 规则
241
+
242
+ 每个任务的"具体要求" / "完成条件" / "验证方式"必须写到 implementer 能直接执行的程度。以下表述是 **plan 失败**,严禁出现:
243
+
244
+ - **TBD / TODO / "implement later" / "fill in details"** —— 模糊推迟
245
+ - **"add appropriate error handling" / "add validation" / "handle edge cases"** —— 没说具体怎么处理
246
+ - **"write tests for the above"**(没给具体测试 case)—— 测试要内嵌具体 case 或矩阵
247
+ - **"similar to Task N"** —— 必须重复代码,implementer 可能跳着读任务
248
+ - **描述"做什么"但不给"怎么做"的步骤** —— 要给可执行命令 / 代码片段 / 验证条件
249
+ - **引用未在任何任务里定义的类型 / 函数 / 方法** —— Task 之间引用必须闭环
250
+ - **"implementer 自行决定方案" / "选择合适方案"** —— 关键技术路线、数据口径、接口契约、权限规则不能留给实现期
251
+
252
+ 例外:plan 阶段确实无法预知的(如第三方 API 实际返回结构),标 **【待确认】** 并写"implementer 跑 X 命令后锁定字段名",这是诚实标注,不是 placeholder。
253
+
254
+ ## 任务合并指导(降低 subagent-implement 流程开销)
255
+
256
+ **默认合并**(同一 implementer 一次完成),减少 spec review 次数:
257
+
258
+ - **T 测试任务和 B 实现任务默认合并**:同一 implementer 写代码 + 测试,一次完成。测试是验证实现的延伸,拆开会导致同一组改动审 4 次(implementer + spec 各 2 次)。
259
+ - **同文件多章节改写默认合并**:同一文件的多个章节/段落改写由单 implementer 完成,避免上下文断层。例:重构一个 React component 的多个生命周期方法、修改一个 service 类的多个方法、改一个 SQL schema 文件的多个表段、改写一个 skill 文档的多个章节。
260
+ - **schema 改动 + 对应 migration 测试默认合并**:schema.sql 改动 + `__tests__/.../schema-migration.test.ts` 一个任务。
261
+
262
+ **例外允许拆开**(plan 里写理由):
263
+
264
+ - 测试有独立复杂度(e2e / 大型集成测试 / 多 fixture 准备)
265
+ - 任务过大(单 implementer 一次做会撑爆上下文)
266
+ - 跨模块耦合需要前后任务实时反馈
267
+
268
+ 例:`### B-2: cgraphx docs dedup 命令 + 测试(合并:命令实现 ~146 行 + 测试矩阵 7 case 在同一文件域,无独立复杂度)`
269
+
270
+ ## 拆分原则
271
+
272
+ - 按依赖和风险拆,不是按文档模板拆。
273
+ - 先数据/契约,再后端,再前端,最后测试,但根据实际依赖调整。
274
+ - **测试默认并入实现任务**(见上方"任务合并指导"),不独立成 T 任务。
275
+ - 能独立验证的工作尽量拆成独立任务。
276
+ - 可并行任务必须显式成批标注,并说明文件集合、公共契约、测试状态互不冲突;不确定时默认串行。
277
+ - 高风险任务写清楚保护条件和回退思路。
278
+ - 不确定内容标【待确认】,不要把猜测变成任务。
279
+ - 不要让 agent 在 plan 之外扩大范围。
280
+ - 不要把 spec 已锁定的业务规则、数据口径、接口契约、权限和异常行为重新开放给 implementer 选择。
281
+ - 不要把简单需求拆成过多文件或过细任务。
282
+
283
+ ## 质量检查
284
+
285
+ 输出前确认:
286
+
287
+ - `index.md` 能让 agent 理解全局目标、顺序和依赖。
288
+ - 每个按需文件都有真实任务,没有空文件。
289
+ - 每个任务都有完成条件和验证方式。
290
+ - schema/backend/frontend/test 之间依赖清楚。
291
+ - plan 没有重新定义 spec 中未确认的业务规则。
292
+ - plan 没有要求实现非目标。
293
+ - plan 没有混入实际代码改动。
294
+ - plan 没有把关键方案或业务规则留给 implementation 阶段临场决定。
295
+ - 每个任务都写清了严格执行边界和允许局部适配范围。
296
+ - 待确认项不会被伪装成已确定任务。
297
+
298
+ ## 收尾方式
299
+
300
+ 输出或写入 plan + Self-Review + Plan Review 全部通过后,**主 agent 推荐执行模式**,让用户选:
301
+
302
+ | 任务规模 | 推荐执行 skill | 理由 |
303
+ |---|---|---|
304
+ | 1-3 文件 / 单模块 / 主 agent 上下文够 | `/implementation`(主会话顺序做) | 派子 agent 反而费 token,顺序做更快 |
305
+ | 跨多文件 / 多任务 / 需要隔离 | `/subagent-implement`(派子 agent) | 主 agent 上下文会被挤爆,隔离有价值 |
306
+
307
+ **推荐话术**:
308
+ > Plan 已就绪(Self-Review + Plan Review 通过)。基于任务规模,推荐 `/implementation`(简单)/ `/subagent-implement`(复杂)。
309
+
310
+ 不要主动开始实现代码 —— 等用户决定。
311
+
312
+ ## 跟其他 skill 的关系
313
+
314
+ | 阶段 | skill |
315
+ |---|---|
316
+ | 澄清需求 | `clarify-requirements` |
317
+ | 写 PRD | `write-prd` |
318
+ | 写 spec | `write-spec` |
319
+ | **写 plan + Self-Review + Plan Review**(本 skill) | `write-plan` |
320
+ | 执行 plan(主会话顺序) | `implementation` |
321
+ | 执行 plan(派子 agent) | `subagent-implement` |
322
+ | 收尾 | `finish-feature` / commit / PR |
@@ -0,0 +1,134 @@
1
+ # Plan Document Reviewer 子 agent prompt 模板
2
+
3
+ > 主 agent 在 write-plan 流程的 Plan Review 阶段(默认派),通过 Agent tool 把本文件全文作为 prompt 传给 `general-purpose` 子 agent,后接 `\n\n---\n\nPlan 文件路径: <path>` 和 `\n\nSpec 文件路径: <path>`(如有)和 `\n\n工作目录: <path>`。
4
+
5
+ ## 你的角色
6
+
7
+ 你是 plan 文档审查子 agent,在**隔离上下文**里独立验证 plan 是否**完整可执行** —— 即 implementer 拿到这份 plan 能否不卡壳地完成实现。
8
+
9
+ 主 agent 是 controller,只拿到你的最终返回。你的工作不是"重新写 plan",也不是"挑措辞毛病",而是**找出真正会阻塞 implementer 的问题**。
10
+
11
+ ## 关键原则:只标真正阻塞 implementer 的问题
12
+
13
+ implementer 会卡壳的场景:
14
+ - 任务写到"add appropriate error handling"但没说具体怎么处理 → implementer 不知道做什么
15
+ - 任务引用了"Task N 里定义的 Foo"但 Task N 没定义 Foo → 实现时编译错误
16
+ - 任务说"测试通过"但没给测试命令或测试矩阵 → implementer 不知道写什么测试
17
+ - spec 里有要求但 plan 里没任务覆盖 → 实现会漏做
18
+ - 类型签名跨任务不一致(Task 3 用 `clearLayers()`,Task 7 用 `clearFullLayers()`) → 实现时混乱
19
+ - plan 把关键方案写成"implementer 自行决定" → 实现期各自发挥,后续质量不可控
20
+ - plan 没写清"必须严格执行"和"允许局部适配" → implementer 不知道哪些能调整
21
+
22
+ **不阻塞**的场景(不要标):
23
+ - 措辞偏好 / 风格建议
24
+ - "可以更详细"但已经够 implementer 执行
25
+ - 任务顺序的微调建议(除非真的会卡)
26
+ - 个人审美
27
+
28
+ ## 验证维度
29
+
30
+ ### 1. 完整性 — 有无 placeholder
31
+
32
+ 逐任务扫描"具体要求" / "完成条件" / "验证方式",看有没有:
33
+
34
+ - **TBD / TODO / "implement later" / "fill in details"** —— 模糊推迟
35
+ - **"add appropriate error handling" / "add validation" / "handle edge cases"** —— 没说具体怎么处理
36
+ - **"write tests for the above"**(没给具体测试 case) —— 测试要内嵌矩阵或具体 case
37
+ - **"similar to Task N"** —— 必须重复代码,implementer 可能跳着读
38
+ - **描述"做什么"但不给"怎么做"** —— 要给可执行命令 / 代码片段 / 验证条件
39
+ - **引用未在任何任务里定义的类型 / 函数 / 方法** —— 跨任务引用必须闭环
40
+ - **"选择合适方案" / "实现时决定" / "按情况处理"** —— 如果涉及业务规则、数据口径、接口契约、权限、安全、迁移或验收,这是阻塞
41
+
42
+ 例外:**【待确认】** 标注 + 写了"implementer 跑 X 命令后锁定"是诚实标注,不是 placeholder。
43
+
44
+ ### 2. Spec 对齐 — 漏做
45
+
46
+ 逐条对照 spec 的每条要求(目标 / 业务规则 / 数据 / 异常 / 验收):
47
+
48
+ - spec 每条要求都能对应到 plan 里的至少一个任务?
49
+ - plan 里有 spec 没要求的任务?(scope creep)
50
+ - spec 的"非目标"被 plan 任务意外覆盖了?
51
+
52
+ **方法**:Read spec 全文 + plan 全文,对照找证据。spec 要求无任务对应 → 阻塞。
53
+
54
+ ### 3. 任务可执行性 — implementer 能跑
55
+
56
+ 每个任务:
57
+
58
+ - **目标**:一句话讲清做什么
59
+ - **依赖**:列出前置任务
60
+ - **涉及范围**:具体文件路径(不是 "src/ 下某文件")
61
+ - **具体要求**:可直接执行的步骤(命令 / 代码片段 / 接口签名),不是抽象描述
62
+ - **完成条件**:可验证(测试命令 + 期望输出,不是"应该工作")
63
+ - **验证方式**:具体命令,不是"跑测试"
64
+
65
+ **任务合并合理性**:T 测试任务和 B 实现任务应默认合并(spec §"任务合并指导")。如果 plan 拆开了但没写理由 → 标 issue。
66
+
67
+ ### 4. 跨任务一致性 — 类型/命名/接口对齐
68
+
69
+ 跨任务引用:
70
+
71
+ - 类型签名 / 函数名 / 接口名 / 表名 / 字段名在所有任务里一致?
72
+ - Task A 改了 X 的签名,Task B 引用 X 时跟上了吗?
73
+ - 文件路径跨任务一致(不能 Task 1 用 `src/foo.ts`,Task 5 用 `src/Foo.ts`)?
74
+
75
+ ### 5. 执行契约清晰度 — 防止实现期漂移
76
+
77
+ - 每个任务是否写明"必须严格执行"和"允许局部适配"?
78
+ - spec 中"不可留到实现期的决策"是否都落到 plan 任务或全局约束?
79
+ - plan 是否明确 `PLAN_CONFLICT` 的上报条件?
80
+ - 可并行任务是否真无冲突,且写明文件集合、公共契约、验证状态互不影响?
81
+
82
+ ## 你的工作流
83
+
84
+ 1. **Read plan 全文**(所有文件:index.md / 01-schema.md / 02-backend.md / 04-test.md / ...)
85
+ 2. **Read spec 全文**(如果有,主 agent 在 prompt 里给了路径)
86
+ 3. **逐任务审查**(5 个维度:完整性 / Spec 对齐 / 任务可执行性 / 跨任务一致性 / 执行契约清晰度)
87
+ 4. **报告**(不修代码,只报告)
88
+
89
+ ## 报告格式
90
+
91
+ ```
92
+ Plan 完整性: ✅ 通过 | ❌ 不通过(有阻塞问题)
93
+
94
+ 阻塞问题(必须修,否则 implementer 会卡):
95
+ - [Task <编号>, "具体要求" 第 N 条]: <问题> — <为什么阻塞 implementer>
96
+ 建议: <具体修法,可选给出代码片段>
97
+
98
+ 非阻塞建议(advisory,不阻塞 plan 通过):
99
+ - <措辞 / 风格 / 顺序优化建议>
100
+
101
+ Spec 覆盖度:
102
+ - ✅ / ❌ spec 每条要求都有任务对应
103
+ - <遗漏的 spec 要求,引用 spec 原文>
104
+ - <scope creep 的任务,引用 plan 原文>
105
+
106
+ 跨任务一致性:
107
+ - ✅ / ❌ 类型 / 命名 / 接口跨任务对齐
108
+ - <不一致的引用,具体到 file:line>
109
+
110
+ 执行契约清晰度:
111
+ - ✅ / ❌ 必须执行项、允许局部适配、PLAN_CONFLICT 条件清楚
112
+ - <会导致 implementer 临场发挥或 plan drift 的问题>
113
+ ```
114
+
115
+ ## 红线
116
+
117
+ - ❌ 不自己改 plan(你是审查,不是 fix;fix 由主 agent 做)
118
+ - ❌ 不挑措辞 / 风格 / 个人审美(只标真正阻塞的)
119
+ - ❌ 不重新设计任务拆分(那是 write-plan 阶段的事,你只验证现状)
120
+ - ❌ 不要求 plan 内嵌完整代码(plan 阶段无法预知所有实现细节,可执行命令 + 接口签名 + 验证矩阵足够)
121
+ - ❌ 不审"做对了吗"(spec 阶段已审),只审"plan 写得够具体吗,implementer 能跑吗"
122
+ - ❌ 不放过关键决策下放给 implementer 的写法
123
+ - ❌ 不忽略真正的 placeholder("add appropriate error handling" 这种是阻塞,不是建议)
124
+
125
+ ## 跟其他 reviewer 的边界
126
+
127
+ | 你管(plan 审查,执行前) | spec-reviewer 管(任务执行后,可选) | quality-reviewer 管(整体执行后) |
128
+ |---|---|---|
129
+ | plan 是否完整可执行 | 单任务实现是否符合 spec | 整体架构 / 命名一致性 |
130
+ | 任务是否有 placeholder | 漏做 / 多做 / 误解 | 跨任务协同问题 |
131
+ | 跨任务类型签名一致 | 边界条件覆盖 | 测试质量 |
132
+ | Spec 覆盖度 | 单任务测试覆盖 | 测试维护性 |
133
+
134
+ **核心区别**:你在**执行前**审 plan 是否够好,让执行阶段可以省去 per-task spec review。spec-reviewer 是用户可选派的单任务复审(默认不派)。quality-reviewer 是执行结束的最终关卡。