pi-harness-runtime 0.10.11 → 0.10.12

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 (584) hide show
  1. package/cli.ts +111 -0
  2. package/footer-status.ts +204 -0
  3. package/harness/agent-handoff.ts +189 -0
  4. package/harness/auto-compact.ts +309 -0
  5. package/harness/auto-quota-resume.ts +132 -0
  6. package/harness/autonomous-review.ts +88 -0
  7. package/harness/blackboard.ts +291 -0
  8. package/harness/context-compact-orchestrator.ts +551 -0
  9. package/harness/context-window-manager.ts +464 -0
  10. package/harness/continue-prompt.ts +242 -0
  11. package/harness/e2e/index.ts +44 -0
  12. package/harness/e2e/minimax-quota-parser.ts +88 -0
  13. package/harness/e2e/minimax-quota-scraper.ts +609 -0
  14. package/harness/e2e/openai-quota-scraper.ts +447 -0
  15. package/harness/e2e/playwright-runner.ts +204 -0
  16. package/harness/e2e/quota-status.ts +194 -0
  17. package/harness/e2e/test-engine.ts +398 -0
  18. package/harness/forked-summarizer.ts +304 -0
  19. package/harness/herdr-agents.ts +91 -0
  20. package/harness/index.ts +232 -0
  21. package/harness/job-state-machine.ts +363 -0
  22. package/harness/loop-code-agent.ts +284 -0
  23. package/harness/loop-controller.ts +201 -0
  24. package/harness/loop-review-agent.ts +295 -0
  25. package/harness/loop-runtime.ts +760 -0
  26. package/harness/loop-types.ts +118 -0
  27. package/harness/master-planner.ts +327 -0
  28. package/harness/notification-events.ts +299 -0
  29. package/harness/output-limit-handler.ts +316 -0
  30. package/harness/partial-recovery.ts +531 -0
  31. package/harness/project-detector/detector.ts +328 -0
  32. package/harness/repair-engine.ts +340 -0
  33. package/harness/session-memory.ts +401 -0
  34. package/harness/task-graph.d.ts +51 -0
  35. package/harness/task-graph.ts +143 -0
  36. package/mirror.ts +278 -0
  37. package/package.json +8 -12
  38. package/packages/a2a-adapter/src/agent.ts +139 -0
  39. package/packages/a2a-adapter/src/client.ts +107 -0
  40. package/packages/a2a-adapter/src/discovery.ts +106 -0
  41. package/packages/a2a-adapter/src/index.ts +38 -0
  42. package/packages/a2a-adapter/src/protocol.ts +46 -0
  43. package/packages/a2a-adapter/src/transport.ts +142 -0
  44. package/packages/a2a-adapter/src/types.ts +117 -0
  45. package/packages/auth/src/minimax-browser-auth.ts +1109 -0
  46. package/packages/auth/src/run-minimax-auth.ts +150 -0
  47. package/packages/autonomous-refactor/src/detector.ts +219 -0
  48. package/packages/autonomous-refactor/src/index.ts +16 -0
  49. package/packages/autonomous-refactor/src/planner.ts +99 -0
  50. package/packages/autonomous-refactor/src/types.ts +57 -0
  51. package/packages/autonomous-runtime/src/inbox.ts +266 -0
  52. package/packages/autonomous-runtime/src/index.ts +22 -0
  53. package/packages/autonomous-runtime/src/lease.ts +318 -0
  54. package/packages/autonomous-runtime/src/types.ts +257 -0
  55. package/packages/cache-strategy/src/cache.ts +213 -0
  56. package/packages/cache-strategy/src/index.ts +6 -0
  57. package/packages/cache-strategy/src/types.ts +40 -0
  58. package/packages/capability-registry/src/defaults.ts +247 -0
  59. package/packages/capability-registry/src/index.ts +43 -0
  60. package/packages/capability-registry/src/query.ts +99 -0
  61. package/packages/capability-registry/src/registry.ts +222 -0
  62. package/packages/capability-registry/src/types.d.ts +47 -0
  63. package/packages/capability-registry/src/types.js +10 -0
  64. package/packages/capability-registry/src/types.ts +83 -0
  65. package/packages/checkpoint/src/checkpoint-manager.ts +33 -0
  66. package/packages/checkpoint/src/differ.ts +281 -0
  67. package/packages/checkpoint/src/engine.ts +532 -0
  68. package/packages/checkpoint/src/index.ts +48 -0
  69. package/packages/checkpoint/src/storage.ts +439 -0
  70. package/packages/checkpoint/src/types.ts +348 -0
  71. package/packages/cli-plugin-sdk/src/index.ts +169 -0
  72. package/packages/cli-plugin-sdk/src/plugin-fs.ts +91 -0
  73. package/packages/cli-plugin-sdk/src/registry.ts +55 -0
  74. package/packages/cli-plugin-sdk/src/types.ts +32 -0
  75. package/packages/clipboard/dist/src/clipboard.d.ts +11 -0
  76. package/packages/clipboard/dist/src/clipboard.js +51 -0
  77. package/packages/clipboard/dist/src/copy-sync.d.ts +27 -0
  78. package/packages/clipboard/dist/src/copy-sync.js +170 -0
  79. package/packages/clipboard/dist/src/gist-relay.d.ts +48 -0
  80. package/packages/clipboard/dist/src/gist-relay.js +186 -0
  81. package/packages/clipboard/dist/src/github-login.d.ts +16 -0
  82. package/packages/clipboard/dist/src/github-login.js +69 -0
  83. package/packages/clipboard/dist/src/index.d.ts +4 -0
  84. package/packages/clipboard/dist/src/index.js +3 -0
  85. package/packages/clipboard/dist/src/types.d.ts +13 -0
  86. package/packages/clipboard/dist/src/types.js +5 -0
  87. package/packages/clipboard/src/clipboard.ts +59 -0
  88. package/packages/clipboard/src/copy-sync.ts +201 -0
  89. package/packages/clipboard/src/gist-relay.ts +240 -0
  90. package/packages/clipboard/src/github-login.ts +107 -0
  91. package/packages/clipboard/src/index.ts +3 -0
  92. package/packages/clipboard/src/types.ts +14 -0
  93. package/packages/code-generation/src/faker.ts +461 -0
  94. package/packages/code-generation/src/generator.ts +421 -0
  95. package/packages/code-generation/src/index.ts +56 -0
  96. package/packages/code-generation/src/templates/ejs-renderer.ts +142 -0
  97. package/packages/code-generation/src/templates/registry.ts +174 -0
  98. package/packages/code-generation/src/types.ts +373 -0
  99. package/packages/code-review/src/engine.ts +408 -0
  100. package/packages/code-review/src/index.ts +46 -0
  101. package/packages/code-review/src/reports/html.ts +143 -0
  102. package/packages/code-review/src/reports/markdown.ts +197 -0
  103. package/packages/code-review/src/reports/text.ts +171 -0
  104. package/packages/code-review/src/types.ts +324 -0
  105. package/packages/codex-adapter/src/executor.ts +83 -0
  106. package/packages/codex-adapter/src/index.ts +16 -0
  107. package/packages/codex-adapter/src/provider.ts +213 -0
  108. package/packages/codex-adapter/src/types.ts +118 -0
  109. package/packages/config-capture/src/index.ts +357 -0
  110. package/packages/context-compiler/src/budget.ts +122 -0
  111. package/packages/context-compiler/src/cache.ts +134 -0
  112. package/packages/context-compiler/src/compiler.ts +314 -0
  113. package/packages/context-compiler/src/deduplicate.ts +171 -0
  114. package/packages/context-compiler/src/filter.ts +135 -0
  115. package/packages/context-compiler/src/index.ts +61 -0
  116. package/packages/context-compiler/src/okf-loader.ts +86 -0
  117. package/packages/context-compiler/src/score.ts +130 -0
  118. package/packages/context-compiler/src/types.ts +246 -0
  119. package/packages/context-discovery/dist/src/discover.d.ts +3 -0
  120. package/packages/context-discovery/dist/src/discover.js +42 -0
  121. package/packages/context-discovery/dist/src/discovery.d.ts +28 -0
  122. package/packages/context-discovery/dist/src/discovery.js +21 -0
  123. package/packages/context-discovery/dist/src/index.d.ts +3 -0
  124. package/packages/context-discovery/dist/src/index.js +2 -0
  125. package/packages/context-discovery/dist/src/types.d.ts +16 -0
  126. package/packages/context-discovery/dist/src/types.js +2 -0
  127. package/packages/context-discovery/src/discover.ts +42 -0
  128. package/packages/context-discovery/src/discovery.ts +44 -0
  129. package/packages/context-discovery/src/index.ts +2 -0
  130. package/packages/context-discovery/src/types.ts +15 -0
  131. package/packages/context-manager/src/compaction.ts +139 -0
  132. package/packages/context-manager/src/core.ts +85 -0
  133. package/packages/context-manager/src/index.ts +22 -0
  134. package/packages/context-manager/src/types.ts +44 -0
  135. package/packages/cookie-sanitizer/src/atomic-write.ts +79 -0
  136. package/packages/cookie-sanitizer/src/detect-format.ts +102 -0
  137. package/packages/cookie-sanitizer/src/index.ts +89 -0
  138. package/packages/cookie-sanitizer/src/infer-provider.ts +103 -0
  139. package/packages/cookie-sanitizer/src/normalize.ts +92 -0
  140. package/packages/cookie-sanitizer/src/parse-json.ts +122 -0
  141. package/packages/cookie-sanitizer/src/parse-netscape.ts +118 -0
  142. package/packages/cookie-sanitizer/src/sync.ts +312 -0
  143. package/packages/cookie-sanitizer/src/types.ts +101 -0
  144. package/packages/cookie-sanitizer/src/watcher.ts +180 -0
  145. package/packages/cost-optimizer/src/budget.ts +138 -0
  146. package/packages/cost-optimizer/src/config.ts +34 -0
  147. package/packages/cost-optimizer/src/forecast.ts +59 -0
  148. package/packages/cost-optimizer/src/index.ts +74 -0
  149. package/packages/cost-optimizer/src/optimizer.ts +277 -0
  150. package/packages/cost-optimizer/src/selection.ts +264 -0
  151. package/packages/cost-optimizer/src/tracker.ts +122 -0
  152. package/packages/cost-optimizer/src/types.ts +134 -0
  153. package/packages/dependency-analyzer/dist/src/analyzer.d.ts +17 -0
  154. package/packages/dependency-analyzer/dist/src/analyzer.js +119 -0
  155. package/packages/dependency-analyzer/dist/src/imports.d.ts +12 -0
  156. package/packages/dependency-analyzer/dist/src/imports.js +73 -0
  157. package/packages/dependency-analyzer/dist/src/index.d.ts +4 -0
  158. package/packages/dependency-analyzer/dist/src/index.js +3 -0
  159. package/packages/dependency-analyzer/dist/src/types.d.ts +28 -0
  160. package/packages/dependency-analyzer/dist/src/types.js +5 -0
  161. package/packages/dependency-analyzer/src/analyzer.ts +140 -0
  162. package/packages/dependency-analyzer/src/imports.ts +93 -0
  163. package/packages/dependency-analyzer/src/index.ts +9 -0
  164. package/packages/dependency-analyzer/src/types.ts +38 -0
  165. package/packages/django-plugin/src/analyzer.ts +284 -0
  166. package/packages/django-plugin/src/index.ts +39 -0
  167. package/packages/django-plugin/src/types.ts +35 -0
  168. package/packages/doc-generator/src/detector.ts +113 -0
  169. package/packages/doc-generator/src/docs.ts +158 -0
  170. package/packages/doc-generator/src/index.ts +7 -0
  171. package/packages/doc-generator/src/types.ts +58 -0
  172. package/packages/evaluation-engine/src/engine.ts +488 -0
  173. package/packages/evaluation-engine/src/index.ts +23 -0
  174. package/packages/evaluation-engine/src/types.ts +136 -0
  175. package/packages/evaluation-runner/src/index.ts +6 -0
  176. package/packages/evaluation-runner/src/runner.ts +182 -0
  177. package/packages/evaluation-runner/src/types.ts +51 -0
  178. package/packages/event-bus/dist/src/bus.d.ts +15 -0
  179. package/packages/event-bus/dist/src/bus.js +98 -0
  180. package/packages/event-bus/dist/src/herdr-bus.d.ts +121 -0
  181. package/packages/event-bus/dist/src/herdr-bus.js +322 -0
  182. package/packages/event-bus/dist/src/index.d.ts +6 -0
  183. package/packages/event-bus/dist/src/index.js +4 -0
  184. package/packages/event-bus/dist/src/types.d.ts +27 -0
  185. package/packages/event-bus/dist/src/types.js +10 -0
  186. package/packages/event-bus/src/bus.ts +111 -0
  187. package/packages/event-bus/src/herdr-bus.ts +525 -0
  188. package/packages/event-bus/src/index.ts +38 -0
  189. package/packages/event-bus/src/types.ts +59 -0
  190. package/packages/event-store/dist/src/index.d.ts +3 -0
  191. package/packages/event-store/dist/src/index.js +2 -0
  192. package/packages/event-store/dist/src/store.d.ts +15 -0
  193. package/packages/event-store/dist/src/store.js +139 -0
  194. package/packages/event-store/dist/src/types.d.ts +48 -0
  195. package/packages/event-store/dist/src/types.js +5 -0
  196. package/packages/event-store/src/index.ts +11 -0
  197. package/packages/event-store/src/store.ts +168 -0
  198. package/packages/event-store/src/types.d.ts +48 -0
  199. package/packages/event-store/src/types.js +5 -0
  200. package/packages/event-store/src/types.ts +65 -0
  201. package/packages/experience-replay/src/index.ts +19 -0
  202. package/packages/experience-replay/src/replay.ts +348 -0
  203. package/packages/experience-replay/src/types.ts +128 -0
  204. package/packages/feedback-collector/src/collector.ts +160 -0
  205. package/packages/feedback-collector/src/index.ts +6 -0
  206. package/packages/feedback-collector/src/types.ts +51 -0
  207. package/packages/framework-detector/src/detector.ts +586 -0
  208. package/packages/framework-detector/src/index.ts +46 -0
  209. package/packages/framework-detector/src/signatures/registry.ts +648 -0
  210. package/packages/framework-detector/src/types.ts +299 -0
  211. package/packages/framework-plugin-sdk/src/index.ts +45 -0
  212. package/packages/framework-plugin-sdk/src/manager.ts +525 -0
  213. package/packages/framework-plugin-sdk/src/types.ts +449 -0
  214. package/packages/frappe-plugin/src/analyzer.ts +454 -0
  215. package/packages/frappe-plugin/src/index.ts +72 -0
  216. package/packages/frappe-plugin/src/types.ts +135 -0
  217. package/packages/generic-web-plugin/src/analyzer.ts +347 -0
  218. package/packages/generic-web-plugin/src/index.ts +61 -0
  219. package/packages/generic-web-plugin/src/types.ts +41 -0
  220. package/packages/health-monitor/src/index.ts +16 -0
  221. package/packages/health-monitor/src/monitor.ts +216 -0
  222. package/packages/health-monitor/src/types.ts +45 -0
  223. package/packages/intent-analyzer/dist/src/analyzer.d.ts +13 -0
  224. package/packages/intent-analyzer/dist/src/analyzer.js +239 -0
  225. package/packages/intent-analyzer/dist/src/index.d.ts +3 -0
  226. package/packages/intent-analyzer/dist/src/index.js +2 -0
  227. package/packages/intent-analyzer/dist/src/types.d.ts +26 -0
  228. package/packages/intent-analyzer/dist/src/types.js +7 -0
  229. package/packages/intent-analyzer/src/analyzer.ts +259 -0
  230. package/packages/intent-analyzer/src/index.ts +8 -0
  231. package/packages/intent-analyzer/src/types.ts +44 -0
  232. package/packages/knowledge-retrieval/src/index.ts +18 -0
  233. package/packages/knowledge-retrieval/src/mcp-client.ts +212 -0
  234. package/packages/knowledge-retrieval/src/types.ts +112 -0
  235. package/packages/laravel-plugin/src/analyzer.ts +323 -0
  236. package/packages/laravel-plugin/src/index.ts +40 -0
  237. package/packages/laravel-plugin/src/types.ts +24 -0
  238. package/packages/learning-engine/src/engine.ts +391 -0
  239. package/packages/learning-engine/src/index.ts +26 -0
  240. package/packages/learning-engine/src/types.ts +201 -0
  241. package/packages/mcp-adapter/src/index.ts +20 -0
  242. package/packages/mcp-adapter/src/server.ts +273 -0
  243. package/packages/mcp-adapter/src/tools.ts +220 -0
  244. package/packages/mcp-adapter/src/types.ts +79 -0
  245. package/packages/memory-engine/src/engine.ts +615 -0
  246. package/packages/memory-engine/src/index.ts +20 -0
  247. package/packages/memory-engine/src/types.ts +159 -0
  248. package/packages/model-registry/src/cost.ts +80 -0
  249. package/packages/model-registry/src/defaults.ts +178 -0
  250. package/packages/model-registry/src/index.ts +57 -0
  251. package/packages/model-registry/src/query.ts +85 -0
  252. package/packages/model-registry/src/registry.ts +188 -0
  253. package/packages/model-registry/src/types.d.ts +63 -0
  254. package/packages/model-registry/src/types.js +5 -0
  255. package/packages/model-registry/src/types.ts +69 -0
  256. package/packages/nextjs-plugin/src/analyzer.ts +247 -0
  257. package/packages/nextjs-plugin/src/index.ts +41 -0
  258. package/packages/nextjs-plugin/src/types.ts +36 -0
  259. package/packages/notification/src/adapters/email-adapter.ts +126 -0
  260. package/packages/notification/src/adapters/ntfy-adapter.ts +100 -0
  261. package/packages/notification/src/adapters/telegram-adapter.ts +107 -0
  262. package/packages/notification/src/adapters/webhook-adapter.ts +75 -0
  263. package/packages/notification/src/base-adapter.ts +75 -0
  264. package/packages/notification/src/index.ts +9 -0
  265. package/packages/notification/src/notification-center.ts +286 -0
  266. package/packages/notification/src/types.ts +89 -0
  267. package/packages/observability/src/alerts.ts +355 -0
  268. package/packages/observability/src/health.ts +325 -0
  269. package/packages/observability/src/index.ts +79 -0
  270. package/packages/observability/src/logger.ts +373 -0
  271. package/packages/observability/src/metrics.ts +475 -0
  272. package/packages/observability/src/tracer.ts +336 -0
  273. package/packages/observability/src/types.ts +391 -0
  274. package/packages/okf-indexer/src/cli.ts +25 -0
  275. package/packages/okf-indexer/src/indexer.ts +186 -0
  276. package/packages/performance-optimizer/src/index.ts +20 -0
  277. package/packages/performance-optimizer/src/optimizer.ts +428 -0
  278. package/packages/performance-optimizer/src/types.ts +112 -0
  279. package/packages/privilege-broker/src/approval.ts +70 -0
  280. package/packages/privilege-broker/src/audit.ts +142 -0
  281. package/packages/privilege-broker/src/executor.ts +110 -0
  282. package/packages/privilege-broker/src/index.ts +46 -0
  283. package/packages/privilege-broker/src/registry.ts +98 -0
  284. package/packages/privilege-broker/src/types.ts +105 -0
  285. package/packages/project-analyzer/src/analyzer.ts +683 -0
  286. package/packages/project-analyzer/src/cache.ts +329 -0
  287. package/packages/project-analyzer/src/command-discovery.ts +239 -0
  288. package/packages/project-analyzer/src/index.ts +123 -0
  289. package/packages/project-analyzer/src/plugins/index.ts +16 -0
  290. package/packages/project-analyzer/src/rule-discovery.ts +282 -0
  291. package/packages/project-analyzer/src/signals.ts +355 -0
  292. package/packages/project-analyzer/src/types.ts +412 -0
  293. package/packages/project-analyzer/src/walker.ts +366 -0
  294. package/packages/projection-engine/dist/src/engine.d.ts +61 -0
  295. package/packages/projection-engine/dist/src/engine.js +87 -0
  296. package/packages/projection-engine/dist/src/index.d.ts +2 -0
  297. package/packages/projection-engine/dist/src/index.js +2 -0
  298. package/packages/projection-engine/dist/src/project.d.ts +3 -0
  299. package/packages/projection-engine/dist/src/project.js +24 -0
  300. package/packages/projection-engine/dist/src/types.d.ts +55 -0
  301. package/packages/projection-engine/dist/src/types.js +5 -0
  302. package/packages/projection-engine/src/engine.ts +134 -0
  303. package/packages/projection-engine/src/index.ts +8 -0
  304. package/packages/projection-engine/src/project.ts +24 -0
  305. package/packages/projection-engine/src/types.d.ts +55 -0
  306. package/packages/projection-engine/src/types.js +5 -0
  307. package/packages/projection-engine/src/types.ts +60 -0
  308. package/packages/prompt-compiler/src/budget.ts +170 -0
  309. package/packages/prompt-compiler/src/compiler.ts +188 -0
  310. package/packages/prompt-compiler/src/deduplicate.ts +84 -0
  311. package/packages/prompt-compiler/src/index.ts +50 -0
  312. package/packages/prompt-compiler/src/normalize.ts +140 -0
  313. package/packages/prompt-compiler/src/render.ts +105 -0
  314. package/packages/prompt-compiler/src/section-builder.ts +279 -0
  315. package/packages/prompt-compiler/src/types.ts +263 -0
  316. package/packages/prompt-compiler/src/validate.ts +157 -0
  317. package/packages/prompt-versioning/src/index.ts +6 -0
  318. package/packages/prompt-versioning/src/types.ts +41 -0
  319. package/packages/prompt-versioning/src/versioning.ts +149 -0
  320. package/packages/provider-adapter-sdk/dist/src/builder.d.ts +140 -0
  321. package/packages/provider-adapter-sdk/dist/src/builder.js +332 -0
  322. package/packages/provider-adapter-sdk/dist/src/errors.d.ts +71 -0
  323. package/packages/provider-adapter-sdk/dist/src/errors.js +111 -0
  324. package/packages/provider-adapter-sdk/dist/src/index.d.ts +15 -0
  325. package/packages/provider-adapter-sdk/dist/src/index.js +19 -0
  326. package/packages/provider-adapter-sdk/dist/src/registry.d.ts +108 -0
  327. package/packages/provider-adapter-sdk/dist/src/registry.js +301 -0
  328. package/packages/provider-adapter-sdk/dist/src/tester.d.ts +71 -0
  329. package/packages/provider-adapter-sdk/dist/src/tester.js +392 -0
  330. package/packages/provider-adapter-sdk/dist/src/types.d.ts +182 -0
  331. package/packages/provider-adapter-sdk/dist/src/types.js +11 -0
  332. package/packages/provider-adapter-sdk/src/builder.ts +442 -0
  333. package/packages/provider-adapter-sdk/src/errors.ts +153 -0
  334. package/packages/provider-adapter-sdk/src/index.ts +84 -0
  335. package/packages/provider-adapter-sdk/src/registry.ts +486 -0
  336. package/packages/provider-adapter-sdk/src/tester.ts +483 -0
  337. package/packages/provider-adapter-sdk/src/types.ts +293 -0
  338. package/packages/provider-router/dist/capability-registry/src/types.d.ts +47 -0
  339. package/packages/provider-router/dist/capability-registry/src/types.js +10 -0
  340. package/packages/provider-router/dist/provider-router/src/index.d.ts +23 -0
  341. package/packages/provider-router/dist/provider-router/src/index.js +25 -0
  342. package/packages/provider-router/dist/provider-router/src/policy.d.ts +10 -0
  343. package/packages/provider-router/dist/provider-router/src/policy.js +45 -0
  344. package/packages/provider-router/dist/provider-router/src/provider-router.d.ts +56 -0
  345. package/packages/provider-router/dist/provider-router/src/provider-router.js +222 -0
  346. package/packages/provider-router/dist/provider-router/src/strategies.d.ts +19 -0
  347. package/packages/provider-router/dist/provider-router/src/strategies.js +110 -0
  348. package/packages/provider-router/dist/provider-router/src/types.d.ts +91 -0
  349. package/packages/provider-router/dist/provider-router/src/types.js +10 -0
  350. package/packages/provider-router/dist/src/index.d.ts +23 -0
  351. package/packages/provider-router/dist/src/index.js +25 -0
  352. package/packages/provider-router/dist/src/policy.d.ts +10 -0
  353. package/packages/provider-router/dist/src/policy.js +45 -0
  354. package/packages/provider-router/dist/src/provider-router.d.ts +56 -0
  355. package/packages/provider-router/dist/src/provider-router.js +222 -0
  356. package/packages/provider-router/dist/src/strategies.d.ts +19 -0
  357. package/packages/provider-router/dist/src/strategies.js +110 -0
  358. package/packages/provider-router/dist/src/types.d.ts +91 -0
  359. package/packages/provider-router/dist/src/types.js +10 -0
  360. package/packages/provider-router/dist/types/src/runtime-types.d.ts +412 -0
  361. package/packages/provider-router/dist/types/src/runtime-types.js +2 -0
  362. package/packages/provider-router/src/index.ts +49 -0
  363. package/packages/provider-router/src/policy.ts +50 -0
  364. package/packages/provider-router/src/provider-router.ts +315 -0
  365. package/packages/provider-router/src/strategies.ts +158 -0
  366. package/packages/provider-router/src/types.ts +130 -0
  367. package/packages/provider-selector/src/index.ts +13 -0
  368. package/packages/provider-selector/src/selector.ts +120 -0
  369. package/packages/provider-selector/src/types.ts +33 -0
  370. package/packages/providers/dist/src/adapters.d.ts +133 -0
  371. package/packages/providers/dist/src/adapters.js +236 -0
  372. package/packages/providers/dist/src/deepagents-adapter.d.ts +78 -0
  373. package/packages/providers/dist/src/deepagents-adapter.js +323 -0
  374. package/packages/providers/dist/src/glm-usage.d.ts +102 -0
  375. package/packages/providers/dist/src/glm-usage.js +197 -0
  376. package/packages/providers/dist/src/index.d.ts +11 -0
  377. package/packages/providers/dist/src/index.js +11 -0
  378. package/packages/providers/dist/src/openai-usage.d.ts +103 -0
  379. package/packages/providers/dist/src/openai-usage.js +208 -0
  380. package/packages/providers/dist/src/provider-id.d.ts +46 -0
  381. package/packages/providers/dist/src/provider-id.js +113 -0
  382. package/packages/providers/src/adapters.ts +362 -0
  383. package/packages/providers/src/deepagents-adapter.ts +458 -0
  384. package/packages/providers/src/glm-usage.ts +248 -0
  385. package/packages/providers/src/index.ts +11 -0
  386. package/packages/providers/src/openai-usage.ts +263 -0
  387. package/packages/providers/src/provider-id.ts +129 -0
  388. package/packages/quota-manager/dist/src/examples/tui-usage-integration.d.ts +35 -0
  389. package/packages/quota-manager/dist/src/examples/tui-usage-integration.js +73 -0
  390. package/packages/quota-manager/dist/src/index.d.ts +8 -0
  391. package/packages/quota-manager/dist/src/index.js +8 -0
  392. package/packages/quota-manager/dist/src/quota-manager.d.ts +70 -0
  393. package/packages/quota-manager/dist/src/quota-manager.js +260 -0
  394. package/packages/quota-manager/dist/src/tui-usage-monitor.d.ts +96 -0
  395. package/packages/quota-manager/dist/src/tui-usage-monitor.js +268 -0
  396. package/packages/quota-manager/src/examples/tui-usage-integration.ts +72 -0
  397. package/packages/quota-manager/src/index.ts +8 -0
  398. package/packages/quota-manager/src/quota-manager.ts +336 -0
  399. package/packages/quota-manager/src/tui-usage-monitor.ts +355 -0
  400. package/packages/rate-limiter/src/index.ts +6 -0
  401. package/packages/rate-limiter/src/limiter.ts +122 -0
  402. package/packages/rate-limiter/src/types.ts +41 -0
  403. package/packages/react-vite-plugin/src/analyzer.ts +226 -0
  404. package/packages/react-vite-plugin/src/index.ts +39 -0
  405. package/packages/react-vite-plugin/src/types.ts +28 -0
  406. package/packages/release-manager/src/changelog.ts +148 -0
  407. package/packages/release-manager/src/index.ts +21 -0
  408. package/packages/release-manager/src/types.ts +50 -0
  409. package/packages/release-manager/src/version.ts +52 -0
  410. package/packages/requirement-compiler/src/ambiguity-detector.ts +302 -0
  411. package/packages/requirement-compiler/src/classifier.ts +145 -0
  412. package/packages/requirement-compiler/src/compiler.ts +328 -0
  413. package/packages/requirement-compiler/src/extractor.ts +155 -0
  414. package/packages/requirement-compiler/src/index.ts +36 -0
  415. package/packages/requirement-compiler/src/normalizer.ts +161 -0
  416. package/packages/requirement-compiler/src/risk-detector.ts +58 -0
  417. package/packages/requirement-compiler/src/types.ts +596 -0
  418. package/packages/runtime/dist/src/command-executor.d.ts +129 -0
  419. package/packages/runtime/dist/src/command-executor.js +383 -0
  420. package/packages/runtime/dist/src/index.d.ts +11 -0
  421. package/packages/runtime/dist/src/index.js +11 -0
  422. package/packages/runtime/dist/src/local-runtime-agent.d.ts +111 -0
  423. package/packages/runtime/dist/src/local-runtime-agent.js +356 -0
  424. package/packages/runtime/dist/src/policy-engine.d.ts +203 -0
  425. package/packages/runtime/dist/src/policy-engine.js +592 -0
  426. package/packages/runtime/dist/src/runtime-api.d.ts +137 -0
  427. package/packages/runtime/dist/src/runtime-api.js +454 -0
  428. package/packages/runtime/dist/src/workspace-manager.d.ts +162 -0
  429. package/packages/runtime/dist/src/workspace-manager.js +451 -0
  430. package/packages/runtime/src/command-executor.ts +523 -0
  431. package/packages/runtime/src/index.ts +11 -0
  432. package/packages/runtime/src/local-runtime-agent.ts +480 -0
  433. package/packages/runtime/src/policy-engine.ts +813 -0
  434. package/packages/runtime/src/runtime-api.ts +665 -0
  435. package/packages/runtime/src/workspace-manager.ts +591 -0
  436. package/packages/scheduler/src/scheduler.ts +50 -0
  437. package/packages/scheduler-adapter/src/cron.ts +123 -0
  438. package/packages/scheduler-adapter/src/index.ts +9 -0
  439. package/packages/scheduler-adapter/src/interface.ts +61 -0
  440. package/packages/scheduler-adapter/src/internal.ts +99 -0
  441. package/packages/scheduler-adapter/src/systemd.ts +221 -0
  442. package/packages/session/src/history.ts +353 -0
  443. package/packages/session/src/index.ts +53 -0
  444. package/packages/session/src/manager.ts +481 -0
  445. package/packages/session/src/policy.ts +363 -0
  446. package/packages/session/src/store.ts +348 -0
  447. package/packages/session/src/types.ts +275 -0
  448. package/packages/session-api/dist/src/api.d.ts +83 -0
  449. package/packages/session-api/dist/src/api.js +49 -0
  450. package/packages/session-api/dist/src/index.d.ts +2 -0
  451. package/packages/session-api/dist/src/index.js +2 -0
  452. package/packages/session-api/dist/src/types.d.ts +22 -0
  453. package/packages/session-api/dist/src/types.js +5 -0
  454. package/packages/session-api/src/api.ts +117 -0
  455. package/packages/session-api/src/index.ts +1 -0
  456. package/packages/session-api/src/types.ts +23 -0
  457. package/packages/session-export/dist/src/exporter.d.ts +28 -0
  458. package/packages/session-export/dist/src/exporter.js +42 -0
  459. package/packages/session-export/dist/src/index.d.ts +2 -0
  460. package/packages/session-export/dist/src/index.js +2 -0
  461. package/packages/session-export/dist/src/types.d.ts +20 -0
  462. package/packages/session-export/dist/src/types.js +5 -0
  463. package/packages/session-export/src/exporter.ts +81 -0
  464. package/packages/session-export/src/index.ts +1 -0
  465. package/packages/session-export/src/types.ts +22 -0
  466. package/packages/shared-context/src/index.ts +7 -0
  467. package/packages/shared-context/src/shared-context.ts +42 -0
  468. package/packages/skill-registry/src/defaults.ts +146 -0
  469. package/packages/skill-registry/src/index.ts +48 -0
  470. package/packages/skill-registry/src/matching.ts +118 -0
  471. package/packages/skill-registry/src/registry.ts +211 -0
  472. package/packages/skill-registry/src/types.ts +97 -0
  473. package/packages/sprint-planner/src/decomposer.ts +57 -0
  474. package/packages/sprint-planner/src/index.ts +16 -0
  475. package/packages/sprint-planner/src/planner.ts +150 -0
  476. package/packages/sprint-planner/src/types.ts +59 -0
  477. package/packages/subscription-engine/dist/src/engine.d.ts +13 -0
  478. package/packages/subscription-engine/dist/src/engine.js +40 -0
  479. package/packages/subscription-engine/dist/src/index.d.ts +2 -0
  480. package/packages/subscription-engine/dist/src/index.js +2 -0
  481. package/packages/subscription-engine/dist/src/subscriptions.d.ts +19 -0
  482. package/packages/subscription-engine/dist/src/subscriptions.js +39 -0
  483. package/packages/subscription-engine/dist/src/types.d.ts +24 -0
  484. package/packages/subscription-engine/dist/src/types.js +5 -0
  485. package/packages/subscription-engine/src/engine.ts +55 -0
  486. package/packages/subscription-engine/src/index.ts +6 -0
  487. package/packages/subscription-engine/src/subscriptions.ts +55 -0
  488. package/packages/subscription-engine/src/types.ts +27 -0
  489. package/packages/task-compiler/src/command-policy.ts +193 -0
  490. package/packages/task-compiler/src/compiler.ts +114 -0
  491. package/packages/task-compiler/src/decompose.ts +265 -0
  492. package/packages/task-compiler/src/file-scope.ts +240 -0
  493. package/packages/task-compiler/src/graph.ts +144 -0
  494. package/packages/task-compiler/src/index.ts +38 -0
  495. package/packages/task-compiler/src/types.ts +225 -0
  496. package/packages/task-compiler/src/validate.ts +218 -0
  497. package/packages/task-compiler/src/verification.ts +248 -0
  498. package/packages/tencentdb-memory/src/client.ts +130 -0
  499. package/packages/tencentdb-memory/src/index.ts +32 -0
  500. package/packages/tencentdb-memory/src/loader.ts +150 -0
  501. package/packages/tencentdb-memory/src/mcp-tools.ts +213 -0
  502. package/packages/tencentdb-memory/src/types.ts +101 -0
  503. package/packages/tencentdb-sync/src/cli.ts +363 -0
  504. package/packages/tencentdb-sync/src/client.ts +268 -0
  505. package/packages/tencentdb-sync/src/config.ts +139 -0
  506. package/packages/tencentdb-sync/src/index.ts +15 -0
  507. package/packages/test-data-generator/src/faker-adapter.ts +657 -0
  508. package/packages/test-data-generator/src/generator.ts +461 -0
  509. package/packages/test-data-generator/src/index.ts +48 -0
  510. package/packages/test-data-generator/src/types.ts +421 -0
  511. package/packages/test-generator/src/generator.ts +144 -0
  512. package/packages/test-generator/src/index.ts +11 -0
  513. package/packages/test-generator/src/types.ts +39 -0
  514. package/packages/todo-bd-sync/src/detector.ts +171 -0
  515. package/packages/todo-bd-sync/src/extension.ts +129 -0
  516. package/packages/todo-bd-sync/src/index.ts +401 -0
  517. package/packages/todo-bd-sync/src/sync.ts +322 -0
  518. package/packages/todo-bd-sync/src/task-analyzer.ts +314 -0
  519. package/packages/todo-bd-sync/src/todo-reminder.ts +418 -0
  520. package/packages/todo-bd-sync/src/types.ts +137 -0
  521. package/packages/token-estimation/src/index.ts +192 -0
  522. package/packages/token-optimizer/src/index.ts +15 -0
  523. package/packages/token-optimizer/src/optimizer.ts +150 -0
  524. package/packages/token-optimizer/src/types.ts +47 -0
  525. package/packages/types/src/agent-worker-types.d.ts +206 -0
  526. package/packages/types/src/agent-worker-types.js +41 -0
  527. package/packages/types/src/agent-worker-types.ts +264 -0
  528. package/packages/types/src/ai-providers.d.ts +36 -0
  529. package/packages/types/src/ai-providers.js +66 -0
  530. package/packages/types/src/ai-providers.ts +73 -0
  531. package/packages/types/src/runtime-types.d.ts +418 -0
  532. package/packages/types/src/runtime-types.js +3 -0
  533. package/packages/types/src/runtime-types.ts +588 -0
  534. package/packages/workflow-events/dist/src/events.d.ts +38 -0
  535. package/packages/workflow-events/dist/src/events.js +55 -0
  536. package/packages/workflow-events/dist/src/index.d.ts +2 -0
  537. package/packages/workflow-events/dist/src/index.js +2 -0
  538. package/packages/workflow-events/dist/src/pipeline.d.ts +21 -0
  539. package/packages/workflow-events/dist/src/pipeline.js +36 -0
  540. package/packages/workflow-events/dist/src/types.d.ts +110 -0
  541. package/packages/workflow-events/dist/src/types.js +5 -0
  542. package/packages/workflow-events/src/events.ts +86 -0
  543. package/packages/workflow-events/src/index.ts +19 -0
  544. package/packages/workflow-events/src/pipeline.ts +41 -0
  545. package/packages/workflow-events/src/types.d.ts +110 -0
  546. package/packages/workflow-events/src/types.js +5 -0
  547. package/packages/workflow-events/src/types.ts +139 -0
  548. package/packages/workspace-scanner/dist/src/detect.d.ts +3 -0
  549. package/packages/workspace-scanner/dist/src/detect.js +60 -0
  550. package/packages/workspace-scanner/dist/src/git.d.ts +7 -0
  551. package/packages/workspace-scanner/dist/src/git.js +75 -0
  552. package/packages/workspace-scanner/dist/src/index.d.ts +5 -0
  553. package/packages/workspace-scanner/dist/src/index.js +4 -0
  554. package/packages/workspace-scanner/dist/src/scanner.d.ts +11 -0
  555. package/packages/workspace-scanner/dist/src/scanner.js +59 -0
  556. package/packages/workspace-scanner/dist/src/types.d.ts +35 -0
  557. package/packages/workspace-scanner/dist/src/types.js +5 -0
  558. package/packages/workspace-scanner/src/detect.ts +77 -0
  559. package/packages/workspace-scanner/src/git.ts +83 -0
  560. package/packages/workspace-scanner/src/index.ts +9 -0
  561. package/packages/workspace-scanner/src/scanner.ts +73 -0
  562. package/packages/workspace-scanner/src/types.ts +48 -0
  563. package/packages/worktree/dist/src/index.d.ts +7 -0
  564. package/packages/worktree/dist/src/index.js +7 -0
  565. package/packages/worktree/dist/src/worktree.d.ts +88 -0
  566. package/packages/worktree/dist/src/worktree.js +239 -0
  567. package/packages/worktree/src/index.ts +7 -0
  568. package/packages/worktree/src/worktree.ts +290 -0
  569. package/packages/write-review/src/blackboard.ts +249 -0
  570. package/packages/write-review/src/gate.ts +169 -0
  571. package/packages/write-review/src/index.ts +18 -0
  572. package/packages/write-review/src/injection.ts +170 -0
  573. package/packages/write-review/src/review.ts +206 -0
  574. package/packages/write-review/src/trigger.ts +133 -0
  575. package/packages/write-review/src/types.ts +90 -0
  576. package/proactive-compact.ts +90 -0
  577. package/prompts/tencentdb-connect.md +35 -0
  578. package/prompts/tencentdb-setup.md +101 -0
  579. package/prompts/tencentdb.md +88 -0
  580. package/renderer.ts +205 -0
  581. package/skills/harness-runtime/SKILL.md +237 -0
  582. package/status-parsers.ts +84 -0
  583. package/tracker.ts +72 -0
  584. package/windows.ts +121 -0
@@ -0,0 +1,347 @@
1
+ /**
2
+ * Generic Web Plugin — Analyzer (RFC-0066)
3
+ *
4
+ * Detects and deeply analyzes generic web projects.
5
+ */
6
+
7
+ import { existsSync } from "node:fs";
8
+ import { readdir, readFile, stat } from "node:fs/promises";
9
+ import { join, extname } from "node:path";
10
+ import type {
11
+ GenericWebAnalysis,
12
+ WebFrameworkType,
13
+ PageRoute,
14
+ ApiEndpoint,
15
+ } from "./types.js";
16
+
17
+ // --- Detection ----------------------------------------------------------------
18
+
19
+ /**
20
+ * Detect if a directory is a generic web project
21
+ */
22
+ export async function detectWeb(root: string): Promise<boolean> {
23
+ const hasPackageJson = existsSync(join(root, "package.json"));
24
+ const hasNodeModules = existsSync(join(root, "node_modules"));
25
+ const hasSrc =
26
+ existsSync(join(root, "src")) ||
27
+ existsSync(join(root, "app")) ||
28
+ existsSync(join(root, "pages")) ||
29
+ existsSync(join(root, "components"));
30
+ return hasPackageJson && (hasNodeModules || hasSrc);
31
+ }
32
+
33
+ // --- Framework Detection ----------------------------------------------------
34
+
35
+ async function detectFramework(root: string): Promise<WebFrameworkType> {
36
+ const pkgJson = await readFile(join(root, "package.json"), "utf-8").catch(
37
+ () => "{}",
38
+ );
39
+ const pkg = JSON.parse(pkgJson);
40
+ const deps = { ...pkg.dependencies, ...pkg.devDependencies };
41
+ const scripts: Record<string, string> = pkg.scripts || {};
42
+
43
+ if (deps["next"]) return "next";
44
+ if (deps["@remix-run/react"]) return "remix";
45
+ if (deps["astro"]) return "astro";
46
+ if (deps["nuxt"]) return "nuxt";
47
+ if (deps["svelte"]) return "svelte";
48
+ if (deps["vite"] && deps["react"]) return "react-vite";
49
+ if (deps["vite"] && deps["vue"]) return "vue-vite";
50
+ if (deps["webpack"]) return "webpack";
51
+ if (deps["express"]) return "express";
52
+ if (deps["fastify"]) return "fastify";
53
+ if (deps["koa"]) return "koa";
54
+ if (deps["hono"]) return "hono";
55
+ if (deps["flask"]) return "flask";
56
+ if (deps["django"]) return "django";
57
+ if (deps["rails"] || deps["@rails/ujs"]) return "rails";
58
+ if (deps["laravel-mix"] || deps["laravel"]) return "laravel";
59
+ if (scripts["nuxt"] || scripts["nuxt:build"]) return "nuxt";
60
+ if (scripts["astro"] || scripts["astro:build"]) return "astro";
61
+
62
+ return "static";
63
+ }
64
+
65
+ // --- Route Scanning ---------------------------------------------------------
66
+
67
+ async function findRouteFiles(
68
+ root: string,
69
+ framework: WebFrameworkType,
70
+ ): Promise<PageRoute[]> {
71
+ const routes: PageRoute[] = [];
72
+ const patterns = getRoutePatterns(framework);
73
+
74
+ for (const { dir, exts } of patterns) {
75
+ const fullDir = join(root, dir);
76
+ if (!existsSync(fullDir)) continue;
77
+
78
+ await scanDir(fullDir, fullDir, exts, (filePath, relPath) => {
79
+ const path = relPath
80
+ .replace(/\\/g, "/")
81
+ .replace(new RegExp(`\\${exts[0]}$`), "")
82
+ .replace(/\/index$/, "")
83
+ .replace(/^\//, "");
84
+
85
+ const route: PageRoute = {
86
+ path: path || "/",
87
+ file: filePath,
88
+ component: guessComponentName(framework, path),
89
+ };
90
+ routes.push(route);
91
+ });
92
+ }
93
+
94
+ return deduplicateRoutes(routes);
95
+ }
96
+
97
+ interface RoutePattern {
98
+ dir: string;
99
+ exts: string[];
100
+ }
101
+
102
+ function getRoutePatterns(framework: WebFrameworkType): RoutePattern[] {
103
+ switch (framework) {
104
+ case "next":
105
+ return [
106
+ { dir: "pages", exts: [".tsx", ".jsx", ".ts", ".js"] },
107
+ { dir: "app", exts: [".tsx", ".jsx"] },
108
+ ];
109
+ case "nuxt":
110
+ case "remix":
111
+ case "astro":
112
+ return [{ dir: "app", exts: [".tsx", ".jsx", ".svelte", ".vue"] }];
113
+ case "react-vite":
114
+ case "vue-vite":
115
+ case "svelte":
116
+ case "static":
117
+ default:
118
+ return [
119
+ { dir: "src", exts: [".tsx", ".jsx", ".svelte", ".vue"] },
120
+ { dir: "components", exts: [".tsx", ".jsx", ".svelte", ".vue"] },
121
+ { dir: "pages", exts: [".tsx", ".jsx"] },
122
+ ];
123
+ case "express":
124
+ case "fastify":
125
+ case "koa":
126
+ case "hono":
127
+ return [{ dir: "routes", exts: [".ts", ".js"] }];
128
+ case "django":
129
+ return [
130
+ { dir: "templates", exts: [".html"] },
131
+ { dir: "views", exts: [".py"] },
132
+ ];
133
+ case "flask":
134
+ return [
135
+ { dir: "templates", exts: [".html"] },
136
+ { dir: "routes", exts: [".py"] },
137
+ ];
138
+ case "rails":
139
+ return [
140
+ { dir: "app/views", exts: [".html.erb", ".html.slim", ".html.haml"] },
141
+ { dir: "app/controllers", exts: [".rb"] },
142
+ ];
143
+ case "laravel":
144
+ return [
145
+ { dir: "resources/views", exts: [".blade.php", ".php"] },
146
+ { dir: "routes", exts: [".php"] },
147
+ ];
148
+ }
149
+ }
150
+
151
+ type DirScanner = (filePath: string, relPath: string) => void;
152
+
153
+ async function scanDir(
154
+ dir: string,
155
+ base: string,
156
+ exts: string[],
157
+ emit: DirScanner,
158
+ ): Promise<void> {
159
+ let entries;
160
+ try {
161
+ entries = await readdir(dir, { withFileTypes: true });
162
+ } catch {
163
+ return;
164
+ }
165
+
166
+ for (const entry of entries) {
167
+ if (entry.name.startsWith(".") || entry.name.startsWith("_")) continue;
168
+
169
+ const fullPath = join(dir, entry.name);
170
+ const relPath = join(base, entry.name)
171
+ .slice(join(base, "").length)
172
+ .replace(/^[/\\]/, "");
173
+
174
+ if (entry.isDirectory()) {
175
+ await scanDir(fullPath, base, exts, emit);
176
+ } else if (exts.includes(extname(entry.name))) {
177
+ emit(fullPath, relPath);
178
+ }
179
+ }
180
+ }
181
+
182
+ function guessComponentName(framework: WebFrameworkType, path: string): string {
183
+ const name = path.split("/").pop() || "index";
184
+ switch (framework) {
185
+ case "react-vite":
186
+ return `${name.charAt(0).toUpperCase()}${name.slice(1)}.tsx`;
187
+ case "vue-vite":
188
+ return `${name.charAt(0).toUpperCase()}${name.slice(1)}.vue`;
189
+ case "svelte":
190
+ return `${name.charAt(0).toUpperCase()}${name.slice(1)}.svelte`;
191
+ case "next":
192
+ case "nuxt":
193
+ case "remix":
194
+ return path.replace(/\//g, "-").replace(/^-/, "") || "home";
195
+ default:
196
+ return name;
197
+ }
198
+ }
199
+
200
+ function deduplicateRoutes(routes: PageRoute[]): PageRoute[] {
201
+ const seen = new Set<string>();
202
+ const result: PageRoute[] = [];
203
+ for (const route of routes) {
204
+ if (!seen.has(route.path)) {
205
+ seen.add(route.path);
206
+ result.push(route);
207
+ }
208
+ }
209
+ return result;
210
+ }
211
+
212
+ // --- API Endpoint Detection --------------------------------------------------
213
+
214
+ async function findApiEndpoints(
215
+ root: string,
216
+ framework: WebFrameworkType,
217
+ ): Promise<ApiEndpoint[]> {
218
+ if (
219
+ ![
220
+ "express",
221
+ "fastify",
222
+ "koa",
223
+ "hono",
224
+ "flask",
225
+ "django",
226
+ "rails",
227
+ "laravel",
228
+ "next",
229
+ ].includes(framework)
230
+ ) {
231
+ return [];
232
+ }
233
+
234
+ const endpoints: ApiEndpoint[] = [];
235
+ const patterns = getApiPatterns(framework);
236
+
237
+ for (const { dir, exts } of patterns) {
238
+ const fullDir = join(root, dir);
239
+ if (!existsSync(fullDir)) continue;
240
+
241
+ await scanDir(fullDir, fullDir, exts, (filePath, relPath) => {
242
+ const methods = extractHttpMethods(filePath);
243
+ const routePath = relPath
244
+ .replace(/\\/g, "/")
245
+ .replace(new RegExp(`\\${exts[0]}$`), "")
246
+ .replace(/\/index$/, "")
247
+ .replace(/^api\//, "")
248
+ .replace(/^routes\//, "");
249
+
250
+ for (const method of methods) {
251
+ endpoints.push({
252
+ method,
253
+ path: `/${routePath}`,
254
+ file: filePath,
255
+ });
256
+ }
257
+ });
258
+ }
259
+
260
+ return endpoints;
261
+ }
262
+
263
+ interface ApiPattern {
264
+ dir: string;
265
+ exts: string[];
266
+ }
267
+
268
+ function getApiPatterns(framework: WebFrameworkType): ApiPattern[] {
269
+ switch (framework) {
270
+ case "express":
271
+ case "fastify":
272
+ case "koa":
273
+ case "hono":
274
+ return [
275
+ { dir: "routes", exts: [".ts", ".js"] },
276
+ { dir: "src/routes", exts: [".ts", ".js"] },
277
+ ];
278
+ case "next":
279
+ return [
280
+ { dir: "pages/api", exts: [".ts", ".js"] },
281
+ { dir: "app/api", exts: [".ts", ".tsx"] },
282
+ ];
283
+ case "flask":
284
+ return [
285
+ { dir: "routes", exts: [".py"] },
286
+ { dir: "app", exts: [".py"] },
287
+ ];
288
+ case "django":
289
+ return [
290
+ { dir: "views", exts: [".py"] },
291
+ { dir: "api", exts: [".py"] },
292
+ ];
293
+ case "rails":
294
+ return [
295
+ { dir: "config/routes.rb", exts: [".rb"] },
296
+ { dir: "app/controllers", exts: [".rb"] },
297
+ ];
298
+ case "laravel":
299
+ return [
300
+ { dir: "routes", exts: [".php"] },
301
+ { dir: "app/Http/Controllers", exts: [".php"] },
302
+ ];
303
+ default:
304
+ return [];
305
+ }
306
+ }
307
+
308
+ function extractHttpMethods(filePath: string): string[] {
309
+ try {
310
+ const content = require("fs").readFileSync(filePath, "utf-8");
311
+ const methods = new Set<string>();
312
+ if (/\bget\b/i.test(content)) methods.add("GET");
313
+ if (/\bpost\b/i.test(content)) methods.add("POST");
314
+ if (/\bput\b/i.test(content)) methods.add("PUT");
315
+ if (/\bpatch\b/i.test(content)) methods.add("PATCH");
316
+ if (/\bdelete\b/i.test(content)) methods.add("DELETE");
317
+ if (/\boptions\b/i.test(content)) methods.add("OPTIONS");
318
+ return methods.size > 0 ? Array.from(methods) : ["GET"];
319
+ } catch {
320
+ return ["GET"];
321
+ }
322
+ }
323
+
324
+ // --- Analysis ----------------------------------------------------------------
325
+
326
+ /**
327
+ * Deep analysis of a generic web project
328
+ */
329
+ export async function analyzeWeb(
330
+ root: string,
331
+ ): Promise<GenericWebAnalysis | null> {
332
+ const detected = await detectWeb(root);
333
+ if (!detected) return null;
334
+
335
+ const framework = await detectFramework(root);
336
+ const [routes, endpoints] = await Promise.all([
337
+ findRouteFiles(root, framework),
338
+ findApiEndpoints(root, framework),
339
+ ]);
340
+
341
+ return {
342
+ framework,
343
+ routes,
344
+ endpoints,
345
+ ssr: framework !== "static",
346
+ };
347
+ }
@@ -0,0 +1,61 @@
1
+ /**
2
+ * Generic Web Plugin — Main Entry (RFC-0066)
3
+ */
4
+
5
+ import type { FrameworkExtension } from "../../framework-plugin-sdk/src/types.js";
6
+ import { analyzeWeb } from "./analyzer.js";
7
+
8
+ export type {
9
+ GenericWebAnalysis,
10
+ WebFrameworkType,
11
+ PageRoute,
12
+ ApiEndpoint,
13
+ } from "./types.js";
14
+
15
+ /**
16
+ * Analyze a generic web project (RFC-0066)
17
+ */
18
+ export async function analyzeWebWorkspace(
19
+ workspaceRoot: string,
20
+ ): Promise<import("./types.js").GenericWebAnalysis | null> {
21
+ return analyzeWeb(workspaceRoot);
22
+ }
23
+
24
+ /**
25
+ * Generic Web Framework Plugin (RFC-0066)
26
+ *
27
+ * Detects and deeply analyzes generic web frameworks:
28
+ * - Framework type detection (Next.js, Nuxt, Remix, Astro, Express, Fastify, etc.)
29
+ * - Route file discovery (pages, app/, components)
30
+ * - API endpoint scanning (routes/, pages/api/, controllers)
31
+ * - SSR/static detection
32
+ */
33
+ export function createGenericWebPlugin(): FrameworkExtension {
34
+ return {
35
+ capability: "framework",
36
+ name: "Generic Web Framework Plugin",
37
+ detector: {
38
+ detect: async (workspaceRoot: unknown): Promise<unknown> => {
39
+ const root = workspaceRoot as string;
40
+ const { existsSync } = await import("node:fs");
41
+ return (
42
+ existsSync(`${root}/package.json`) ||
43
+ existsSync(`${root}/pages`) ||
44
+ existsSync(`${root}/app`) ||
45
+ existsSync(`${root}/src`) ||
46
+ existsSync(`${root}/routes`) ||
47
+ existsSync(`${root}/manage.py`) ||
48
+ existsSync(`${root}/composer.json`)
49
+ );
50
+ },
51
+ signals: [
52
+ { type: "package", pattern: "package.json", weight: 0.5 },
53
+ { type: "directory", pattern: "src", weight: 0.4 },
54
+ { type: "directory", pattern: "pages", weight: 0.4 },
55
+ { type: "directory", pattern: "app", weight: 0.3 },
56
+ { type: "file", pattern: "routes", weight: 0.3 },
57
+ ],
58
+ },
59
+ config: {},
60
+ };
61
+ }
@@ -0,0 +1,41 @@
1
+ /**
2
+ * Generic Web Plugin — Types (RFC-0066)
3
+ */
4
+
5
+ export type WebFrameworkType =
6
+ | "next"
7
+ | "nuxt"
8
+ | "remix"
9
+ | "astro"
10
+ | "react-vite"
11
+ | "vue-vite"
12
+ | "svelte"
13
+ | "webpack"
14
+ | "express"
15
+ | "fastify"
16
+ | "koa"
17
+ | "hono"
18
+ | "flask"
19
+ | "django"
20
+ | "rails"
21
+ | "laravel"
22
+ | "static";
23
+
24
+ export interface PageRoute {
25
+ path: string;
26
+ file: string;
27
+ component: string;
28
+ }
29
+
30
+ export interface ApiEndpoint {
31
+ method: string;
32
+ path: string;
33
+ file?: string;
34
+ }
35
+
36
+ export interface GenericWebAnalysis {
37
+ framework: WebFrameworkType;
38
+ routes: PageRoute[];
39
+ endpoints: ApiEndpoint[];
40
+ ssr: boolean;
41
+ }
@@ -0,0 +1,16 @@
1
+ /**
2
+ * Health Monitor — Main Entry
3
+ */
4
+
5
+ export {
6
+ DEFAULT_CONFIG,
7
+ determineStatus,
8
+ createReport,
9
+ aggregateHealth,
10
+ determineRecoveryAction,
11
+ resetRecoveryAttempts,
12
+ runHealthCheck,
13
+ calculateUptime,
14
+ collectSnapshot,
15
+ } from "./monitor.js";
16
+ export type * from "./types.js";
@@ -0,0 +1,216 @@
1
+ /**
2
+ * Health Monitor — Core Monitor
3
+ */
4
+
5
+ import type {
6
+ ComponentName,
7
+ ComponentHealth,
8
+ HealthReport,
9
+ HealthStatus,
10
+ MonitorConfig,
11
+ RecoveryAction,
12
+ } from "./types.js";
13
+
14
+ export const DEFAULT_CONFIG: Required<MonitorConfig> = {
15
+ checkIntervalMs: 30_000,
16
+ degradedThreshold: 2000,
17
+ unhealthyThreshold: 10_000,
18
+ maxErrorRate: 0.1,
19
+ autoRecover: false,
20
+ maxRecoveryAttempts: 3,
21
+ };
22
+
23
+ const recoveryAttempts = new Map<ComponentName, number>();
24
+ const startTime = Date.now();
25
+
26
+ // --- Collectors ----------------------------------------------------------------
27
+
28
+ export interface SnapshotValue {
29
+ value: number;
30
+ unit: string;
31
+ }
32
+
33
+ export interface HealthSnapshot {
34
+ timestamp: number;
35
+ memory: Record<string, SnapshotValue>;
36
+ cpu: Record<string, SnapshotValue>;
37
+ uptime: number;
38
+ }
39
+
40
+ export function collectMemory(): { name: string; timestamp: number; values: Record<string, SnapshotValue> } {
41
+ const mem = process.memoryUsage();
42
+ return {
43
+ name: "memory",
44
+ timestamp: Date.now(),
45
+ values: {
46
+ rss: { value: mem.rss, unit: "bytes" },
47
+ heapTotal: { value: mem.heapTotal, unit: "bytes" },
48
+ heapUsed: { value: mem.heapUsed, unit: "bytes" },
49
+ external: { value: mem.external, unit: "bytes" },
50
+ },
51
+ };
52
+ }
53
+
54
+ export function collectCPU(): { name: string; timestamp: number; values: Record<string, SnapshotValue> } {
55
+ const cpu = process.cpuUsage();
56
+ return {
57
+ name: "cpu",
58
+ timestamp: Date.now(),
59
+ values: {
60
+ user: { value: cpu.user, unit: "microseconds" },
61
+ system: { value: cpu.system, unit: "microseconds" },
62
+ },
63
+ };
64
+ }
65
+
66
+ export function collectUptime(): { name: string; timestamp: number; values: Record<string, SnapshotValue> } {
67
+ return {
68
+ name: "uptime",
69
+ timestamp: Date.now(),
70
+ values: {
71
+ seconds: { value: process.uptime(), unit: "seconds" },
72
+ },
73
+ };
74
+ }
75
+
76
+ export function collectSnapshot(): HealthSnapshot {
77
+ return {
78
+ timestamp: Date.now(),
79
+ memory: {
80
+ rss: { value: process.memoryUsage().rss, unit: "bytes" },
81
+ heapUsed: { value: process.memoryUsage().heapUsed, unit: "bytes" },
82
+ heapTotal: { value: process.memoryUsage().heapTotal, unit: "bytes" },
83
+ },
84
+ cpu: {
85
+ user: { value: process.cpuUsage().user, unit: "microseconds" },
86
+ system: { value: process.cpuUsage().system, unit: "microseconds" },
87
+ },
88
+ uptime: process.uptime(),
89
+ };
90
+ }
91
+
92
+ export function determineStatus(
93
+ responseTimeMs: number,
94
+ errorRate: number,
95
+ config: Required<MonitorConfig>,
96
+ ): HealthStatus {
97
+ if (
98
+ responseTimeMs > config.unhealthyThreshold ||
99
+ errorRate > config.maxErrorRate
100
+ ) {
101
+ return "unhealthy";
102
+ }
103
+ if (responseTimeMs > config.degradedThreshold) {
104
+ return "degraded";
105
+ }
106
+ return "healthy";
107
+ }
108
+
109
+ export function createReport(
110
+ components: ComponentHealth[],
111
+ _config: Required<MonitorConfig>,
112
+ ): HealthReport {
113
+ return {
114
+ overall: aggregateHealth(components.map((c) => c.status)),
115
+ timestamp: new Date().toISOString(),
116
+ components,
117
+ uptime: Math.floor((Date.now() - startTime) / 1000),
118
+ };
119
+ }
120
+
121
+ export function aggregateHealth(statuses: HealthStatus[]): HealthStatus {
122
+ if (statuses.length === 0) return "unknown";
123
+ if (statuses.some((s) => s === "unhealthy")) return "unhealthy";
124
+ if (statuses.some((s) => s === "degraded")) return "degraded";
125
+ if (statuses.every((s) => s === "healthy")) return "healthy";
126
+ return "unknown";
127
+ }
128
+
129
+ export function determineRecoveryAction(
130
+ component: ComponentName,
131
+ status: HealthStatus,
132
+ config: Required<MonitorConfig>,
133
+ ): RecoveryAction | null {
134
+ if (status === "healthy") return null;
135
+ if (!config.autoRecover) return null;
136
+
137
+ const attempts = recoveryAttempts.get(component) ?? 0;
138
+ if (attempts >= config.maxRecoveryAttempts) {
139
+ return {
140
+ type: "alert",
141
+ target: component,
142
+ config: {
143
+ message: `Max recovery attempts (${attempts}) exceeded for ${component}`,
144
+ },
145
+ };
146
+ }
147
+
148
+ recoveryAttempts.set(component, attempts + 1);
149
+
150
+ if (status === "unhealthy") {
151
+ return {
152
+ type: "restart",
153
+ target: component,
154
+ config: { attempt: attempts + 1 },
155
+ };
156
+ }
157
+
158
+ return {
159
+ type: "retry",
160
+ target: component,
161
+ config: { attempt: attempts + 1, backoffMs: 2 ** attempts * 1000 },
162
+ };
163
+ }
164
+
165
+ export function resetRecoveryAttempts(component: ComponentName): void {
166
+ recoveryAttempts.delete(component);
167
+ }
168
+
169
+ export async function runHealthCheck(
170
+ component: ComponentName,
171
+ checkFn: () => Promise<boolean>,
172
+ config: Required<MonitorConfig>,
173
+ ): Promise<ComponentHealth> {
174
+ const start = Date.now();
175
+ let status: HealthStatus = "healthy";
176
+ let details: string | undefined;
177
+
178
+ try {
179
+ const result = await Promise.race([
180
+ checkFn(),
181
+ new Promise<false>((_, reject) =>
182
+ setTimeout(
183
+ () => reject(new Error("timeout")),
184
+ config.unhealthyThreshold,
185
+ ),
186
+ ),
187
+ ]);
188
+ if (!result) {
189
+ status = "unhealthy";
190
+ details = "Check returned false";
191
+ }
192
+ } catch (err) {
193
+ status = "unhealthy";
194
+ details = err instanceof Error ? err.message : "Unknown error";
195
+ }
196
+
197
+ const responseTimeMs = Date.now() - start;
198
+ const determined = determineStatus(
199
+ responseTimeMs,
200
+ status === "unhealthy" ? 1 : 0,
201
+ config,
202
+ );
203
+
204
+ return {
205
+ component,
206
+ status: determined,
207
+ lastCheck: new Date().toISOString(),
208
+ responseTimeMs,
209
+ errorRate: status === "unhealthy" ? 1 : 0,
210
+ details,
211
+ };
212
+ }
213
+
214
+ export function calculateUptime(report: HealthReport): number {
215
+ return report.overall === "unhealthy" ? 95 : 100;
216
+ }