@winspan/claude-forge 8.51.1 → 8.54.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (409) hide show
  1. package/DEVELOPMENT.md +290 -221
  2. package/README.md +50 -8
  3. package/dist/cli/commands/skills.d.ts.map +1 -1
  4. package/dist/cli/commands/skills.js +121 -2
  5. package/dist/cli/commands/skills.js.map +1 -1
  6. package/dist/cli/init/hook-manager.d.ts +1 -1
  7. package/dist/cli/init/hook-manager.d.ts.map +1 -1
  8. package/dist/cli/init/hook-manager.js +1 -0
  9. package/dist/cli/init/hook-manager.js.map +1 -1
  10. package/dist/core/constants.d.ts +2 -0
  11. package/dist/core/constants.d.ts.map +1 -1
  12. package/dist/core/constants.js +4 -0
  13. package/dist/core/constants.js.map +1 -1
  14. package/dist/core/storage/events.d.ts.map +1 -1
  15. package/dist/core/storage/events.js +0 -1
  16. package/dist/core/storage/events.js.map +1 -1
  17. package/dist/core/storage/maintenance.d.ts +25 -3
  18. package/dist/core/storage/maintenance.d.ts.map +1 -1
  19. package/dist/core/storage/maintenance.js +33 -4
  20. package/dist/core/storage/maintenance.js.map +1 -1
  21. package/dist/core/storage/routing.d.ts +4 -0
  22. package/dist/core/storage/routing.d.ts.map +1 -1
  23. package/dist/core/storage/routing.js +10 -4
  24. package/dist/core/storage/routing.js.map +1 -1
  25. package/dist/core/storage/sessions.d.ts +17 -0
  26. package/dist/core/storage/sessions.d.ts.map +1 -1
  27. package/dist/core/storage/sessions.js +64 -0
  28. package/dist/core/storage/sessions.js.map +1 -1
  29. package/dist/core/storage/skills.d.ts +4 -0
  30. package/dist/core/storage/skills.d.ts.map +1 -1
  31. package/dist/core/storage/skills.js +10 -2
  32. package/dist/core/storage/skills.js.map +1 -1
  33. package/dist/core/storage/sqlite.d.ts +5 -0
  34. package/dist/core/storage/sqlite.d.ts.map +1 -1
  35. package/dist/core/storage/sqlite.js +6 -0
  36. package/dist/core/storage/sqlite.js.map +1 -1
  37. package/dist/core/storage/tasks.d.ts.map +1 -1
  38. package/dist/core/storage/tasks.js +2 -0
  39. package/dist/core/storage/tasks.js.map +1 -1
  40. package/dist/core/types.d.ts +7 -0
  41. package/dist/core/types.d.ts.map +1 -1
  42. package/dist/daemon/index.d.ts.map +1 -1
  43. package/dist/daemon/index.js +30 -5
  44. package/dist/daemon/index.js.map +1 -1
  45. package/dist/daemon/skill-sync.d.ts +21 -0
  46. package/dist/daemon/skill-sync.d.ts.map +1 -0
  47. package/dist/daemon/skill-sync.js +75 -0
  48. package/dist/daemon/skill-sync.js.map +1 -0
  49. package/dist/hooks/notification.sh +1 -1
  50. package/dist/hooks/post-tool-use.sh +1 -1
  51. package/dist/hooks/pre-tool-use.sh +1 -1
  52. package/dist/hooks/stop.sh +1 -1
  53. package/dist/hooks/user-prompt-submit.sh +1 -1
  54. package/dist/skills/official/code-simplifier.md +37 -1
  55. package/dist/skills/official/find-skills.md +120 -1
  56. package/dist/skills/official/official-api-design.md +14 -1
  57. package/dist/skills/official/official-architecture-decision.md +22 -1
  58. package/dist/skills/official/official-db-schema-design.md +19 -1
  59. package/dist/skills/official/official-debug.md +9 -1
  60. package/dist/skills/official/official-pr-review.md +1 -1
  61. package/dist/skills/official/official-security-hardening.md +7 -1
  62. package/dist/skills/official/planning-with-files.md +206 -2
  63. package/dist/skills/official/ui-ux-pro-max.md +88 -1
  64. package/dist/skills/official/webapp-testing.md +85 -1
  65. package/dist/skills/registry.d.ts +1 -1
  66. package/dist/skills/registry.d.ts.map +1 -1
  67. package/dist/skills/registry.js +15 -4
  68. package/dist/skills/registry.js.map +1 -1
  69. package/dist/skills/semantic-matcher.d.ts +4 -3
  70. package/dist/skills/semantic-matcher.d.ts.map +1 -1
  71. package/dist/skills/semantic-matcher.js +20 -22
  72. package/dist/skills/semantic-matcher.js.map +1 -1
  73. package/dist/skills/upgrade-engine.d.ts +93 -0
  74. package/dist/skills/upgrade-engine.d.ts.map +1 -0
  75. package/dist/skills/upgrade-engine.js +447 -0
  76. package/dist/skills/upgrade-engine.js.map +1 -0
  77. package/dist/skills/upgrade-prompt.d.ts +20 -0
  78. package/dist/skills/upgrade-prompt.d.ts.map +1 -0
  79. package/dist/skills/upgrade-prompt.js +75 -0
  80. package/dist/skills/upgrade-prompt.js.map +1 -0
  81. package/dist/web/analytics/weekly-report.d.ts.map +1 -1
  82. package/dist/web/analytics/weekly-report.js +21 -29
  83. package/dist/web/analytics/weekly-report.js.map +1 -1
  84. package/dist/web/routes/patch.d.ts.map +1 -1
  85. package/dist/web/routes/patch.js +32 -2
  86. package/dist/web/routes/patch.js.map +1 -1
  87. package/dist/web/routes/sessions.d.ts.map +1 -1
  88. package/dist/web/routes/sessions.js +9 -7
  89. package/dist/web/routes/sessions.js.map +1 -1
  90. package/dist/web/routes/trace.d.ts.map +1 -1
  91. package/dist/web/routes/trace.js +2 -3
  92. package/dist/web/routes/trace.js.map +1 -1
  93. package/dist/web/server.d.ts.map +1 -1
  94. package/dist/web/server.js +3 -2
  95. package/dist/web/server.js.map +1 -1
  96. package/package.json +12 -2
  97. package/scripts/postinstall.cjs +21 -0
  98. package/.claude/CLAUDE.md +0 -17
  99. package/.eslintrc.js +0 -23
  100. package/.prettierrc +0 -8
  101. package/ARCHITECTURE_ISSUES.md +0 -249
  102. package/CLAUDE.md +0 -265
  103. package/CLAUDE.md.backup +0 -488
  104. package/docs/concurrent-agents.md +0 -129
  105. package/docs/design/architecture-review-20260516.md +0 -232
  106. package/docs/design/fix-skills-data-and-set-leak-spec-20260516-1300.md +0 -219
  107. package/docs/design/h1-storage-aggregation-spec-20260518-1121.md +0 -299
  108. package/docs/design/h2-getdatabase-encapsulation-spec-20260518-1450.md +0 -191
  109. package/docs/design/h3-fallback-removal-spec-20260518-1245.md +0 -76
  110. package/docs/design/h4-index-dedup-spec-20260518-1230.md +0 -109
  111. package/docs/design/h6-services-migration-spec-20260518-1355.md +0 -82
  112. package/docs/design/hook-failure-queue-spec-20260516-1530.md +0 -204
  113. package/docs/design/l1-swarm-protocol-extract-spec-20260518-1605.md +0 -106
  114. package/docs/design/m10-forge-paths-spec-20260518-1320.md +0 -121
  115. package/docs/design/m2-m3-tool-input-spec-20260518-1425.md +0 -131
  116. package/docs/design/m7-routing-event-association-spec-20260518-1545.md +0 -103
  117. package/docs/design/project-path-gitroot-spec-20260518-1715.md +0 -134
  118. package/docs/design/refactor-phase1-spec-20260515-1600.md +0 -543
  119. package/docs/design/refactor-phase2-spec-20260515-1700.md +0 -424
  120. package/docs/design/task-active-gc-spec-20260518-1745.md +0 -146
  121. package/docs/design/tasks-list-filter-pagination-spec-20260518-0930.md +0 -208
  122. package/docs/implementation/fix-skills-data-and-set-leak-changelog-20260516-1300.md +0 -104
  123. package/docs/implementation/h1-storage-aggregation-changelog-20260518-1121.md +0 -82
  124. package/docs/implementation/h2-final-changelog-20260518-1530.md +0 -61
  125. package/docs/implementation/h2-phase1-safety-net-changelog-20260518-1450.md +0 -70
  126. package/docs/implementation/h2-phase2-operations-changelog-20260518-1450.md +0 -120
  127. package/docs/implementation/h2-phase3-callsites-changelog-20260518-1450.md +0 -71
  128. package/docs/implementation/h3-fallback-removal-changelog-20260518-1245.md +0 -71
  129. package/docs/implementation/h4-index-dedup-changelog-20260518-1230.md +0 -60
  130. package/docs/implementation/h6-services-migration-changelog-20260518-1355.md +0 -46
  131. package/docs/implementation/h7-m9-defaults-changelog-20260518-1300.md +0 -46
  132. package/docs/implementation/hook-failure-queue-changelog-20260516-1530.md +0 -196
  133. package/docs/implementation/hotfix-daemon-event-reject-20260516-1430.md +0 -56
  134. package/docs/implementation/l1-swarm-protocol-extract-changelog-20260518-1605.md +0 -45
  135. package/docs/implementation/l3-l4-daemon-perf-changelog-20260518-1410.md +0 -63
  136. package/docs/implementation/l6-l8-final-cleanup-changelog-20260518-1640.md +0 -38
  137. package/docs/implementation/m1-m4-m5-l7-cleanup-changelog-20260518-1310.md +0 -58
  138. package/docs/implementation/m10-forge-paths-changelog-20260518-1320.md +0 -60
  139. package/docs/implementation/m2-m3-tool-input-changelog-20260518-1425.md +0 -43
  140. package/docs/implementation/m6-m8-naming-shutdown-changelog-20260518-1340.md +0 -56
  141. package/docs/implementation/m7-routing-association-changelog-20260518-1545.md +0 -69
  142. package/docs/implementation/project-path-gitroot-changelog-20260518-1715.md +0 -63
  143. package/docs/implementation/refactor-phase1-changelog-20260515-1630.md +0 -354
  144. package/docs/implementation/refactor-phase2-changelog-20260515-1705.md +0 -421
  145. package/docs/implementation/task-active-gc-changelog-20260518-1745.md +0 -35
  146. package/docs/implementation/task-title-summary-changelog-20260518-1130.md +0 -39
  147. package/docs/implementation/tasks-detail-back-loses-filters-changelog-20260518-1100.md +0 -22
  148. package/docs/implementation/tasks-list-filter-pagination-changelog-20260518-0930.md +0 -72
  149. package/docs/implementation/tasks-page-white-screen-hotfix-changelog-20260518-1015.md +0 -56
  150. package/docs/reviews/claudemd-template-sync.md +0 -54
  151. package/docs/reviews/task-title-summary.md +0 -92
  152. package/docs/reviews/tasks-detail-back-loses-filters.md +0 -58
  153. package/docs/reviews/tasks-filter-pagination.md +0 -80
  154. package/docs/reviews/tasks-page-white-screen-hotfix.md +0 -126
  155. package/docs/ruflo-learning-strategy.md +0 -322
  156. package/docs/skills-deduplication-analysis.md +0 -83
  157. package/docs/skills-multiformat-support.md +0 -177
  158. package/docs/skills-third-party.md +0 -183
  159. package/docs/testing/tasks-filter-pagination-test-report.md +0 -86
  160. package/forge +0 -321
  161. package/playwright.config.ts +0 -40
  162. package/scripts/demo-v2.ts +0 -91
  163. package/scripts/dev-daemon.sh +0 -232
  164. package/scripts/dev-web.ts +0 -109
  165. package/scripts/e2e-mcp-link.ts +0 -423
  166. package/scripts/e2e-methodology-quality.ts +0 -253
  167. package/scripts/e2e-routing.ts +0 -456
  168. package/scripts/e2e-user-methodology.ts +0 -326
  169. package/scripts/e2e-web-workflows.ts +0 -299
  170. package/scripts/migrate-legacy-to-dynamic.sql +0 -108
  171. package/scripts/regenerate-execution-docs.ts +0 -116
  172. package/scripts/sync-agent-skills.ts +0 -193
  173. package/scripts/test-hook.sh +0 -71
  174. package/scripts/verify-skill-loading.ts +0 -62
  175. package/src/claudemd/claudemd-generator.ts +0 -568
  176. package/src/claudemd/convention-extractor.ts +0 -69
  177. package/src/claudemd/index.ts +0 -35
  178. package/src/claudemd/persona-manager.ts +0 -88
  179. package/src/claudemd/resume-manager.ts +0 -236
  180. package/src/claudemd/tech-detector.ts +0 -220
  181. package/src/claudemd/templates/swarm-protocol.md +0 -222
  182. package/src/cli/commands/claudemd.ts +0 -84
  183. package/src/cli/commands/config.ts +0 -46
  184. package/src/cli/commands/daemon.ts +0 -310
  185. package/src/cli/commands/executions.ts +0 -115
  186. package/src/cli/commands/init.ts +0 -204
  187. package/src/cli/commands/logs.ts +0 -181
  188. package/src/cli/commands/mcp.ts +0 -242
  189. package/src/cli/commands/menu.ts +0 -357
  190. package/src/cli/commands/skills.ts +0 -185
  191. package/src/cli/commands/stats.ts +0 -73
  192. package/src/cli/commands/status.ts +0 -69
  193. package/src/cli/commands/template.ts +0 -77
  194. package/src/cli/commands/trace.ts +0 -148
  195. package/src/cli/index.ts +0 -42
  196. package/src/cli/init/hook-manager.ts +0 -132
  197. package/src/core/ai/provider.ts +0 -308
  198. package/src/core/ai/types.ts +0 -51
  199. package/src/core/config.ts +0 -124
  200. package/src/core/constants.ts +0 -62
  201. package/src/core/event-fields.ts +0 -32
  202. package/src/core/queue/index.ts +0 -192
  203. package/src/core/storage/base.ts +0 -302
  204. package/src/core/storage/events.ts +0 -434
  205. package/src/core/storage/injections.ts +0 -78
  206. package/src/core/storage/maintenance.ts +0 -59
  207. package/src/core/storage/migrations/002_add_skill_tracking.sql +0 -6
  208. package/src/core/storage/migrations/003_add_skill_invocations.sql +0 -23
  209. package/src/core/storage/performance-indexes.sql +0 -23
  210. package/src/core/storage/routing.ts +0 -322
  211. package/src/core/storage/rows.ts +0 -112
  212. package/src/core/storage/schema.sql +0 -224
  213. package/src/core/storage/sessions.ts +0 -168
  214. package/src/core/storage/skills.ts +0 -233
  215. package/src/core/storage/sqlite.ts +0 -293
  216. package/src/core/storage/tasks.ts +0 -318
  217. package/src/core/storage/token-usage.ts +0 -93
  218. package/src/core/types.ts +0 -181
  219. package/src/core/utils/error-handler.ts +0 -257
  220. package/src/core/utils/forge-resume-block.ts +0 -74
  221. package/src/core/utils/format.ts +0 -69
  222. package/src/core/utils/git.ts +0 -23
  223. package/src/core/utils/logger.ts +0 -134
  224. package/src/core/utils/lru-cache.ts +0 -54
  225. package/src/core/utils/path.ts +0 -19
  226. package/src/core/utils/session.ts +0 -26
  227. package/src/core/utils/time.ts +0 -37
  228. package/src/core/utils/token-tracker.ts +0 -97
  229. package/src/daemon/event-parser.ts +0 -36
  230. package/src/daemon/handlers/history-exporter.ts +0 -117
  231. package/src/daemon/handlers/post-tool-use.ts +0 -54
  232. package/src/daemon/handlers/stop.ts +0 -208
  233. package/src/daemon/handlers/user-prompt.ts +0 -178
  234. package/src/daemon/hook-sync.ts +0 -91
  235. package/src/daemon/index.ts +0 -302
  236. package/src/daemon/launchd/com.claude-forge.daemon.plist.template +0 -47
  237. package/src/daemon/launchd-installer.ts +0 -260
  238. package/src/daemon/lifecycle.ts +0 -128
  239. package/src/daemon/router.ts +0 -40
  240. package/src/daemon/server.ts +0 -196
  241. package/src/daemon/services/task-segmenter.ts +0 -112
  242. package/src/hooks/hook-lib.sh +0 -118
  243. package/src/hooks/notification.sh +0 -35
  244. package/src/hooks/post-tool-use.sh +0 -61
  245. package/src/hooks/pre-tool-use.sh +0 -63
  246. package/src/hooks/stop.sh +0 -43
  247. package/src/hooks/user-prompt-submit.sh +0 -69
  248. package/src/mcp/server.ts +0 -322
  249. package/src/skills/index.ts +0 -2
  250. package/src/skills/invocation-guard.ts +0 -177
  251. package/src/skills/matcher.ts +0 -148
  252. package/src/skills/official/code-simplifier.md +0 -16
  253. package/src/skills/official/find-skills.md +0 -23
  254. package/src/skills/official/official-api-design.md +0 -17
  255. package/src/skills/official/official-architecture-decision.md +0 -20
  256. package/src/skills/official/official-bmad.md +0 -118
  257. package/src/skills/official/official-db-schema-design.md +0 -16
  258. package/src/skills/official/official-debug.md +0 -17
  259. package/src/skills/official/official-doc-driven.md +0 -31
  260. package/src/skills/official/official-harness-engineering.md +0 -108
  261. package/src/skills/official/official-performance-optimization.md +0 -30
  262. package/src/skills/official/official-pr-review.md +0 -35
  263. package/src/skills/official/official-release-checklist.md +0 -30
  264. package/src/skills/official/official-security-hardening.md +0 -26
  265. package/src/skills/official/official-spec-driven-design.md +0 -31
  266. package/src/skills/official/planning-with-files.md +0 -37
  267. package/src/skills/official/ui-ux-pro-max.md +0 -18
  268. package/src/skills/official/webapp-testing.md +0 -12
  269. package/src/skills/official-skills.ts +0 -89
  270. package/src/skills/registry.ts +0 -355
  271. package/src/skills/semantic-matcher.ts +0 -231
  272. package/src/skills/tools/pipeline-suggest.ts +0 -226
  273. package/src/skills/tools/skill-invoke.ts +0 -168
  274. package/src/skills/tools/skill-list.ts +0 -59
  275. package/src/templates/go.yaml +0 -53
  276. package/src/templates/python.yaml +0 -59
  277. package/src/templates/react.yaml +0 -55
  278. package/src/templates/template-manager.ts +0 -170
  279. package/src/web/analytics/anti-pattern-detector.ts +0 -367
  280. package/src/web/analytics/drift-detector.ts +0 -219
  281. package/src/web/analytics/weekly-report.ts +0 -431
  282. package/src/web/auth-middleware.ts +0 -54
  283. package/src/web/routes/_helpers.ts +0 -34
  284. package/src/web/routes/ai.ts +0 -204
  285. package/src/web/routes/auth.ts +0 -22
  286. package/src/web/routes/drift.ts +0 -25
  287. package/src/web/routes/error-handler.ts +0 -120
  288. package/src/web/routes/events.ts +0 -47
  289. package/src/web/routes/insights.ts +0 -43
  290. package/src/web/routes/patch.ts +0 -117
  291. package/src/web/routes/reports.ts +0 -34
  292. package/src/web/routes/rules.ts +0 -76
  293. package/src/web/routes/sessions.ts +0 -250
  294. package/src/web/routes/skill-stats.ts +0 -92
  295. package/src/web/routes/skills.ts +0 -350
  296. package/src/web/routes/static.ts +0 -67
  297. package/src/web/routes/stats.ts +0 -50
  298. package/src/web/routes/status.ts +0 -30
  299. package/src/web/routes/tasks.ts +0 -193
  300. package/src/web/routes/token-usage.ts +0 -20
  301. package/src/web/routes/trace.ts +0 -126
  302. package/src/web/routes/types.ts +0 -57
  303. package/src/web/server.ts +0 -134
  304. package/src/web/ssrf-guard.ts +0 -112
  305. package/src/web/static/index.html +0 -3251
  306. package/src/web/static/vendor/chart.umd.min.js +0 -20
  307. package/tests/e2e/dashboard.spec.ts +0 -205
  308. package/tests/e2e/routing-skill-e2e.test.ts +0 -39
  309. package/tests/helpers/mock-ai.ts +0 -92
  310. package/tests/helpers/mock-storage.ts +0 -159
  311. package/tests/integration/claudemd-generator.test.ts +0 -90
  312. package/tests/integration/queue-replay.integration.test.ts +0 -193
  313. package/tests/integration/tasks-filter.integration.test.ts +0 -154
  314. package/tests/integration/web-analytics.integration.test.ts +0 -133
  315. package/tests/integration/web-stats.integration.test.ts +0 -135
  316. package/tests/integration/web-trace.integration.test.ts +0 -175
  317. package/tests/performance/database.benchmark.ts +0 -161
  318. package/tests/semantic-matcher.test.ts +0 -99
  319. package/tests/skill-matcher.test.ts +0 -110
  320. package/tests/unit/ai-provider-retry.test.ts +0 -194
  321. package/tests/unit/ai-provider-vision.test.ts +0 -224
  322. package/tests/unit/claudemd-generator.test.ts +0 -68
  323. package/tests/unit/cli-mcp.test.ts +0 -141
  324. package/tests/unit/core/forge-paths.test.ts +0 -99
  325. package/tests/unit/daemon/hook-sync.test.ts +0 -71
  326. package/tests/unit/daemon/post-tool-use.test.ts +0 -121
  327. package/tests/unit/daemon/stop-handler-behavior-summary.test.ts +0 -202
  328. package/tests/unit/daemon/task-segmenter-recover.test.ts +0 -84
  329. package/tests/unit/event-fields.test.ts +0 -88
  330. package/tests/unit/event-parser.test.ts +0 -55
  331. package/tests/unit/handlers.test.ts +0 -171
  332. package/tests/unit/hooks/resolve-project-path.test.ts +0 -122
  333. package/tests/unit/invocation-guard.test.ts +0 -125
  334. package/tests/unit/queue.test.ts +0 -272
  335. package/tests/unit/router.test.ts +0 -138
  336. package/tests/unit/security.test.ts +0 -128
  337. package/tests/unit/skill-invocations-workflow.test.ts +0 -495
  338. package/tests/unit/skill-registry.test.ts +0 -94
  339. package/tests/unit/skills/invocation-guard-ttl.test.ts +0 -211
  340. package/tests/unit/skills/official-skills-loader.test.ts +0 -126
  341. package/tests/unit/skills/registry-multiformat.test.ts +0 -92
  342. package/tests/unit/socket-server.test.ts +0 -183
  343. package/tests/unit/storage/event-operations-aggregates.test.ts +0 -342
  344. package/tests/unit/storage/migration-idempotent.test.ts +0 -304
  345. package/tests/unit/storage/routing-aggregates.test.ts +0 -276
  346. package/tests/unit/storage/routing.test.ts +0 -117
  347. package/tests/unit/storage/schema-missing.test.ts +0 -81
  348. package/tests/unit/storage/session-operations-aggregates.test.ts +0 -120
  349. package/tests/unit/storage/sessions-aggregate.test.ts +0 -435
  350. package/tests/unit/storage/skill-operations-counts.test.ts +0 -106
  351. package/tests/unit/storage/skills-aggregates.test.ts +0 -104
  352. package/tests/unit/storage/sqlite-refactor-harness.test.ts +0 -314
  353. package/tests/unit/storage/task-operations-counts.test.ts +0 -46
  354. package/tests/unit/storage/tasks-getById.test.ts +0 -343
  355. package/tests/unit/storage/tasks-stale-gc.test.ts +0 -86
  356. package/tests/unit/storage.test.ts +0 -172
  357. package/tests/unit/token-usage.test.ts +0 -144
  358. package/tests/unit/type-guards.test.ts +0 -201
  359. package/tests/unit/utils/format.test.ts +0 -189
  360. package/tests/unit/utils/session.test.ts +0 -89
  361. package/tests/unit/utils/time.test.ts +0 -112
  362. package/tests/unit/web/navigation-back-contract.test.ts +0 -134
  363. package/tests/unit/web/routes-auth.test.ts +0 -93
  364. package/tests/unit/web/routes-events.test.ts +0 -101
  365. package/tests/unit/web/routes-rules.test.ts +0 -182
  366. package/tests/unit/web/routes-sessions.test.ts +0 -181
  367. package/tests/unit/web/routes-skill-stats.test.ts +0 -179
  368. package/tests/unit/web/routes-stats.test.ts +0 -92
  369. package/tests/unit/web/routes-tasks.test.ts +0 -385
  370. package/tests/unit/web/task-title-contract.test.ts +0 -210
  371. package/tests/unit/web/tasks-component-contract.test.ts +0 -179
  372. package/tsconfig.json +0 -22
  373. package/vitest.config.ts +0 -21
  374. package/vitest.integration.config.ts +0 -16
  375. package/web/CLAUDE.md +0 -20
  376. package/web/index.html +0 -13
  377. package/web/package-lock.json +0 -4854
  378. package/web/package.json +0 -35
  379. package/web/postcss.config.js +0 -6
  380. package/web/src/App.tsx +0 -110
  381. package/web/src/components/CodeBlock.tsx +0 -31
  382. package/web/src/components/Confirm.tsx +0 -96
  383. package/web/src/components/Drawer.tsx +0 -60
  384. package/web/src/components/Layout.tsx +0 -145
  385. package/web/src/components/MarkdownRenderer.tsx +0 -77
  386. package/web/src/components/SearchInput.tsx +0 -31
  387. package/web/src/components/SessionDetailContent.tsx +0 -157
  388. package/web/src/components/Toast.tsx +0 -92
  389. package/web/src/index.css +0 -19
  390. package/web/src/main.tsx +0 -31
  391. package/web/src/pages/AIConfig.tsx +0 -233
  392. package/web/src/pages/Dashboard.tsx +0 -572
  393. package/web/src/pages/Events.tsx +0 -271
  394. package/web/src/pages/Reports.tsx +0 -428
  395. package/web/src/pages/SessionDetail.tsx +0 -162
  396. package/web/src/pages/Sessions.tsx +0 -205
  397. package/web/src/pages/Skills.tsx +0 -180
  398. package/web/src/pages/TaskDetail.tsx +0 -515
  399. package/web/src/pages/Tasks.tsx +0 -415
  400. package/web/src/utils/auth.ts +0 -59
  401. package/web/src/utils/export.ts +0 -54
  402. package/web/src/utils/navigation.ts +0 -25
  403. package/web/src/utils/task-title.ts +0 -49
  404. package/web/src/utils/time.ts +0 -13
  405. package/web/tailwind.config.js +0 -11
  406. package/web/tsconfig.json +0 -21
  407. package/web/tsconfig.node.json +0 -10
  408. package/web/vite.config.ts +0 -76
  409. package/winspan-claude-forge-8.43.0.tgz +0 -0
@@ -1,91 +0,0 @@
1
- import { existsSync, readFileSync, copyFileSync, chmodSync } from 'node:fs';
2
- import { createHash } from 'node:crypto';
3
- import { join, dirname } from 'node:path';
4
- import { fileURLToPath } from 'node:url';
5
- import { FORGE_PATHS } from '../core/constants.js';
6
- import { logger } from '../core/utils/logger.js';
7
-
8
- // All hook files to sync (5 hooks + shared lib)
9
- const HOOK_FILES = [
10
- 'pre-tool-use.sh',
11
- 'post-tool-use.sh',
12
- 'user-prompt-submit.sh',
13
- 'notification.sh',
14
- 'stop.sh',
15
- 'hook-lib.sh',
16
- ];
17
-
18
- function sha256(content: Buffer): string {
19
- return createHash('sha256').update(content).digest('hex');
20
- }
21
-
22
- function getSourceHooksDir(): string {
23
- // Compiled: dist/daemon/hook-sync.js → dist/hooks
24
- // Dev (vitest): src/daemon/hook-sync.ts → src/hooks
25
- return join(dirname(fileURLToPath(import.meta.url)), '..', 'hooks');
26
- }
27
-
28
- export interface SyncResult {
29
- copied: number;
30
- checked: number;
31
- skipped: number;
32
- }
33
-
34
- /**
35
- * Sync hooks from the package source (dist/hooks) to ~/.claude-forge/hooks/.
36
- * Uses SHA-256 comparison to skip identical files.
37
- *
38
- * Accepts optional overrides for source/target dirs — used in unit tests.
39
- * Any failure logs a warning and continues; never throws.
40
- */
41
- export function syncHooks(opts?: { sourceDir?: string; targetDir?: string }): SyncResult {
42
- const result: SyncResult = { copied: 0, checked: 0, skipped: 0 };
43
- const sourceDir = opts?.sourceDir ?? getSourceHooksDir();
44
- const targetDir = opts?.targetDir ?? FORGE_PATHS.hooks();
45
-
46
- if (!existsSync(sourceDir)) {
47
- logger.warn(`[HookSync] source hooks dir not found at ${sourceDir}, skipping`);
48
- return result;
49
- }
50
-
51
- if (!existsSync(targetDir)) {
52
- // User has not run `claude-forge init` yet — skip silently
53
- logger.debug(`[HookSync] target dir not found: ${targetDir} (user may not have run \`claude-forge init\`)`);
54
- return result;
55
- }
56
-
57
- for (const file of HOOK_FILES) {
58
- const src = join(sourceDir, file);
59
- const dest = join(targetDir, file);
60
-
61
- if (!existsSync(src)) {
62
- result.skipped++;
63
- continue;
64
- }
65
-
66
- result.checked++;
67
-
68
- try {
69
- const srcContent = readFileSync(src);
70
- if (existsSync(dest)) {
71
- const destContent = readFileSync(dest);
72
- if (sha256(srcContent) === sha256(destContent)) {
73
- continue; // identical — no copy needed
74
- }
75
- }
76
-
77
- copyFileSync(src, dest);
78
- chmodSync(dest, 0o755);
79
- result.copied++;
80
- logger.info(`[HookSync] updated ${file}`);
81
- } catch (err) {
82
- logger.warn(`[HookSync] failed to sync ${file}: ${err instanceof Error ? err.message : String(err)}`);
83
- }
84
- }
85
-
86
- if (result.copied > 0) {
87
- logger.info(`[HookSync] synced ${result.copied}/${result.checked} hook files`);
88
- }
89
-
90
- return result;
91
- }
@@ -1,302 +0,0 @@
1
- /**
2
- * Daemon entry point — starts the Forge daemon process
3
- *
4
- * Responsibilities:
5
- * 1. Load config and initialize logging
6
- * 2. Manage lifecycle (PID, socket, auth token)
7
- * 3. Initialize storage, AI provider, and core services
8
- * 4. Create event handlers and start socket server
9
- * 5. Handle graceful shutdown
10
- */
11
-
12
- import { SocketServer } from './server.js';
13
- import {
14
- writePidFile,
15
- removePidFile,
16
- cleanSocket,
17
- getSocketPath,
18
- writeAuthToken,
19
- syncMcpToken,
20
- removeAuthToken,
21
- } from './lifecycle.js';
22
- import { routeEvent, type Handlers } from './router.js';
23
- import { logger } from '../core/utils/logger.js';
24
- import { ConfigManager } from '../core/config.js';
25
- import { SQLiteStorage } from '../core/storage/sqlite.js';
26
- import { expandPath } from '../core/utils/path.js';
27
- import { ClaudeProvider } from '../core/ai/provider.js';
28
- import { TaskSegmenter } from './services/task-segmenter.js';
29
- import { SkillRegistry } from '../skills/registry.js';
30
- import { InvocationGuard } from '../skills/invocation-guard.js';
31
- import { HistoryExporter } from './handlers/history-exporter.js';
32
- import { ResumeManager } from '../claudemd/resume-manager.js';
33
- import { ConventionExtractor } from '../claudemd/convention-extractor.js';
34
- import { UserPromptHandler } from './handlers/user-prompt.js';
35
- import { PostToolUseHandler } from './handlers/post-tool-use.js';
36
- import { StopHandler } from './handlers/stop.js';
37
- import { syncHooks } from './hook-sync.js';
38
- import { replayQueue } from '../core/queue/index.js';
39
- import { DEFAULTS } from '../core/constants.js';
40
- import type { ForgeEvent } from '../core/types.js';
41
- import { getUserPrompt } from '../core/event-fields.js';
42
- import type { HookResponse } from './server.js';
43
-
44
- export interface DaemonOptions {
45
- /** Whether to enable the web server (default: use config value) */
46
- web?: boolean;
47
- }
48
-
49
- export async function startDaemon(foreground: boolean = false, options: DaemonOptions = {}): Promise<void> {
50
- // ── 0. Global Exception Handlers ───────────────────────────────────────────
51
- process.on('uncaughtException', (err) => {
52
- logger.error(`[Daemon] Uncaught exception: ${err.message}`);
53
- logger.error(err.stack || '');
54
- // Don't exit — let daemon continue running
55
- });
56
-
57
- process.on('unhandledRejection', (reason, promise) => {
58
- logger.error(`[Daemon] Unhandled rejection at ${promise}: ${reason}`);
59
- });
60
-
61
- // ── 1. Config & Logging ────────────────────────────────────────────────────
62
- // Log level is auto-parsed from LOG_LEVEL env var at logger module load time.
63
- const config = new ConfigManager().get();
64
- logger.info('Claude Forge daemon starting...');
65
-
66
- // ── 2. Lifecycle (PID, socket, auth token) ─────────────────────────────────
67
- cleanSocket();
68
- writePidFile();
69
- const authToken = writeAuthToken();
70
- logger.info('[Security] Auth token generated');
71
- syncMcpToken(authToken, config.web?.port ?? DEFAULTS.WEB_PORT);
72
-
73
- // ── 3. Storage ─────────────────────────────────────────────────────────────
74
- const dbPath = expandPath(config.storage.path);
75
- const storage = new SQLiteStorage(dbPath);
76
- logger.info(`Storage initialized: ${dbPath}`);
77
-
78
- // ── 3.5. Auto-sync hooks ────────────────────────────────────────────────
79
- // npm upgrade 不会自动更新 ~/.claude-forge/hooks/,每次 daemon 启动
80
- // 用 SHA-256 比对源 dist/hooks 与本地副本,不一致则覆盖。
81
- try {
82
- syncHooks();
83
- } catch (err) {
84
- logger.warn(`[HookSync] unexpected error: ${err}`);
85
- }
86
-
87
- // ── 4. AI Provider ─────────────────────────────────────────────────────────
88
- const apiKey = config.ai.api_key || process.env.ANTHROPIC_API_KEY || '';
89
- if (!apiKey) {
90
- logger.warn('No API key configured — AI features disabled');
91
- }
92
-
93
- const ai = apiKey
94
- ? new ClaudeProvider(apiKey, config.ai.model, config.ai.base_url)
95
- : null;
96
-
97
- // ── 5. Initialize services ─────────────────────────────────────────────────
98
- const skillApiKey = config.skill_matching?.api_key || apiKey;
99
- const skillRegistry = new SkillRegistry(skillApiKey);
100
- const invocationGuard = new InvocationGuard();
101
- if (skillApiKey) {
102
- logger.info('[Skills] Registry loaded with semantic matching support');
103
- } else {
104
- logger.info('[Skills] Registry loaded (keyword matching)');
105
- }
106
- logger.info('[Skills] InvocationGuard ready (idempotent + depth/total limits)');
107
-
108
- const exporter = new HistoryExporter(storage);
109
- const resume = new ResumeManager(storage);
110
- const conventionExtractor = new ConventionExtractor();
111
- const taskSegmenter = new TaskSegmenter(storage);
112
-
113
- logger.info('[Services] Initialized: ResumeManager, TaskSegmenter, SkillRegistry');
114
-
115
- // ── 5.5. Schedule daily maintenance ────────────────────────────────────────
116
- // Clean old events every 24 hours
117
- const MAINTENANCE_INTERVAL = 24 * 60 * 60 * 1000; // 24 hours
118
- const maintenanceInterval = setInterval(() => {
119
- logger.info('[Daemon] Running daily maintenance: cleaning old events');
120
- try {
121
- storage.cleanOldEvents(30);
122
- } catch (err) {
123
- logger.error(`[Daemon] Maintenance failed: ${err}`);
124
- }
125
- }, MAINTENANCE_INTERVAL);
126
- logger.info('[Daemon] Scheduled daily maintenance (clean events older than 30 days)');
127
-
128
- // ── 5.6. Stale task GC (every 5 minutes) ──────────────────────────────────
129
- const STALE_TASK_GC_INTERVAL = 5 * 60 * 1000; // 5 分钟
130
- const STALE_TASK_IDLE_MINUTES = 10; // idle 超 10 分钟视为滞留
131
-
132
- const staleTaskGcInterval = setInterval(() => {
133
- try {
134
- const closed = storage.completeStaleActiveTasks(STALE_TASK_IDLE_MINUTES);
135
- if (closed > 0) {
136
- logger.info(`[Maintenance] Auto-completed ${closed} stale active task(s)`);
137
- }
138
- } catch (err) {
139
- logger.error(`[Maintenance] Stale task GC failed: ${err}`);
140
- }
141
- }, STALE_TASK_GC_INTERVAL);
142
-
143
- // ── 6. Create handlers ─────────────────────────────────────────────────────
144
- const userPromptHandler = new UserPromptHandler(
145
- resume,
146
- conventionExtractor,
147
- storage,
148
- skillRegistry,
149
- );
150
-
151
- const handlers: Handlers = {
152
- UserPromptSubmit: userPromptHandler,
153
- PostToolUse: new PostToolUseHandler(storage),
154
- Stop: new StopHandler(
155
- exporter,
156
- resume,
157
- taskSegmenter,
158
- storage,
159
- invocationGuard,
160
- userPromptHandler,
161
- ),
162
- };
163
-
164
- // ── 7. Event handler ───────────────────────────────────────────────────────
165
- const handleEvent = async (event: ForgeEvent): Promise<HookResponse | void> => {
166
- try {
167
- try {
168
- storage.writeEvent(event);
169
- } catch (writeErr) {
170
- const writeMsg = writeErr instanceof Error ? writeErr.message : String(writeErr);
171
- if (writeMsg.includes('UNIQUE constraint failed')) {
172
- // Duplicate event_id — already in DB (e.g. replayed from queue then re-sent).
173
- // Log at debug level and continue processing the event normally.
174
- logger.debug(`[Event] Duplicate event_id ignored: ${event.event_id}`);
175
- } else {
176
- throw writeErr;
177
- }
178
- }
179
- logger.debug(`[Event] ${event.hook_type} | tool=${event.tool_name ?? 'N/A'}`);
180
-
181
- // Task segmentation: UserPromptSubmit starts/continues tasks
182
- const prompt = getUserPrompt(event);
183
- if (event.hook_type === 'UserPromptSubmit' && prompt) {
184
- taskSegmenter.processPrompt(event.session_id, prompt, event.timestamp, event.event_id);
185
- } else if (event.event_id) {
186
- taskSegmenter.linkEvent(event.session_id, event.event_id);
187
- }
188
-
189
- // PreToolUse: always allow (governance removed)
190
- if (event.hook_type === 'PreToolUse') {
191
- return { allow: true };
192
- }
193
-
194
- const result = await routeEvent(event, handlers);
195
-
196
- if (result) {
197
- const handlerName = event.hook_type + 'Handler';
198
- if (result.systemMessage) {
199
- storage.writeInjection({
200
- event_id: event.event_id,
201
- session_id: event.session_id,
202
- timestamp: event.timestamp,
203
- source_handler: handlerName,
204
- injection_type: 'systemMessage',
205
- content: result.systemMessage,
206
- });
207
- const preview = result.systemMessage.slice(0, 200).replace(/\n/g, ' ');
208
- console.error(`\x1b[36m[${handlerName}] systemMessage (${result.systemMessage.length} chars): ${preview}\x1b[0m`);
209
- }
210
- if (result.additionalContext) {
211
- storage.writeInjection({
212
- event_id: event.event_id,
213
- session_id: event.session_id,
214
- timestamp: event.timestamp,
215
- source_handler: handlerName,
216
- injection_type: 'additionalContext',
217
- content: result.additionalContext,
218
- });
219
- const preview = result.additionalContext.slice(0, 200).replace(/\n/g, ' ');
220
- console.error(`\x1b[36m[${handlerName}] additionalContext: ${preview}\x1b[0m`);
221
- }
222
- }
223
-
224
- return result;
225
- } catch (err) {
226
- logger.error(`Event handling failed: ${err}`);
227
- throw err;
228
- }
229
- };
230
-
231
- // ── 8. Start socket server ─────────────────────────────────────────────────
232
- const socketPath = getSocketPath();
233
- const server = new SocketServer(socketPath, handleEvent, authToken);
234
-
235
- // ── 8.1. Replay queued events (hook failures during daemon downtime) ────────
236
- // Run after the socket is created so the daemon is ready to receive events.
237
- // setImmediate ensures the event loop has had a chance to process the listen
238
- // callback before we touch storage (not strictly required, but defensive).
239
- setImmediate(() => {
240
- replayQueue(storage).then(({ replayed, skipped, dead }) => {
241
- if (replayed > 0 || skipped > 0 || dead > 0) {
242
- logger.info(`[Queue] Replay: ${replayed} replayed, ${skipped} skipped (dup), ${dead} dead-lettered`);
243
- }
244
- }).catch((err) => {
245
- logger.error(`[Queue] replayQueue failed: ${err}`);
246
- });
247
- });
248
-
249
- // ── 8.5. Start web server (optional) ───────────────────────────────────────
250
- // Priority: CLI option > env var > config file
251
- const webEnabled = options.web ?? (process.env.FORGE_DAEMON_NO_WEB === '1' ? false : config.web.enabled);
252
- let webServer: any = null;
253
- if (webEnabled) {
254
- const { WebServer } = await import('../web/server.js');
255
- webServer = new WebServer({
256
- port: config.web.port,
257
- storage,
258
- skillRegistry,
259
- invocationGuard,
260
- });
261
- await webServer.start();
262
- } else {
263
- logger.info('[Web] Server disabled (--no-web or config.web.enabled=false)');
264
- }
265
-
266
- // ── 9. Graceful shutdown ───────────────────────────────────────────────────
267
- let shuttingDown = false;
268
- const shutdown = async () => {
269
- if (shuttingDown) return;
270
- shuttingDown = true;
271
- logger.info('Shutting down...');
272
-
273
- if (ai) logger.info(`[AI Stats] ${ai.formatStats()}`);
274
-
275
- clearInterval(maintenanceInterval);
276
- clearInterval(staleTaskGcInterval);
277
- if (webServer) await webServer.stop();
278
- await server.close();
279
- storage.close();
280
- removePidFile();
281
- cleanSocket();
282
- removeAuthToken();
283
- process.exit(0);
284
- };
285
-
286
- process.on('SIGTERM', shutdown);
287
- process.on('SIGINT', shutdown);
288
-
289
- logger.info(`Daemon started (PID: ${process.pid})`);
290
- if (foreground) {
291
- process.stdout.write(`Claude Forge daemon running (PID: ${process.pid})\n`);
292
- process.stdout.write('Press Ctrl+C to stop\n');
293
- }
294
- }
295
-
296
- // Allow running as standalone script (spawned by `cf daemon start`)
297
- if (process.env.FORGE_DAEMON_FOREGROUND === '1') {
298
- startDaemon(true).catch((err) => {
299
- console.error('Daemon failed to start:', err);
300
- process.exit(1);
301
- });
302
- }
@@ -1,47 +0,0 @@
1
- <?xml version="1.0" encoding="UTF-8"?>
2
- <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
3
- <plist version="1.0">
4
- <dict>
5
- <key>Label</key>
6
- <string>com.claude-forge.daemon</string>
7
-
8
- <key>ProgramArguments</key>
9
- <array>
10
- <string>{{NODE_PATH}}</string>
11
- <string>{{DAEMON_PATH}}</string>
12
- </array>
13
-
14
- <key>WorkingDirectory</key>
15
- <string>{{HOME}}</string>
16
-
17
- <key>EnvironmentVariables</key>
18
- <dict>
19
- <key>PATH</key>
20
- <string>/usr/local/bin:/opt/homebrew/bin:/usr/bin:/bin</string>
21
- <key>NODE_ENV</key>
22
- <string>production</string>
23
- <key>FORGE_DAEMON_FOREGROUND</key>
24
- <string>1</string>
25
- </dict>
26
-
27
- <key>RunAtLoad</key>
28
- <true/>
29
-
30
- <key>KeepAlive</key>
31
- <dict>
32
- <key>SuccessfulExit</key>
33
- <false/>
34
- <key>Crashed</key>
35
- <true/>
36
- </dict>
37
-
38
- <key>ThrottleInterval</key>
39
- <integer>10</integer>
40
-
41
- <key>StandardOutPath</key>
42
- <string>{{HOME}}/.claude-forge/daemon-stdout.log</string>
43
-
44
- <key>StandardErrorPath</key>
45
- <string>{{HOME}}/.claude-forge/daemon-stderr.log</string>
46
- </dict>
47
- </plist>
@@ -1,260 +0,0 @@
1
- /**
2
- * macOS LaunchAgent integration for the Forge daemon.
3
- *
4
- * Renders the plist template, installs/uninstalls the LaunchAgent via launchctl,
5
- * and reports status. Intended to give the daemon supervisor-grade auto-restart
6
- * behavior on darwin without depending on systemd.
7
- */
8
-
9
- import fs from 'fs';
10
- import os from 'os';
11
- import path from 'path';
12
- import { execSync, execFileSync } from 'child_process';
13
- import { fileURLToPath } from 'url';
14
-
15
- const __dirname = path.dirname(fileURLToPath(import.meta.url));
16
-
17
- export const LAUNCHD_LABEL = 'com.claude-forge.daemon';
18
- export const LAUNCH_AGENTS_DIR = path.join(os.homedir(), 'Library', 'LaunchAgents');
19
- export const PLIST_PATH = path.join(LAUNCH_AGENTS_DIR, `${LAUNCHD_LABEL}.plist`);
20
-
21
- export const TEMPLATE_PATH = path.resolve(
22
- __dirname,
23
- 'launchd',
24
- 'com.claude-forge.daemon.plist.template'
25
- );
26
-
27
- export function ensureDarwin(): void {
28
- if (process.platform !== 'darwin') {
29
- throw new Error(
30
- `LaunchAgent commands are only supported on macOS (current platform: ${process.platform}). ` +
31
- `Use './scripts/dev-daemon.sh' or 'cf daemon start' on other platforms.`
32
- );
33
- }
34
- }
35
-
36
- export function getUid(): number {
37
- if (typeof process.getuid === 'function') {
38
- return process.getuid();
39
- }
40
- // Fallback: shell out (process.getuid is undefined on Windows but always defined on darwin).
41
- return parseInt(execSync('id -u', { encoding: 'utf-8' }).trim(), 10);
42
- }
43
-
44
- export interface RenderOptions {
45
- /**
46
- * If true, points ProgramArguments at the local development build
47
- * (`<repo>/dist/daemon/index.js` resolved from this module's location).
48
- * Otherwise, resolves the daemon entry from the globally-installed package.
49
- */
50
- dev?: boolean;
51
- /**
52
- * Optional explicit path to the daemon entrypoint.
53
- * Takes precedence over `dev`.
54
- */
55
- daemonPath?: string;
56
- /**
57
- * Optional explicit node path. Defaults to `process.execPath`.
58
- */
59
- nodePath?: string;
60
- }
61
-
62
- /**
63
- * Resolve the path to `dist/daemon/index.js`.
64
- *
65
- * - In dev mode: resolves relative to this module (works in both src and dist).
66
- * - In production mode: prefers a globally-installed `claude-forge` binary,
67
- * falling back to the path resolved from this module.
68
- */
69
- export function resolveDaemonPath(opts: RenderOptions = {}): string {
70
- if (opts.daemonPath) {
71
- if (!fs.existsSync(opts.daemonPath)) {
72
- throw new Error(`Provided daemon path does not exist: ${opts.daemonPath}`);
73
- }
74
- return opts.daemonPath;
75
- }
76
-
77
- // From `dist/daemon/launchd-installer.js` -> `dist/daemon/index.js`
78
- // From `src/daemon/launchd-installer.ts` -> would resolve to src path; but we only ship dist.
79
- const localGuess = path.resolve(__dirname, 'index.js');
80
-
81
- if (opts.dev) {
82
- if (!fs.existsSync(localGuess)) {
83
- throw new Error(
84
- `Local daemon entry not found at ${localGuess}. Run 'npm run build' first.`
85
- );
86
- }
87
- return localGuess;
88
- }
89
-
90
- // Production mode: try to find global install via `which claude-forge`.
91
- try {
92
- const cliPath = execSync('command -v claude-forge', { encoding: 'utf-8' }).trim();
93
- if (cliPath) {
94
- const resolved = fs.realpathSync(cliPath);
95
- // The CLI lives at <pkg>/dist/cli/index.js; daemon at <pkg>/dist/daemon/index.js.
96
- const pkgRoot = path.resolve(path.dirname(resolved), '..');
97
- const candidate = path.join(pkgRoot, 'daemon', 'index.js');
98
- if (fs.existsSync(candidate)) {
99
- return candidate;
100
- }
101
- }
102
- } catch {
103
- // Ignore — fall through to local guess.
104
- }
105
-
106
- if (fs.existsSync(localGuess)) {
107
- return localGuess;
108
- }
109
-
110
- throw new Error(
111
- `Could not locate daemon entry. Install claude-forge globally (npm i -g @winspan/claude-forge) ` +
112
- `or run with --dev after 'npm run build'.`
113
- );
114
- }
115
-
116
- export function renderPlist(opts: RenderOptions = {}): string {
117
- if (!fs.existsSync(TEMPLATE_PATH)) {
118
- throw new Error(`plist template missing at ${TEMPLATE_PATH}. Did you run 'npm run build'?`);
119
- }
120
- const template = fs.readFileSync(TEMPLATE_PATH, 'utf-8');
121
- const nodePath = opts.nodePath ?? process.execPath;
122
- const daemonPath = resolveDaemonPath(opts);
123
- const home = os.homedir();
124
-
125
- return template
126
- .replace(/{{NODE_PATH}}/g, nodePath)
127
- .replace(/{{DAEMON_PATH}}/g, daemonPath)
128
- .replace(/{{HOME}}/g, home);
129
- }
130
-
131
- function runLaunchctl(args: string[]): { stdout: string; stderr: string; code: number } {
132
- try {
133
- const stdout = execFileSync('launchctl', args, {
134
- encoding: 'utf-8',
135
- stdio: ['ignore', 'pipe', 'pipe'],
136
- });
137
- return { stdout, stderr: '', code: 0 };
138
- } catch (err) {
139
- const e = err as NodeJS.ErrnoException & { stdout?: Buffer; stderr?: Buffer; status?: number };
140
- return {
141
- stdout: e.stdout?.toString() ?? '',
142
- stderr: e.stderr?.toString() ?? e.message ?? '',
143
- code: e.status ?? 1,
144
- };
145
- }
146
- }
147
-
148
- export interface InstallResult {
149
- plistPath: string;
150
- nodePath: string;
151
- daemonPath: string;
152
- reloaded: boolean;
153
- }
154
-
155
- export function install(opts: RenderOptions = {}): InstallResult {
156
- ensureDarwin();
157
- fs.mkdirSync(LAUNCH_AGENTS_DIR, { recursive: true });
158
-
159
- const uid = getUid();
160
- const target = `gui/${uid}/${LAUNCHD_LABEL}`;
161
-
162
- // Idempotent: bootout existing service before re-installing.
163
- let reloaded = false;
164
- if (fs.existsSync(PLIST_PATH)) {
165
- const r = runLaunchctl(['bootout', `gui/${uid}`, PLIST_PATH]);
166
- if (r.code === 0 || /No such process|Could not find specified service/.test(r.stderr)) {
167
- reloaded = true;
168
- } else {
169
- // Non-fatal; proceed and let bootstrap surface real errors.
170
- reloaded = true;
171
- }
172
- }
173
-
174
- const rendered = renderPlist(opts);
175
- fs.writeFileSync(PLIST_PATH, rendered, { mode: 0o644 });
176
-
177
- const bootstrap = runLaunchctl(['bootstrap', `gui/${uid}`, PLIST_PATH]);
178
- if (bootstrap.code !== 0) {
179
- throw new Error(
180
- `launchctl bootstrap failed (exit ${bootstrap.code}): ${bootstrap.stderr.trim() || bootstrap.stdout.trim()}\n` +
181
- `Service target: ${target}`
182
- );
183
- }
184
-
185
- // Best-effort kickstart so the daemon comes up immediately.
186
- runLaunchctl(['kickstart', '-k', target]);
187
-
188
- // Read back rendered values to report.
189
- const nodePath = opts.nodePath ?? process.execPath;
190
- const daemonPath = resolveDaemonPath(opts);
191
-
192
- return { plistPath: PLIST_PATH, nodePath, daemonPath, reloaded };
193
- }
194
-
195
- export interface UninstallResult {
196
- removedPlist: boolean;
197
- bootedOut: boolean;
198
- }
199
-
200
- export function uninstall(): UninstallResult {
201
- ensureDarwin();
202
- const uid = getUid();
203
-
204
- let bootedOut = false;
205
- if (fs.existsSync(PLIST_PATH)) {
206
- const r = runLaunchctl(['bootout', `gui/${uid}`, PLIST_PATH]);
207
- bootedOut =
208
- r.code === 0 || /No such process|Could not find specified service/.test(r.stderr);
209
- }
210
-
211
- let removedPlist = false;
212
- if (fs.existsSync(PLIST_PATH)) {
213
- fs.unlinkSync(PLIST_PATH);
214
- removedPlist = true;
215
- }
216
-
217
- return { bootedOut, removedPlist };
218
- }
219
-
220
- export interface LaunchdStatus {
221
- installed: boolean;
222
- loaded: boolean;
223
- pid: number | null;
224
- lastExitCode: number | null;
225
- state: string | null;
226
- raw: string;
227
- }
228
-
229
- export function status(): LaunchdStatus {
230
- ensureDarwin();
231
- const uid = getUid();
232
- const target = `gui/${uid}/${LAUNCHD_LABEL}`;
233
- const installed = fs.existsSync(PLIST_PATH);
234
-
235
- const r = runLaunchctl(['print', target]);
236
- if (r.code !== 0) {
237
- return {
238
- installed,
239
- loaded: false,
240
- pid: null,
241
- lastExitCode: null,
242
- state: null,
243
- raw: r.stderr.trim() || r.stdout.trim(),
244
- };
245
- }
246
-
247
- const out = r.stdout;
248
- const pidMatch = out.match(/^\s*pid\s*=\s*(\d+)/m);
249
- const stateMatch = out.match(/^\s*state\s*=\s*([\w-]+)/m);
250
- const exitMatch = out.match(/^\s*last exit code\s*=\s*(-?\d+)/mi);
251
-
252
- return {
253
- installed,
254
- loaded: true,
255
- pid: pidMatch ? parseInt(pidMatch[1], 10) : null,
256
- state: stateMatch ? stateMatch[1] : null,
257
- lastExitCode: exitMatch ? parseInt(exitMatch[1], 10) : null,
258
- raw: out,
259
- };
260
- }