forgeos 0.1.0-alpha.7 → 0.1.0-alpha.71

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 (598) hide show
  1. package/.agents/skills/forge-agent-fabric/SKILL.md +178 -0
  2. package/.agents/skills/forge-agent-fabric/references/managed-workflows.md +95 -0
  3. package/.agents/skills/forge-agent-fabric/references/repository-analysis.md +102 -0
  4. package/.agents/skills/forge-agent-fabric/scripts/fabric.mjs +46 -0
  5. package/.agents/skills/forge-agent-fabric/scripts/repository.mjs +44 -0
  6. package/.npmignore +10 -0
  7. package/AGENTS.md +142 -90
  8. package/CHANGELOG.md +870 -9
  9. package/LICENSE +21 -0
  10. package/README.md +121 -6
  11. package/adapters/go/README.md +23 -0
  12. package/adapters/go/go.mod +3 -0
  13. package/adapters/go/http.go +149 -0
  14. package/adapters/go/registry.go +234 -0
  15. package/adapters/go/types.go +136 -0
  16. package/adapters/java/README.md +68 -0
  17. package/adapters/java/pom.xml +47 -0
  18. package/adapters/java/src/main/java/dev/forgeos/adapter/Auth.java +20 -0
  19. package/adapters/java/src/main/java/dev/forgeos/adapter/Diagnostic.java +16 -0
  20. package/adapters/java/src/main/java/dev/forgeos/adapter/Entry.java +38 -0
  21. package/adapters/java/src/main/java/dev/forgeos/adapter/EntryKind.java +16 -0
  22. package/adapters/java/src/main/java/dev/forgeos/adapter/ErrorInfo.java +4 -0
  23. package/adapters/java/src/main/java/dev/forgeos/adapter/Forge.java +94 -0
  24. package/adapters/java/src/main/java/dev/forgeos/adapter/ForgeCall.java +12 -0
  25. package/adapters/java/src/main/java/dev/forgeos/adapter/ForgeContext.java +11 -0
  26. package/adapters/java/src/main/java/dev/forgeos/adapter/ForgeHandler.java +8 -0
  27. package/adapters/java/src/main/java/dev/forgeos/adapter/ForgeHttpHandler.java +179 -0
  28. package/adapters/java/src/main/java/dev/forgeos/adapter/ForgeRegistry.java +121 -0
  29. package/adapters/java/src/main/java/dev/forgeos/adapter/Json.java +14 -0
  30. package/adapters/java/src/main/java/dev/forgeos/adapter/Manifest.java +14 -0
  31. package/adapters/java/src/main/java/dev/forgeos/adapter/RequestEnvelope.java +6 -0
  32. package/adapters/java/src/main/java/dev/forgeos/adapter/ResponseEnvelope.java +25 -0
  33. package/adapters/java/src/main/java/dev/forgeos/adapter/Risk.java +18 -0
  34. package/adapters/java/src/main/java/dev/forgeos/adapter/Schemas.java +36 -0
  35. package/adapters/java/src/main/java/dev/forgeos/adapter/Service.java +65 -0
  36. package/adapters/java/src/main/java/dev/forgeos/adapter/TransactionMode.java +18 -0
  37. package/adapters/java/src/main/java/dev/forgeos/adapter/TypedForgeHandler.java +6 -0
  38. package/adapters/java-spring-boot-starter/README.md +32 -0
  39. package/adapters/java-spring-boot-starter/pom.xml +49 -0
  40. package/adapters/java-spring-boot-starter/src/main/java/dev/forgeos/adapter/spring/ForgeCommand.java +22 -0
  41. package/adapters/java-spring-boot-starter/src/main/java/dev/forgeos/adapter/spring/ForgeExternalService.java +15 -0
  42. package/adapters/java-spring-boot-starter/src/main/java/dev/forgeos/adapter/spring/ForgeQuery.java +16 -0
  43. package/adapters/java-spring-boot-starter/src/main/java/dev/forgeos/adapter/spring/ForgeServiceBeanCondition.java +18 -0
  44. package/adapters/java-spring-boot-starter/src/main/java/dev/forgeos/adapter/spring/ForgeSpringAutoConfiguration.java +16 -0
  45. package/adapters/java-spring-boot-starter/src/main/java/dev/forgeos/adapter/spring/ForgeSpringRuntime.java +104 -0
  46. package/adapters/java-spring-boot-starter/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports +1 -0
  47. package/bin/forge.mjs +18 -0
  48. package/docs/agent-fabric-programs.md +151 -0
  49. package/docs/agent-fabric.md +582 -0
  50. package/docs/architecture/agent-fabric/PORTABLE_PROJECTS_PLAN.md +136 -0
  51. package/docs/architecture/agent-fabric/README.md +180 -0
  52. package/docs/architecture/agent-fabric/REPOSITORY_MANIFEST_PLAN.md +284 -0
  53. package/docs/architecture/agent-fabric/WORKFLOW_PROGRAM_V2_ADR.md +81 -0
  54. package/docs/architecture/agent-fabric/WORKFLOW_PROGRAM_V2_CORRECTIONS.md +39 -0
  55. package/docs/architecture/agent-fabric/WORKFLOW_PROGRAM_V2_CORRECTIONS_EVIDENCE.md +53 -0
  56. package/docs/architecture/agent-fabric/WORKFLOW_PROGRAM_V2_EVIDENCE.md +49 -0
  57. package/docs/architecture/agent-fabric/WORKFLOW_PROGRAM_V2_PLAN.md +590 -0
  58. package/docs/cair-protocol.md +103 -0
  59. package/docs/changelog.md +1070 -0
  60. package/docs/forge-protocol.md +189 -0
  61. package/docs/repository-agent-benchmark.md +179 -0
  62. package/docs/repository-analysis.md +139 -0
  63. package/docs/repository-context-quality.md +179 -0
  64. package/docs/repository-runtime-observation.md +82 -0
  65. package/examples/agent-fabric-v2/README.md +70 -0
  66. package/examples/agent-fabric-v2/item-child.workflow.ts +11 -0
  67. package/examples/agent-fabric-v2/make-request.mjs +4 -0
  68. package/examples/agent-fabric-v2/map-child.workflow.ts +10 -0
  69. package/examples/agent-fabric-v2/migrate.workflow.ts +35 -0
  70. package/examples/agent-fabric-v2/registry.example.json +256 -0
  71. package/examples/agent-fabric-v2/run-ui-fixture.ts +48 -0
  72. package/examples/agent-fabric-v2/ui-audit.workflow.ts +28 -0
  73. package/examples/agent-fabric-v2/ui-fixture-worker.cjs +36 -0
  74. package/examples/agent-fabric-v2/visual-population.json +13 -0
  75. package/examples/agent-fabric-v2/workers/check.mjs +2 -0
  76. package/examples/agent-fabric-v2/workers/common.mjs +7 -0
  77. package/examples/agent-fabric-v2/workers/discover.mjs +2 -0
  78. package/examples/agent-fabric-v2/workers/migrate.mjs +4 -0
  79. package/examples/agent-fabric-v2/workers/review.mjs +3 -0
  80. package/examples/go-billing/go.mod +7 -0
  81. package/examples/go-billing/main.go +120 -0
  82. package/examples/java-billing/pom.xml +60 -0
  83. package/examples/java-billing/src/main/java/dev/forgeos/examples/billing/CreateInvoiceInput.java +4 -0
  84. package/examples/java-billing/src/main/java/dev/forgeos/examples/billing/Invoice.java +11 -0
  85. package/examples/java-billing/src/main/java/dev/forgeos/examples/billing/Main.java +127 -0
  86. package/package.json +60 -5
  87. package/schemas/agent-fabric/v0.1/control-event.schema.json +281 -0
  88. package/schemas/forge-manifest.schema.json +389 -0
  89. package/scripts/field-test-forgeos.mjs +1021 -0
  90. package/scripts/install-agent-fabric-skill.mjs +105 -0
  91. package/src/forge/_generated/releaseManifest.json +1 -2
  92. package/src/forge/_generated/releaseManifest.ts +3 -3
  93. package/src/forge/agent-adapters/index.ts +1592 -125
  94. package/src/forge/agent-adapters/types.ts +225 -1
  95. package/src/forge/agent-fabric/adapter.ts +131 -0
  96. package/src/forge/agent-fabric/attached-snapshot.ts +55 -0
  97. package/src/forge/agent-fabric/attached-task-contract.ts +105 -0
  98. package/src/forge/agent-fabric/attached-task-service.ts +127 -0
  99. package/src/forge/agent-fabric/attached-task-store.ts +109 -0
  100. package/src/forge/agent-fabric/authority.ts +298 -0
  101. package/src/forge/agent-fabric/canonical.ts +135 -0
  102. package/src/forge/agent-fabric/codex-adversarial-review.ts +229 -0
  103. package/src/forge/agent-fabric/codex-sdk-worker.ts +203 -0
  104. package/src/forge/agent-fabric/conductor.ts +754 -0
  105. package/src/forge/agent-fabric/dictionary.ts +12 -0
  106. package/src/forge/agent-fabric/errors.ts +32 -0
  107. package/src/forge/agent-fabric/hardened-conductor.ts +485 -0
  108. package/src/forge/agent-fabric/hardened-reducer.ts +211 -0
  109. package/src/forge/agent-fabric/index.ts +48 -0
  110. package/src/forge/agent-fabric/journal.ts +116 -0
  111. package/src/forge/agent-fabric/local-adaptive-digest-worker.mjs +26 -0
  112. package/src/forge/agent-fabric/local-adaptive-harness.ts +343 -0
  113. package/src/forge/agent-fabric/local-adaptive-service.ts +398 -0
  114. package/src/forge/agent-fabric/local-adaptive-worker.ts +146 -0
  115. package/src/forge/agent-fabric/local-approval-window.ts +211 -0
  116. package/src/forge/agent-fabric/local-change-review-service.ts +374 -0
  117. package/src/forge/agent-fabric/local-coding-worker.ts +285 -0
  118. package/src/forge/agent-fabric/local-control-store.ts +239 -0
  119. package/src/forge/agent-fabric/local-effect-broker.ts +348 -0
  120. package/src/forge/agent-fabric/local-evolution-approval.ts +81 -0
  121. package/src/forge/agent-fabric/local-evolution-profile.ts +87 -0
  122. package/src/forge/agent-fabric/local-evolution-registry.ts +427 -0
  123. package/src/forge/agent-fabric/local-evolution-service.ts +200 -0
  124. package/src/forge/agent-fabric/local-intelligence.ts +281 -0
  125. package/src/forge/agent-fabric/local-paths.ts +18 -0
  126. package/src/forge/agent-fabric/local-task-contract.ts +203 -0
  127. package/src/forge/agent-fabric/local-task-inbox.ts +543 -0
  128. package/src/forge/agent-fabric/local-task-server.ts +374 -0
  129. package/src/forge/agent-fabric/local-task-service.ts +982 -0
  130. package/src/forge/agent-fabric/local-verification.ts +551 -0
  131. package/src/forge/agent-fabric/managed-environment.ts +205 -0
  132. package/src/forge/agent-fabric/managed-run-contract.ts +103 -0
  133. package/src/forge/agent-fabric/managed-run-service.ts +401 -0
  134. package/src/forge/agent-fabric/managed-run-store.ts +165 -0
  135. package/src/forge/agent-fabric/managed-workspace.ts +253 -0
  136. package/src/forge/agent-fabric/p0a.ts +104 -0
  137. package/src/forge/agent-fabric/p0b-model-adapter.ts +434 -0
  138. package/src/forge/agent-fabric/planning.ts +155 -0
  139. package/src/forge/agent-fabric/program-api.ts +37 -0
  140. package/src/forge/agent-fabric/program-contract.ts +283 -0
  141. package/src/forge/agent-fabric/program-dsl.ts +126 -0
  142. package/src/forge/agent-fabric/program-evidence.ts +22 -0
  143. package/src/forge/agent-fabric/program-image.ts +15 -0
  144. package/src/forge/agent-fabric/program-lock.ts +50 -0
  145. package/src/forge/agent-fabric/program-owner.ts +16 -0
  146. package/src/forge/agent-fabric/program-scheduler.ts +38 -0
  147. package/src/forge/agent-fabric/program-service.ts +793 -0
  148. package/src/forge/agent-fabric/program-store.ts +142 -0
  149. package/src/forge/agent-fabric/program-structure.ts +65 -0
  150. package/src/forge/agent-fabric/program-types.ts +110 -0
  151. package/src/forge/agent-fabric/program-view.ts +12 -0
  152. package/src/forge/agent-fabric/program-worker.ts +108 -0
  153. package/src/forge/agent-fabric/project-profile.ts +50 -0
  154. package/src/forge/agent-fabric/project-registry.ts +120 -0
  155. package/src/forge/agent-fabric/project-runtime.ts +85 -0
  156. package/src/forge/agent-fabric/readiness.ts +26 -0
  157. package/src/forge/agent-fabric/reducer.ts +863 -0
  158. package/src/forge/agent-fabric/repository-context.ts +83 -0
  159. package/src/forge/agent-fabric/resource-ledger.ts +266 -0
  160. package/src/forge/agent-fabric/serialized-local-adapter.ts +60 -0
  161. package/src/forge/agent-fabric/types.ts +424 -0
  162. package/src/forge/agent-fabric/validation.ts +500 -0
  163. package/src/forge/agent-fabric/workflow-engine.ts +218 -0
  164. package/src/forge/agent-fabric/workflow-task-actions.ts +104 -0
  165. package/src/forge/agent-fabric/workflow-templates.ts +11 -0
  166. package/src/forge/agent-memory/bridge.ts +1728 -0
  167. package/src/forge/agent-memory/context-pack.ts +284 -0
  168. package/src/forge/agent-memory/hook-runner.ts +331 -0
  169. package/src/forge/agent-memory/mcp.ts +597 -0
  170. package/src/forge/agent-memory/normalize.ts +498 -0
  171. package/src/forge/agent-memory/redaction.ts +103 -0
  172. package/src/forge/agent-memory/sources/claude-code.ts +51 -0
  173. package/src/forge/agent-memory/sources/codex-hook-runner.mjs +343 -0
  174. package/src/forge/agent-memory/sources/codex.ts +161 -0
  175. package/src/forge/agent-memory/sources/cursor.ts +35 -0
  176. package/src/forge/agent-memory/types.ts +215 -0
  177. package/src/forge/bench.ts +248 -0
  178. package/src/forge/brownfield-import/index.ts +896 -0
  179. package/src/forge/brownfield-import/types.ts +127 -0
  180. package/src/forge/cair/action-journal.ts +61 -0
  181. package/src/forge/cair/action-parser.ts +314 -0
  182. package/src/forge/cair/action-validator.ts +40 -0
  183. package/src/forge/cair/actions.ts +1818 -0
  184. package/src/forge/cair/format.ts +77 -0
  185. package/src/forge/cair/index.ts +118 -0
  186. package/src/forge/cair/query.ts +478 -0
  187. package/src/forge/cair/snapshot.ts +315 -0
  188. package/src/forge/cair/types.ts +255 -0
  189. package/src/forge/cli/adaptive.ts +51 -0
  190. package/src/forge/cli/ai.ts +16 -1
  191. package/src/forge/cli/auth.ts +459 -15
  192. package/src/forge/cli/authmd.ts +441 -0
  193. package/src/forge/cli/baseline.ts +112 -0
  194. package/src/forge/cli/build.ts +20 -4
  195. package/src/forge/cli/changed.ts +418 -0
  196. package/src/forge/cli/codex-app-server.ts +877 -0
  197. package/src/forge/cli/commands.ts +1859 -20
  198. package/src/forge/cli/db.ts +209 -2
  199. package/src/forge/cli/deploy.ts +1339 -0
  200. package/src/forge/cli/deps.ts +150 -23
  201. package/src/forge/cli/dev.ts +1137 -53
  202. package/src/forge/cli/docs.ts +265 -0
  203. package/src/forge/cli/doctor.ts +297 -0
  204. package/src/forge/cli/env-placeholders.ts +62 -0
  205. package/src/forge/cli/evolution.ts +40 -0
  206. package/src/forge/cli/fabric.ts +253 -0
  207. package/src/forge/cli/field-test.ts +568 -0
  208. package/src/forge/cli/golden-path.ts +487 -0
  209. package/src/forge/cli/handoff.ts +336 -0
  210. package/src/forge/cli/index.ts +1 -0
  211. package/src/forge/cli/last-run.ts +84 -0
  212. package/src/forge/cli/main.ts +196 -3
  213. package/src/forge/cli/new.ts +169 -17
  214. package/src/forge/cli/next-actions.ts +23 -0
  215. package/src/forge/cli/output.ts +398 -6
  216. package/src/forge/cli/parse.ts +1377 -38
  217. package/src/forge/cli/progress.ts +51 -0
  218. package/src/forge/cli/query.ts +32 -0
  219. package/src/forge/cli/release.ts +35 -11
  220. package/src/forge/cli/repository.ts +151 -0
  221. package/src/forge/cli/run.ts +42 -0
  222. package/src/forge/cli/secrets.ts +137 -1
  223. package/src/forge/cli/seed.ts +581 -0
  224. package/src/forge/cli/self-host.ts +56 -14
  225. package/src/forge/cli/studio.ts +2282 -0
  226. package/src/forge/cli/verify.ts +1458 -32
  227. package/src/forge/cli/windows.ts +23 -0
  228. package/src/forge/cli/workos.ts +3509 -0
  229. package/src/forge/compiler/agent-contract/build.ts +728 -64
  230. package/src/forge/compiler/agent-contract/types.ts +45 -2
  231. package/src/forge/compiler/ai-registry/parse.ts +71 -2
  232. package/src/forge/compiler/api-surface/build.ts +47 -0
  233. package/src/forge/compiler/app-graph/build.ts +112 -9
  234. package/src/forge/compiler/app-graph/extract.ts +107 -0
  235. package/src/forge/compiler/app-graph/module-graph.ts +73 -78
  236. package/src/forge/compiler/app-graph/parser.ts +24 -24
  237. package/src/forge/compiler/app-graph/profile.ts +26 -0
  238. package/src/forge/compiler/app-graph/tsconfig-hash.ts +41 -4
  239. package/src/forge/compiler/app-graph/versions.ts +1 -1
  240. package/src/forge/compiler/classifier/capabilities.ts +3 -2
  241. package/src/forge/compiler/classifier/classify.ts +32 -8
  242. package/src/forge/compiler/classifier/secrets.ts +3 -2
  243. package/src/forge/compiler/classifier/signals.ts +91 -1
  244. package/src/forge/compiler/client-sdk/build-manifest.ts +59 -0
  245. package/src/forge/compiler/client-sdk/render-client.ts +295 -13
  246. package/src/forge/compiler/data-graph/build.ts +29 -1
  247. package/src/forge/compiler/data-graph/parse.ts +20 -4
  248. package/src/forge/compiler/data-graph/sql/ddl.ts +144 -31
  249. package/src/forge/compiler/data-graph/sql/serialize.ts +4 -0
  250. package/src/forge/compiler/data-graph/sql/types.ts +1 -0
  251. package/src/forge/compiler/diagnostics/codes.ts +38 -0
  252. package/src/forge/compiler/diagnostics/create.ts +28 -2
  253. package/src/forge/compiler/diagnostics/index.ts +2 -0
  254. package/src/forge/compiler/emitter/barrel.ts +3 -0
  255. package/src/forge/compiler/emitter/render.ts +9 -0
  256. package/src/forge/compiler/external-manifest/registry.ts +217 -0
  257. package/src/forge/compiler/external-manifest/types.ts +91 -0
  258. package/src/forge/compiler/external-manifest/validate.ts +373 -0
  259. package/src/forge/compiler/frontend-graph/build.ts +142 -14
  260. package/src/forge/compiler/integration/add.ts +991 -33
  261. package/src/forge/compiler/integration/plan.ts +43 -12
  262. package/src/forge/compiler/integration/render.ts +29 -0
  263. package/src/forge/compiler/integration/snapshot.ts +2 -0
  264. package/src/forge/compiler/integration/templates/convex.ts +70 -0
  265. package/src/forge/compiler/integration/templates/index.ts +1 -0
  266. package/src/forge/compiler/integration/templates/render.ts +38 -0
  267. package/src/forge/compiler/integration/templates/types.ts +3 -0
  268. package/src/forge/compiler/integration/templates/workos.ts +1439 -0
  269. package/src/forge/compiler/make-registry/build.ts +8 -9
  270. package/src/forge/compiler/orchestrator/fast-check.ts +4 -0
  271. package/src/forge/compiler/orchestrator/generate-lock.ts +14 -3
  272. package/src/forge/compiler/orchestrator/manifest.ts +1 -1
  273. package/src/forge/compiler/orchestrator/plan-profile.ts +23 -0
  274. package/src/forge/compiler/orchestrator/plan.ts +249 -10
  275. package/src/forge/compiler/orchestrator/profile.ts +65 -0
  276. package/src/forge/compiler/orchestrator/run.ts +101 -33
  277. package/src/forge/compiler/orchestrator/serialize.ts +33 -8
  278. package/src/forge/compiler/orchestrator/types.ts +1 -1
  279. package/src/forge/compiler/package-graph/compiler.ts +3 -1
  280. package/src/forge/compiler/package-graph/constants.ts +1 -1
  281. package/src/forge/compiler/package-graph/dts-extractor.ts +14 -1
  282. package/src/forge/compiler/package-manager/adapter.ts +4 -1
  283. package/src/forge/compiler/package-manager/commands.ts +4 -0
  284. package/src/forge/compiler/package-manager/executor.ts +30 -1
  285. package/src/forge/compiler/package-manager/version.ts +36 -12
  286. package/src/forge/compiler/package-upgrades/planner.ts +155 -18
  287. package/src/forge/compiler/package-upgrades/types.ts +2 -0
  288. package/src/forge/compiler/policy-registry/build.ts +47 -2
  289. package/src/forge/compiler/policy-registry/parse.ts +32 -2
  290. package/src/forge/compiler/recipes/definitions.ts +63 -0
  291. package/src/forge/compiler/recipes/index.ts +2 -0
  292. package/src/forge/compiler/recipes/profiles.ts +81 -0
  293. package/src/forge/compiler/recipes/registry.ts +6 -0
  294. package/src/forge/compiler/test-graph/build.ts +11 -3
  295. package/src/forge/compiler/types/app-graph.ts +8 -2
  296. package/src/forge/compiler/types/cli.ts +76 -1
  297. package/src/forge/compiler/types/dev-manifest.ts +4 -0
  298. package/src/forge/compiler/types/emit.ts +2 -0
  299. package/src/forge/compiler/types/frontend-graph.ts +2 -2
  300. package/src/forge/compiler/types/integration.ts +1 -0
  301. package/src/forge/compiler/types/package-graph.ts +6 -0
  302. package/src/forge/compiler/types/policy-registry.ts +3 -1
  303. package/src/forge/delta/broker-runner.mjs +5 -0
  304. package/src/forge/delta/broker.ts +429 -0
  305. package/src/forge/delta/classifier.ts +52 -0
  306. package/src/forge/delta/explain.ts +238 -0
  307. package/src/forge/delta/git-observer.ts +67 -0
  308. package/src/forge/delta/ids.ts +44 -0
  309. package/src/forge/delta/index.ts +25 -0
  310. package/src/forge/delta/process-identity.ts +37 -0
  311. package/src/forge/delta/queue-status.ts +190 -0
  312. package/src/forge/delta/recorder.ts +540 -0
  313. package/src/forge/delta/redaction.ts +50 -0
  314. package/src/forge/delta/schema.ts +240 -0
  315. package/src/forge/delta/session.ts +142 -0
  316. package/src/forge/delta/status.ts +1139 -0
  317. package/src/forge/delta/store.ts +3329 -0
  318. package/src/forge/delta/timeline.ts +178 -0
  319. package/src/forge/dev/server.ts +1061 -22
  320. package/src/forge/dev/types.ts +15 -1
  321. package/src/forge/dev/watch.ts +17 -7
  322. package/src/forge/dev-console/cycle.ts +285 -33
  323. package/src/forge/dev-console/types.ts +47 -1
  324. package/src/forge/impact/index.ts +222 -30
  325. package/src/forge/impact/types.ts +33 -1
  326. package/src/forge/intent/index.ts +35 -16
  327. package/src/forge/make/fields.ts +26 -0
  328. package/src/forge/make/index.ts +42 -6
  329. package/src/forge/make/templates.ts +211 -4
  330. package/src/forge/make/types.ts +2 -1
  331. package/src/forge/policy.ts +1 -1
  332. package/src/forge/react/index.ts +160 -2
  333. package/src/forge/refactor/index.ts +1 -0
  334. package/src/forge/repair/rules/index.ts +2 -2
  335. package/src/forge/repository-analysis/adapters/common.ts +72 -0
  336. package/src/forge/repository-analysis/adapters/docker.ts +185 -0
  337. package/src/forge/repository-analysis/adapters/java.ts +133 -0
  338. package/src/forge/repository-analysis/adapters/typescript.ts +350 -0
  339. package/src/forge/repository-analysis/adapters/vue.ts +71 -0
  340. package/src/forge/repository-analysis/analyze.ts +434 -0
  341. package/src/forge/repository-analysis/benchmark.ts +336 -0
  342. package/src/forge/repository-analysis/cache-gc.ts +154 -0
  343. package/src/forge/repository-analysis/check-selection.ts +123 -0
  344. package/src/forge/repository-analysis/context-node.ts +17 -0
  345. package/src/forge/repository-analysis/context.ts +456 -0
  346. package/src/forge/repository-analysis/http-resolution.ts +135 -0
  347. package/src/forge/repository-analysis/identity.ts +45 -0
  348. package/src/forge/repository-analysis/index.ts +18 -0
  349. package/src/forge/repository-analysis/nuxt-resolution.ts +188 -0
  350. package/src/forge/repository-analysis/quality.ts +60 -0
  351. package/src/forge/repository-analysis/retrieval.ts +309 -0
  352. package/src/forge/repository-analysis/runtime-artifacts.ts +195 -0
  353. package/src/forge/repository-analysis/runtime-observation.ts +325 -0
  354. package/src/forge/repository-analysis/scanner.ts +174 -0
  355. package/src/forge/repository-analysis/storage.ts +193 -0
  356. package/src/forge/repository-analysis/test-associations.ts +59 -0
  357. package/src/forge/repository-analysis/types.ts +99 -0
  358. package/src/forge/repository-manifest/index.ts +178 -0
  359. package/src/forge/repository-manifest/types.ts +63 -0
  360. package/src/forge/review/index.ts +162 -12
  361. package/src/forge/review/types.ts +15 -0
  362. package/src/forge/runtime/ai/providers.ts +19 -4
  363. package/src/forge/runtime/auth/config.ts +17 -0
  364. package/src/forge/runtime/auth/evaluate.ts +15 -2
  365. package/src/forge/runtime/auth/resolve.ts +61 -6
  366. package/src/forge/runtime/auth/types.ts +1 -0
  367. package/src/forge/runtime/db/factory.ts +1 -3
  368. package/src/forge/runtime/db/generated-client.ts +13 -2
  369. package/src/forge/runtime/db/memory-adapter.ts +139 -32
  370. package/src/forge/runtime/db/pglite-adapter.ts +285 -2
  371. package/src/forge/runtime/executor.ts +129 -16
  372. package/src/forge/runtime/external/bridge.ts +663 -0
  373. package/src/forge/runtime/runner/run-entry.ts +16 -7
  374. package/src/forge/runtime/telemetry/buffer.ts +4 -1
  375. package/src/forge/runtime/telemetry/scrubber.ts +35 -5
  376. package/src/forge/runtime/webhooks/security.ts +12 -7
  377. package/src/forge/server.ts +71 -7
  378. package/src/forge/ui/index.ts +831 -19
  379. package/src/forge/ui/types.ts +3 -1
  380. package/src/forge/version.ts +1 -1
  381. package/src/forge/vue/index.ts +422 -0
  382. package/src/forge/workspace/baseline.ts +112 -0
  383. package/src/forge/workspace/change-summary.ts +292 -0
  384. package/src/forge/workspace/forge-cli.ts +42 -0
  385. package/src/forge/workspace/git-summary.ts +393 -0
  386. package/templates/agent-workroom/AGENTS.md +29 -0
  387. package/templates/agent-workroom/README.md +34 -0
  388. package/templates/agent-workroom/forge.config.ts +3 -0
  389. package/templates/agent-workroom/package.json +34 -0
  390. package/templates/agent-workroom/pnpm-workspace.yaml +2 -0
  391. package/templates/agent-workroom/src/actions/indexAgentSignal.ts +10 -0
  392. package/templates/agent-workroom/src/commands/openWorkroom.ts +61 -0
  393. package/templates/agent-workroom/src/commands/recordAgentSignal.ts +119 -0
  394. package/templates/agent-workroom/src/commands/recordCheckRun.ts +52 -0
  395. package/templates/agent-workroom/src/forge/schema.ts +54 -0
  396. package/templates/agent-workroom/src/policies.ts +6 -0
  397. package/templates/agent-workroom/src/queries/listWorkrooms.ts +11 -0
  398. package/templates/agent-workroom/src/queries/liveWorkroom.ts +63 -0
  399. package/templates/agent-workroom/tsconfig.json +16 -0
  400. package/templates/agent-workroom/web/index.html +13 -0
  401. package/templates/agent-workroom/web/package.json +21 -0
  402. package/templates/agent-workroom/web/src/App.tsx +345 -0
  403. package/templates/agent-workroom/web/src/lib/forge.ts +20 -0
  404. package/templates/agent-workroom/web/src/main.tsx +13 -0
  405. package/templates/agent-workroom/web/src/styles.css +545 -0
  406. package/templates/agent-workroom/web/tsconfig.json +27 -0
  407. package/templates/agent-workroom/web/vite.config.ts +36 -0
  408. package/templates/b2b-support-web/package.json +2 -0
  409. package/templates/b2b-support-web/pnpm-workspace.yaml +2 -0
  410. package/templates/b2b-support-web/web/app/page.tsx +2 -2
  411. package/templates/b2b-support-web/web/lib/forge.ts +9 -2
  412. package/templates/b2b-support-web/web/next.config.ts +24 -0
  413. package/templates/b2b-support-web/web/package.json +1 -1
  414. package/templates/minimal-web/package.json +2 -1
  415. package/templates/minimal-web/pnpm-workspace.yaml +2 -0
  416. package/templates/minimal-web/web/index.html +1 -0
  417. package/templates/minimal-web/web/src/App.tsx +12 -6
  418. package/templates/minimal-web/web/src/lib/forge.ts +9 -2
  419. package/templates/minimal-web/web/src/styles.css +34 -0
  420. package/templates/minimal-web/web/vite.config.ts +36 -0
  421. package/templates/nuxt-web/.vscode/settings.json +14 -0
  422. package/templates/nuxt-web/.yarnrc.yml +1 -0
  423. package/templates/nuxt-web/README.md +30 -0
  424. package/templates/nuxt-web/forge.config.ts +3 -0
  425. package/templates/nuxt-web/package.json +37 -0
  426. package/templates/nuxt-web/pnpm-workspace.yaml +2 -0
  427. package/templates/nuxt-web/src/actions/logNoteCreated.ts +11 -0
  428. package/templates/nuxt-web/src/commands/createNote.ts +26 -0
  429. package/templates/nuxt-web/src/forge/schema.ts +12 -0
  430. package/templates/nuxt-web/src/policies.ts +6 -0
  431. package/templates/nuxt-web/src/queries/listNotes.ts +8 -0
  432. package/templates/nuxt-web/src/queries/liveNotes.ts +8 -0
  433. package/templates/nuxt-web/tsconfig.json +17 -0
  434. package/templates/nuxt-web/web/app.vue +67 -0
  435. package/templates/nuxt-web/web/components/LiveNotes.vue +89 -0
  436. package/templates/nuxt-web/web/components/NoteComposer.vue +100 -0
  437. package/templates/nuxt-web/web/composables/forge.ts +13 -0
  438. package/templates/nuxt-web/web/composables/useNotes.ts +24 -0
  439. package/templates/nuxt-web/web/nuxt.config.ts +11 -0
  440. package/templates/nuxt-web/web/package.json +22 -0
  441. package/templates/nuxt-web/web/plugins/forge.client.ts +10 -0
  442. package/templates/nuxt-web/web/plugins/forge.server.ts +10 -0
  443. package/templates/nuxt-web/web/server/api/forge-health.get.ts +7 -0
  444. package/templates/nuxt-web/web/tsconfig.json +6 -0
  445. package/templates/vendor-access/.vscode/settings.json +14 -0
  446. package/templates/vendor-access/README.md +30 -0
  447. package/templates/vendor-access/forge.config.ts +3 -0
  448. package/templates/vendor-access/package.json +35 -0
  449. package/templates/vendor-access/pnpm-workspace.yaml +2 -0
  450. package/templates/vendor-access/src/commands/addEvidence.ts +42 -0
  451. package/templates/vendor-access/src/commands/approveAccessRequest.ts +43 -0
  452. package/templates/vendor-access/src/commands/createAccessRequest.ts +49 -0
  453. package/templates/vendor-access/src/commands/seedVendorAccessDemo.ts +200 -0
  454. package/templates/vendor-access/src/forge/schema.ts +74 -0
  455. package/templates/vendor-access/src/policies.ts +11 -0
  456. package/templates/vendor-access/src/queries/listVendorAccessDashboard.ts +24 -0
  457. package/templates/vendor-access/src/queries/liveVendorAccessDashboard.ts +24 -0
  458. package/templates/vendor-access/tsconfig.json +17 -0
  459. package/templates/vendor-access/web/index.html +13 -0
  460. package/templates/vendor-access/web/package.json +21 -0
  461. package/templates/vendor-access/web/src/App.tsx +573 -0
  462. package/templates/vendor-access/web/src/lib/forge.ts +20 -0
  463. package/templates/vendor-access/web/src/main.tsx +205 -0
  464. package/templates/vendor-access/web/src/styles.css +682 -0
  465. package/templates/vendor-access/web/tsconfig.json +18 -0
  466. package/templates/vendor-access/web/vite.config.ts +36 -0
  467. package/src/forge/_generated/actionSubscriptions.json +0 -2
  468. package/src/forge/_generated/actionSubscriptions.ts +0 -10
  469. package/src/forge/_generated/agentAdapterManifest.json +0 -2
  470. package/src/forge/_generated/agentAdapterManifest.ts +0 -73
  471. package/src/forge/_generated/agentContract.json +0 -2
  472. package/src/forge/_generated/agentContract.ts +0 -7829
  473. package/src/forge/_generated/agentQuickstart.md +0 -34
  474. package/src/forge/_generated/agentTools.json +0 -2
  475. package/src/forge/_generated/agentTools.md +0 -16
  476. package/src/forge/_generated/agentTools.ts +0 -12
  477. package/src/forge/_generated/aiContext.ts +0 -125
  478. package/src/forge/_generated/aiModels.json +0 -2
  479. package/src/forge/_generated/aiModels.ts +0 -51
  480. package/src/forge/_generated/aiProviders.json +0 -2
  481. package/src/forge/_generated/aiProviders.ts +0 -23
  482. package/src/forge/_generated/aiRegistry.json +0 -2
  483. package/src/forge/_generated/aiRegistry.ts +0 -31
  484. package/src/forge/_generated/api.json +0 -2
  485. package/src/forge/_generated/api.ts +0 -8
  486. package/src/forge/_generated/appGraph.json +0 -2
  487. package/src/forge/_generated/appGraph.ts +0 -14937
  488. package/src/forge/_generated/appMap.md +0 -55
  489. package/src/forge/_generated/artifactManifest.json +0 -2
  490. package/src/forge/_generated/artifactManifest.ts +0 -7
  491. package/src/forge/_generated/authClaims.json +0 -2
  492. package/src/forge/_generated/authClaims.ts +0 -13
  493. package/src/forge/_generated/authConfig.json +0 -2
  494. package/src/forge/_generated/authConfig.ts +0 -17
  495. package/src/forge/_generated/authContext.ts +0 -23
  496. package/src/forge/_generated/authRegistry.json +0 -2
  497. package/src/forge/_generated/authRegistry.ts +0 -25
  498. package/src/forge/_generated/buildInfo.json +0 -2
  499. package/src/forge/_generated/buildInfo.ts +0 -9
  500. package/src/forge/_generated/capabilityMap.json +0 -2
  501. package/src/forge/_generated/capabilityMap.md +0 -15
  502. package/src/forge/_generated/capabilityMap.ts +0 -17
  503. package/src/forge/_generated/client.ts +0 -282
  504. package/src/forge/_generated/clientApi.ts +0 -9
  505. package/src/forge/_generated/clientManifest.json +0 -2
  506. package/src/forge/_generated/clientManifest.ts +0 -39
  507. package/src/forge/_generated/clientTypes.ts +0 -78
  508. package/src/forge/_generated/configRegistry.json +0 -2
  509. package/src/forge/_generated/configRegistry.ts +0 -4
  510. package/src/forge/_generated/dataGraph.json +0 -2
  511. package/src/forge/_generated/dataGraph.ts +0 -8
  512. package/src/forge/_generated/db.json +0 -2
  513. package/src/forge/_generated/db.ts +0 -2
  514. package/src/forge/_generated/dbSecurityManifest.json +0 -2
  515. package/src/forge/_generated/dbSecurityManifest.ts +0 -15
  516. package/src/forge/_generated/dbSessionContext.json +0 -2
  517. package/src/forge/_generated/dbSessionContext.ts +0 -39
  518. package/src/forge/_generated/deployManifest.json +0 -2
  519. package/src/forge/_generated/deployManifest.ts +0 -14
  520. package/src/forge/_generated/devManifest.json +0 -2
  521. package/src/forge/_generated/devManifest.ts +0 -62
  522. package/src/forge/_generated/envSchema.json +0 -2
  523. package/src/forge/_generated/envSchema.ts +0 -59
  524. package/src/forge/_generated/frontendGraph.json +0 -2
  525. package/src/forge/_generated/frontendGraph.ts +0 -27
  526. package/src/forge/_generated/importGuards.json +0 -2
  527. package/src/forge/_generated/importGuards.ts +0 -686
  528. package/src/forge/_generated/index.ts +0 -68
  529. package/src/forge/_generated/liveProductionManifest.json +0 -2
  530. package/src/forge/_generated/liveProductionManifest.ts +0 -23
  531. package/src/forge/_generated/liveProtocol.json +0 -2
  532. package/src/forge/_generated/liveProtocol.ts +0 -21
  533. package/src/forge/_generated/liveQueryRegistry.json +0 -2
  534. package/src/forge/_generated/liveQueryRegistry.ts +0 -9
  535. package/src/forge/_generated/liveTransportConfig.json +0 -2
  536. package/src/forge/_generated/liveTransportConfig.ts +0 -19
  537. package/src/forge/_generated/makeRegistry.json +0 -2
  538. package/src/forge/_generated/makeRegistry.ts +0 -177
  539. package/src/forge/_generated/makeTemplates.json +0 -2
  540. package/src/forge/_generated/makeTemplates.ts +0 -66
  541. package/src/forge/_generated/mockMap.json +0 -2
  542. package/src/forge/_generated/mockMap.ts +0 -7
  543. package/src/forge/_generated/operationPlaybooks.md +0 -167
  544. package/src/forge/_generated/packageGraph.json +0 -2
  545. package/src/forge/_generated/packageGraph.ts +0 -249334
  546. package/src/forge/_generated/packageUpgradeRegistry.json +0 -2
  547. package/src/forge/_generated/packageUpgradeRegistry.ts +0 -15
  548. package/src/forge/_generated/permissionMatrix.json +0 -2
  549. package/src/forge/_generated/permissionMatrix.ts +0 -7
  550. package/src/forge/_generated/policyRegistry.json +0 -2
  551. package/src/forge/_generated/policyRegistry.ts +0 -11
  552. package/src/forge/_generated/queryRegistry.json +0 -2
  553. package/src/forge/_generated/queryRegistry.ts +0 -9
  554. package/src/forge/_generated/react.d.ts +0 -22
  555. package/src/forge/_generated/react.ts +0 -29
  556. package/src/forge/_generated/reactManifest.json +0 -2
  557. package/src/forge/_generated/reactManifest.ts +0 -19
  558. package/src/forge/_generated/rlsPolicies.json +0 -2
  559. package/src/forge/_generated/rlsPolicies.sql +0 -34
  560. package/src/forge/_generated/rlsPolicies.ts +0 -6
  561. package/src/forge/_generated/runtimeGraph.json +0 -2
  562. package/src/forge/_generated/runtimeGraph.ts +0 -8
  563. package/src/forge/_generated/runtimeMatrix.json +0 -2
  564. package/src/forge/_generated/runtimeMatrix.ts +0 -334130
  565. package/src/forge/_generated/runtimeRegistry.ts +0 -2
  566. package/src/forge/_generated/runtimeRules.md +0 -91
  567. package/src/forge/_generated/secretRegistry.json +0 -2
  568. package/src/forge/_generated/secretRegistry.ts +0 -50
  569. package/src/forge/_generated/secretsContext.ts +0 -11
  570. package/src/forge/_generated/serverApi.ts +0 -10
  571. package/src/forge/_generated/sourceMapManifest.json +0 -2
  572. package/src/forge/_generated/sourceMapManifest.ts +0 -7
  573. package/src/forge/_generated/sqlPlan.json +0 -2
  574. package/src/forge/_generated/sqlPlan.ts +0 -88
  575. package/src/forge/_generated/subscriptionManifest.json +0 -2
  576. package/src/forge/_generated/subscriptionManifest.ts +0 -7
  577. package/src/forge/_generated/symbolicationManifest.json +0 -2
  578. package/src/forge/_generated/symbolicationManifest.ts +0 -17
  579. package/src/forge/_generated/telemetryRegistry.json +0 -2
  580. package/src/forge/_generated/telemetryRegistry.ts +0 -9
  581. package/src/forge/_generated/telemetrySinks.json +0 -2
  582. package/src/forge/_generated/telemetrySinks.ts +0 -11
  583. package/src/forge/_generated/tenantScope.json +0 -2
  584. package/src/forge/_generated/tenantScope.ts +0 -8
  585. package/src/forge/_generated/testGraph.json +0 -2
  586. package/src/forge/_generated/testGraph.ts +0 -3452
  587. package/src/forge/_generated/testPlanRegistry.json +0 -2
  588. package/src/forge/_generated/testPlanRegistry.ts +0 -33
  589. package/src/forge/_generated/uiRoutes.json +0 -2
  590. package/src/forge/_generated/uiRoutes.ts +0 -16
  591. package/src/forge/_generated/uiScenarios.json +0 -2
  592. package/src/forge/_generated/uiScenarios.ts +0 -30
  593. package/src/forge/_generated/uiTestManifest.json +0 -2
  594. package/src/forge/_generated/uiTestManifest.ts +0 -27
  595. package/src/forge/_generated/workflowRegistry.json +0 -2
  596. package/src/forge/_generated/workflowRegistry.ts +0 -9
  597. package/src/forge/_generated/workflowSubscriptions.json +0 -2
  598. package/src/forge/_generated/workflowSubscriptions.ts +0 -10
@@ -0,0 +1,498 @@
1
+ import { normalizePath } from "../compiler/primitives/paths.ts";
2
+ import { hashStable } from "../compiler/primitives/hash.ts";
3
+ import { readDeltaGitSnapshot } from "../delta/git-observer.ts";
4
+ import { redactDeltaPayload } from "../delta/redaction.ts";
5
+ import { redactAgentPayload } from "./redaction.ts";
6
+ import {
7
+ AGENT_EVENT_SCHEMA,
8
+ type AgentEventEnvelope,
9
+ type AgentMemoryIntegrationKind,
10
+ type AgentMemorySourceName,
11
+ type AgentMemoryTrustLevel,
12
+ } from "./types.ts";
13
+
14
+ export interface NormalizeAgentEventInput {
15
+ workspaceRoot: string;
16
+ source: AgentMemorySourceName | string;
17
+ eventName?: string;
18
+ integration?: AgentMemoryIntegrationKind | string;
19
+ raw: Record<string, unknown>;
20
+ now?: string;
21
+ }
22
+
23
+ export function normalizeAgentEvent(input: NormalizeAgentEventInput): AgentEventEnvelope {
24
+ const source = normalizeSource(input.source);
25
+ const rawEventName = input.eventName ?? stringField(input.raw, "hook_event_name") ?? stringField(input.raw, "event") ?? "unknown";
26
+ const normalizedKind = normalizeEventKind(source, rawEventName, input.raw);
27
+ const redacted = redactAgentPayload(input.raw);
28
+ const derived = deriveSafeHookMetadata(input.raw, rawEventName);
29
+ const git = readDeltaGitSnapshot(input.workspaceRoot);
30
+ const actorName = source === "claude-code"
31
+ ? "Claude Code"
32
+ : source === "codex"
33
+ ? "Codex"
34
+ : source === "cursor"
35
+ ? "Cursor"
36
+ : "External Agent";
37
+ return {
38
+ schema: AGENT_EVENT_SCHEMA,
39
+ source: {
40
+ agent: source,
41
+ integration: input.integration ?? defaultIntegrationForSource(source),
42
+ version: stringField(input.raw, "version") ?? "unknown",
43
+ },
44
+ workspace: {
45
+ root: normalizePath(input.workspaceRoot),
46
+ gitBranch: git.branch,
47
+ gitHead: git.head,
48
+ },
49
+ session: {
50
+ externalSessionId: stringField(input.raw, "session_id") ?? stringField(input.raw, "sessionId") ?? stringField(input.raw, "conversation_id"),
51
+ forgeSessionId: stringField(input.raw, "forgeSessionId"),
52
+ turnId: stringField(input.raw, "turn_id") ?? stringField(input.raw, "turnId"),
53
+ },
54
+ event: {
55
+ kind: normalizedKind,
56
+ timestamp: stringField(input.raw, "timestamp") ?? input.now ?? new Date().toISOString(),
57
+ },
58
+ actor: {
59
+ kind: "agent",
60
+ name: stringField(input.raw, "actor") ?? actorName,
61
+ model: stringField(input.raw, "model"),
62
+ },
63
+ payload: {
64
+ ...redacted.value,
65
+ ...derived,
66
+ },
67
+ privacy: {
68
+ rawPromptStored: false,
69
+ rawCompletionStored: false,
70
+ rawToolArgsStored: false,
71
+ transcriptImported: false,
72
+ redacted: true,
73
+ sensitiveFieldsRemoved: redacted.sensitiveFieldsRemoved,
74
+ },
75
+ capture: {
76
+ trustLevel: trustLevelForIntegration(input.integration ?? defaultIntegrationForSource(source)),
77
+ confidence: confidenceForSource(source, input.integration ?? defaultIntegrationForSource(source)),
78
+ },
79
+ };
80
+ }
81
+
82
+ export function summarizeAgentEvent(envelope: AgentEventEnvelope): string {
83
+ const tool = stringField(envelope.payload, "toolName") ??
84
+ stringField(envelope.payload, "tool_name") ??
85
+ stringField(envelope.payload, "tool");
86
+ const command = stringField(envelope.payload, "command");
87
+ const commandSummary = stringField(envelope.payload, "commandSummary");
88
+ const resultStatus = stringField(envelope.payload, "resultStatus");
89
+ const promptSummary = stringField(envelope.payload, "promptSummary") ?? stringField(envelope.payload, "userPromptSummary");
90
+ if (envelope.event.kind === "agent.prompt.submitted" && promptSummary) {
91
+ return promptSummary;
92
+ }
93
+ if (envelope.event.kind === "approval.requested") {
94
+ return `${envelope.source.agent} requested approval${tool ? ` for ${tool}` : ""}${commandSummary ? `: ${commandSummary}` : ""}`;
95
+ }
96
+ if (tool) {
97
+ const status = resultStatus ?? statusFromKind(envelope.event.kind);
98
+ return `${envelope.source.agent} ${tool}${status ? ` ${status}` : ""}${commandSummary ? `: ${commandSummary}` : ""}`;
99
+ }
100
+ if (commandSummary ?? command) {
101
+ return `${envelope.source.agent} ran ${commandSummary ?? command}`;
102
+ }
103
+ return `${envelope.source.agent} ${envelope.event.kind}`;
104
+ }
105
+
106
+ export function extractAgentEventBindings(envelope: AgentEventEnvelope): {
107
+ toolName?: string;
108
+ command?: string;
109
+ exitCode?: number;
110
+ files: string[];
111
+ entries: string[];
112
+ proofs: string[];
113
+ status?: string;
114
+ } {
115
+ const payload = envelope.payload;
116
+ return {
117
+ toolName: stringField(payload, "toolName") ?? stringField(payload, "tool_name") ?? stringField(payload, "tool"),
118
+ command: stringField(payload, "command") ?? stringField(payload, "commandSummary"),
119
+ exitCode: numberField(payload, "exitCode") ?? numberField(payload, "exit_code"),
120
+ files: uniqueStrings([
121
+ ...arrayOfStrings(payload.files),
122
+ ...arrayOfStrings(payload.paths),
123
+ ...arrayOfStrings(payload.affectedFiles),
124
+ stringField(payload, "file_path"),
125
+ stringField(payload, "filePath"),
126
+ stringField(payload, "path"),
127
+ ].map((value) => value ? normalizePath(value) : value)),
128
+ entries: uniqueStrings([
129
+ ...arrayOfStrings(payload.entries),
130
+ stringField(payload, "entryName"),
131
+ stringField(payload, "entry_name"),
132
+ stringField(payload, "runtimeEntry"),
133
+ stringField(payload, "runtime_entry"),
134
+ ]),
135
+ proofs: uniqueStrings([
136
+ ...arrayOfStrings(payload.proofs),
137
+ stringField(payload, "proofKind"),
138
+ stringField(payload, "proof_kind"),
139
+ ]),
140
+ status: statusFromKind(envelope.event.kind),
141
+ };
142
+ }
143
+
144
+ function deriveSafeHookMetadata(raw: Record<string, unknown>, eventName: string): Record<string, unknown> {
145
+ const derived: Record<string, unknown> = {};
146
+ const toolName = stringField(raw, "tool_name") ?? stringField(raw, "toolName") ?? stringField(raw, "tool");
147
+ const toolUseId = stringField(raw, "tool_use_id") ?? stringField(raw, "toolUseId");
148
+ const permissionMode = stringField(raw, "permission_mode") ?? stringField(raw, "permissionMode");
149
+ const cwd = stringField(raw, "cwd");
150
+ const trigger = stringField(raw, "trigger");
151
+ const agentId = stringField(raw, "agent_id") ?? stringField(raw, "agentId");
152
+ const agentType = stringField(raw, "agent_type") ?? stringField(raw, "agentType");
153
+ if (toolName) {
154
+ derived.toolName = toolName;
155
+ }
156
+ if (toolUseId) {
157
+ derived.toolUseId = toolUseId;
158
+ }
159
+ if (permissionMode) {
160
+ derived.permissionMode = permissionMode;
161
+ }
162
+ if (cwd) {
163
+ derived.cwd = normalizePath(cwd);
164
+ }
165
+ if (trigger) {
166
+ derived.trigger = trigger;
167
+ }
168
+ if (agentId) {
169
+ derived.agentId = agentId;
170
+ }
171
+ if (agentType) {
172
+ derived.agentType = agentType;
173
+ }
174
+
175
+ const toolInput = objectField(raw, "tool_input") ?? objectField(raw, "toolInput");
176
+ const toolResponse = objectField(raw, "tool_response") ?? objectField(raw, "toolResponse");
177
+ const command = stringField(toolInput, "command") ?? stringField(raw, "command");
178
+ if (command) {
179
+ derived.commandHash = hashStable(command);
180
+ derived.commandStored = false;
181
+ derived.commandSummary = summarizeCommand(command);
182
+ derived.commandKind = classifyCommand(toolName, command);
183
+ }
184
+ const description = stringField(toolInput, "description");
185
+ if (description) {
186
+ derived.approvalDescriptionSummary = safeSummary(description, 180);
187
+ }
188
+ const exitCode = numberField(toolResponse, "exitCode") ?? numberField(toolResponse, "exit_code") ?? numberField(raw, "exitCode") ?? numberField(raw, "exit_code");
189
+ if (exitCode !== undefined) {
190
+ derived.exitCode = exitCode;
191
+ derived.resultStatus = exitCode === 0 ? "success" : "failed";
192
+ } else {
193
+ const status = stringField(toolResponse, "status") ?? stringField(raw, "status");
194
+ if (status) {
195
+ derived.resultStatus = status;
196
+ }
197
+ }
198
+ const responseSummary = summarizeToolResponse(toolResponse);
199
+ if (responseSummary) {
200
+ derived.responseSummary = responseSummary;
201
+ }
202
+ if (toolResponse) {
203
+ derived.responseHash = hashStable(JSON.stringify(toolResponse));
204
+ derived.responseStored = false;
205
+ }
206
+
207
+ const files = uniqueStrings([
208
+ ...extractPaths(toolInput),
209
+ ...extractPaths(toolResponse),
210
+ ...extractPaths(raw),
211
+ ...extractPathsFromCommand(command),
212
+ ].map((value) => normalizePath(value)));
213
+ if (files.length > 0) {
214
+ derived.files = files;
215
+ derived.affectedFiles = files;
216
+ }
217
+ const entries = uniqueStrings([
218
+ ...extractNamedValues(toolInput, ["entry", "entryName", "entry_name", "runtimeEntry", "runtime_entry"]),
219
+ ...extractNamedValues(raw, ["entry", "entryName", "entry_name", "runtimeEntry", "runtime_entry"]),
220
+ ...extractEntriesFromCommand(command),
221
+ ]);
222
+ if (entries.length > 0) {
223
+ derived.entries = entries;
224
+ }
225
+ if (eventName === "Stop" || eventName === "SubagentStop") {
226
+ const lastMessage = stringField(raw, "last_assistant_message") ?? stringField(raw, "lastAssistantMessage");
227
+ if (lastMessage) {
228
+ derived.lastAssistantMessageHash = hashStable(lastMessage);
229
+ derived.lastAssistantMessageStored = false;
230
+ derived.lastAssistantMessageSummary = safeSummary(lastMessage, 220);
231
+ }
232
+ }
233
+ return derived;
234
+ }
235
+
236
+ function normalizeSource(source: string): AgentMemorySourceName | string {
237
+ if (source === "claude" || source === "claude-code") {
238
+ return "claude-code";
239
+ }
240
+ if (source === "codex" || source === "cursor") {
241
+ return source;
242
+ }
243
+ return source || "generic";
244
+ }
245
+
246
+ function defaultIntegrationForSource(source: string): AgentMemoryIntegrationKind {
247
+ return source === "cursor" ? "mcp" : "native-hook";
248
+ }
249
+
250
+ function trustLevelForIntegration(integration: string): AgentMemoryTrustLevel {
251
+ if (integration === "native-hook") {
252
+ return "direct-hook";
253
+ }
254
+ if (integration === "mcp") {
255
+ return "mcp-tool";
256
+ }
257
+ if (integration === "cli-wrapper") {
258
+ return "forge-command";
259
+ }
260
+ if (integration === "file-watcher") {
261
+ return "file-watcher";
262
+ }
263
+ if (integration === "git-hook") {
264
+ return "git-observer";
265
+ }
266
+ return "manual-import";
267
+ }
268
+
269
+ function confidenceForSource(source: string, integration: string): number {
270
+ if (integration === "native-hook") {
271
+ return source === "generic" ? 0.78 : 0.94;
272
+ }
273
+ if (integration === "mcp") {
274
+ return 0.9;
275
+ }
276
+ if (integration === "cli-wrapper") {
277
+ return 0.84;
278
+ }
279
+ return 0.68;
280
+ }
281
+
282
+ function normalizeEventKind(source: string, eventName: string, raw: Record<string, unknown>): string {
283
+ const canonical = eventName.replace(/\s+/g, "");
284
+ switch (canonical) {
285
+ case "SessionStart":
286
+ return "agent.session.started";
287
+ case "SessionEnd":
288
+ return "agent.session.ended";
289
+ case "UserPromptSubmit":
290
+ return "agent.prompt.submitted";
291
+ case "PreToolUse":
292
+ return "agent.tool.requested";
293
+ case "PermissionRequest":
294
+ return "approval.requested";
295
+ case "PermissionDenied":
296
+ return "approval.denied";
297
+ case "PostToolUseFailure":
298
+ return "agent.tool.failed";
299
+ case "PostToolUse":
300
+ return "agent.tool.completed";
301
+ case "SubagentStart":
302
+ return "agent.subagent.started";
303
+ case "SubagentStop":
304
+ return "agent.subagent.ended";
305
+ case "PreCompact":
306
+ return "agent.memory.compaction.requested";
307
+ case "PostCompact":
308
+ return "agent.memory.compaction.completed";
309
+ case "FileChanged":
310
+ return "agent.file.changed";
311
+ case "Stop":
312
+ return source === "codex" ? "agent.turn.stopped" : "agent.turn.completed";
313
+ default: {
314
+ const tool = stringField(raw, "toolName") ?? stringField(raw, "tool_name");
315
+ if (tool && (canonical === "tool.call" || canonical === "tool_call" || canonical === "unknown")) {
316
+ return "agent.tool.called";
317
+ }
318
+ return canonical.includes(".") ? canonical : `agent.${canonical || "event"}`;
319
+ }
320
+ }
321
+ }
322
+
323
+ function statusFromKind(kind: string): string | undefined {
324
+ if (kind.endsWith(".completed") || kind === "agent.tool.called") {
325
+ return "completed";
326
+ }
327
+ if (kind.endsWith(".failed")) {
328
+ return "failed";
329
+ }
330
+ if (kind.endsWith(".requested")) {
331
+ return "requested";
332
+ }
333
+ if (kind.endsWith(".denied")) {
334
+ return "denied";
335
+ }
336
+ return undefined;
337
+ }
338
+
339
+ function objectField(value: Record<string, unknown>, key: string): Record<string, unknown> | undefined {
340
+ const field = value[key];
341
+ return field && typeof field === "object" && !Array.isArray(field) ? field as Record<string, unknown> : undefined;
342
+ }
343
+
344
+ function stringField(value: Record<string, unknown> | undefined, key: string): string | undefined {
345
+ const field = value?.[key];
346
+ return typeof field === "string" && field.length > 0 ? field : undefined;
347
+ }
348
+
349
+ function numberField(value: Record<string, unknown> | undefined, key: string): number | undefined {
350
+ const field = value?.[key];
351
+ return typeof field === "number" && Number.isFinite(field) ? field : undefined;
352
+ }
353
+
354
+ function arrayOfStrings(value: unknown): string[] {
355
+ return Array.isArray(value) ? value.filter((item): item is string => typeof item === "string" && item.length > 0) : [];
356
+ }
357
+
358
+ function uniqueStrings(values: Array<string | undefined>): string[] {
359
+ return [...new Set(values.filter((value): value is string => typeof value === "string" && value.length > 0))];
360
+ }
361
+
362
+ function summarizeCommand(command: string): string {
363
+ const normalized = command.replace(/\s+/g, " ").trim();
364
+ const singleLine = normalized.length > 220 ? `${normalized.slice(0, 217)}...` : normalized;
365
+ return safeSummary(singleLine, 220);
366
+ }
367
+
368
+ function safeSummary(value: string, maxLength: number): string {
369
+ const normalized = value.replace(/\s+/g, " ").trim();
370
+ const clipped = normalized.length > maxLength ? `${normalized.slice(0, Math.max(0, maxLength - 3))}...` : normalized;
371
+ const redacted = redactDeltaPayload({ summary: scrubSecretTokens(clipped) }).value.summary;
372
+ return typeof redacted === "string" ? redacted : clipped;
373
+ }
374
+
375
+ function scrubSecretTokens(value: string): string {
376
+ return value
377
+ .replace(/\bsk[-_][A-Za-z0-9_\-.]{8,}\b/g, "[REDACTED]")
378
+ .replace(/\bnpm_[A-Za-z0-9]{16,}\b/g, "[REDACTED]")
379
+ .replace(/\bgh[pousr]_[A-Za-z0-9_]{16,}\b/g, "[REDACTED]")
380
+ .replace(/\b(?:xox[baprs]-)[A-Za-z0-9-]{16,}\b/g, "[REDACTED]");
381
+ }
382
+
383
+ function classifyCommand(toolName: string | undefined, command: string): string {
384
+ if (toolName === "apply_patch") {
385
+ return "patch";
386
+ }
387
+ if (toolName?.startsWith("mcp__")) {
388
+ return "mcp";
389
+ }
390
+ if (/\b(git|npm|pnpm|bun|yarn|node|forge|gh|python|pytest|mvn|gradle)\b/.test(command)) {
391
+ return "shell";
392
+ }
393
+ return toolName ?? "command";
394
+ }
395
+
396
+ function summarizeToolResponse(value: Record<string, unknown> | undefined): string | undefined {
397
+ if (!value) {
398
+ return undefined;
399
+ }
400
+ const candidate = stringField(value, "summary") ??
401
+ stringField(value, "message") ??
402
+ stringField(value, "stderr") ??
403
+ stringField(value, "stdout") ??
404
+ stringField(value, "output") ??
405
+ stringField(value, "result");
406
+ return candidate ? safeSummary(candidate, 220) : undefined;
407
+ }
408
+
409
+ function extractPaths(value: unknown): string[] {
410
+ const paths: string[] = [];
411
+ visit(value, (key, child) => {
412
+ if (typeof child === "string" && isPathLikeKey(key) && looksLikePath(child)) {
413
+ paths.push(child);
414
+ }
415
+ if (Array.isArray(child) && isPathListKey(key)) {
416
+ for (const item of child) {
417
+ if (typeof item === "string" && looksLikePath(item)) {
418
+ paths.push(item);
419
+ }
420
+ }
421
+ }
422
+ });
423
+ return paths;
424
+ }
425
+
426
+ function extractNamedValues(value: unknown, keys: string[]): string[] {
427
+ const wanted = new Set(keys);
428
+ const values: string[] = [];
429
+ visit(value, (key, child) => {
430
+ if (wanted.has(key) && typeof child === "string" && child.length > 0) {
431
+ values.push(child);
432
+ }
433
+ });
434
+ return values;
435
+ }
436
+
437
+ function extractPathsFromCommand(command: string | undefined): string[] {
438
+ if (!command) {
439
+ return [];
440
+ }
441
+ const paths: string[] = [];
442
+ const patchPattern = /^\*\*\* (?:Add|Update|Delete) File: (.+)$/gm;
443
+ for (const match of command.matchAll(patchPattern)) {
444
+ if (match[1]) {
445
+ paths.push(match[1].trim());
446
+ }
447
+ }
448
+ const literalPathPattern = /(?:-LiteralPath|-Path)\s+["']?([^"'\s]+)["']?/g;
449
+ for (const match of command.matchAll(literalPathPattern)) {
450
+ if (match[1] && looksLikePath(match[1])) {
451
+ paths.push(match[1]);
452
+ }
453
+ }
454
+ return paths;
455
+ }
456
+
457
+ function extractEntriesFromCommand(command: string | undefined): string[] {
458
+ if (!command) {
459
+ return [];
460
+ }
461
+ const entries: string[] = [];
462
+ const forgeEntryPattern = /\b(?:run|query|explain|timeline)\s+([a-zA-Z0-9_.:-]+)/g;
463
+ for (const match of command.matchAll(forgeEntryPattern)) {
464
+ const value = match[1];
465
+ if (value && value.includes(".")) {
466
+ entries.push(value);
467
+ }
468
+ }
469
+ return entries;
470
+ }
471
+
472
+ function visit(value: unknown, callback: (key: string, value: unknown) => void, depth = 0): void {
473
+ if (!value || typeof value !== "object" || depth > 4) {
474
+ return;
475
+ }
476
+ if (Array.isArray(value)) {
477
+ for (const item of value.slice(0, 50)) {
478
+ visit(item, callback, depth + 1);
479
+ }
480
+ return;
481
+ }
482
+ for (const [key, child] of Object.entries(value as Record<string, unknown>)) {
483
+ callback(key, child);
484
+ visit(child, callback, depth + 1);
485
+ }
486
+ }
487
+
488
+ function isPathLikeKey(key: string): boolean {
489
+ return /^(file|filePath|file_path|path|uri|absolutePath|relativePath)$/i.test(key);
490
+ }
491
+
492
+ function isPathListKey(key: string): boolean {
493
+ return /^(files|paths|changedFiles|affectedFiles|artifact_paths|artifactPaths)$/i.test(key);
494
+ }
495
+
496
+ function looksLikePath(value: string): boolean {
497
+ return /[\\/]/.test(value) || /\.(ts|tsx|js|jsx|mjs|cjs|json|md|mdx|sql|css|html|yml|yaml|toml|lock|java|go|py|ps1)$/i.test(value);
498
+ }
@@ -0,0 +1,103 @@
1
+ import { hashStable } from "../compiler/primitives/hash.ts";
2
+ import { redactDeltaPayload } from "../delta/redaction.ts";
3
+
4
+ const RAW_TEXT_KEYS = new Set([
5
+ "prompt",
6
+ "userPrompt",
7
+ "last_assistant_message",
8
+ "lastAssistantMessage",
9
+ "completion",
10
+ "message",
11
+ "transcript",
12
+ "transcript_path",
13
+ "transcriptPath",
14
+ "output",
15
+ "stdout",
16
+ "stderr",
17
+ "result",
18
+ ]);
19
+
20
+ const RAW_ARGS_KEYS = new Set(["args", "arguments", "tool_input", "toolInput", "tool_response", "toolResponse", "input"]);
21
+
22
+ export interface AgentPayloadRedaction {
23
+ value: Record<string, unknown>;
24
+ sensitiveFieldsRemoved: string[];
25
+ }
26
+
27
+ export function redactAgentPayload(payload: Record<string, unknown>): AgentPayloadRedaction {
28
+ const removed: string[] = [];
29
+ const coarse = stripRawPayload(payload, [], removed) as Record<string, unknown>;
30
+ const redacted = redactDeltaPayload(coarse);
31
+ return {
32
+ value: redacted.value,
33
+ sensitiveFieldsRemoved: [...new Set([...removed, ...redacted.redaction.diagnostics])],
34
+ };
35
+ }
36
+
37
+ function stripRawPayload(value: unknown, path: string[], removed: string[]): unknown {
38
+ if (Array.isArray(value)) {
39
+ return value.slice(0, 50).map((item, index) => stripRawPayload(item, [...path, String(index)], removed));
40
+ }
41
+ if (!value || typeof value !== "object") {
42
+ return value;
43
+ }
44
+ const output: Record<string, unknown> = {};
45
+ for (const [key, child] of Object.entries(value as Record<string, unknown>)) {
46
+ const nextPath = [...path, key];
47
+ if (RAW_TEXT_KEYS.has(key)) {
48
+ removed.push(nextPath.join("."));
49
+ output[`${key}Hash`] = typeof child === "string" ? hashStable(child) : hashStable(JSON.stringify(child ?? null));
50
+ output[`${key}Stored`] = false;
51
+ if (typeof child === "string" && !isPromptLikeKey(key)) {
52
+ const summary = summarizeText(child);
53
+ if (summary) {
54
+ output[`${key}Summary`] = redactDeltaPayload({ summary }).value.summary;
55
+ }
56
+ }
57
+ continue;
58
+ }
59
+ if (RAW_ARGS_KEYS.has(key)) {
60
+ removed.push(nextPath.join("."));
61
+ output[`${key}Hash`] = hashStable(JSON.stringify(child ?? null));
62
+ output[`${key}Stored`] = false;
63
+ output[`${key}Shape`] = describeShape(child);
64
+ continue;
65
+ }
66
+ output[key] = stripRawPayload(child, nextPath, removed);
67
+ }
68
+ return output;
69
+ }
70
+
71
+ function isPromptLikeKey(key: string): boolean {
72
+ return key.toLowerCase().includes("prompt") || key.toLowerCase().includes("completion") || key.toLowerCase().includes("message");
73
+ }
74
+
75
+ function summarizeText(value: string): string | undefined {
76
+ const normalized = value.replace(/\s+/g, " ").trim();
77
+ if (!normalized) {
78
+ return undefined;
79
+ }
80
+ const clipped = normalized.length > 160 ? `${normalized.slice(0, 157)}...` : normalized;
81
+ return scrubSecretTokens(clipped);
82
+ }
83
+
84
+ function describeShape(value: unknown): unknown {
85
+ if (Array.isArray(value)) {
86
+ return { kind: "array", length: value.length };
87
+ }
88
+ if (value && typeof value === "object") {
89
+ return {
90
+ kind: "object",
91
+ keys: Object.keys(value as Record<string, unknown>).slice(0, 20).sort(),
92
+ };
93
+ }
94
+ return { kind: typeof value };
95
+ }
96
+
97
+ function scrubSecretTokens(value: string): string {
98
+ return value
99
+ .replace(/\bsk[-_][A-Za-z0-9_\-.]{8,}\b/g, "[REDACTED]")
100
+ .replace(/\bnpm_[A-Za-z0-9]{16,}\b/g, "[REDACTED]")
101
+ .replace(/\bgh[pousr]_[A-Za-z0-9_]{16,}\b/g, "[REDACTED]")
102
+ .replace(/\b(?:xox[baprs]-)[A-Za-z0-9-]{16,}\b/g, "[REDACTED]");
103
+ }
@@ -0,0 +1,51 @@
1
+ import type { AgentInstallResult } from "../types.ts";
2
+ import { privacyDefaults } from "./codex.ts";
3
+
4
+ const CLAUDE_EVENTS = [
5
+ "SessionStart",
6
+ "UserPromptSubmit",
7
+ "PreToolUse",
8
+ "PermissionRequest",
9
+ "PostToolUse",
10
+ "PostToolUseFailure",
11
+ "PermissionDenied",
12
+ "FileChanged",
13
+ "SubagentStart",
14
+ "SubagentStop",
15
+ "Stop",
16
+ "SessionEnd",
17
+ ];
18
+
19
+ export function claudeCodeInstallFiles(): Array<{ path: string; content: string }> {
20
+ const settings = {
21
+ hooks: Object.fromEntries(CLAUDE_EVENTS.map((event) => [
22
+ event,
23
+ [
24
+ {
25
+ matcher: "*",
26
+ hooks: [
27
+ {
28
+ type: "command",
29
+ command: `forge agent ingest claude-code --event ${event}`,
30
+ },
31
+ ],
32
+ },
33
+ ],
34
+ ])),
35
+ };
36
+ return [
37
+ { path: ".claude/settings.json", content: `${JSON.stringify(settings, null, 2)}\n` },
38
+ ];
39
+ }
40
+
41
+ export function claudeCodeInstallResult(filesWritten: string[], filesPlanned: string[]): AgentInstallResult {
42
+ return {
43
+ ok: true,
44
+ target: "claude-code",
45
+ filesWritten,
46
+ filesPlanned,
47
+ privacy: privacyDefaults(),
48
+ warnings: ["Claude transcript imports are opt-in only; hooks store redacted project memory."],
49
+ exitCode: 0,
50
+ };
51
+ }