@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,250 +0,0 @@
1
- import type { Application } from 'express';
2
- import type { RouteContext } from './types.js';
3
- import { truncateField } from './_helpers.js';
4
- import { getCommand, getFilePath, getUserPrompt } from '../../core/event-fields.js';
5
-
6
- /**
7
- * /api/sessions* — session lists, per-session detail, timeline.
8
- *
9
- * Also hosts /api/injections since they are session-adjacent views.
10
- */
11
- export function registerSessionsRoutes(app: Application, ctx: RouteContext): void {
12
- const { storage } = ctx;
13
-
14
- // Sessions: list with first prompt
15
- app.get('/api/sessions', (req, res) => {
16
- const limit = parseInt(req.query.limit as string) || 10;
17
- const projectPath = req.query.project as string | undefined;
18
- const sessions = storage.querySessions({ project_path: projectPath, limit });
19
- res.json(sessions);
20
- });
21
-
22
- // Injections: query injection history
23
- app.get('/api/injections', (req, res) => {
24
- const limit = parseInt(req.query.limit as string) || 50;
25
- const sessionId = req.query.session as string | undefined;
26
- const eventId = req.query.event as string | undefined;
27
- const handler = req.query.handler as string | undefined;
28
- const injections = storage.queryInjections({
29
- session_id: sessionId,
30
- event_id: eventId,
31
- source_handler: handler,
32
- limit,
33
- });
34
- res.json(injections);
35
- });
36
-
37
- // Session Events Search: server-side filtering
38
- app.get('/api/sessions/:sessionId/events/search', (req, res) => {
39
- const { sessionId } = req.params;
40
- const { q, tool_name, hook_type, limit = '100', offset = '0' } = req.query;
41
-
42
- const sessions = storage.querySessions({ limit: 1000 });
43
- const session = sessions.find(s => s.session_id === sessionId || s.session_id.startsWith(sessionId));
44
-
45
- if (!session) {
46
- res.status(404).json({ error: 'Session not found' });
47
- return;
48
- }
49
-
50
- const results = storage.searchEvents({
51
- session_id: session.session_id,
52
- query: q as string | undefined,
53
- tool_name: tool_name as string | undefined,
54
- hook_type: hook_type as string | undefined,
55
- limit: parseInt(limit as string, 10),
56
- offset: parseInt(offset as string, 10),
57
- });
58
-
59
- res.json({ events: results, total: results.length, session_id: session.session_id });
60
- });
61
-
62
- // Session Detail: task-grouped session data
63
- app.get('/api/sessions/:sessionId/detail', (req, res) => {
64
- const sessionId = req.params.sessionId;
65
- const eventLimit = parseInt(req.query.eventLimit as string) || 200;
66
- const eventOffset = parseInt(req.query.eventOffset as string) || 0;
67
-
68
- const sessions = storage.querySessions({ limit: 1000 });
69
- const session = sessions.find(s => s.session_id === sessionId || s.session_id.startsWith(sessionId));
70
- if (!session) {
71
- res.status(404).json({ error: 'Session not found' });
72
- return;
73
- }
74
-
75
- const fullSessionId = session.session_id;
76
- const tasks = storage.queryTasks({ session_id: fullSessionId });
77
- const totalEvents = storage.countEvents({ session_id: fullSessionId });
78
- const allEvents = storage.queryEvents({ session_id: fullSessionId, limit: eventLimit, offset: eventOffset });
79
- const allInjections = storage.queryInjections({ session_id: fullSessionId, limit: 200 });
80
-
81
- const buildTaskDetail = (events: typeof allEvents, injections: typeof allInjections) => {
82
- const prompts = events
83
- .filter(e => e.hook_type === 'UserPromptSubmit' && getUserPrompt(e))
84
- .map(e => ({ timestamp: e.timestamp, content: getUserPrompt(e) }));
85
-
86
- const toolUsage: Record<string, number> = {};
87
- events.forEach(e => { if (e.tool_name) toolUsage[e.tool_name] = (toolUsage[e.tool_name] || 0) + 1; });
88
-
89
- const filesChanged = [...new Set(
90
- events
91
- .filter(e => (e.tool_name === 'Edit' || e.tool_name === 'Write') && getFilePath(e))
92
- .map(e => getFilePath(e)!),
93
- )];
94
-
95
- const commits = events
96
- .filter(e => e.tool_name === 'Bash' && getCommand(e)?.includes('git commit'))
97
- .map(e => {
98
- const cmd = getCommand(e) || '';
99
- const match = cmd.match(/git commit.*-m\s+["']([^"']+)["']/);
100
- return { timestamp: e.timestamp, message: match ? match[1] : 'commit' };
101
- });
102
-
103
- return { prompts, events: events.slice(0, 200), injections, summary: { toolUsage, filesChanged, commits } };
104
- };
105
-
106
- if (tasks.length === 0) {
107
- const detail = buildTaskDetail(allEvents, allInjections);
108
- const virtualTask = {
109
- id: 'virtual',
110
- session_id: fullSessionId,
111
- title: session.first_prompt || '(未分类任务)',
112
- start_time: session.start_time,
113
- end_time: session.end_time,
114
- status: 'completed' as const,
115
- event_count: allEvents.length,
116
- ...detail,
117
- };
118
- res.json({ session, tasks: [virtualTask], total_events: totalEvents, event_limit: eventLimit, event_offset: eventOffset });
119
- return;
120
- }
121
-
122
- const taskDetails = tasks.map(task => {
123
- const taskEventIds = new Set(storage.getTaskEventIds(task.id));
124
- const events = allEvents.filter(e => taskEventIds.has(e.event_id ?? ''));
125
- const injections = allInjections.filter(i => i.event_id && taskEventIds.has(i.event_id));
126
- const detail = buildTaskDetail(events, injections);
127
- return { ...task, ...detail };
128
- });
129
-
130
- res.json({ session, tasks: taskDetails, total_events: totalEvents, event_limit: eventLimit, event_offset: eventOffset });
131
- });
132
-
133
- // Session timeline: detailed event timeline for a session
134
- app.get('/api/sessions/:id/timeline', (req, res) => {
135
- const sessionIdPrefix = req.params.id;
136
- const limit = parseInt(req.query.limit as string) || 50;
137
- const offset = parseInt(req.query.offset as string) || 0;
138
-
139
- const sessions = storage.querySessions({ limit: 1000 });
140
- const session = sessions.find(s => s.session_id.startsWith(sessionIdPrefix));
141
-
142
- if (!session) {
143
- res.status(404).json({ error: 'Session not found' });
144
- return;
145
- }
146
-
147
- const fullSessionId = session.session_id;
148
- const events = storage.queryEvents({ session_id: fullSessionId, limit: 2000 });
149
- const injections = storage.queryInjections({ session_id: fullSessionId, limit: 200 });
150
-
151
- // Build timeline: merge events and injections, sort by timestamp
152
- const timeline: Array<{
153
- timestamp: string;
154
- type: 'user_input' | 'injection' | 'tool_call' | 'quality_check';
155
- data: any;
156
- }> = [];
157
-
158
- // User inputs
159
- events
160
- .filter(e => e.hook_type === 'UserPromptSubmit' && getUserPrompt(e))
161
- .forEach(e => {
162
- timeline.push({
163
- timestamp: e.timestamp,
164
- type: 'user_input',
165
- data: { content: getUserPrompt(e) },
166
- });
167
- });
168
-
169
- // Injections (truncate content for preview)
170
- injections.forEach(inj => {
171
- timeline.push({
172
- timestamp: inj.timestamp,
173
- type: 'injection',
174
- data: {
175
- source: inj.source_handler,
176
- injection_type: inj.injection_type,
177
- content: inj.content.slice(0, 500),
178
- length: inj.content.length,
179
- truncated: inj.content.length > 500,
180
- },
181
- });
182
- });
183
-
184
- // Tool calls (truncate large fields)
185
- events
186
- .filter(e => e.tool_name && e.hook_type === 'PreToolUse')
187
- .forEach(e => {
188
- const toolInput = e.tool_input;
189
- const toolOutput = e.tool_output;
190
-
191
- timeline.push({
192
- timestamp: e.timestamp,
193
- type: 'tool_call',
194
- data: {
195
- tool: e.tool_name,
196
- input: truncateField(toolInput, 200, 5),
197
- output: truncateField(toolOutput, 200, 5),
198
- success: !toolOutput?.error,
199
- },
200
- });
201
- });
202
-
203
- // Quality checks (from PostToolUse events with quality gate results)
204
- events
205
- .filter(e => e.hook_type === 'PostToolUse' && (e.tool_output as any)?.quality_check)
206
- .forEach(e => {
207
- const qc = (e.tool_output as any).quality_check;
208
- timeline.push({
209
- timestamp: e.timestamp,
210
- type: 'quality_check',
211
- data: qc,
212
- });
213
- });
214
-
215
- // Sort by timestamp
216
- timeline.sort((a, b) => a.timestamp.localeCompare(b.timestamp));
217
-
218
- // Paginate
219
- const total = timeline.length;
220
- const paginatedTimeline = timeline.slice(offset, offset + limit);
221
-
222
- // Summary
223
- const commits = events
224
- .filter(e => e.tool_name === 'Bash' && getCommand(e)?.includes('git commit'))
225
- .map(e => {
226
- const cmd = getCommand(e) || '';
227
- const match = cmd.match(/git commit.*-m\s+["']([^"']+)["']/);
228
- return { message: match ? match[1] : 'commit' };
229
- });
230
-
231
- const filesChanged = [...new Set(
232
- events
233
- .filter(e => (e.tool_name === 'Edit' || e.tool_name === 'Write') && getFilePath(e))
234
- .map(e => getFilePath(e)!),
235
- )];
236
-
237
- res.json({
238
- session,
239
- timeline: paginatedTimeline,
240
- total,
241
- offset,
242
- limit,
243
- hasMore: offset + limit < total,
244
- summary: {
245
- commits,
246
- filesChanged,
247
- },
248
- });
249
- });
250
- }
@@ -1,92 +0,0 @@
1
- import type { Application } from 'express';
2
- import type { RouteContext } from './types.js';
3
-
4
- /**
5
- * /api/skill-stats/* — Skill usage statistics and analytics
6
- *
7
- * Provides data for the Skill Statistics dashboard:
8
- * - /api/skill-stats/distribution — routing type distribution (agent/skill/none)
9
- * - /api/skill-stats/frequency — skill usage frequency
10
- * - /api/skill-stats/trend — skill usage rate trend over time
11
- *
12
- * H1: All endpoints now use storage-layer SQL aggregation (no JS GROUP BY).
13
- */
14
- export function registerSkillStatsRoutes(app: Application, ctx: RouteContext): void {
15
- const { storage } = ctx;
16
-
17
- // Routing type distribution (for pie chart)
18
- app.get('/api/skill-stats/distribution', (req, res) => {
19
- const windowHours = parseInt((req.query.window as string) || '168'); // default 7d
20
- const since = Date.now() - windowHours * 3600 * 1000;
21
- const agg = storage.aggregateRoutingStats({ since_ts: since });
22
-
23
- // Ensure stable ordering and presence of all three buckets (agent/skill/none)
24
- const counts: Record<string, number> = { agent: 0, skill: 0, none: 0 };
25
- for (const row of agg.by_type) {
26
- counts[row.type] = row.count;
27
- }
28
- const result = Object.entries(counts).map(([type, count]) => ({ type, count }));
29
-
30
- res.json({ windowHours, distribution: result });
31
- });
32
-
33
- // Skill usage frequency (for bar chart)
34
- app.get('/api/skill-stats/frequency', (req, res) => {
35
- const windowHours = parseInt((req.query.window as string) || '168');
36
- const since = Date.now() - windowHours * 3600 * 1000;
37
- const agg = storage.aggregateRoutingStats({ since_ts: since });
38
-
39
- const result = agg.by_skill_routed.map(({ skill, count }) => ({ name: skill, count }));
40
-
41
- res.json({ windowHours, frequency: result });
42
- });
43
-
44
- // Skill usage rate trend over time (for line chart)
45
- app.get('/api/skill-stats/trend', (req, res) => {
46
- const windowHours = parseInt((req.query.window as string) || '168');
47
- const since = Date.now() - windowHours * 3600 * 1000;
48
- const rows = storage.aggregateRoutingTrendByDay({ since_ts: since });
49
-
50
- const result = rows
51
- .map(r => ({
52
- day: r.day,
53
- skillRate: r.total > 0 ? Math.round((r.skill / r.total) * 100) : 0,
54
- }))
55
- .sort((a, b) => a.day.localeCompare(b.day));
56
-
57
- res.json({ windowHours, trend: result });
58
- });
59
-
60
- // Skill invocations from skill_invocations table (real call records)
61
- app.get('/api/skill-stats/invocations', (req, res) => {
62
- const days = parseInt((req.query.days as string) || '7');
63
- const since = Date.now() - days * 24 * 3600 * 1000;
64
- const rows = storage.aggregateSkillInvocationsBySkill({ since });
65
-
66
- const total = rows.reduce((sum, r) => sum + r.total, 0);
67
- const result = rows.map(r => ({
68
- skill_id: r.skill_id,
69
- total: r.total,
70
- success: r.success,
71
- failed: r.failed,
72
- }));
73
-
74
- res.json({ days, total, invocations: result });
75
- });
76
-
77
- // Routing/Agent call rate stats
78
- app.get('/api/routing/stats', (req, res) => {
79
- const days = parseInt((req.query.days as string) || '7');
80
- const since = Date.now() - days * 24 * 3600 * 1000;
81
- const agg = storage.aggregateRoutingStats({ since_ts: since });
82
-
83
- const total = agg.total;
84
- const agentCalls = agg.obeyed;
85
- const noAgent = total - agentCalls;
86
- const agentRate = total > 0 ? Math.round((agentCalls / total) * 1000) / 10 : 0;
87
-
88
- const byAgent = agg.by_agent.map(({ agent, count }) => ({ agent, count }));
89
-
90
- res.json({ days, total, agentCalls, noAgent, agentRate, byAgent });
91
- });
92
- }
@@ -1,350 +0,0 @@
1
- import type { Application } from 'express';
2
- import fs from 'fs';
3
- import path from 'path';
4
- import { homedir } from 'os';
5
- import { logger } from '../../core/utils/logger.js';
6
- import type { RouteContext } from './types.js';
7
- import { FORGE_PATHS } from '../../core/constants.js';
8
-
9
- /**
10
- * /api/skills/* — list, read, update, version, rollback.
11
- *
12
- * Supports both flat `<name>.md` and directory-style `<name>/SKILL.md` layouts.
13
- * Prefers the registry when available so built-in skills resolve correctly.
14
- */
15
- export function registerSkillsRoutes(app: Application, ctx: RouteContext): void {
16
- const skillRegistry = ctx.skillRegistry;
17
-
18
- // GET /api/skills — list all skills (official + user; supports flat & directory formats)
19
- app.get('/api/skills', (_req, res) => {
20
- try {
21
- if (skillRegistry) {
22
- // Preferred path: reuse SkillRegistry (handles flat .md and <name>/SKILL.md)
23
- const skills = skillRegistry.getAll().map(s => ({
24
- name: s.name,
25
- id: s.id,
26
- description: s.description ?? '',
27
- keywords: s.keywords,
28
- path: s.path,
29
- isOfficial: s.isOfficial === true,
30
- source: s.isOfficial ? 'official' : 'user',
31
- }));
32
- res.json({ skills });
33
- return;
34
- }
35
-
36
- // Fallback: scan directly if registry not injected
37
- const skillsDir = path.join(homedir(), '.claude', 'skills');
38
- const skills: Array<{
39
- name: string;
40
- id: string;
41
- description: string;
42
- keywords: string[];
43
- path: string;
44
- isOfficial: boolean;
45
- source: 'official' | 'user';
46
- }> = [];
47
-
48
- if (fs.existsSync(skillsDir)) {
49
- const entries = fs.readdirSync(skillsDir, { withFileTypes: true });
50
- for (const entry of entries) {
51
- let filePath: string | null = null;
52
- let id: string;
53
-
54
- if (entry.isFile() && entry.name.endsWith('.md')) {
55
- filePath = path.join(skillsDir, entry.name);
56
- id = entry.name.replace(/\.md$/, '');
57
- } else if (entry.isDirectory() || entry.isSymbolicLink()) {
58
- const skillMd = path.join(skillsDir, entry.name, 'SKILL.md');
59
- if (!fs.existsSync(skillMd)) continue;
60
- filePath = skillMd;
61
- id = entry.name;
62
- } else {
63
- continue;
64
- }
65
-
66
- try {
67
- const content = fs.readFileSync(filePath, 'utf-8');
68
- const match = content.match(/^---\n([\s\S]*?)\n---/);
69
- let description = '';
70
- const keywords: string[] = [];
71
- if (match) {
72
- const fm = match[1];
73
- const descMatch = fm.match(/description:\s*["']?([^"'\n]+)["']?/);
74
- description = descMatch?.[1]?.trim() || '';
75
- }
76
- skills.push({
77
- name: id,
78
- id,
79
- description,
80
- keywords,
81
- path: filePath,
82
- isOfficial: false,
83
- source: 'user',
84
- });
85
- } catch (err) {
86
- logger.warn(`[Web] Failed to read skill ${id}: ${err}`);
87
- }
88
- }
89
- }
90
-
91
- res.json({ skills });
92
- } catch (err) {
93
- logger.warn(`[Web] Failed to list skills: ${err}`);
94
- res.status(500).json({ error: String(err) });
95
- }
96
- });
97
-
98
- // GET /api/skills/:name — get skill details (supports flat & directory formats)
99
- app.get('/api/skills/:name', (req, res) => {
100
- try {
101
- const { name } = req.params;
102
-
103
- // Security: prevent path traversal attacks
104
- if (!name || name.includes('/') || name.includes('\\') || name.includes('..')) {
105
- res.status(400).json({ error: 'Invalid skill name' });
106
- return;
107
- }
108
-
109
- if (skillRegistry) {
110
- const skill = skillRegistry.getAll().find(s => s.id === name || s.name === name);
111
- if (skill) {
112
- if (skill.path === '<built-in>') {
113
- res.json({
114
- name: skill.name,
115
- id: skill.id,
116
- description: skill.description ?? '',
117
- keywords: skill.keywords,
118
- isOfficial: true,
119
- source: 'official',
120
- content: skill.content,
121
- });
122
- return;
123
- }
124
- // For user skills, fall through to disk read so edits show latest content
125
- if (fs.existsSync(skill.path)) {
126
- const content = fs.readFileSync(skill.path, 'utf-8');
127
- res.json({
128
- name: skill.name,
129
- id: skill.id,
130
- description: skill.description ?? '',
131
- keywords: skill.keywords,
132
- isOfficial: false,
133
- source: 'user',
134
- path: skill.path,
135
- content,
136
- });
137
- return;
138
- }
139
- }
140
- }
141
-
142
- // Fallback: try flat .md then <name>/SKILL.md
143
- const skillsDir = path.join(homedir(), '.claude', 'skills');
144
- const flatPath = path.join(skillsDir, `${name}.md`);
145
- const dirPath = path.join(skillsDir, name, 'SKILL.md');
146
- const filePath = fs.existsSync(flatPath)
147
- ? flatPath
148
- : fs.existsSync(dirPath)
149
- ? dirPath
150
- : null;
151
-
152
- if (!filePath) {
153
- res.status(404).json({ error: 'Skill not found' });
154
- return;
155
- }
156
-
157
- const content = fs.readFileSync(filePath, 'utf-8');
158
- const match = content.match(/^---\n([\s\S]*?)\n---\n([\s\S]*)$/);
159
- if (!match) {
160
- res.json({ name, id: name, content, path: filePath });
161
- return;
162
- }
163
-
164
- const fm = match[1];
165
- const descMatch = fm.match(/description:\s*["']?([^"'\n]+)["']?/);
166
- const verMatch = fm.match(/version:\s*["']?([^"'\n]+)["']?/);
167
- const sourceMatch = fm.match(/source:\s*["']?([^"'\n]+)["']?/);
168
-
169
- res.json({
170
- name,
171
- id: name,
172
- description: descMatch?.[1]?.trim() || '',
173
- version: verMatch?.[1],
174
- source: sourceMatch?.[1] || 'user',
175
- path: filePath,
176
- content,
177
- });
178
- } catch (err) {
179
- logger.warn(`[Web] Failed to get skill ${req.params.name}: ${err}`);
180
- res.status(500).json({ error: String(err) });
181
- }
182
- });
183
-
184
- // PUT /api/skills/:name — update skill content
185
- app.put('/api/skills/:name', (req, res) => {
186
- try {
187
- const { name } = req.params;
188
- const { content } = req.body;
189
-
190
- // Security: prevent path traversal attacks
191
- if (!name || name.includes('/') || name.includes('\\') || name.includes('..')) {
192
- res.status(400).json({ error: 'Invalid skill name' });
193
- return;
194
- }
195
-
196
- if (!content || typeof content !== 'string') {
197
- res.status(400).json({ error: 'Missing content' });
198
- return;
199
- }
200
-
201
- const skillsDir = path.join(homedir(), '.claude', 'skills');
202
- const filePath = path.join(skillsDir, `${name}.md`);
203
-
204
- if (!fs.existsSync(filePath)) {
205
- res.status(404).json({ error: 'Skill not found' });
206
- return;
207
- }
208
-
209
- const backupDir = FORGE_PATHS.backups('skills');
210
- fs.mkdirSync(backupDir, { recursive: true });
211
- const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
212
- const backupPath = path.join(backupDir, `${name}-${timestamp}.md`);
213
- fs.copyFileSync(filePath, backupPath);
214
-
215
- fs.writeFileSync(filePath, content, 'utf-8');
216
- logger.info(`[Web] Updated skill ${name} (backup: ${backupPath})`);
217
-
218
- res.json({ success: true, backup: backupPath });
219
- } catch (err) {
220
- logger.warn(`[Web] Failed to update skill ${req.params.name}: ${err}`);
221
- res.status(500).json({ error: String(err) });
222
- }
223
- });
224
-
225
- // GET /api/skills/:name/versions — list backup versions
226
- app.get('/api/skills/:name/versions', (req, res) => {
227
- try {
228
- const { name } = req.params;
229
-
230
- // Security: prevent path traversal attacks
231
- if (!name || name.includes('/') || name.includes('\\') || name.includes('..')) {
232
- res.status(400).json({ error: 'Invalid skill name' });
233
- return;
234
- }
235
-
236
- const backupDir = FORGE_PATHS.backups('skills');
237
-
238
- if (!fs.existsSync(backupDir)) {
239
- res.json({ versions: [] });
240
- return;
241
- }
242
-
243
- const files = fs.readdirSync(backupDir)
244
- .filter(f => f.startsWith(`${name}-`) && f.endsWith('.md'))
245
- .map(f => {
246
- const filePath = path.join(backupDir, f);
247
- const stats = fs.statSync(filePath);
248
- const timestampMatch = f.match(/-(\d{4}-\d{2}-\d{2}T\d{2}-\d{2}-\d{2}-\d{3}Z)\.md$/);
249
- return {
250
- filename: f,
251
- timestamp: timestampMatch ? timestampMatch[1].replace(/-/g, ':').replace(/T(\d{2}):(\d{2}):(\d{2})/, 'T$1:$2:$3') : '',
252
- size: stats.size,
253
- mtime: stats.mtime.toISOString(),
254
- };
255
- })
256
- .sort((a, b) => new Date(b.mtime).getTime() - new Date(a.mtime).getTime());
257
-
258
- res.json({ versions: files });
259
- } catch (err) {
260
- logger.warn(`[Web] Failed to list skill versions: ${err}`);
261
- res.status(500).json({ error: String(err) });
262
- }
263
- });
264
-
265
- // GET /api/skills/:name/versions/:timestamp — get specific version content
266
- app.get('/api/skills/:name/versions/:timestamp', (req, res) => {
267
- try {
268
- const { name, timestamp } = req.params;
269
-
270
- // Security: prevent path traversal attacks
271
- if (!name || name.includes('/') || name.includes('\\') || name.includes('..')) {
272
- res.status(400).json({ error: 'Invalid skill name' });
273
- return;
274
- }
275
- if (!timestamp || timestamp.includes('/') || timestamp.includes('\\') || timestamp.includes('..')) {
276
- res.status(400).json({ error: 'Invalid timestamp' });
277
- return;
278
- }
279
-
280
- const backupDir = FORGE_PATHS.backups('skills');
281
- const filename = `${name}-${timestamp}.md`;
282
- const filePath = path.join(backupDir, filename);
283
-
284
- if (!fs.existsSync(filePath)) {
285
- res.status(404).json({ error: 'Version not found' });
286
- return;
287
- }
288
-
289
- const content = fs.readFileSync(filePath, 'utf-8');
290
- res.json({ content });
291
- } catch (err) {
292
- logger.warn(`[Web] Failed to get skill version: ${err}`);
293
- res.status(500).json({ error: String(err) });
294
- }
295
- });
296
-
297
- // POST /api/skills/:name/rollback — rollback to a specific version
298
- app.post('/api/skills/:name/rollback', (req, res) => {
299
- try {
300
- const { name } = req.params;
301
- const { timestamp } = req.body;
302
-
303
- // Security: prevent path traversal attacks
304
- if (!name || name.includes('/') || name.includes('\\') || name.includes('..')) {
305
- res.status(400).json({ error: 'Invalid skill name' });
306
- return;
307
- }
308
-
309
- if (!timestamp) {
310
- res.status(400).json({ error: 'Missing timestamp' });
311
- return;
312
- }
313
-
314
- // Security: validate timestamp format
315
- if (timestamp.includes('/') || timestamp.includes('\\') || timestamp.includes('..')) {
316
- res.status(400).json({ error: 'Invalid timestamp' });
317
- return;
318
- }
319
-
320
- const skillsDir = path.join(homedir(), '.claude', 'skills');
321
- const currentPath = path.join(skillsDir, `${name}.md`);
322
- const backupDir = FORGE_PATHS.backups('skills');
323
- const versionPath = path.join(backupDir, `${name}-${timestamp}.md`);
324
-
325
- if (!fs.existsSync(currentPath)) {
326
- res.status(404).json({ error: 'Skill not found' });
327
- return;
328
- }
329
-
330
- if (!fs.existsSync(versionPath)) {
331
- res.status(404).json({ error: 'Version not found' });
332
- return;
333
- }
334
-
335
- fs.mkdirSync(backupDir, { recursive: true });
336
- const rollbackTimestamp = new Date().toISOString().replace(/[:.]/g, '-');
337
- const rollbackBackupPath = path.join(backupDir, `${name}-${rollbackTimestamp}.md`);
338
- fs.copyFileSync(currentPath, rollbackBackupPath);
339
-
340
- const versionContent = fs.readFileSync(versionPath, 'utf-8');
341
- fs.writeFileSync(currentPath, versionContent, 'utf-8');
342
-
343
- logger.info(`[Web] Rolled back skill ${name} to ${timestamp} (backup: ${rollbackBackupPath})`);
344
- res.json({ success: true, backup: rollbackBackupPath });
345
- } catch (err) {
346
- logger.warn(`[Web] Failed to rollback skill: ${err}`);
347
- res.status(500).json({ error: String(err) });
348
- }
349
- });
350
- }