clinkx 1.2.0 → 1.4.0
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/CHANGELOG.md +60 -0
- package/README.md +17 -8
- package/clinkx-workflows/dist/architecture-arena/admission.d.ts +16 -0
- package/clinkx-workflows/dist/architecture-arena/admission.js +107 -0
- package/clinkx-workflows/dist/architecture-arena/admission.js.map +1 -0
- package/clinkx-workflows/dist/architecture-arena/contract.d.ts +1368 -0
- package/clinkx-workflows/dist/architecture-arena/contract.js +254 -0
- package/clinkx-workflows/dist/architecture-arena/contract.js.map +1 -0
- package/clinkx-workflows/dist/architecture-arena/runtime.d.ts +53 -0
- package/clinkx-workflows/dist/architecture-arena/runtime.js +511 -0
- package/clinkx-workflows/dist/architecture-arena/runtime.js.map +1 -0
- package/clinkx-workflows/dist/architecture-comparison/admission.d.ts +17 -1
- package/clinkx-workflows/dist/architecture-comparison/admission.js +27 -4
- package/clinkx-workflows/dist/architecture-comparison/admission.js.map +1 -1
- package/clinkx-workflows/dist/architecture-comparison/contract.d.ts +59 -62
- package/clinkx-workflows/dist/architecture-comparison/contract.js +4 -21
- package/clinkx-workflows/dist/architecture-comparison/contract.js.map +1 -1
- package/clinkx-workflows/dist/architecture-comparison/runtime.d.ts +4 -3
- package/clinkx-workflows/dist/architecture-comparison/runtime.js +22 -67
- package/clinkx-workflows/dist/architecture-comparison/runtime.js.map +1 -1
- package/clinkx-workflows/dist/artifacts.d.ts +19 -4
- package/clinkx-workflows/dist/artifacts.js +16 -7
- package/clinkx-workflows/dist/artifacts.js.map +1 -1
- package/clinkx-workflows/dist/backend.d.ts +30 -0
- package/clinkx-workflows/dist/child-env.d.ts +3 -0
- package/clinkx-workflows/dist/child-env.js +11 -0
- package/clinkx-workflows/dist/child-env.js.map +1 -1
- package/clinkx-workflows/dist/clink-client.d.ts +8 -2
- package/clinkx-workflows/dist/clink-client.js +4 -2
- package/clinkx-workflows/dist/clink-client.js.map +1 -1
- package/clinkx-workflows/dist/context-preflight.d.ts +6 -0
- package/clinkx-workflows/dist/context-preflight.js.map +1 -1
- package/clinkx-workflows/dist/council-execution-policy.d.ts +3 -1
- package/clinkx-workflows/dist/council-execution-policy.js +4 -0
- package/clinkx-workflows/dist/council-execution-policy.js.map +1 -1
- package/clinkx-workflows/dist/dashboard/api-routes.d.ts +21 -0
- package/clinkx-workflows/dist/dashboard/api-routes.js +27 -0
- package/clinkx-workflows/dist/dashboard/api-routes.js.map +1 -1
- package/clinkx-workflows/dist/dashboard/auth/challenge-store.d.ts +13 -0
- package/clinkx-workflows/dist/dashboard/auth/challenge-store.js.map +1 -1
- package/clinkx-workflows/dist/dashboard/auth/controller.d.ts +27 -0
- package/clinkx-workflows/dist/dashboard/auth/controller.js +262 -23
- package/clinkx-workflows/dist/dashboard/auth/controller.js.map +1 -1
- package/clinkx-workflows/dist/dashboard/auth/settings-step-up.d.ts +62 -0
- package/clinkx-workflows/dist/dashboard/auth/settings-step-up.js +70 -0
- package/clinkx-workflows/dist/dashboard/auth/settings-step-up.js.map +1 -0
- package/clinkx-workflows/dist/dashboard/contracts.d.ts +586 -586
- package/clinkx-workflows/dist/dashboard/progress-report-contract.d.ts +28 -28
- package/clinkx-workflows/dist/dashboard/request-admission.d.ts +6 -0
- package/clinkx-workflows/dist/dashboard/request-admission.js +9 -0
- package/clinkx-workflows/dist/dashboard/request-admission.js.map +1 -1
- package/clinkx-workflows/dist/dashboard/server-factory.js +15 -1
- package/clinkx-workflows/dist/dashboard/server-factory.js.map +1 -1
- package/clinkx-workflows/dist/dashboard/session-log-contract.d.ts +32 -32
- package/clinkx-workflows/dist/dashboard/settings-contract.d.ts +1806 -0
- package/clinkx-workflows/dist/dashboard/settings-contract.js +630 -0
- package/clinkx-workflows/dist/dashboard/settings-contract.js.map +1 -0
- package/clinkx-workflows/dist/dashboard/settings-process-reader.d.ts +48 -0
- package/clinkx-workflows/dist/dashboard/settings-process-reader.js +195 -0
- package/clinkx-workflows/dist/dashboard/settings-process-reader.js.map +1 -0
- package/clinkx-workflows/dist/dashboard/settings-routes.d.ts +87 -0
- package/clinkx-workflows/dist/dashboard/settings-routes.js +690 -0
- package/clinkx-workflows/dist/dashboard/settings-routes.js.map +1 -0
- package/clinkx-workflows/dist/dashboard-ui/assets/index-DSOtuS0p.js +122 -0
- package/clinkx-workflows/dist/dashboard-ui/assets/style-C5guUjwN.css +1 -0
- package/clinkx-workflows/dist/dashboard-ui/index.html +2 -2
- package/clinkx-workflows/dist/delegate-signature.d.ts +4 -3
- package/clinkx-workflows/dist/delegate-signature.js +4 -3
- package/clinkx-workflows/dist/delegate-signature.js.map +1 -1
- package/clinkx-workflows/dist/durable-file-core.d.ts +76 -0
- package/clinkx-workflows/dist/durable-file-core.js +146 -0
- package/clinkx-workflows/dist/durable-file-core.js.map +1 -0
- package/clinkx-workflows/dist/durable-file.d.ts +13 -0
- package/clinkx-workflows/dist/durable-file.js +22 -0
- package/clinkx-workflows/dist/durable-file.js.map +1 -0
- package/clinkx-workflows/dist/engine.d.ts +42 -7
- package/clinkx-workflows/dist/engine.js +196 -24
- package/clinkx-workflows/dist/engine.js.map +1 -1
- package/clinkx-workflows/dist/index.js +68 -2
- package/clinkx-workflows/dist/index.js.map +1 -1
- package/clinkx-workflows/dist/ping-pong/admission.d.ts +127 -0
- package/clinkx-workflows/dist/ping-pong/admission.js +522 -0
- package/clinkx-workflows/dist/ping-pong/admission.js.map +1 -0
- package/clinkx-workflows/dist/ping-pong/contract.d.ts +2539 -0
- package/clinkx-workflows/dist/ping-pong/contract.js +819 -0
- package/clinkx-workflows/dist/ping-pong/contract.js.map +1 -0
- package/clinkx-workflows/dist/ping-pong/control.d.ts +67 -0
- package/clinkx-workflows/dist/ping-pong/control.js +12 -0
- package/clinkx-workflows/dist/ping-pong/control.js.map +1 -0
- package/clinkx-workflows/dist/ping-pong/runtime-handle.d.ts +24 -0
- package/clinkx-workflows/dist/ping-pong/runtime-handle.js +55 -0
- package/clinkx-workflows/dist/ping-pong/runtime-handle.js.map +1 -0
- package/clinkx-workflows/dist/ping-pong/runtime.d.ts +235 -0
- package/clinkx-workflows/dist/ping-pong/runtime.js +1183 -0
- package/clinkx-workflows/dist/ping-pong/runtime.js.map +1 -0
- package/clinkx-workflows/dist/ping-pong/settle.d.ts +57 -0
- package/clinkx-workflows/dist/ping-pong/settle.js +58 -0
- package/clinkx-workflows/dist/ping-pong/settle.js.map +1 -0
- package/clinkx-workflows/dist/ping-pong/sidecar.d.ts +65 -0
- package/clinkx-workflows/dist/ping-pong/sidecar.js +138 -0
- package/clinkx-workflows/dist/ping-pong/sidecar.js.map +1 -0
- package/clinkx-workflows/dist/plan-review/publication.d.ts +2 -1
- package/clinkx-workflows/dist/plan-review/publication.js +5 -6
- package/clinkx-workflows/dist/plan-review/publication.js.map +1 -1
- package/clinkx-workflows/dist/plan-review/snapshot.d.ts +3 -2
- package/clinkx-workflows/dist/plan-review/snapshot.js +8 -8
- package/clinkx-workflows/dist/plan-review/snapshot.js.map +1 -1
- package/clinkx-workflows/dist/recipe-host.d.ts +315 -0
- package/clinkx-workflows/dist/recipe-host.js +183 -0
- package/clinkx-workflows/dist/recipe-host.js.map +1 -0
- package/clinkx-workflows/dist/recipe-seats.d.ts +96 -0
- package/clinkx-workflows/dist/recipe-seats.js +163 -0
- package/clinkx-workflows/dist/recipe-seats.js.map +1 -0
- package/clinkx-workflows/dist/recipe-shared/evidence.d.ts +67 -0
- package/clinkx-workflows/dist/recipe-shared/evidence.js +111 -0
- package/clinkx-workflows/dist/recipe-shared/evidence.js.map +1 -0
- package/clinkx-workflows/dist/reducers/index.d.ts +9 -1
- package/clinkx-workflows/dist/reducers/index.js +30 -0
- package/clinkx-workflows/dist/reducers/index.js.map +1 -1
- package/clinkx-workflows/dist/run-lock-reclaim.d.ts +44 -0
- package/clinkx-workflows/dist/run-lock-reclaim.js +86 -0
- package/clinkx-workflows/dist/run-lock-reclaim.js.map +1 -0
- package/clinkx-workflows/dist/settings/audit.d.ts +101 -0
- package/clinkx-workflows/dist/settings/audit.js +318 -0
- package/clinkx-workflows/dist/settings/audit.js.map +1 -0
- package/clinkx-workflows/dist/settings/bootstrap.d.ts +35 -0
- package/clinkx-workflows/dist/settings/bootstrap.js +52 -0
- package/clinkx-workflows/dist/settings/bootstrap.js.map +1 -0
- package/clinkx-workflows/dist/settings/codec.d.ts +51 -0
- package/clinkx-workflows/dist/settings/codec.js +410 -0
- package/clinkx-workflows/dist/settings/codec.js.map +1 -0
- package/clinkx-workflows/dist/settings/durable-write.d.ts +48 -0
- package/clinkx-workflows/dist/settings/durable-write.js +31 -0
- package/clinkx-workflows/dist/settings/durable-write.js.map +1 -0
- package/clinkx-workflows/dist/settings/index.d.ts +20 -0
- package/clinkx-workflows/dist/settings/index.js +23 -0
- package/clinkx-workflows/dist/settings/index.js.map +1 -0
- package/clinkx-workflows/dist/settings/loader.d.ts +80 -0
- package/clinkx-workflows/dist/settings/loader.js +577 -0
- package/clinkx-workflows/dist/settings/loader.js.map +1 -0
- package/clinkx-workflows/dist/settings/lock.d.ts +108 -0
- package/clinkx-workflows/dist/settings/lock.js +344 -0
- package/clinkx-workflows/dist/settings/lock.js.map +1 -0
- package/clinkx-workflows/dist/settings/paths.d.ts +65 -0
- package/clinkx-workflows/dist/settings/paths.js +173 -0
- package/clinkx-workflows/dist/settings/paths.js.map +1 -0
- package/clinkx-workflows/dist/settings/process-heartbeat.d.ts +47 -0
- package/clinkx-workflows/dist/settings/process-heartbeat.js +305 -0
- package/clinkx-workflows/dist/settings/process-heartbeat.js.map +1 -0
- package/clinkx-workflows/dist/settings/registry.d.ts +178 -0
- package/clinkx-workflows/dist/settings/registry.js +1285 -0
- package/clinkx-workflows/dist/settings/registry.js.map +1 -0
- package/clinkx-workflows/dist/settings/schema.d.ts +404 -0
- package/clinkx-workflows/dist/settings/schema.js +415 -0
- package/clinkx-workflows/dist/settings/schema.js.map +1 -0
- package/clinkx-workflows/dist/settings/store.d.ts +157 -0
- package/clinkx-workflows/dist/settings/store.js +842 -0
- package/clinkx-workflows/dist/settings/store.js.map +1 -0
- package/clinkx-workflows/dist/state-schema.d.ts +11 -0
- package/clinkx-workflows/dist/state-schema.js +4 -1
- package/clinkx-workflows/dist/state-schema.js.map +1 -1
- package/clinkx-workflows/dist/state.d.ts +178 -3
- package/clinkx-workflows/dist/state.js +618 -83
- package/clinkx-workflows/dist/state.js.map +1 -1
- package/clinkx-workflows/dist/stdio-entry.d.ts +2 -0
- package/clinkx-workflows/dist/stdio-entry.js +52 -0
- package/clinkx-workflows/dist/stdio-entry.js.map +1 -0
- package/clinkx-workflows/dist/transport.d.ts +2 -1
- package/clinkx-workflows/dist/transport.js +5 -0
- package/clinkx-workflows/dist/transport.js.map +1 -1
- package/clinkx-workflows/dist/validators/architecture-arena.d.ts +6 -0
- package/clinkx-workflows/dist/validators/architecture-arena.js +16 -0
- package/clinkx-workflows/dist/validators/architecture-arena.js.map +1 -0
- package/clinkx-workflows/dist/validators/index.js +4 -0
- package/clinkx-workflows/dist/validators/index.js.map +1 -1
- package/clinkx-workflows/dist/validators/ping-pong.d.ts +6 -0
- package/clinkx-workflows/dist/validators/ping-pong.js +10 -0
- package/clinkx-workflows/dist/validators/ping-pong.js.map +1 -0
- package/clinkx-workflows/dist/workflow-tools.d.ts +51 -5
- package/clinkx-workflows/dist/workflow-tools.js +785 -34
- package/clinkx-workflows/dist/workflow-tools.js.map +1 -1
- package/clinkx-workflows/dist/workflow-verification-contract.d.ts +4 -4
- package/clinkx-workflows/templates/architecture-arena/candidate.txt +39 -0
- package/clinkx-workflows/templates/architecture-arena/judge.txt +34 -0
- package/clinkx-workflows/templates/ping-pong/implement.txt +14 -0
- package/clinkx-workflows/templates/ping-pong/remediate.txt +14 -0
- package/clinkx-workflows/templates/ping-pong/review.txt +27 -0
- package/clinkx-workflows/workflows/architecture-arena.yaml +127 -0
- package/clinkx-workflows/workflows/ping-pong.yaml +158 -0
- package/dist/context-builder/bundle.js +4 -3
- package/dist/context-builder/bundle.js.map +1 -1
- package/dist/context-builder/delegate-packet.d.ts +1 -0
- package/dist/context-builder/delegate-packet.js +66 -7
- package/dist/context-builder/delegate-packet.js.map +1 -1
- package/dist/context-builder/delegate-validation.d.ts +12 -3
- package/dist/context-builder/delegate-validation.js +23 -13
- package/dist/context-builder/delegate-validation.js.map +1 -1
- package/dist/context-builder/external-gaps.d.ts +14 -3
- package/dist/context-builder/external-gaps.js +124 -18
- package/dist/context-builder/external-gaps.js.map +1 -1
- package/dist/context-builder/handler.js +108 -191
- package/dist/context-builder/handler.js.map +1 -1
- package/dist/context-builder/review-coverage.js +27 -1
- package/dist/context-builder/review-coverage.js.map +1 -1
- package/dist/context-builder/secrets.js +1 -1
- package/dist/context-builder/secrets.js.map +1 -1
- package/dist/context-builder/versions.d.ts +10 -4
- package/dist/context-builder/versions.js +10 -4
- package/dist/context-builder/versions.js.map +1 -1
- package/dist/context-builder/workflow-runner.js +33 -24
- package/dist/context-builder/workflow-runner.js.map +1 -1
- package/dist/dashboard-cli.d.ts +2 -0
- package/dist/dashboard-cli.js +197 -58
- package/dist/dashboard-cli.js.map +1 -1
- package/dist/dashboard-companion/client.d.ts +10 -0
- package/dist/dashboard-companion/client.js +43 -1
- package/dist/dashboard-companion/client.js.map +1 -1
- package/dist/dashboard-companion/config.d.ts +19 -1
- package/dist/dashboard-companion/config.js +104 -3
- package/dist/dashboard-companion/config.js.map +1 -1
- package/dist/dashboard-companion/protocol.d.ts +16 -0
- package/dist/dashboard-companion/protocol.js +55 -1
- package/dist/dashboard-companion/protocol.js.map +1 -1
- package/dist/dashboard-companion/workstation-binding.d.ts +69 -0
- package/dist/dashboard-companion/workstation-binding.js +192 -0
- package/dist/dashboard-companion/workstation-binding.js.map +1 -0
- package/dist/dashboard-gateway/admin-cli.d.ts +10 -0
- package/dist/dashboard-gateway/admin-cli.js +266 -0
- package/dist/dashboard-gateway/admin-cli.js.map +1 -0
- package/dist/dashboard-gateway/config.d.ts +50 -0
- package/dist/dashboard-gateway/config.js +235 -1
- package/dist/dashboard-gateway/config.js.map +1 -1
- package/dist/dashboard-gateway/connection-registry.d.ts +100 -0
- package/dist/dashboard-gateway/connection-registry.js +228 -0
- package/dist/dashboard-gateway/connection-registry.js.map +1 -0
- package/dist/dashboard-gateway/control-plane/account-auth.d.ts +78 -0
- package/dist/dashboard-gateway/control-plane/account-auth.js +198 -0
- package/dist/dashboard-gateway/control-plane/account-auth.js.map +1 -0
- package/dist/dashboard-gateway/control-plane/billing.d.ts +264 -0
- package/dist/dashboard-gateway/control-plane/billing.js +787 -0
- package/dist/dashboard-gateway/control-plane/billing.js.map +1 -0
- package/dist/dashboard-gateway/control-plane/contracts.d.ts +1293 -0
- package/dist/dashboard-gateway/control-plane/contracts.js +280 -0
- package/dist/dashboard-gateway/control-plane/contracts.js.map +1 -0
- package/dist/dashboard-gateway/control-plane/cookies.d.ts +13 -0
- package/dist/dashboard-gateway/control-plane/cookies.js +46 -0
- package/dist/dashboard-gateway/control-plane/cookies.js.map +1 -0
- package/dist/dashboard-gateway/control-plane/credentials.d.ts +63 -0
- package/dist/dashboard-gateway/control-plane/credentials.js +66 -0
- package/dist/dashboard-gateway/control-plane/credentials.js.map +1 -0
- package/dist/dashboard-gateway/control-plane/entitlements.d.ts +118 -0
- package/dist/dashboard-gateway/control-plane/entitlements.js +329 -0
- package/dist/dashboard-gateway/control-plane/entitlements.js.map +1 -0
- package/dist/dashboard-gateway/control-plane/errors.d.ts +17 -0
- package/dist/dashboard-gateway/control-plane/errors.js +23 -0
- package/dist/dashboard-gateway/control-plane/errors.js.map +1 -0
- package/dist/dashboard-gateway/control-plane/hosts.d.ts +6 -0
- package/dist/dashboard-gateway/control-plane/hosts.js +16 -0
- package/dist/dashboard-gateway/control-plane/hosts.js.map +1 -0
- package/dist/dashboard-gateway/control-plane/http.d.ts +34 -0
- package/dist/dashboard-gateway/control-plane/http.js +331 -0
- package/dist/dashboard-gateway/control-plane/http.js.map +1 -0
- package/dist/dashboard-gateway/control-plane/schema.d.ts +9 -0
- package/dist/dashboard-gateway/control-plane/schema.js +247 -0
- package/dist/dashboard-gateway/control-plane/schema.js.map +1 -0
- package/dist/dashboard-gateway/control-plane/secrets.d.ts +20 -0
- package/dist/dashboard-gateway/control-plane/secrets.js +39 -0
- package/dist/dashboard-gateway/control-plane/secrets.js.map +1 -0
- package/dist/dashboard-gateway/control-plane/store.d.ts +579 -0
- package/dist/dashboard-gateway/control-plane/store.js +1115 -0
- package/dist/dashboard-gateway/control-plane/store.js.map +1 -0
- package/dist/dashboard-gateway/cookie-boundary.d.ts +60 -0
- package/dist/dashboard-gateway/cookie-boundary.js +205 -0
- package/dist/dashboard-gateway/cookie-boundary.js.map +1 -0
- package/dist/dashboard-gateway/index.js +271 -494
- package/dist/dashboard-gateway/index.js.map +1 -1
- package/dist/dashboard-gateway/main.js +7 -2
- package/dist/dashboard-gateway/main.js.map +1 -1
- package/dist/dashboard-gateway/routing.d.ts +43 -0
- package/dist/dashboard-gateway/routing.js +65 -0
- package/dist/dashboard-gateway/routing.js.map +1 -0
- package/dist/dashboard-gateway/tenant-gateway.d.ts +56 -0
- package/dist/dashboard-gateway/tenant-gateway.js +989 -0
- package/dist/dashboard-gateway/tenant-gateway.js.map +1 -0
- package/dist/dashboard-gateway/tenant-main.d.ts +41 -0
- package/dist/dashboard-gateway/tenant-main.js +303 -0
- package/dist/dashboard-gateway/tenant-main.js.map +1 -0
- package/dist/dashboard-gateway/tunnel-errors.d.ts +16 -0
- package/dist/dashboard-gateway/tunnel-errors.js +22 -0
- package/dist/dashboard-gateway/tunnel-errors.js.map +1 -0
- package/dist/dashboard-gateway/tunnel-http.d.ts +21 -0
- package/dist/dashboard-gateway/tunnel-http.js +195 -0
- package/dist/dashboard-gateway/tunnel-http.js.map +1 -0
- package/dist/elaris/config.d.ts +10 -0
- package/dist/elaris/config.js +27 -1
- package/dist/elaris/config.js.map +1 -1
- package/dist/elaris/tools.js +4 -1
- package/dist/elaris/tools.js.map +1 -1
- package/dist/handler.d.ts +6 -0
- package/dist/handler.js +17 -1
- package/dist/handler.js.map +1 -1
- package/dist/index.d.ts +0 -31
- package/dist/index.js +41 -404
- package/dist/index.js.map +1 -1
- package/dist/lib.d.ts +17 -0
- package/dist/lib.js +17 -0
- package/dist/lib.js.map +1 -0
- package/dist/local-clink-backend.d.ts +2 -1
- package/dist/local-clink-backend.js +28 -4
- package/dist/local-clink-backend.js.map +1 -1
- package/dist/parsers/extract.d.ts +19 -1
- package/dist/parsers/extract.js +68 -3
- package/dist/parsers/extract.js.map +1 -1
- package/dist/pipeline.d.ts +17 -1
- package/dist/pipeline.js +34 -6
- package/dist/pipeline.js.map +1 -1
- package/dist/process-group.d.ts +65 -0
- package/dist/process-group.js +153 -0
- package/dist/process-group.js.map +1 -0
- package/dist/progress-report/lock.d.ts +17 -59
- package/dist/progress-report/lock.js +25 -329
- package/dist/progress-report/lock.js.map +1 -1
- package/dist/progress-report/schema.d.ts +23 -23
- package/dist/project-verification/files.js +1 -1
- package/dist/project-verification/files.js.map +1 -1
- package/dist/project-verification/process.js +23 -44
- package/dist/project-verification/process.js.map +1 -1
- package/dist/project-verification/service.js +9 -1
- package/dist/project-verification/service.js.map +1 -1
- package/dist/prompt.d.ts +7 -0
- package/dist/prompt.js +18 -1
- package/dist/prompt.js.map +1 -1
- package/dist/recipe-host/git-trust.d.ts +43 -0
- package/dist/recipe-host/git-trust.js +360 -0
- package/dist/recipe-host/git-trust.js.map +1 -0
- package/dist/recipe-host/git.d.ts +42 -0
- package/dist/recipe-host/git.js +207 -0
- package/dist/recipe-host/git.js.map +1 -0
- package/dist/recipe-host/native-recipe-host.d.ts +127 -0
- package/dist/recipe-host/native-recipe-host.js +880 -0
- package/dist/recipe-host/native-recipe-host.js.map +1 -0
- package/dist/recipe-host/seat-cwd.d.ts +16 -0
- package/dist/recipe-host/seat-cwd.js +170 -0
- package/dist/recipe-host/seat-cwd.js.map +1 -0
- package/dist/runner.d.ts +43 -1
- package/dist/runner.js +234 -35
- package/dist/runner.js.map +1 -1
- package/dist/server.js +84 -5
- package/dist/server.js.map +1 -1
- package/dist/settings-cli/clients.d.ts +137 -0
- package/dist/settings-cli/clients.js +1124 -0
- package/dist/settings-cli/clients.js.map +1 -0
- package/dist/settings-cli/commands.d.ts +67 -0
- package/dist/settings-cli/commands.js +726 -0
- package/dist/settings-cli/commands.js.map +1 -0
- package/dist/settings-cli/format.d.ts +34 -0
- package/dist/settings-cli/format.js +40 -0
- package/dist/settings-cli/format.js.map +1 -0
- package/dist/settings-cli/main.d.ts +18 -0
- package/dist/settings-cli/main.js +256 -0
- package/dist/settings-cli/main.js.map +1 -0
- package/dist/stdio-main.d.ts +73 -0
- package/dist/stdio-main.js +455 -0
- package/dist/stdio-main.js.map +1 -0
- package/docs/configuration.md +362 -40
- package/docs/engineering-recipes.md +291 -0
- package/docs/security.md +234 -6
- package/docs/verification/project-checks.md +24 -2
- package/package.json +6 -2
- package/clinkx-workflows/dist/dashboard-ui/assets/index-BdpmbPps.js +0 -115
- package/clinkx-workflows/dist/dashboard-ui/assets/style-Im5i1iAs.css +0 -1
|
@@ -0,0 +1,1285 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Settings registry — the S0-1 freeze point for dashboard-managed ClinkX
|
|
3
|
+
* environment keys.
|
|
4
|
+
*
|
|
5
|
+
* Single source of truth for every key the dashboard Settings feature may
|
|
6
|
+
* write: canonical env name, type, bounds, class, consumers, read timing,
|
|
7
|
+
* invalid-value policy, cross-key requirements, legacy aliases, docs and the
|
|
8
|
+
* encode() function that renders a file value in the consumer's exact legacy
|
|
9
|
+
* env grammar.
|
|
10
|
+
*
|
|
11
|
+
* Constraints (DECISIONS.md 2026-11-03 + TASKS.md amendments):
|
|
12
|
+
* - Precedence per key: explicit env > settings file > built-in default
|
|
13
|
+
* (OQ-3: an env var present with an empty value, and legacy aliases, count
|
|
14
|
+
* as env-present). The loader is A1-1; this registry only describes keys.
|
|
15
|
+
* - Apply model is restart-only (coordinator decision 8): every key is
|
|
16
|
+
* restartRequired.
|
|
17
|
+
* - Keys whose values feed the workflow resume fingerprint
|
|
18
|
+
* (buildChildConfigFingerprint, clinkx-workflows/src/state.ts) are flagged
|
|
19
|
+
* affectsResumeFingerprint; editing them can strand unfinished resumable
|
|
20
|
+
* runs.
|
|
21
|
+
* - Policy keys declare onInvalid {restrictive} (owner decision 7); the one
|
|
22
|
+
* exception is CLINKX_ALLOWED_ROOTS (OQ-8: invalid file value is NOT filled,
|
|
23
|
+
* the consumer no-config default — cwd() — applies, with a loud warning).
|
|
24
|
+
* - Reader-first persistence flags encode exactly "true"/"false" so a filled
|
|
25
|
+
* value can never widen into another grammar.
|
|
26
|
+
*
|
|
27
|
+
* This module must stay dependency-free (no zod, no logger, no config): the
|
|
28
|
+
* startup bootstrap (A1-1) loads it before any module import that could pull
|
|
29
|
+
* pino or clinkx-workflows/src/config.js, and tests walk its import closure.
|
|
30
|
+
*/
|
|
31
|
+
// ---------------------------------------------------------------------------
|
|
32
|
+
// Public constants
|
|
33
|
+
// ---------------------------------------------------------------------------
|
|
34
|
+
/** Env override that disables settings loading entirely (value `off`). */
|
|
35
|
+
export const SETTINGS_OFF_ENV = "CLINKX_SETTINGS";
|
|
36
|
+
/** Env override for the settings directory (absolute; validated by A1-1). */
|
|
37
|
+
export const SETTINGS_DIR_ENV = "CLINKX_SETTINGS_DIR";
|
|
38
|
+
/**
|
|
39
|
+
* Every boolean grammar in the tree accepts exactly "true"/"false"
|
|
40
|
+
* (exact_true, env_bool, not_false, truthy_set and the allow-secrets token
|
|
41
|
+
* set all contain both spellings), so bool values always encode exactly
|
|
42
|
+
* "true"/"false" — the reader-first requirement — and stay legible to every
|
|
43
|
+
* consumer.
|
|
44
|
+
*/
|
|
45
|
+
function boolDescriptor(input) {
|
|
46
|
+
return {
|
|
47
|
+
...input,
|
|
48
|
+
restartRequired: true,
|
|
49
|
+
encode: (value) => (value === true ? "true" : "false"),
|
|
50
|
+
};
|
|
51
|
+
}
|
|
52
|
+
function intDescriptor(input) {
|
|
53
|
+
return {
|
|
54
|
+
...input,
|
|
55
|
+
restartRequired: true,
|
|
56
|
+
encode: (value) => String(value),
|
|
57
|
+
};
|
|
58
|
+
}
|
|
59
|
+
function enumDescriptor(input) {
|
|
60
|
+
return {
|
|
61
|
+
...input,
|
|
62
|
+
restartRequired: true,
|
|
63
|
+
encode: (value) => String(value),
|
|
64
|
+
};
|
|
65
|
+
}
|
|
66
|
+
function stringDescriptor(input) {
|
|
67
|
+
return {
|
|
68
|
+
...input,
|
|
69
|
+
restartRequired: true,
|
|
70
|
+
encode: (value) => String(value),
|
|
71
|
+
};
|
|
72
|
+
}
|
|
73
|
+
function urlDescriptor(input) {
|
|
74
|
+
return {
|
|
75
|
+
...input,
|
|
76
|
+
restartRequired: true,
|
|
77
|
+
encode: (value) => String(value),
|
|
78
|
+
};
|
|
79
|
+
}
|
|
80
|
+
function listDescriptor(input) {
|
|
81
|
+
return {
|
|
82
|
+
...input,
|
|
83
|
+
restartRequired: true,
|
|
84
|
+
encode: (value) => (Array.isArray(value) ? value.join(",") : String(value)),
|
|
85
|
+
};
|
|
86
|
+
}
|
|
87
|
+
// ---------------------------------------------------------------------------
|
|
88
|
+
// Registry
|
|
89
|
+
// ---------------------------------------------------------------------------
|
|
90
|
+
const PINNED_APP_SERVER_PROTOCOL_VERSION = "0.140.0";
|
|
91
|
+
const REGISTRY_TABLE = [
|
|
92
|
+
// ---- Tuning: logging -----------------------------------------------------
|
|
93
|
+
enumDescriptor({
|
|
94
|
+
key: "CLINKX_LOG_LEVEL",
|
|
95
|
+
class: "tuning",
|
|
96
|
+
type: "enum",
|
|
97
|
+
unit: "",
|
|
98
|
+
choices: ["fatal", "error", "warn", "info", "debug", "trace", "silent"],
|
|
99
|
+
default: "info",
|
|
100
|
+
consumers: ["src/logger.ts:3 (module-load pino level)"],
|
|
101
|
+
readTiming: "module_load",
|
|
102
|
+
affectsResumeFingerprint: false,
|
|
103
|
+
onInvalid: "default",
|
|
104
|
+
docs: {
|
|
105
|
+
title: "Log level (root server)",
|
|
106
|
+
summary: "Pino log verbosity for the root MCP server, written to stderr.",
|
|
107
|
+
},
|
|
108
|
+
}),
|
|
109
|
+
enumDescriptor({
|
|
110
|
+
key: "CLINKX_WORKFLOWS_LOG_LEVEL",
|
|
111
|
+
class: "tuning",
|
|
112
|
+
type: "enum",
|
|
113
|
+
unit: "",
|
|
114
|
+
choices: ["fatal", "error", "warn", "info", "debug", "trace", "silent"],
|
|
115
|
+
default: "info",
|
|
116
|
+
consumers: [
|
|
117
|
+
"clinkx-workflows/src/logger.ts:4 via config.getLogLevel()",
|
|
118
|
+
"clinkx-workflows/src/state.ts buildChildConfigFingerprint (child CLINKX_LOG_LEVEL)",
|
|
119
|
+
],
|
|
120
|
+
readTiming: "module_load",
|
|
121
|
+
affectsResumeFingerprint: true,
|
|
122
|
+
onInvalid: "default",
|
|
123
|
+
docs: {
|
|
124
|
+
title: "Log level (workflows)",
|
|
125
|
+
summary: "Pino log verbosity for the workflows package (also drives the workflow child's log level).",
|
|
126
|
+
warning: "Feeds the workflow resume fingerprint: editing it can make unfinished resumable runs non-resumable.",
|
|
127
|
+
},
|
|
128
|
+
}),
|
|
129
|
+
// ---- Tuning: pipeline / capture -------------------------------------------
|
|
130
|
+
intDescriptor({
|
|
131
|
+
key: "CLINKX_MAX_CONCURRENT",
|
|
132
|
+
class: "tuning",
|
|
133
|
+
type: "int",
|
|
134
|
+
unit: "calls",
|
|
135
|
+
grammar: "safe_parse_int",
|
|
136
|
+
default: 5,
|
|
137
|
+
min: 1,
|
|
138
|
+
consumers: ["src/concurrency.ts:22 Semaphore (module-load singleton via src/pipeline.ts:228)"],
|
|
139
|
+
readTiming: "module_load",
|
|
140
|
+
affectsResumeFingerprint: false,
|
|
141
|
+
onInvalid: "default",
|
|
142
|
+
docs: {
|
|
143
|
+
title: "Max concurrent clink calls",
|
|
144
|
+
summary: "Fail-fast semaphore limit for concurrent provider subprocess calls (no queuing).",
|
|
145
|
+
},
|
|
146
|
+
}),
|
|
147
|
+
intDescriptor({
|
|
148
|
+
key: "CLINKX_MAX_RESPONSE_CHARS",
|
|
149
|
+
class: "tuning",
|
|
150
|
+
type: "int",
|
|
151
|
+
unit: "chars",
|
|
152
|
+
grammar: "safe_parse_int",
|
|
153
|
+
default: 20000,
|
|
154
|
+
min: 1,
|
|
155
|
+
consumers: [
|
|
156
|
+
"src/pipeline.ts:740 (per call)",
|
|
157
|
+
"src/codex/app-server-registry.ts:691 (registry singleton)",
|
|
158
|
+
],
|
|
159
|
+
readTiming: "per_call",
|
|
160
|
+
affectsResumeFingerprint: false,
|
|
161
|
+
onInvalid: "default",
|
|
162
|
+
docs: {
|
|
163
|
+
title: "Max response chars",
|
|
164
|
+
summary: "Output truncation ceiling for clink tool responses.",
|
|
165
|
+
},
|
|
166
|
+
}),
|
|
167
|
+
intDescriptor({
|
|
168
|
+
key: "CLINKX_MAX_PROMPT_BYTES",
|
|
169
|
+
class: "tuning",
|
|
170
|
+
type: "int",
|
|
171
|
+
unit: "bytes",
|
|
172
|
+
grammar: "safe_parse_int",
|
|
173
|
+
default: 1048576,
|
|
174
|
+
min: 1,
|
|
175
|
+
consumers: ["src/runner.ts:271 (per call)"],
|
|
176
|
+
readTiming: "per_call",
|
|
177
|
+
affectsResumeFingerprint: false,
|
|
178
|
+
onInvalid: "default",
|
|
179
|
+
docs: {
|
|
180
|
+
title: "Max prompt bytes (root)",
|
|
181
|
+
summary: "Maximum prompt size before a subprocess spawn is rejected (1 MB default).",
|
|
182
|
+
},
|
|
183
|
+
}),
|
|
184
|
+
intDescriptor({
|
|
185
|
+
key: "CLINKX_MAX_CAPTURE_BYTES",
|
|
186
|
+
class: "tuning",
|
|
187
|
+
type: "int",
|
|
188
|
+
unit: "bytes",
|
|
189
|
+
grammar: "safe_parse_int",
|
|
190
|
+
default: 2097152,
|
|
191
|
+
min: 1,
|
|
192
|
+
legacyAliases: ["CLINKX_MAX_OUTPUT_BYTES"],
|
|
193
|
+
consumers: ["src/runner.ts:274 (per call; CLINKX_MAX_OUTPUT_BYTES is the fallback spelling)"],
|
|
194
|
+
readTiming: "per_call",
|
|
195
|
+
affectsResumeFingerprint: false,
|
|
196
|
+
onInvalid: "default",
|
|
197
|
+
docs: {
|
|
198
|
+
title: "Max capture bytes",
|
|
199
|
+
summary: "Per-stream capture retention ceiling (head + tail ring buffer, 2 MB default).",
|
|
200
|
+
warning: "Legacy alias CLINKX_MAX_OUTPUT_BYTES still shadows this key from the environment.",
|
|
201
|
+
},
|
|
202
|
+
}),
|
|
203
|
+
intDescriptor({
|
|
204
|
+
key: "CLINKX_SESSION_LOG_MAX_LINE_CHARS",
|
|
205
|
+
class: "tuning",
|
|
206
|
+
type: "int",
|
|
207
|
+
unit: "chars",
|
|
208
|
+
grammar: "safe_parse_int",
|
|
209
|
+
default: 1048576,
|
|
210
|
+
min: 1,
|
|
211
|
+
consumers: ["src/runner.ts:278 (per call)"],
|
|
212
|
+
readTiming: "per_call",
|
|
213
|
+
affectsResumeFingerprint: false,
|
|
214
|
+
onInvalid: "default",
|
|
215
|
+
docs: {
|
|
216
|
+
title: "Session log max line chars",
|
|
217
|
+
summary: "Per-line cap for the provider session-log stream (1 MiB default).",
|
|
218
|
+
},
|
|
219
|
+
}),
|
|
220
|
+
// ---- Tuning: server / context builder -------------------------------------
|
|
221
|
+
intDescriptor({
|
|
222
|
+
key: "CLINKX_SERVER_IDLE_TIMEOUT_SECONDS",
|
|
223
|
+
class: "tuning",
|
|
224
|
+
type: "int",
|
|
225
|
+
unit: "seconds",
|
|
226
|
+
grammar: "idle_timeout_seconds",
|
|
227
|
+
default: 0,
|
|
228
|
+
min: 0,
|
|
229
|
+
max: 2147483,
|
|
230
|
+
consumers: ["clinkx-workflows/src/stdio-watchdog.ts:127 (throws on invalid)"],
|
|
231
|
+
readTiming: "startup",
|
|
232
|
+
affectsResumeFingerprint: false,
|
|
233
|
+
onInvalid: "default",
|
|
234
|
+
docs: {
|
|
235
|
+
title: "Server idle timeout",
|
|
236
|
+
summary: "Opt-in STDIO server idle lifetime; 0 disables. Decimal seconds are accepted by the consumer.",
|
|
237
|
+
},
|
|
238
|
+
}),
|
|
239
|
+
intDescriptor({
|
|
240
|
+
key: "CLINKX_CONTEXT_BUILDER_MAX_CONCURRENT",
|
|
241
|
+
class: "tuning",
|
|
242
|
+
type: "int",
|
|
243
|
+
unit: "runs",
|
|
244
|
+
grammar: "cb_max_concurrent",
|
|
245
|
+
default: 1,
|
|
246
|
+
min: 1,
|
|
247
|
+
max: 32,
|
|
248
|
+
consumers: [
|
|
249
|
+
"src/context-builder/config.ts:198 (throws on invalid; hard limit 32)",
|
|
250
|
+
"src/server.ts:321 async admission cap (startup)",
|
|
251
|
+
],
|
|
252
|
+
readTiming: "per_call",
|
|
253
|
+
affectsResumeFingerprint: false,
|
|
254
|
+
onInvalid: "default",
|
|
255
|
+
docs: {
|
|
256
|
+
title: "Context builder concurrency",
|
|
257
|
+
summary: "Fail-fast concurrency limit for context_builder runs (shared with refine_context_run).",
|
|
258
|
+
},
|
|
259
|
+
}),
|
|
260
|
+
intDescriptor({
|
|
261
|
+
key: "CLINKX_WORKFLOWS_CONTEXT_CACHE_MAX_ENTRIES",
|
|
262
|
+
class: "tuning",
|
|
263
|
+
type: "int",
|
|
264
|
+
unit: "entries",
|
|
265
|
+
grammar: "trimmed_non_negative_int",
|
|
266
|
+
default: 50,
|
|
267
|
+
min: 0,
|
|
268
|
+
consumers: ["src/context-builder/storage.ts:2020 (per call)"],
|
|
269
|
+
readTiming: "per_call",
|
|
270
|
+
affectsResumeFingerprint: false,
|
|
271
|
+
onInvalid: "default",
|
|
272
|
+
docs: {
|
|
273
|
+
title: "Context cache max entries",
|
|
274
|
+
summary: "LRU cap for committed workflow context cache runs (wfctx-*).",
|
|
275
|
+
},
|
|
276
|
+
}),
|
|
277
|
+
intDescriptor({
|
|
278
|
+
key: "CLINKX_WORKFLOWS_CONTEXT_CACHE_TTL_SECONDS",
|
|
279
|
+
class: "tuning",
|
|
280
|
+
type: "int",
|
|
281
|
+
unit: "seconds",
|
|
282
|
+
grammar: "trimmed_non_negative_int",
|
|
283
|
+
default: 86400,
|
|
284
|
+
min: 0,
|
|
285
|
+
consumers: ["src/context-builder/storage.ts:2027 (per call)"],
|
|
286
|
+
readTiming: "per_call",
|
|
287
|
+
affectsResumeFingerprint: false,
|
|
288
|
+
onInvalid: "default",
|
|
289
|
+
docs: {
|
|
290
|
+
title: "Context cache TTL",
|
|
291
|
+
summary: "TTL for committed workflow context cache runs; the temp/provenance TTL derives from it.",
|
|
292
|
+
},
|
|
293
|
+
}),
|
|
294
|
+
// ---- Tuning: workflow engine ----------------------------------------------
|
|
295
|
+
enumDescriptor({
|
|
296
|
+
key: "CLINKX_WORKFLOWS_CONTEXT_DEFAULT",
|
|
297
|
+
class: "tuning",
|
|
298
|
+
type: "enum",
|
|
299
|
+
unit: "",
|
|
300
|
+
choices: ["full", "deterministic", "off"],
|
|
301
|
+
default: "full",
|
|
302
|
+
consumers: [
|
|
303
|
+
"clinkx-workflows/src/config.ts:224 getWorkflowsContextDefault (throws on invalid)",
|
|
304
|
+
"src/server.ts:332 (startup), clinkx-workflows/src/workflow-tools.ts (per call)",
|
|
305
|
+
],
|
|
306
|
+
readTiming: "startup",
|
|
307
|
+
affectsResumeFingerprint: false,
|
|
308
|
+
onInvalid: "default",
|
|
309
|
+
docs: {
|
|
310
|
+
title: "Workflow context default",
|
|
311
|
+
summary: "Soft default for workflow context-builder preflight mode when cb_context_mode is omitted.",
|
|
312
|
+
},
|
|
313
|
+
}),
|
|
314
|
+
stringDescriptor({
|
|
315
|
+
key: "CLINKX_WORKFLOWS_CONTEXT_DEFAULT_CURATOR",
|
|
316
|
+
class: "tuning",
|
|
317
|
+
type: "string",
|
|
318
|
+
unit: "",
|
|
319
|
+
minLength: 1,
|
|
320
|
+
maxLength: 64,
|
|
321
|
+
pattern: /^[a-z0-9][a-z0-9_-]*$/,
|
|
322
|
+
default: "codex",
|
|
323
|
+
consumers: ["clinkx-workflows/src/config.ts:229 (throws on empty; adapter must exist at startup)"],
|
|
324
|
+
readTiming: "startup",
|
|
325
|
+
affectsResumeFingerprint: false,
|
|
326
|
+
onInvalid: "default",
|
|
327
|
+
docs: {
|
|
328
|
+
title: "Context default curator",
|
|
329
|
+
summary: "Curator adapter name for the injected default full context delegate.",
|
|
330
|
+
warning: "Startup hard-requires the adapter to resolve; an unknown name makes the server fail to start.",
|
|
331
|
+
},
|
|
332
|
+
}),
|
|
333
|
+
intDescriptor({
|
|
334
|
+
key: "CLINKX_WORKFLOWS_MAX_CONCURRENT_ASYNC",
|
|
335
|
+
class: "tuning",
|
|
336
|
+
type: "int",
|
|
337
|
+
unit: "runs",
|
|
338
|
+
grammar: "env_positive_int",
|
|
339
|
+
default: 1,
|
|
340
|
+
min: 1,
|
|
341
|
+
consumers: [
|
|
342
|
+
"clinkx-workflows/src/config.ts:249",
|
|
343
|
+
"clinkx-workflows/src/workflow-tools.ts:455 (admission)",
|
|
344
|
+
"src/server.ts:322 (injected cap)",
|
|
345
|
+
],
|
|
346
|
+
readTiming: "startup",
|
|
347
|
+
affectsResumeFingerprint: false,
|
|
348
|
+
onInvalid: "default",
|
|
349
|
+
docs: {
|
|
350
|
+
title: "Max concurrent workflow runs",
|
|
351
|
+
summary: "Process-wide cap on concurrently admitted workflow runs (blocking and async share the mutex map).",
|
|
352
|
+
},
|
|
353
|
+
}),
|
|
354
|
+
intDescriptor({
|
|
355
|
+
key: "CLINKX_WORKFLOWS_MAX_PARALLEL",
|
|
356
|
+
class: "tuning",
|
|
357
|
+
type: "int",
|
|
358
|
+
unit: "calls",
|
|
359
|
+
grammar: "env_int",
|
|
360
|
+
default: 5,
|
|
361
|
+
min: 1,
|
|
362
|
+
consumers: ["clinkx-workflows/src/config.ts:244", "clinkx-workflows/src/engine.ts:654 (per engine)"],
|
|
363
|
+
readTiming: "per_call",
|
|
364
|
+
affectsResumeFingerprint: false,
|
|
365
|
+
onInvalid: "default",
|
|
366
|
+
docs: {
|
|
367
|
+
title: "Workflow max parallel calls",
|
|
368
|
+
summary: "Per-engine parallel stage-call limit.",
|
|
369
|
+
},
|
|
370
|
+
}),
|
|
371
|
+
intDescriptor({
|
|
372
|
+
key: "CLINKX_WORKFLOWS_MAX_PROMPT_BYTES",
|
|
373
|
+
class: "tuning",
|
|
374
|
+
type: "int",
|
|
375
|
+
unit: "bytes",
|
|
376
|
+
grammar: "env_int",
|
|
377
|
+
default: 900000,
|
|
378
|
+
min: 1,
|
|
379
|
+
consumers: [
|
|
380
|
+
"clinkx-workflows/src/config.ts:668",
|
|
381
|
+
"clinkx-workflows/src/engine.ts:657, workflow-tools.ts:3205, prompt-budget.ts:78",
|
|
382
|
+
],
|
|
383
|
+
readTiming: "per_call",
|
|
384
|
+
affectsResumeFingerprint: false,
|
|
385
|
+
onInvalid: "default",
|
|
386
|
+
docs: {
|
|
387
|
+
title: "Workflow max prompt bytes",
|
|
388
|
+
summary: "Pre-dispatch UTF-8 prompt/context ceiling for workflow calls (distinct from the root CLINKX_MAX_PROMPT_BYTES).",
|
|
389
|
+
},
|
|
390
|
+
}),
|
|
391
|
+
// ---- Tuning: workflow child knobs (fingerprinted) ---------------------------
|
|
392
|
+
intDescriptor({
|
|
393
|
+
key: "CLINKX_WORKFLOWS_CHILD_MAX_CONCURRENT",
|
|
394
|
+
class: "tuning",
|
|
395
|
+
type: "int",
|
|
396
|
+
unit: "calls",
|
|
397
|
+
grammar: "env_int",
|
|
398
|
+
default: 5,
|
|
399
|
+
min: 1,
|
|
400
|
+
consumers: [
|
|
401
|
+
"clinkx-workflows/src/config.ts:259",
|
|
402
|
+
"clinkx-workflows/src/state.ts buildChildConfigFingerprint",
|
|
403
|
+
],
|
|
404
|
+
readTiming: "per_call",
|
|
405
|
+
affectsResumeFingerprint: true,
|
|
406
|
+
onInvalid: "default",
|
|
407
|
+
docs: {
|
|
408
|
+
title: "Child max concurrent",
|
|
409
|
+
summary: "CLINKX_MAX_CONCURRENT handed to the workflow-owned child server.",
|
|
410
|
+
warning: "Feeds the workflow resume fingerprint: editing it can strand unfinished resumable runs.",
|
|
411
|
+
},
|
|
412
|
+
}),
|
|
413
|
+
intDescriptor({
|
|
414
|
+
key: "CLINKX_WORKFLOWS_CHILD_MAX_RESPONSE_CHARS",
|
|
415
|
+
class: "tuning",
|
|
416
|
+
type: "int",
|
|
417
|
+
unit: "chars",
|
|
418
|
+
grammar: "env_int",
|
|
419
|
+
default: 200000,
|
|
420
|
+
min: 1,
|
|
421
|
+
consumers: [
|
|
422
|
+
"clinkx-workflows/src/config.ts:264",
|
|
423
|
+
"clinkx-workflows/src/state.ts buildChildConfigFingerprint",
|
|
424
|
+
],
|
|
425
|
+
readTiming: "per_call",
|
|
426
|
+
affectsResumeFingerprint: true,
|
|
427
|
+
onInvalid: "default",
|
|
428
|
+
docs: {
|
|
429
|
+
title: "Child max response chars",
|
|
430
|
+
summary: "CLINKX_MAX_RESPONSE_CHARS handed to the workflow-owned child server.",
|
|
431
|
+
warning: "Feeds the workflow resume fingerprint: editing it can strand unfinished resumable runs.",
|
|
432
|
+
},
|
|
433
|
+
}),
|
|
434
|
+
intDescriptor({
|
|
435
|
+
key: "CLINKX_WORKFLOWS_CHILD_MAX_OUTPUT_BYTES",
|
|
436
|
+
class: "tuning",
|
|
437
|
+
type: "int",
|
|
438
|
+
unit: "bytes",
|
|
439
|
+
grammar: "env_int",
|
|
440
|
+
default: 10485760,
|
|
441
|
+
min: 1,
|
|
442
|
+
consumers: [
|
|
443
|
+
"clinkx-workflows/src/config.ts:269",
|
|
444
|
+
"clinkx-workflows/src/state.ts buildChildConfigFingerprint",
|
|
445
|
+
],
|
|
446
|
+
readTiming: "per_call",
|
|
447
|
+
affectsResumeFingerprint: true,
|
|
448
|
+
onInvalid: "default",
|
|
449
|
+
docs: {
|
|
450
|
+
title: "Child max output bytes",
|
|
451
|
+
summary: "CLINKX_MAX_OUTPUT_BYTES handed to the workflow-owned child server (10 MiB default).",
|
|
452
|
+
warning: "Feeds the workflow resume fingerprint: editing it can strand unfinished resumable runs.",
|
|
453
|
+
},
|
|
454
|
+
}),
|
|
455
|
+
intDescriptor({
|
|
456
|
+
key: "CLINKX_WORKFLOWS_CHILD_MAX_PROMPT_BYTES",
|
|
457
|
+
class: "tuning",
|
|
458
|
+
type: "int",
|
|
459
|
+
unit: "bytes",
|
|
460
|
+
grammar: "env_int",
|
|
461
|
+
default: 1048576,
|
|
462
|
+
min: 1,
|
|
463
|
+
consumers: [
|
|
464
|
+
"clinkx-workflows/src/config.ts:274",
|
|
465
|
+
"clinkx-workflows/src/state.ts buildChildConfigFingerprint",
|
|
466
|
+
],
|
|
467
|
+
readTiming: "per_call",
|
|
468
|
+
affectsResumeFingerprint: true,
|
|
469
|
+
onInvalid: "default",
|
|
470
|
+
docs: {
|
|
471
|
+
title: "Child max prompt bytes",
|
|
472
|
+
summary: "CLINKX_MAX_PROMPT_BYTES handed to the workflow-owned child server.",
|
|
473
|
+
warning: "Feeds the workflow resume fingerprint: editing it can strand unfinished resumable runs.",
|
|
474
|
+
},
|
|
475
|
+
}),
|
|
476
|
+
// ---- Tuning: Elaris ---------------------------------------------------------
|
|
477
|
+
stringDescriptor({
|
|
478
|
+
key: "CLINKX_ELARIS_DEFAULT_MODEL_ID",
|
|
479
|
+
class: "tuning",
|
|
480
|
+
type: "string",
|
|
481
|
+
unit: "",
|
|
482
|
+
minLength: 0,
|
|
483
|
+
maxLength: 128,
|
|
484
|
+
default: "",
|
|
485
|
+
blankIsUnset: true,
|
|
486
|
+
consumers: ["src/elaris/config.ts:26 (per call; trimmed, empty = unset)"],
|
|
487
|
+
readTiming: "per_call",
|
|
488
|
+
affectsResumeFingerprint: false,
|
|
489
|
+
onInvalid: "default",
|
|
490
|
+
docs: {
|
|
491
|
+
title: "Elaris default model id",
|
|
492
|
+
summary: "Fallback model_id for clink_elaris_run when the caller omits it. Empty means unset (callers must pass model_id).",
|
|
493
|
+
},
|
|
494
|
+
}),
|
|
495
|
+
intDescriptor({
|
|
496
|
+
key: "CLINKX_ELARIS_REQUEST_TIMEOUT_SECONDS",
|
|
497
|
+
class: "tuning",
|
|
498
|
+
type: "int",
|
|
499
|
+
unit: "seconds",
|
|
500
|
+
grammar: "positive_seconds_strict",
|
|
501
|
+
default: 30,
|
|
502
|
+
min: 1,
|
|
503
|
+
consumers: ["src/elaris/config.ts:79 readPositiveSeconds (throws on invalid)"],
|
|
504
|
+
readTiming: "per_call",
|
|
505
|
+
affectsResumeFingerprint: false,
|
|
506
|
+
onInvalid: "default",
|
|
507
|
+
docs: {
|
|
508
|
+
title: "Elaris request timeout",
|
|
509
|
+
summary: "Per-HTTP-request timeout for Elaris client calls.",
|
|
510
|
+
},
|
|
511
|
+
}),
|
|
512
|
+
intDescriptor({
|
|
513
|
+
key: "CLINKX_ELARIS_WAIT_TIMEOUT_SECONDS",
|
|
514
|
+
class: "tuning",
|
|
515
|
+
type: "int",
|
|
516
|
+
unit: "seconds",
|
|
517
|
+
grammar: "positive_seconds_strict",
|
|
518
|
+
default: 300,
|
|
519
|
+
min: 1,
|
|
520
|
+
consumers: ["src/elaris/config.ts:80 readPositiveSeconds (throws on invalid)"],
|
|
521
|
+
readTiming: "per_call",
|
|
522
|
+
affectsResumeFingerprint: false,
|
|
523
|
+
onInvalid: "default",
|
|
524
|
+
docs: {
|
|
525
|
+
title: "Elaris wait timeout",
|
|
526
|
+
summary: "Default bounded wait-loop timeout for Elaris wait:true / op:wait.",
|
|
527
|
+
},
|
|
528
|
+
}),
|
|
529
|
+
// ---- Tuning: app-server registry knobs (S* singleton per process) -----------
|
|
530
|
+
intDescriptor({
|
|
531
|
+
key: "CLINKX_MAX_ACTIVE_TURNS",
|
|
532
|
+
class: "tuning",
|
|
533
|
+
type: "int",
|
|
534
|
+
unit: "turns",
|
|
535
|
+
grammar: "safe_parse_int",
|
|
536
|
+
default: 5,
|
|
537
|
+
min: 1,
|
|
538
|
+
consumers: ["src/codex/app-server-registry.ts:657 resolveRegistryConfig"],
|
|
539
|
+
readTiming: "startup_singleton",
|
|
540
|
+
affectsResumeFingerprint: false,
|
|
541
|
+
onInvalid: "default",
|
|
542
|
+
docs: {
|
|
543
|
+
title: "App-server active turn cap",
|
|
544
|
+
summary: "Codex app-server active-turn lease cap (sole concurrency gate for sessions).",
|
|
545
|
+
},
|
|
546
|
+
}),
|
|
547
|
+
intDescriptor({
|
|
548
|
+
key: "CLINKX_MAX_RETAINED_SESSIONS",
|
|
549
|
+
class: "tuning",
|
|
550
|
+
type: "int",
|
|
551
|
+
unit: "sessions",
|
|
552
|
+
grammar: "safe_parse_int",
|
|
553
|
+
default: 20,
|
|
554
|
+
min: 1,
|
|
555
|
+
consumers: ["src/codex/app-server-registry.ts:661 resolveRegistryConfig"],
|
|
556
|
+
readTiming: "startup_singleton",
|
|
557
|
+
affectsResumeFingerprint: false,
|
|
558
|
+
onInvalid: "default",
|
|
559
|
+
docs: {
|
|
560
|
+
title: "App-server retained sessions",
|
|
561
|
+
summary: "Max retained idle app-server sessions before oldest-first eviction.",
|
|
562
|
+
},
|
|
563
|
+
}),
|
|
564
|
+
intDescriptor({
|
|
565
|
+
key: "CLINKX_SESSION_TTL_SECONDS",
|
|
566
|
+
class: "tuning",
|
|
567
|
+
type: "int",
|
|
568
|
+
unit: "seconds",
|
|
569
|
+
grammar: "safe_parse_non_neg_int",
|
|
570
|
+
default: 1800,
|
|
571
|
+
min: 0,
|
|
572
|
+
consumers: ["src/codex/app-server-registry.ts:665 resolveRegistryConfig"],
|
|
573
|
+
readTiming: "startup_singleton",
|
|
574
|
+
affectsResumeFingerprint: false,
|
|
575
|
+
onInvalid: "default",
|
|
576
|
+
docs: {
|
|
577
|
+
title: "App-server session TTL",
|
|
578
|
+
summary: "Idle app-server session TTL before reaping; 0 disables.",
|
|
579
|
+
},
|
|
580
|
+
}),
|
|
581
|
+
intDescriptor({
|
|
582
|
+
key: "CLINKX_SESSION_EVENT_BUFFER",
|
|
583
|
+
class: "tuning",
|
|
584
|
+
type: "int",
|
|
585
|
+
unit: "events",
|
|
586
|
+
grammar: "safe_parse_int",
|
|
587
|
+
default: 500,
|
|
588
|
+
min: 1,
|
|
589
|
+
consumers: ["src/codex/app-server-registry.ts:670 resolveRegistryConfig"],
|
|
590
|
+
readTiming: "startup_singleton",
|
|
591
|
+
affectsResumeFingerprint: false,
|
|
592
|
+
onInvalid: "default",
|
|
593
|
+
docs: {
|
|
594
|
+
title: "App-server event buffer",
|
|
595
|
+
summary: "Per-session bounded event-ring capacity for get_log.",
|
|
596
|
+
},
|
|
597
|
+
}),
|
|
598
|
+
intDescriptor({
|
|
599
|
+
key: "CLINKX_TURN_TIMEOUT_SECONDS",
|
|
600
|
+
class: "tuning",
|
|
601
|
+
type: "int",
|
|
602
|
+
unit: "seconds",
|
|
603
|
+
grammar: "safe_parse_non_neg_int",
|
|
604
|
+
default: 600,
|
|
605
|
+
min: 0,
|
|
606
|
+
consumers: ["src/codex/app-server-registry.ts:674 resolveRegistryConfig"],
|
|
607
|
+
readTiming: "startup_singleton",
|
|
608
|
+
affectsResumeFingerprint: false,
|
|
609
|
+
onInvalid: "default",
|
|
610
|
+
docs: {
|
|
611
|
+
title: "App-server turn timeout",
|
|
612
|
+
summary: "Wall-clock turn timeout before interrupt/escalation; 0 disables.",
|
|
613
|
+
},
|
|
614
|
+
}),
|
|
615
|
+
intDescriptor({
|
|
616
|
+
key: "CLINKX_APPROVAL_TIMEOUT_SECONDS",
|
|
617
|
+
class: "tuning",
|
|
618
|
+
type: "int",
|
|
619
|
+
unit: "seconds",
|
|
620
|
+
grammar: "safe_parse_non_neg_int",
|
|
621
|
+
default: 120,
|
|
622
|
+
min: 0,
|
|
623
|
+
consumers: ["src/codex/app-server-registry.ts:678 resolveRegistryConfig"],
|
|
624
|
+
readTiming: "startup_singleton",
|
|
625
|
+
affectsResumeFingerprint: false,
|
|
626
|
+
onInvalid: "default",
|
|
627
|
+
docs: {
|
|
628
|
+
title: "App-server approval timeout",
|
|
629
|
+
summary: "Pending-approval timeout before auto-decline/escalation; 0 disables.",
|
|
630
|
+
},
|
|
631
|
+
}),
|
|
632
|
+
intDescriptor({
|
|
633
|
+
key: "CLINKX_SESSION_EVENT_TEXT_MAX",
|
|
634
|
+
class: "tuning",
|
|
635
|
+
type: "int",
|
|
636
|
+
unit: "chars",
|
|
637
|
+
grammar: "safe_parse_int",
|
|
638
|
+
default: 2000,
|
|
639
|
+
min: 1,
|
|
640
|
+
consumers: ["src/codex/app-server-registry.ts:697 resolveRegistryConfig"],
|
|
641
|
+
readTiming: "startup_singleton",
|
|
642
|
+
affectsResumeFingerprint: false,
|
|
643
|
+
onInvalid: "default",
|
|
644
|
+
docs: {
|
|
645
|
+
title: "App-server event text max",
|
|
646
|
+
summary: "Max chars retained for high-volume event text fields (delta/item.text).",
|
|
647
|
+
},
|
|
648
|
+
}),
|
|
649
|
+
intDescriptor({
|
|
650
|
+
key: "CLINKX_TURN_INTERRUPT_BUDGET_SECONDS",
|
|
651
|
+
class: "tuning",
|
|
652
|
+
type: "int",
|
|
653
|
+
unit: "seconds",
|
|
654
|
+
grammar: "safe_parse_int",
|
|
655
|
+
default: 10,
|
|
656
|
+
min: 1,
|
|
657
|
+
consumers: ["src/codex/app-server-registry.ts:701 resolveRegistryConfig"],
|
|
658
|
+
readTiming: "startup_singleton",
|
|
659
|
+
affectsResumeFingerprint: false,
|
|
660
|
+
onInvalid: "default",
|
|
661
|
+
docs: {
|
|
662
|
+
title: "App-server interrupt budget",
|
|
663
|
+
summary: "Bounded budget for the interrupt/decline RPC round-trip before escalation.",
|
|
664
|
+
},
|
|
665
|
+
}),
|
|
666
|
+
intDescriptor({
|
|
667
|
+
key: "CLINKX_TERMINAL_WAIT_BUDGET_SECONDS",
|
|
668
|
+
class: "tuning",
|
|
669
|
+
type: "int",
|
|
670
|
+
unit: "seconds",
|
|
671
|
+
grammar: "safe_parse_int",
|
|
672
|
+
default: 10,
|
|
673
|
+
min: 1,
|
|
674
|
+
consumers: ["src/codex/app-server-registry.ts:706 resolveRegistryConfig"],
|
|
675
|
+
readTiming: "startup_singleton",
|
|
676
|
+
affectsResumeFingerprint: false,
|
|
677
|
+
onInvalid: "default",
|
|
678
|
+
docs: {
|
|
679
|
+
title: "App-server terminal wait budget",
|
|
680
|
+
summary: "Bounded budget to await a terminal turn/completed before escalation.",
|
|
681
|
+
},
|
|
682
|
+
}),
|
|
683
|
+
intDescriptor({
|
|
684
|
+
key: "CLINKX_APP_SERVER_START_BUDGET_SECONDS",
|
|
685
|
+
class: "tuning",
|
|
686
|
+
type: "int",
|
|
687
|
+
unit: "seconds",
|
|
688
|
+
grammar: "safe_parse_int",
|
|
689
|
+
default: 60,
|
|
690
|
+
min: 1,
|
|
691
|
+
consumers: ["src/codex/app-server-registry.ts:711 resolveRegistryConfig"],
|
|
692
|
+
readTiming: "startup_singleton",
|
|
693
|
+
affectsResumeFingerprint: false,
|
|
694
|
+
onInvalid: "default",
|
|
695
|
+
docs: {
|
|
696
|
+
title: "App-server start budget",
|
|
697
|
+
summary: "Bounded budget for the pre-turn startup RPC sequence in startSession.",
|
|
698
|
+
},
|
|
699
|
+
}),
|
|
700
|
+
// ---- Retention --------------------------------------------------------------
|
|
701
|
+
intDescriptor({
|
|
702
|
+
key: "CLINKX_WORKFLOWS_RETAIN_SUCCEEDED_DAYS",
|
|
703
|
+
class: "retention",
|
|
704
|
+
type: "int",
|
|
705
|
+
unit: "days",
|
|
706
|
+
grammar: "env_non_negative_int",
|
|
707
|
+
default: 1,
|
|
708
|
+
min: 0,
|
|
709
|
+
consumers: ["clinkx-workflows/src/config.ts:683 (DEFAULT_RETAIN_SUCCEEDED_DAYS)", "clinkx-workflows/src/state.ts prune"],
|
|
710
|
+
readTiming: "per_call",
|
|
711
|
+
affectsResumeFingerprint: false,
|
|
712
|
+
onInvalid: "default",
|
|
713
|
+
docs: {
|
|
714
|
+
title: "Retain succeeded runs (days)",
|
|
715
|
+
summary: "Retention TTL for succeeded_sync workflow run dirs; 0 keeps them indefinitely.",
|
|
716
|
+
},
|
|
717
|
+
}),
|
|
718
|
+
intDescriptor({
|
|
719
|
+
key: "CLINKX_WORKFLOWS_RETAIN_ASYNC_DAYS",
|
|
720
|
+
class: "retention",
|
|
721
|
+
type: "int",
|
|
722
|
+
unit: "days",
|
|
723
|
+
grammar: "env_non_negative_int",
|
|
724
|
+
default: 1,
|
|
725
|
+
min: 0,
|
|
726
|
+
consumers: ["clinkx-workflows/src/config.ts:682 (DEFAULT_RETAIN_ASYNC_DAYS)", "clinkx-workflows/src/state.ts prune"],
|
|
727
|
+
readTiming: "per_call",
|
|
728
|
+
affectsResumeFingerprint: false,
|
|
729
|
+
onInvalid: "default",
|
|
730
|
+
docs: {
|
|
731
|
+
title: "Retain async runs (days)",
|
|
732
|
+
summary: "Retention TTL for succeeded_async run dirs kept for workflow_run_status polling; 0 keeps them indefinitely.",
|
|
733
|
+
},
|
|
734
|
+
}),
|
|
735
|
+
intDescriptor({
|
|
736
|
+
key: "CLINKX_WORKFLOWS_RETAIN_FAILED_DAYS",
|
|
737
|
+
class: "retention",
|
|
738
|
+
type: "int",
|
|
739
|
+
unit: "days",
|
|
740
|
+
grammar: "env_non_negative_int",
|
|
741
|
+
default: 30,
|
|
742
|
+
min: 0,
|
|
743
|
+
consumers: ["clinkx-workflows/src/config.ts:679 (DEFAULT_RETAIN_FAILED_DAYS)", "clinkx-workflows/src/state.ts prune"],
|
|
744
|
+
readTiming: "per_call",
|
|
745
|
+
affectsResumeFingerprint: false,
|
|
746
|
+
onInvalid: "default",
|
|
747
|
+
docs: {
|
|
748
|
+
title: "Retain failed runs (days)",
|
|
749
|
+
summary: "Retention TTL for failed run dirs; also the effective decision TTL for recipe runs.",
|
|
750
|
+
},
|
|
751
|
+
}),
|
|
752
|
+
intDescriptor({
|
|
753
|
+
key: "CLINKX_WORKFLOWS_RETAIN_CANCELLED_DAYS",
|
|
754
|
+
class: "retention",
|
|
755
|
+
type: "int",
|
|
756
|
+
unit: "days",
|
|
757
|
+
grammar: "env_non_negative_int",
|
|
758
|
+
default: 30,
|
|
759
|
+
min: 0,
|
|
760
|
+
consumers: ["clinkx-workflows/src/config.ts:680 (DEFAULT_RETAIN_CANCELLED_DAYS)", "clinkx-workflows/src/state.ts prune"],
|
|
761
|
+
readTiming: "per_call",
|
|
762
|
+
affectsResumeFingerprint: false,
|
|
763
|
+
onInvalid: "default",
|
|
764
|
+
docs: {
|
|
765
|
+
title: "Retain cancelled runs (days)",
|
|
766
|
+
summary: "Retention TTL for cancelled workflow run dirs.",
|
|
767
|
+
},
|
|
768
|
+
}),
|
|
769
|
+
intDescriptor({
|
|
770
|
+
key: "CLINKX_WORKFLOWS_RETAIN_DEBUG_DAYS",
|
|
771
|
+
class: "retention",
|
|
772
|
+
type: "int",
|
|
773
|
+
unit: "days",
|
|
774
|
+
grammar: "env_non_negative_int",
|
|
775
|
+
default: 7,
|
|
776
|
+
min: 0,
|
|
777
|
+
consumers: ["clinkx-workflows/src/config.ts:681 (DEFAULT_RETAIN_DEBUG_DAYS)", "clinkx-workflows/src/state.ts prune"],
|
|
778
|
+
readTiming: "per_call",
|
|
779
|
+
affectsResumeFingerprint: false,
|
|
780
|
+
onInvalid: "default",
|
|
781
|
+
docs: {
|
|
782
|
+
title: "Retain debug artifacts (days)",
|
|
783
|
+
summary: "Retention TTL for debug-class workflow artifacts.",
|
|
784
|
+
},
|
|
785
|
+
}),
|
|
786
|
+
// ---- Feature gates ------------------------------------------------------------
|
|
787
|
+
boolDescriptor({
|
|
788
|
+
key: "CLINKX_DIRECT_SESSION_LOGS_ENABLED",
|
|
789
|
+
class: "feature",
|
|
790
|
+
type: "bool",
|
|
791
|
+
unit: "",
|
|
792
|
+
grammar: "not_false",
|
|
793
|
+
default: true,
|
|
794
|
+
consumers: ["src/config.ts:276 directSessionLogsEnabled (per call via src/pipeline.ts:608)"],
|
|
795
|
+
readTiming: "per_call",
|
|
796
|
+
affectsResumeFingerprint: false,
|
|
797
|
+
onInvalid: "default",
|
|
798
|
+
docs: {
|
|
799
|
+
title: "Direct session logs",
|
|
800
|
+
summary: "Master opt-OUT for synthesizing a session log on direct clink calls. Default on; \"false\" opts out.",
|
|
801
|
+
},
|
|
802
|
+
}),
|
|
803
|
+
boolDescriptor({
|
|
804
|
+
key: "CLINKX_DASHBOARD_ACTIVITY_RETAIN_RESULT",
|
|
805
|
+
class: "feature",
|
|
806
|
+
type: "bool",
|
|
807
|
+
unit: "",
|
|
808
|
+
grammar: "exact_true",
|
|
809
|
+
default: false,
|
|
810
|
+
consumers: ["src/server.ts:190 (startup capture)", "src/activity-journal.ts ACTIVITY_RETAIN_RESULT_ENV"],
|
|
811
|
+
readTiming: "startup",
|
|
812
|
+
affectsResumeFingerprint: false,
|
|
813
|
+
onInvalid: "default",
|
|
814
|
+
docs: {
|
|
815
|
+
title: "Retain activity results",
|
|
816
|
+
summary: "Opt in to retaining the bounded final text of direct clink calls in the dashboard activity journal (privacy toggle).",
|
|
817
|
+
warning: "Retention is recorded per activity; enabling persists provider output text on disk.",
|
|
818
|
+
},
|
|
819
|
+
}),
|
|
820
|
+
boolDescriptor({
|
|
821
|
+
key: "CLINKX_WORKFLOWS_CONTEXT_PREFLIGHT_ENABLED",
|
|
822
|
+
class: "feature",
|
|
823
|
+
type: "bool",
|
|
824
|
+
unit: "",
|
|
825
|
+
grammar: "not_false",
|
|
826
|
+
default: true,
|
|
827
|
+
consumers: ["src/server.ts:762 workflowsContextPreflightEnabledFromEnv (startup)"],
|
|
828
|
+
readTiming: "startup",
|
|
829
|
+
affectsResumeFingerprint: false,
|
|
830
|
+
onInvalid: "default",
|
|
831
|
+
docs: {
|
|
832
|
+
title: "Workflow context preflight",
|
|
833
|
+
summary: "Root-server master switch for workflow context-builder preflight. Default on; \"false\" bypasses the runner entirely.",
|
|
834
|
+
warning: "Disabling also skips default-delegate adapter validation and changes workflow context behavior globally.",
|
|
835
|
+
},
|
|
836
|
+
}),
|
|
837
|
+
boolDescriptor({
|
|
838
|
+
key: "CLINKX_STRICT_FIDELITY",
|
|
839
|
+
class: "feature",
|
|
840
|
+
type: "bool",
|
|
841
|
+
unit: "",
|
|
842
|
+
grammar: "exact_true",
|
|
843
|
+
default: false,
|
|
844
|
+
consumers: ["src/pipeline.ts:391 (per call)"],
|
|
845
|
+
readTiming: "per_call",
|
|
846
|
+
affectsResumeFingerprint: false,
|
|
847
|
+
onInvalid: "default",
|
|
848
|
+
docs: {
|
|
849
|
+
title: "Strict fidelity",
|
|
850
|
+
summary: "Return isError on capture-layer truncation for stdout-extracted clink calls.",
|
|
851
|
+
},
|
|
852
|
+
}),
|
|
853
|
+
// ---- Reader-first rollout flags -------------------------------------------------
|
|
854
|
+
boolDescriptor({
|
|
855
|
+
key: "CLINKX_INVOCATION_AUDIT_V2_PERSISTENCE_ENABLED",
|
|
856
|
+
class: "reader_first",
|
|
857
|
+
type: "bool",
|
|
858
|
+
unit: "",
|
|
859
|
+
grammar: "exact_true",
|
|
860
|
+
default: false,
|
|
861
|
+
consumers: [
|
|
862
|
+
"clinkx-workflows/src/config.ts:151 invocationAuditV2PersistenceEnabled",
|
|
863
|
+
"src/server.ts:400, src/activity-journal.ts:845, clinkx-workflows/src/state.ts:962, src/context-builder/handler.ts:1229",
|
|
864
|
+
],
|
|
865
|
+
readTiming: "startup",
|
|
866
|
+
affectsResumeFingerprint: false,
|
|
867
|
+
onInvalid: "default",
|
|
868
|
+
docs: {
|
|
869
|
+
title: "Invocation audit V2 persistence",
|
|
870
|
+
summary: "Reader-first activation for invocation-audit V2 persistence surfaces (workflow calls, Activity V2, context sidecars).",
|
|
871
|
+
warning: "Reader-first rollout: deploy V2-capable readers before enabling; disable producers first on rollback.",
|
|
872
|
+
},
|
|
873
|
+
}),
|
|
874
|
+
boolDescriptor({
|
|
875
|
+
key: "CLINKX_OBSERVED_INVOCATION_PERSISTENCE_ENABLED",
|
|
876
|
+
class: "reader_first",
|
|
877
|
+
type: "bool",
|
|
878
|
+
unit: "",
|
|
879
|
+
grammar: "exact_true",
|
|
880
|
+
default: false,
|
|
881
|
+
consumers: [
|
|
882
|
+
"clinkx-workflows/src/config.ts:162 observedInvocationPersistenceEnabled",
|
|
883
|
+
"src/activity-journal.ts:699,749, clinkx-workflows/src/state.ts:963",
|
|
884
|
+
],
|
|
885
|
+
readTiming: "per_call",
|
|
886
|
+
affectsResumeFingerprint: false,
|
|
887
|
+
onInvalid: "default",
|
|
888
|
+
docs: {
|
|
889
|
+
title: "Observed invocation persistence",
|
|
890
|
+
summary: "Writer activation for observed-invocation persistence (what a provider actually reported).",
|
|
891
|
+
warning: "Reader-first rollout: readers always accept V1; disabling never scrubs existing bytes.",
|
|
892
|
+
},
|
|
893
|
+
}),
|
|
894
|
+
boolDescriptor({
|
|
895
|
+
key: "CLINKX_SESSION_LOG_TOOL_ARGUMENTS_PERSISTENCE_ENABLED",
|
|
896
|
+
class: "reader_first",
|
|
897
|
+
type: "bool",
|
|
898
|
+
unit: "",
|
|
899
|
+
grammar: "exact_true",
|
|
900
|
+
default: false,
|
|
901
|
+
consumers: ["src/session-log-stream.ts:136 (read once per producer)"],
|
|
902
|
+
readTiming: "per_call",
|
|
903
|
+
affectsResumeFingerprint: false,
|
|
904
|
+
onInvalid: "default",
|
|
905
|
+
docs: {
|
|
906
|
+
title: "Session-log tool arguments",
|
|
907
|
+
summary: "Persist live tool arguments, derived summaries and best-effort coverage metadata in session logs.",
|
|
908
|
+
warning: "Persists prompts/tool arguments to disk despite pattern redaction; readers accept extended events regardless.",
|
|
909
|
+
},
|
|
910
|
+
}),
|
|
911
|
+
// ---- Policy (each save requires a fresh passkey step-up + audit entry) -----------
|
|
912
|
+
listDescriptor({
|
|
913
|
+
key: "CLINKX_ALLOWED_ROOTS",
|
|
914
|
+
class: "policy",
|
|
915
|
+
type: "list",
|
|
916
|
+
unit: "paths",
|
|
917
|
+
separator: ",",
|
|
918
|
+
default: [],
|
|
919
|
+
consumers: [
|
|
920
|
+
"src/allowed-roots.ts:22-30,82,193-221 (host-side path admission; runtime-mutated)",
|
|
921
|
+
"src/server.ts:239-242 (startup append), src/context-builder/handler.ts:309 (per-run append)",
|
|
922
|
+
],
|
|
923
|
+
readTiming: "per_call",
|
|
924
|
+
affectsResumeFingerprint: false,
|
|
925
|
+
// OQ-8: invalid file value is NOT filled; the no-config default (cwd) applies, loudly.
|
|
926
|
+
onInvalid: "default",
|
|
927
|
+
docs: {
|
|
928
|
+
title: "Allowed roots",
|
|
929
|
+
summary: "Comma-separated host-side path validation roots (files, context anchors, app-server cwd). Not the Codex child sandbox.",
|
|
930
|
+
warning: "Security boundary. Invalid file value is not filled (cwd default applies) and warns. Runtime appends state/artifact roots to the live env copy.",
|
|
931
|
+
},
|
|
932
|
+
}),
|
|
933
|
+
boolDescriptor({
|
|
934
|
+
key: "CLINKX_APP_SERVER_ENABLED",
|
|
935
|
+
class: "policy",
|
|
936
|
+
type: "bool",
|
|
937
|
+
unit: "",
|
|
938
|
+
grammar: "exact_true",
|
|
939
|
+
default: false,
|
|
940
|
+
onInvalid: { restrictive: false },
|
|
941
|
+
consumers: ["src/config.ts:251 appServerEnabled (per tools/list and call)"],
|
|
942
|
+
readTiming: "per_call",
|
|
943
|
+
affectsResumeFingerprint: false,
|
|
944
|
+
docs: {
|
|
945
|
+
title: "App-server tools",
|
|
946
|
+
summary: "Master opt-in for the async clink_agent_run / clink_agent_manage tools (Codex app-server backend).",
|
|
947
|
+
warning: "Security boundary: enables a stateful, approval-capable backend.",
|
|
948
|
+
},
|
|
949
|
+
}),
|
|
950
|
+
boolDescriptor({
|
|
951
|
+
key: "CLINKX_ELARIS_ENABLED",
|
|
952
|
+
class: "policy",
|
|
953
|
+
type: "bool",
|
|
954
|
+
unit: "",
|
|
955
|
+
grammar: "exact_true",
|
|
956
|
+
default: false,
|
|
957
|
+
onInvalid: { restrictive: false },
|
|
958
|
+
requires: ["CLINKX_ELARIS_BASE_URL"],
|
|
959
|
+
consumers: ["src/config.ts:260 elarisEnabled (per tools/list and call)"],
|
|
960
|
+
readTiming: "per_call",
|
|
961
|
+
affectsResumeFingerprint: false,
|
|
962
|
+
docs: {
|
|
963
|
+
title: "Elaris tools",
|
|
964
|
+
summary: "Master opt-in for clink_elaris_run / clink_elaris_manage remote agent sessions.",
|
|
965
|
+
warning: "Requires CLINKX_ELARIS_BASE_URL: if the base URL is neither in env nor valid in the file, the loader forces this key false.",
|
|
966
|
+
},
|
|
967
|
+
}),
|
|
968
|
+
urlDescriptor({
|
|
969
|
+
key: "CLINKX_ELARIS_BASE_URL",
|
|
970
|
+
class: "policy",
|
|
971
|
+
type: "url",
|
|
972
|
+
unit: "",
|
|
973
|
+
default: "",
|
|
974
|
+
onInvalid: { restrictive: "" },
|
|
975
|
+
consumers: ["src/elaris/config.ts:21-23,44-66 validateElarisBaseUrl (per call)"],
|
|
976
|
+
readTiming: "per_call",
|
|
977
|
+
affectsResumeFingerprint: false,
|
|
978
|
+
docs: {
|
|
979
|
+
title: "Elaris base URL",
|
|
980
|
+
summary: "Remote Elaris origin: absolute HTTPS (loopback HTTP allowed); no credentials, query, fragment or path.",
|
|
981
|
+
warning: "Invalid value means unset; with Elaris enabled from the file, the loader then forces CLINKX_ELARIS_ENABLED=false.",
|
|
982
|
+
},
|
|
983
|
+
}),
|
|
984
|
+
boolDescriptor({
|
|
985
|
+
key: "CLINKX_CONTEXT_ALLOW_SECRETS",
|
|
986
|
+
class: "policy",
|
|
987
|
+
type: "bool",
|
|
988
|
+
unit: "",
|
|
989
|
+
grammar: "allow_secrets_tokens",
|
|
990
|
+
default: true,
|
|
991
|
+
onInvalid: { restrictive: false },
|
|
992
|
+
consumers: ["src/context-builder/secrets.ts:1211 (per call; invalid token throws -32602)"],
|
|
993
|
+
readTiming: "per_call",
|
|
994
|
+
affectsResumeFingerprint: false,
|
|
995
|
+
docs: {
|
|
996
|
+
title: "Allow secrets in context bundles",
|
|
997
|
+
summary: "Default-on inclusion of secret material in curated bundles and delegate packets; false enables the fail-closed hygiene filter.",
|
|
998
|
+
warning: "Security boundary; invalid file values fall back to false (filter on).",
|
|
999
|
+
},
|
|
1000
|
+
}),
|
|
1001
|
+
boolDescriptor({
|
|
1002
|
+
key: "CLINKX_WORKFLOWS_ALLOW_UNSAFE_ASYNC_CAP",
|
|
1003
|
+
class: "policy",
|
|
1004
|
+
type: "bool",
|
|
1005
|
+
unit: "",
|
|
1006
|
+
grammar: "env_bool",
|
|
1007
|
+
default: false,
|
|
1008
|
+
onInvalid: { restrictive: false },
|
|
1009
|
+
consumers: ["clinkx-workflows/src/config.ts:254", "src/server.ts:323 (startup)"],
|
|
1010
|
+
readTiming: "startup",
|
|
1011
|
+
affectsResumeFingerprint: false,
|
|
1012
|
+
docs: {
|
|
1013
|
+
title: "Allow unsafe async cap",
|
|
1014
|
+
summary: "When false, an async_cap above the context-builder pool auto-caps admission to the pool maximum.",
|
|
1015
|
+
warning: "Security boundary: true admits the raw async cap beyond the context-builder pool.",
|
|
1016
|
+
},
|
|
1017
|
+
}),
|
|
1018
|
+
intDescriptor({
|
|
1019
|
+
key: "CLINKX_MAX_AGENT_DEPTH",
|
|
1020
|
+
class: "policy",
|
|
1021
|
+
type: "int",
|
|
1022
|
+
unit: "levels",
|
|
1023
|
+
grammar: "safe_parse_int",
|
|
1024
|
+
default: 2,
|
|
1025
|
+
min: 1,
|
|
1026
|
+
onInvalid: { restrictive: 1 },
|
|
1027
|
+
consumers: ["src/codex/app-server-registry.ts:686 (registry singleton)"],
|
|
1028
|
+
readTiming: "startup_singleton",
|
|
1029
|
+
affectsResumeFingerprint: false,
|
|
1030
|
+
docs: {
|
|
1031
|
+
title: "Max agent depth",
|
|
1032
|
+
summary: "Recursion depth ceiling for nested app-server sessions.",
|
|
1033
|
+
warning: "Security boundary; invalid file values fall back to the most restrictive working depth (1).",
|
|
1034
|
+
},
|
|
1035
|
+
}),
|
|
1036
|
+
boolDescriptor({
|
|
1037
|
+
key: "CLINKX_ELARIS_REDACT_AGGRESSIVE",
|
|
1038
|
+
class: "policy",
|
|
1039
|
+
type: "bool",
|
|
1040
|
+
unit: "",
|
|
1041
|
+
grammar: "exact_true",
|
|
1042
|
+
default: false,
|
|
1043
|
+
onInvalid: { restrictive: true },
|
|
1044
|
+
consumers: ["src/elaris/redact.ts:240 isAggressiveRedaction (per redaction)"],
|
|
1045
|
+
readTiming: "per_call",
|
|
1046
|
+
affectsResumeFingerprint: false,
|
|
1047
|
+
docs: {
|
|
1048
|
+
title: "Elaris aggressive redaction",
|
|
1049
|
+
summary: "Opt-in bare-entropy fallback that also clobbers SHAs, JWTs, base64 blobs and UUIDs.",
|
|
1050
|
+
warning: "Invalid file values fall back to true (redact more); true destroys legitimate content.",
|
|
1051
|
+
},
|
|
1052
|
+
}),
|
|
1053
|
+
stringDescriptor({
|
|
1054
|
+
key: "CLINKX_APP_SERVER_MIN_VERSION",
|
|
1055
|
+
class: "policy",
|
|
1056
|
+
type: "string",
|
|
1057
|
+
unit: "",
|
|
1058
|
+
minLength: 5,
|
|
1059
|
+
maxLength: 32,
|
|
1060
|
+
pattern: /^\d+\.\d+\.\d+$/,
|
|
1061
|
+
default: PINNED_APP_SERVER_PROTOCOL_VERSION,
|
|
1062
|
+
blankIsVerbatim: true,
|
|
1063
|
+
onInvalid: { restrictive: PINNED_APP_SERVER_PROTOCOL_VERSION },
|
|
1064
|
+
consumers: ["src/codex/app-server-client.ts:803 acceptedMinVersion (handshake)"],
|
|
1065
|
+
readTiming: "per_call",
|
|
1066
|
+
affectsResumeFingerprint: false,
|
|
1067
|
+
docs: {
|
|
1068
|
+
title: "App-server min version",
|
|
1069
|
+
summary: "Minimum accepted Codex app-server version (parsed from userAgent).",
|
|
1070
|
+
warning: "Invalid file values fall back to the pinned protocol floor.",
|
|
1071
|
+
},
|
|
1072
|
+
}),
|
|
1073
|
+
stringDescriptor({
|
|
1074
|
+
key: "CLINKX_APP_SERVER_MAX_VERSION",
|
|
1075
|
+
class: "policy",
|
|
1076
|
+
type: "string",
|
|
1077
|
+
unit: "",
|
|
1078
|
+
minLength: 5,
|
|
1079
|
+
maxLength: 32,
|
|
1080
|
+
pattern: /^\d+\.\d+\.\d+$/,
|
|
1081
|
+
default: PINNED_APP_SERVER_PROTOCOL_VERSION,
|
|
1082
|
+
blankIsVerbatim: true,
|
|
1083
|
+
onInvalid: { restrictive: PINNED_APP_SERVER_PROTOCOL_VERSION },
|
|
1084
|
+
consumers: ["src/codex/app-server-client.ts:807 acceptedMaxVersion (handshake)"],
|
|
1085
|
+
readTiming: "per_call",
|
|
1086
|
+
affectsResumeFingerprint: false,
|
|
1087
|
+
docs: {
|
|
1088
|
+
title: "App-server max version",
|
|
1089
|
+
summary: "Known-good Codex app-server version ceiling; above it warns unless strict.",
|
|
1090
|
+
warning: "Invalid file values fall back to the pinned protocol ceiling.",
|
|
1091
|
+
},
|
|
1092
|
+
}),
|
|
1093
|
+
boolDescriptor({
|
|
1094
|
+
key: "CLINKX_APP_SERVER_STRICT_VERSION",
|
|
1095
|
+
class: "policy",
|
|
1096
|
+
type: "bool",
|
|
1097
|
+
unit: "",
|
|
1098
|
+
grammar: "truthy_set",
|
|
1099
|
+
default: false,
|
|
1100
|
+
onInvalid: { restrictive: true },
|
|
1101
|
+
consumers: ["src/codex/app-server-client.ts:812 isStrictVersionEnabled (handshake)"],
|
|
1102
|
+
readTiming: "per_call",
|
|
1103
|
+
affectsResumeFingerprint: false,
|
|
1104
|
+
docs: {
|
|
1105
|
+
title: "App-server strict version",
|
|
1106
|
+
summary: "Reject (not warn) a Codex app-server above the max version.",
|
|
1107
|
+
warning: "Invalid file values fall back to true (reject above max).",
|
|
1108
|
+
},
|
|
1109
|
+
}),
|
|
1110
|
+
// ---- Secret -------------------------------------------------------------------
|
|
1111
|
+
stringDescriptor({
|
|
1112
|
+
key: "CLINKX_ELARIS_API_KEY",
|
|
1113
|
+
class: "secret",
|
|
1114
|
+
type: "string",
|
|
1115
|
+
unit: "",
|
|
1116
|
+
minLength: 1,
|
|
1117
|
+
maxLength: 4096,
|
|
1118
|
+
default: "",
|
|
1119
|
+
consumers: [
|
|
1120
|
+
"src/elaris/tools.ts:673 resolveElarisApiKey (per call, via CLINKX_ELARIS_API_KEY_ENV indirection)",
|
|
1121
|
+
"src/elaris/redact.ts (redaction target)",
|
|
1122
|
+
],
|
|
1123
|
+
readTiming: "per_call",
|
|
1124
|
+
affectsResumeFingerprint: false,
|
|
1125
|
+
onInvalid: "default",
|
|
1126
|
+
docs: {
|
|
1127
|
+
title: "Elaris API key",
|
|
1128
|
+
summary: "Bearer key for the Elaris remote agent-session API. Write-only; stored in the 0600 secrets file, never returned to the browser.",
|
|
1129
|
+
warning: "Secret: saved through the step-up secrets endpoint only; never logged, echoed in responses, hashed into DTOs or audited.",
|
|
1130
|
+
},
|
|
1131
|
+
}),
|
|
1132
|
+
];
|
|
1133
|
+
export const SETTINGS_KEYS = REGISTRY_TABLE.map((d) => d.key);
|
|
1134
|
+
export const SETTINGS_KEY_SET = new Set(SETTINGS_KEYS);
|
|
1135
|
+
/**
|
|
1136
|
+
* Null-prototype by construction (S1): `Object.fromEntries` would leave
|
|
1137
|
+
* `SETTINGS_REGISTRY["__proto__"]`, `["constructor"]` and `["toString"]`
|
|
1138
|
+
* resolving to inherited Object members, so a key of that shape arriving from
|
|
1139
|
+
* JSON looked up a "descriptor" that is really `Object.prototype`. Assignment
|
|
1140
|
+
* on a null-prototype record can only ever create own properties.
|
|
1141
|
+
*/
|
|
1142
|
+
const REGISTRY_RECORD = Object.create(null);
|
|
1143
|
+
for (const descriptor of REGISTRY_TABLE) {
|
|
1144
|
+
REGISTRY_RECORD[descriptor.key] = descriptor;
|
|
1145
|
+
}
|
|
1146
|
+
export const SETTINGS_REGISTRY = Object.freeze(REGISTRY_RECORD);
|
|
1147
|
+
// ---------------------------------------------------------------------------
|
|
1148
|
+
// Lookups
|
|
1149
|
+
// ---------------------------------------------------------------------------
|
|
1150
|
+
export function getSettingDescriptor(name) {
|
|
1151
|
+
// Own-property gate; the single lookup every caller must go through. The
|
|
1152
|
+
// null-prototype record already hides inherited names — this keeps that
|
|
1153
|
+
// true even if the record's construction ever changes.
|
|
1154
|
+
return Object.hasOwn(SETTINGS_REGISTRY, name) ? SETTINGS_REGISTRY[name] : undefined;
|
|
1155
|
+
}
|
|
1156
|
+
const ALIAS_INDEX = new Map(REGISTRY_TABLE.flatMap((d) => (d.legacyAliases ?? []).map((alias) => [alias, d.key])));
|
|
1157
|
+
/** Registry keys of a given class, in registry order. */
|
|
1158
|
+
export function settingsKeysByClass(cls) {
|
|
1159
|
+
return REGISTRY_TABLE.filter((d) => d.class === cls).map((d) => d.key);
|
|
1160
|
+
}
|
|
1161
|
+
/** Secret-class keys (exactly the keys allowed in the secrets document). */
|
|
1162
|
+
export function getSecretSettingKeys() {
|
|
1163
|
+
return settingsKeysByClass("secret");
|
|
1164
|
+
}
|
|
1165
|
+
export function isSecretSettingKey(name) {
|
|
1166
|
+
const descriptor = getSettingDescriptor(name);
|
|
1167
|
+
return descriptor != null && descriptor.class === "secret";
|
|
1168
|
+
}
|
|
1169
|
+
export function classifySettingsEnvName(name) {
|
|
1170
|
+
if (Object.hasOwn(SETTINGS_REGISTRY, name)) {
|
|
1171
|
+
return { kind: "key", key: name };
|
|
1172
|
+
}
|
|
1173
|
+
const canonical = ALIAS_INDEX.get(name);
|
|
1174
|
+
if (canonical != null) {
|
|
1175
|
+
return { kind: "alias", of: canonical };
|
|
1176
|
+
}
|
|
1177
|
+
for (const list of EXCLUSION_LISTS) {
|
|
1178
|
+
if (list.entries.has(name)) {
|
|
1179
|
+
return { kind: "excluded", list: list.name };
|
|
1180
|
+
}
|
|
1181
|
+
}
|
|
1182
|
+
return undefined;
|
|
1183
|
+
}
|
|
1184
|
+
/**
|
|
1185
|
+
* ENV_ONLY: real environment variables that must never come from the settings
|
|
1186
|
+
* file because they locate the file itself, act as internal process channels,
|
|
1187
|
+
* choose the exec binary, are test/dev-only (DECISIONS #9; OQ-4/OQ-6), or are
|
|
1188
|
+
* adapter-overridable knobs whose optional adapter JSON field wins whenever it
|
|
1189
|
+
* is pinned (the env is then only the fallback).
|
|
1190
|
+
*/
|
|
1191
|
+
const ENV_ONLY = [
|
|
1192
|
+
{ name: "CLINKX_HOME", reason: "bootstrap locator: root for all durable ClinkX data; locates tiers the settings resolver must not depend on" },
|
|
1193
|
+
{ name: "CLINKX_WORKFLOWS_STATE_DIR", reason: "bootstrap locator: workflow state root; must agree across processes before settings are read" },
|
|
1194
|
+
{ name: "CLINKX_WORKFLOWS_ARTIFACTS_DIR", reason: "bootstrap locator: disposable artifacts root" },
|
|
1195
|
+
{ name: "CLINKX_CONTEXT_BUILDER_RUNS_DIR", reason: "bootstrap locator: durable context_builder artifact runs directory" },
|
|
1196
|
+
{ name: "CLINKX_WORKFLOWS_PROGRESS_REPORT_OVERRIDE_DIR", reason: "bootstrap locator: parent dir of dashboard-written sidecars" },
|
|
1197
|
+
{ name: "CLINKX_CONFIG_PATH", reason: "bootstrap locator: replaces adapter config discovery tiers wholesale" },
|
|
1198
|
+
{ name: "CLINKX_ROSTERS_PATH", reason: "bootstrap locator: replaces roster preset discovery tiers" },
|
|
1199
|
+
{ name: "CLINKX_WORKFLOWS_CHILD_CONFIG_PATH", reason: "bootstrap locator and resume fingerprint input (state.ts buildChildConfigFingerprint)" },
|
|
1200
|
+
{ name: "CLINKX_WORKFLOWS_WORKSPACE_ROOT", reason: "bootstrap/policy input: derives workflow allowed roots and the child cwd (OQ-6)" },
|
|
1201
|
+
{ name: "CLINKX_WORKFLOWS_PATH", reason: "bootstrap locator: workflow definition directory (OQ-6)" },
|
|
1202
|
+
{ name: "CLINKX_WORKFLOWS_TEMPLATES_PATH", reason: "bootstrap locator: prompt template root (OQ-6)" },
|
|
1203
|
+
{ name: "CLINKX_ELARIS_API_KEY_ENV", reason: "secret indirection: names the env var holding the Elaris key; keeps the key out of tool inputs (OQ-6)" },
|
|
1204
|
+
{ name: "CLINKX_WORKFLOWS_CLINKX_CMD", reason: "code execution: chooses the exec binary for the workflow child; never file-writable" },
|
|
1205
|
+
{ name: "CLINKX_AGENT_DEPTH", reason: "internal channel: per-process-chain recursion marker written for the app-server child" },
|
|
1206
|
+
{ name: "CLINKX_RUN_DIR", reason: "internal channel: written into the provider subprocess env; never read by ClinkX" },
|
|
1207
|
+
{ name: "CLINKX_DASHBOARD_STANDALONE_ENTRY", reason: "internal channel: marks the companion standalone entry process" },
|
|
1208
|
+
{ name: "CLINKX_SETTINGS_DIR", reason: "bootstrap locator: overrides the settings directory itself (OQ-4)" },
|
|
1209
|
+
{ name: "CLINKX_SETTINGS", reason: "bootstrap switch: disables settings loading entirely (OQ-4)" },
|
|
1210
|
+
{ name: "CLINKX_RUN_CODEX_SCHEMA_DRIFT", reason: "test/dev-only opt-in for the live codex schema drift check (tests/codex)" },
|
|
1211
|
+
{ name: "CLINKX_REQUIRE_CROSS_REPO", reason: "test/dev-only cross-repo assertion flag (tests/integration)" },
|
|
1212
|
+
{ name: "CLINKX_IDLE_TIMEOUT_SECONDS", reason: "adapter-overridable knob: optional adapter idle_timeout_seconds (src/config.ts) wins when pinned; this env is the live fallback for adapters that pin none (src/runner.ts)" },
|
|
1213
|
+
{ name: "CLINKX_IDLE_TIMEOUT_STARTUP_SECONDS", reason: "adapter-overridable knob: optional adapter idle_timeout_startup_seconds (src/config.ts) wins when pinned; this env is the live fallback for adapters that pin none (src/runner.ts)" },
|
|
1214
|
+
];
|
|
1215
|
+
/**
|
|
1216
|
+
* DEPLOYMENT_ONLY: dashboard/companion/gateway self-configuration (DECISIONS
|
|
1217
|
+
* #6: stays in env/compose, shown read-only at most) — including names the
|
|
1218
|
+
* gateway composes from a prefix and retired names whose presence rejects.
|
|
1219
|
+
*/
|
|
1220
|
+
const DEPLOYMENT_ONLY = [
|
|
1221
|
+
{ name: "CLINKX_WORKFLOWS_DASHBOARD_PORT", reason: "dashboard self-config: local dashboard listen port (compose/env owned)" },
|
|
1222
|
+
{ name: "CLINKX_WORKFLOWS_DASHBOARD_BOOTSTRAP_PORT", reason: "dashboard self-config: bootstrap port (CLI help/Dockerfile only)" },
|
|
1223
|
+
{ name: "CLINKX_WORKFLOWS_DASHBOARD_AUTH_MODE", reason: "dashboard self-config: auth mode guards the Settings page itself (none disables auth)" },
|
|
1224
|
+
{ name: "CLINKX_WORKFLOWS_DASHBOARD_CREDENTIAL_DIR", reason: "dashboard self-config: passkey credential directory" },
|
|
1225
|
+
{ name: "CLINKX_WORKFLOWS_DASHBOARD_RP_NAME", reason: "dashboard self-config: WebAuthn RP name" },
|
|
1226
|
+
{ name: "CLINKX_WORKFLOWS_DASHBOARD_SESSION_TTL_SECONDS", reason: "dashboard self-config: dashboard session TTL" },
|
|
1227
|
+
{ name: "CLINKX_WORKFLOWS_DASHBOARD_MAX_STATE_BYTES", reason: "dashboard self-config: dashboard state size bound" },
|
|
1228
|
+
{ name: "CLINKX_WORKFLOWS_DASHBOARD_PUBLIC_API_ORIGIN", reason: "dashboard self-config: public API origin allowlist" },
|
|
1229
|
+
{ name: "CLINKX_WORKFLOWS_DASHBOARD_UI_ORIGIN", reason: "dashboard self-config: UI origin allowlist" },
|
|
1230
|
+
{ name: "CLINKX_WORKFLOWS_DASHBOARD_TOKEN", reason: "dashboard self-config secret: bearer bootstrap token" },
|
|
1231
|
+
{ name: "CLINKX_DASHBOARD_GATEWAY_URL", reason: "companion self-config: gateway origin" },
|
|
1232
|
+
{ name: "CLINKX_DASHBOARD_GATEWAY_TOKEN", reason: "companion/gateway self-config secret: bearer token (legacy tenant token in gateway mode)" },
|
|
1233
|
+
{ name: "CLINKX_DASHBOARD_ACCOUNT_ORIGIN", reason: "retired companion name: set means reject" },
|
|
1234
|
+
{ name: "CLINKX_DASHBOARD_DEVICE_PROFILE_DIR", reason: "retired companion name: set means reject" },
|
|
1235
|
+
{ name: "CLINKX_DASHBOARD_GATEWAY_", reason: "string prefix fragment composing CLINKX_DASHBOARD_GATEWAY_* names (dashboard-gateway/config.ts)" },
|
|
1236
|
+
{ name: "CLINKX_DASHBOARD_GATEWAY_MODE", reason: "gateway self-config: legacy/tenant mode" },
|
|
1237
|
+
{ name: "CLINKX_DASHBOARD_GATEWAY_HOST", reason: "gateway self-config: listen host" },
|
|
1238
|
+
{ name: "CLINKX_DASHBOARD_GATEWAY_CLOUD_DB_PATH", reason: "gateway self-config: cloud DB path" },
|
|
1239
|
+
{ name: "CLINKX_DASHBOARD_GATEWAY_PUBLIC_ORIGIN", reason: "gateway self-config: public origin" },
|
|
1240
|
+
{ name: "CLINKX_DASHBOARD_GATEWAY_OIDC_ISSUER", reason: "gateway self-config: OIDC issuer" },
|
|
1241
|
+
{ name: "CLINKX_DASHBOARD_GATEWAY_OIDC_CLIENT_ID", reason: "gateway self-config: OIDC client id" },
|
|
1242
|
+
{ name: "CLINKX_DASHBOARD_GATEWAY_OIDC_CLIENT_SECRET_ENV", reason: "gateway self-config: secret env indirection" },
|
|
1243
|
+
{ name: "CLINKX_DASHBOARD_GATEWAY_BILLING", reason: "gateway self-config: billing mode" },
|
|
1244
|
+
{ name: "CLINKX_DASHBOARD_GATEWAY_STRIPE_ENVIRONMENT", reason: "gateway self-config: Stripe environment" },
|
|
1245
|
+
{ name: "CLINKX_DASHBOARD_GATEWAY_STRIPE_SECRET_KEY_ENV", reason: "gateway self-config: secret env indirection" },
|
|
1246
|
+
{ name: "CLINKX_DASHBOARD_GATEWAY_STRIPE_WEBHOOK_SECRET_ENV", reason: "gateway self-config: secret env indirection" },
|
|
1247
|
+
{ name: "CLINKX_DASHBOARD_GATEWAY_STRIPE_PRICE_IDS", reason: "gateway self-config: Stripe price ids" },
|
|
1248
|
+
{ name: "CLINKX_DASHBOARD_GATEWAY_BILLING_GRACE_SECONDS", reason: "gateway self-config: billing grace window" },
|
|
1249
|
+
{ name: "CLINKX_DASHBOARD_GATEWAY_BILLING_RECONCILE_INTERVAL_SECONDS", reason: "gateway self-config: billing reconcile cadence" },
|
|
1250
|
+
{ name: "CLINKX_DASHBOARD_GATEWAY_BILLING_MAX_STALENESS_SECONDS", reason: "gateway self-config: billing staleness bound" },
|
|
1251
|
+
{ name: "CLINKX_DASHBOARD_GATEWAY_REQUIRE_PERSISTENT_DB", reason: "gateway self-config: image-set persistent DB requirement" },
|
|
1252
|
+
{ name: "CLINKX_DASHBOARD_GATEWAY_ACCOUNT_ORIGIN", reason: "retired gateway name: set means reject" },
|
|
1253
|
+
{ name: "CLINKX_DASHBOARD_GATEWAY_TENANT_BASE_DOMAIN", reason: "retired gateway name: set means reject" },
|
|
1254
|
+
];
|
|
1255
|
+
/**
|
|
1256
|
+
* DEAD: still read by consumers but effectively unreachable — every shipped
|
|
1257
|
+
* adapter JSON wins (TIMEOUT family) or no caller remains
|
|
1258
|
+
* (WORKFLOWS_TIMEOUT). Read-only in the UI and flagged in guided trim; a
|
|
1259
|
+
* control for a dead knob would mislead. The IDLE family is NOT here: the
|
|
1260
|
+
* adapter idle fields are optional (src/config.ts), so the env fallback is
|
|
1261
|
+
* live — those keys sit in ENV_ONLY.
|
|
1262
|
+
*/
|
|
1263
|
+
const DEAD = [
|
|
1264
|
+
{ name: "CLINKX_TIMEOUT_SECONDS", reason: "dead: per-call options and every shipped adapter's timeout_seconds (3600) win; child-env deletes it" },
|
|
1265
|
+
{ name: "CLINKX_WORKFLOWS_TIMEOUT_SECONDS", reason: "dead knob: getWorkflowTimeout has zero callers (engine deadline comes from YAML settings)" },
|
|
1266
|
+
];
|
|
1267
|
+
function toExclusionList(name, description, entries) {
|
|
1268
|
+
return {
|
|
1269
|
+
name,
|
|
1270
|
+
description,
|
|
1271
|
+
entries: new Map(entries.map((entry) => [entry.name, entry.reason])),
|
|
1272
|
+
};
|
|
1273
|
+
}
|
|
1274
|
+
const EXCLUSION_LISTS = [
|
|
1275
|
+
toExclusionList("ENV_ONLY", "Env vars that must never come from the settings file", ENV_ONLY),
|
|
1276
|
+
toExclusionList("DEPLOYMENT_ONLY", "Dashboard/companion/gateway self-configuration (env/compose owned)", DEPLOYMENT_ONLY),
|
|
1277
|
+
toExclusionList("DEAD", "Unreachable knobs (adapter JSON wins or zero callers)", DEAD),
|
|
1278
|
+
];
|
|
1279
|
+
export const SETTINGS_ENV_ONLY = ENV_ONLY;
|
|
1280
|
+
export const SETTINGS_DEPLOYMENT_ONLY = DEPLOYMENT_ONLY;
|
|
1281
|
+
export const SETTINGS_DEAD = DEAD;
|
|
1282
|
+
export function getSettingsExclusionLists() {
|
|
1283
|
+
return EXCLUSION_LISTS;
|
|
1284
|
+
}
|
|
1285
|
+
//# sourceMappingURL=registry.js.map
|