forgeos 0.1.0-alpha.2 → 0.1.0-alpha.21

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 (406) hide show
  1. package/.npmignore +4 -0
  2. package/AGENTS.md +168 -81
  3. package/CHANGELOG.md +211 -0
  4. package/README.md +88 -14
  5. package/adapters/go/README.md +23 -0
  6. package/adapters/go/go.mod +3 -0
  7. package/adapters/go/http.go +149 -0
  8. package/adapters/go/registry.go +234 -0
  9. package/adapters/go/types.go +136 -0
  10. package/adapters/java/README.md +68 -0
  11. package/adapters/java/pom.xml +34 -0
  12. package/adapters/java/src/main/java/dev/forgeos/adapter/Auth.java +20 -0
  13. package/adapters/java/src/main/java/dev/forgeos/adapter/Diagnostic.java +16 -0
  14. package/adapters/java/src/main/java/dev/forgeos/adapter/Entry.java +38 -0
  15. package/adapters/java/src/main/java/dev/forgeos/adapter/EntryKind.java +16 -0
  16. package/adapters/java/src/main/java/dev/forgeos/adapter/ErrorInfo.java +4 -0
  17. package/adapters/java/src/main/java/dev/forgeos/adapter/Forge.java +94 -0
  18. package/adapters/java/src/main/java/dev/forgeos/adapter/ForgeCall.java +12 -0
  19. package/adapters/java/src/main/java/dev/forgeos/adapter/ForgeContext.java +11 -0
  20. package/adapters/java/src/main/java/dev/forgeos/adapter/ForgeHandler.java +8 -0
  21. package/adapters/java/src/main/java/dev/forgeos/adapter/ForgeHttpHandler.java +179 -0
  22. package/adapters/java/src/main/java/dev/forgeos/adapter/ForgeRegistry.java +121 -0
  23. package/adapters/java/src/main/java/dev/forgeos/adapter/Json.java +14 -0
  24. package/adapters/java/src/main/java/dev/forgeos/adapter/Manifest.java +14 -0
  25. package/adapters/java/src/main/java/dev/forgeos/adapter/RequestEnvelope.java +6 -0
  26. package/adapters/java/src/main/java/dev/forgeos/adapter/ResponseEnvelope.java +25 -0
  27. package/adapters/java/src/main/java/dev/forgeos/adapter/Risk.java +18 -0
  28. package/adapters/java/src/main/java/dev/forgeos/adapter/Schemas.java +36 -0
  29. package/adapters/java/src/main/java/dev/forgeos/adapter/Service.java +65 -0
  30. package/adapters/java/src/main/java/dev/forgeos/adapter/TransactionMode.java +18 -0
  31. package/adapters/java/src/main/java/dev/forgeos/adapter/TypedForgeHandler.java +6 -0
  32. package/adapters/java/target/classes/dev/forgeos/adapter/Auth.class +0 -0
  33. package/adapters/java/target/classes/dev/forgeos/adapter/Diagnostic.class +0 -0
  34. package/adapters/java/target/classes/dev/forgeos/adapter/Entry.class +0 -0
  35. package/adapters/java/target/classes/dev/forgeos/adapter/EntryKind.class +0 -0
  36. package/adapters/java/target/classes/dev/forgeos/adapter/ErrorInfo.class +0 -0
  37. package/adapters/java/target/classes/dev/forgeos/adapter/Forge.class +0 -0
  38. package/adapters/java/target/classes/dev/forgeos/adapter/ForgeCall.class +0 -0
  39. package/adapters/java/target/classes/dev/forgeos/adapter/ForgeContext.class +0 -0
  40. package/adapters/java/target/classes/dev/forgeos/adapter/ForgeHandler.class +0 -0
  41. package/adapters/java/target/classes/dev/forgeos/adapter/ForgeHttpHandler.class +0 -0
  42. package/adapters/java/target/classes/dev/forgeos/adapter/ForgeRegistry$EntryOption.class +0 -0
  43. package/adapters/java/target/classes/dev/forgeos/adapter/ForgeRegistry$RegisteredEntry.class +0 -0
  44. package/adapters/java/target/classes/dev/forgeos/adapter/ForgeRegistry$RegistryOption.class +0 -0
  45. package/adapters/java/target/classes/dev/forgeos/adapter/ForgeRegistry.class +0 -0
  46. package/adapters/java/target/classes/dev/forgeos/adapter/Json.class +0 -0
  47. package/adapters/java/target/classes/dev/forgeos/adapter/Manifest.class +0 -0
  48. package/adapters/java/target/classes/dev/forgeos/adapter/RequestEnvelope.class +0 -0
  49. package/adapters/java/target/classes/dev/forgeos/adapter/ResponseEnvelope.class +0 -0
  50. package/adapters/java/target/classes/dev/forgeos/adapter/Risk.class +0 -0
  51. package/adapters/java/target/classes/dev/forgeos/adapter/Schemas.class +0 -0
  52. package/adapters/java/target/classes/dev/forgeos/adapter/Service.class +0 -0
  53. package/adapters/java/target/classes/dev/forgeos/adapter/TransactionMode.class +0 -0
  54. package/adapters/java/target/classes/dev/forgeos/adapter/TypedForgeHandler.class +0 -0
  55. package/adapters/java/target/forge-java-adapter-0.1.0-alpha.11.jar +0 -0
  56. package/adapters/java/target/maven-archiver/pom.properties +3 -0
  57. package/adapters/java/target/maven-status/maven-compiler-plugin/compile/default-compile/createdFiles.lst +23 -0
  58. package/adapters/java/target/maven-status/maven-compiler-plugin/compile/default-compile/inputFiles.lst +20 -0
  59. package/adapters/java-spring-boot-starter/README.md +32 -0
  60. package/adapters/java-spring-boot-starter/pom.xml +36 -0
  61. package/adapters/java-spring-boot-starter/src/main/java/dev/forgeos/adapter/spring/ForgeCommand.java +22 -0
  62. package/adapters/java-spring-boot-starter/src/main/java/dev/forgeos/adapter/spring/ForgeExternalService.java +15 -0
  63. package/adapters/java-spring-boot-starter/src/main/java/dev/forgeos/adapter/spring/ForgeQuery.java +16 -0
  64. package/adapters/java-spring-boot-starter/src/main/java/dev/forgeos/adapter/spring/ForgeServiceBeanCondition.java +18 -0
  65. package/adapters/java-spring-boot-starter/src/main/java/dev/forgeos/adapter/spring/ForgeSpringAutoConfiguration.java +16 -0
  66. package/adapters/java-spring-boot-starter/src/main/java/dev/forgeos/adapter/spring/ForgeSpringRuntime.java +104 -0
  67. package/adapters/java-spring-boot-starter/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports +1 -0
  68. package/adapters/java-spring-boot-starter/target/classes/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports +1 -0
  69. package/adapters/java-spring-boot-starter/target/classes/dev/forgeos/adapter/spring/ForgeCommand.class +0 -0
  70. package/adapters/java-spring-boot-starter/target/classes/dev/forgeos/adapter/spring/ForgeExternalService.class +0 -0
  71. package/adapters/java-spring-boot-starter/target/classes/dev/forgeos/adapter/spring/ForgeQuery.class +0 -0
  72. package/adapters/java-spring-boot-starter/target/classes/dev/forgeos/adapter/spring/ForgeServiceBeanCondition.class +0 -0
  73. package/adapters/java-spring-boot-starter/target/classes/dev/forgeos/adapter/spring/ForgeSpringAutoConfiguration.class +0 -0
  74. package/adapters/java-spring-boot-starter/target/classes/dev/forgeos/adapter/spring/ForgeSpringRuntime.class +0 -0
  75. package/adapters/java-spring-boot-starter/target/forge-java-spring-boot-starter-0.1.0-alpha.11.jar +0 -0
  76. package/adapters/java-spring-boot-starter/target/maven-archiver/pom.properties +3 -0
  77. package/adapters/java-spring-boot-starter/target/maven-status/maven-compiler-plugin/compile/default-compile/createdFiles.lst +6 -0
  78. package/adapters/java-spring-boot-starter/target/maven-status/maven-compiler-plugin/compile/default-compile/inputFiles.lst +6 -0
  79. package/bin/forge.mjs +18 -0
  80. package/docs/changelog.md +242 -0
  81. package/docs/forge-protocol.md +189 -0
  82. package/examples/go-billing/go.mod +7 -0
  83. package/examples/go-billing/main.go +120 -0
  84. package/examples/java-billing/pom.xml +52 -0
  85. package/examples/java-billing/src/main/java/dev/forgeos/examples/billing/CreateInvoiceInput.java +4 -0
  86. package/examples/java-billing/src/main/java/dev/forgeos/examples/billing/Invoice.java +11 -0
  87. package/examples/java-billing/src/main/java/dev/forgeos/examples/billing/Main.java +127 -0
  88. package/examples/java-billing/target/classes/dev/forgeos/examples/billing/CreateInvoiceInput.class +0 -0
  89. package/examples/java-billing/target/classes/dev/forgeos/examples/billing/Invoice.class +0 -0
  90. package/examples/java-billing/target/classes/dev/forgeos/examples/billing/Main$EmptyInput.class +0 -0
  91. package/examples/java-billing/target/classes/dev/forgeos/examples/billing/Main$Options.class +0 -0
  92. package/examples/java-billing/target/classes/dev/forgeos/examples/billing/Main.class +0 -0
  93. package/examples/java-billing/target/java-billing-0.1.0-alpha.11-all.jar +0 -0
  94. package/examples/java-billing/target/java-billing-0.1.0-alpha.11.jar +0 -0
  95. package/examples/java-billing/target/maven-archiver/pom.properties +3 -0
  96. package/examples/java-billing/target/maven-status/maven-compiler-plugin/compile/default-compile/createdFiles.lst +5 -0
  97. package/examples/java-billing/target/maven-status/maven-compiler-plugin/compile/default-compile/inputFiles.lst +3 -0
  98. package/package.json +29 -7
  99. package/schemas/forge-manifest.schema.json +57 -0
  100. package/src/forge/_generated/releaseManifest.json +1 -2
  101. package/src/forge/_generated/releaseManifest.ts +3 -3
  102. package/src/forge/agent-adapters/index.ts +1511 -123
  103. package/src/forge/agent-adapters/types.ts +216 -1
  104. package/src/forge/agent-memory/bridge.ts +1245 -0
  105. package/src/forge/agent-memory/context-pack.ts +151 -0
  106. package/src/forge/agent-memory/hook-runner.ts +312 -0
  107. package/src/forge/agent-memory/mcp.ts +224 -0
  108. package/src/forge/agent-memory/normalize.ts +498 -0
  109. package/src/forge/agent-memory/redaction.ts +103 -0
  110. package/src/forge/agent-memory/sources/claude-code.ts +51 -0
  111. package/src/forge/agent-memory/sources/codex-hook-runner.mjs +273 -0
  112. package/src/forge/agent-memory/sources/codex.ts +119 -0
  113. package/src/forge/agent-memory/sources/cursor.ts +35 -0
  114. package/src/forge/agent-memory/types.ts +191 -0
  115. package/src/forge/bench.ts +248 -0
  116. package/src/forge/brownfield-import/index.ts +801 -0
  117. package/src/forge/brownfield-import/types.ts +127 -0
  118. package/src/forge/cair/action-journal.ts +61 -0
  119. package/src/forge/cair/action-parser.ts +314 -0
  120. package/src/forge/cair/action-validator.ts +40 -0
  121. package/src/forge/cair/actions.ts +1818 -0
  122. package/src/forge/cair/format.ts +77 -0
  123. package/src/forge/cair/index.ts +106 -0
  124. package/src/forge/cair/query.ts +478 -0
  125. package/src/forge/cair/snapshot.ts +315 -0
  126. package/src/forge/cair/types.ts +248 -0
  127. package/src/forge/cli/ai.ts +671 -3
  128. package/src/forge/cli/auth.ts +36 -1
  129. package/src/forge/cli/build.ts +20 -4
  130. package/src/forge/cli/changed.ts +300 -0
  131. package/src/forge/cli/codex-app-server.ts +877 -0
  132. package/src/forge/cli/commands.ts +1285 -7
  133. package/src/forge/cli/db.ts +121 -2
  134. package/src/forge/cli/deps.ts +79 -12
  135. package/src/forge/cli/dev.ts +502 -38
  136. package/src/forge/cli/docs.ts +265 -0
  137. package/src/forge/cli/handoff.ts +250 -0
  138. package/src/forge/cli/index.ts +1 -0
  139. package/src/forge/cli/main.ts +49 -3
  140. package/src/forge/cli/new.ts +3 -1
  141. package/src/forge/cli/next-actions.ts +23 -0
  142. package/src/forge/cli/output.ts +290 -1
  143. package/src/forge/cli/parse.ts +770 -36
  144. package/src/forge/cli/query.ts +32 -0
  145. package/src/forge/cli/release.ts +35 -11
  146. package/src/forge/cli/rls.ts +568 -17
  147. package/src/forge/cli/run.ts +41 -0
  148. package/src/forge/cli/secrets.ts +46 -1
  149. package/src/forge/cli/security.ts +381 -0
  150. package/src/forge/cli/self-host.ts +56 -14
  151. package/src/forge/cli/studio.ts +2163 -0
  152. package/src/forge/cli/verify.ts +1422 -32
  153. package/src/forge/compiler/agent-contract/build.ts +725 -41
  154. package/src/forge/compiler/agent-contract/types.ts +85 -0
  155. package/src/forge/compiler/ai-registry/build.ts +62 -1
  156. package/src/forge/compiler/ai-registry/constants.ts +1 -1
  157. package/src/forge/compiler/ai-registry/parse.ts +168 -5
  158. package/src/forge/compiler/api-surface/build.ts +47 -0
  159. package/src/forge/compiler/app-graph/build.ts +68 -8
  160. package/src/forge/compiler/app-graph/extract.ts +107 -0
  161. package/src/forge/compiler/app-graph/forge-apis.ts +1 -0
  162. package/src/forge/compiler/app-graph/module-graph.ts +73 -78
  163. package/src/forge/compiler/app-graph/parser.ts +24 -24
  164. package/src/forge/compiler/app-graph/profile.ts +26 -0
  165. package/src/forge/compiler/app-graph/versions.ts +1 -1
  166. package/src/forge/compiler/classifier/capabilities.ts +3 -2
  167. package/src/forge/compiler/classifier/classify.ts +32 -8
  168. package/src/forge/compiler/classifier/secrets.ts +3 -2
  169. package/src/forge/compiler/classifier/signals.ts +91 -1
  170. package/src/forge/compiler/client-sdk/build-manifest.ts +59 -0
  171. package/src/forge/compiler/client-sdk/render-client.ts +188 -13
  172. package/src/forge/compiler/data-graph/parse.ts +3 -3
  173. package/src/forge/compiler/data-graph/sql/ddl.ts +60 -2
  174. package/src/forge/compiler/data-graph/sql/serialize.ts +4 -0
  175. package/src/forge/compiler/data-graph/sql/types.ts +1 -0
  176. package/src/forge/compiler/dev-manifest/build.ts +3 -0
  177. package/src/forge/compiler/diagnostics/codes.ts +35 -0
  178. package/src/forge/compiler/diagnostics/create.ts +8 -3
  179. package/src/forge/compiler/diagnostics/index.ts +2 -0
  180. package/src/forge/compiler/emitter/barrel.ts +3 -0
  181. package/src/forge/compiler/emitter/render.ts +5 -0
  182. package/src/forge/compiler/external-manifest/registry.ts +205 -0
  183. package/src/forge/compiler/external-manifest/types.ts +91 -0
  184. package/src/forge/compiler/external-manifest/validate.ts +373 -0
  185. package/src/forge/compiler/frontend-graph/build.ts +85 -13
  186. package/src/forge/compiler/integration/add.ts +498 -22
  187. package/src/forge/compiler/integration/snapshot.ts +2 -0
  188. package/src/forge/compiler/make-registry/build.ts +19 -7
  189. package/src/forge/compiler/orchestrator/plan-profile.ts +23 -0
  190. package/src/forge/compiler/orchestrator/plan.ts +78 -7
  191. package/src/forge/compiler/orchestrator/profile.ts +65 -0
  192. package/src/forge/compiler/orchestrator/run.ts +97 -31
  193. package/src/forge/compiler/orchestrator/serialize.ts +101 -8
  194. package/src/forge/compiler/package-graph/compiler.ts +13 -3
  195. package/src/forge/compiler/package-manager/adapter.ts +4 -1
  196. package/src/forge/compiler/package-manager/commands.ts +4 -0
  197. package/src/forge/compiler/package-manager/executor.ts +30 -1
  198. package/src/forge/compiler/policy-registry/build.ts +44 -1
  199. package/src/forge/compiler/test-graph/build.ts +11 -3
  200. package/src/forge/compiler/types/ai-registry.ts +25 -1
  201. package/src/forge/compiler/types/app-graph.ts +9 -2
  202. package/src/forge/compiler/types/cli.ts +76 -1
  203. package/src/forge/compiler/types/dev-manifest.ts +3 -0
  204. package/src/forge/compiler/types/frontend-graph.ts +2 -2
  205. package/src/forge/delta/classifier.ts +52 -0
  206. package/src/forge/delta/explain.ts +126 -0
  207. package/src/forge/delta/git-observer.ts +43 -0
  208. package/src/forge/delta/ids.ts +44 -0
  209. package/src/forge/delta/index.ts +13 -0
  210. package/src/forge/delta/recorder.ts +402 -0
  211. package/src/forge/delta/redaction.ts +50 -0
  212. package/src/forge/delta/schema.ts +240 -0
  213. package/src/forge/delta/session.ts +142 -0
  214. package/src/forge/delta/status.ts +489 -0
  215. package/src/forge/delta/store.ts +2975 -0
  216. package/src/forge/delta/timeline.ts +104 -0
  217. package/src/forge/dev/server.ts +768 -15
  218. package/src/forge/dev/types.ts +15 -1
  219. package/src/forge/dev/watch.ts +17 -7
  220. package/src/forge/dev-console/cycle.ts +233 -21
  221. package/src/forge/dev-console/types.ts +46 -1
  222. package/src/forge/impact/index.ts +46 -8
  223. package/src/forge/impact/types.ts +6 -0
  224. package/src/forge/intent/index.ts +35 -16
  225. package/src/forge/make/index.ts +149 -6
  226. package/src/forge/make/templates.ts +343 -2
  227. package/src/forge/make/types.ts +3 -1
  228. package/src/forge/refactor/index.ts +1 -0
  229. package/src/forge/repair/rules/index.ts +2 -2
  230. package/src/forge/review/index.ts +158 -12
  231. package/src/forge/review/types.ts +15 -0
  232. package/src/forge/runtime/ai/context.ts +210 -5
  233. package/src/forge/runtime/ai/types.ts +70 -0
  234. package/src/forge/runtime/auth/claims.ts +32 -0
  235. package/src/forge/runtime/auth/errors.ts +2 -0
  236. package/src/forge/runtime/context/create-context.ts +30 -6
  237. package/src/forge/runtime/db/generated-client.ts +13 -2
  238. package/src/forge/runtime/db/memory-adapter.ts +2 -2
  239. package/src/forge/runtime/db/pglite-adapter.ts +77 -2
  240. package/src/forge/runtime/db/postgres-adapter.ts +6 -3
  241. package/src/forge/runtime/executor.ts +112 -2
  242. package/src/forge/runtime/external/bridge.ts +649 -0
  243. package/src/forge/runtime/runner/run-entry.ts +16 -7
  244. package/src/forge/runtime/telemetry/scrubber.ts +91 -10
  245. package/src/forge/runtime/webhooks/security.ts +184 -0
  246. package/src/forge/server.ts +100 -2
  247. package/src/forge/version.ts +1 -1
  248. package/src/forge/vue/index.ts +407 -0
  249. package/src/forge/workspace/change-summary.ts +209 -0
  250. package/src/forge/workspace/forge-cli.ts +14 -0
  251. package/src/forge/workspace/git-summary.ts +279 -0
  252. package/templates/agent-workroom/AGENTS.md +29 -0
  253. package/templates/agent-workroom/README.md +34 -0
  254. package/templates/agent-workroom/forge.config.ts +3 -0
  255. package/templates/agent-workroom/package.json +33 -0
  256. package/templates/agent-workroom/src/actions/indexAgentSignal.ts +10 -0
  257. package/templates/agent-workroom/src/commands/openWorkroom.ts +61 -0
  258. package/templates/agent-workroom/src/commands/recordAgentSignal.ts +119 -0
  259. package/templates/agent-workroom/src/commands/recordCheckRun.ts +52 -0
  260. package/templates/agent-workroom/src/forge/schema.ts +54 -0
  261. package/templates/agent-workroom/src/policies.ts +6 -0
  262. package/templates/agent-workroom/src/queries/listWorkrooms.ts +11 -0
  263. package/templates/agent-workroom/src/queries/liveWorkroom.ts +63 -0
  264. package/templates/agent-workroom/tsconfig.json +16 -0
  265. package/templates/agent-workroom/web/index.html +12 -0
  266. package/templates/agent-workroom/web/package.json +21 -0
  267. package/templates/agent-workroom/web/src/App.tsx +345 -0
  268. package/templates/agent-workroom/web/src/lib/forge.ts +13 -0
  269. package/templates/agent-workroom/web/src/main.tsx +13 -0
  270. package/templates/agent-workroom/web/src/styles.css +545 -0
  271. package/templates/agent-workroom/web/tsconfig.json +27 -0
  272. package/templates/b2b-support-web/package.json +2 -0
  273. package/templates/b2b-support-web/tsconfig.json +4 -1
  274. package/templates/b2b-support-web/web/package.json +1 -1
  275. package/templates/minimal-web/package.json +2 -1
  276. package/templates/minimal-web/tsconfig.json +3 -1
  277. package/templates/minimal-web/web/package.json +2 -2
  278. package/src/forge/_generated/actionSubscriptions.json +0 -2
  279. package/src/forge/_generated/actionSubscriptions.ts +0 -10
  280. package/src/forge/_generated/agentAdapterManifest.json +0 -2
  281. package/src/forge/_generated/agentAdapterManifest.ts +0 -73
  282. package/src/forge/_generated/agentContract.json +0 -2
  283. package/src/forge/_generated/agentContract.ts +0 -7696
  284. package/src/forge/_generated/agentQuickstart.md +0 -32
  285. package/src/forge/_generated/aiContext.ts +0 -59
  286. package/src/forge/_generated/aiModels.json +0 -2
  287. package/src/forge/_generated/aiModels.ts +0 -35
  288. package/src/forge/_generated/aiProviders.json +0 -2
  289. package/src/forge/_generated/aiProviders.ts +0 -23
  290. package/src/forge/_generated/aiRegistry.json +0 -2
  291. package/src/forge/_generated/aiRegistry.ts +0 -29
  292. package/src/forge/_generated/api.json +0 -2
  293. package/src/forge/_generated/api.ts +0 -8
  294. package/src/forge/_generated/appGraph.json +0 -2
  295. package/src/forge/_generated/appGraph.ts +0 -14667
  296. package/src/forge/_generated/appMap.md +0 -35
  297. package/src/forge/_generated/artifactManifest.json +0 -2
  298. package/src/forge/_generated/artifactManifest.ts +0 -7
  299. package/src/forge/_generated/authClaims.json +0 -2
  300. package/src/forge/_generated/authClaims.ts +0 -13
  301. package/src/forge/_generated/authConfig.json +0 -2
  302. package/src/forge/_generated/authConfig.ts +0 -17
  303. package/src/forge/_generated/authContext.ts +0 -23
  304. package/src/forge/_generated/authRegistry.json +0 -2
  305. package/src/forge/_generated/authRegistry.ts +0 -25
  306. package/src/forge/_generated/buildInfo.json +0 -2
  307. package/src/forge/_generated/buildInfo.ts +0 -9
  308. package/src/forge/_generated/capabilityMap.json +0 -2
  309. package/src/forge/_generated/capabilityMap.md +0 -15
  310. package/src/forge/_generated/capabilityMap.ts +0 -17
  311. package/src/forge/_generated/client.ts +0 -282
  312. package/src/forge/_generated/clientApi.ts +0 -9
  313. package/src/forge/_generated/clientManifest.json +0 -2
  314. package/src/forge/_generated/clientManifest.ts +0 -39
  315. package/src/forge/_generated/clientTypes.ts +0 -78
  316. package/src/forge/_generated/configRegistry.json +0 -2
  317. package/src/forge/_generated/configRegistry.ts +0 -4
  318. package/src/forge/_generated/dataGraph.json +0 -2
  319. package/src/forge/_generated/dataGraph.ts +0 -8
  320. package/src/forge/_generated/db.json +0 -2
  321. package/src/forge/_generated/db.ts +0 -2
  322. package/src/forge/_generated/dbSecurityManifest.json +0 -2
  323. package/src/forge/_generated/dbSecurityManifest.ts +0 -15
  324. package/src/forge/_generated/dbSessionContext.json +0 -2
  325. package/src/forge/_generated/dbSessionContext.ts +0 -39
  326. package/src/forge/_generated/deployManifest.json +0 -2
  327. package/src/forge/_generated/deployManifest.ts +0 -14
  328. package/src/forge/_generated/devManifest.json +0 -2
  329. package/src/forge/_generated/devManifest.ts +0 -47
  330. package/src/forge/_generated/envSchema.json +0 -2
  331. package/src/forge/_generated/envSchema.ts +0 -59
  332. package/src/forge/_generated/frontendGraph.json +0 -2
  333. package/src/forge/_generated/frontendGraph.ts +0 -27
  334. package/src/forge/_generated/importGuards.json +0 -2
  335. package/src/forge/_generated/importGuards.ts +0 -686
  336. package/src/forge/_generated/index.ts +0 -67
  337. package/src/forge/_generated/liveProductionManifest.json +0 -2
  338. package/src/forge/_generated/liveProductionManifest.ts +0 -23
  339. package/src/forge/_generated/liveProtocol.json +0 -2
  340. package/src/forge/_generated/liveProtocol.ts +0 -21
  341. package/src/forge/_generated/liveQueryRegistry.json +0 -2
  342. package/src/forge/_generated/liveQueryRegistry.ts +0 -9
  343. package/src/forge/_generated/liveTransportConfig.json +0 -2
  344. package/src/forge/_generated/liveTransportConfig.ts +0 -19
  345. package/src/forge/_generated/makeRegistry.json +0 -2
  346. package/src/forge/_generated/makeRegistry.ts +0 -163
  347. package/src/forge/_generated/makeTemplates.json +0 -2
  348. package/src/forge/_generated/makeTemplates.ts +0 -61
  349. package/src/forge/_generated/mockMap.json +0 -2
  350. package/src/forge/_generated/mockMap.ts +0 -7
  351. package/src/forge/_generated/operationPlaybooks.md +0 -147
  352. package/src/forge/_generated/packageGraph.json +0 -2
  353. package/src/forge/_generated/packageGraph.ts +0 -245249
  354. package/src/forge/_generated/packageUpgradeRegistry.json +0 -2
  355. package/src/forge/_generated/packageUpgradeRegistry.ts +0 -15
  356. package/src/forge/_generated/permissionMatrix.json +0 -2
  357. package/src/forge/_generated/permissionMatrix.ts +0 -7
  358. package/src/forge/_generated/policyRegistry.json +0 -2
  359. package/src/forge/_generated/policyRegistry.ts +0 -11
  360. package/src/forge/_generated/queryRegistry.json +0 -2
  361. package/src/forge/_generated/queryRegistry.ts +0 -9
  362. package/src/forge/_generated/react.d.ts +0 -22
  363. package/src/forge/_generated/react.ts +0 -29
  364. package/src/forge/_generated/reactManifest.json +0 -2
  365. package/src/forge/_generated/reactManifest.ts +0 -19
  366. package/src/forge/_generated/rlsPolicies.json +0 -2
  367. package/src/forge/_generated/rlsPolicies.sql +0 -34
  368. package/src/forge/_generated/rlsPolicies.ts +0 -6
  369. package/src/forge/_generated/runtimeGraph.json +0 -2
  370. package/src/forge/_generated/runtimeGraph.ts +0 -8
  371. package/src/forge/_generated/runtimeMatrix.json +0 -2
  372. package/src/forge/_generated/runtimeMatrix.ts +0 -327385
  373. package/src/forge/_generated/runtimeRegistry.ts +0 -2
  374. package/src/forge/_generated/runtimeRules.md +0 -79
  375. package/src/forge/_generated/secretRegistry.json +0 -2
  376. package/src/forge/_generated/secretRegistry.ts +0 -50
  377. package/src/forge/_generated/secretsContext.ts +0 -11
  378. package/src/forge/_generated/serverApi.ts +0 -10
  379. package/src/forge/_generated/sourceMapManifest.json +0 -2
  380. package/src/forge/_generated/sourceMapManifest.ts +0 -7
  381. package/src/forge/_generated/sqlPlan.json +0 -2
  382. package/src/forge/_generated/sqlPlan.ts +0 -88
  383. package/src/forge/_generated/subscriptionManifest.json +0 -2
  384. package/src/forge/_generated/subscriptionManifest.ts +0 -7
  385. package/src/forge/_generated/symbolicationManifest.json +0 -2
  386. package/src/forge/_generated/symbolicationManifest.ts +0 -17
  387. package/src/forge/_generated/telemetryRegistry.json +0 -2
  388. package/src/forge/_generated/telemetryRegistry.ts +0 -9
  389. package/src/forge/_generated/telemetrySinks.json +0 -2
  390. package/src/forge/_generated/telemetrySinks.ts +0 -11
  391. package/src/forge/_generated/tenantScope.json +0 -2
  392. package/src/forge/_generated/tenantScope.ts +0 -8
  393. package/src/forge/_generated/testGraph.json +0 -2
  394. package/src/forge/_generated/testGraph.ts +0 -3108
  395. package/src/forge/_generated/testPlanRegistry.json +0 -2
  396. package/src/forge/_generated/testPlanRegistry.ts +0 -33
  397. package/src/forge/_generated/uiRoutes.json +0 -2
  398. package/src/forge/_generated/uiRoutes.ts +0 -16
  399. package/src/forge/_generated/uiScenarios.json +0 -2
  400. package/src/forge/_generated/uiScenarios.ts +0 -30
  401. package/src/forge/_generated/uiTestManifest.json +0 -2
  402. package/src/forge/_generated/uiTestManifest.ts +0 -27
  403. package/src/forge/_generated/workflowRegistry.json +0 -2
  404. package/src/forge/_generated/workflowRegistry.ts +0 -9
  405. package/src/forge/_generated/workflowSubscriptions.json +0 -2
  406. package/src/forge/_generated/workflowSubscriptions.ts +0 -10
@@ -0,0 +1,151 @@
1
+ import { DeltaStore } from "../delta/store.ts";
2
+ import type { AgentMemoryContextEvent, AgentMemoryContextPack, AgentMemoryEventRecord } from "./types.ts";
3
+
4
+ export async function buildAgentMemoryContext(input: {
5
+ workspaceRoot: string;
6
+ entry?: string;
7
+ limit?: number;
8
+ }): Promise<AgentMemoryContextPack> {
9
+ const store = await DeltaStore.open(input.workspaceRoot, { access: "read" });
10
+ try {
11
+ const target = input.entry;
12
+ const events = await store.listAgentMemoryEvents({ target, limit: input.limit ?? 50 });
13
+ const timeline = target ? await store.semanticTimeline({ target, limit: input.limit ?? 50 }) : undefined;
14
+ const current = target ? timeline?.currentState ?? {} : await currentSessionState(store);
15
+ const goals = events
16
+ .filter((event) => event.normalizedKind === "agent.prompt.submitted")
17
+ .map((event) => ({
18
+ source: event.sourceName,
19
+ summary: event.summary ?? "Prompt submitted",
20
+ confidence: event.confidence,
21
+ }));
22
+ const calls = toolCalls(events);
23
+ const files = uniqueStrings(events.flatMap((event) => bindings(event).files));
24
+ const entries = uniqueStrings(events.flatMap((event) => bindings(event).entries));
25
+ const approvals = events
26
+ .filter((event) => event.normalizedKind.startsWith("approval."))
27
+ .map((event) => ({
28
+ source: event.sourceName,
29
+ status: event.normalizedKind.replace(/^approval\./, ""),
30
+ summary: event.summary,
31
+ }));
32
+ const proofs = uniqueStrings(events.flatMap((event) => bindings(event).proofs))
33
+ .map((kind) => ({ kind }));
34
+ const contextEventItems = contextEvents(events);
35
+ const openQuestions = timeline?.openQuestions ?? [];
36
+ return {
37
+ ok: true,
38
+ scope: target ? "entry" : "current",
39
+ entry: target,
40
+ currentState: current,
41
+ agentMemory: {
42
+ summary: {
43
+ events: contextEventItems.length,
44
+ goals: goals.length,
45
+ toolCalls: calls.length,
46
+ files: files.length,
47
+ entries: entries.length,
48
+ approvals: approvals.length,
49
+ proofs: proofs.length,
50
+ openQuestions: openQuestions.length,
51
+ sources: uniqueStrings(contextEventItems.map((event) => event.source)),
52
+ tools: uniqueStrings(calls.map((call) => call.tool)),
53
+ ...(contextEventItems.at(-1)?.capturedAt ? { latestEventAt: contextEventItems.at(-1)!.capturedAt } : {}),
54
+ },
55
+ goals,
56
+ toolCalls: calls,
57
+ files,
58
+ entries,
59
+ approvals,
60
+ proofs,
61
+ events: contextEventItems,
62
+ openQuestions,
63
+ },
64
+ exitCode: 0,
65
+ };
66
+ } finally {
67
+ await store.close();
68
+ }
69
+ }
70
+
71
+ function contextEvents(events: AgentMemoryEventRecord[]): AgentMemoryContextEvent[] {
72
+ return events.map((event) => {
73
+ const eventBindings = bindings(event);
74
+ return {
75
+ id: event.id,
76
+ source: event.sourceName,
77
+ integration: event.integrationKind,
78
+ trustLevel: event.trustLevel,
79
+ kind: event.normalizedKind,
80
+ capturedAt: event.capturedAt,
81
+ ...(event.summary ? { summary: event.summary } : {}),
82
+ ...(event.externalSessionId ? { sessionId: event.externalSessionId } : {}),
83
+ ...(event.externalTurnId ? { turnId: event.externalTurnId } : {}),
84
+ ...(eventBindings.toolName ? { tool: eventBindings.toolName } : {}),
85
+ ...(eventBindings.command ? { command: eventBindings.command } : {}),
86
+ ...(eventBindings.status ? { status: eventBindings.status } : {}),
87
+ files: eventBindings.files,
88
+ entries: eventBindings.entries,
89
+ proofs: eventBindings.proofs,
90
+ confidence: event.confidence,
91
+ };
92
+ });
93
+ }
94
+
95
+ async function currentSessionState(store: DeltaStore): Promise<Record<string, unknown>> {
96
+ const session = await store.currentWorkSession();
97
+ return session
98
+ ? {
99
+ sessionId: session.id,
100
+ title: session.title,
101
+ inferredIntent: session.inferredIntent,
102
+ confidence: session.confidence,
103
+ status: session.status,
104
+ }
105
+ : {};
106
+ }
107
+
108
+ function toolCalls(events: AgentMemoryEventRecord[]): AgentMemoryContextPack["agentMemory"]["toolCalls"] {
109
+ return events
110
+ .filter((event) => event.normalizedKind.startsWith("agent.tool"))
111
+ .map((event) => {
112
+ const eventBindings = bindings(event);
113
+ return {
114
+ source: event.sourceName,
115
+ tool: eventBindings.toolName ?? "unknown",
116
+ status: eventBindings.status,
117
+ summary: event.summary,
118
+ };
119
+ });
120
+ }
121
+
122
+ function bindings(event: AgentMemoryEventRecord): {
123
+ toolName?: string;
124
+ command?: string;
125
+ status?: string;
126
+ files: string[];
127
+ entries: string[];
128
+ proofs: string[];
129
+ } {
130
+ const raw = event.data.bindings;
131
+ if (!raw || typeof raw !== "object" || Array.isArray(raw)) {
132
+ return { files: [], entries: [], proofs: [] };
133
+ }
134
+ const record = raw as Record<string, unknown>;
135
+ return {
136
+ toolName: typeof record.toolName === "string" ? record.toolName : undefined,
137
+ command: typeof record.command === "string" ? record.command : undefined,
138
+ status: typeof record.status === "string" ? record.status : undefined,
139
+ files: arrayOfStrings(record.files),
140
+ entries: arrayOfStrings(record.entries),
141
+ proofs: arrayOfStrings(record.proofs),
142
+ };
143
+ }
144
+
145
+ function arrayOfStrings(value: unknown): string[] {
146
+ return Array.isArray(value) ? value.filter((item): item is string => typeof item === "string" && item.length > 0) : [];
147
+ }
148
+
149
+ function uniqueStrings(values: string[]): string[] {
150
+ return [...new Set(values)].sort();
151
+ }
@@ -0,0 +1,312 @@
1
+ import { existsSync, readFileSync } from "node:fs";
2
+ import { spawn, spawnSync } from "node:child_process";
3
+ import { join } from "node:path";
4
+ import { releaseManifest } from "../_generated/releaseManifest.ts";
5
+ import {
6
+ CODEX_HOOK_META_RELATIVE,
7
+ CODEX_HOOK_QUEUE_RELATIVE,
8
+ CODEX_HOOK_RUNNER_RELATIVE,
9
+ } from "./sources/codex.ts";
10
+
11
+ export interface CodexHookMeta {
12
+ schema: string;
13
+ forgeVersion: string;
14
+ installedAt: string;
15
+ commandResolvedFrom: string;
16
+ workspaceRoot: string;
17
+ runner: string;
18
+ queueFile: string;
19
+ stdinTimeoutMs?: number;
20
+ hookTimeouts?: Record<string, number>;
21
+ }
22
+
23
+ export interface CodexHookCommandInspection {
24
+ hookCommands: string[];
25
+ usesLightweightRunner: boolean;
26
+ usesLegacyForgeCli: boolean;
27
+ maxHookTimeout?: number;
28
+ legacyCommands: string[];
29
+ }
30
+
31
+ export interface ForgePathResolution {
32
+ path: string;
33
+ version?: string;
34
+ source: "path" | "workspace-bin" | "unknown";
35
+ }
36
+
37
+ export interface CodexHookRunnerProbe {
38
+ ok: boolean;
39
+ durationMs: number;
40
+ exitCode: number | null;
41
+ queued: boolean;
42
+ stdinHangSafe: boolean;
43
+ stdinHangDurationMs?: number;
44
+ error?: string;
45
+ }
46
+
47
+ export function readCodexHookMeta(workspaceRoot: string): CodexHookMeta | null {
48
+ const path = join(workspaceRoot, CODEX_HOOK_META_RELATIVE);
49
+ if (!existsSync(path)) {
50
+ return null;
51
+ }
52
+ try {
53
+ const parsed = JSON.parse(readFileSync(path, "utf8")) as unknown;
54
+ if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
55
+ return null;
56
+ }
57
+ const meta = parsed as Partial<CodexHookMeta>;
58
+ if (typeof meta.forgeVersion !== "string" || typeof meta.workspaceRoot !== "string") {
59
+ return null;
60
+ }
61
+ return meta as CodexHookMeta;
62
+ } catch {
63
+ return null;
64
+ }
65
+ }
66
+
67
+ export function inspectCodexHookCommands(workspaceRoot: string): CodexHookCommandInspection {
68
+ const hooksPath = join(workspaceRoot, ".codex", "hooks.json");
69
+ const empty: CodexHookCommandInspection = {
70
+ hookCommands: [],
71
+ usesLightweightRunner: false,
72
+ usesLegacyForgeCli: false,
73
+ legacyCommands: [],
74
+ };
75
+ if (!existsSync(hooksPath)) {
76
+ return empty;
77
+ }
78
+ try {
79
+ const parsed = JSON.parse(readFileSync(hooksPath, "utf8")) as {
80
+ hooks?: Record<string, Array<{ hooks?: Array<{ command?: string; timeout?: number }> }>>;
81
+ };
82
+ const commands: string[] = [];
83
+ const legacyCommands: string[] = [];
84
+ let maxHookTimeout: number | undefined;
85
+ for (const groups of Object.values(parsed.hooks ?? {})) {
86
+ for (const group of groups ?? []) {
87
+ for (const hook of group.hooks ?? []) {
88
+ if (typeof hook.command === "string") {
89
+ commands.push(hook.command);
90
+ if (/forge\s+agent\s+ingest/i.test(hook.command)) {
91
+ legacyCommands.push(hook.command);
92
+ }
93
+ }
94
+ if (typeof hook.timeout === "number") {
95
+ maxHookTimeout = maxHookTimeout === undefined ? hook.timeout : Math.max(maxHookTimeout, hook.timeout);
96
+ }
97
+ }
98
+ }
99
+ }
100
+ const usesLightweightRunner = commands.some((command) => command.includes("codex-hook.mjs"));
101
+ const usesLegacyForgeCli = legacyCommands.length > 0;
102
+ return {
103
+ hookCommands: commands,
104
+ usesLightweightRunner,
105
+ usesLegacyForgeCli,
106
+ maxHookTimeout,
107
+ legacyCommands,
108
+ };
109
+ } catch {
110
+ return empty;
111
+ }
112
+ }
113
+
114
+ export function resolveForgeOnPath(workspaceRoot?: string): ForgePathResolution | null {
115
+ const roots = [workspaceRoot, process.cwd()].filter((value): value is string => Boolean(value));
116
+ for (const root of roots) {
117
+ const localBin = join(root, "bin", "forge.mjs");
118
+ if (existsSync(localBin)) {
119
+ return { path: localBin, source: "workspace-bin", version: readForgeVersion(localBin) };
120
+ }
121
+ }
122
+ const command = process.platform === "win32" ? "where.exe" : "which";
123
+ const args = process.platform === "win32" ? ["forge"] : ["forge"];
124
+ const result = spawnSyncSafe(command, args);
125
+ if (!result.ok || !result.stdout.trim()) {
126
+ return null;
127
+ }
128
+ const firstLine = result.stdout.split(/\r?\n/).find((line) => line.trim())?.trim();
129
+ if (!firstLine) {
130
+ return null;
131
+ }
132
+ return {
133
+ path: firstLine,
134
+ source: "path",
135
+ version: readForgeVersion(firstLine),
136
+ };
137
+ }
138
+
139
+ export function compareHookForgeVersions(
140
+ meta: CodexHookMeta | null,
141
+ runtimeVersion: string = releaseManifest.packageVersion,
142
+ ): { matches: boolean; installedVersion?: string; runtimeVersion: string } {
143
+ if (!meta?.forgeVersion) {
144
+ return { matches: false, runtimeVersion };
145
+ }
146
+ return {
147
+ matches: meta.forgeVersion === runtimeVersion,
148
+ installedVersion: meta.forgeVersion,
149
+ runtimeVersion,
150
+ };
151
+ }
152
+
153
+ export async function probeCodexHookRunner(
154
+ workspaceRoot: string,
155
+ options?: { maxDurationMs?: number; stdinHangBudgetMs?: number },
156
+ ): Promise<CodexHookRunnerProbe> {
157
+ const maxDurationMs = options?.maxDurationMs ?? 5000;
158
+ const stdinHangBudgetMs = options?.stdinHangBudgetMs ?? 3000;
159
+ const runnerPath = join(workspaceRoot, CODEX_HOOK_RUNNER_RELATIVE);
160
+ if (!existsSync(runnerPath)) {
161
+ return {
162
+ ok: false,
163
+ durationMs: 0,
164
+ exitCode: null,
165
+ queued: false,
166
+ stdinHangSafe: false,
167
+ error: `missing hook runner: ${CODEX_HOOK_RUNNER_RELATIVE}`,
168
+ };
169
+ }
170
+
171
+ const queuePath = join(workspaceRoot, CODEX_HOOK_QUEUE_RELATIVE);
172
+ const queueBefore = existsSync(queuePath) ? readFileSync(queuePath, "utf8") : "";
173
+ const payload = JSON.stringify({
174
+ session_id: "forge-hook-probe",
175
+ hook_event_name: "SessionStart",
176
+ cwd: workspaceRoot,
177
+ forgeHookProbe: true,
178
+ });
179
+
180
+ const startedAt = Date.now();
181
+ const result = spawnSync(process.execPath, [runnerPath, "SessionStart"], {
182
+ cwd: workspaceRoot,
183
+ input: payload,
184
+ encoding: "utf8",
185
+ timeout: maxDurationMs + 1000,
186
+ windowsHide: true,
187
+ });
188
+ const durationMs = Date.now() - startedAt;
189
+
190
+ const queueAfter = existsSync(queuePath) ? readFileSync(queuePath, "utf8") : "";
191
+ const queued = queueAfter.length > queueBefore.length && queueAfter.includes("forge-hook-probe");
192
+
193
+ const hangStartedAt = Date.now();
194
+ const hangResult = await spawnNodeHook(runnerPath, ["SessionStart"], {
195
+ cwd: workspaceRoot,
196
+ keepStdinOpen: true,
197
+ timeoutMs: stdinHangBudgetMs,
198
+ });
199
+ const stdinHangDurationMs = Date.now() - hangStartedAt;
200
+ const stdinHangSafe = !hangResult.timedOut && hangResult.exitCode === 0 && stdinHangDurationMs <= stdinHangBudgetMs;
201
+
202
+ const exitCode = result.status;
203
+ const ok = exitCode === 0 && durationMs <= maxDurationMs && queued && stdinHangSafe;
204
+ const stderr = typeof result.stderr === "string" ? result.stderr.trim() : "";
205
+ return {
206
+ ok,
207
+ durationMs,
208
+ exitCode,
209
+ queued,
210
+ stdinHangSafe,
211
+ stdinHangDurationMs,
212
+ ...(ok ? {} : {
213
+ error: stderr ||
214
+ (!stdinHangSafe ? `hook runner did not exit safely with open stdin within ${stdinHangBudgetMs}ms` : undefined) ||
215
+ (exitCode !== 0 ? `hook runner exited with code ${exitCode ?? "unknown"}` : undefined) ||
216
+ (!queued ? "hook runner did not append NDJSON queue entry" : undefined) ||
217
+ (durationMs > maxDurationMs ? `hook runner took ${durationMs}ms (budget ${maxDurationMs}ms)` : undefined) ||
218
+ "hook probe failed",
219
+ }),
220
+ };
221
+ }
222
+
223
+ function readForgeVersion(commandPath: string): string | undefined {
224
+ if (commandPath.endsWith(".mjs") || commandPath.endsWith(".js")) {
225
+ try {
226
+ const pkgPath = join(commandPath, "..", "..", "package.json");
227
+ if (existsSync(pkgPath)) {
228
+ const pkg = JSON.parse(readFileSync(pkgPath, "utf8")) as { version?: string };
229
+ return typeof pkg.version === "string" ? pkg.version : undefined;
230
+ }
231
+ } catch {
232
+ return undefined;
233
+ }
234
+ return undefined;
235
+ }
236
+ const result = spawnSyncSafe(process.execPath, [commandPath, "--version"], { timeoutMs: 3000 });
237
+ return result.ok ? result.stdout.trim().split(/\r?\n/)[0]?.trim() : undefined;
238
+ }
239
+
240
+ function spawnSyncSafe(
241
+ command: string,
242
+ args: string[],
243
+ options?: { timeoutMs?: number },
244
+ ): { ok: boolean; stdout: string; stderr: string; status: number | null } {
245
+ const result = spawnSync(command, args, {
246
+ encoding: "utf8",
247
+ timeout: options?.timeoutMs,
248
+ windowsHide: true,
249
+ });
250
+ return {
251
+ ok: result.status === 0 && !result.error,
252
+ stdout: result.stdout ?? "",
253
+ stderr: result.stderr ?? "",
254
+ status: result.status,
255
+ };
256
+ }
257
+
258
+ function spawnNodeHook(
259
+ runnerPath: string,
260
+ args: string[],
261
+ options: {
262
+ cwd: string;
263
+ input?: string;
264
+ keepStdinOpen?: boolean;
265
+ timeoutMs: number;
266
+ },
267
+ ): Promise<{ exitCode: number | null; timedOut: boolean; error?: string }> {
268
+ return new Promise((resolvePromise) => {
269
+ const child = spawn(process.execPath, [runnerPath, ...args], {
270
+ cwd: options.cwd,
271
+ stdio: ["pipe", "ignore", "ignore"],
272
+ windowsHide: true,
273
+ });
274
+ let settled = false;
275
+ let timedOut = false;
276
+ let killGraceTimer: ReturnType<typeof setTimeout> | undefined;
277
+ const finish = (value: { exitCode: number | null; timedOut: boolean; error?: string }) => {
278
+ if (settled) {
279
+ return;
280
+ }
281
+ settled = true;
282
+ clearTimeout(timer);
283
+ if (killGraceTimer) {
284
+ clearTimeout(killGraceTimer);
285
+ }
286
+ resolvePromise(value);
287
+ };
288
+ const timer = setTimeout(() => {
289
+ timedOut = true;
290
+ child.kill();
291
+ killGraceTimer = setTimeout(() => {
292
+ finish({ exitCode: null, timedOut: true, error: "hook runner timed out" });
293
+ }, 1000);
294
+ }, options.timeoutMs);
295
+
296
+ child.on("error", (error) => {
297
+ finish({ exitCode: null, timedOut, error: error.message });
298
+ });
299
+ child.on("close", (code) => {
300
+ finish({ exitCode: code, timedOut });
301
+ });
302
+
303
+ if (options.keepStdinOpen) {
304
+ child.stdin?.write('{"session_id":"forge-hook-hang-probe"');
305
+ return;
306
+ }
307
+ if (options.input !== undefined) {
308
+ child.stdin?.write(options.input);
309
+ }
310
+ child.stdin?.end();
311
+ });
312
+ }
@@ -0,0 +1,224 @@
1
+ import { readFileSync } from "node:fs";
2
+ import { join } from "node:path";
3
+ import { DeltaStore } from "../delta/store.ts";
4
+ import { buildAgentMemoryContext } from "./context-pack.ts";
5
+ import { ingestEnvelope } from "./bridge.ts";
6
+ import { normalizeAgentEvent } from "./normalize.ts";
7
+
8
+ interface JsonRpcRequest {
9
+ jsonrpc?: "2.0";
10
+ id?: string | number | null;
11
+ method: string;
12
+ params?: Record<string, unknown>;
13
+ }
14
+
15
+ export async function handleMcpRequest(workspaceRoot: string, request: JsonRpcRequest): Promise<Record<string, unknown> | null> {
16
+ if (request.method.startsWith("notifications/")) {
17
+ return null;
18
+ }
19
+ try {
20
+ if (request.method === "initialize") {
21
+ return response(request.id, {
22
+ protocolVersion: "2024-11-05",
23
+ capabilities: { tools: {} },
24
+ serverInfo: { name: "forgeos-agent-memory", version: "0.1.0" },
25
+ });
26
+ }
27
+ if (request.method === "tools/list") {
28
+ return response(request.id, {
29
+ tools: [
30
+ {
31
+ name: "agent_context",
32
+ description: "Read the ForgeOS Agent Memory context pack for the current work or a runtime entry.",
33
+ inputSchema: {
34
+ type: "object",
35
+ properties: { entry: { type: "string" } },
36
+ additionalProperties: false,
37
+ },
38
+ },
39
+ {
40
+ name: "agent_memory",
41
+ description: "List recent redacted agent memory events.",
42
+ inputSchema: {
43
+ type: "object",
44
+ properties: { target: { type: "string" }, limit: { type: "number" } },
45
+ additionalProperties: false,
46
+ },
47
+ },
48
+ {
49
+ name: "timeline",
50
+ description: "Read the semantic timeline for an entry, file, policy, service, tool, or agent.",
51
+ inputSchema: {
52
+ type: "object",
53
+ properties: { target: { type: "string" }, limit: { type: "number" } },
54
+ required: ["target"],
55
+ additionalProperties: false,
56
+ },
57
+ },
58
+ {
59
+ name: "inspect_all",
60
+ description: "Read the generated ForgeOS machine contract artifacts that are safe for agents.",
61
+ inputSchema: {
62
+ type: "object",
63
+ properties: {},
64
+ additionalProperties: false,
65
+ },
66
+ },
67
+ ],
68
+ });
69
+ }
70
+ if (request.method === "tools/call") {
71
+ const params = request.params ?? {};
72
+ const name = typeof params.name === "string" ? params.name : "";
73
+ const args = params.arguments && typeof params.arguments === "object" && !Array.isArray(params.arguments)
74
+ ? params.arguments as Record<string, unknown>
75
+ : {};
76
+ const result = await runTool(workspaceRoot, name, args);
77
+ await logMcpToolCall(workspaceRoot, name, args, "completed").catch(() => undefined);
78
+ return response(request.id, {
79
+ content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
80
+ });
81
+ }
82
+ return response(request.id, null, { code: -32601, message: `unknown MCP method: ${request.method}` });
83
+ } catch (error) {
84
+ const message = error instanceof Error ? error.message : String(error);
85
+ return response(request.id, null, { code: -32000, message });
86
+ }
87
+ }
88
+
89
+ export async function runMcpServe(workspaceRoot: string): Promise<number> {
90
+ let buffer = "";
91
+ let sawFramedMessage = false;
92
+ for await (const chunk of process.stdin) {
93
+ buffer += Buffer.isBuffer(chunk) ? chunk.toString("utf8") : String(chunk);
94
+ const parsed = parseMcpFrames(buffer);
95
+ buffer = parsed.remainder;
96
+ if (parsed.requests.length > 0) {
97
+ sawFramedMessage = true;
98
+ }
99
+ for (const request of parsed.requests) {
100
+ const result = await handleMcpRequest(workspaceRoot, request);
101
+ if (result) {
102
+ writeMcpMessage(result);
103
+ }
104
+ }
105
+ }
106
+ const leftover = buffer.trim();
107
+ if (!sawFramedMessage && leftover.startsWith("{")) {
108
+ const result = await handleMcpRequest(workspaceRoot, JSON.parse(leftover) as JsonRpcRequest);
109
+ if (result) {
110
+ writeMcpMessage(result);
111
+ }
112
+ }
113
+ return 0;
114
+ }
115
+
116
+ async function runTool(workspaceRoot: string, name: string, args: Record<string, unknown>): Promise<unknown> {
117
+ if (name === "agent_context") {
118
+ return buildAgentMemoryContext({
119
+ workspaceRoot,
120
+ entry: typeof args.entry === "string" ? args.entry : undefined,
121
+ });
122
+ }
123
+ if (name === "agent_memory") {
124
+ const store = await DeltaStore.open(workspaceRoot, { access: "read" });
125
+ try {
126
+ return {
127
+ ok: true,
128
+ events: await store.listAgentMemoryEvents({
129
+ target: typeof args.target === "string" ? args.target : undefined,
130
+ limit: typeof args.limit === "number" ? args.limit : undefined,
131
+ }),
132
+ };
133
+ } finally {
134
+ await store.close();
135
+ }
136
+ }
137
+ if (name === "timeline") {
138
+ const target = typeof args.target === "string" ? args.target : undefined;
139
+ if (!target) {
140
+ throw new Error("timeline requires target");
141
+ }
142
+ const store = await DeltaStore.open(workspaceRoot, { access: "read" });
143
+ try {
144
+ return {
145
+ ok: true,
146
+ timeline: await store.semanticTimeline({
147
+ target,
148
+ limit: typeof args.limit === "number" ? args.limit : undefined,
149
+ }),
150
+ };
151
+ } finally {
152
+ await store.close();
153
+ }
154
+ }
155
+ if (name === "inspect_all") {
156
+ return readInspectAll(workspaceRoot);
157
+ }
158
+ throw new Error(`unknown ForgeOS MCP tool: ${name}`);
159
+ }
160
+
161
+ async function logMcpToolCall(workspaceRoot: string, toolName: string, args: Record<string, unknown>, status: string): Promise<void> {
162
+ const envelope = normalizeAgentEvent({
163
+ workspaceRoot,
164
+ source: "generic",
165
+ integration: "mcp",
166
+ eventName: "tool.call",
167
+ raw: {
168
+ toolName,
169
+ args,
170
+ status,
171
+ timestamp: new Date().toISOString(),
172
+ },
173
+ });
174
+ await ingestEnvelope(workspaceRoot, envelope);
175
+ }
176
+
177
+ function readInspectAll(workspaceRoot: string): Record<string, unknown> {
178
+ const generated = join(workspaceRoot, "src", "forge", "_generated");
179
+ const read = (name: string) => {
180
+ try {
181
+ return JSON.parse(readFileSync(join(generated, name), "utf8")) as unknown;
182
+ } catch {
183
+ return null;
184
+ }
185
+ };
186
+ return {
187
+ ok: true,
188
+ agentContract: read("agentContract.json"),
189
+ agentTools: read("agentTools.json"),
190
+ runtimeGraph: read("runtimeGraph.json"),
191
+ policyRegistry: read("policyRegistry.json"),
192
+ };
193
+ }
194
+
195
+ function response(id: JsonRpcRequest["id"], result: unknown, error?: Record<string, unknown>): Record<string, unknown> {
196
+ return error ? { jsonrpc: "2.0", id: id ?? null, error } : { jsonrpc: "2.0", id: id ?? null, result };
197
+ }
198
+
199
+ function parseMcpFrames(raw: string): { requests: JsonRpcRequest[]; remainder: string } {
200
+ const messages: JsonRpcRequest[] = [];
201
+ let cursor = 0;
202
+ while (cursor < raw.length) {
203
+ const headerEnd = raw.indexOf("\r\n\r\n", cursor);
204
+ if (headerEnd === -1) {
205
+ break;
206
+ }
207
+ const header = raw.slice(cursor, headerEnd);
208
+ const match = /Content-Length:\s*(\d+)/i.exec(header);
209
+ if (!match) {
210
+ break;
211
+ }
212
+ const length = Number(match[1]);
213
+ const bodyStart = headerEnd + 4;
214
+ const body = raw.slice(bodyStart, bodyStart + length);
215
+ messages.push(JSON.parse(body) as JsonRpcRequest);
216
+ cursor = bodyStart + length;
217
+ }
218
+ return { requests: messages, remainder: raw.slice(cursor) };
219
+ }
220
+
221
+ function writeMcpMessage(message: Record<string, unknown>): void {
222
+ const body = JSON.stringify(message);
223
+ process.stdout.write(`Content-Length: ${Buffer.byteLength(body, "utf8")}\r\n\r\n${body}`);
224
+ }