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.
- package/.npmignore +4 -0
- package/AGENTS.md +168 -81
- package/CHANGELOG.md +211 -0
- package/README.md +88 -14
- package/adapters/go/README.md +23 -0
- package/adapters/go/go.mod +3 -0
- package/adapters/go/http.go +149 -0
- package/adapters/go/registry.go +234 -0
- package/adapters/go/types.go +136 -0
- package/adapters/java/README.md +68 -0
- package/adapters/java/pom.xml +34 -0
- package/adapters/java/src/main/java/dev/forgeos/adapter/Auth.java +20 -0
- package/adapters/java/src/main/java/dev/forgeos/adapter/Diagnostic.java +16 -0
- package/adapters/java/src/main/java/dev/forgeos/adapter/Entry.java +38 -0
- package/adapters/java/src/main/java/dev/forgeos/adapter/EntryKind.java +16 -0
- package/adapters/java/src/main/java/dev/forgeos/adapter/ErrorInfo.java +4 -0
- package/adapters/java/src/main/java/dev/forgeos/adapter/Forge.java +94 -0
- package/adapters/java/src/main/java/dev/forgeos/adapter/ForgeCall.java +12 -0
- package/adapters/java/src/main/java/dev/forgeos/adapter/ForgeContext.java +11 -0
- package/adapters/java/src/main/java/dev/forgeos/adapter/ForgeHandler.java +8 -0
- package/adapters/java/src/main/java/dev/forgeos/adapter/ForgeHttpHandler.java +179 -0
- package/adapters/java/src/main/java/dev/forgeos/adapter/ForgeRegistry.java +121 -0
- package/adapters/java/src/main/java/dev/forgeos/adapter/Json.java +14 -0
- package/adapters/java/src/main/java/dev/forgeos/adapter/Manifest.java +14 -0
- package/adapters/java/src/main/java/dev/forgeos/adapter/RequestEnvelope.java +6 -0
- package/adapters/java/src/main/java/dev/forgeos/adapter/ResponseEnvelope.java +25 -0
- package/adapters/java/src/main/java/dev/forgeos/adapter/Risk.java +18 -0
- package/adapters/java/src/main/java/dev/forgeos/adapter/Schemas.java +36 -0
- package/adapters/java/src/main/java/dev/forgeos/adapter/Service.java +65 -0
- package/adapters/java/src/main/java/dev/forgeos/adapter/TransactionMode.java +18 -0
- package/adapters/java/src/main/java/dev/forgeos/adapter/TypedForgeHandler.java +6 -0
- package/adapters/java/target/classes/dev/forgeos/adapter/Auth.class +0 -0
- package/adapters/java/target/classes/dev/forgeos/adapter/Diagnostic.class +0 -0
- package/adapters/java/target/classes/dev/forgeos/adapter/Entry.class +0 -0
- package/adapters/java/target/classes/dev/forgeos/adapter/EntryKind.class +0 -0
- package/adapters/java/target/classes/dev/forgeos/adapter/ErrorInfo.class +0 -0
- package/adapters/java/target/classes/dev/forgeos/adapter/Forge.class +0 -0
- package/adapters/java/target/classes/dev/forgeos/adapter/ForgeCall.class +0 -0
- package/adapters/java/target/classes/dev/forgeos/adapter/ForgeContext.class +0 -0
- package/adapters/java/target/classes/dev/forgeos/adapter/ForgeHandler.class +0 -0
- package/adapters/java/target/classes/dev/forgeos/adapter/ForgeHttpHandler.class +0 -0
- package/adapters/java/target/classes/dev/forgeos/adapter/ForgeRegistry$EntryOption.class +0 -0
- package/adapters/java/target/classes/dev/forgeos/adapter/ForgeRegistry$RegisteredEntry.class +0 -0
- package/adapters/java/target/classes/dev/forgeos/adapter/ForgeRegistry$RegistryOption.class +0 -0
- package/adapters/java/target/classes/dev/forgeos/adapter/ForgeRegistry.class +0 -0
- package/adapters/java/target/classes/dev/forgeos/adapter/Json.class +0 -0
- package/adapters/java/target/classes/dev/forgeos/adapter/Manifest.class +0 -0
- package/adapters/java/target/classes/dev/forgeos/adapter/RequestEnvelope.class +0 -0
- package/adapters/java/target/classes/dev/forgeos/adapter/ResponseEnvelope.class +0 -0
- package/adapters/java/target/classes/dev/forgeos/adapter/Risk.class +0 -0
- package/adapters/java/target/classes/dev/forgeos/adapter/Schemas.class +0 -0
- package/adapters/java/target/classes/dev/forgeos/adapter/Service.class +0 -0
- package/adapters/java/target/classes/dev/forgeos/adapter/TransactionMode.class +0 -0
- package/adapters/java/target/classes/dev/forgeos/adapter/TypedForgeHandler.class +0 -0
- package/adapters/java/target/forge-java-adapter-0.1.0-alpha.11.jar +0 -0
- package/adapters/java/target/maven-archiver/pom.properties +3 -0
- package/adapters/java/target/maven-status/maven-compiler-plugin/compile/default-compile/createdFiles.lst +23 -0
- package/adapters/java/target/maven-status/maven-compiler-plugin/compile/default-compile/inputFiles.lst +20 -0
- package/adapters/java-spring-boot-starter/README.md +32 -0
- package/adapters/java-spring-boot-starter/pom.xml +36 -0
- package/adapters/java-spring-boot-starter/src/main/java/dev/forgeos/adapter/spring/ForgeCommand.java +22 -0
- package/adapters/java-spring-boot-starter/src/main/java/dev/forgeos/adapter/spring/ForgeExternalService.java +15 -0
- package/adapters/java-spring-boot-starter/src/main/java/dev/forgeos/adapter/spring/ForgeQuery.java +16 -0
- package/adapters/java-spring-boot-starter/src/main/java/dev/forgeos/adapter/spring/ForgeServiceBeanCondition.java +18 -0
- package/adapters/java-spring-boot-starter/src/main/java/dev/forgeos/adapter/spring/ForgeSpringAutoConfiguration.java +16 -0
- package/adapters/java-spring-boot-starter/src/main/java/dev/forgeos/adapter/spring/ForgeSpringRuntime.java +104 -0
- package/adapters/java-spring-boot-starter/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports +1 -0
- package/adapters/java-spring-boot-starter/target/classes/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports +1 -0
- package/adapters/java-spring-boot-starter/target/classes/dev/forgeos/adapter/spring/ForgeCommand.class +0 -0
- package/adapters/java-spring-boot-starter/target/classes/dev/forgeos/adapter/spring/ForgeExternalService.class +0 -0
- package/adapters/java-spring-boot-starter/target/classes/dev/forgeos/adapter/spring/ForgeQuery.class +0 -0
- package/adapters/java-spring-boot-starter/target/classes/dev/forgeos/adapter/spring/ForgeServiceBeanCondition.class +0 -0
- package/adapters/java-spring-boot-starter/target/classes/dev/forgeos/adapter/spring/ForgeSpringAutoConfiguration.class +0 -0
- package/adapters/java-spring-boot-starter/target/classes/dev/forgeos/adapter/spring/ForgeSpringRuntime.class +0 -0
- package/adapters/java-spring-boot-starter/target/forge-java-spring-boot-starter-0.1.0-alpha.11.jar +0 -0
- package/adapters/java-spring-boot-starter/target/maven-archiver/pom.properties +3 -0
- package/adapters/java-spring-boot-starter/target/maven-status/maven-compiler-plugin/compile/default-compile/createdFiles.lst +6 -0
- package/adapters/java-spring-boot-starter/target/maven-status/maven-compiler-plugin/compile/default-compile/inputFiles.lst +6 -0
- package/bin/forge.mjs +18 -0
- package/docs/changelog.md +242 -0
- package/docs/forge-protocol.md +189 -0
- package/examples/go-billing/go.mod +7 -0
- package/examples/go-billing/main.go +120 -0
- package/examples/java-billing/pom.xml +52 -0
- package/examples/java-billing/src/main/java/dev/forgeos/examples/billing/CreateInvoiceInput.java +4 -0
- package/examples/java-billing/src/main/java/dev/forgeos/examples/billing/Invoice.java +11 -0
- package/examples/java-billing/src/main/java/dev/forgeos/examples/billing/Main.java +127 -0
- package/examples/java-billing/target/classes/dev/forgeos/examples/billing/CreateInvoiceInput.class +0 -0
- package/examples/java-billing/target/classes/dev/forgeos/examples/billing/Invoice.class +0 -0
- package/examples/java-billing/target/classes/dev/forgeos/examples/billing/Main$EmptyInput.class +0 -0
- package/examples/java-billing/target/classes/dev/forgeos/examples/billing/Main$Options.class +0 -0
- package/examples/java-billing/target/classes/dev/forgeos/examples/billing/Main.class +0 -0
- package/examples/java-billing/target/java-billing-0.1.0-alpha.11-all.jar +0 -0
- package/examples/java-billing/target/java-billing-0.1.0-alpha.11.jar +0 -0
- package/examples/java-billing/target/maven-archiver/pom.properties +3 -0
- package/examples/java-billing/target/maven-status/maven-compiler-plugin/compile/default-compile/createdFiles.lst +5 -0
- package/examples/java-billing/target/maven-status/maven-compiler-plugin/compile/default-compile/inputFiles.lst +3 -0
- package/package.json +29 -7
- package/schemas/forge-manifest.schema.json +57 -0
- package/src/forge/_generated/releaseManifest.json +1 -2
- package/src/forge/_generated/releaseManifest.ts +3 -3
- package/src/forge/agent-adapters/index.ts +1511 -123
- package/src/forge/agent-adapters/types.ts +216 -1
- package/src/forge/agent-memory/bridge.ts +1245 -0
- package/src/forge/agent-memory/context-pack.ts +151 -0
- package/src/forge/agent-memory/hook-runner.ts +312 -0
- package/src/forge/agent-memory/mcp.ts +224 -0
- package/src/forge/agent-memory/normalize.ts +498 -0
- package/src/forge/agent-memory/redaction.ts +103 -0
- package/src/forge/agent-memory/sources/claude-code.ts +51 -0
- package/src/forge/agent-memory/sources/codex-hook-runner.mjs +273 -0
- package/src/forge/agent-memory/sources/codex.ts +119 -0
- package/src/forge/agent-memory/sources/cursor.ts +35 -0
- package/src/forge/agent-memory/types.ts +191 -0
- package/src/forge/bench.ts +248 -0
- package/src/forge/brownfield-import/index.ts +801 -0
- package/src/forge/brownfield-import/types.ts +127 -0
- package/src/forge/cair/action-journal.ts +61 -0
- package/src/forge/cair/action-parser.ts +314 -0
- package/src/forge/cair/action-validator.ts +40 -0
- package/src/forge/cair/actions.ts +1818 -0
- package/src/forge/cair/format.ts +77 -0
- package/src/forge/cair/index.ts +106 -0
- package/src/forge/cair/query.ts +478 -0
- package/src/forge/cair/snapshot.ts +315 -0
- package/src/forge/cair/types.ts +248 -0
- package/src/forge/cli/ai.ts +671 -3
- package/src/forge/cli/auth.ts +36 -1
- package/src/forge/cli/build.ts +20 -4
- package/src/forge/cli/changed.ts +300 -0
- package/src/forge/cli/codex-app-server.ts +877 -0
- package/src/forge/cli/commands.ts +1285 -7
- package/src/forge/cli/db.ts +121 -2
- package/src/forge/cli/deps.ts +79 -12
- package/src/forge/cli/dev.ts +502 -38
- package/src/forge/cli/docs.ts +265 -0
- package/src/forge/cli/handoff.ts +250 -0
- package/src/forge/cli/index.ts +1 -0
- package/src/forge/cli/main.ts +49 -3
- package/src/forge/cli/new.ts +3 -1
- package/src/forge/cli/next-actions.ts +23 -0
- package/src/forge/cli/output.ts +290 -1
- package/src/forge/cli/parse.ts +770 -36
- package/src/forge/cli/query.ts +32 -0
- package/src/forge/cli/release.ts +35 -11
- package/src/forge/cli/rls.ts +568 -17
- package/src/forge/cli/run.ts +41 -0
- package/src/forge/cli/secrets.ts +46 -1
- package/src/forge/cli/security.ts +381 -0
- package/src/forge/cli/self-host.ts +56 -14
- package/src/forge/cli/studio.ts +2163 -0
- package/src/forge/cli/verify.ts +1422 -32
- package/src/forge/compiler/agent-contract/build.ts +725 -41
- package/src/forge/compiler/agent-contract/types.ts +85 -0
- package/src/forge/compiler/ai-registry/build.ts +62 -1
- package/src/forge/compiler/ai-registry/constants.ts +1 -1
- package/src/forge/compiler/ai-registry/parse.ts +168 -5
- package/src/forge/compiler/api-surface/build.ts +47 -0
- package/src/forge/compiler/app-graph/build.ts +68 -8
- package/src/forge/compiler/app-graph/extract.ts +107 -0
- package/src/forge/compiler/app-graph/forge-apis.ts +1 -0
- package/src/forge/compiler/app-graph/module-graph.ts +73 -78
- package/src/forge/compiler/app-graph/parser.ts +24 -24
- package/src/forge/compiler/app-graph/profile.ts +26 -0
- package/src/forge/compiler/app-graph/versions.ts +1 -1
- package/src/forge/compiler/classifier/capabilities.ts +3 -2
- package/src/forge/compiler/classifier/classify.ts +32 -8
- package/src/forge/compiler/classifier/secrets.ts +3 -2
- package/src/forge/compiler/classifier/signals.ts +91 -1
- package/src/forge/compiler/client-sdk/build-manifest.ts +59 -0
- package/src/forge/compiler/client-sdk/render-client.ts +188 -13
- package/src/forge/compiler/data-graph/parse.ts +3 -3
- package/src/forge/compiler/data-graph/sql/ddl.ts +60 -2
- package/src/forge/compiler/data-graph/sql/serialize.ts +4 -0
- package/src/forge/compiler/data-graph/sql/types.ts +1 -0
- package/src/forge/compiler/dev-manifest/build.ts +3 -0
- package/src/forge/compiler/diagnostics/codes.ts +35 -0
- package/src/forge/compiler/diagnostics/create.ts +8 -3
- package/src/forge/compiler/diagnostics/index.ts +2 -0
- package/src/forge/compiler/emitter/barrel.ts +3 -0
- package/src/forge/compiler/emitter/render.ts +5 -0
- package/src/forge/compiler/external-manifest/registry.ts +205 -0
- package/src/forge/compiler/external-manifest/types.ts +91 -0
- package/src/forge/compiler/external-manifest/validate.ts +373 -0
- package/src/forge/compiler/frontend-graph/build.ts +85 -13
- package/src/forge/compiler/integration/add.ts +498 -22
- package/src/forge/compiler/integration/snapshot.ts +2 -0
- package/src/forge/compiler/make-registry/build.ts +19 -7
- package/src/forge/compiler/orchestrator/plan-profile.ts +23 -0
- package/src/forge/compiler/orchestrator/plan.ts +78 -7
- package/src/forge/compiler/orchestrator/profile.ts +65 -0
- package/src/forge/compiler/orchestrator/run.ts +97 -31
- package/src/forge/compiler/orchestrator/serialize.ts +101 -8
- package/src/forge/compiler/package-graph/compiler.ts +13 -3
- package/src/forge/compiler/package-manager/adapter.ts +4 -1
- package/src/forge/compiler/package-manager/commands.ts +4 -0
- package/src/forge/compiler/package-manager/executor.ts +30 -1
- package/src/forge/compiler/policy-registry/build.ts +44 -1
- package/src/forge/compiler/test-graph/build.ts +11 -3
- package/src/forge/compiler/types/ai-registry.ts +25 -1
- package/src/forge/compiler/types/app-graph.ts +9 -2
- package/src/forge/compiler/types/cli.ts +76 -1
- package/src/forge/compiler/types/dev-manifest.ts +3 -0
- package/src/forge/compiler/types/frontend-graph.ts +2 -2
- package/src/forge/delta/classifier.ts +52 -0
- package/src/forge/delta/explain.ts +126 -0
- package/src/forge/delta/git-observer.ts +43 -0
- package/src/forge/delta/ids.ts +44 -0
- package/src/forge/delta/index.ts +13 -0
- package/src/forge/delta/recorder.ts +402 -0
- package/src/forge/delta/redaction.ts +50 -0
- package/src/forge/delta/schema.ts +240 -0
- package/src/forge/delta/session.ts +142 -0
- package/src/forge/delta/status.ts +489 -0
- package/src/forge/delta/store.ts +2975 -0
- package/src/forge/delta/timeline.ts +104 -0
- package/src/forge/dev/server.ts +768 -15
- package/src/forge/dev/types.ts +15 -1
- package/src/forge/dev/watch.ts +17 -7
- package/src/forge/dev-console/cycle.ts +233 -21
- package/src/forge/dev-console/types.ts +46 -1
- package/src/forge/impact/index.ts +46 -8
- package/src/forge/impact/types.ts +6 -0
- package/src/forge/intent/index.ts +35 -16
- package/src/forge/make/index.ts +149 -6
- package/src/forge/make/templates.ts +343 -2
- package/src/forge/make/types.ts +3 -1
- package/src/forge/refactor/index.ts +1 -0
- package/src/forge/repair/rules/index.ts +2 -2
- package/src/forge/review/index.ts +158 -12
- package/src/forge/review/types.ts +15 -0
- package/src/forge/runtime/ai/context.ts +210 -5
- package/src/forge/runtime/ai/types.ts +70 -0
- package/src/forge/runtime/auth/claims.ts +32 -0
- package/src/forge/runtime/auth/errors.ts +2 -0
- package/src/forge/runtime/context/create-context.ts +30 -6
- package/src/forge/runtime/db/generated-client.ts +13 -2
- package/src/forge/runtime/db/memory-adapter.ts +2 -2
- package/src/forge/runtime/db/pglite-adapter.ts +77 -2
- package/src/forge/runtime/db/postgres-adapter.ts +6 -3
- package/src/forge/runtime/executor.ts +112 -2
- package/src/forge/runtime/external/bridge.ts +649 -0
- package/src/forge/runtime/runner/run-entry.ts +16 -7
- package/src/forge/runtime/telemetry/scrubber.ts +91 -10
- package/src/forge/runtime/webhooks/security.ts +184 -0
- package/src/forge/server.ts +100 -2
- package/src/forge/version.ts +1 -1
- package/src/forge/vue/index.ts +407 -0
- package/src/forge/workspace/change-summary.ts +209 -0
- package/src/forge/workspace/forge-cli.ts +14 -0
- package/src/forge/workspace/git-summary.ts +279 -0
- package/templates/agent-workroom/AGENTS.md +29 -0
- package/templates/agent-workroom/README.md +34 -0
- package/templates/agent-workroom/forge.config.ts +3 -0
- package/templates/agent-workroom/package.json +33 -0
- package/templates/agent-workroom/src/actions/indexAgentSignal.ts +10 -0
- package/templates/agent-workroom/src/commands/openWorkroom.ts +61 -0
- package/templates/agent-workroom/src/commands/recordAgentSignal.ts +119 -0
- package/templates/agent-workroom/src/commands/recordCheckRun.ts +52 -0
- package/templates/agent-workroom/src/forge/schema.ts +54 -0
- package/templates/agent-workroom/src/policies.ts +6 -0
- package/templates/agent-workroom/src/queries/listWorkrooms.ts +11 -0
- package/templates/agent-workroom/src/queries/liveWorkroom.ts +63 -0
- package/templates/agent-workroom/tsconfig.json +16 -0
- package/templates/agent-workroom/web/index.html +12 -0
- package/templates/agent-workroom/web/package.json +21 -0
- package/templates/agent-workroom/web/src/App.tsx +345 -0
- package/templates/agent-workroom/web/src/lib/forge.ts +13 -0
- package/templates/agent-workroom/web/src/main.tsx +13 -0
- package/templates/agent-workroom/web/src/styles.css +545 -0
- package/templates/agent-workroom/web/tsconfig.json +27 -0
- package/templates/b2b-support-web/package.json +2 -0
- package/templates/b2b-support-web/tsconfig.json +4 -1
- package/templates/b2b-support-web/web/package.json +1 -1
- package/templates/minimal-web/package.json +2 -1
- package/templates/minimal-web/tsconfig.json +3 -1
- package/templates/minimal-web/web/package.json +2 -2
- package/src/forge/_generated/actionSubscriptions.json +0 -2
- package/src/forge/_generated/actionSubscriptions.ts +0 -10
- package/src/forge/_generated/agentAdapterManifest.json +0 -2
- package/src/forge/_generated/agentAdapterManifest.ts +0 -73
- package/src/forge/_generated/agentContract.json +0 -2
- package/src/forge/_generated/agentContract.ts +0 -7696
- package/src/forge/_generated/agentQuickstart.md +0 -32
- package/src/forge/_generated/aiContext.ts +0 -59
- package/src/forge/_generated/aiModels.json +0 -2
- package/src/forge/_generated/aiModels.ts +0 -35
- package/src/forge/_generated/aiProviders.json +0 -2
- package/src/forge/_generated/aiProviders.ts +0 -23
- package/src/forge/_generated/aiRegistry.json +0 -2
- package/src/forge/_generated/aiRegistry.ts +0 -29
- package/src/forge/_generated/api.json +0 -2
- package/src/forge/_generated/api.ts +0 -8
- package/src/forge/_generated/appGraph.json +0 -2
- package/src/forge/_generated/appGraph.ts +0 -14667
- package/src/forge/_generated/appMap.md +0 -35
- package/src/forge/_generated/artifactManifest.json +0 -2
- package/src/forge/_generated/artifactManifest.ts +0 -7
- package/src/forge/_generated/authClaims.json +0 -2
- package/src/forge/_generated/authClaims.ts +0 -13
- package/src/forge/_generated/authConfig.json +0 -2
- package/src/forge/_generated/authConfig.ts +0 -17
- package/src/forge/_generated/authContext.ts +0 -23
- package/src/forge/_generated/authRegistry.json +0 -2
- package/src/forge/_generated/authRegistry.ts +0 -25
- package/src/forge/_generated/buildInfo.json +0 -2
- package/src/forge/_generated/buildInfo.ts +0 -9
- package/src/forge/_generated/capabilityMap.json +0 -2
- package/src/forge/_generated/capabilityMap.md +0 -15
- package/src/forge/_generated/capabilityMap.ts +0 -17
- package/src/forge/_generated/client.ts +0 -282
- package/src/forge/_generated/clientApi.ts +0 -9
- package/src/forge/_generated/clientManifest.json +0 -2
- package/src/forge/_generated/clientManifest.ts +0 -39
- package/src/forge/_generated/clientTypes.ts +0 -78
- package/src/forge/_generated/configRegistry.json +0 -2
- package/src/forge/_generated/configRegistry.ts +0 -4
- package/src/forge/_generated/dataGraph.json +0 -2
- package/src/forge/_generated/dataGraph.ts +0 -8
- package/src/forge/_generated/db.json +0 -2
- package/src/forge/_generated/db.ts +0 -2
- package/src/forge/_generated/dbSecurityManifest.json +0 -2
- package/src/forge/_generated/dbSecurityManifest.ts +0 -15
- package/src/forge/_generated/dbSessionContext.json +0 -2
- package/src/forge/_generated/dbSessionContext.ts +0 -39
- package/src/forge/_generated/deployManifest.json +0 -2
- package/src/forge/_generated/deployManifest.ts +0 -14
- package/src/forge/_generated/devManifest.json +0 -2
- package/src/forge/_generated/devManifest.ts +0 -47
- package/src/forge/_generated/envSchema.json +0 -2
- package/src/forge/_generated/envSchema.ts +0 -59
- package/src/forge/_generated/frontendGraph.json +0 -2
- package/src/forge/_generated/frontendGraph.ts +0 -27
- package/src/forge/_generated/importGuards.json +0 -2
- package/src/forge/_generated/importGuards.ts +0 -686
- package/src/forge/_generated/index.ts +0 -67
- package/src/forge/_generated/liveProductionManifest.json +0 -2
- package/src/forge/_generated/liveProductionManifest.ts +0 -23
- package/src/forge/_generated/liveProtocol.json +0 -2
- package/src/forge/_generated/liveProtocol.ts +0 -21
- package/src/forge/_generated/liveQueryRegistry.json +0 -2
- package/src/forge/_generated/liveQueryRegistry.ts +0 -9
- package/src/forge/_generated/liveTransportConfig.json +0 -2
- package/src/forge/_generated/liveTransportConfig.ts +0 -19
- package/src/forge/_generated/makeRegistry.json +0 -2
- package/src/forge/_generated/makeRegistry.ts +0 -163
- package/src/forge/_generated/makeTemplates.json +0 -2
- package/src/forge/_generated/makeTemplates.ts +0 -61
- package/src/forge/_generated/mockMap.json +0 -2
- package/src/forge/_generated/mockMap.ts +0 -7
- package/src/forge/_generated/operationPlaybooks.md +0 -147
- package/src/forge/_generated/packageGraph.json +0 -2
- package/src/forge/_generated/packageGraph.ts +0 -245249
- package/src/forge/_generated/packageUpgradeRegistry.json +0 -2
- package/src/forge/_generated/packageUpgradeRegistry.ts +0 -15
- package/src/forge/_generated/permissionMatrix.json +0 -2
- package/src/forge/_generated/permissionMatrix.ts +0 -7
- package/src/forge/_generated/policyRegistry.json +0 -2
- package/src/forge/_generated/policyRegistry.ts +0 -11
- package/src/forge/_generated/queryRegistry.json +0 -2
- package/src/forge/_generated/queryRegistry.ts +0 -9
- package/src/forge/_generated/react.d.ts +0 -22
- package/src/forge/_generated/react.ts +0 -29
- package/src/forge/_generated/reactManifest.json +0 -2
- package/src/forge/_generated/reactManifest.ts +0 -19
- package/src/forge/_generated/rlsPolicies.json +0 -2
- package/src/forge/_generated/rlsPolicies.sql +0 -34
- package/src/forge/_generated/rlsPolicies.ts +0 -6
- package/src/forge/_generated/runtimeGraph.json +0 -2
- package/src/forge/_generated/runtimeGraph.ts +0 -8
- package/src/forge/_generated/runtimeMatrix.json +0 -2
- package/src/forge/_generated/runtimeMatrix.ts +0 -327385
- package/src/forge/_generated/runtimeRegistry.ts +0 -2
- package/src/forge/_generated/runtimeRules.md +0 -79
- package/src/forge/_generated/secretRegistry.json +0 -2
- package/src/forge/_generated/secretRegistry.ts +0 -50
- package/src/forge/_generated/secretsContext.ts +0 -11
- package/src/forge/_generated/serverApi.ts +0 -10
- package/src/forge/_generated/sourceMapManifest.json +0 -2
- package/src/forge/_generated/sourceMapManifest.ts +0 -7
- package/src/forge/_generated/sqlPlan.json +0 -2
- package/src/forge/_generated/sqlPlan.ts +0 -88
- package/src/forge/_generated/subscriptionManifest.json +0 -2
- package/src/forge/_generated/subscriptionManifest.ts +0 -7
- package/src/forge/_generated/symbolicationManifest.json +0 -2
- package/src/forge/_generated/symbolicationManifest.ts +0 -17
- package/src/forge/_generated/telemetryRegistry.json +0 -2
- package/src/forge/_generated/telemetryRegistry.ts +0 -9
- package/src/forge/_generated/telemetrySinks.json +0 -2
- package/src/forge/_generated/telemetrySinks.ts +0 -11
- package/src/forge/_generated/tenantScope.json +0 -2
- package/src/forge/_generated/tenantScope.ts +0 -8
- package/src/forge/_generated/testGraph.json +0 -2
- package/src/forge/_generated/testGraph.ts +0 -3108
- package/src/forge/_generated/testPlanRegistry.json +0 -2
- package/src/forge/_generated/testPlanRegistry.ts +0 -33
- package/src/forge/_generated/uiRoutes.json +0 -2
- package/src/forge/_generated/uiRoutes.ts +0 -16
- package/src/forge/_generated/uiScenarios.json +0 -2
- package/src/forge/_generated/uiScenarios.ts +0 -30
- package/src/forge/_generated/uiTestManifest.json +0 -2
- package/src/forge/_generated/uiTestManifest.ts +0 -27
- package/src/forge/_generated/workflowRegistry.json +0 -2
- package/src/forge/_generated/workflowRegistry.ts +0 -9
- package/src/forge/_generated/workflowSubscriptions.json +0 -2
- 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
|
+
}
|