@cleocode/core 2026.6.12 → 2026.6.14
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/dist/admin/ops.d.ts +4 -0
- package/dist/admin/ops.d.ts.map +1 -1
- package/dist/check/index.d.ts +12 -0
- package/dist/check/index.d.ts.map +1 -0
- package/dist/check/index.js +12 -0
- package/dist/check/index.js.map +1 -0
- package/dist/check/pr-gate.d.ts +179 -0
- package/dist/check/pr-gate.d.ts.map +1 -0
- package/dist/check/pr-gate.js +366 -0
- package/dist/check/pr-gate.js.map +1 -0
- package/dist/conduit/delivery-router.d.ts +134 -0
- package/dist/conduit/delivery-router.d.ts.map +1 -0
- package/dist/conduit/delivery-router.js +0 -0
- package/dist/conduit/delivery-router.js.map +1 -0
- package/dist/conduit/index.d.ts +5 -2
- package/dist/conduit/index.d.ts.map +1 -1
- package/dist/conduit/index.js +5 -2
- package/dist/conduit/index.js.map +1 -1
- package/dist/conduit/local-transport.d.ts +12 -0
- package/dist/conduit/local-transport.d.ts.map +1 -1
- package/dist/conduit/local-transport.js +53 -23
- package/dist/conduit/local-transport.js.map +1 -1
- package/dist/conduit/local-tui-adapter.d.ts +89 -0
- package/dist/conduit/local-tui-adapter.d.ts.map +1 -0
- package/dist/conduit/local-tui-adapter.js +225 -0
- package/dist/conduit/local-tui-adapter.js.map +1 -0
- package/dist/config/registry.d.ts +54 -0
- package/dist/config/registry.d.ts.map +1 -1
- package/dist/config/registry.js +94 -2
- package/dist/config/registry.js.map +1 -1
- package/dist/crypto/credentials.d.ts +37 -0
- package/dist/crypto/credentials.d.ts.map +1 -1
- package/dist/crypto/credentials.js +110 -0
- package/dist/crypto/credentials.js.map +1 -1
- package/dist/deriver/queue-manager.d.ts +30 -2
- package/dist/deriver/queue-manager.d.ts.map +1 -1
- package/dist/deriver/queue-manager.js +54 -9
- package/dist/deriver/queue-manager.js.map +1 -1
- package/dist/dispatch/config-domain-handler.d.ts +125 -0
- package/dist/dispatch/config-domain-handler.d.ts.map +1 -0
- package/dist/dispatch/config-domain-handler.js +160 -0
- package/dist/dispatch/config-domain-handler.js.map +1 -0
- package/dist/dispatch/contracts/derive-output-contract.d.ts +86 -0
- package/dist/dispatch/contracts/derive-output-contract.d.ts.map +1 -0
- package/dist/dispatch/contracts/derive-output-contract.js +347 -0
- package/dist/dispatch/contracts/derive-output-contract.js.map +1 -0
- package/dist/dispatch/contracts/ensures-schema.d.ts +77 -0
- package/dist/dispatch/contracts/ensures-schema.d.ts.map +1 -0
- package/dist/dispatch/contracts/ensures-schema.js +91 -0
- package/dist/dispatch/contracts/ensures-schema.js.map +1 -0
- package/dist/dispatch/contracts/input-contracts.d.ts.map +1 -1
- package/dist/dispatch/contracts/input-contracts.js +19 -1
- package/dist/dispatch/contracts/input-contracts.js.map +1 -1
- package/dist/dispatch/contracts/output-contracts.d.ts +27 -5
- package/dist/dispatch/contracts/output-contracts.d.ts.map +1 -1
- package/dist/dispatch/contracts/output-contracts.js +29 -6
- package/dist/dispatch/contracts/output-contracts.js.map +1 -1
- package/dist/docs/export-document.js +5413 -1345
- package/dist/docs/export-document.js.map +3 -3
- package/dist/gateway-client/client.d.ts +123 -0
- package/dist/gateway-client/client.d.ts.map +1 -0
- package/dist/gateway-client/client.js +93 -0
- package/dist/gateway-client/client.js.map +1 -0
- package/dist/gateway-client/generated/client/client.gen.d.ts +3 -0
- package/dist/gateway-client/generated/client/client.gen.d.ts.map +1 -0
- package/dist/gateway-client/generated/client/client.gen.js +217 -0
- package/dist/gateway-client/generated/client/client.gen.js.map +1 -0
- package/dist/gateway-client/generated/client/index.d.ts +11 -0
- package/dist/gateway-client/generated/client/index.d.ts.map +1 -0
- package/dist/gateway-client/generated/client/index.js +7 -0
- package/dist/gateway-client/generated/client/index.js.map +1 -0
- package/dist/gateway-client/generated/client/types.gen.d.ts +121 -0
- package/dist/gateway-client/generated/client/types.gen.d.ts.map +1 -0
- package/dist/gateway-client/generated/client/types.gen.js +3 -0
- package/dist/gateway-client/generated/client/types.gen.js.map +1 -0
- package/dist/gateway-client/generated/client/utils.gen.d.ts +38 -0
- package/dist/gateway-client/generated/client/utils.gen.d.ts.map +1 -0
- package/dist/gateway-client/generated/client/utils.gen.js +229 -0
- package/dist/gateway-client/generated/client/utils.gen.js.map +1 -0
- package/dist/gateway-client/generated/client.gen.d.ts +13 -0
- package/dist/gateway-client/generated/client.gen.d.ts.map +1 -0
- package/dist/gateway-client/generated/client.gen.js +4 -0
- package/dist/gateway-client/generated/client.gen.js.map +1 -0
- package/dist/gateway-client/generated/core/auth.gen.d.ts +26 -0
- package/dist/gateway-client/generated/core/auth.gen.d.ts.map +1 -0
- package/dist/gateway-client/generated/core/auth.gen.js +15 -0
- package/dist/gateway-client/generated/core/auth.gen.js.map +1 -0
- package/dist/gateway-client/generated/core/bodySerializer.gen.d.ts +26 -0
- package/dist/gateway-client/generated/core/bodySerializer.gen.d.ts.map +1 -0
- package/dist/gateway-client/generated/core/bodySerializer.gen.js +58 -0
- package/dist/gateway-client/generated/core/bodySerializer.gen.js.map +1 -0
- package/dist/gateway-client/generated/core/params.gen.d.ts +44 -0
- package/dist/gateway-client/generated/core/params.gen.d.ts.map +1 -0
- package/dist/gateway-client/generated/core/params.gen.js +101 -0
- package/dist/gateway-client/generated/core/params.gen.js.map +1 -0
- package/dist/gateway-client/generated/core/pathSerializer.gen.d.ts +34 -0
- package/dist/gateway-client/generated/core/pathSerializer.gen.d.ts.map +1 -0
- package/dist/gateway-client/generated/core/pathSerializer.gen.js +107 -0
- package/dist/gateway-client/generated/core/pathSerializer.gen.js.map +1 -0
- package/dist/gateway-client/generated/core/queryKeySerializer.gen.d.ts +19 -0
- package/dist/gateway-client/generated/core/queryKeySerializer.gen.d.ts.map +1 -0
- package/dist/gateway-client/generated/core/queryKeySerializer.gen.js +93 -0
- package/dist/gateway-client/generated/core/queryKeySerializer.gen.js.map +1 -0
- package/dist/gateway-client/generated/core/serverSentEvents.gen.d.ts +72 -0
- package/dist/gateway-client/generated/core/serverSentEvents.gen.d.ts.map +1 -0
- package/dist/gateway-client/generated/core/serverSentEvents.gen.js +133 -0
- package/dist/gateway-client/generated/core/serverSentEvents.gen.js.map +1 -0
- package/dist/gateway-client/generated/core/types.gen.d.ts +84 -0
- package/dist/gateway-client/generated/core/types.gen.d.ts.map +1 -0
- package/dist/gateway-client/generated/core/types.gen.js +3 -0
- package/dist/gateway-client/generated/core/types.gen.js.map +1 -0
- package/dist/gateway-client/generated/core/utils.gen.d.ts +20 -0
- package/dist/gateway-client/generated/core/utils.gen.d.ts.map +1 -0
- package/dist/gateway-client/generated/core/utils.gen.js +88 -0
- package/dist/gateway-client/generated/core/utils.gen.js.map +1 -0
- package/dist/gateway-client/generated/index.d.ts +3 -0
- package/dist/gateway-client/generated/index.d.ts.map +1 -0
- package/dist/gateway-client/generated/index.js +3 -0
- package/dist/gateway-client/generated/index.js.map +1 -0
- package/dist/gateway-client/generated/namespaces.gen.d.ts +512 -0
- package/dist/gateway-client/generated/namespaces.gen.d.ts.map +1 -0
- package/dist/gateway-client/generated/namespaces.gen.js +521 -0
- package/dist/gateway-client/generated/namespaces.gen.js.map +1 -0
- package/dist/gateway-client/generated/sdk.gen.d.ts +1780 -0
- package/dist/gateway-client/generated/sdk.gen.d.ts.map +1 -0
- package/dist/gateway-client/generated/sdk.gen.js +3811 -0
- package/dist/gateway-client/generated/sdk.gen.js.map +1 -0
- package/dist/gateway-client/generated/types.gen.d.ts +14681 -0
- package/dist/gateway-client/generated/types.gen.d.ts.map +1 -0
- package/dist/gateway-client/generated/types.gen.js +3 -0
- package/dist/gateway-client/generated/types.gen.js.map +1 -0
- package/dist/gateway-client/index.d.ts +27 -0
- package/dist/gateway-client/index.d.ts.map +1 -0
- package/dist/gateway-client/index.js +25 -0
- package/dist/gateway-client/index.js.map +1 -0
- package/dist/go/driver.d.ts +132 -7
- package/dist/go/driver.d.ts.map +1 -1
- package/dist/go/driver.js +135 -10
- package/dist/go/driver.js.map +1 -1
- package/dist/go/index.d.ts +1 -1
- package/dist/go/index.d.ts.map +1 -1
- package/dist/go/index.js +1 -1
- package/dist/go/index.js.map +1 -1
- package/dist/index.d.ts +11 -0
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +25 -0
- package/dist/index.js.map +1 -1
- package/dist/init.d.ts.map +1 -1
- package/dist/init.js +28 -0
- package/dist/init.js.map +1 -1
- package/dist/internal.d.ts +23 -11
- package/dist/internal.d.ts.map +1 -1
- package/dist/internal.js +29 -12
- package/dist/internal.js.map +1 -1
- package/dist/lifecycle/engine-ops.d.ts.map +1 -1
- package/dist/lifecycle/engine-ops.js +7 -4
- package/dist/lifecycle/engine-ops.js.map +1 -1
- package/dist/lifecycle/ivtr-loop.d.ts +108 -183
- package/dist/lifecycle/ivtr-loop.d.ts.map +1 -1
- package/dist/lifecycle/ivtr-loop.js +207 -522
- package/dist/lifecycle/ivtr-loop.js.map +1 -1
- package/dist/llm/auxiliary-fallback.js +1 -1
- package/dist/llm/auxiliary-fallback.js.map +1 -1
- package/dist/llm/catalog-model-resolver.d.ts +19 -0
- package/dist/llm/catalog-model-resolver.d.ts.map +1 -1
- package/dist/llm/catalog-model-resolver.js +36 -0
- package/dist/llm/catalog-model-resolver.js.map +1 -1
- package/dist/llm/catalog-resolver.d.ts +112 -0
- package/dist/llm/catalog-resolver.d.ts.map +1 -0
- package/dist/llm/catalog-resolver.js +207 -0
- package/dist/llm/catalog-resolver.js.map +1 -0
- package/dist/llm/catalog-seeder.d.ts +96 -0
- package/dist/llm/catalog-seeder.d.ts.map +1 -0
- package/dist/llm/catalog-seeder.js +189 -0
- package/dist/llm/catalog-seeder.js.map +1 -0
- package/dist/llm/cli-ops.d.ts +14 -1
- package/dist/llm/cli-ops.d.ts.map +1 -1
- package/dist/llm/cli-ops.js +46 -17
- package/dist/llm/cli-ops.js.map +1 -1
- package/dist/llm/complexity-classifier.d.ts +208 -0
- package/dist/llm/complexity-classifier.d.ts.map +1 -0
- package/dist/llm/complexity-classifier.js +359 -0
- package/dist/llm/complexity-classifier.js.map +1 -0
- package/dist/llm/concrete-session.d.ts.map +1 -1
- package/dist/llm/concrete-session.js +4 -0
- package/dist/llm/concrete-session.js.map +1 -1
- package/dist/llm/credential-pool.d.ts +2 -0
- package/dist/llm/credential-pool.d.ts.map +1 -1
- package/dist/llm/credential-pool.js +5 -2
- package/dist/llm/credential-pool.js.map +1 -1
- package/dist/llm/credentials-store.d.ts +10 -14
- package/dist/llm/credentials-store.d.ts.map +1 -1
- package/dist/llm/credentials-store.js.map +1 -1
- package/dist/llm/credentials.d.ts +35 -0
- package/dist/llm/credentials.d.ts.map +1 -1
- package/dist/llm/credentials.js +49 -0
- package/dist/llm/credentials.js.map +1 -1
- package/dist/llm/entity-ops.d.ts +299 -0
- package/dist/llm/entity-ops.d.ts.map +1 -0
- package/dist/llm/entity-ops.js +441 -0
- package/dist/llm/entity-ops.js.map +1 -0
- package/dist/llm/index.d.ts +19 -0
- package/dist/llm/index.d.ts.map +1 -1
- package/dist/llm/index.js +12 -0
- package/dist/llm/index.js.map +1 -1
- package/dist/llm/llm-queue-admit.d.ts +118 -0
- package/dist/llm/llm-queue-admit.d.ts.map +1 -0
- package/dist/llm/llm-queue-admit.js +275 -0
- package/dist/llm/llm-queue-admit.js.map +1 -0
- package/dist/llm/oauth/device-code.d.ts.map +1 -1
- package/dist/llm/oauth/device-code.js +2 -8
- package/dist/llm/oauth/device-code.js.map +1 -1
- package/dist/llm/oauth/google-pkce.d.ts.map +1 -1
- package/dist/llm/oauth/google-pkce.js +2 -18
- package/dist/llm/oauth/google-pkce.js.map +1 -1
- package/dist/llm/oauth/pkce.d.ts +70 -0
- package/dist/llm/oauth/pkce.d.ts.map +1 -1
- package/dist/llm/oauth/pkce.js +106 -29
- package/dist/llm/oauth/pkce.js.map +1 -1
- package/dist/llm/onboarding/front-door.d.ts +146 -0
- package/dist/llm/onboarding/front-door.d.ts.map +1 -0
- package/dist/llm/onboarding/front-door.js +153 -0
- package/dist/llm/onboarding/front-door.js.map +1 -0
- package/dist/llm/onboarding/login-engine.d.ts +175 -0
- package/dist/llm/onboarding/login-engine.d.ts.map +1 -0
- package/dist/llm/onboarding/login-engine.js +286 -0
- package/dist/llm/onboarding/login-engine.js.map +1 -0
- package/dist/llm/pi/gondolin-loader.d.ts +241 -0
- package/dist/llm/pi/gondolin-loader.d.ts.map +1 -0
- package/dist/llm/pi/gondolin-loader.js +195 -0
- package/dist/llm/pi/gondolin-loader.js.map +1 -0
- package/dist/llm/pi/index.d.ts +28 -0
- package/dist/llm/pi/index.d.ts.map +1 -0
- package/dist/llm/pi/index.js +27 -0
- package/dist/llm/pi/index.js.map +1 -0
- package/dist/llm/pi/pi-agent-adapter.d.ts +135 -0
- package/dist/llm/pi/pi-agent-adapter.d.ts.map +1 -0
- package/dist/llm/pi/pi-agent-adapter.js +329 -0
- package/dist/llm/pi/pi-agent-adapter.js.map +1 -0
- package/dist/llm/pi/pi-errors.d.ts +161 -0
- package/dist/llm/pi/pi-errors.d.ts.map +1 -0
- package/dist/llm/pi/pi-errors.js +296 -0
- package/dist/llm/pi/pi-errors.js.map +1 -0
- package/dist/llm/pi/pi-execution-env.d.ts +286 -0
- package/dist/llm/pi/pi-execution-env.d.ts.map +1 -0
- package/dist/llm/pi/pi-execution-env.js +406 -0
- package/dist/llm/pi/pi-execution-env.js.map +1 -0
- package/dist/llm/pi/pi-gondolin-env.d.ts +250 -0
- package/dist/llm/pi/pi-gondolin-env.d.ts.map +1 -0
- package/dist/llm/pi/pi-gondolin-env.js +541 -0
- package/dist/llm/pi/pi-gondolin-env.js.map +1 -0
- package/dist/llm/pi/pi-session-storage.d.ts +154 -0
- package/dist/llm/pi/pi-session-storage.d.ts.map +1 -0
- package/dist/llm/pi/pi-session-storage.js +314 -0
- package/dist/llm/pi/pi-session-storage.js.map +1 -0
- package/dist/llm/pi/pi-stream-fn.d.ts +124 -0
- package/dist/llm/pi/pi-stream-fn.d.ts.map +1 -0
- package/dist/llm/pi/pi-stream-fn.js +504 -0
- package/dist/llm/pi/pi-stream-fn.js.map +1 -0
- package/dist/llm/pi/pi-tool-bridge.d.ts +99 -0
- package/dist/llm/pi/pi-tool-bridge.d.ts.map +1 -0
- package/dist/llm/pi/pi-tool-bridge.js +117 -0
- package/dist/llm/pi/pi-tool-bridge.js.map +1 -0
- package/dist/llm/pi/pi-types.d.ts +56 -0
- package/dist/llm/pi/pi-types.d.ts.map +1 -0
- package/dist/llm/pi/pi-types.js +16 -0
- package/dist/llm/pi/pi-types.js.map +1 -0
- package/dist/llm/pi/resolve-execution-env.d.ts +194 -0
- package/dist/llm/pi/resolve-execution-env.d.ts.map +1 -0
- package/dist/llm/pi/resolve-execution-env.js +132 -0
- package/dist/llm/pi/resolve-execution-env.js.map +1 -0
- package/dist/llm/plugin-facade.js +5472 -1331
- package/dist/llm/plugin-facade.js.map +3 -3
- package/dist/llm/provider-registry/builtin/anthropic.d.ts.map +1 -1
- package/dist/llm/provider-registry/builtin/anthropic.js +23 -10
- package/dist/llm/provider-registry/builtin/anthropic.js.map +1 -1
- package/dist/llm/provider-registry/provider-alias.d.ts +62 -0
- package/dist/llm/provider-registry/provider-alias.d.ts.map +1 -0
- package/dist/llm/provider-registry/provider-alias.js +85 -0
- package/dist/llm/provider-registry/provider-alias.js.map +1 -0
- package/dist/llm/provider-registry/provider-defs.d.ts +45 -0
- package/dist/llm/provider-registry/provider-defs.d.ts.map +1 -0
- package/dist/llm/provider-registry/provider-defs.js +145 -0
- package/dist/llm/provider-registry/provider-defs.js.map +1 -0
- package/dist/llm/provider-registry/provider-seed.d.ts +78 -0
- package/dist/llm/provider-registry/provider-seed.d.ts.map +1 -0
- package/dist/llm/provider-registry/provider-seed.js +113 -0
- package/dist/llm/provider-registry/provider-seed.js.map +1 -0
- package/dist/llm/role-executor.d.ts.map +1 -1
- package/dist/llm/role-executor.js +44 -5
- package/dist/llm/role-executor.js.map +1 -1
- package/dist/llm/role-resolver.d.ts +46 -14
- package/dist/llm/role-resolver.d.ts.map +1 -1
- package/dist/llm/role-resolver.js +185 -20
- package/dist/llm/role-resolver.js.map +1 -1
- package/dist/llm/sealed-credential.d.ts +125 -0
- package/dist/llm/sealed-credential.d.ts.map +1 -0
- package/dist/llm/sealed-credential.js +133 -0
- package/dist/llm/sealed-credential.js.map +1 -0
- package/dist/llm/session-factory.d.ts.map +1 -1
- package/dist/llm/session-factory.js +6 -2
- package/dist/llm/session-factory.js.map +1 -1
- package/dist/llm/system-key.d.ts +67 -0
- package/dist/llm/system-key.d.ts.map +1 -0
- package/dist/llm/system-key.js +87 -0
- package/dist/llm/system-key.js.map +1 -0
- package/dist/llm/system-of-use-registry.d.ts +119 -0
- package/dist/llm/system-of-use-registry.d.ts.map +1 -0
- package/dist/llm/system-of-use-registry.js +200 -0
- package/dist/llm/system-of-use-registry.js.map +1 -0
- package/dist/llm/system-resolver.d.ts +32 -10
- package/dist/llm/system-resolver.d.ts.map +1 -1
- package/dist/llm/system-resolver.js +138 -35
- package/dist/llm/system-resolver.js.map +1 -1
- package/dist/memory/brain-writer-thread.d.ts.map +1 -1
- package/dist/memory/brain-writer-thread.js +116 -11
- package/dist/memory/brain-writer-thread.js.map +1 -1
- package/dist/memory/claude-mem-migration.d.ts.map +1 -1
- package/dist/memory/claude-mem-migration.js +21 -0
- package/dist/memory/claude-mem-migration.js.map +1 -1
- package/dist/memory/graph-memory-bridge.d.ts.map +1 -1
- package/dist/memory/graph-memory-bridge.js +32 -25
- package/dist/memory/graph-memory-bridge.js.map +1 -1
- package/dist/memory/learnings.d.ts +4 -0
- package/dist/memory/learnings.d.ts.map +1 -1
- package/dist/memory/llm-backend-resolver.js +23 -5
- package/dist/memory/llm-backend-resolver.js.map +1 -1
- package/dist/memory/patterns.d.ts +4 -0
- package/dist/memory/patterns.d.ts.map +1 -1
- package/dist/metrics/index.d.ts +2 -0
- package/dist/metrics/index.d.ts.map +1 -1
- package/dist/metrics/index.js +1 -0
- package/dist/metrics/index.js.map +1 -1
- package/dist/nexus/migrations/M-split-graph.d.ts.map +1 -1
- package/dist/nexus/migrations/M-split-graph.js +60 -53
- package/dist/nexus/migrations/M-split-graph.js.map +1 -1
- package/dist/orchestrate/pivot.d.ts.map +1 -1
- package/dist/orchestrate/pivot.js +20 -2
- package/dist/orchestrate/pivot.js.map +1 -1
- package/dist/orchestration/spawn.d.ts +89 -0
- package/dist/orchestration/spawn.d.ts.map +1 -1
- package/dist/orchestration/spawn.js +68 -0
- package/dist/orchestration/spawn.js.map +1 -1
- package/dist/playbooks/cantbook-profile.d.ts +96 -0
- package/dist/playbooks/cantbook-profile.d.ts.map +1 -0
- package/dist/playbooks/cantbook-profile.js +97 -0
- package/dist/playbooks/cantbook-profile.js.map +1 -0
- package/dist/playbooks/guarded-deterministic-runner.d.ts +153 -0
- package/dist/playbooks/guarded-deterministic-runner.d.ts.map +1 -0
- package/dist/playbooks/guarded-deterministic-runner.js +155 -0
- package/dist/playbooks/guarded-deterministic-runner.js.map +1 -0
- package/dist/playbooks/index.d.ts +2 -0
- package/dist/playbooks/index.d.ts.map +1 -1
- package/dist/playbooks/index.js +10 -0
- package/dist/playbooks/index.js.map +1 -1
- package/dist/playbooks/pi-runner-wiring.d.ts +75 -0
- package/dist/playbooks/pi-runner-wiring.d.ts.map +1 -0
- package/dist/playbooks/pi-runner-wiring.js +82 -0
- package/dist/playbooks/pi-runner-wiring.js.map +1 -0
- package/dist/release/engine-ops.js +2 -2
- package/dist/release/engine-ops.js.map +1 -1
- package/dist/routing/capability-matrix.d.ts.map +1 -1
- package/dist/routing/capability-matrix.js +0 -57
- package/dist/routing/capability-matrix.js.map +1 -1
- package/dist/runtime/openapi/generate-openapi.d.ts +211 -0
- package/dist/runtime/openapi/generate-openapi.d.ts.map +1 -0
- package/dist/runtime/openapi/generate-openapi.js +300 -0
- package/dist/runtime/openapi/generate-openapi.js.map +1 -0
- package/dist/runtime/openapi/index.d.ts +16 -0
- package/dist/runtime/openapi/index.d.ts.map +1 -0
- package/dist/runtime/openapi/index.js +16 -0
- package/dist/runtime/openapi/index.js.map +1 -0
- package/dist/selfimprove/budget.d.ts +206 -0
- package/dist/selfimprove/budget.d.ts.map +1 -0
- package/dist/selfimprove/budget.js +203 -0
- package/dist/selfimprove/budget.js.map +1 -0
- package/dist/selfimprove/dhq-adapter.d.ts +105 -0
- package/dist/selfimprove/dhq-adapter.d.ts.map +1 -0
- package/dist/selfimprove/dhq-adapter.js +95 -0
- package/dist/selfimprove/dhq-adapter.js.map +1 -0
- package/dist/selfimprove/draft-pr.d.ts +129 -0
- package/dist/selfimprove/draft-pr.d.ts.map +1 -0
- package/dist/selfimprove/draft-pr.js +158 -0
- package/dist/selfimprove/draft-pr.js.map +1 -0
- package/dist/selfimprove/envelope-diff.d.ts +162 -0
- package/dist/selfimprove/envelope-diff.d.ts.map +1 -0
- package/dist/selfimprove/envelope-diff.js +321 -0
- package/dist/selfimprove/envelope-diff.js.map +1 -0
- package/dist/selfimprove/replay.d.ts +121 -0
- package/dist/selfimprove/replay.d.ts.map +1 -0
- package/dist/selfimprove/replay.js +109 -0
- package/dist/selfimprove/replay.js.map +1 -0
- package/dist/selfimprove/run-loop.d.ts +148 -0
- package/dist/selfimprove/run-loop.d.ts.map +1 -0
- package/dist/selfimprove/run-loop.js +240 -0
- package/dist/selfimprove/run-loop.js.map +1 -0
- package/dist/selfimprove/scenario.d.ts +145 -0
- package/dist/selfimprove/scenario.d.ts.map +1 -0
- package/dist/selfimprove/scenario.js +243 -0
- package/dist/selfimprove/scenario.js.map +1 -0
- package/dist/selfimprove/scenarios/dhq-replay-find/golden.json +32 -0
- package/dist/selfimprove/scenarios/dhq-replay-find/scenario.json +18 -0
- package/dist/sentient/daemon-entry.js +5 -0
- package/dist/sentient/daemon-entry.js.map +1 -1
- package/dist/sentient/daemon.d.ts.map +1 -1
- package/dist/sentient/daemon.js +19 -0
- package/dist/sentient/daemon.js.map +1 -1
- package/dist/sentient/hygiene-scan.d.ts.map +1 -1
- package/dist/sentient/hygiene-scan.js +14 -6
- package/dist/sentient/hygiene-scan.js.map +1 -1
- package/dist/sessions/briefing.d.ts.map +1 -1
- package/dist/sessions/briefing.js +13 -9
- package/dist/sessions/briefing.js.map +1 -1
- package/dist/sessions/connection-session-handle.d.ts +161 -0
- package/dist/sessions/connection-session-handle.d.ts.map +1 -0
- package/dist/sessions/connection-session-handle.js +168 -0
- package/dist/sessions/connection-session-handle.js.map +1 -0
- package/dist/sessions/handoff.d.ts.map +1 -1
- package/dist/sessions/handoff.js +9 -0
- package/dist/sessions/handoff.js.map +1 -1
- package/dist/sessions/index.d.ts +4 -1
- package/dist/sessions/index.d.ts.map +1 -1
- package/dist/sessions/index.js +31 -1
- package/dist/sessions/index.js.map +1 -1
- package/dist/sessions/session-id.d.ts +34 -0
- package/dist/sessions/session-id.d.ts.map +1 -1
- package/dist/sessions/session-id.js +37 -0
- package/dist/sessions/session-id.js.map +1 -1
- package/dist/sessions/session-manifest-mirror.d.ts +115 -0
- package/dist/sessions/session-manifest-mirror.d.ts.map +1 -0
- package/dist/sessions/session-manifest-mirror.js +250 -0
- package/dist/sessions/session-manifest-mirror.js.map +1 -0
- package/dist/sessions/session-switch.d.ts.map +1 -1
- package/dist/sessions/session-switch.js +5 -2
- package/dist/sessions/session-switch.js.map +1 -1
- package/dist/setup/config-json-merge.d.ts.map +1 -1
- package/dist/setup/config-json-merge.js +14 -0
- package/dist/setup/config-json-merge.js.map +1 -1
- package/dist/setup/index.d.ts +23 -11
- package/dist/setup/index.d.ts.map +1 -1
- package/dist/setup/index.js +25 -12
- package/dist/setup/index.js.map +1 -1
- package/dist/setup/sections/llm.d.ts +28 -1
- package/dist/setup/sections/llm.d.ts.map +1 -1
- package/dist/setup/sections/llm.js +27 -6
- package/dist/setup/sections/llm.js.map +1 -1
- package/dist/setup/sections/models-roles.d.ts +40 -0
- package/dist/setup/sections/models-roles.d.ts.map +1 -0
- package/dist/setup/sections/models-roles.js +219 -0
- package/dist/setup/sections/models-roles.js.map +1 -0
- package/dist/setup/wizard.d.ts +19 -1
- package/dist/setup/wizard.d.ts.map +1 -1
- package/dist/setup/wizard.js.map +1 -1
- package/dist/store/converters.d.ts.map +1 -1
- package/dist/store/converters.js +2 -0
- package/dist/store/converters.js.map +1 -1
- package/dist/store/db-helpers.d.ts.map +1 -1
- package/dist/store/db-helpers.js +2 -0
- package/dist/store/db-helpers.js.map +1 -1
- package/dist/store/dual-scope-db.d.ts.map +1 -1
- package/dist/store/dual-scope-db.js +87 -47
- package/dist/store/dual-scope-db.js.map +1 -1
- package/dist/store/pi-session-store.d.ts +151 -0
- package/dist/store/pi-session-store.d.ts.map +1 -0
- package/dist/store/pi-session-store.js +166 -0
- package/dist/store/pi-session-store.js.map +1 -0
- package/dist/store/safety-data-accessor.d.ts +1 -0
- package/dist/store/safety-data-accessor.d.ts.map +1 -1
- package/dist/store/safety-data-accessor.js +5 -0
- package/dist/store/safety-data-accessor.js.map +1 -1
- package/dist/store/schedule-schema.d.ts +195 -0
- package/dist/store/schedule-schema.d.ts.map +1 -0
- package/dist/store/schedule-schema.js +84 -0
- package/dist/store/schedule-schema.js.map +1 -0
- package/dist/store/schedule-store.d.ts +144 -0
- package/dist/store/schedule-store.d.ts.map +1 -0
- package/dist/store/schedule-store.js +162 -0
- package/dist/store/schedule-store.js.map +1 -0
- package/dist/store/schema/attachments.d.ts +1 -1
- package/dist/store/schema/cleo-global/accounts.d.ts +357 -0
- package/dist/store/schema/cleo-global/accounts.d.ts.map +1 -0
- package/dist/store/schema/cleo-global/accounts.js +136 -0
- package/dist/store/schema/cleo-global/accounts.js.map +1 -0
- package/dist/store/schema/cleo-global/index.d.ts +5 -0
- package/dist/store/schema/cleo-global/index.d.ts.map +1 -1
- package/dist/store/schema/cleo-global/index.js +7 -0
- package/dist/store/schema/cleo-global/index.js.map +1 -1
- package/dist/store/schema/cleo-global/models-catalog.d.ts +359 -0
- package/dist/store/schema/cleo-global/models-catalog.d.ts.map +1 -0
- package/dist/store/schema/cleo-global/models-catalog.js +114 -0
- package/dist/store/schema/cleo-global/models-catalog.js.map +1 -0
- package/dist/store/schema/cleo-global/providers.d.ts +279 -0
- package/dist/store/schema/cleo-global/providers.d.ts.map +1 -0
- package/dist/store/schema/cleo-global/providers.js +94 -0
- package/dist/store/schema/cleo-global/providers.js.map +1 -0
- package/dist/store/schema/cleo-global/services.d.ts +493 -0
- package/dist/store/schema/cleo-global/services.d.ts.map +1 -0
- package/dist/store/schema/cleo-global/services.js +200 -0
- package/dist/store/schema/cleo-global/services.js.map +1 -0
- package/dist/store/schema/cleo-global/session-manifest.d.ts +217 -0
- package/dist/store/schema/cleo-global/session-manifest.d.ts.map +1 -0
- package/dist/store/schema/cleo-global/session-manifest.js +99 -0
- package/dist/store/schema/cleo-global/session-manifest.js.map +1 -0
- package/dist/store/schema/cleo-project/docs.d.ts +1 -1
- package/dist/store/schema/cleo-project/provenance-rest.d.ts +1 -1
- package/dist/store/schema/cleo-project/tasks-core.d.ts +16 -0
- package/dist/store/schema/cleo-project/tasks-core.d.ts.map +1 -1
- package/dist/store/schema/cleo-project/tasks-core.js +14 -0
- package/dist/store/schema/cleo-project/tasks-core.js.map +1 -1
- package/dist/store/schema/cleo-shared/brain.d.ts +2 -2
- package/dist/store/schema/memory-schema.d.ts +182 -2
- package/dist/store/schema/memory-schema.d.ts.map +1 -1
- package/dist/store/schema/memory-schema.js +111 -2
- package/dist/store/schema/memory-schema.js.map +1 -1
- package/dist/store/schema/provenance/releases.d.ts +1 -1
- package/dist/store/schema/tasks.d.ts +16 -0
- package/dist/store/schema/tasks.d.ts.map +1 -1
- package/dist/store/schema/tasks.js +10 -0
- package/dist/store/schema/tasks.js.map +1 -1
- package/dist/store/selfimprove-dhq-schema.d.ts +284 -0
- package/dist/store/selfimprove-dhq-schema.d.ts.map +1 -0
- package/dist/store/selfimprove-dhq-schema.js +128 -0
- package/dist/store/selfimprove-dhq-schema.js.map +1 -0
- package/dist/store/selfimprove-dhq-store.d.ts +175 -0
- package/dist/store/selfimprove-dhq-store.d.ts.map +1 -0
- package/dist/store/selfimprove-dhq-store.js +182 -0
- package/dist/store/selfimprove-dhq-store.js.map +1 -0
- package/dist/store/service-connections-accessor.d.ts +313 -0
- package/dist/store/service-connections-accessor.d.ts.map +1 -0
- package/dist/store/service-connections-accessor.js +464 -0
- package/dist/store/service-connections-accessor.js.map +1 -0
- package/dist/store/service-host-matcher.d.ts +70 -0
- package/dist/store/service-host-matcher.d.ts.map +1 -0
- package/dist/store/service-host-matcher.js +127 -0
- package/dist/store/service-host-matcher.js.map +1 -0
- package/dist/store/service-injection.d.ts +152 -0
- package/dist/store/service-injection.d.ts.map +1 -0
- package/dist/store/service-injection.js +225 -0
- package/dist/store/service-injection.js.map +1 -0
- package/dist/store/service-oauth.d.ts +287 -0
- package/dist/store/service-oauth.d.ts.map +1 -0
- package/dist/store/service-oauth.js +524 -0
- package/dist/store/service-oauth.js.map +1 -0
- package/dist/store/service-trust-gate.d.ts +164 -0
- package/dist/store/service-trust-gate.d.ts.map +1 -0
- package/dist/store/service-trust-gate.js +122 -0
- package/dist/store/service-trust-gate.js.map +1 -0
- package/dist/store/session-store.d.ts +52 -13
- package/dist/store/session-store.d.ts.map +1 -1
- package/dist/store/session-store.js +71 -13
- package/dist/store/session-store.js.map +1 -1
- package/dist/store/sqlite-data-accessor.d.ts.map +1 -1
- package/dist/store/sqlite-data-accessor.js +7 -0
- package/dist/store/sqlite-data-accessor.js.map +1 -1
- package/dist/store/umbrella-data-accessor.d.ts +1 -0
- package/dist/store/umbrella-data-accessor.d.ts.map +1 -1
- package/dist/store/umbrella-data-accessor.js +5 -0
- package/dist/store/umbrella-data-accessor.js.map +1 -1
- package/dist/store/validation-schemas.d.ts +36 -4
- package/dist/store/validation-schemas.d.ts.map +1 -1
- package/dist/store/writer-lease-schema.d.ts +392 -0
- package/dist/store/writer-lease-schema.d.ts.map +1 -0
- package/dist/store/writer-lease-schema.js +142 -0
- package/dist/store/writer-lease-schema.js.map +1 -0
- package/dist/store/writer-lease.d.ts +368 -0
- package/dist/store/writer-lease.d.ts.map +1 -0
- package/dist/store/writer-lease.js +1002 -0
- package/dist/store/writer-lease.js.map +1 -0
- package/dist/tasks/agent-lifecycle-lane.d.ts +175 -0
- package/dist/tasks/agent-lifecycle-lane.d.ts.map +1 -0
- package/dist/tasks/agent-lifecycle-lane.js +176 -0
- package/dist/tasks/agent-lifecycle-lane.js.map +1 -0
- package/dist/tasks/backfill-child-projections.d.ts.map +1 -1
- package/dist/tasks/backfill-child-projections.js +14 -9
- package/dist/tasks/backfill-child-projections.js.map +1 -1
- package/dist/tasks/complete.d.ts +17 -0
- package/dist/tasks/complete.d.ts.map +1 -1
- package/dist/tasks/complete.js +60 -20
- package/dist/tasks/complete.js.map +1 -1
- package/dist/tasks/depends-waiver-audit.d.ts +52 -0
- package/dist/tasks/depends-waiver-audit.d.ts.map +1 -0
- package/dist/tasks/depends-waiver-audit.js +36 -0
- package/dist/tasks/depends-waiver-audit.js.map +1 -0
- package/dist/tasks/duplicate-detector.d.ts.map +1 -1
- package/dist/tasks/duplicate-detector.js +14 -7
- package/dist/tasks/duplicate-detector.js.map +1 -1
- package/dist/tasks/engine-wrap.d.ts +36 -2
- package/dist/tasks/engine-wrap.d.ts.map +1 -1
- package/dist/tasks/engine-wrap.js +44 -2
- package/dist/tasks/engine-wrap.js.map +1 -1
- package/dist/tasks/index.d.ts +1 -0
- package/dist/tasks/index.d.ts.map +1 -1
- package/dist/tasks/index.js +1 -0
- package/dist/tasks/index.js.map +1 -1
- package/dist/tasks/ops.d.ts +3 -0
- package/dist/tasks/ops.d.ts.map +1 -1
- package/dist/tasks/task-ops.d.ts +1 -1
- package/dist/tasks/task-ops.d.ts.map +1 -1
- package/dist/tasks/task-ops.js +3 -1
- package/dist/tasks/task-ops.js.map +1 -1
- package/dist/tasks/task-reparent.d.ts +90 -0
- package/dist/tasks/task-reparent.d.ts.map +1 -1
- package/dist/tasks/task-reparent.js +171 -0
- package/dist/tasks/task-reparent.js.map +1 -1
- package/dist/telemetry/index.d.ts.map +1 -1
- package/dist/telemetry/index.js +10 -4
- package/dist/telemetry/index.js.map +1 -1
- package/dist/tools/agent-registry.d.ts +250 -0
- package/dist/tools/agent-registry.d.ts.map +1 -0
- package/dist/tools/agent-registry.js +292 -0
- package/dist/tools/agent-registry.js.map +1 -0
- package/dist/tools/agent-tool-families.d.ts +107 -0
- package/dist/tools/agent-tool-families.d.ts.map +1 -0
- package/dist/tools/agent-tool-families.js +527 -0
- package/dist/tools/agent-tool-families.js.map +1 -0
- package/dist/tools/browser-driver.d.ts +183 -0
- package/dist/tools/browser-driver.d.ts.map +1 -0
- package/dist/tools/browser-driver.js +242 -0
- package/dist/tools/browser-driver.js.map +1 -0
- package/dist/tools/builtin-agent-tools.d.ts +36 -0
- package/dist/tools/builtin-agent-tools.d.ts.map +1 -0
- package/dist/tools/builtin-agent-tools.js +191 -0
- package/dist/tools/builtin-agent-tools.js.map +1 -0
- package/dist/tools/dispatch.d.ts +370 -0
- package/dist/tools/dispatch.d.ts.map +1 -0
- package/dist/tools/dispatch.js +505 -0
- package/dist/tools/dispatch.js.map +1 -0
- package/dist/tools/env-scrub.d.ts +93 -0
- package/dist/tools/env-scrub.d.ts.map +1 -0
- package/dist/tools/env-scrub.js +176 -0
- package/dist/tools/env-scrub.js.map +1 -0
- package/dist/tools/exec-code-agent-tool.d.ts +179 -0
- package/dist/tools/exec-code-agent-tool.d.ts.map +1 -0
- package/dist/tools/exec-code-agent-tool.js +239 -0
- package/dist/tools/exec-code-agent-tool.js.map +1 -0
- package/dist/tools/fs.d.ts +30 -0
- package/dist/tools/fs.d.ts.map +1 -1
- package/dist/tools/fs.js +55 -2
- package/dist/tools/fs.js.map +1 -1
- package/dist/tools/guard.d.ts +15 -0
- package/dist/tools/guard.d.ts.map +1 -1
- package/dist/tools/guard.js +49 -12
- package/dist/tools/guard.js.map +1 -1
- package/dist/tools/index.d.ts +16 -0
- package/dist/tools/index.d.ts.map +1 -1
- package/dist/tools/index.js +52 -0
- package/dist/tools/index.js.map +1 -1
- package/dist/tools/mcp-agent-tool.d.ts +189 -0
- package/dist/tools/mcp-agent-tool.d.ts.map +1 -0
- package/dist/tools/mcp-agent-tool.js +243 -0
- package/dist/tools/mcp-agent-tool.js.map +1 -0
- package/dist/tools/media-agent-tools.d.ts +105 -0
- package/dist/tools/media-agent-tools.d.ts.map +1 -0
- package/dist/tools/media-agent-tools.js +255 -0
- package/dist/tools/media-agent-tools.js.map +1 -0
- package/dist/tools/memory-agent-tools.d.ts +99 -0
- package/dist/tools/memory-agent-tools.d.ts.map +1 -0
- package/dist/tools/memory-agent-tools.js +190 -0
- package/dist/tools/memory-agent-tools.js.map +1 -0
- package/dist/tools/pty.d.ts +45 -0
- package/dist/tools/pty.d.ts.map +1 -0
- package/dist/tools/pty.js +166 -0
- package/dist/tools/pty.js.map +1 -0
- package/dist/tools/schedule-agent-tools.d.ts +151 -0
- package/dist/tools/schedule-agent-tools.d.ts.map +1 -0
- package/dist/tools/schedule-agent-tools.js +238 -0
- package/dist/tools/schedule-agent-tools.js.map +1 -0
- package/dist/tools/schema-gen.d.ts +57 -0
- package/dist/tools/schema-gen.d.ts.map +1 -0
- package/dist/tools/schema-gen.js +52 -0
- package/dist/tools/schema-gen.js.map +1 -0
- package/dist/tools/shell.d.ts +12 -0
- package/dist/tools/shell.d.ts.map +1 -1
- package/dist/tools/shell.js +14 -1
- package/dist/tools/shell.js.map +1 -1
- package/dist/tools/skill-agent-tool.d.ts +108 -0
- package/dist/tools/skill-agent-tool.d.ts.map +1 -0
- package/dist/tools/skill-agent-tool.js +135 -0
- package/dist/tools/skill-agent-tool.js.map +1 -0
- package/dist/tools/web-agent-tools.d.ts +72 -0
- package/dist/tools/web-agent-tools.d.ts.map +1 -0
- package/dist/tools/web-agent-tools.js +393 -0
- package/dist/tools/web-agent-tools.js.map +1 -0
- package/dist/tools/web-search-backends.d.ts +156 -0
- package/dist/tools/web-search-backends.d.ts.map +1 -0
- package/dist/tools/web-search-backends.js +290 -0
- package/dist/tools/web-search-backends.js.map +1 -0
- package/dist/validation/engine-ops.d.ts.map +1 -1
- package/dist/validation/engine-ops.js +17 -1
- package/dist/validation/engine-ops.js.map +1 -1
- package/dist/validation/ops.d.ts +1 -15
- package/dist/validation/ops.d.ts.map +1 -1
- package/dist/validation/ops.js +0 -20
- package/dist/validation/ops.js.map +1 -1
- package/migrations/drizzle-brain/20260610000001_t10405-bitemporal-network-columns/migration.sql +71 -0
- package/migrations/drizzle-cleo-global/20260607000000_t11891-writer-leases/migration.sql +55 -0
- package/migrations/drizzle-cleo-global/20260607010000_t11639-session-manifest/migration.sql +43 -0
- package/migrations/drizzle-cleo-global/20260608000000_t11899-pi-session-tree/migration.sql +52 -0
- package/migrations/drizzle-cleo-global/20260608010000_t11709-accounts-credential-pool/migration.sql +72 -0
- package/migrations/drizzle-cleo-global/20260608020000_t11889-selfimprove-dhq/migration.sql +64 -0
- package/migrations/drizzle-cleo-global/20260609000000_t11937-service-vault/migration.sql +93 -0
- package/migrations/drizzle-cleo-global/20260609010000_t11733-models-catalog/migration.sql +65 -0
- package/migrations/drizzle-cleo-global/20260609020000_t11703-providers/migration.sql +52 -0
- package/migrations/drizzle-cleo-global/20260610000000_t11962-schedules/migration.sql +48 -0
- package/migrations/drizzle-cleo-project/20260607000000_t11891-writer-leases/migration.sql +55 -0
- package/migrations/drizzle-cleo-project/20260607010000_t11639-session-parent/migration.sql +22 -0
- package/migrations/drizzle-cleo-project/20260608000000_t11899-pi-session-tree/migration.sql +52 -0
- package/migrations/drizzle-cleo-project/20260608020000_t11889-selfimprove-dhq/migration.sql +64 -0
- package/migrations/drizzle-cleo-project/20260610000000_t11962-schedules/migration.sql +48 -0
- package/package.json +26 -14
- package/dist/lifecycle/chain-composition.d.ts +0 -30
- package/dist/lifecycle/chain-composition.d.ts.map +0 -1
- package/dist/lifecycle/chain-composition.js +0 -152
- package/dist/lifecycle/chain-composition.js.map +0 -1
- package/dist/lifecycle/chain-store.d.ts +0 -70
- package/dist/lifecycle/chain-store.d.ts.map +0 -1
- package/dist/lifecycle/chain-store.js +0 -246
- package/dist/lifecycle/chain-store.js.map +0 -1
- package/dist/lifecycle/default-chain.d.ts +0 -39
- package/dist/lifecycle/default-chain.d.ts.map +0 -1
- package/dist/lifecycle/default-chain.js +0 -176
- package/dist/lifecycle/default-chain.js.map +0 -1
- package/dist/lifecycle/tessera-engine.d.ts +0 -48
- package/dist/lifecycle/tessera-engine.d.ts.map +0 -1
- package/dist/lifecycle/tessera-engine.js +0 -249
- package/dist/lifecycle/tessera-engine.js.map +0 -1
- package/dist/validation/chain-validation.d.ts +0 -43
- package/dist/validation/chain-validation.d.ts.map +0 -1
- package/dist/validation/chain-validation.js +0 -146
- package/dist/validation/chain-validation.js.map +0 -1
|
@@ -0,0 +1,206 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Budget caps + circuit-breaker state machine for the self-improvement loop
|
|
3
|
+
* (T11889 · T11889-C).
|
|
4
|
+
*
|
|
5
|
+
* The loop is an AUTONOMOUS dogfooding engine — it boots a sandbox, replays a
|
|
6
|
+
* scenario, and on a regression it WRITES a leased DHQ row and opens a draft PR.
|
|
7
|
+
* Two guardrails bound that autonomy:
|
|
8
|
+
*
|
|
9
|
+
* 1. {@link SelfImproveBudget} — HARD, in-code caps (`maxTokens`, `maxUsd`,
|
|
10
|
+
* `maxPrs = 1`, `maxWorktrees = 1`). These are REAL, not advisory: the engine
|
|
11
|
+
* asks {@link CircuitBreaker.assertWithinBudget} BEFORE each costed step, so a
|
|
12
|
+
* cap is enforced as a PRE-FLIGHT check (never merely observed after the fact).
|
|
13
|
+
* `MemoryMax=32G` is NOT an in-code cap — a CORE function cannot portably
|
|
14
|
+
* self-confine to a cgroup (`systemd-run` is Linux-only) — it is an OPERATIONAL
|
|
15
|
+
* launch-wrapper documented on {@link MEMORY_MAX_LAUNCH_WRAPPER}; the in-process
|
|
16
|
+
* complement is the gondolin VM's own `memory` option.
|
|
17
|
+
* 2. {@link CircuitBreaker} — a one-way latch that HALTS the run (no further ops,
|
|
18
|
+
* no DHQ write, no PR) the moment any of these trip:
|
|
19
|
+
* - an architectural gate goes RED (`gateRed`);
|
|
20
|
+
* - the writer lease throws {@link "../store/writer-lease.js".LeaseUnavailableError}
|
|
21
|
+
* (a `require`-mode acquisition FAILURE — `leaseUnavailable`);
|
|
22
|
+
* - a budget cap would be exceeded (`budgetOverrun`);
|
|
23
|
+
* - a DB error escapes the leased section (`dbError`).
|
|
24
|
+
* It does NOT trip on "daemon OFF": the default lease mode is `local` (no
|
|
25
|
+
* daemon), so daemon-off is the NORMAL operating state — tripping on it would
|
|
26
|
+
* block EVERY write in the default config (P5 spec §B.7 correction).
|
|
27
|
+
*
|
|
28
|
+
* This module is PURE — no DB, no native handle, no `cleo` mutation, no I/O.
|
|
29
|
+
* Import-time side-effect-free.
|
|
30
|
+
*
|
|
31
|
+
* @module @cleocode/core/selfimprove/budget
|
|
32
|
+
* @epic T11889
|
|
33
|
+
* @task T11913
|
|
34
|
+
*/
|
|
35
|
+
/**
|
|
36
|
+
* The reasons the circuit-breaker may latch OPEN. Each is a genuine
|
|
37
|
+
* halt-the-loop condition (P5 spec §B.7). Deliberately does NOT include a
|
|
38
|
+
* "daemon-off" reason — the default `local` lease mode runs daemon-less, so that
|
|
39
|
+
* is the normal state, not a fault.
|
|
40
|
+
*/
|
|
41
|
+
export type CircuitBreakerReason =
|
|
42
|
+
/** An architectural gate (`cleo check arch --strict`) went RED. */
|
|
43
|
+
'gateRed'
|
|
44
|
+
/** The writer lease threw `LeaseUnavailableError` (`require`-mode failure). */
|
|
45
|
+
| 'leaseUnavailable'
|
|
46
|
+
/** A budget cap (tokens/$/PRs/worktrees) would be exceeded. */
|
|
47
|
+
| 'budgetOverrun'
|
|
48
|
+
/** A DB error escaped the leased section. */
|
|
49
|
+
| 'dbError';
|
|
50
|
+
/**
|
|
51
|
+
* Hard, in-code budget caps for ONE self-improvement run.
|
|
52
|
+
*
|
|
53
|
+
* `maxPrs` and `maxWorktrees` are pinned to `1` by {@link DEFAULT_BUDGET}: the loop
|
|
54
|
+
* opens AT MOST one draft PR and boots AT MOST one sandbox per run. `maxTokens` /
|
|
55
|
+
* `maxUsd` bound model spend; the engine accumulates per-op cost and asks
|
|
56
|
+
* {@link CircuitBreaker.assertWithinBudget} before each costed step.
|
|
57
|
+
*
|
|
58
|
+
* `MemoryMax=32G` is intentionally ABSENT here — it is enforced at the launch
|
|
59
|
+
* boundary (see {@link MEMORY_MAX_LAUNCH_WRAPPER}), not by this object.
|
|
60
|
+
*/
|
|
61
|
+
export interface SelfImproveBudget {
|
|
62
|
+
/** Maximum model tokens spent across the whole run. */
|
|
63
|
+
readonly maxTokens: number;
|
|
64
|
+
/** Maximum USD spent across the whole run. */
|
|
65
|
+
readonly maxUsd: number;
|
|
66
|
+
/** Maximum draft PRs opened in the run (pinned to `1`). */
|
|
67
|
+
readonly maxPrs: number;
|
|
68
|
+
/** Maximum sandbox envs booted in the run (pinned to `1`). */
|
|
69
|
+
readonly maxWorktrees: number;
|
|
70
|
+
}
|
|
71
|
+
/**
|
|
72
|
+
* The default budget for a self-improvement run. `maxPrs` / `maxWorktrees` are
|
|
73
|
+
* `1` by contract; `maxTokens` / `maxUsd` are conservative defaults overridable
|
|
74
|
+
* via {@link resolveBudget} (env) or an explicit partial.
|
|
75
|
+
*/
|
|
76
|
+
export declare const DEFAULT_BUDGET: SelfImproveBudget;
|
|
77
|
+
/**
|
|
78
|
+
* The launch-boundary memory cap — an OPERATIONAL wrapper, NOT an in-code cap.
|
|
79
|
+
*
|
|
80
|
+
* A CORE function cannot portably self-confine to a cgroup (`systemd-run` is
|
|
81
|
+
* Linux-only; re-exec'ing under it from inside the engine is fragile), so the
|
|
82
|
+
* runbook / spawn wrapper that invokes `cleo selfimprove run` wraps it on Linux.
|
|
83
|
+
* On macOS the gondolin VM's own `memory` option bounds the guest. Exported as a
|
|
84
|
+
* documented constant so the spawn wrapper and the runbook share one SSoT string.
|
|
85
|
+
*/
|
|
86
|
+
export declare const MEMORY_MAX_LAUNCH_WRAPPER: "systemd-run --user --scope -p MemoryMax=32G -p MemorySwapMax=0";
|
|
87
|
+
/**
|
|
88
|
+
* The mutable cost accumulator the engine threads through one run. Every costed
|
|
89
|
+
* step ADDS to this before asking the breaker whether the next step fits.
|
|
90
|
+
*/
|
|
91
|
+
export interface BudgetSpend {
|
|
92
|
+
/** Tokens spent so far. */
|
|
93
|
+
tokens: number;
|
|
94
|
+
/** USD spent so far. */
|
|
95
|
+
usd: number;
|
|
96
|
+
/** Draft PRs opened so far. */
|
|
97
|
+
prs: number;
|
|
98
|
+
/** Sandbox envs booted so far. */
|
|
99
|
+
worktrees: number;
|
|
100
|
+
}
|
|
101
|
+
/** A fresh, zeroed {@link BudgetSpend}. */
|
|
102
|
+
export declare function emptySpend(): BudgetSpend;
|
|
103
|
+
/**
|
|
104
|
+
* The increment a single step would add to the spend. Each field defaults to `0`,
|
|
105
|
+
* so a step that only opens a PR passes `{ prs: 1 }`.
|
|
106
|
+
*/
|
|
107
|
+
export interface BudgetCharge {
|
|
108
|
+
/** Tokens this step would consume. */
|
|
109
|
+
readonly tokens?: number;
|
|
110
|
+
/** USD this step would consume. */
|
|
111
|
+
readonly usd?: number;
|
|
112
|
+
/** Draft PRs this step would open. */
|
|
113
|
+
readonly prs?: number;
|
|
114
|
+
/** Sandbox envs this step would boot. */
|
|
115
|
+
readonly worktrees?: number;
|
|
116
|
+
}
|
|
117
|
+
/**
|
|
118
|
+
* Thrown by {@link CircuitBreaker.assertWithinBudget} when a step's charge would
|
|
119
|
+
* push the accumulated spend past a cap. Carries the offending dimension so the
|
|
120
|
+
* engine can trip the breaker with `reason: 'budgetOverrun'` and surface WHICH cap.
|
|
121
|
+
*/
|
|
122
|
+
export declare class BudgetExceededError extends Error {
|
|
123
|
+
/** Stable machine-readable code. */
|
|
124
|
+
readonly code: "E_SELFIMPROVE_BUDGET_EXCEEDED";
|
|
125
|
+
/** Which cap was exceeded. */
|
|
126
|
+
readonly dimension: keyof SelfImproveBudget;
|
|
127
|
+
/**
|
|
128
|
+
* @param dimension - The exceeded cap dimension.
|
|
129
|
+
* @param attempted - The accumulated value the step would have reached.
|
|
130
|
+
* @param cap - The cap that bounds it.
|
|
131
|
+
*/
|
|
132
|
+
constructor(dimension: keyof SelfImproveBudget, attempted: number, cap: number);
|
|
133
|
+
}
|
|
134
|
+
/** Snapshot of the circuit-breaker latch state. */
|
|
135
|
+
export interface CircuitBreakerState {
|
|
136
|
+
/** Whether the breaker has latched OPEN (the loop must halt). */
|
|
137
|
+
readonly open: boolean;
|
|
138
|
+
/** The reason the breaker tripped, or `null` while closed. */
|
|
139
|
+
readonly reason: CircuitBreakerReason | null;
|
|
140
|
+
/** A human-readable detail for the trip, or `null` while closed. */
|
|
141
|
+
readonly detail: string | null;
|
|
142
|
+
}
|
|
143
|
+
/**
|
|
144
|
+
* A one-way circuit-breaker latch + pre-flight budget gate for ONE run.
|
|
145
|
+
*
|
|
146
|
+
* Once {@link trip} is called the breaker stays OPEN for the run's lifetime —
|
|
147
|
+
* there is no reset (a run is single-use; the next run constructs a fresh
|
|
148
|
+
* breaker). {@link assertOpen} short-circuits B.4-B.5 to a no-op the moment the
|
|
149
|
+
* latch is set, and {@link assertWithinBudget} is the PRE-FLIGHT check the engine
|
|
150
|
+
* runs before each costed step.
|
|
151
|
+
*
|
|
152
|
+
* PURE — holds only in-memory counters; no I/O.
|
|
153
|
+
*/
|
|
154
|
+
export declare class CircuitBreaker {
|
|
155
|
+
#private;
|
|
156
|
+
/**
|
|
157
|
+
* @param budget - The caps for this run (defaults to {@link DEFAULT_BUDGET}).
|
|
158
|
+
* @param spend - The starting spend (defaults to a zeroed accumulator).
|
|
159
|
+
*/
|
|
160
|
+
constructor(budget?: SelfImproveBudget, spend?: BudgetSpend);
|
|
161
|
+
/** Whether the breaker has latched OPEN. */
|
|
162
|
+
get isOpen(): boolean;
|
|
163
|
+
/** The current latch state (open flag + reason + detail). */
|
|
164
|
+
get state(): CircuitBreakerState;
|
|
165
|
+
/** The accumulated spend so far (a live read of the internal counters). */
|
|
166
|
+
get spend(): Readonly<BudgetSpend>;
|
|
167
|
+
/**
|
|
168
|
+
* Latch the breaker OPEN. Idempotent: the FIRST trip wins — a later trip does
|
|
169
|
+
* not overwrite the original reason (the first fault is the relevant one).
|
|
170
|
+
*
|
|
171
|
+
* @param reason - The trip reason.
|
|
172
|
+
* @param detail - A human-readable detail for logs / the run report.
|
|
173
|
+
*/
|
|
174
|
+
trip(reason: CircuitBreakerReason, detail: string): void;
|
|
175
|
+
/**
|
|
176
|
+
* Throw if the breaker is OPEN — the engine calls this at the top of each
|
|
177
|
+
* phase so a tripped breaker short-circuits the rest of the run.
|
|
178
|
+
*
|
|
179
|
+
* @throws {Error} `E_SELFIMPROVE_CIRCUIT_OPEN` when the breaker is latched.
|
|
180
|
+
*/
|
|
181
|
+
assertClosed(): void;
|
|
182
|
+
/**
|
|
183
|
+
* PRE-FLIGHT budget check for a costed step. Computes the spend the step WOULD
|
|
184
|
+
* reach and — if any dimension would exceed its cap — TRIPS the breaker with
|
|
185
|
+
* `reason: 'budgetOverrun'` and throws {@link BudgetExceededError} BEFORE the
|
|
186
|
+
* step runs. On success it COMMITS the charge to the accumulator.
|
|
187
|
+
*
|
|
188
|
+
* @param charge - The increment the step would add.
|
|
189
|
+
* @throws {BudgetExceededError} When a cap would be exceeded (and trips the breaker).
|
|
190
|
+
*/
|
|
191
|
+
chargeOrTrip(charge: BudgetCharge): void;
|
|
192
|
+
}
|
|
193
|
+
/**
|
|
194
|
+
* Resolve the effective {@link SelfImproveBudget}, layering env overrides over an
|
|
195
|
+
* explicit partial over {@link DEFAULT_BUDGET}. `maxPrs` / `maxWorktrees` are
|
|
196
|
+
* ALWAYS clamped to at most `1` regardless of override — the one-PR / one-sandbox
|
|
197
|
+
* ceiling is a hard invariant, not a tunable.
|
|
198
|
+
*
|
|
199
|
+
* Env overrides (numeric): `CLEO_SELFIMPROVE_MAX_TOKENS`, `CLEO_SELFIMPROVE_MAX_USD`.
|
|
200
|
+
*
|
|
201
|
+
* @param overrides - Optional explicit partial caps (test / caller injection).
|
|
202
|
+
* @param env - The environment to read overrides from (defaults to `process.env`).
|
|
203
|
+
* @returns The resolved, invariant-clamped budget.
|
|
204
|
+
*/
|
|
205
|
+
export declare function resolveBudget(overrides?: Partial<SelfImproveBudget>, env?: NodeJS.ProcessEnv): SelfImproveBudget;
|
|
206
|
+
//# sourceMappingURL=budget.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"budget.d.ts","sourceRoot":"","sources":["../../src/selfimprove/budget.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,203 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Budget caps + circuit-breaker state machine for the self-improvement loop
|
|
3
|
+
* (T11889 · T11889-C).
|
|
4
|
+
*
|
|
5
|
+
* The loop is an AUTONOMOUS dogfooding engine — it boots a sandbox, replays a
|
|
6
|
+
* scenario, and on a regression it WRITES a leased DHQ row and opens a draft PR.
|
|
7
|
+
* Two guardrails bound that autonomy:
|
|
8
|
+
*
|
|
9
|
+
* 1. {@link SelfImproveBudget} — HARD, in-code caps (`maxTokens`, `maxUsd`,
|
|
10
|
+
* `maxPrs = 1`, `maxWorktrees = 1`). These are REAL, not advisory: the engine
|
|
11
|
+
* asks {@link CircuitBreaker.assertWithinBudget} BEFORE each costed step, so a
|
|
12
|
+
* cap is enforced as a PRE-FLIGHT check (never merely observed after the fact).
|
|
13
|
+
* `MemoryMax=32G` is NOT an in-code cap — a CORE function cannot portably
|
|
14
|
+
* self-confine to a cgroup (`systemd-run` is Linux-only) — it is an OPERATIONAL
|
|
15
|
+
* launch-wrapper documented on {@link MEMORY_MAX_LAUNCH_WRAPPER}; the in-process
|
|
16
|
+
* complement is the gondolin VM's own `memory` option.
|
|
17
|
+
* 2. {@link CircuitBreaker} — a one-way latch that HALTS the run (no further ops,
|
|
18
|
+
* no DHQ write, no PR) the moment any of these trip:
|
|
19
|
+
* - an architectural gate goes RED (`gateRed`);
|
|
20
|
+
* - the writer lease throws {@link "../store/writer-lease.js".LeaseUnavailableError}
|
|
21
|
+
* (a `require`-mode acquisition FAILURE — `leaseUnavailable`);
|
|
22
|
+
* - a budget cap would be exceeded (`budgetOverrun`);
|
|
23
|
+
* - a DB error escapes the leased section (`dbError`).
|
|
24
|
+
* It does NOT trip on "daemon OFF": the default lease mode is `local` (no
|
|
25
|
+
* daemon), so daemon-off is the NORMAL operating state — tripping on it would
|
|
26
|
+
* block EVERY write in the default config (P5 spec §B.7 correction).
|
|
27
|
+
*
|
|
28
|
+
* This module is PURE — no DB, no native handle, no `cleo` mutation, no I/O.
|
|
29
|
+
* Import-time side-effect-free.
|
|
30
|
+
*
|
|
31
|
+
* @module @cleocode/core/selfimprove/budget
|
|
32
|
+
* @epic T11889
|
|
33
|
+
* @task T11913
|
|
34
|
+
*/
|
|
35
|
+
/**
|
|
36
|
+
* The default budget for a self-improvement run. `maxPrs` / `maxWorktrees` are
|
|
37
|
+
* `1` by contract; `maxTokens` / `maxUsd` are conservative defaults overridable
|
|
38
|
+
* via {@link resolveBudget} (env) or an explicit partial.
|
|
39
|
+
*/
|
|
40
|
+
export const DEFAULT_BUDGET = {
|
|
41
|
+
maxTokens: 200_000,
|
|
42
|
+
maxUsd: 5,
|
|
43
|
+
maxPrs: 1,
|
|
44
|
+
maxWorktrees: 1,
|
|
45
|
+
};
|
|
46
|
+
/**
|
|
47
|
+
* The launch-boundary memory cap — an OPERATIONAL wrapper, NOT an in-code cap.
|
|
48
|
+
*
|
|
49
|
+
* A CORE function cannot portably self-confine to a cgroup (`systemd-run` is
|
|
50
|
+
* Linux-only; re-exec'ing under it from inside the engine is fragile), so the
|
|
51
|
+
* runbook / spawn wrapper that invokes `cleo selfimprove run` wraps it on Linux.
|
|
52
|
+
* On macOS the gondolin VM's own `memory` option bounds the guest. Exported as a
|
|
53
|
+
* documented constant so the spawn wrapper and the runbook share one SSoT string.
|
|
54
|
+
*/
|
|
55
|
+
export const MEMORY_MAX_LAUNCH_WRAPPER = 'systemd-run --user --scope -p MemoryMax=32G -p MemorySwapMax=0';
|
|
56
|
+
/** A fresh, zeroed {@link BudgetSpend}. */
|
|
57
|
+
export function emptySpend() {
|
|
58
|
+
return { tokens: 0, usd: 0, prs: 0, worktrees: 0 };
|
|
59
|
+
}
|
|
60
|
+
/**
|
|
61
|
+
* Thrown by {@link CircuitBreaker.assertWithinBudget} when a step's charge would
|
|
62
|
+
* push the accumulated spend past a cap. Carries the offending dimension so the
|
|
63
|
+
* engine can trip the breaker with `reason: 'budgetOverrun'` and surface WHICH cap.
|
|
64
|
+
*/
|
|
65
|
+
export class BudgetExceededError extends Error {
|
|
66
|
+
/** Stable machine-readable code. */
|
|
67
|
+
code = 'E_SELFIMPROVE_BUDGET_EXCEEDED';
|
|
68
|
+
/** Which cap was exceeded. */
|
|
69
|
+
dimension;
|
|
70
|
+
/**
|
|
71
|
+
* @param dimension - The exceeded cap dimension.
|
|
72
|
+
* @param attempted - The accumulated value the step would have reached.
|
|
73
|
+
* @param cap - The cap that bounds it.
|
|
74
|
+
*/
|
|
75
|
+
constructor(dimension, attempted, cap) {
|
|
76
|
+
super(`self-improve budget exceeded: ${dimension} would reach ${attempted}, cap is ${cap}`);
|
|
77
|
+
this.name = 'BudgetExceededError';
|
|
78
|
+
this.dimension = dimension;
|
|
79
|
+
}
|
|
80
|
+
}
|
|
81
|
+
/**
|
|
82
|
+
* A one-way circuit-breaker latch + pre-flight budget gate for ONE run.
|
|
83
|
+
*
|
|
84
|
+
* Once {@link trip} is called the breaker stays OPEN for the run's lifetime —
|
|
85
|
+
* there is no reset (a run is single-use; the next run constructs a fresh
|
|
86
|
+
* breaker). {@link assertOpen} short-circuits B.4-B.5 to a no-op the moment the
|
|
87
|
+
* latch is set, and {@link assertWithinBudget} is the PRE-FLIGHT check the engine
|
|
88
|
+
* runs before each costed step.
|
|
89
|
+
*
|
|
90
|
+
* PURE — holds only in-memory counters; no I/O.
|
|
91
|
+
*/
|
|
92
|
+
export class CircuitBreaker {
|
|
93
|
+
#budget;
|
|
94
|
+
#spend;
|
|
95
|
+
#open = false;
|
|
96
|
+
#reason = null;
|
|
97
|
+
#detail = null;
|
|
98
|
+
/**
|
|
99
|
+
* @param budget - The caps for this run (defaults to {@link DEFAULT_BUDGET}).
|
|
100
|
+
* @param spend - The starting spend (defaults to a zeroed accumulator).
|
|
101
|
+
*/
|
|
102
|
+
constructor(budget = DEFAULT_BUDGET, spend = emptySpend()) {
|
|
103
|
+
this.#budget = budget;
|
|
104
|
+
this.#spend = spend;
|
|
105
|
+
}
|
|
106
|
+
/** Whether the breaker has latched OPEN. */
|
|
107
|
+
get isOpen() {
|
|
108
|
+
return this.#open;
|
|
109
|
+
}
|
|
110
|
+
/** The current latch state (open flag + reason + detail). */
|
|
111
|
+
get state() {
|
|
112
|
+
return { open: this.#open, reason: this.#reason, detail: this.#detail };
|
|
113
|
+
}
|
|
114
|
+
/** The accumulated spend so far (a live read of the internal counters). */
|
|
115
|
+
get spend() {
|
|
116
|
+
return { ...this.#spend };
|
|
117
|
+
}
|
|
118
|
+
/**
|
|
119
|
+
* Latch the breaker OPEN. Idempotent: the FIRST trip wins — a later trip does
|
|
120
|
+
* not overwrite the original reason (the first fault is the relevant one).
|
|
121
|
+
*
|
|
122
|
+
* @param reason - The trip reason.
|
|
123
|
+
* @param detail - A human-readable detail for logs / the run report.
|
|
124
|
+
*/
|
|
125
|
+
trip(reason, detail) {
|
|
126
|
+
if (this.#open)
|
|
127
|
+
return;
|
|
128
|
+
this.#open = true;
|
|
129
|
+
this.#reason = reason;
|
|
130
|
+
this.#detail = detail;
|
|
131
|
+
}
|
|
132
|
+
/**
|
|
133
|
+
* Throw if the breaker is OPEN — the engine calls this at the top of each
|
|
134
|
+
* phase so a tripped breaker short-circuits the rest of the run.
|
|
135
|
+
*
|
|
136
|
+
* @throws {Error} `E_SELFIMPROVE_CIRCUIT_OPEN` when the breaker is latched.
|
|
137
|
+
*/
|
|
138
|
+
assertClosed() {
|
|
139
|
+
if (this.#open) {
|
|
140
|
+
const err = new Error(`self-improve circuit-breaker OPEN (${this.#reason}): ${this.#detail}`);
|
|
141
|
+
err.code = 'E_SELFIMPROVE_CIRCUIT_OPEN';
|
|
142
|
+
throw err;
|
|
143
|
+
}
|
|
144
|
+
}
|
|
145
|
+
/**
|
|
146
|
+
* PRE-FLIGHT budget check for a costed step. Computes the spend the step WOULD
|
|
147
|
+
* reach and — if any dimension would exceed its cap — TRIPS the breaker with
|
|
148
|
+
* `reason: 'budgetOverrun'` and throws {@link BudgetExceededError} BEFORE the
|
|
149
|
+
* step runs. On success it COMMITS the charge to the accumulator.
|
|
150
|
+
*
|
|
151
|
+
* @param charge - The increment the step would add.
|
|
152
|
+
* @throws {BudgetExceededError} When a cap would be exceeded (and trips the breaker).
|
|
153
|
+
*/
|
|
154
|
+
chargeOrTrip(charge) {
|
|
155
|
+
const next = {
|
|
156
|
+
tokens: this.#spend.tokens + (charge.tokens ?? 0),
|
|
157
|
+
usd: this.#spend.usd + (charge.usd ?? 0),
|
|
158
|
+
prs: this.#spend.prs + (charge.prs ?? 0),
|
|
159
|
+
worktrees: this.#spend.worktrees + (charge.worktrees ?? 0),
|
|
160
|
+
};
|
|
161
|
+
const checks = [
|
|
162
|
+
['maxTokens', next.tokens, this.#budget.maxTokens],
|
|
163
|
+
['maxUsd', next.usd, this.#budget.maxUsd],
|
|
164
|
+
['maxPrs', next.prs, this.#budget.maxPrs],
|
|
165
|
+
['maxWorktrees', next.worktrees, this.#budget.maxWorktrees],
|
|
166
|
+
];
|
|
167
|
+
for (const [dimension, attempted, cap] of checks) {
|
|
168
|
+
if (attempted > cap) {
|
|
169
|
+
const err = new BudgetExceededError(dimension, attempted, cap);
|
|
170
|
+
this.trip('budgetOverrun', err.message);
|
|
171
|
+
throw err;
|
|
172
|
+
}
|
|
173
|
+
}
|
|
174
|
+
this.#spend.tokens = next.tokens;
|
|
175
|
+
this.#spend.usd = next.usd;
|
|
176
|
+
this.#spend.prs = next.prs;
|
|
177
|
+
this.#spend.worktrees = next.worktrees;
|
|
178
|
+
}
|
|
179
|
+
}
|
|
180
|
+
/**
|
|
181
|
+
* Resolve the effective {@link SelfImproveBudget}, layering env overrides over an
|
|
182
|
+
* explicit partial over {@link DEFAULT_BUDGET}. `maxPrs` / `maxWorktrees` are
|
|
183
|
+
* ALWAYS clamped to at most `1` regardless of override — the one-PR / one-sandbox
|
|
184
|
+
* ceiling is a hard invariant, not a tunable.
|
|
185
|
+
*
|
|
186
|
+
* Env overrides (numeric): `CLEO_SELFIMPROVE_MAX_TOKENS`, `CLEO_SELFIMPROVE_MAX_USD`.
|
|
187
|
+
*
|
|
188
|
+
* @param overrides - Optional explicit partial caps (test / caller injection).
|
|
189
|
+
* @param env - The environment to read overrides from (defaults to `process.env`).
|
|
190
|
+
* @returns The resolved, invariant-clamped budget.
|
|
191
|
+
*/
|
|
192
|
+
export function resolveBudget(overrides = {}, env = process.env) {
|
|
193
|
+
const envTokens = Number(env.CLEO_SELFIMPROVE_MAX_TOKENS);
|
|
194
|
+
const envUsd = Number(env.CLEO_SELFIMPROVE_MAX_USD);
|
|
195
|
+
const maxTokens = overrides.maxTokens ??
|
|
196
|
+
(Number.isFinite(envTokens) && envTokens > 0 ? envTokens : DEFAULT_BUDGET.maxTokens);
|
|
197
|
+
const maxUsd = overrides.maxUsd ?? (Number.isFinite(envUsd) && envUsd > 0 ? envUsd : DEFAULT_BUDGET.maxUsd);
|
|
198
|
+
// The one-PR / one-sandbox ceiling is invariant — clamp to at most 1.
|
|
199
|
+
const maxPrs = Math.min(1, overrides.maxPrs ?? DEFAULT_BUDGET.maxPrs);
|
|
200
|
+
const maxWorktrees = Math.min(1, overrides.maxWorktrees ?? DEFAULT_BUDGET.maxWorktrees);
|
|
201
|
+
return { maxTokens, maxUsd, maxPrs, maxWorktrees };
|
|
202
|
+
}
|
|
203
|
+
//# sourceMappingURL=budget.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"budget.js","sourceRoot":"","sources":["../../src/selfimprove/budget.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,105 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Durable DHQ adapter for the self-improvement loop (T11889 · T11889-C).
|
|
3
|
+
*
|
|
4
|
+
* This adapter sits OUTSIDE the store chokepoint (it is in `selfimprove/`, not
|
|
5
|
+
* `store/`), so it MUST NOT open a raw native handle (Gate-3). It is the lease
|
|
6
|
+
* boundary: EVERY write it performs is wrapped in
|
|
7
|
+
* {@link "../store/writer-lease.js".withWriterLease}`('project', 'bulk', …)`, which
|
|
8
|
+
* serializes the write against any other writer on the `(project, bulk)` lane. It
|
|
9
|
+
* then calls the Gate-3 accessors in
|
|
10
|
+
* {@link "../store/selfimprove-dhq-store.js"} (the ONLY native-handle toucher) —
|
|
11
|
+
* whose prepared statements target ONLY `selfimprove_dhq`.
|
|
12
|
+
*
|
|
13
|
+
* Two invariants the rest of the loop relies on:
|
|
14
|
+
*
|
|
15
|
+
* 1. **No raw / unleased write.** Reads go straight through the accessor (the
|
|
16
|
+
* shared handle, no lease); every WRITE goes through {@link upsertOpenDhq} /
|
|
17
|
+
* {@link recordPrUrl}, both of which acquire the lease first. There is no
|
|
18
|
+
* code path here that mutates `cleo.db` without the lease.
|
|
19
|
+
* 2. **`selfimprove_dhq` ONLY — never a prod `tasks`/`brain` row.** The lease
|
|
20
|
+
* SERIALIZES the write; it does NOT confine it to a table. The
|
|
21
|
+
* table-confinement is ENTIRELY this adapter's discipline: it calls only the
|
|
22
|
+
* `selfimprove_dhq` accessors, whose SQL references no other table. A unit
|
|
23
|
+
* test asserts the accessor SQL targets `selfimprove_dhq` and nothing else.
|
|
24
|
+
*
|
|
25
|
+
* Lease-mode note (P5 spec §B.7): the default mode is `local` (no daemon), where a
|
|
26
|
+
* contended lease DEGRADES under `busy_timeout` rather than throwing. To get a hard
|
|
27
|
+
* denial signal for the circuit-breaker, the process runs in `require` mode
|
|
28
|
+
* (`CLEO_WRITER_LEASE_MODE=require`), where an unacquirable lease THROWS
|
|
29
|
+
* {@link "../store/writer-lease.js".LeaseUnavailableError}. This adapter does NOT
|
|
30
|
+
* swallow that throw — it propagates so {@link runSelfImprove} trips the breaker.
|
|
31
|
+
*
|
|
32
|
+
* This module is import-time side-effect-free.
|
|
33
|
+
*
|
|
34
|
+
* @module @cleocode/core/selfimprove/dhq-adapter
|
|
35
|
+
* @epic T11889
|
|
36
|
+
* @task T11913
|
|
37
|
+
*/
|
|
38
|
+
import { type SelfimproveDhqRow } from '../store/selfimprove-dhq-store.js';
|
|
39
|
+
/**
|
|
40
|
+
* The fields the engine supplies to {@link upsertOpenDhq}. `now` and the fixed
|
|
41
|
+
* `status: 'open'` are stamped by the accessor; `dhqId` / `severity` carry through.
|
|
42
|
+
*/
|
|
43
|
+
export interface UpsertDhqInput {
|
|
44
|
+
/** Stable `'DHQ-###'` handle (used only on first insert for a hash). */
|
|
45
|
+
readonly dhqId: string;
|
|
46
|
+
/** The scenario name replayed. */
|
|
47
|
+
readonly scenario: string;
|
|
48
|
+
/** sha256 of the normalized regression signature — the idempotency key. */
|
|
49
|
+
readonly questionHash: string;
|
|
50
|
+
/** Human-readable DHQ title. */
|
|
51
|
+
readonly title: string;
|
|
52
|
+
/** The envelope-diff payload (the evidence) as serialized JSON. */
|
|
53
|
+
readonly regressionJson: string;
|
|
54
|
+
/** Severity classification, or `null` until triaged. */
|
|
55
|
+
readonly severity: string | null;
|
|
56
|
+
/** Ties the row to ONE loop run. */
|
|
57
|
+
readonly runId: string;
|
|
58
|
+
}
|
|
59
|
+
/** The durable DHQ adapter — the lease boundary for the self-improvement loop. */
|
|
60
|
+
export interface DhqAdapter {
|
|
61
|
+
/**
|
|
62
|
+
* Read the open DHQ row for a `question_hash` (lease-free — readers share the
|
|
63
|
+
* handle). Returns `null` when no open row exists.
|
|
64
|
+
*/
|
|
65
|
+
readOpen(questionHash: string): Promise<SelfimproveDhqRow | null>;
|
|
66
|
+
/**
|
|
67
|
+
* UPSERT exactly ONE open DHQ row for a `question_hash`, under the
|
|
68
|
+
* `(project, bulk)` writer lease. Idempotent via the partial-UNIQUE index: a
|
|
69
|
+
* repeated open regression refreshes the existing row.
|
|
70
|
+
*/
|
|
71
|
+
upsertOpenDhq(input: UpsertDhqInput): Promise<void>;
|
|
72
|
+
/**
|
|
73
|
+
* Record the draft PR URL on the open DHQ row for a `question_hash`, under the
|
|
74
|
+
* `(project, bulk)` writer lease.
|
|
75
|
+
*
|
|
76
|
+
* @returns The number of rows updated (0 when no open row exists).
|
|
77
|
+
*/
|
|
78
|
+
recordPrUrl(questionHash: string, prUrl: string): Promise<number>;
|
|
79
|
+
}
|
|
80
|
+
/**
|
|
81
|
+
* Construct the durable DHQ adapter bound to a project working directory.
|
|
82
|
+
*
|
|
83
|
+
* Every WRITE method acquires the `(project, bulk)` writer lease via
|
|
84
|
+
* {@link "../store/writer-lease.js".withWriterLease} before delegating to the
|
|
85
|
+
* Gate-3 accessor. The native handle is resolved per call through
|
|
86
|
+
* {@link "../store/selfimprove-dhq-store.js".getSelfimproveDhqNativeDb} (the
|
|
87
|
+
* chokepoint singleton — no raw open). The clock is injectable for deterministic
|
|
88
|
+
* tests; production uses `Date.now`.
|
|
89
|
+
*
|
|
90
|
+
* @param opts - Adapter options.
|
|
91
|
+
* @param opts.cwd - Project working directory for scope resolution (defaults to `cwd`).
|
|
92
|
+
* @param opts.now - Injectable clock (defaults to {@link Date.now}).
|
|
93
|
+
* @returns A {@link DhqAdapter}.
|
|
94
|
+
*
|
|
95
|
+
* @example
|
|
96
|
+
* ```ts
|
|
97
|
+
* const adapter = createDhqAdapter({ cwd: projectRoot });
|
|
98
|
+
* await adapter.upsertOpenDhq({ dhqId: 'DHQ-001', … }); // leased UPSERT
|
|
99
|
+
* ```
|
|
100
|
+
*/
|
|
101
|
+
export declare function createDhqAdapter(opts?: {
|
|
102
|
+
cwd?: string;
|
|
103
|
+
now?: () => number;
|
|
104
|
+
}): DhqAdapter;
|
|
105
|
+
//# sourceMappingURL=dhq-adapter.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"dhq-adapter.d.ts","sourceRoot":"","sources":["../../src/selfimprove/dhq-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAEH,OAAO,EAGL,KAAK,iBAAiB,EAIvB,MAAM,mCAAmC,CAAC;AAG3C;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,wEAAwE;IACxE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,kCAAkC;IAClC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,2EAA2E;IAC3E,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,gCAAgC;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,mEAAmE;IACnE,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,wDAAwD;IACxD,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,oCAAoC;IACpC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,kFAAkF;AAClF,MAAM,WAAW,UAAU;IACzB;;;OAGG;IACH,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAAC;IAClE;;;;OAIG;IACH,aAAa,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpD;;;;;OAKG;IACH,WAAW,CAAC,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACnE;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,GAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAA;CAAO,GAAG,UAAU,CAoC5F"}
|
|
@@ -0,0 +1,95 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Durable DHQ adapter for the self-improvement loop (T11889 · T11889-C).
|
|
3
|
+
*
|
|
4
|
+
* This adapter sits OUTSIDE the store chokepoint (it is in `selfimprove/`, not
|
|
5
|
+
* `store/`), so it MUST NOT open a raw native handle (Gate-3). It is the lease
|
|
6
|
+
* boundary: EVERY write it performs is wrapped in
|
|
7
|
+
* {@link "../store/writer-lease.js".withWriterLease}`('project', 'bulk', …)`, which
|
|
8
|
+
* serializes the write against any other writer on the `(project, bulk)` lane. It
|
|
9
|
+
* then calls the Gate-3 accessors in
|
|
10
|
+
* {@link "../store/selfimprove-dhq-store.js"} (the ONLY native-handle toucher) —
|
|
11
|
+
* whose prepared statements target ONLY `selfimprove_dhq`.
|
|
12
|
+
*
|
|
13
|
+
* Two invariants the rest of the loop relies on:
|
|
14
|
+
*
|
|
15
|
+
* 1. **No raw / unleased write.** Reads go straight through the accessor (the
|
|
16
|
+
* shared handle, no lease); every WRITE goes through {@link upsertOpenDhq} /
|
|
17
|
+
* {@link recordPrUrl}, both of which acquire the lease first. There is no
|
|
18
|
+
* code path here that mutates `cleo.db` without the lease.
|
|
19
|
+
* 2. **`selfimprove_dhq` ONLY — never a prod `tasks`/`brain` row.** The lease
|
|
20
|
+
* SERIALIZES the write; it does NOT confine it to a table. The
|
|
21
|
+
* table-confinement is ENTIRELY this adapter's discipline: it calls only the
|
|
22
|
+
* `selfimprove_dhq` accessors, whose SQL references no other table. A unit
|
|
23
|
+
* test asserts the accessor SQL targets `selfimprove_dhq` and nothing else.
|
|
24
|
+
*
|
|
25
|
+
* Lease-mode note (P5 spec §B.7): the default mode is `local` (no daemon), where a
|
|
26
|
+
* contended lease DEGRADES under `busy_timeout` rather than throwing. To get a hard
|
|
27
|
+
* denial signal for the circuit-breaker, the process runs in `require` mode
|
|
28
|
+
* (`CLEO_WRITER_LEASE_MODE=require`), where an unacquirable lease THROWS
|
|
29
|
+
* {@link "../store/writer-lease.js".LeaseUnavailableError}. This adapter does NOT
|
|
30
|
+
* swallow that throw — it propagates so {@link runSelfImprove} trips the breaker.
|
|
31
|
+
*
|
|
32
|
+
* This module is import-time side-effect-free.
|
|
33
|
+
*
|
|
34
|
+
* @module @cleocode/core/selfimprove/dhq-adapter
|
|
35
|
+
* @epic T11889
|
|
36
|
+
* @task T11913
|
|
37
|
+
*/
|
|
38
|
+
import { getSelfimproveDhqNativeDb, readOpenSelfimproveDhq, setSelfimproveDhqPrUrl, upsertOpenSelfimproveDhq, } from '../store/selfimprove-dhq-store.js';
|
|
39
|
+
import { withWriterLease } from '../store/writer-lease.js';
|
|
40
|
+
/**
|
|
41
|
+
* Construct the durable DHQ adapter bound to a project working directory.
|
|
42
|
+
*
|
|
43
|
+
* Every WRITE method acquires the `(project, bulk)` writer lease via
|
|
44
|
+
* {@link "../store/writer-lease.js".withWriterLease} before delegating to the
|
|
45
|
+
* Gate-3 accessor. The native handle is resolved per call through
|
|
46
|
+
* {@link "../store/selfimprove-dhq-store.js".getSelfimproveDhqNativeDb} (the
|
|
47
|
+
* chokepoint singleton — no raw open). The clock is injectable for deterministic
|
|
48
|
+
* tests; production uses `Date.now`.
|
|
49
|
+
*
|
|
50
|
+
* @param opts - Adapter options.
|
|
51
|
+
* @param opts.cwd - Project working directory for scope resolution (defaults to `cwd`).
|
|
52
|
+
* @param opts.now - Injectable clock (defaults to {@link Date.now}).
|
|
53
|
+
* @returns A {@link DhqAdapter}.
|
|
54
|
+
*
|
|
55
|
+
* @example
|
|
56
|
+
* ```ts
|
|
57
|
+
* const adapter = createDhqAdapter({ cwd: projectRoot });
|
|
58
|
+
* await adapter.upsertOpenDhq({ dhqId: 'DHQ-001', … }); // leased UPSERT
|
|
59
|
+
* ```
|
|
60
|
+
*/
|
|
61
|
+
export function createDhqAdapter(opts = {}) {
|
|
62
|
+
const cwd = opts.cwd;
|
|
63
|
+
const now = opts.now ?? (() => Date.now());
|
|
64
|
+
return {
|
|
65
|
+
async readOpen(questionHash) {
|
|
66
|
+
const native = await getSelfimproveDhqNativeDb(cwd);
|
|
67
|
+
return readOpenSelfimproveDhq(native, questionHash);
|
|
68
|
+
},
|
|
69
|
+
async upsertOpenDhq(input) {
|
|
70
|
+
// EVERY write is leased — never raw / unleased. The lease serializes against
|
|
71
|
+
// other writers on (project, bulk); the table-confinement is the accessor's.
|
|
72
|
+
await withWriterLease('project', 'bulk', async () => {
|
|
73
|
+
const native = await getSelfimproveDhqNativeDb(cwd);
|
|
74
|
+
const row = {
|
|
75
|
+
dhqId: input.dhqId,
|
|
76
|
+
scenario: input.scenario,
|
|
77
|
+
questionHash: input.questionHash,
|
|
78
|
+
title: input.title,
|
|
79
|
+
regressionJson: input.regressionJson,
|
|
80
|
+
severity: input.severity,
|
|
81
|
+
runId: input.runId,
|
|
82
|
+
now: now(),
|
|
83
|
+
};
|
|
84
|
+
upsertOpenSelfimproveDhq(native, row);
|
|
85
|
+
});
|
|
86
|
+
},
|
|
87
|
+
async recordPrUrl(questionHash, prUrl) {
|
|
88
|
+
return withWriterLease('project', 'bulk', async () => {
|
|
89
|
+
const native = await getSelfimproveDhqNativeDb(cwd);
|
|
90
|
+
return setSelfimproveDhqPrUrl(native, questionHash, prUrl, now());
|
|
91
|
+
});
|
|
92
|
+
},
|
|
93
|
+
};
|
|
94
|
+
}
|
|
95
|
+
//# sourceMappingURL=dhq-adapter.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"dhq-adapter.js","sourceRoot":"","sources":["../../src/selfimprove/dhq-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAEH,OAAO,EACL,yBAAyB,EACzB,sBAAsB,EAGtB,sBAAsB,EACtB,wBAAwB,GACzB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AA6C3D;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAA6C,EAAE;IAC9E,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC;IACrB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;IAE3C,OAAO;QACL,KAAK,CAAC,QAAQ,CAAC,YAAoB;YACjC,MAAM,MAAM,GAAG,MAAM,yBAAyB,CAAC,GAAG,CAAC,CAAC;YACpD,OAAO,sBAAsB,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;QACtD,CAAC;QAED,KAAK,CAAC,aAAa,CAAC,KAAqB;YACvC,6EAA6E;YAC7E,6EAA6E;YAC7E,MAAM,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,IAAI,EAAE;gBAClD,MAAM,MAAM,GAAG,MAAM,yBAAyB,CAAC,GAAG,CAAC,CAAC;gBACpD,MAAM,GAAG,GAAyB;oBAChC,KAAK,EAAE,KAAK,CAAC,KAAK;oBAClB,QAAQ,EAAE,KAAK,CAAC,QAAQ;oBACxB,YAAY,EAAE,KAAK,CAAC,YAAY;oBAChC,KAAK,EAAE,KAAK,CAAC,KAAK;oBAClB,cAAc,EAAE,KAAK,CAAC,cAAc;oBACpC,QAAQ,EAAE,KAAK,CAAC,QAAQ;oBACxB,KAAK,EAAE,KAAK,CAAC,KAAK;oBAClB,GAAG,EAAE,GAAG,EAAE;iBACX,CAAC;gBACF,wBAAwB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;YACxC,CAAC,CAAC,CAAC;QACL,CAAC;QAED,KAAK,CAAC,WAAW,CAAC,YAAoB,EAAE,KAAa;YACnD,OAAO,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,IAAI,EAAE;gBACnD,MAAM,MAAM,GAAG,MAAM,yBAAyB,CAAC,GAAG,CAAC,CAAC;gBACpD,OAAO,sBAAsB,CAAC,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;YACpE,CAAC,CAAC,CAAC;QACL,CAAC;KACF,CAAC;AACJ,CAAC"}
|