zero-workspace 0.0.2

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 (507) hide show
  1. package/CHANGELOG.md +18 -0
  2. package/README.md +187 -0
  3. package/config/component-versions.json +16 -0
  4. package/config/scenarioCapabilities.json +29 -0
  5. package/config/version-notes.yaml +244 -0
  6. package/dist/adapters/OutputAdapter.d.ts +79 -0
  7. package/dist/adapters/OutputAdapter.d.ts.map +1 -0
  8. package/dist/adapters/OutputAdapter.js +124 -0
  9. package/dist/adapters/OutputAdapter.js.map +1 -0
  10. package/dist/cli/check-node-version.d.ts +3 -0
  11. package/dist/cli/check-node-version.d.ts.map +1 -0
  12. package/dist/cli/check-node-version.js +153 -0
  13. package/dist/cli/check-node-version.js.map +1 -0
  14. package/dist/cli/plugins.d.ts +41 -0
  15. package/dist/cli/plugins.d.ts.map +1 -0
  16. package/dist/cli/plugins.js +742 -0
  17. package/dist/cli/plugins.js.map +1 -0
  18. package/dist/cli/rebuild.d.ts +63 -0
  19. package/dist/cli/rebuild.d.ts.map +1 -0
  20. package/dist/cli/rebuild.js +989 -0
  21. package/dist/cli/rebuild.js.map +1 -0
  22. package/dist/cli/repair.d.ts +7 -0
  23. package/dist/cli/repair.d.ts.map +1 -0
  24. package/dist/cli/repair.js +925 -0
  25. package/dist/cli/repair.js.map +1 -0
  26. package/dist/cli/setup.d.ts +7 -0
  27. package/dist/cli/setup.d.ts.map +1 -0
  28. package/dist/cli/setup.js +452 -0
  29. package/dist/cli/setup.js.map +1 -0
  30. package/dist/cli/update.d.ts +10 -0
  31. package/dist/cli/update.d.ts.map +1 -0
  32. package/dist/cli/update.js +426 -0
  33. package/dist/cli/update.js.map +1 -0
  34. package/dist/cli/webui.d.ts +6 -0
  35. package/dist/cli/webui.d.ts.map +1 -0
  36. package/dist/cli/webui.js +210 -0
  37. package/dist/cli/webui.js.map +1 -0
  38. package/dist/http/index.d.ts +3 -0
  39. package/dist/http/index.d.ts.map +1 -0
  40. package/dist/http/index.js +15 -0
  41. package/dist/http/index.js.map +1 -0
  42. package/dist/http/middleware/errorHandler.d.ts +16 -0
  43. package/dist/http/middleware/errorHandler.d.ts.map +1 -0
  44. package/dist/http/middleware/errorHandler.js +79 -0
  45. package/dist/http/middleware/errorHandler.js.map +1 -0
  46. package/dist/http/routes/admin.d.ts +3 -0
  47. package/dist/http/routes/admin.d.ts.map +1 -0
  48. package/dist/http/routes/admin.js +730 -0
  49. package/dist/http/routes/admin.js.map +1 -0
  50. package/dist/http/routes/backup.d.ts +3 -0
  51. package/dist/http/routes/backup.d.ts.map +1 -0
  52. package/dist/http/routes/backup.js +172 -0
  53. package/dist/http/routes/backup.js.map +1 -0
  54. package/dist/http/routes/config.d.ts +3 -0
  55. package/dist/http/routes/config.d.ts.map +1 -0
  56. package/dist/http/routes/config.js +157 -0
  57. package/dist/http/routes/config.js.map +1 -0
  58. package/dist/http/routes/context.d.ts +3 -0
  59. package/dist/http/routes/context.d.ts.map +1 -0
  60. package/dist/http/routes/context.js +82 -0
  61. package/dist/http/routes/context.js.map +1 -0
  62. package/dist/http/routes/log.d.ts +3 -0
  63. package/dist/http/routes/log.d.ts.map +1 -0
  64. package/dist/http/routes/log.js +105 -0
  65. package/dist/http/routes/log.js.map +1 -0
  66. package/dist/http/routes/memo.d.ts +6 -0
  67. package/dist/http/routes/memo.d.ts.map +1 -0
  68. package/dist/http/routes/memo.js +29 -0
  69. package/dist/http/routes/memo.js.map +1 -0
  70. package/dist/http/routes/node.d.ts +3 -0
  71. package/dist/http/routes/node.d.ts.map +1 -0
  72. package/dist/http/routes/node.js +251 -0
  73. package/dist/http/routes/node.js.map +1 -0
  74. package/dist/http/routes/state.d.ts +3 -0
  75. package/dist/http/routes/state.d.ts.map +1 -0
  76. package/dist/http/routes/state.js +48 -0
  77. package/dist/http/routes/state.js.map +1 -0
  78. package/dist/http/routes/workspace.d.ts +3 -0
  79. package/dist/http/routes/workspace.d.ts.map +1 -0
  80. package/dist/http/routes/workspace.js +249 -0
  81. package/dist/http/routes/workspace.js.map +1 -0
  82. package/dist/http/server.d.ts +10 -0
  83. package/dist/http/server.d.ts.map +1 -0
  84. package/dist/http/server.js +284 -0
  85. package/dist/http/server.js.map +1 -0
  86. package/dist/http/services.d.ts +93 -0
  87. package/dist/http/services.d.ts.map +1 -0
  88. package/dist/http/services.js +297 -0
  89. package/dist/http/services.js.map +1 -0
  90. package/dist/index.d.ts +3 -0
  91. package/dist/index.d.ts.map +1 -0
  92. package/dist/index.js +1073 -0
  93. package/dist/index.js.map +1 -0
  94. package/dist/prompts/guidanceContent.d.ts +18 -0
  95. package/dist/prompts/guidanceContent.d.ts.map +1 -0
  96. package/dist/prompts/guidanceContent.js +814 -0
  97. package/dist/prompts/guidanceContent.js.map +1 -0
  98. package/dist/prompts/index.d.ts +2 -0
  99. package/dist/prompts/index.d.ts.map +1 -0
  100. package/dist/prompts/index.js +4 -0
  101. package/dist/prompts/index.js.map +1 -0
  102. package/dist/prompts/instructions.d.ts +56 -0
  103. package/dist/prompts/instructions.d.ts.map +1 -0
  104. package/dist/prompts/instructions.js +1343 -0
  105. package/dist/prompts/instructions.js.map +1 -0
  106. package/dist/services/BackupService.d.ts +104 -0
  107. package/dist/services/BackupService.d.ts.map +1 -0
  108. package/dist/services/BackupService.js +549 -0
  109. package/dist/services/BackupService.js.map +1 -0
  110. package/dist/services/CapabilityService.d.ts +38 -0
  111. package/dist/services/CapabilityService.d.ts.map +1 -0
  112. package/dist/services/CapabilityService.js +256 -0
  113. package/dist/services/CapabilityService.js.map +1 -0
  114. package/dist/services/ConfigService.d.ts +35 -0
  115. package/dist/services/ConfigService.d.ts.map +1 -0
  116. package/dist/services/ConfigService.js +105 -0
  117. package/dist/services/ConfigService.js.map +1 -0
  118. package/dist/services/ContextService.d.ts +65 -0
  119. package/dist/services/ContextService.d.ts.map +1 -0
  120. package/dist/services/ContextService.js +503 -0
  121. package/dist/services/ContextService.js.map +1 -0
  122. package/dist/services/DetectionService.d.ts +76 -0
  123. package/dist/services/DetectionService.d.ts.map +1 -0
  124. package/dist/services/DetectionService.js +262 -0
  125. package/dist/services/DetectionService.js.map +1 -0
  126. package/dist/services/DispatchService.d.ts +267 -0
  127. package/dist/services/DispatchService.d.ts.map +1 -0
  128. package/dist/services/DispatchService.js +1357 -0
  129. package/dist/services/DispatchService.js.map +1 -0
  130. package/dist/services/EventService.d.ts +81 -0
  131. package/dist/services/EventService.d.ts.map +1 -0
  132. package/dist/services/EventService.js +187 -0
  133. package/dist/services/EventService.js.map +1 -0
  134. package/dist/services/GuidanceService.d.ts +64 -0
  135. package/dist/services/GuidanceService.d.ts.map +1 -0
  136. package/dist/services/GuidanceService.js +259 -0
  137. package/dist/services/GuidanceService.js.map +1 -0
  138. package/dist/services/HealthService.d.ts +43 -0
  139. package/dist/services/HealthService.d.ts.map +1 -0
  140. package/dist/services/HealthService.js +276 -0
  141. package/dist/services/HealthService.js.map +1 -0
  142. package/dist/services/InstallationService.d.ts +62 -0
  143. package/dist/services/InstallationService.d.ts.map +1 -0
  144. package/dist/services/InstallationService.js +204 -0
  145. package/dist/services/InstallationService.js.map +1 -0
  146. package/dist/services/LogService.d.ts +35 -0
  147. package/dist/services/LogService.d.ts.map +1 -0
  148. package/dist/services/LogService.js +189 -0
  149. package/dist/services/LogService.js.map +1 -0
  150. package/dist/services/MemoService.d.ts +39 -0
  151. package/dist/services/MemoService.d.ts.map +1 -0
  152. package/dist/services/MemoService.js +288 -0
  153. package/dist/services/MemoService.js.map +1 -0
  154. package/dist/services/NodeService.d.ts +90 -0
  155. package/dist/services/NodeService.d.ts.map +1 -0
  156. package/dist/services/NodeService.js +958 -0
  157. package/dist/services/NodeService.js.map +1 -0
  158. package/dist/services/OpenSpecParser.d.ts +43 -0
  159. package/dist/services/OpenSpecParser.d.ts.map +1 -0
  160. package/dist/services/OpenSpecParser.js +191 -0
  161. package/dist/services/OpenSpecParser.js.map +1 -0
  162. package/dist/services/ReferenceService.d.ts +35 -0
  163. package/dist/services/ReferenceService.d.ts.map +1 -0
  164. package/dist/services/ReferenceService.js +195 -0
  165. package/dist/services/ReferenceService.js.map +1 -0
  166. package/dist/services/RepairService.d.ts +36 -0
  167. package/dist/services/RepairService.d.ts.map +1 -0
  168. package/dist/services/RepairService.js +429 -0
  169. package/dist/services/RepairService.js.map +1 -0
  170. package/dist/services/SearchService.d.ts +34 -0
  171. package/dist/services/SearchService.d.ts.map +1 -0
  172. package/dist/services/SearchService.js +293 -0
  173. package/dist/services/SearchService.js.map +1 -0
  174. package/dist/services/SessionService.d.ts +136 -0
  175. package/dist/services/SessionService.d.ts.map +1 -0
  176. package/dist/services/SessionService.js +297 -0
  177. package/dist/services/SessionService.js.map +1 -0
  178. package/dist/services/StateService.d.ts +97 -0
  179. package/dist/services/StateService.d.ts.map +1 -0
  180. package/dist/services/StateService.js +846 -0
  181. package/dist/services/StateService.js.map +1 -0
  182. package/dist/services/TutorialService.d.ts +114 -0
  183. package/dist/services/TutorialService.d.ts.map +1 -0
  184. package/dist/services/TutorialService.js +1262 -0
  185. package/dist/services/TutorialService.js.map +1 -0
  186. package/dist/services/WorkspaceService.d.ts +273 -0
  187. package/dist/services/WorkspaceService.d.ts.map +1 -0
  188. package/dist/services/WorkspaceService.js +1764 -0
  189. package/dist/services/WorkspaceService.js.map +1 -0
  190. package/dist/services/index.d.ts +15 -0
  191. package/dist/services/index.d.ts.map +1 -0
  192. package/dist/services/index.js +14 -0
  193. package/dist/services/index.js.map +1 -0
  194. package/dist/storage/FileSystemAdapter.d.ts +223 -0
  195. package/dist/storage/FileSystemAdapter.d.ts.map +1 -0
  196. package/dist/storage/FileSystemAdapter.js +384 -0
  197. package/dist/storage/FileSystemAdapter.js.map +1 -0
  198. package/dist/storage/JsonStorage.d.ts +158 -0
  199. package/dist/storage/JsonStorage.d.ts.map +1 -0
  200. package/dist/storage/JsonStorage.js +613 -0
  201. package/dist/storage/JsonStorage.js.map +1 -0
  202. package/dist/storage/MarkdownStorage.d.ts +178 -0
  203. package/dist/storage/MarkdownStorage.d.ts.map +1 -0
  204. package/dist/storage/MarkdownStorage.js +918 -0
  205. package/dist/storage/MarkdownStorage.js.map +1 -0
  206. package/dist/storage/SessionBindingStorage.d.ts +69 -0
  207. package/dist/storage/SessionBindingStorage.d.ts.map +1 -0
  208. package/dist/storage/SessionBindingStorage.js +131 -0
  209. package/dist/storage/SessionBindingStorage.js.map +1 -0
  210. package/dist/storage/index.d.ts +6 -0
  211. package/dist/storage/index.d.ts.map +1 -0
  212. package/dist/storage/index.js +6 -0
  213. package/dist/storage/index.js.map +1 -0
  214. package/dist/tools/capability.d.ts +18 -0
  215. package/dist/tools/capability.d.ts.map +1 -0
  216. package/dist/tools/capability.js +73 -0
  217. package/dist/tools/capability.js.map +1 -0
  218. package/dist/tools/config.d.ts +14 -0
  219. package/dist/tools/config.d.ts.map +1 -0
  220. package/dist/tools/config.js +61 -0
  221. package/dist/tools/config.js.map +1 -0
  222. package/dist/tools/context.d.ts +22 -0
  223. package/dist/tools/context.d.ts.map +1 -0
  224. package/dist/tools/context.js +139 -0
  225. package/dist/tools/context.js.map +1 -0
  226. package/dist/tools/dispatch.d.ts +41 -0
  227. package/dist/tools/dispatch.d.ts.map +1 -0
  228. package/dist/tools/dispatch.js +380 -0
  229. package/dist/tools/dispatch.js.map +1 -0
  230. package/dist/tools/help.d.ts +44 -0
  231. package/dist/tools/help.d.ts.map +1 -0
  232. package/dist/tools/help.js +227 -0
  233. package/dist/tools/help.js.map +1 -0
  234. package/dist/tools/import.d.ts +17 -0
  235. package/dist/tools/import.d.ts.map +1 -0
  236. package/dist/tools/import.js +96 -0
  237. package/dist/tools/import.js.map +1 -0
  238. package/dist/tools/index.d.ts +12 -0
  239. package/dist/tools/index.d.ts.map +1 -0
  240. package/dist/tools/index.js +13 -0
  241. package/dist/tools/index.js.map +1 -0
  242. package/dist/tools/log.d.ts +21 -0
  243. package/dist/tools/log.d.ts.map +1 -0
  244. package/dist/tools/log.js +93 -0
  245. package/dist/tools/log.js.map +1 -0
  246. package/dist/tools/memo.d.ts +26 -0
  247. package/dist/tools/memo.d.ts.map +1 -0
  248. package/dist/tools/memo.js +188 -0
  249. package/dist/tools/memo.js.map +1 -0
  250. package/dist/tools/node.d.ts +34 -0
  251. package/dist/tools/node.d.ts.map +1 -0
  252. package/dist/tools/node.js +328 -0
  253. package/dist/tools/node.js.map +1 -0
  254. package/dist/tools/search.d.ts +14 -0
  255. package/dist/tools/search.d.ts.map +1 -0
  256. package/dist/tools/search.js +95 -0
  257. package/dist/tools/search.js.map +1 -0
  258. package/dist/tools/session.d.ts +22 -0
  259. package/dist/tools/session.d.ts.map +1 -0
  260. package/dist/tools/session.js +127 -0
  261. package/dist/tools/session.js.map +1 -0
  262. package/dist/tools/state.d.ts +10 -0
  263. package/dist/tools/state.d.ts.map +1 -0
  264. package/dist/tools/state.js +79 -0
  265. package/dist/tools/state.js.map +1 -0
  266. package/dist/tools/workspace.d.ts +38 -0
  267. package/dist/tools/workspace.d.ts.map +1 -0
  268. package/dist/tools/workspace.js +240 -0
  269. package/dist/tools/workspace.js.map +1 -0
  270. package/dist/types/capability.d.ts +36 -0
  271. package/dist/types/capability.d.ts.map +1 -0
  272. package/dist/types/capability.js +3 -0
  273. package/dist/types/capability.js.map +1 -0
  274. package/dist/types/confirmation.d.ts +35 -0
  275. package/dist/types/confirmation.d.ts.map +1 -0
  276. package/dist/types/confirmation.js +3 -0
  277. package/dist/types/confirmation.js.map +1 -0
  278. package/dist/types/context.d.ts +174 -0
  279. package/dist/types/context.d.ts.map +1 -0
  280. package/dist/types/context.js +3 -0
  281. package/dist/types/context.js.map +1 -0
  282. package/dist/types/errors.d.ts +81 -0
  283. package/dist/types/errors.d.ts.map +1 -0
  284. package/dist/types/errors.js +154 -0
  285. package/dist/types/errors.js.map +1 -0
  286. package/dist/types/guidance.d.ts +162 -0
  287. package/dist/types/guidance.d.ts.map +1 -0
  288. package/dist/types/guidance.js +4 -0
  289. package/dist/types/guidance.js.map +1 -0
  290. package/dist/types/health.d.ts +61 -0
  291. package/dist/types/health.d.ts.map +1 -0
  292. package/dist/types/health.js +3 -0
  293. package/dist/types/health.js.map +1 -0
  294. package/dist/types/index.d.ts +10 -0
  295. package/dist/types/index.d.ts.map +1 -0
  296. package/dist/types/index.js +11 -0
  297. package/dist/types/index.js.map +1 -0
  298. package/dist/types/memo.d.ts +132 -0
  299. package/dist/types/memo.d.ts.map +1 -0
  300. package/dist/types/memo.js +3 -0
  301. package/dist/types/memo.js.map +1 -0
  302. package/dist/types/node.d.ts +316 -0
  303. package/dist/types/node.d.ts.map +1 -0
  304. package/dist/types/node.js +3 -0
  305. package/dist/types/node.js.map +1 -0
  306. package/dist/types/repair.d.ts +62 -0
  307. package/dist/types/repair.d.ts.map +1 -0
  308. package/dist/types/repair.js +4 -0
  309. package/dist/types/repair.js.map +1 -0
  310. package/dist/types/search.d.ts +58 -0
  311. package/dist/types/search.d.ts.map +1 -0
  312. package/dist/types/search.js +3 -0
  313. package/dist/types/search.js.map +1 -0
  314. package/dist/types/settings.d.ts +109 -0
  315. package/dist/types/settings.d.ts.map +1 -0
  316. package/dist/types/settings.js +30 -0
  317. package/dist/types/settings.js.map +1 -0
  318. package/dist/types/workspace.d.ts +357 -0
  319. package/dist/types/workspace.d.ts.map +1 -0
  320. package/dist/types/workspace.js +3 -0
  321. package/dist/types/workspace.js.map +1 -0
  322. package/dist/utils/contentValidation.d.ts +47 -0
  323. package/dist/utils/contentValidation.d.ts.map +1 -0
  324. package/dist/utils/contentValidation.js +93 -0
  325. package/dist/utils/contentValidation.js.map +1 -0
  326. package/dist/utils/devLog.d.ts +43 -0
  327. package/dist/utils/devLog.d.ts.map +1 -0
  328. package/dist/utils/devLog.js +94 -0
  329. package/dist/utils/devLog.js.map +1 -0
  330. package/dist/utils/errorLogger.d.ts +27 -0
  331. package/dist/utils/errorLogger.d.ts.map +1 -0
  332. package/dist/utils/errorLogger.js +105 -0
  333. package/dist/utils/errorLogger.js.map +1 -0
  334. package/dist/utils/git.d.ts +123 -0
  335. package/dist/utils/git.d.ts.map +1 -0
  336. package/dist/utils/git.js +400 -0
  337. package/dist/utils/git.js.map +1 -0
  338. package/dist/utils/hash.d.ts +32 -0
  339. package/dist/utils/hash.d.ts.map +1 -0
  340. package/dist/utils/hash.js +37 -0
  341. package/dist/utils/hash.js.map +1 -0
  342. package/dist/utils/id.d.ts +54 -0
  343. package/dist/utils/id.d.ts.map +1 -0
  344. package/dist/utils/id.js +96 -0
  345. package/dist/utils/id.js.map +1 -0
  346. package/dist/utils/index.d.ts +8 -0
  347. package/dist/utils/index.d.ts.map +1 -0
  348. package/dist/utils/index.js +9 -0
  349. package/dist/utils/index.js.map +1 -0
  350. package/dist/utils/logger.d.ts +42 -0
  351. package/dist/utils/logger.d.ts.map +1 -0
  352. package/dist/utils/logger.js +228 -0
  353. package/dist/utils/logger.js.map +1 -0
  354. package/dist/utils/manualChangeFormatter.d.ts +8 -0
  355. package/dist/utils/manualChangeFormatter.d.ts.map +1 -0
  356. package/dist/utils/manualChangeFormatter.js +21 -0
  357. package/dist/utils/manualChangeFormatter.js.map +1 -0
  358. package/dist/utils/paramValidator.d.ts +35 -0
  359. package/dist/utils/paramValidator.d.ts.map +1 -0
  360. package/dist/utils/paramValidator.js +214 -0
  361. package/dist/utils/paramValidator.js.map +1 -0
  362. package/dist/utils/port.d.ts +7 -0
  363. package/dist/utils/port.d.ts.map +1 -0
  364. package/dist/utils/port.js +28 -0
  365. package/dist/utils/port.js.map +1 -0
  366. package/dist/utils/processManager.d.ts +53 -0
  367. package/dist/utils/processManager.d.ts.map +1 -0
  368. package/dist/utils/processManager.js +267 -0
  369. package/dist/utils/processManager.js.map +1 -0
  370. package/dist/utils/sessionLogger.d.ts +28 -0
  371. package/dist/utils/sessionLogger.d.ts.map +1 -0
  372. package/dist/utils/sessionLogger.js +142 -0
  373. package/dist/utils/sessionLogger.js.map +1 -0
  374. package/dist/utils/time.d.ts +15 -0
  375. package/dist/utils/time.d.ts.map +1 -0
  376. package/dist/utils/time.js +32 -0
  377. package/dist/utils/time.js.map +1 -0
  378. package/dist/utils/validation.d.ts +23 -0
  379. package/dist/utils/validation.d.ts.map +1 -0
  380. package/dist/utils/validation.js +88 -0
  381. package/dist/utils/validation.js.map +1 -0
  382. package/docs//346/227/245/345/277/227/347/263/273/347/273/237.md +389 -0
  383. package/docs//347/224/250/346/210/267/346/211/213/345/206/214.md +1446 -0
  384. package/docs//347/224/250/346/210/267/346/211/213/345/206/214/344/270/216/346/212/200/346/234/257/346/214/207/345/215/227.md +873 -0
  385. package/package.json +94 -0
  386. package/plugin/README.md +141 -0
  387. package/plugin/agents/zero-executor.md +114 -0
  388. package/plugin/agents/zero-reviewer.md +133 -0
  389. package/plugin/docs/diagnostic-guide.md +128 -0
  390. package/plugin/hooks/hooks.json.deprecated +70 -0
  391. package/plugin/scripts/cursor-hook-entry.cjs +217 -0
  392. package/plugin/scripts/hook-entry.cjs +663 -0
  393. package/plugin/scripts/openspec-import.cjs +714 -0
  394. package/plugin/scripts/shared/binding.cjs +98 -0
  395. package/plugin/scripts/shared/config.cjs +65 -0
  396. package/plugin/scripts/shared/context.cjs +120 -0
  397. package/plugin/scripts/shared/index.cjs +34 -0
  398. package/plugin/scripts/shared/logger.cjs +196 -0
  399. package/plugin/scripts/shared/reminder.cjs +261 -0
  400. package/plugin/scripts/shared/utils.cjs +62 -0
  401. package/plugin/scripts/shared/workspace.cjs +322 -0
  402. package/plugin/skills/aligning-intent/SKILL.md +275 -0
  403. package/plugin/skills/analyzing-measurements/SKILL.md +223 -0
  404. package/plugin/skills/bootstrapping-workspace/SKILL.md +260 -0
  405. package/plugin/skills/designing-solutions/SKILL.md +363 -0
  406. package/plugin/skills/diagnosing-issues/SKILL.md +219 -0
  407. package/plugin/skills/discovering-context/SKILL.md +283 -0
  408. package/plugin/skills/dispatching-parent/SKILL.md +399 -0
  409. package/plugin/skills/executing-task/SKILL.md +340 -0
  410. package/plugin/skills/memo-create/SKILL.md +222 -0
  411. package/plugin/skills/planning-verification/SKILL.md +245 -0
  412. package/plugin/skills/preparing-dispatch/SKILL.md +299 -0
  413. package/plugin/skills/researching-tech/SKILL.md +223 -0
  414. package/plugin/skills/reviewing-quality/SKILL.md +354 -0
  415. package/plugin/skills/reviewing-spec/SKILL.md +333 -0
  416. package/plugin/skills/starting-info-flow/SKILL.md +196 -0
  417. package/web/README.md +5 -0
  418. package/web/dist/assets/DocsView-Bls_Vjsr.css +1 -0
  419. package/web/dist/assets/DocsView-Cxc0B63r.js +1447 -0
  420. package/web/dist/assets/HomeView-C7df9thb.js +9 -0
  421. package/web/dist/assets/HomeView-ufUdnfHk.css +1 -0
  422. package/web/dist/assets/MarkdownContent-DXp6CtSP.js +308 -0
  423. package/web/dist/assets/MarkdownContent-NFqiOBLH.css +1 -0
  424. package/web/dist/assets/NotFoundView-BYX1oZAn.css +1 -0
  425. package/web/dist/assets/NotFoundView-zrc0lT9q.js +1 -0
  426. package/web/dist/assets/WorkspaceView-BckqgNcX.js +27 -0
  427. package/web/dist/assets/WorkspaceView-J1dgpYMx.css +1 -0
  428. package/web/dist/assets/WsConfirmDialog-C1CvL4my.css +1 -0
  429. package/web/dist/assets/WsConfirmDialog-gLEP7uBD.js +4 -0
  430. package/web/dist/assets/arc-DPkKTkUT.js +1 -0
  431. package/web/dist/assets/architectureDiagram-VXUJARFQ-CEGpqUlZ.js +36 -0
  432. package/web/dist/assets/blockDiagram-VD42YOAC-Bv-mqdQH.js +122 -0
  433. package/web/dist/assets/c4Diagram-YG6GDRKO-DRyPatZ_.js +10 -0
  434. package/web/dist/assets/channel-B84mKLDZ.js +1 -0
  435. package/web/dist/assets/chunk-4BX2VUAB-c7DivX0u.js +1 -0
  436. package/web/dist/assets/chunk-55IACEB6-CGKTaLlo.js +1 -0
  437. package/web/dist/assets/chunk-B4BG7PRW-Czhx5Q_P.js +165 -0
  438. package/web/dist/assets/chunk-DI55MBZ5-CQVA7hcZ.js +220 -0
  439. package/web/dist/assets/chunk-FMBD7UC4-hEiPmi7V.js +15 -0
  440. package/web/dist/assets/chunk-QN33PNHL-rL6yYI-E.js +1 -0
  441. package/web/dist/assets/chunk-QZHKN3VN-BRyHBBzq.js +1 -0
  442. package/web/dist/assets/chunk-TZMSLE5B-D4PXmTz9.js +1 -0
  443. package/web/dist/assets/classDiagram-2ON5EDUG-CNn53ohi.js +1 -0
  444. package/web/dist/assets/classDiagram-v2-WZHVMYZB-CNn53ohi.js +1 -0
  445. package/web/dist/assets/cose-bilkent-S5V4N54A-BAREnRga.js +1 -0
  446. package/web/dist/assets/cytoscape.esm-BnkdMOzK.js +321 -0
  447. package/web/dist/assets/dagre-6UL2VRFP-DaYzb3MT.js +4 -0
  448. package/web/dist/assets/defaultLocale-C4B-KCzX.js +1 -0
  449. package/web/dist/assets/diagram-PSM6KHXK-BFltDqvd.js +24 -0
  450. package/web/dist/assets/diagram-QEK2KX5R-CR4VU2La.js +43 -0
  451. package/web/dist/assets/diagram-S2PKOQOG-0UfIeT-1.js +24 -0
  452. package/web/dist/assets/erDiagram-Q2GNP2WA-Bo17Xmng.js +60 -0
  453. package/web/dist/assets/flowDiagram-NV44I4VS-CzqhQp8s.js +162 -0
  454. package/web/dist/assets/ganttDiagram-JELNMOA3-TXwXtUcq.js +267 -0
  455. package/web/dist/assets/gitGraphDiagram-NY62KEGX-CoFQTy9O.js +65 -0
  456. package/web/dist/assets/graph-CIQcRIVd.js +1 -0
  457. package/web/dist/assets/index-BgLd_o_M.css +1 -0
  458. package/web/dist/assets/index-Cd_J3fZn.js +30 -0
  459. package/web/dist/assets/infoDiagram-WHAUD3N6-Dq0xXfVu.js +2 -0
  460. package/web/dist/assets/init-Gi6I4Gst.js +1 -0
  461. package/web/dist/assets/journeyDiagram-XKPGCS4Q-jIg5BOfC.js +139 -0
  462. package/web/dist/assets/kanban-definition-3W4ZIXB7-D2giu6aZ.js +89 -0
  463. package/web/dist/assets/katex-XbL3y5x-.js +261 -0
  464. package/web/dist/assets/layout-Bm-XCM-8.js +1 -0
  465. package/web/dist/assets/linear-FbekP9OZ.js +1 -0
  466. package/web/dist/assets/min-BrRCpYmF.js +1 -0
  467. package/web/dist/assets/mindmap-definition-VGOIOE7T-o-4ubbY9.js +68 -0
  468. package/web/dist/assets/noto-emoji-0-400-normal-BTQbhB77.woff +0 -0
  469. package/web/dist/assets/noto-emoji-0-400-normal-DHdy6Uhy.woff2 +0 -0
  470. package/web/dist/assets/noto-emoji-1-400-normal-0IvkdXBB.woff +0 -0
  471. package/web/dist/assets/noto-emoji-1-400-normal-BY9OovbM.woff2 +0 -0
  472. package/web/dist/assets/noto-emoji-10-400-normal-D9w4QCof.woff2 +0 -0
  473. package/web/dist/assets/noto-emoji-10-400-normal-DtCumcZR.woff +0 -0
  474. package/web/dist/assets/noto-emoji-11-400-normal-BboTlyvx.woff +0 -0
  475. package/web/dist/assets/noto-emoji-12-400-normal-BB5pgBKj.woff2 +0 -0
  476. package/web/dist/assets/noto-emoji-12-400-normal-g186qhiA.woff +0 -0
  477. package/web/dist/assets/noto-emoji-2-400-normal-BKCR1azW.woff2 +0 -0
  478. package/web/dist/assets/noto-emoji-2-400-normal-BYH0KhDr.woff +0 -0
  479. package/web/dist/assets/noto-emoji-3-400-normal-CnPTUeEK.woff +0 -0
  480. package/web/dist/assets/noto-emoji-3-400-normal-TrTb2VQM.woff2 +0 -0
  481. package/web/dist/assets/noto-emoji-4-400-normal-BxD0KVdj.woff +0 -0
  482. package/web/dist/assets/noto-emoji-4-400-normal-s_n9EyG1.woff2 +0 -0
  483. package/web/dist/assets/noto-emoji-5-400-normal-C190AIxR.woff +0 -0
  484. package/web/dist/assets/noto-emoji-5-400-normal-Ctfx4xc6.woff2 +0 -0
  485. package/web/dist/assets/noto-emoji-6-400-normal-DlXlXWt7.woff +0 -0
  486. package/web/dist/assets/noto-emoji-6-400-normal-NzsjD754.woff2 +0 -0
  487. package/web/dist/assets/noto-emoji-7-400-normal-BHP8KeA6.woff2 +0 -0
  488. package/web/dist/assets/noto-emoji-7-400-normal-CtuKhtAZ.woff +0 -0
  489. package/web/dist/assets/noto-emoji-8-400-normal-DR49ZFe7.woff +0 -0
  490. package/web/dist/assets/noto-emoji-8-400-normal-Dvmkf6b2.woff2 +0 -0
  491. package/web/dist/assets/noto-emoji-9-400-normal-BeHJQ2iK.woff2 +0 -0
  492. package/web/dist/assets/noto-emoji-9-400-normal-BlXmCgeQ.woff +0 -0
  493. package/web/dist/assets/ordinal-Cboi1Yqb.js +1 -0
  494. package/web/dist/assets/pieDiagram-ADFJNKIX-C45wSpld.js +30 -0
  495. package/web/dist/assets/quadrantDiagram-AYHSOK5B-tv-_fe-W.js +7 -0
  496. package/web/dist/assets/reduce-CoLNNlNb.js +1 -0
  497. package/web/dist/assets/requirementDiagram-UZGBJVZJ-Dn6PDfkL.js +64 -0
  498. package/web/dist/assets/sankeyDiagram-TZEHDZUN-CbXTZAsG.js +10 -0
  499. package/web/dist/assets/sequenceDiagram-WL72ISMW-B-o1CUJ5.js +145 -0
  500. package/web/dist/assets/stateDiagram-FKZM4ZOC-hzrupXQi.js +1 -0
  501. package/web/dist/assets/stateDiagram-v2-4FDKWEC3-DN-c2M96.js +1 -0
  502. package/web/dist/assets/timeline-definition-IT6M3QCI-R5SP9GDo.js +61 -0
  503. package/web/dist/assets/treemap-KMMF4GRG-Pg9KlUOt.js +128 -0
  504. package/web/dist/assets/xychartDiagram-PRI3JC2R-C3vbJhd1.js +7 -0
  505. package/web/dist/favicon.svg +13 -0
  506. package/web/dist/index.html +17 -0
  507. package//351/205/215/347/275/256/346/226/271/345/274/217.md +330 -0
@@ -0,0 +1,503 @@
1
+ // src/services/ContextService.ts
2
+ import * as crypto from "node:crypto";
3
+ import { ZeroError } from "../types/errors.js";
4
+ import { now } from "../utils/time.js";
5
+ import { computeConclusionsHash } from "../utils/hash.js";
6
+ import { devLog } from "../utils/devLog.js";
7
+ import { GuidanceService } from "./GuidanceService.js";
8
+ import { eventService } from "./EventService.js";
9
+ // ========== 结论截取常量 ==========
10
+ const CONCLUSION_TRUNCATE_THRESHOLD = 600; // 超过此长度才截取
11
+ const CONCLUSION_HEAD_LENGTH = 400; // 保留头部字符数
12
+ const CONCLUSION_TAIL_LENGTH = 200; // 保留尾部字符数
13
+ /**
14
+ * 软截取结论:前 400 + 尾 200,中间用省略标记
15
+ * 用于 childConclusions,避免超长老结论占用过多 token
16
+ */
17
+ function truncateConclusion(conclusion) {
18
+ if (conclusion.length <= CONCLUSION_TRUNCATE_THRESHOLD) {
19
+ return conclusion;
20
+ }
21
+ const head = conclusion.slice(0, CONCLUSION_HEAD_LENGTH);
22
+ const tail = conclusion.slice(-CONCLUSION_TAIL_LENGTH);
23
+ const omitted = conclusion.length - CONCLUSION_HEAD_LENGTH - CONCLUSION_TAIL_LENGTH;
24
+ return `${head}\n\n...[已截取 ${omitted} 字符,完整内容请用 node_get 查看]...\n\n${tail}`;
25
+ }
26
+ /**
27
+ * 上下文服务
28
+ * 处理上下文获取和焦点管理
29
+ */
30
+ export class ContextService {
31
+ json;
32
+ md;
33
+ fs;
34
+ guidanceService;
35
+ workspaceService; // WorkspaceService - 避免循环依赖,通过 setter 注入
36
+ memoService; // MemoService - 通过 setter 注入
37
+ installationService;
38
+ constructor(json, md, fs) {
39
+ this.json = json;
40
+ this.md = md;
41
+ this.fs = fs;
42
+ this.guidanceService = new GuidanceService();
43
+ }
44
+ /**
45
+ * 设置 WorkspaceService 依赖(用于清除手动变更)
46
+ */
47
+ setWorkspaceService(workspaceService) {
48
+ this.workspaceService = workspaceService;
49
+ }
50
+ /**
51
+ * 设置 MemoService 依赖(用于获取 memo 内容)
52
+ */
53
+ setMemoService(memoService) {
54
+ this.memoService = memoService;
55
+ }
56
+ /**
57
+ * 设置 InstallationService 依赖(用于项目组件版本检查)
58
+ */
59
+ setInstallationService(service) {
60
+ this.installationService = service;
61
+ }
62
+ /**
63
+ * 根据 workspaceId 获取工作区信息(包括归档状态和目录名)
64
+ */
65
+ async resolveWorkspaceInfo(workspaceId) {
66
+ const index = await this.json.readIndex();
67
+ const wsEntry = index.workspaces.find(ws => ws.id === workspaceId);
68
+ if (!wsEntry) {
69
+ throw new ZeroError("WORKSPACE_NOT_FOUND", `工作区 "${workspaceId}" 不存在`);
70
+ }
71
+ if (wsEntry.status === "error" && wsEntry.errorInfo) {
72
+ throw new ZeroError("WORKSPACE_ERROR", `工作区 "${workspaceId}" 处于错误状态: ${wsEntry.errorInfo.message}`);
73
+ }
74
+ const isArchived = wsEntry.status === "archived";
75
+ const wsDirName = wsEntry.dirName || wsEntry.id; // 向后兼容
76
+ if (isArchived) {
77
+ devLog.archivePath(workspaceId, isArchived, this.fs.getWorkspaceBasePath(wsEntry.projectRoot, wsDirName, true));
78
+ }
79
+ return {
80
+ projectRoot: wsEntry.projectRoot,
81
+ wsDirName,
82
+ isArchived,
83
+ };
84
+ }
85
+ /**
86
+ * 获取聚焦上下文
87
+ */
88
+ async get(params) {
89
+ const { workspaceId, nodeId, includeLog = true, maxLogEntries = 20, reverseLog = false, includeProblem = true, } = params;
90
+ // 1. 获取工作区信息(包括归档状态)
91
+ const { projectRoot, wsDirName, isArchived } = await this.resolveWorkspaceInfo(workspaceId);
92
+ // 2. 验证节点存在
93
+ const graph = await this.json.readGraph(projectRoot, wsDirName, isArchived);
94
+ if (!graph.nodes[nodeId]) {
95
+ throw new ZeroError("NODE_NOT_FOUND", `节点 "${nodeId}" 不存在`);
96
+ }
97
+ // 3. 读取工作区 Workspace.md,提取 rules/docs
98
+ const workspaceData = await this.md.readWorkspaceMdFull(projectRoot, wsDirName, isArchived);
99
+ // 3.1 从根节点读取 goal(requirement 字段)- goal 已统一到根节点
100
+ const config = await this.json.readWorkspaceConfig(projectRoot, wsDirName, isArchived);
101
+ const rootNodeId = config.rootNodeId || "root";
102
+ const rootNodeMeta = graph.nodes[rootNodeId];
103
+ const rootNodeDirName = rootNodeMeta?.dirName || rootNodeId;
104
+ const rootNodeInfo = await this.md.readNodeInfo(projectRoot, wsDirName, rootNodeDirName, isArchived);
105
+ const goal = rootNodeInfo.requirement || "";
106
+ // 4. 构建上下文链(从根到当前节点)
107
+ const chain = await this.buildContextChain(projectRoot, wsDirName, nodeId, graph, {
108
+ includeLog,
109
+ maxLogEntries,
110
+ includeProblem,
111
+ reverseLog,
112
+ }, isArchived, workspaceId);
113
+ // 5. 收集跨节点引用和 memo 引用
114
+ const nodeMeta = graph.nodes[nodeId];
115
+ const references = [];
116
+ const memoReferences = [];
117
+ for (const ref of nodeMeta.references || []) {
118
+ // 检查是否为 memo 引用
119
+ if (ref.startsWith("memo://")) {
120
+ const memoId = ref.substring(7); // 去掉 "memo://" 前缀
121
+ try {
122
+ if (this.memoService) {
123
+ const memoResult = await this.memoService.get({
124
+ workspaceId,
125
+ memoId,
126
+ });
127
+ memoReferences.push({
128
+ memoId: memoResult.memo.id,
129
+ title: memoResult.memo.title,
130
+ summary: memoResult.memo.summary,
131
+ content: memoResult.memo.content,
132
+ tags: memoResult.memo.tags,
133
+ });
134
+ }
135
+ }
136
+ catch (error) {
137
+ // Memo 不存在或读取失败,跳过
138
+ devLog.warn("获取 memo 失败", { memoId, error });
139
+ }
140
+ }
141
+ else if (graph.nodes[ref]) {
142
+ // 节点引用
143
+ const refItem = await this.buildSingleContextItem(projectRoot, wsDirName, ref, graph, {
144
+ includeLog,
145
+ maxLogEntries,
146
+ includeProblem,
147
+ reverseLog,
148
+ }, isArchived, workspaceId);
149
+ references.push(refItem);
150
+ }
151
+ }
152
+ // 6. 收集所有直接子节点信息
153
+ // 内容数据以 Info.md 为权威来源
154
+ // 对超长结论进行软截取(前 400 + 尾 200)
155
+ const childConclusions = [];
156
+ for (const childId of nodeMeta.children) {
157
+ const childMeta = graph.nodes[childId];
158
+ if (childMeta) {
159
+ const childDirName = childMeta.dirName || childId; // 向后兼容
160
+ const childInfo = await this.md.readNodeInfo(projectRoot, wsDirName, childDirName, isArchived);
161
+ childConclusions.push({
162
+ nodeId: childId,
163
+ title: childInfo.title,
164
+ status: childMeta.status,
165
+ conclusion: truncateConclusion(childInfo.conclusion || ""),
166
+ });
167
+ }
168
+ }
169
+ // 7. 生成工作流提示
170
+ const hint = this.generateHint(nodeMeta, chain, childConclusions);
171
+ // 8. 计算规则哈希
172
+ const rulesHash = workspaceData.rules.length > 0
173
+ ? crypto.createHash("md5").update(workspaceData.rules.join("\n")).digest("hex").substring(0, 8)
174
+ : "";
175
+ // 8.1 生成引导内容
176
+ const guidanceContext = {
177
+ toolName: "context_get",
178
+ nodeType: nodeMeta.type,
179
+ nodeStatus: nodeMeta.status,
180
+ hasChildren: nodeMeta.children.length > 0,
181
+ hasDocs: workspaceData.docs.length > 0,
182
+ };
183
+ const guidance = this.guidanceService.generateFromContext(guidanceContext, 0);
184
+ // 9. 读取派发配置(如果存在)- config 已在前面读取
185
+ const dispatch = config.dispatch?.enabled ? config.dispatch : undefined;
186
+ // 10. 清除手动变更清单(AI 已获取上下文,无需再提醒历史变更)
187
+ // 注意:只在非归档状态下清除,归档工作区为只读
188
+ if (!isArchived && this.workspaceService) {
189
+ try {
190
+ await this.workspaceService.clearManualChanges(workspaceId);
191
+ }
192
+ catch (error) {
193
+ // 清除失败不影响主流程
194
+ devLog.warn("清除手动变更失败", { workspaceId, error });
195
+ }
196
+ }
197
+ // 11. 计算 conclusionsHash(使用 graph.json 中的原始结论,与 node_transition 保持一致)
198
+ // 注意:childConclusions 中的 conclusion 可能被截断,不能用于 hash 计算
199
+ const conclusionsForHash = nodeMeta.children
200
+ .map(childId => {
201
+ const childMeta = graph.nodes[childId];
202
+ return childMeta ? { nodeId: childId, conclusion: childMeta.conclusion || "" } : null;
203
+ })
204
+ .filter((c) => c !== null && !!c.conclusion);
205
+ const conclusionsHash = computeConclusionsHash(conclusionsForHash);
206
+ // 12. 返回结果
207
+ return {
208
+ workspace: {
209
+ goal, // 从根节点 requirement 读取
210
+ rules: workspaceData.rules,
211
+ rulesHash,
212
+ docs: workspaceData.docs,
213
+ dispatch,
214
+ },
215
+ chain,
216
+ references,
217
+ memoReferences,
218
+ childConclusions,
219
+ conclusionsHash,
220
+ hint,
221
+ guidance: guidance.content,
222
+ };
223
+ }
224
+ /**
225
+ * 根据节点类型和状态生成工作流提示
226
+ */
227
+ generateHint(nodeMeta, chain, childConclusions) {
228
+ const currentNode = chain[chain.length - 1];
229
+ const logCount = currentNode?.logEntries?.length ?? 0;
230
+ const docsCount = currentNode?.docs?.length ?? 0;
231
+ const nodeType = nodeMeta.type;
232
+ const childCount = nodeMeta.children.length;
233
+ // 文档缺失提醒(仅在 pending/implementing/planning 状态提示)
234
+ const needsDocsWarning = ["pending", "implementing", "planning"].includes(nodeMeta.status);
235
+ const docsWarning = docsCount === 0 && needsDocsWarning
236
+ ? " ⚠️ 当前节点无文档引用,如需参考文档请用 node_reference 添加,或确认父节点是否遗漏派发。"
237
+ : "";
238
+ // 规划节点特殊处理
239
+ if (nodeType === "planning") {
240
+ switch (nodeMeta.status) {
241
+ case "pending":
242
+ return "💡 规划节点待启动。请调用 node_transition(action=\"start\") 进入规划状态。" + docsWarning;
243
+ case "planning":
244
+ if (childCount === 0) {
245
+ return "💡 规划节点已激活,尚无子节点。分析完需求后,使用 node_create 创建执行节点(type=\"execution\")或子规划节点(type=\"planning\")来分解任务。" + docsWarning;
246
+ }
247
+ else {
248
+ return "💡 规划节点有子节点但仍在规划状态。如需继续添加子节点可继续创建,否则等待子节点 start 后进入 monitoring。" + docsWarning;
249
+ }
250
+ case "monitoring":
251
+ const completedCount = childConclusions.filter(c => c.status === "completed" || c.status === "failed").length;
252
+ const pendingChildren = childCount - completedCount;
253
+ if (pendingChildren > 0) {
254
+ return `💡 规划节点正在监控子节点。已完成 ${completedCount}/${childCount},还有 ${pendingChildren} 个子节点待完成。`;
255
+ }
256
+ else {
257
+ return "💡 所有子节点已完成。请调用 node_transition(action=\"complete\", conclusion=\"...\") 汇总结论。";
258
+ }
259
+ case "completed":
260
+ return "💡 规划节点已完成。如需修改请 reopen,或切换到其他任务。";
261
+ case "cancelled":
262
+ return "💡 规划节点已取消。如需重新规划请 reopen。";
263
+ default:
264
+ return "";
265
+ }
266
+ }
267
+ // 执行节点处理
268
+ if (nodeType === "execution") {
269
+ switch (nodeMeta.status) {
270
+ case "pending":
271
+ return "💡 执行节点待启动。请调用 node_transition(action=\"start\") 开始执行。" + docsWarning;
272
+ case "implementing":
273
+ if (logCount === 0) {
274
+ return "💡 执行任务进行中,但尚未记录日志。请使用 log_append 记录执行过程。如果发现任务过于复杂,请 fail 回退到父规划节点分解。" + docsWarning;
275
+ }
276
+ else {
277
+ return "💡 执行任务进行中。继续执行并记录日志,完成后调用 node_transition(action=\"complete\", conclusion=\"...\")。" + docsWarning;
278
+ }
279
+ case "validating":
280
+ return "💡 执行任务验证中。验证通过请 complete,验证失败请 fail。";
281
+ case "completed":
282
+ return "💡 执行任务已完成。如需修改请 reopen,或切换到其他任务。";
283
+ case "failed":
284
+ return "💡 执行任务已失败。分析失败原因:如果任务过于复杂,回到父规划节点重新分解;如果是可修复的问题,retry 后重试。";
285
+ default:
286
+ return "";
287
+ }
288
+ }
289
+ // 兼容旧节点(无 type)
290
+ switch (nodeMeta.status) {
291
+ case "pending":
292
+ return "💡 节点待执行。请调用 node_transition(action=\"start\") 开始执行。" + docsWarning;
293
+ case "implementing":
294
+ return "💡 任务执行中。使用 log_append 记录进展,完成后调用 node_transition(action=\"complete\")。" + docsWarning;
295
+ case "validating":
296
+ return "💡 任务验证中。验证通过请 complete,验证失败请 fail。";
297
+ case "completed":
298
+ return "💡 任务已完成。如需修改请 reopen,或切换到其他任务。";
299
+ case "failed":
300
+ return "💡 任务已失败。分析原因后可 retry 重试。";
301
+ default:
302
+ return "";
303
+ }
304
+ }
305
+ /**
306
+ * 设置当前焦点
307
+ */
308
+ async focus(params) {
309
+ const { workspaceId, nodeId } = params;
310
+ // 1. 获取工作区信息
311
+ const { projectRoot, wsDirName } = await this.resolveWorkspaceInfo(workspaceId);
312
+ // 2. 验证节点存在
313
+ const graph = await this.json.readGraph(projectRoot, wsDirName);
314
+ if (!graph.nodes[nodeId]) {
315
+ throw new ZeroError("NODE_NOT_FOUND", `节点 "${nodeId}" 不存在`);
316
+ }
317
+ // 3. 保存之前的焦点
318
+ const previousFocus = graph.currentFocus;
319
+ // 3.1 检查 conclusionStale 阻断
320
+ if (previousFocus && previousFocus !== nodeId) {
321
+ // 获取当前焦点的祖先链中所有 stale 节点
322
+ const staleAncestors = [];
323
+ let currentId = previousFocus;
324
+ while (currentId) {
325
+ const currentMeta = graph.nodes[currentId];
326
+ if (!currentMeta)
327
+ break;
328
+ if (currentMeta.conclusionStale) {
329
+ staleAncestors.push(currentId);
330
+ }
331
+ currentId = currentMeta.parentId;
332
+ }
333
+ // 如果有 stale 祖先,检查目标节点是否在其子树内
334
+ if (staleAncestors.length > 0) {
335
+ // 获取目标节点的祖先链(包含自身)
336
+ const targetAncestors = new Set();
337
+ let targetId = nodeId;
338
+ while (targetId) {
339
+ targetAncestors.add(targetId);
340
+ const targetMeta = graph.nodes[targetId];
341
+ if (!targetMeta)
342
+ break;
343
+ targetId = targetMeta.parentId;
344
+ }
345
+ // 检查是否切换到了 stale 节点子树外
346
+ // 如果目标节点的祖先链包含 stale 节点,则在子树内(允许)
347
+ // 否则在子树外(阻断)
348
+ for (const staleId of staleAncestors) {
349
+ if (!targetAncestors.has(staleId)) {
350
+ // 目标不在此 stale 节点的子树内,阻断
351
+ return {
352
+ success: false,
353
+ previousFocus,
354
+ currentFocus: previousFocus, // 焦点不变
355
+ error: "CONCLUSION_STALE",
356
+ staleNodeId: staleId,
357
+ hint: "请先 context_get 获取上下文,再用精确替换模式更新结论",
358
+ };
359
+ }
360
+ }
361
+ }
362
+ }
363
+ // 4. 更新 currentFocus
364
+ graph.currentFocus = nodeId;
365
+ // 5. 写入 graph.json
366
+ await this.json.writeGraph(projectRoot, wsDirName, graph);
367
+ // 6. 更新工作区配置的 updatedAt
368
+ const config = await this.json.readWorkspaceConfig(projectRoot, wsDirName);
369
+ const currentTime = now();
370
+ config.updatedAt = currentTime;
371
+ await this.json.writeWorkspaceConfig(projectRoot, wsDirName, config);
372
+ // 7. 同步更新索引中的 updatedAt
373
+ const index = await this.json.readIndex();
374
+ const wsEntry = index.workspaces.find(ws => ws.id === workspaceId);
375
+ if (wsEntry) {
376
+ wsEntry.updatedAt = currentTime;
377
+ await this.json.writeIndex(index);
378
+ }
379
+ // 8. 发送事件通知
380
+ eventService.emitContextUpdate(workspaceId, nodeId);
381
+ // 9. 返回结果
382
+ return {
383
+ success: true,
384
+ previousFocus,
385
+ currentFocus: nodeId,
386
+ };
387
+ }
388
+ /**
389
+ * 构建上下文链
390
+ */
391
+ async buildContextChain(projectRoot, wsDirName, nodeId, graph, options, isArchived = false, workspaceId) {
392
+ const chain = [];
393
+ let currentId = nodeId;
394
+ while (currentId) {
395
+ const nodeMeta = graph.nodes[currentId];
396
+ if (!nodeMeta)
397
+ break;
398
+ const item = await this.buildSingleContextItem(projectRoot, wsDirName, currentId, graph, options, isArchived, workspaceId);
399
+ chain.unshift(item); // 从根开始
400
+ // 检查隔离标记
401
+ if (nodeMeta.isolate)
402
+ break;
403
+ currentId = nodeMeta.parentId;
404
+ }
405
+ return chain;
406
+ }
407
+ /**
408
+ * 构建单个上下文项
409
+ */
410
+ async buildSingleContextItem(projectRoot, wsDirName, nodeId, graph, options, isArchived = false, workspaceId) {
411
+ const nodeMeta = graph.nodes[nodeId];
412
+ const nodeDirName = nodeMeta.dirName || nodeId; // 向后兼容
413
+ const info = await this.md.readNodeInfoFull(projectRoot, wsDirName, nodeDirName, isArchived);
414
+ const item = {
415
+ nodeId,
416
+ title: info.title,
417
+ requirement: info.requirement,
418
+ docs: info.docs,
419
+ note: info.notes,
420
+ // 内容数据以 Info.md 为权威来源
421
+ conclusion: info.conclusion || undefined,
422
+ // 验收标准从 graph.json 获取
423
+ acceptanceCriteria: nodeMeta.acceptanceCriteria,
424
+ };
425
+ // 包含日志
426
+ if (options.includeLog) {
427
+ const logContent = await this.md.readLogRaw(projectRoot, wsDirName, nodeDirName, isArchived);
428
+ let logs = this.md.parseLogTable(logContent);
429
+ logs = this.tailLogs(logs, options.maxLogEntries);
430
+ if (options.reverseLog) {
431
+ logs = logs.reverse();
432
+ }
433
+ item.logEntries = logs;
434
+ }
435
+ // 包含问题
436
+ if (options.includeProblem) {
437
+ const problem = await this.md.readProblem(projectRoot, wsDirName, nodeDirName, isArchived);
438
+ if (problem.currentProblem && problem.currentProblem !== "(暂无)") {
439
+ item.problem = problem.currentProblem;
440
+ }
441
+ }
442
+ // 增强 docs 中的 memo:// 引用
443
+ if (workspaceId) {
444
+ item.docs = await this.enrichDocsWithMemoMeta(item.docs, workspaceId);
445
+ }
446
+ return item;
447
+ }
448
+ /**
449
+ * 增强文档引用中的 memo:// 引用,填充 memoMeta 字段
450
+ * 如果 memo 已被删除,标记 status 为 expired
451
+ */
452
+ async enrichDocsWithMemoMeta(docs, workspaceId) {
453
+ if (!this.memoService) {
454
+ return docs;
455
+ }
456
+ const enrichedDocs = [];
457
+ for (const doc of docs) {
458
+ if (doc.path.startsWith("memo://")) {
459
+ const memoId = doc.path.substring(7); // 去掉 "memo://" 前缀
460
+ try {
461
+ const memoResult = await this.memoService.get({
462
+ workspaceId,
463
+ memoId,
464
+ });
465
+ // 填充 memoMeta
466
+ enrichedDocs.push({
467
+ ...doc,
468
+ memoMeta: {
469
+ id: memoResult.memo.id,
470
+ title: memoResult.memo.title,
471
+ summary: memoResult.memo.summary,
472
+ tags: memoResult.memo.tags,
473
+ },
474
+ });
475
+ }
476
+ catch (error) {
477
+ // Memo 不存在(已删除),标记为 expired
478
+ devLog.warn("Memo 引用已过期", { memoId, error });
479
+ enrichedDocs.push({
480
+ ...doc,
481
+ status: "expired",
482
+ });
483
+ }
484
+ }
485
+ else {
486
+ // 非 memo 引用,保持原样
487
+ enrichedDocs.push(doc);
488
+ }
489
+ }
490
+ return enrichedDocs;
491
+ }
492
+ /**
493
+ * 日志截断(Tail-First)
494
+ */
495
+ tailLogs(logs, max) {
496
+ if (max <= 0)
497
+ return [];
498
+ if (logs.length <= max)
499
+ return logs;
500
+ return logs.slice(-max);
501
+ }
502
+ }
503
+ //# sourceMappingURL=ContextService.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ContextService.js","sourceRoot":"","sources":["../../src/services/ContextService.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,76 @@
1
+ import type { PlatformType } from "../types/settings.js";
2
+ /**
3
+ * 组件检测结果
4
+ */
5
+ export interface ComponentDetection {
6
+ installed: boolean;
7
+ path?: string;
8
+ }
9
+ /**
10
+ * 平台检测结果
11
+ */
12
+ export interface DetectionResult {
13
+ platform: PlatformType;
14
+ detected: boolean;
15
+ components: {
16
+ hooks: ComponentDetection;
17
+ mcp: ComponentDetection;
18
+ agents?: ComponentDetection;
19
+ skills?: ComponentDetection;
20
+ };
21
+ }
22
+ /**
23
+ * 所有平台检测结果
24
+ */
25
+ export interface AllDetectionResults {
26
+ claudeCode?: DetectionResult;
27
+ cursor?: DetectionResult;
28
+ codex?: DetectionResult;
29
+ }
30
+ /**
31
+ * 检测服务
32
+ * 检测各平台的 ZeroWorkspace 组件安装状态
33
+ */
34
+ export declare class DetectionService {
35
+ private claudeSettingsPath;
36
+ private claudeConfigPath;
37
+ private claudeAgentsPath;
38
+ private claudeSkillsPath;
39
+ private cursorHooksPath;
40
+ private cursorMcpPath;
41
+ private zeroScriptsPath;
42
+ private zeroSkillsSource;
43
+ constructor();
44
+ /**
45
+ * 检测 Claude Code 组件安装状态
46
+ */
47
+ detectClaudeCode(): Promise<DetectionResult>;
48
+ /**
49
+ * 检测 Cursor 组件安装状态
50
+ */
51
+ detectCursor(): Promise<DetectionResult>;
52
+ /**
53
+ * 检测 Codex 组件安装状态(预留)
54
+ */
55
+ detectCodex(): Promise<DetectionResult>;
56
+ /**
57
+ * 检测所有平台
58
+ */
59
+ detectAll(): Promise<AllDetectionResults>;
60
+ /**
61
+ * 检查 Hook 脚本文件是否存在
62
+ */
63
+ checkHookScriptExists(platform: PlatformType): Promise<boolean>;
64
+ /**
65
+ * 检查 ZeroWorkspace dispatch agents 是否已安装
66
+ * 检测 ~/.claude/agents/ 下是否存在 zero-executor.md 和 zero-reviewer.md
67
+ */
68
+ checkAgentsInstalled(): Promise<boolean>;
69
+ /**
70
+ * 检查 ZeroWorkspace skills 是否已安装
71
+ * 检测 ~/.claude/skills/ 下是否存在任何 ZeroWorkspace 提供的 skill 文件
72
+ * 由于 skills 目录可能为空(模板尚未创建),返回 false 表示未安装
73
+ */
74
+ checkSkillsInstalled(): Promise<boolean>;
75
+ }
76
+ //# sourceMappingURL=DetectionService.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"DetectionService.d.ts","sourceRoot":"","sources":["../../src/services/DetectionService.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEzD;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,OAAO,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,YAAY,CAAC;IACvB,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,EAAE;QACV,KAAK,EAAE,kBAAkB,CAAC;QAC1B,GAAG,EAAE,kBAAkB,CAAC;QACxB,MAAM,CAAC,EAAE,kBAAkB,CAAC;QAC5B,MAAM,CAAC,EAAE,kBAAkB,CAAC;KAC7B,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,UAAU,CAAC,EAAE,eAAe,CAAC;IAC7B,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,KAAK,CAAC,EAAE,eAAe,CAAC;CACzB;AAED;;;GAGG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,kBAAkB,CAAS;IACnC,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,gBAAgB,CAAS;;IAgBjC;;OAEG;IACG,gBAAgB,IAAI,OAAO,CAAC,eAAe,CAAC;IAyFlD;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC,eAAe,CAAC;IA0D9C;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,eAAe,CAAC;IAY7C;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,mBAAmB,CAAC;IAsB/C;;OAEG;IACG,qBAAqB,CAAC,QAAQ,EAAE,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC;IAYrE;;;OAGG;IACG,oBAAoB,IAAI,OAAO,CAAC,OAAO,CAAC;IAe9C;;;;OAIG;IACG,oBAAoB,IAAI,OAAO,CAAC,OAAO,CAAC;CAe/C"}