@wildo-ai/dev-companion 1.1.1 → 1.1.2
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/esm/.tsbuildinfo +1 -1
- package/dist/esm/claude-cli/models/coding-agent-dispatch.models.d.ts +12 -1
- package/dist/esm/claude-cli/models/coding-agent-dispatch.models.d.ts.map +1 -1
- package/dist/esm/claude-cli/models/coding-agent-dispatch.models.js +11 -0
- package/dist/esm/claude-cli/models/coding-agent-dispatch.models.js.map +1 -1
- package/dist/esm/claude-cli/services/coding-agent-dispatch.companion.service.d.ts +153 -1
- package/dist/esm/claude-cli/services/coding-agent-dispatch.companion.service.d.ts.map +1 -1
- package/dist/esm/claude-cli/services/coding-agent-dispatch.companion.service.js +419 -41
- package/dist/esm/claude-cli/services/coding-agent-dispatch.companion.service.js.map +1 -1
- package/dist/esm/claude-cli/services/research-agent-dispatch.companion.service.d.ts +25 -10
- package/dist/esm/claude-cli/services/research-agent-dispatch.companion.service.d.ts.map +1 -1
- package/dist/esm/claude-cli/services/research-agent-dispatch.companion.service.js +65 -24
- package/dist/esm/claude-cli/services/research-agent-dispatch.companion.service.js.map +1 -1
- package/dist/esm/claude-cli/services/research-evidence-store.companion.d.ts +86 -0
- package/dist/esm/claude-cli/services/research-evidence-store.companion.d.ts.map +1 -0
- package/dist/esm/claude-cli/services/research-evidence-store.companion.js +127 -0
- package/dist/esm/claude-cli/services/research-evidence-store.companion.js.map +1 -0
- package/dist/esm/companion-api/companion-api.schemas.d.ts +59 -2
- package/dist/esm/companion-api/companion-api.schemas.d.ts.map +1 -1
- package/dist/esm/companion-api/companion-api.schemas.js +60 -0
- package/dist/esm/companion-api/companion-api.schemas.js.map +1 -1
- package/dist/esm/companion-api/controllers/companion.controller.d.ts +63 -1
- package/dist/esm/companion-api/controllers/companion.controller.d.ts.map +1 -1
- package/dist/esm/companion-api/controllers/companion.controller.js +322 -21
- package/dist/esm/companion-api/controllers/companion.controller.js.map +1 -1
- package/dist/esm/core/inject/models/container.d.ts.map +1 -1
- package/dist/esm/core/inject/models/container.js +11 -0
- package/dist/esm/core/inject/models/container.js.map +1 -1
- package/dist/esm/core/inject/models/service-types.d.ts +5 -0
- package/dist/esm/core/inject/models/service-types.d.ts.map +1 -1
- package/dist/esm/core/inject/models/service-types.js +5 -0
- package/dist/esm/core/inject/models/service-types.js.map +1 -1
- package/dist/esm/core/introspection/behaviors/companion-introspection-behavior-definitions.d.ts.map +1 -1
- package/dist/esm/core/introspection/behaviors/companion-introspection-behavior-definitions.js +81 -0
- package/dist/esm/core/introspection/behaviors/companion-introspection-behavior-definitions.js.map +1 -1
- package/dist/esm/core/introspection/models/companion-introspection.models.d.ts +11 -1
- package/dist/esm/core/introspection/models/companion-introspection.models.d.ts.map +1 -1
- package/dist/esm/core/introspection/models/companion-introspection.models.js +39 -0
- package/dist/esm/core/introspection/models/companion-introspection.models.js.map +1 -1
- package/dist/esm/core/introspection/resources/creation-plane-dispatch.custom-impl.companion.service.d.ts +8 -0
- package/dist/esm/core/introspection/resources/creation-plane-dispatch.custom-impl.companion.service.d.ts.map +1 -0
- package/dist/esm/core/introspection/resources/creation-plane-dispatch.custom-impl.companion.service.js +317 -0
- package/dist/esm/core/introspection/resources/creation-plane-dispatch.custom-impl.companion.service.js.map +1 -0
- package/dist/esm/core/introspection/resources/creation-plane-projection.companion.service.d.ts +45 -0
- package/dist/esm/core/introspection/resources/creation-plane-projection.companion.service.d.ts.map +1 -0
- package/dist/esm/core/introspection/resources/creation-plane-projection.companion.service.js +250 -0
- package/dist/esm/core/introspection/resources/creation-plane-projection.companion.service.js.map +1 -0
- package/dist/esm/core/introspection/resources/introspection-resource-notifier.companion.service.d.ts +123 -0
- package/dist/esm/core/introspection/resources/introspection-resource-notifier.companion.service.d.ts.map +1 -0
- package/dist/esm/core/introspection/resources/introspection-resource-notifier.companion.service.js +298 -0
- package/dist/esm/core/introspection/resources/introspection-resource-notifier.companion.service.js.map +1 -0
- package/dist/esm/core/introspection/resources/introspection-resource-source.companion.service.d.ts +78 -1
- package/dist/esm/core/introspection/resources/introspection-resource-source.companion.service.d.ts.map +1 -1
- package/dist/esm/core/introspection/resources/introspection-resource-source.companion.service.js +155 -6
- package/dist/esm/core/introspection/resources/introspection-resource-source.companion.service.js.map +1 -1
- package/dist/esm/core/introspection/services/companion-introspection.companion.service.d.ts +131 -2
- package/dist/esm/core/introspection/services/companion-introspection.companion.service.d.ts.map +1 -1
- package/dist/esm/core/introspection/services/companion-introspection.companion.service.js +259 -9
- package/dist/esm/core/introspection/services/companion-introspection.companion.service.js.map +1 -1
- package/dist/esm/core/introspection/services/introspection-derivation-state.companion.service.d.ts +243 -0
- package/dist/esm/core/introspection/services/introspection-derivation-state.companion.service.d.ts.map +1 -0
- package/dist/esm/core/introspection/services/introspection-derivation-state.companion.service.js +417 -0
- package/dist/esm/core/introspection/services/introspection-derivation-state.companion.service.js.map +1 -0
- package/dist/esm/core/introspection/services/introspection-source-state.companion.service.d.ts +186 -0
- package/dist/esm/core/introspection/services/introspection-source-state.companion.service.d.ts.map +1 -0
- package/dist/esm/core/introspection/services/introspection-source-state.companion.service.js +368 -0
- package/dist/esm/core/introspection/services/introspection-source-state.companion.service.js.map +1 -0
- package/dist/esm/core/introspection/services/introspection-source-watcher.companion.service.d.ts +101 -0
- package/dist/esm/core/introspection/services/introspection-source-watcher.companion.service.d.ts.map +1 -0
- package/dist/esm/core/introspection/services/introspection-source-watcher.companion.service.js +278 -0
- package/dist/esm/core/introspection/services/introspection-source-watcher.companion.service.js.map +1 -0
- package/dist/esm/core/introspection/subprocess/application-domain-model.behavior.d.ts +365 -0
- package/dist/esm/core/introspection/subprocess/application-domain-model.behavior.d.ts.map +1 -0
- package/dist/esm/core/introspection/subprocess/application-domain-model.behavior.js +167 -0
- package/dist/esm/core/introspection/subprocess/application-domain-model.behavior.js.map +1 -0
- package/dist/esm/core/introspection/subprocess/companion-introspection-behavior-handlers.d.ts.map +1 -1
- package/dist/esm/core/introspection/subprocess/companion-introspection-behavior-handlers.js +332 -3
- package/dist/esm/core/introspection/subprocess/companion-introspection-behavior-handlers.js.map +1 -1
- package/dist/esm/core/introspection/subprocess/family-aspects.behavior.d.ts +19 -0
- package/dist/esm/core/introspection/subprocess/family-aspects.behavior.d.ts.map +1 -0
- package/dist/esm/core/introspection/subprocess/family-aspects.behavior.js +164 -0
- package/dist/esm/core/introspection/subprocess/family-aspects.behavior.js.map +1 -0
- package/dist/esm/core/introspection/subprocess/openapi-generation-input.behavior.d.ts +3 -1
- package/dist/esm/core/introspection/subprocess/openapi-generation-input.behavior.d.ts.map +1 -1
- package/dist/esm/core/introspection/subprocess/openapi-generation-input.behavior.js +36 -23
- package/dist/esm/core/introspection/subprocess/openapi-generation-input.behavior.js.map +1 -1
- package/dist/esm/core/introspection/subprocess/specification-artifacts.behavior.d.ts +51 -0
- package/dist/esm/core/introspection/subprocess/specification-artifacts.behavior.d.ts.map +1 -0
- package/dist/esm/core/introspection/subprocess/specification-artifacts.behavior.js +391 -0
- package/dist/esm/core/introspection/subprocess/specification-artifacts.behavior.js.map +1 -0
- package/dist/esm/core/runtime/companion-startup-assembly.d.ts.map +1 -1
- package/dist/esm/core/runtime/companion-startup-assembly.js +5 -0
- package/dist/esm/core/runtime/companion-startup-assembly.js.map +1 -1
- package/dist/esm/core/runtime/dev-compile-quiet.companion.d.ts +103 -0
- package/dist/esm/core/runtime/dev-compile-quiet.companion.d.ts.map +1 -0
- package/dist/esm/core/runtime/dev-compile-quiet.companion.js +124 -0
- package/dist/esm/core/runtime/dev-compile-quiet.companion.js.map +1 -0
- package/dist/esm/core/runtime/services/start-companion-application.service.d.ts +39 -2
- package/dist/esm/core/runtime/services/start-companion-application.service.d.ts.map +1 -1
- package/dist/esm/core/runtime/services/start-companion-application.service.js +122 -11
- package/dist/esm/core/runtime/services/start-companion-application.service.js.map +1 -1
- package/dist/esm/core/specifications/non-composite-view-specification-context.shared.d.ts +6 -0
- package/dist/esm/core/specifications/non-composite-view-specification-context.shared.d.ts.map +1 -1
- package/dist/esm/core/specifications/non-composite-view-specification-context.shared.js.map +1 -1
- package/dist/esm/core/specifications/specification-context-factory.shared.d.ts +23 -0
- package/dist/esm/core/specifications/specification-context-factory.shared.d.ts.map +1 -1
- package/dist/esm/core/specifications/specification-context-factory.shared.js +26 -4
- package/dist/esm/core/specifications/specification-context-factory.shared.js.map +1 -1
- package/dist/esm/executions/services/companion-executions.companion.service.d.ts +82 -3
- package/dist/esm/executions/services/companion-executions.companion.service.d.ts.map +1 -1
- package/dist/esm/executions/services/companion-executions.companion.service.js +126 -12
- package/dist/esm/executions/services/companion-executions.companion.service.js.map +1 -1
- package/dist/esm/i18n/components/APP_LAYOUTS_MAIN_CONTAINER.en.d.ts +12 -0
- package/dist/esm/i18n/components/APP_LAYOUTS_MAIN_CONTAINER.en.d.ts.map +1 -0
- package/dist/esm/i18n/components/APP_LAYOUTS_MAIN_CONTAINER.en.js +12 -0
- package/dist/esm/i18n/components/APP_LAYOUTS_MAIN_CONTAINER.en.js.map +1 -0
- package/dist/esm/i18n/components/LOW_LEVEL_FORM_FIELD.en.d.ts +1 -1
- package/dist/esm/i18n/components/LOW_LEVEL_FORM_FIELD.en.js +1 -1
- package/dist/esm/i18n/components/LOW_LEVEL_FORM_FIELD.en.js.map +1 -1
- package/dist/esm/i18n/composite_views/app.creation-board.en.d.ts +13 -0
- package/dist/esm/i18n/composite_views/app.creation-board.en.d.ts.map +1 -0
- package/dist/esm/i18n/composite_views/app.creation-board.en.js +91 -0
- package/dist/esm/i18n/composite_views/app.creation-board.en.js.map +1 -0
- package/dist/esm/i18n/composite_views/app.domain-model.en.d.ts +38 -0
- package/dist/esm/i18n/composite_views/app.domain-model.en.d.ts.map +1 -0
- package/dist/esm/i18n/composite_views/app.domain-model.en.js +41 -0
- package/dist/esm/i18n/composite_views/app.domain-model.en.js.map +1 -0
- package/dist/esm/i18n/index.d.ts +3 -3
- package/dist/esm/i18n/index.js +3 -3
- package/dist/esm/i18n/index.js.map +1 -1
- package/dist/esm/i18n/resources/wildoApplicationActorSystemExecutions.en.d.ts +24 -0
- package/dist/esm/i18n/resources/wildoApplicationActorSystemExecutions.en.d.ts.map +1 -0
- package/dist/esm/i18n/resources/wildoApplicationActorSystemExecutions.en.js +20 -0
- package/dist/esm/i18n/resources/wildoApplicationActorSystemExecutions.en.js.map +1 -0
- package/dist/esm/i18n/resources/wildoApplicationActorTasks.en.d.ts +31 -0
- package/dist/esm/i18n/resources/wildoApplicationActorTasks.en.d.ts.map +1 -0
- package/dist/esm/i18n/resources/wildoApplicationActorTasks.en.js +27 -0
- package/dist/esm/i18n/resources/wildoApplicationActorTasks.en.js.map +1 -0
- package/dist/esm/i18n/resources/wildoApplicationFlowSystemExecutions.en.d.ts +24 -0
- package/dist/esm/i18n/resources/wildoApplicationFlowSystemExecutions.en.d.ts.map +1 -0
- package/dist/esm/i18n/resources/wildoApplicationFlowSystemExecutions.en.js +20 -0
- package/dist/esm/i18n/resources/wildoApplicationFlowSystemExecutions.en.js.map +1 -0
- package/dist/esm/i18n/resources/workbenchBuildPlanTasks.en.d.ts +28 -0
- package/dist/esm/i18n/resources/workbenchBuildPlanTasks.en.d.ts.map +1 -0
- package/dist/esm/i18n/resources/workbenchBuildPlanTasks.en.js +24 -0
- package/dist/esm/i18n/resources/workbenchBuildPlanTasks.en.js.map +1 -0
- package/dist/esm/i18n/resources/workbenchDomainResources.en.d.ts +138 -0
- package/dist/esm/i18n/resources/workbenchDomainResources.en.d.ts.map +1 -0
- package/dist/esm/i18n/resources/workbenchDomainResources.en.js +100 -0
- package/dist/esm/i18n/resources/workbenchDomainResources.en.js.map +1 -0
- package/dist/esm/i18n/resources/workbenchPlaybooks.en.d.ts +29 -0
- package/dist/esm/i18n/resources/workbenchPlaybooks.en.d.ts.map +1 -0
- package/dist/esm/i18n/resources/workbenchPlaybooks.en.js +25 -0
- package/dist/esm/i18n/resources/workbenchPlaybooks.en.js.map +1 -0
- package/dist/esm/i18n/resources/workbenchRunWriteRecords.en.d.ts +27 -0
- package/dist/esm/i18n/resources/workbenchRunWriteRecords.en.d.ts.map +1 -0
- package/dist/esm/i18n/resources/workbenchRunWriteRecords.en.js +23 -0
- package/dist/esm/i18n/resources/workbenchRunWriteRecords.en.js.map +1 -0
- package/dist/esm/i18n/resources/workbenchSpecificationArtifacts.en.d.ts +806 -0
- package/dist/esm/i18n/resources/workbenchSpecificationArtifacts.en.d.ts.map +1 -0
- package/dist/esm/i18n/resources/workbenchSpecificationArtifacts.en.js +326 -0
- package/dist/esm/i18n/resources/workbenchSpecificationArtifacts.en.js.map +1 -0
- package/dist/esm/i18n/resources/workbenchTraceSessions.en.d.ts +26 -0
- package/dist/esm/i18n/resources/workbenchTraceSessions.en.d.ts.map +1 -0
- package/dist/esm/i18n/resources/workbenchTraceSessions.en.js +22 -0
- package/dist/esm/i18n/resources/workbenchTraceSessions.en.js.map +1 -0
- package/dist/esm/i18n/system_enums/market.en.d.ts +202 -0
- package/dist/esm/i18n/system_enums/market.en.d.ts.map +1 -0
- package/dist/esm/i18n/system_enums/market.en.js +209 -0
- package/dist/esm/i18n/system_enums/market.en.js.map +1 -0
- package/dist/esm/meta-workflows/models/application-coding-agent.actors-system.definitions.d.ts +112 -2
- package/dist/esm/meta-workflows/models/application-coding-agent.actors-system.definitions.d.ts.map +1 -1
- package/dist/esm/meta-workflows/models/application-coding-agent.actors-system.definitions.js +201 -34
- package/dist/esm/meta-workflows/models/application-coding-agent.actors-system.definitions.js.map +1 -1
- package/dist/esm/meta-workflows/models/application-research-agent.actors-system.definitions.d.ts +31 -3
- package/dist/esm/meta-workflows/models/application-research-agent.actors-system.definitions.d.ts.map +1 -1
- package/dist/esm/meta-workflows/models/application-research-agent.actors-system.definitions.js +48 -12
- package/dist/esm/meta-workflows/models/application-research-agent.actors-system.definitions.js.map +1 -1
- package/dist/esm/meta-workflows/models/brief-adequacy.actors-system.definitions.d.ts +36 -0
- package/dist/esm/meta-workflows/models/brief-adequacy.actors-system.definitions.d.ts.map +1 -0
- package/dist/esm/meta-workflows/models/brief-adequacy.actors-system.definitions.js +75 -0
- package/dist/esm/meta-workflows/models/brief-adequacy.actors-system.definitions.js.map +1 -0
- package/dist/esm/meta-workflows/services/application-build-dispatch.companion.service.d.ts +105 -7
- package/dist/esm/meta-workflows/services/application-build-dispatch.companion.service.d.ts.map +1 -1
- package/dist/esm/meta-workflows/services/application-build-dispatch.companion.service.js +298 -24
- package/dist/esm/meta-workflows/services/application-build-dispatch.companion.service.js.map +1 -1
- package/dist/esm/meta-workflows/services/application-build-generation-step.companion.service.d.ts +46 -3
- package/dist/esm/meta-workflows/services/application-build-generation-step.companion.service.d.ts.map +1 -1
- package/dist/esm/meta-workflows/services/application-build-generation-step.companion.service.js +95 -2
- package/dist/esm/meta-workflows/services/application-build-generation-step.companion.service.js.map +1 -1
- package/dist/esm/meta-workflows/services/execution-trace-read.companion.service.d.ts +9 -0
- package/dist/esm/meta-workflows/services/execution-trace-read.companion.service.d.ts.map +1 -1
- package/dist/esm/meta-workflows/services/execution-trace-read.companion.service.js +13 -0
- package/dist/esm/meta-workflows/services/execution-trace-read.companion.service.js.map +1 -1
- package/dist/esm/meta-workflows/services/playbook-run-write-register.companion.service.d.ts +12 -0
- package/dist/esm/meta-workflows/services/playbook-run-write-register.companion.service.d.ts.map +1 -1
- package/dist/esm/meta-workflows/services/playbook-run-write-register.companion.service.js +23 -0
- package/dist/esm/meta-workflows/services/playbook-run-write-register.companion.service.js.map +1 -1
- package/dist/esm/meta-workflows/services/playbook-run.companion.service.d.ts +120 -3
- package/dist/esm/meta-workflows/services/playbook-run.companion.service.d.ts.map +1 -1
- package/dist/esm/meta-workflows/services/playbook-run.companion.service.js +636 -81
- package/dist/esm/meta-workflows/services/playbook-run.companion.service.js.map +1 -1
- package/dist/esm/meta-workflows/services/playbook-suspended-run.companion.service.d.ts +40 -0
- package/dist/esm/meta-workflows/services/playbook-suspended-run.companion.service.d.ts.map +1 -1
- package/dist/esm/meta-workflows/services/playbook-suspended-run.companion.service.js +63 -1
- package/dist/esm/meta-workflows/services/playbook-suspended-run.companion.service.js.map +1 -1
- package/dist/esm/technical-doc/services/technical-doc.companion.service.d.ts +21 -0
- package/dist/esm/technical-doc/services/technical-doc.companion.service.d.ts.map +1 -1
- package/dist/esm/technical-doc/services/technical-doc.companion.service.js +86 -2
- package/dist/esm/technical-doc/services/technical-doc.companion.service.js.map +1 -1
- package/dist/esm/technical-doc/services/technical-documentation-application-derivation.companion.service.d.ts +12 -1
- package/dist/esm/technical-doc/services/technical-documentation-application-derivation.companion.service.d.ts.map +1 -1
- package/dist/esm/technical-doc/services/technical-documentation-application-derivation.companion.service.js +47 -1
- package/dist/esm/technical-doc/services/technical-documentation-application-derivation.companion.service.js.map +1 -1
- package/package.json +17 -17
- package/dist/esm/.builder.pid +0 -9
- package/dist/esm/i18n/resources/workbenchApplicationModules.en.d.ts +0 -36
- package/dist/esm/i18n/resources/workbenchApplicationModules.en.d.ts.map +0 -1
- package/dist/esm/i18n/resources/workbenchApplicationModules.en.js +0 -32
- package/dist/esm/i18n/resources/workbenchApplicationModules.en.js.map +0 -1
- package/dist/esm/i18n/resources/workbenchResourceRelationships.en.d.ts +0 -29
- package/dist/esm/i18n/resources/workbenchResourceRelationships.en.d.ts.map +0 -1
- package/dist/esm/i18n/resources/workbenchResourceRelationships.en.js +0 -25
- package/dist/esm/i18n/resources/workbenchResourceRelationships.en.js.map +0 -1
|
@@ -18,9 +18,48 @@ import { SAAS_SERVICE_TYPES } from '@wildo-ai/saas-backend-lib';
|
|
|
18
18
|
import { AppLibraryType, resolvePackageCompanionEntryPath } from '@wildo-ai/platform-config-lib';
|
|
19
19
|
import { CompanionIntrospectionResultSchema } from '../../../companion-api/companion-api.schemas.js';
|
|
20
20
|
import { CompanionIntrospectionBehaviorRegistryService } from './companion-introspection-behavior-registry.companion.service.js';
|
|
21
|
+
import { IntrospectionDerivationStateCompanionService } from './introspection-derivation-state.companion.service.js';
|
|
21
22
|
import { COMPANION_SERVICE_TYPES } from '../../inject/models/service-types.js';
|
|
22
23
|
const DEFAULT_MAX_CONCURRENCY = 4;
|
|
23
24
|
const DEFAULT_TIMEOUT_MS = 30_000;
|
|
25
|
+
/**
|
|
26
|
+
* The signals that mean SOMEONE ELSE stopped this process tree.
|
|
27
|
+
*
|
|
28
|
+
* Read only in the exit branch that has already established this service sent no kill of its own, so
|
|
29
|
+
* membership here is what separates "the companion is going down" from "the derivation failed".
|
|
30
|
+
* `SIGKILL` is deliberately absent: it is what this service's own force-kill escalation sends, and a
|
|
31
|
+
* child that reaches it has already been through `requestTermination`.
|
|
32
|
+
*/
|
|
33
|
+
const EXTERNAL_TERMINATION_SIGNALS = new Set(['SIGTERM', 'SIGINT', 'SIGHUP']);
|
|
34
|
+
/**
|
|
35
|
+
* Whether a dead introspection child was killed by SOMEONE OTHER than this service.
|
|
36
|
+
*
|
|
37
|
+
* Exported because it is the whole decision — the call site is one branch — and because it is the
|
|
38
|
+
* part worth pinning: the plumbing around it needs a real subprocess and a real signal, while the
|
|
39
|
+
* reasoning is three booleans.
|
|
40
|
+
*
|
|
41
|
+
* The inference rests on an invariant of this file: every termination this service performs goes
|
|
42
|
+
* through `requestTermination`, which sets a pending failure BEFORE killing, and the exit handler
|
|
43
|
+
* returns that failure without consulting this. So a termination signal arriving with no pending
|
|
44
|
+
* failure and no parsed result means nobody here asked — the child died because its PARENT did,
|
|
45
|
+
* taking the process group with it. If a future kill path forgets to set the pending failure first,
|
|
46
|
+
* this starts misreporting a local kill as an external one, which is why the invariant is stated
|
|
47
|
+
* here rather than left implicit at the call site.
|
|
48
|
+
*/
|
|
49
|
+
export function wasTerminatedFromOutside(input) {
|
|
50
|
+
if (input.hasPendingFailure || input.hasParsedResult)
|
|
51
|
+
return false;
|
|
52
|
+
return input.signal !== null && EXTERNAL_TERMINATION_SIGNALS.has(input.signal);
|
|
53
|
+
}
|
|
54
|
+
/**
|
|
55
|
+
* Env value that turns the derivation cache off entirely.
|
|
56
|
+
*
|
|
57
|
+
* Read once at construction. A door rather than a design: if the cache is ever suspected of serving
|
|
58
|
+
* a stale answer, an operator can settle the question in one restart instead of reasoning about the
|
|
59
|
+
* invalidation, and the diagnosis stays about the application rather than about this file. The
|
|
60
|
+
* default is ON — the whole point is that the workbench stops paying a cold transpile per request.
|
|
61
|
+
*/
|
|
62
|
+
const DISABLE_DERIVATION_CACHE_VALUE = 'off';
|
|
24
63
|
/**
|
|
25
64
|
* Env-var namespaces stripped from the spawned introspection child's
|
|
26
65
|
* environment so pre-bootstrap reads surface `undefined` instead of inheriting
|
|
@@ -45,6 +84,73 @@ export const SCRUBBED_CHILD_ENV_NAMES = [
|
|
|
45
84
|
'COMPANION_FRAMEWORK_ROOT',
|
|
46
85
|
'WILDO_COMPANION_INTROSPECTION_CHILD',
|
|
47
86
|
];
|
|
87
|
+
/**
|
|
88
|
+
* Render an arbitrary behavior `input` so that two structurally equal inputs produce one key.
|
|
89
|
+
*
|
|
90
|
+
* `JSON.stringify` alone would not: `{a:1,b:2}` and `{b:2,a:1}` are the same question and would
|
|
91
|
+
* occupy two cache entries, so the second phrasing of a question would always miss. Object keys are
|
|
92
|
+
* therefore sorted at every depth. Arrays keep their order, because in an input an array's order is
|
|
93
|
+
* part of the question.
|
|
94
|
+
*
|
|
95
|
+
* A value that cannot be rendered — a cycle, a `BigInt` — yields `null`, which the caller reads as
|
|
96
|
+
* "this question is not cacheable" rather than as an error. Nothing in the current behavior surface
|
|
97
|
+
* sends such an input; treating it as uncacheable rather than throwing keeps a future one working.
|
|
98
|
+
*/
|
|
99
|
+
export function renderStableCacheableInput(input) {
|
|
100
|
+
const seen = new WeakSet();
|
|
101
|
+
const render = (value) => {
|
|
102
|
+
if (value === undefined)
|
|
103
|
+
return 'undefined';
|
|
104
|
+
if (value === null)
|
|
105
|
+
return 'null';
|
|
106
|
+
if (typeof value === 'bigint')
|
|
107
|
+
throw new Error('BigInt is not renderable.');
|
|
108
|
+
if (typeof value !== 'object')
|
|
109
|
+
return JSON.stringify(value) ?? 'undefined';
|
|
110
|
+
if (seen.has(value))
|
|
111
|
+
throw new Error('Cyclic input is not renderable.');
|
|
112
|
+
seen.add(value);
|
|
113
|
+
if (Array.isArray(value)) {
|
|
114
|
+
return `[${value.map(render).join(',')}]`;
|
|
115
|
+
}
|
|
116
|
+
const entries = Object.entries(value)
|
|
117
|
+
.filter(([, entryValue]) => entryValue !== undefined)
|
|
118
|
+
.sort(([left], [right]) => (left < right ? -1 : left > right ? 1 : 0));
|
|
119
|
+
return `{${entries.map(([key, entryValue]) => `${JSON.stringify(key)}:${render(entryValue)}`).join(',')}}`;
|
|
120
|
+
};
|
|
121
|
+
try {
|
|
122
|
+
return render(input);
|
|
123
|
+
}
|
|
124
|
+
catch {
|
|
125
|
+
return null;
|
|
126
|
+
}
|
|
127
|
+
}
|
|
128
|
+
/**
|
|
129
|
+
* The identity of a derivation on the REQUEST side.
|
|
130
|
+
*
|
|
131
|
+
* Everything the child is given that can change its answer: which service, which behavior, which
|
|
132
|
+
* target it routes to, and the behavior input. `entryPath` and `packageRoot` are included because a
|
|
133
|
+
* package whose built `./companion` export appears or disappears changes which bytes are imported
|
|
134
|
+
* without changing the behavior id — and `resolvePackageCompanionEntryPath` prefers `dist` when it
|
|
135
|
+
* exists and falls back to source when it does not.
|
|
136
|
+
*
|
|
137
|
+
* Returns `null` for an input that cannot be stably rendered, which the caller reads as
|
|
138
|
+
* "derive, do not remember".
|
|
139
|
+
*/
|
|
140
|
+
function buildDerivationCacheKey(target) {
|
|
141
|
+
const renderedInput = renderStableCacheableInput(target.input);
|
|
142
|
+
if (renderedInput === null)
|
|
143
|
+
return null;
|
|
144
|
+
return [
|
|
145
|
+
target.serviceKey,
|
|
146
|
+
target.serviceKind,
|
|
147
|
+
target.behavior,
|
|
148
|
+
target.targetId,
|
|
149
|
+
target.packageRoot,
|
|
150
|
+
target.entryPath,
|
|
151
|
+
renderedInput,
|
|
152
|
+
].join('\u0001');
|
|
153
|
+
}
|
|
48
154
|
/**
|
|
49
155
|
* Build the `env` object handed to the spawned introspection child process.
|
|
50
156
|
*
|
|
@@ -80,6 +186,7 @@ let CompanionIntrospectionService = class CompanionIntrospectionService {
|
|
|
80
186
|
logger;
|
|
81
187
|
companionContext;
|
|
82
188
|
behaviorRegistryService;
|
|
189
|
+
derivationState;
|
|
83
190
|
logDebug;
|
|
84
191
|
maxConcurrency;
|
|
85
192
|
timeoutMs;
|
|
@@ -87,20 +194,133 @@ let CompanionIntrospectionService = class CompanionIntrospectionService {
|
|
|
87
194
|
queue = [];
|
|
88
195
|
/** Test seam only; production always retains Node's real child-process spawn. */
|
|
89
196
|
spawnSubprocess = spawn;
|
|
90
|
-
|
|
197
|
+
/**
|
|
198
|
+
* Whether compiled state may be retained at all.
|
|
199
|
+
*
|
|
200
|
+
* `COMPANION_INTROSPECTION_CACHE=off` still means what it always meant — every read compiles, and
|
|
201
|
+
* no state is consulted or written. The flag is read here rather than inside the state service
|
|
202
|
+
* because this is the door every consumer already comes through, so switching it off cannot be
|
|
203
|
+
* bypassed by a caller that reaches the state service directly.
|
|
204
|
+
*/
|
|
205
|
+
derivationCacheEnabled;
|
|
206
|
+
constructor(logger, companionContext, behaviorRegistryService, derivationState) {
|
|
91
207
|
this.logger = logger;
|
|
92
208
|
this.companionContext = companionContext;
|
|
93
209
|
this.behaviorRegistryService = behaviorRegistryService;
|
|
210
|
+
this.derivationState = derivationState;
|
|
94
211
|
this.logDebug = this.logger.debugByType('CompanionIntrospectionService');
|
|
95
212
|
this.logger.setDebugTypeLogging('CompanionIntrospectionService', true);
|
|
96
213
|
this.maxConcurrency = Math.max(1, Number.parseInt(process.env.COMPANION_INTROSPECTION_MAX_CONCURRENCY ?? '', 10)
|
|
97
214
|
|| DEFAULT_MAX_CONCURRENCY);
|
|
98
215
|
this.timeoutMs = Math.max(1_000, Number.parseInt(process.env.COMPANION_INTROSPECTION_TIMEOUT_MS ?? '', 10)
|
|
99
216
|
|| DEFAULT_TIMEOUT_MS);
|
|
217
|
+
this.derivationCacheEnabled = (process.env.COMPANION_INTROSPECTION_CACHE ?? '').trim().toLowerCase()
|
|
218
|
+
!== DISABLE_DERIVATION_CACHE_VALUE;
|
|
219
|
+
}
|
|
220
|
+
/**
|
|
221
|
+
* Answer an introspection request, re-deriving only when the application's source has moved.
|
|
222
|
+
*
|
|
223
|
+
* ## The three tiers, in order
|
|
224
|
+
*
|
|
225
|
+
* 1. **Cache hit** — a previous derivation of this exact question, taken against a source tree
|
|
226
|
+
* whose observation token still matches. No subprocess, no import, no registry materialization.
|
|
227
|
+
* 2. **In-flight join** — the identical question is already being derived against the identical
|
|
228
|
+
* token. The caller waits on that one rather than spawning a second child.
|
|
229
|
+
* 3. **Derive** — spawn, under the existing concurrency queue.
|
|
230
|
+
*
|
|
231
|
+
* ## What is cached, and what deliberately is not
|
|
232
|
+
*
|
|
233
|
+
* Only SUCCESS. A failure is not memoized, for two separate reasons and either is sufficient: the
|
|
234
|
+
* common failure here is an application whose `dist` is not built, whose remedy moves the source
|
|
235
|
+
* and would invalidate anyway; and a transient failure — a timeout on a loaded machine — would
|
|
236
|
+
* otherwise stick to an unchanged tree and be served as the answer forever. In-flight JOINING
|
|
237
|
+
* still covers failures, because two concurrent identical questions should cost one subprocess
|
|
238
|
+
* whatever the outcome.
|
|
239
|
+
*
|
|
240
|
+
* ## Where the source reading happens
|
|
241
|
+
*
|
|
242
|
+
* Outside the concurrency queue. The observation is ~125 ms of filesystem work with no subprocess
|
|
243
|
+
* behind it; holding one of the four queue slots for it would make a cache HIT contend with real
|
|
244
|
+
* derivations, which is the opposite of the point.
|
|
245
|
+
*/
|
|
246
|
+
/**
|
|
247
|
+
* The introspection MENU — what this running companion can answer, for a caller that has to choose.
|
|
248
|
+
*
|
|
249
|
+
* Serves `wildo context list` (issue #252): the door's tier-1 progressive-disclosure catalog. It is a
|
|
250
|
+
* COMPANION answer rather than a CLI-side copy of the behavior definitions on purpose — the CLI and a
|
|
251
|
+
* running companion can be different builds, and a menu describing behaviors the serving side does not
|
|
252
|
+
* have is the staleness class `.claude/rules/staleness-presents-as-a-logic-defect.md` records. Runtime
|
|
253
|
+
* truth, one hop.
|
|
254
|
+
*
|
|
255
|
+
* `defaultBackendServiceKey` is here for the same one-authority reason: `POST /_meta/introspect`
|
|
256
|
+
* REQUIRES a `serviceKey`, and the "first backend service" default already exists in the playbook
|
|
257
|
+
* composer (`composeWorkspaceTruthSection`). Publishing the resolved default lets a CLI caller pass it
|
|
258
|
+
* explicitly instead of re-deriving the rule, so the POST contract stays strict and the rule stays in
|
|
259
|
+
* companion code.
|
|
260
|
+
*/
|
|
261
|
+
describeCatalog() {
|
|
262
|
+
const behaviors = this.behaviorRegistryService.listBehaviorDefinitions().map((definition) => ({
|
|
263
|
+
behaviorId: definition.behaviorId,
|
|
264
|
+
description: definition.description,
|
|
265
|
+
category: definition.category,
|
|
266
|
+
supportedServiceKinds: definition.supportedServiceKinds,
|
|
267
|
+
}));
|
|
268
|
+
const serviceKeys = Object.entries(this.companionContext.servicesByKey).map(([key, service]) => ({
|
|
269
|
+
key,
|
|
270
|
+
kind: this.resolveServiceKind(service),
|
|
271
|
+
}));
|
|
272
|
+
const defaultBackendServiceKey = serviceKeys.find((service) => service.kind === 'backend')?.key ?? null;
|
|
273
|
+
return { behaviors, serviceKeys, defaultBackendServiceKey };
|
|
100
274
|
}
|
|
101
275
|
async requestInfo(request) {
|
|
276
|
+
const resolvedTarget = await this.resolveTarget(request);
|
|
277
|
+
if (!this.derivationCacheEnabled) {
|
|
278
|
+
return this.deriveThroughQueue(resolvedTarget);
|
|
279
|
+
}
|
|
280
|
+
const cacheKey = buildDerivationCacheKey(resolvedTarget);
|
|
281
|
+
if (cacheKey === null) {
|
|
282
|
+
return this.deriveThroughQueue(resolvedTarget);
|
|
283
|
+
}
|
|
284
|
+
return this.derivationState.read({ cacheKey, behavior: resolvedTarget.behavior, serviceKey: resolvedTarget.serviceKey }, () => this.deriveThroughQueue(resolvedTarget));
|
|
285
|
+
}
|
|
286
|
+
/**
|
|
287
|
+
* Compile a derivation without consulting or writing compiled state.
|
|
288
|
+
*
|
|
289
|
+
* The COMPILE primitive, exposed so the state service can drive a recompilation that no read
|
|
290
|
+
* asked for. It is the same path a cache miss took before, minus the memo: the concurrency queue,
|
|
291
|
+
* the subprocess, the IPC result. Nothing here decides freshness, which is the separation this
|
|
292
|
+
* whole change exists to make — a caller that wants the current answer asks the state service, and
|
|
293
|
+
* a caller that wants a NEW answer asks this.
|
|
294
|
+
*/
|
|
295
|
+
async compileNow(request) {
|
|
296
|
+
return this.deriveThroughQueue(await this.resolveTarget(request));
|
|
297
|
+
}
|
|
298
|
+
/**
|
|
299
|
+
* The cache key a request resolves to, for a caller that needs to talk about a derivation's
|
|
300
|
+
* identity — to warm it, to stamp a notification with its generation — without running it.
|
|
301
|
+
*
|
|
302
|
+
* `null` means the request's input cannot be stably rendered, which every caller reads as
|
|
303
|
+
* "compile, do not remember".
|
|
304
|
+
*/
|
|
305
|
+
async resolveDerivationIdentity(request) {
|
|
306
|
+
const resolvedTarget = await this.resolveTarget(request);
|
|
307
|
+
const cacheKey = buildDerivationCacheKey(resolvedTarget);
|
|
308
|
+
if (cacheKey === null)
|
|
309
|
+
return null;
|
|
310
|
+
return { cacheKey, behavior: resolvedTarget.behavior, serviceKey: resolvedTarget.serviceKey };
|
|
311
|
+
}
|
|
312
|
+
/**
|
|
313
|
+
* Drop every compiled derivation.
|
|
314
|
+
*
|
|
315
|
+
* Costs a recompilation and changes no answer — the property that makes this state per-run runtime
|
|
316
|
+
* state rather than a second source of truth. Kept on this service because it is the door every
|
|
317
|
+
* consumer already holds; the state itself lives one layer down.
|
|
318
|
+
*/
|
|
319
|
+
clearDerivationCache() {
|
|
320
|
+
this.derivationState.clear();
|
|
321
|
+
}
|
|
322
|
+
async deriveThroughQueue(resolvedTarget) {
|
|
102
323
|
return this.enqueue(async () => {
|
|
103
|
-
const resolvedTarget = await this.resolveTarget(request);
|
|
104
324
|
this.logDebug('Executing companion introspection request', {
|
|
105
325
|
serviceKey: resolvedTarget.serviceKey,
|
|
106
326
|
behavior: resolvedTarget.behavior,
|
|
@@ -372,12 +592,40 @@ let CompanionIntrospectionService = class CompanionIntrospectionService {
|
|
|
372
592
|
finalize(parsedResult);
|
|
373
593
|
return;
|
|
374
594
|
}
|
|
375
|
-
|
|
376
|
-
|
|
377
|
-
|
|
378
|
-
|
|
379
|
-
|
|
380
|
-
|
|
595
|
+
/*
|
|
596
|
+
* A signal THIS SERVICE DID NOT SEND means the kill came from outside, and saying so is the
|
|
597
|
+
* difference between an actionable message and a misleading one.
|
|
598
|
+
*
|
|
599
|
+
* Every termination this service performs goes through `requestTermination`, which sets
|
|
600
|
+
* `pendingFailure` BEFORE killing — and the branch above returns that failure. So reaching
|
|
601
|
+
* here with a termination signal proves nobody here asked for it: the child died because its
|
|
602
|
+
* PARENT did, taking the process group with it.
|
|
603
|
+
*
|
|
604
|
+
* In a dev loop that is the supervisor restarting the companion. Measured 2026-09-02 across
|
|
605
|
+
* four session logs: 30 such failures at a median of 11.4 s — nowhere near the 30 s ceiling —
|
|
606
|
+
* and the line immediately preceding each one is
|
|
607
|
+
* `[runtime-supervisor:wildo-dev-companion] Stopping runtime before readiness...`.
|
|
608
|
+
*
|
|
609
|
+
* The old message named the subprocess as the thing that exited, which is true and useless:
|
|
610
|
+
* it reads as a fault in the derivation, and `signal=SIGTERM` beside a 30 s timeout constant
|
|
611
|
+
* reads as that timeout firing. It cost a full investigation before the log said otherwise.
|
|
612
|
+
*/
|
|
613
|
+
const terminatedFromOutside = wasTerminatedFromOutside({
|
|
614
|
+
signal,
|
|
615
|
+
hasPendingFailure: pendingFailure !== null,
|
|
616
|
+
hasParsedResult: parsedResult !== null,
|
|
617
|
+
});
|
|
618
|
+
finalize(this.buildFailureResult(target, startedAt, terminatedFromOutside
|
|
619
|
+
? {
|
|
620
|
+
message: `Companion introspection was terminated by ${signal} that this service did not send — the companion process itself is stopping, so the derivation was cut short rather than failing. Re-run it once the companion is ready.`,
|
|
621
|
+
name: 'CompanionIntrospectionParentTerminatedError',
|
|
622
|
+
}
|
|
623
|
+
: {
|
|
624
|
+
message: parsedResult === null
|
|
625
|
+
? `Companion introspection subprocess exited before returning a result (code=${code ?? 'null'}, signal=${signal ?? 'null'})${outputContext ? ` — ${describeOutputContext(outputContext)}` : ''}.`
|
|
626
|
+
: `Companion introspection subprocess returned a result then exited unsuccessfully (code=${code ?? 'null'}, signal=${signal ?? 'null'}).`,
|
|
627
|
+
name: 'CompanionIntrospectionSubprocessExitError',
|
|
628
|
+
}));
|
|
381
629
|
};
|
|
382
630
|
const timeoutHandle = setTimeout(() => {
|
|
383
631
|
requestTermination(this.buildFailureResult(target, startedAt, {
|
|
@@ -497,7 +745,9 @@ CompanionIntrospectionService = __decorate([
|
|
|
497
745
|
__param(0, inject(SAAS_SERVICE_TYPES.Logger)),
|
|
498
746
|
__param(1, inject(COMPANION_SERVICE_TYPES.CompanionContext)),
|
|
499
747
|
__param(2, inject(COMPANION_SERVICE_TYPES.IntrospectionBehaviorRegistryService)),
|
|
500
|
-
|
|
748
|
+
__param(3, inject(COMPANION_SERVICE_TYPES.IntrospectionDerivationStateService)),
|
|
749
|
+
__metadata("design:paramtypes", [Function, Object, CompanionIntrospectionBehaviorRegistryService,
|
|
750
|
+
IntrospectionDerivationStateCompanionService])
|
|
501
751
|
], CompanionIntrospectionService);
|
|
502
752
|
export { CompanionIntrospectionService };
|
|
503
753
|
//# sourceMappingURL=companion-introspection.companion.service.js.map
|
package/dist/esm/core/introspection/services/companion-introspection.companion.service.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"companion-introspection.companion.service.js","sourceRoot":"","sources":["../../../../../../src/core/introspection/services/companion-introspection.companion.service.ts"],"names":[],"mappings":"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","sourcesContent":["import { spawn } from 'node:child_process';\nimport { join, resolve } from 'node:path';\nimport { fileURLToPath } from 'node:url';\nimport { inject, injectable } from 'inversify';\nimport type { LoggerService } from '@wildo-ai/saas-backend-lib';\nimport { SAAS_SERVICE_TYPES } from '@wildo-ai/saas-backend-lib';\nimport { AppLibraryType, resolvePackageCompanionEntryPath } from '@wildo-ai/platform-config-lib';\nimport { CompanionIntrospectionResultSchema } from '../../../companion-api/companion-api.schemas';\nimport type { CompanionContext } from '../../context/companion-context';\nimport { CompanionIntrospectionBehaviorRegistryService } from './companion-introspection-behavior-registry.companion.service';\nimport type {\n CompanionIntrospectionChildRequest,\n CompanionIntrospectionErrorDetails,\n CompanionIntrospectionFailureResult,\n CompanionIntrospectionHomesSnapshot,\n CompanionIntrospectionRequest,\n CompanionIntrospectionResolvedPackageTarget,\n CompanionIntrospectionResolvedTarget,\n CompanionIntrospectionResult,\n CompanionIntrospectionRouteTargetId,\n CompanionIntrospectionServiceKind,\n} from '../models/companion-introspection.models';\nimport { COMPANION_SERVICE_TYPES } from '../../inject/models/service-types';\n\nconst DEFAULT_MAX_CONCURRENCY = 4;\nconst DEFAULT_TIMEOUT_MS = 30_000;\n\n/**\n * Env-var namespaces stripped from the spawned introspection child's\n * environment so pre-bootstrap reads surface `undefined` instead of inheriting\n * stale values from the parent shell.\n *\n * The trusted homes snapshot is delivered through the IPC handshake and\n * reapplied by `applyTrustedHomesToChildProcess()` as the first action of\n * `handleChildProcessMessage()`. Any code that happens to read these env\n * vars during the narrow window BEFORE that handler runs (for example while\n * `reflect-metadata` is loading) would otherwise see whatever the parent\n * shell had set — including stale values from a previous companion run or\n * from the operator's shell — which would reintroduce the Phase 5\n * \"env-over-context\" class of regression at the subprocess boundary.\n *\n * `WILDO_COMPANION_INTROSPECTION_CHILD` is the intentional child-mode flag\n * and is re-injected fresh for every spawn.\n */\nexport const SCRUBBED_CHILD_ENV_NAMES = [\n 'COMPANION_WORKSPACE_ROOT',\n 'COMPANION_RUNTIME_HOME',\n 'COMPANION_PACKAGE_ROOT',\n 'COMPANION_FRAMEWORK_ROOT',\n 'WILDO_COMPANION_INTROSPECTION_CHILD',\n] as const;\n\n/**\n * Build the `env` object handed to the spawned introspection child process.\n *\n * Responsibilities:\n *\n * 1. Inherit the caller's `process.env` as a base, so the child still sees\n * normal environment (`PATH`, `NODE_OPTIONS`, node-debug flags, etc.).\n * 2. Scrub every `COMPANION_*` bootstrap seed that\n * `applyTrustedHomesToChildProcess()` owns on the child side. Leaving\n * them in place would let `reflect-metadata` (or anything else imported\n * before the first IPC message arrives) read a stale value from the\n * parent shell — the exact Phase 5 \"env-over-context\" regression class\n * this slice was introduced to close.\n * 3. Drop any pre-existing `WILDO_COMPANION_INTROSPECTION_CHILD` so it\n * cannot survive from a parent that was itself a child in a nested\n * spawn, then re-inject it as the exact string `'1'`. The child's\n * `shouldRegisterChildMessageHandler()` gate only accepts `'1'`, so\n * this is also the enforcement point that keeps the flag's contract\n * single-sourced here.\n *\n * Exported purely for unit testing; production code reaches it through\n * `this.runSubprocess(...)` in `CompanionIntrospectionService`.\n */\nexport function buildSubprocessEnv(): NodeJS.ProcessEnv {\n const scrubbed: NodeJS.ProcessEnv = { ...process.env };\n for (const key of SCRUBBED_CHILD_ENV_NAMES) {\n delete scrubbed[key];\n }\n scrubbed.WILDO_COMPANION_INTROSPECTION_CHILD = '1';\n return scrubbed;\n}\n\n@injectable()\nexport class CompanionIntrospectionService {\n private readonly logDebug: (message: string, context?: Record<string, unknown>) => void;\n private readonly maxConcurrency: number;\n private readonly timeoutMs: number;\n private activeCount = 0;\n private readonly queue: Array<() => void> = [];\n /** Test seam only; production always retains Node's real child-process spawn. */\n private spawnSubprocess: typeof spawn = spawn;\n\n constructor(\n @inject(SAAS_SERVICE_TYPES.Logger) private readonly logger: LoggerService,\n @inject(COMPANION_SERVICE_TYPES.CompanionContext) private readonly companionContext: CompanionContext,\n @inject(COMPANION_SERVICE_TYPES.IntrospectionBehaviorRegistryService)\n private readonly behaviorRegistryService: CompanionIntrospectionBehaviorRegistryService,\n ) {\n this.logDebug = this.logger.debugByType('CompanionIntrospectionService');\n this.logger.setDebugTypeLogging('CompanionIntrospectionService', true);\n this.maxConcurrency = Math.max(\n 1,\n Number.parseInt(process.env.COMPANION_INTROSPECTION_MAX_CONCURRENCY ?? '', 10)\n || DEFAULT_MAX_CONCURRENCY,\n );\n this.timeoutMs = Math.max(\n 1_000,\n Number.parseInt(process.env.COMPANION_INTROSPECTION_TIMEOUT_MS ?? '', 10)\n || DEFAULT_TIMEOUT_MS,\n );\n }\n\n public async requestInfo(request: CompanionIntrospectionRequest): Promise<CompanionIntrospectionResult> {\n return this.enqueue(async () => {\n const resolvedTarget = await this.resolveTarget(request);\n this.logDebug('Executing companion introspection request', {\n serviceKey: resolvedTarget.serviceKey,\n behavior: resolvedTarget.behavior,\n targetId: resolvedTarget.targetId,\n entryPath: resolvedTarget.entryPath,\n });\n\n return this.runSubprocess(resolvedTarget);\n });\n }\n\n private async enqueue<T>(task: () => Promise<T>): Promise<T> {\n if (this.activeCount < this.maxConcurrency) {\n return this.runQueuedTask(task);\n }\n\n return new Promise<T>((resolvePromise, rejectPromise) => {\n this.queue.push(() => {\n void this.runQueuedTask(task).then(resolvePromise, rejectPromise);\n });\n });\n }\n\n private async runQueuedTask<T>(task: () => Promise<T>): Promise<T> {\n this.activeCount += 1;\n\n try {\n return await task();\n } finally {\n this.activeCount -= 1;\n const nextTask = this.queue.shift();\n if (nextTask) {\n nextTask();\n }\n }\n }\n\n private async resolveTarget(\n request: CompanionIntrospectionRequest,\n ): Promise<CompanionIntrospectionResolvedTarget> {\n const serviceDefinition = this.companionContext.servicesByKey[request.serviceKey];\n if (!serviceDefinition) {\n throw new Error(`Unknown SaaS service key \"${request.serviceKey}\".`);\n }\n\n const serviceKind = this.resolveServiceKind(serviceDefinition);\n const resolvedBehavior = this.behaviorRegistryService.resolveBehaviorForServiceKind(\n request.behavior,\n serviceKind,\n );\n\n const resolvedTargets = this.resolveCompanionTargets(serviceDefinition);\n const missingTargets = [resolvedBehavior.route.target, ...(resolvedBehavior.route.requiredTargets ?? [])]\n .filter((targetId, index, allTargetIds) => allTargetIds.indexOf(targetId) === index)\n .filter((targetId) => !resolvedTargets[targetId]);\n if (missingTargets.length > 0) {\n throw new Error(\n `Behavior \"${request.behavior}\" requires config-declared target(s) ${missingTargets.map((targetId) => `\"${targetId}\"`).join(', ')}, but they are not declared or resolvable for service \"${request.serviceKey}\".`,\n );\n }\n const behaviorTarget = resolvedTargets[resolvedBehavior.route.target]!;\n\n const servicePath = resolve(this.companionContext.saasRoot, serviceDefinition.path);\n\n return {\n serviceKey: request.serviceKey,\n servicePath,\n serviceName: serviceDefinition.serviceName,\n serviceKind,\n behavior: request.behavior,\n behaviorCategory: resolvedBehavior.category,\n materializationKind: resolvedBehavior.execution.materializationKind,\n targetId: resolvedBehavior.route.target,\n packageRoot: behaviorTarget.packageRoot,\n entryPath: behaviorTarget.entryPath,\n resolvedTargets,\n resolvedBehavior,\n input: request.input,\n };\n }\n\n private resolveServiceKind(\n serviceDefinition: CompanionContext['servicesByKey'][string],\n ): CompanionIntrospectionServiceKind {\n return serviceDefinition.frontendType ? 'frontend' : 'backend';\n }\n\n private async runSubprocess(\n target: CompanionIntrospectionResolvedTarget,\n ): Promise<CompanionIntrospectionResult> {\n const childRequest = this.buildChildRequest(target);\n const launchContext = this.resolveSubprocessLaunchContext();\n\n return new Promise<CompanionIntrospectionResult>((resolvePromise) => {\n const startedAt = Date.now();\n const child = this.spawnSubprocess(process.execPath, [\n /*\n * Silence tsx's own deprecation warning at the SOURCE.\n *\n * `tsx` registers its ESM hooks through `module.register()`, which Node 26 deprecates\n * (DEP0205). The warning is emitted by a dependency on every single introspection call, it\n * says nothing about this application, and there is nothing an application developer can do\n * about it — but it lands in the child's stderr, which is buffered and logged, so it\n * DOMINATED the one place a reader looks to find out what an introspection actually did.\n *\n * Suppressed here rather than filtered out of the log: a warning that is never emitted cannot\n * be mistaken for output, and filtering would leave the next reader wondering whether the\n * filter is hiding something real. Scoped to this ONE code, so a genuine future deprecation\n * still surfaces.\n */\n '--disable-warning=DEP0205',\n '--import',\n 'tsx',\n '--import',\n launchContext.assetNoopRegisterPath,\n launchContext.runnerPath,\n ], {\n cwd: launchContext.cwd,\n env: buildSubprocessEnv(),\n stdio: ['ignore', 'pipe', 'pipe', 'ipc'],\n });\n\n let stdout = '';\n let stderr = '';\n let settled = false;\n let parsedResult: CompanionIntrospectionResult | null = null;\n let pendingFailure: CompanionIntrospectionFailureResult | null = null;\n let naturalExitHandle: NodeJS.Timeout | null = null;\n let forceKillHandle: NodeJS.Timeout | null = null;\n\n /*\n * The child's output, as TWO named fields rather than one ` | `-joined blob.\n *\n * The blob was unreadable in practice: a routine success printed one useful line of stdout\n * glued to a multi-line third-party deprecation warning, and a reader could not tell at a\n * glance whether an introspection had worked, what it had found, or whether the stderr meant\n * anything. Stdout and stderr answer different questions — what it DID versus what went WRONG —\n * and joining them makes the log answer neither.\n */\n const buildOutputContext = (): { stdout?: string; stderr?: string } | undefined => {\n const trimmedStdout = stdout.trim();\n const trimmedStderr = stderr.trim();\n if (trimmedStdout.length === 0 && trimmedStderr.length === 0) return undefined;\n return {\n ...(trimmedStdout.length > 0 ? { stdout: trimmedStdout } : {}),\n ...(trimmedStderr.length > 0 ? { stderr: trimmedStderr } : {}),\n };\n };\n\n /** One line for a message that has no room for two fields. */\n const describeOutputContext = (context: { stdout?: string; stderr?: string } | undefined): string =>\n context === undefined\n ? ''\n : [\n ...(context.stdout ? [`stdout: ${context.stdout}`] : []),\n ...(context.stderr ? [`stderr: ${context.stderr}`] : []),\n ].join(' | ');\n\n const onStdout = (chunk: Buffer | string) => {\n stdout += chunk.toString();\n };\n const onStderr = (chunk: Buffer | string) => {\n stderr += chunk.toString();\n };\n child.stdout?.on('data', onStdout);\n child.stderr?.on('data', onStderr);\n\n const clearTimer = (handle: NodeJS.Timeout | null): void => {\n if (handle !== null) clearTimeout(handle);\n };\n\n const cleanup = () => {\n clearTimeout(timeoutHandle);\n clearTimer(naturalExitHandle);\n clearTimer(forceKillHandle);\n child.off('spawn', onSpawn);\n child.off('message', onMessage);\n child.off('error', onError);\n child.off('close', onClose);\n child.stdout?.off('data', onStdout);\n child.stderr?.off('data', onStderr);\n };\n\n const finalize = (result: CompanionIntrospectionResult) => {\n if (settled) {\n return;\n }\n\n settled = true;\n cleanup();\n const finalResult = {\n ...result,\n stdout: stdout || undefined,\n stderr: stderr || undefined,\n };\n resolvePromise(finalResult);\n };\n\n const requestTermination = (failure: CompanionIntrospectionFailureResult): void => {\n if (pendingFailure === null) pendingFailure = failure;\n clearTimeout(timeoutHandle);\n clearTimer(naturalExitHandle);\n naturalExitHandle = null;\n if (forceKillHandle !== null) return;\n try {\n child.kill('SIGTERM');\n } catch {\n // A concurrent exit can make kill throw; settlement still waits for\n // the terminal `close` event rather than guessing process state.\n }\n forceKillHandle = setTimeout(() => {\n try {\n child.kill('SIGKILL');\n } catch {\n // The terminal `close` event remains the only settlement signal.\n }\n }, 1_000);\n };\n\n const onSpawn = () => {\n child.send?.(childRequest);\n };\n\n const onMessage = (message: unknown) => {\n clearTimeout(timeoutHandle);\n if (pendingFailure !== null) return;\n if (parsedResult !== null) {\n requestTermination(this.buildFailureResult(target, startedAt, {\n message: 'Companion introspection subprocess returned more than one result payload.',\n name: 'CompanionIntrospectionDuplicateResultError',\n }));\n return;\n }\n try {\n parsedResult = CompanionIntrospectionResultSchema.parse(message) as CompanionIntrospectionResult;\n // A valid payload is provisional until the child proves that no late\n // failure occurred. Give the normal child one bounded window to\n // disconnect and exit cleanly before beginning termination.\n naturalExitHandle = setTimeout(() => {\n requestTermination(this.buildFailureResult(target, startedAt, {\n message: 'Companion introspection subprocess returned a result but did not exit cleanly within 1000ms.',\n name: 'CompanionIntrospectionResultExitTimeoutError',\n }));\n }, 1_000);\n } catch (error) {\n // describeCaughtError: N/A — this `try` wraps exactly one statement,\n // `CompanionIntrospectionResultSchema.parse(message)`, which throws a `ZodError`.\n // No engine service is called inside it, so a `WildoError_Backend` (a plain\n // object, which the test below would reject) cannot reach here. The site also\n // needs `.name` and `.stack`, which the string helper does not carry. Left as-is\n // deliberately, not overlooked by the 2026-08-21 sweep.\n const standardError = error instanceof Error ? error : new Error('Invalid companion introspection subprocess payload.');\n requestTermination(this.buildFailureResult(target, startedAt, {\n message: standardError.message,\n name: standardError.name,\n stack: standardError.stack,\n }));\n }\n };\n\n const onError = (error: Error) => {\n requestTermination(this.buildFailureResult(target, startedAt, {\n message: error.message,\n name: error.name,\n stack: error.stack,\n }));\n };\n\n const onClose = (code: number | null, signal: NodeJS.Signals | null) => {\n if (settled) return;\n const outputContext = buildOutputContext();\n if (outputContext) {\n /*\n * Named for what the reader wants to know — WHICH introspection, and whether it went\n * cleanly — rather than for the mechanism. \"exited with buffered output\" described the\n * plumbing and left the behavior buried in a field.\n */\n const cleanExit = code === 0 && signal === null;\n this.logDebug(\n `Companion introspection \"${target.behavior}\" on \"${target.serviceKey}\" ${cleanExit ? 'completed' : `exited code=${code ?? 'null'} signal=${signal ?? 'null'}`}`,\n {\n serviceKey: target.serviceKey,\n behavior: target.behavior,\n targetId: target.targetId,\n code,\n signal,\n ...outputContext,\n },\n );\n }\n if (pendingFailure !== null) {\n finalize(pendingFailure);\n return;\n }\n if (parsedResult !== null && code === 0 && signal === null) {\n finalize(parsedResult);\n return;\n }\n if (parsedResult !== null && parsedResult.success === false) {\n finalize(parsedResult);\n return;\n }\n finalize(this.buildFailureResult(target, startedAt, {\n message: parsedResult === null\n ? `Companion introspection subprocess exited before returning a result (code=${code ?? 'null'}, signal=${signal ?? 'null'})${outputContext ? ` — ${describeOutputContext(outputContext)}` : ''}.`\n : `Companion introspection subprocess returned a result then exited unsuccessfully (code=${code ?? 'null'}, signal=${signal ?? 'null'}).`,\n name: 'CompanionIntrospectionSubprocessExitError',\n }));\n };\n\n const timeoutHandle = setTimeout(() => {\n requestTermination(this.buildFailureResult(target, startedAt, {\n message: `Companion introspection timed out after ${this.timeoutMs}ms.`,\n name: 'CompanionIntrospectionTimeoutError',\n }));\n }, this.timeoutMs);\n\n child.on('spawn', onSpawn);\n child.on('message', onMessage);\n child.on('error', onError);\n // `close`, unlike `message` or `exit`, proves that the process and its\n // stdio handles are all quiescent. The parent never releases its queue\n // slot while the child can still emit output or fail late.\n child.on('close', onClose);\n });\n }\n\n private buildChildRequest(\n target: CompanionIntrospectionResolvedTarget,\n ): CompanionIntrospectionChildRequest {\n return {\n behavior: target.behavior,\n serviceKind: target.serviceKind,\n behaviorCategory: target.behaviorCategory,\n materializationKind: target.materializationKind,\n targetId: target.targetId,\n serviceKey: target.serviceKey,\n entryPath: target.entryPath,\n packageRoot: target.packageRoot,\n homes: this.buildChildHomesSnapshot(),\n resolvedTargets: target.resolvedTargets,\n input: target.input,\n };\n }\n\n /**\n * Resolve subprocess launch paths from THIS MODULE's own location, never from\n * `companionHome/src`. Under dist-only delivery (issue #64) the application's\n * `.wildo-saas/wildo-dev-companion` drop contains no source tree at all — the child runner and\n * the asset-noop register ship as COMPILED siblings of this service inside `dist/esm`, so the\n * only location that is guaranteed to hold them is the directory graph this very module runs\n * from. When the suite executes the source directly (vitest resolves the `.ts` module), the\n * sibling files are the authored `.ts` sources and the child is executable because the spawn\n * always registers `tsx` before the register hook. `cwd` stays the application's companion\n * home: the child resolves app packages and `node_modules` (including `tsx` itself) from there.\n */\n private resolveSubprocessLaunchContext(): {\n cwd: string;\n runnerPath: string;\n assetNoopRegisterPath: string;\n } {\n const isSourceExecution = import.meta.url.endsWith('.ts');\n const subprocessDir = fileURLToPath(new URL('../subprocess/', import.meta.url));\n return {\n cwd: this.companionContext.companionHome,\n runnerPath: join(subprocessDir, isSourceExecution ? 'companion-introspection-child.ts' : 'companion-introspection-child.js'),\n assetNoopRegisterPath: join(subprocessDir, isSourceExecution ? 'asset-noop-register.ts' : 'asset-noop-register.js'),\n };\n }\n\n private buildChildHomesSnapshot(): CompanionIntrospectionHomesSnapshot {\n const appLayout = this.companionContext.resolvedHomes.app.layout;\n if (!appLayout) {\n throw new Error('Companion introspection requires an app layout in the trusted homes snapshot.');\n }\n\n return {\n appDeclarationRoot: appLayout.declarationRoot,\n appRuntimeHome: appLayout.runtimeHome,\n companionHome: this.companionContext.companionHome,\n frameworkRepositoryRoot: this.companionContext.resolvedHomes.framework.repositoryRoot,\n };\n }\n\n private resolveCompanionTargets(\n serviceDefinition: CompanionContext['servicesByKey'][string],\n ): Partial<Record<CompanionIntrospectionRouteTargetId, CompanionIntrospectionResolvedPackageTarget>> {\n const sharedLibrary = this.companionContext.resolvedLibraries.shared;\n const resolvedLibraryTarget = sharedLibrary?.libraryType === AppLibraryType.FULLSTACK\n ? {\n targetId: 'library' as const,\n packageRoot: sharedLibrary.packageRoot,\n entryPath: sharedLibrary.entryPath,\n declaredPath: sharedLibrary.declaredPath,\n }\n : undefined;\n\n return {\n service: this.tryResolveCompanionTarget('service', serviceDefinition.path),\n library: resolvedLibraryTarget,\n specifications: this.companionContext.resolvedSpecifications\n ? {\n targetId: 'specifications',\n packageRoot: this.companionContext.resolvedSpecifications.packageRoot,\n entryPath: this.companionContext.resolvedSpecifications.entryPath,\n declaredPath: this.companionContext.resolvedSpecifications.declaredPath,\n }\n : undefined,\n };\n }\n\n private tryResolveCompanionTarget(\n targetId: CompanionIntrospectionRouteTargetId,\n declaredPath: string,\n ): CompanionIntrospectionResolvedPackageTarget | undefined {\n const packageRoot = resolve(this.companionContext.saasRoot, declaredPath);\n\n try {\n return {\n targetId,\n packageRoot,\n entryPath: resolvePackageCompanionEntryPath(packageRoot),\n declaredPath,\n };\n } catch {\n return undefined;\n }\n }\n\n private buildFailureResult(\n target: CompanionIntrospectionResolvedTarget,\n startedAt: number,\n error: CompanionIntrospectionErrorDetails,\n ): CompanionIntrospectionFailureResult {\n return {\n success: false,\n behavior: target.behavior,\n serviceKey: target.serviceKey,\n serviceKind: target.serviceKind,\n behaviorCategory: target.behaviorCategory,\n materializationKind: target.materializationKind,\n targetId: target.targetId,\n durationMs: Date.now() - startedAt,\n error,\n };\n }\n}\n"]}
|
|
1
|
+
{"version":3,"file":"companion-introspection.companion.service.js","sourceRoot":"","sources":["../../../../../../src/core/introspection/services/companion-introspection.companion.service.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAE/C,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,gCAAgC,EAAE,MAAM,+BAA+B,CAAC;AACjG,OAAO,EAAE,kCAAkC,EAAE,MAAM,8CAA8C,CAAC;AAElG,OAAO,EAAE,6CAA6C,EAAE,MAAM,+DAA+D,CAAC;AAC9H,OAAO,EAAE,4CAA4C,EAAE,MAAM,oDAAoD,CAAC;AAalH,OAAO,EAAE,uBAAuB,EAAE,MAAM,mCAAmC,CAAC;AAE5E,MAAM,uBAAuB,GAAG,CAAC,CAAC;AAClC,MAAM,kBAAkB,GAAG,MAAM,CAAC;AAElC;;;;;;;GAOG;AACH,MAAM,4BAA4B,GAAG,IAAI,GAAG,CAAS,CAAC,SAAS,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC;AAEtF;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,wBAAwB,CAAC,KAIxC;IACC,IAAI,KAAK,CAAC,iBAAiB,IAAI,KAAK,CAAC,eAAe;QAAE,OAAO,KAAK,CAAC;IACnE,OAAO,KAAK,CAAC,MAAM,KAAK,IAAI,IAAI,4BAA4B,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;AACjF,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,8BAA8B,GAAG,KAAK,CAAC;AAE7C;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,0BAA0B;IAC1B,wBAAwB;IACxB,wBAAwB;IACxB,0BAA0B;IAC1B,qCAAqC;CAC7B,CAAC;AAEX;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,0BAA0B,CAAC,KAAc;IACvD,MAAM,IAAI,GAAG,IAAI,OAAO,EAAU,CAAC;IAEnC,MAAM,MAAM,GAAG,CAAC,KAAc,EAAU,EAAE;QACxC,IAAI,KAAK,KAAK,SAAS;YAAE,OAAO,WAAW,CAAC;QAC5C,IAAI,KAAK,KAAK,IAAI;YAAE,OAAO,MAAM,CAAC;QAClC,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;QAC5E,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,WAAW,CAAC;QAC3E,IAAI,IAAI,CAAC,GAAG,CAAC,KAAe,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;QAClF,IAAI,CAAC,GAAG,CAAC,KAAe,CAAC,CAAC;QAC1B,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACzB,OAAO,IAAI,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;QAC5C,CAAC;QACD,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,KAAgC,CAAC;aAC7D,MAAM,CAAC,CAAC,CAAC,EAAE,UAAU,CAAC,EAAE,EAAE,CAAC,UAAU,KAAK,SAAS,CAAC;aACpD,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACzE,OAAO,IAAI,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,UAAU,CAAC,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;IAC7G,CAAC,CAAC;IAEF,IAAI,CAAC;QACH,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;;;;;;;;GAWG;AACH,SAAS,uBAAuB,CAAC,MAA4C;IAC3E,MAAM,aAAa,GAAG,0BAA0B,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC/D,IAAI,aAAa,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAExC,OAAO;QACL,MAAM,CAAC,UAAU;QACjB,MAAM,CAAC,WAAW;QAClB,MAAM,CAAC,QAAQ;QACf,MAAM,CAAC,QAAQ;QACf,MAAM,CAAC,WAAW;QAClB,MAAM,CAAC,SAAS;QAChB,aAAa;KACd,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AACnB,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,kBAAkB;IAChC,MAAM,QAAQ,GAAsB,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IACvD,KAAK,MAAM,GAAG,IAAI,wBAAwB,EAAE,CAAC;QAC3C,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC;IACvB,CAAC;IACD,QAAQ,CAAC,mCAAmC,GAAG,GAAG,CAAC;IACnD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAGM,IAAM,6BAA6B,GAAnC,MAAM,6BAA6B;IAmBc;IACe;IAElD;IAEA;IAvBF,QAAQ,CAA+D;IACvE,cAAc,CAAS;IACvB,SAAS,CAAS;IAC3B,WAAW,GAAG,CAAC,CAAC;IACP,KAAK,GAAsB,EAAE,CAAC;IAC/C,iFAAiF;IACzE,eAAe,GAAiB,KAAK,CAAC;IAC9C;;;;;;;OAOG;IACc,sBAAsB,CAAU;IAEjD,YACsD,MAAqB,EACN,gBAAkC,EAEpF,uBAAsE,EAEtE,eAA6D;QAL1B,WAAM,GAAN,MAAM,CAAe;QACN,qBAAgB,GAAhB,gBAAgB,CAAkB;QAEpF,4BAAuB,GAAvB,uBAAuB,CAA+C;QAEtE,oBAAe,GAAf,eAAe,CAA8C;QAE9E,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,+BAA+B,CAAC,CAAC;QACzE,IAAI,CAAC,MAAM,CAAC,mBAAmB,CAAC,+BAA+B,EAAE,IAAI,CAAC,CAAC;QACvE,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,GAAG,CAC5B,CAAC,EACD,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,uCAAuC,IAAI,EAAE,EAAE,EAAE,CAAC;eAC3E,uBAAuB,CAC3B,CAAC;QACF,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,CACvB,KAAK,EACL,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,kCAAkC,IAAI,EAAE,EAAE,EAAE,CAAC;eACtE,kBAAkB,CACtB,CAAC;QACF,IAAI,CAAC,sBAAsB,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,6BAA6B,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE;gBAC9F,8BAA8B,CAAC;IACvC,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACH;;;;;;;;;;;;;;OAcG;IACI,eAAe;QAUpB,MAAM,SAAS,GAAG,IAAI,CAAC,uBAAuB,CAAC,uBAAuB,EAAE,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;YAC5F,UAAU,EAAE,UAAU,CAAC,UAAU;YACjC,WAAW,EAAE,UAAU,CAAC,WAAW;YACnC,QAAQ,EAAE,UAAU,CAAC,QAAQ;YAC7B,qBAAqB,EAAE,UAAU,CAAC,qBAAqB;SACxD,CAAC,CAAC,CAAC;QACJ,MAAM,WAAW,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,gBAAgB,CAAC,aAAa,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC;YAC/F,GAAG;YACH,IAAI,EAAE,IAAI,CAAC,kBAAkB,CAAC,OAAO,CAAC;SACvC,CAAC,CAAC,CAAC;QACJ,MAAM,wBAAwB,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,KAAK,SAAS,CAAC,EAAE,GAAG,IAAI,IAAI,CAAC;QACxG,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,wBAAwB,EAAE,CAAC;IAC9D,CAAC;IAEM,KAAK,CAAC,WAAW,CAAC,OAAsC;QAC7D,MAAM,cAAc,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;QAEzD,IAAI,CAAC,IAAI,CAAC,sBAAsB,EAAE,CAAC;YACjC,OAAO,IAAI,CAAC,kBAAkB,CAAC,cAAc,CAAC,CAAC;QACjD,CAAC;QAED,MAAM,QAAQ,GAAG,uBAAuB,CAAC,cAAc,CAAC,CAAC;QACzD,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;YACtB,OAAO,IAAI,CAAC,kBAAkB,CAAC,cAAc,CAAC,CAAC;QACjD,CAAC;QAED,OAAO,IAAI,CAAC,eAAe,CAAC,IAAI,CAC9B,EAAE,QAAQ,EAAE,QAAQ,EAAE,cAAc,CAAC,QAAQ,EAAE,UAAU,EAAE,cAAc,CAAC,UAAU,EAAE,EACtF,GAAG,EAAE,CAAC,IAAI,CAAC,kBAAkB,CAAC,cAAc,CAAC,CAC9C,CAAC;IACJ,CAAC;IAED;;;;;;;;OAQG;IACI,KAAK,CAAC,UAAU,CACrB,OAAsC;QAEtC,OAAO,IAAI,CAAC,kBAAkB,CAAC,MAAM,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC;IACpE,CAAC;IAED;;;;;;OAMG;IACI,KAAK,CAAC,yBAAyB,CAAC,OAAsC;QAK3E,MAAM,cAAc,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;QACzD,MAAM,QAAQ,GAAG,uBAAuB,CAAC,cAAc,CAAC,CAAC;QACzD,IAAI,QAAQ,KAAK,IAAI;YAAE,OAAO,IAAI,CAAC;QACnC,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,cAAc,CAAC,QAAQ,EAAE,UAAU,EAAE,cAAc,CAAC,UAAU,EAAE,CAAC;IAChG,CAAC;IAED;;;;;;OAMG;IACI,oBAAoB;QACzB,IAAI,CAAC,eAAe,CAAC,KAAK,EAAE,CAAC;IAC/B,CAAC;IAEO,KAAK,CAAC,kBAAkB,CAC9B,cAAoD;QAEpD,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE;YAC7B,IAAI,CAAC,QAAQ,CAAC,2CAA2C,EAAE;gBACzD,UAAU,EAAE,cAAc,CAAC,UAAU;gBACrC,QAAQ,EAAE,cAAc,CAAC,QAAQ;gBACjC,QAAQ,EAAE,cAAc,CAAC,QAAQ;gBACjC,SAAS,EAAE,cAAc,CAAC,SAAS;aACpC,CAAC,CAAC;YAEH,OAAO,IAAI,CAAC,aAAa,CAAC,cAAc,CAAC,CAAC;QAC5C,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,KAAK,CAAC,OAAO,CAAI,IAAsB;QAC7C,IAAI,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,cAAc,EAAE,CAAC;YAC3C,OAAO,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;QAClC,CAAC;QAED,OAAO,IAAI,OAAO,CAAI,CAAC,cAAc,EAAE,aAAa,EAAE,EAAE;YACtD,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE;gBACnB,KAAK,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,cAAc,EAAE,aAAa,CAAC,CAAC;YACpE,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,KAAK,CAAC,aAAa,CAAI,IAAsB;QACnD,IAAI,CAAC,WAAW,IAAI,CAAC,CAAC;QAEtB,IAAI,CAAC;YACH,OAAO,MAAM,IAAI,EAAE,CAAC;QACtB,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,WAAW,IAAI,CAAC,CAAC;YACtB,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;YACpC,IAAI,QAAQ,EAAE,CAAC;gBACb,QAAQ,EAAE,CAAC;YACb,CAAC;QACH,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,aAAa,CACzB,OAAsC;QAEtC,MAAM,iBAAiB,GAAG,IAAI,CAAC,gBAAgB,CAAC,aAAa,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QAClF,IAAI,CAAC,iBAAiB,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CAAC,6BAA6B,OAAO,CAAC,UAAU,IAAI,CAAC,CAAC;QACvE,CAAC;QAED,MAAM,WAAW,GAAG,IAAI,CAAC,kBAAkB,CAAC,iBAAiB,CAAC,CAAC;QAC/D,MAAM,gBAAgB,GAAG,IAAI,CAAC,uBAAuB,CAAC,6BAA6B,CACjF,OAAO,CAAC,QAAQ,EAChB,WAAW,CACZ,CAAC;QAEF,MAAM,eAAe,GAAG,IAAI,CAAC,uBAAuB,CAAC,iBAAiB,CAAC,CAAC;QACxE,MAAM,cAAc,GAAG,CAAC,gBAAgB,CAAC,KAAK,CAAC,MAAM,EAAE,GAAG,CAAC,gBAAgB,CAAC,KAAK,CAAC,eAAe,IAAI,EAAE,CAAC,CAAC;aACtG,MAAM,CAAC,CAAC,QAAQ,EAAE,KAAK,EAAE,YAAY,EAAE,EAAE,CAAC,YAAY,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,KAAK,CAAC;aACnF,MAAM,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC,CAAC;QACpD,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC9B,MAAM,IAAI,KAAK,CACb,aAAa,OAAO,CAAC,QAAQ,wCAAwC,cAAc,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,IAAI,QAAQ,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,0DAA0D,OAAO,CAAC,UAAU,IAAI,CAClN,CAAC;QACJ,CAAC;QACD,MAAM,cAAc,GAAG,eAAe,CAAC,gBAAgB,CAAC,KAAK,CAAC,MAAM,CAAE,CAAC;QAEvE,MAAM,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,gBAAgB,CAAC,QAAQ,EAAE,iBAAiB,CAAC,IAAI,CAAC,CAAC;QAEpF,OAAO;YACL,UAAU,EAAE,OAAO,CAAC,UAAU;YAC9B,WAAW;YACX,WAAW,EAAE,iBAAiB,CAAC,WAAW;YAC1C,WAAW;YACX,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,gBAAgB,EAAE,gBAAgB,CAAC,QAAQ;YAC3C,mBAAmB,EAAE,gBAAgB,CAAC,SAAS,CAAC,mBAAmB;YACnE,QAAQ,EAAE,gBAAgB,CAAC,KAAK,CAAC,MAAM;YACvC,WAAW,EAAE,cAAc,CAAC,WAAW;YACvC,SAAS,EAAE,cAAc,CAAC,SAAS;YACnC,eAAe;YACf,gBAAgB;YAChB,KAAK,EAAE,OAAO,CAAC,KAAK;SACrB,CAAC;IACJ,CAAC;IAEO,kBAAkB,CACxB,iBAA4D;QAE5D,OAAO,iBAAiB,CAAC,YAAY,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC;IACjE,CAAC;IAEO,KAAK,CAAC,aAAa,CACzB,MAA4C;QAE5C,MAAM,YAAY,GAAG,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC;QACpD,MAAM,aAAa,GAAG,IAAI,CAAC,8BAA8B,EAAE,CAAC;QAE5D,OAAO,IAAI,OAAO,CAA+B,CAAC,cAAc,EAAE,EAAE;YAClE,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAC7B,MAAM,KAAK,GAAG,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,QAAQ,EAAE;gBACnD;;;;;;;;;;;;;mBAaG;gBACH,2BAA2B;gBAC3B,UAAU;gBACV,KAAK;gBACL,UAAU;gBACV,aAAa,CAAC,qBAAqB;gBACnC,aAAa,CAAC,UAAU;aACzB,EAAE;gBACD,GAAG,EAAE,aAAa,CAAC,GAAG;gBACtB,GAAG,EAAE,kBAAkB,EAAE;gBACzB,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC;aACzC,CAAC,CAAC;YAEH,IAAI,MAAM,GAAG,EAAE,CAAC;YAChB,IAAI,MAAM,GAAG,EAAE,CAAC;YAChB,IAAI,OAAO,GAAG,KAAK,CAAC;YACpB,IAAI,YAAY,GAAwC,IAAI,CAAC;YAC7D,IAAI,cAAc,GAA+C,IAAI,CAAC;YACtE,IAAI,iBAAiB,GAA0B,IAAI,CAAC;YACpD,IAAI,eAAe,GAA0B,IAAI,CAAC;YAElD;;;;;;;;eAQG;YACH,MAAM,kBAAkB,GAAG,GAAqD,EAAE;gBAChF,MAAM,aAAa,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;gBACpC,MAAM,aAAa,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;gBACpC,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC;oBAAE,OAAO,SAAS,CAAC;gBAC/E,OAAO;oBACL,GAAG,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBAC9D,GAAG,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBAC/D,CAAC;YACJ,CAAC,CAAC;YAEF,8DAA8D;YAC9D,MAAM,qBAAqB,GAAG,CAAC,OAAyD,EAAU,EAAE,CAClG,OAAO,KAAK,SAAS;gBACnB,CAAC,CAAC,EAAE;gBACJ,CAAC,CAAC;oBACA,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;oBACxD,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;iBACzD,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAElB,MAAM,QAAQ,GAAG,CAAC,KAAsB,EAAE,EAAE;gBAC1C,MAAM,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;YAC7B,CAAC,CAAC;YACF,MAAM,QAAQ,GAAG,CAAC,KAAsB,EAAE,EAAE;gBAC1C,MAAM,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;YAC7B,CAAC,CAAC;YACF,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;YACnC,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;YAEnC,MAAM,UAAU,GAAG,CAAC,MAA6B,EAAQ,EAAE;gBACzD,IAAI,MAAM,KAAK,IAAI;oBAAE,YAAY,CAAC,MAAM,CAAC,CAAC;YAC5C,CAAC,CAAC;YAEF,MAAM,OAAO,GAAG,GAAG,EAAE;gBACnB,YAAY,CAAC,aAAa,CAAC,CAAC;gBAC5B,UAAU,CAAC,iBAAiB,CAAC,CAAC;gBAC9B,UAAU,CAAC,eAAe,CAAC,CAAC;gBAC5B,KAAK,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;gBAC5B,KAAK,CAAC,GAAG,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;gBAChC,KAAK,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;gBAC5B,KAAK,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;gBAC5B,KAAK,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;gBACpC,KAAK,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;YACtC,CAAC,CAAC;YAEF,MAAM,QAAQ,GAAG,CAAC,MAAoC,EAAE,EAAE;gBACxD,IAAI,OAAO,EAAE,CAAC;oBACZ,OAAO;gBACT,CAAC;gBAED,OAAO,GAAG,IAAI,CAAC;gBACf,OAAO,EAAE,CAAC;gBACV,MAAM,WAAW,GAAG;oBAClB,GAAG,MAAM;oBACT,MAAM,EAAE,MAAM,IAAI,SAAS;oBAC3B,MAAM,EAAE,MAAM,IAAI,SAAS;iBAC5B,CAAC;gBACF,cAAc,CAAC,WAAW,CAAC,CAAC;YAC9B,CAAC,CAAC;YAEF,MAAM,kBAAkB,GAAG,CAAC,OAA4C,EAAQ,EAAE;gBAChF,IAAI,cAAc,KAAK,IAAI;oBAAE,cAAc,GAAG,OAAO,CAAC;gBACtD,YAAY,CAAC,aAAa,CAAC,CAAC;gBAC5B,UAAU,CAAC,iBAAiB,CAAC,CAAC;gBAC9B,iBAAiB,GAAG,IAAI,CAAC;gBACzB,IAAI,eAAe,KAAK,IAAI;oBAAE,OAAO;gBACrC,IAAI,CAAC;oBACH,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;gBACxB,CAAC;gBAAC,MAAM,CAAC;oBACP,oEAAoE;oBACpE,iEAAiE;gBACnE,CAAC;gBACD,eAAe,GAAG,UAAU,CAAC,GAAG,EAAE;oBAChC,IAAI,CAAC;wBACH,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;oBACxB,CAAC;oBAAC,MAAM,CAAC;wBACP,iEAAiE;oBACnE,CAAC;gBACH,CAAC,EAAE,KAAK,CAAC,CAAC;YACZ,CAAC,CAAC;YAEF,MAAM,OAAO,GAAG,GAAG,EAAE;gBACnB,KAAK,CAAC,IAAI,EAAE,CAAC,YAAY,CAAC,CAAC;YAC7B,CAAC,CAAC;YAEF,MAAM,SAAS,GAAG,CAAC,OAAgB,EAAE,EAAE;gBACrC,YAAY,CAAC,aAAa,CAAC,CAAC;gBAC5B,IAAI,cAAc,KAAK,IAAI;oBAAE,OAAO;gBACpC,IAAI,YAAY,KAAK,IAAI,EAAE,CAAC;oBAC1B,kBAAkB,CAAC,IAAI,CAAC,kBAAkB,CAAC,MAAM,EAAE,SAAS,EAAE;wBAC5D,OAAO,EAAE,2EAA2E;wBACpF,IAAI,EAAE,4CAA4C;qBACnD,CAAC,CAAC,CAAC;oBACJ,OAAO;gBACT,CAAC;gBACD,IAAI,CAAC;oBACH,YAAY,GAAG,kCAAkC,CAAC,KAAK,CAAC,OAAO,CAAiC,CAAC;oBACjG,qEAAqE;oBACrE,gEAAgE;oBAChE,4DAA4D;oBAC5D,iBAAiB,GAAG,UAAU,CAAC,GAAG,EAAE;wBAClC,kBAAkB,CAAC,IAAI,CAAC,kBAAkB,CAAC,MAAM,EAAE,SAAS,EAAE;4BAC5D,OAAO,EAAE,8FAA8F;4BACvG,IAAI,EAAE,8CAA8C;yBACrD,CAAC,CAAC,CAAC;oBACN,CAAC,EAAE,KAAK,CAAC,CAAC;gBACZ,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,qEAAqE;oBACrE,kFAAkF;oBAClF,4EAA4E;oBAC5E,8EAA8E;oBAC9E,iFAAiF;oBACjF,wDAAwD;oBACxD,MAAM,aAAa,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;oBACxH,kBAAkB,CAAC,IAAI,CAAC,kBAAkB,CAAC,MAAM,EAAE,SAAS,EAAE;wBAC5D,OAAO,EAAE,aAAa,CAAC,OAAO;wBAC9B,IAAI,EAAE,aAAa,CAAC,IAAI;wBACxB,KAAK,EAAE,aAAa,CAAC,KAAK;qBAC3B,CAAC,CAAC,CAAC;gBACN,CAAC;YACH,CAAC,CAAC;YAEF,MAAM,OAAO,GAAG,CAAC,KAAY,EAAE,EAAE;gBAC/B,kBAAkB,CAAC,IAAI,CAAC,kBAAkB,CAAC,MAAM,EAAE,SAAS,EAAE;oBAC5D,OAAO,EAAE,KAAK,CAAC,OAAO;oBACtB,IAAI,EAAE,KAAK,CAAC,IAAI;oBAChB,KAAK,EAAE,KAAK,CAAC,KAAK;iBACnB,CAAC,CAAC,CAAC;YACN,CAAC,CAAC;YAEF,MAAM,OAAO,GAAG,CAAC,IAAmB,EAAE,MAA6B,EAAE,EAAE;gBACrE,IAAI,OAAO;oBAAE,OAAO;gBACpB,MAAM,aAAa,GAAG,kBAAkB,EAAE,CAAC;gBAC3C,IAAI,aAAa,EAAE,CAAC;oBAClB;;;;uBAIG;oBACH,MAAM,SAAS,GAAG,IAAI,KAAK,CAAC,IAAI,MAAM,KAAK,IAAI,CAAC;oBAChD,IAAI,CAAC,QAAQ,CACX,4BAA4B,MAAM,CAAC,QAAQ,SAAS,MAAM,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,eAAe,IAAI,IAAI,MAAM,WAAW,MAAM,IAAI,MAAM,EAAE,EAAE,EAChK;wBACE,UAAU,EAAE,MAAM,CAAC,UAAU;wBAC7B,QAAQ,EAAE,MAAM,CAAC,QAAQ;wBACzB,QAAQ,EAAE,MAAM,CAAC,QAAQ;wBACzB,IAAI;wBACJ,MAAM;wBACN,GAAG,aAAa;qBACjB,CACF,CAAC;gBACJ,CAAC;gBACD,IAAI,cAAc,KAAK,IAAI,EAAE,CAAC;oBAC5B,QAAQ,CAAC,cAAc,CAAC,CAAC;oBACzB,OAAO;gBACT,CAAC;gBACD,IAAI,YAAY,KAAK,IAAI,IAAI,IAAI,KAAK,CAAC,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;oBAC3D,QAAQ,CAAC,YAAY,CAAC,CAAC;oBACvB,OAAO;gBACT,CAAC;gBACD,IAAI,YAAY,KAAK,IAAI,IAAI,YAAY,CAAC,OAAO,KAAK,KAAK,EAAE,CAAC;oBAC5D,QAAQ,CAAC,YAAY,CAAC,CAAC;oBACvB,OAAO;gBACT,CAAC;gBACD;;;;;;;;;;;;;;;;;mBAiBG;gBACH,MAAM,qBAAqB,GAAG,wBAAwB,CAAC;oBACrD,MAAM;oBACN,iBAAiB,EAAE,cAAc,KAAK,IAAI;oBAC1C,eAAe,EAAE,YAAY,KAAK,IAAI;iBACvC,CAAC,CAAC;gBAEH,QAAQ,CAAC,IAAI,CAAC,kBAAkB,CAAC,MAAM,EAAE,SAAS,EAAE,qBAAqB;oBACvE,CAAC,CAAC;wBACA,OAAO,EAAE,6CAA6C,MAAM,yKAAyK;wBACrO,IAAI,EAAE,6CAA6C;qBACpD;oBACD,CAAC,CAAC;wBACA,OAAO,EAAE,YAAY,KAAK,IAAI;4BAC5B,CAAC,CAAC,6EAA6E,IAAI,IAAI,MAAM,YAAY,MAAM,IAAI,MAAM,IAAI,aAAa,CAAC,CAAC,CAAC,MAAM,qBAAqB,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG;4BACjM,CAAC,CAAC,yFAAyF,IAAI,IAAI,MAAM,YAAY,MAAM,IAAI,MAAM,IAAI;wBAC3I,IAAI,EAAE,2CAA2C;qBAClD,CAAC,CAAC,CAAC;YACR,CAAC,CAAC;YAEF,MAAM,aAAa,GAAG,UAAU,CAAC,GAAG,EAAE;gBACpC,kBAAkB,CAAC,IAAI,CAAC,kBAAkB,CAAC,MAAM,EAAE,SAAS,EAAE;oBAC5D,OAAO,EAAE,2CAA2C,IAAI,CAAC,SAAS,KAAK;oBACvE,IAAI,EAAE,oCAAoC;iBAC3C,CAAC,CAAC,CAAC;YACN,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;YAEnB,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAC3B,KAAK,CAAC,EAAE,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;YAC/B,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAC3B,uEAAuE;YACvE,uEAAuE;YACvE,2DAA2D;YAC3D,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAC7B,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,iBAAiB,CACvB,MAA4C;QAE5C,OAAO;YACL,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,gBAAgB,EAAE,MAAM,CAAC,gBAAgB;YACzC,mBAAmB,EAAE,MAAM,CAAC,mBAAmB;YAC/C,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,KAAK,EAAE,IAAI,CAAC,uBAAuB,EAAE;YACrC,eAAe,EAAE,MAAM,CAAC,eAAe;YACvC,KAAK,EAAE,MAAM,CAAC,KAAK;SACpB,CAAC;IACJ,CAAC;IAED;;;;;;;;;;OAUG;IACK,8BAA8B;QAKpC,MAAM,iBAAiB,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QAC1D,MAAM,aAAa,GAAG,aAAa,CAAC,IAAI,GAAG,CAAC,gBAAgB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QAChF,OAAO;YACL,GAAG,EAAE,IAAI,CAAC,gBAAgB,CAAC,aAAa;YACxC,UAAU,EAAE,IAAI,CAAC,aAAa,EAAE,iBAAiB,CAAC,CAAC,CAAC,kCAAkC,CAAC,CAAC,CAAC,kCAAkC,CAAC;YAC5H,qBAAqB,EAAE,IAAI,CAAC,aAAa,EAAE,iBAAiB,CAAC,CAAC,CAAC,wBAAwB,CAAC,CAAC,CAAC,wBAAwB,CAAC;SACpH,CAAC;IACJ,CAAC;IAEO,uBAAuB;QAC7B,MAAM,SAAS,GAAG,IAAI,CAAC,gBAAgB,CAAC,aAAa,CAAC,GAAG,CAAC,MAAM,CAAC;QACjE,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,+EAA+E,CAAC,CAAC;QACnG,CAAC;QAED,OAAO;YACL,kBAAkB,EAAE,SAAS,CAAC,eAAe;YAC7C,cAAc,EAAE,SAAS,CAAC,WAAW;YACrC,aAAa,EAAE,IAAI,CAAC,gBAAgB,CAAC,aAAa;YAClD,uBAAuB,EAAE,IAAI,CAAC,gBAAgB,CAAC,aAAa,CAAC,SAAS,CAAC,cAAc;SACtF,CAAC;IACJ,CAAC;IAEO,uBAAuB,CAC7B,iBAA4D;QAE5D,MAAM,aAAa,GAAG,IAAI,CAAC,gBAAgB,CAAC,iBAAiB,CAAC,MAAM,CAAC;QACrE,MAAM,qBAAqB,GAAG,aAAa,EAAE,WAAW,KAAK,cAAc,CAAC,SAAS;YACnF,CAAC,CAAC;gBACE,QAAQ,EAAE,SAAkB;gBAC5B,WAAW,EAAE,aAAa,CAAC,WAAW;gBACtC,SAAS,EAAE,aAAa,CAAC,SAAS;gBAClC,YAAY,EAAE,aAAa,CAAC,YAAY;aACzC;YACH,CAAC,CAAC,SAAS,CAAC;QAEd,OAAO;YACL,OAAO,EAAE,IAAI,CAAC,yBAAyB,CAAC,SAAS,EAAE,iBAAiB,CAAC,IAAI,CAAC;YAC1E,OAAO,EAAE,qBAAqB;YAC9B,cAAc,EAAE,IAAI,CAAC,gBAAgB,CAAC,sBAAsB;gBAC1D,CAAC,CAAC;oBACE,QAAQ,EAAE,gBAAgB;oBAC1B,WAAW,EAAE,IAAI,CAAC,gBAAgB,CAAC,sBAAsB,CAAC,WAAW;oBACrE,SAAS,EAAE,IAAI,CAAC,gBAAgB,CAAC,sBAAsB,CAAC,SAAS;oBACjE,YAAY,EAAE,IAAI,CAAC,gBAAgB,CAAC,sBAAsB,CAAC,YAAY;iBACxE;gBACH,CAAC,CAAC,SAAS;SACd,CAAC;IACJ,CAAC;IAEO,yBAAyB,CAC/B,QAA6C,EAC7C,YAAoB;QAEpB,MAAM,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,gBAAgB,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;QAE1E,IAAI,CAAC;YACH,OAAO;gBACL,QAAQ;gBACR,WAAW;gBACX,SAAS,EAAE,gCAAgC,CAAC,WAAW,CAAC;gBACxD,YAAY;aACb,CAAC;QACJ,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC;IAEO,kBAAkB,CACxB,MAA4C,EAC5C,SAAiB,EACjB,KAAyC;QAEzC,OAAO;YACL,OAAO,EAAE,KAAK;YACd,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,gBAAgB,EAAE,MAAM,CAAC,gBAAgB;YACzC,mBAAmB,EAAE,MAAM,CAAC,mBAAmB;YAC/C,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;YAClC,KAAK;SACN,CAAC;IACJ,CAAC;CACF,CAAA;AAxoBY,6BAA6B;IADzC,UAAU,EAAE;IAoBR,WAAA,MAAM,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAA;IACjC,WAAA,MAAM,CAAC,uBAAuB,CAAC,gBAAgB,CAAC,CAAA;IAChD,WAAA,MAAM,CAAC,uBAAuB,CAAC,oCAAoC,CAAC,CAAA;IAEpE,WAAA,MAAM,CAAC,uBAAuB,CAAC,mCAAmC,CAAC,CAAA;uDAD1B,6CAA6C;QAErD,4CAA4C;GAxBrE,6BAA6B,CAwoBzC","sourcesContent":["import { spawn } from 'node:child_process';\nimport { join, resolve } from 'node:path';\nimport { fileURLToPath } from 'node:url';\nimport { inject, injectable } from 'inversify';\nimport type { LoggerService } from '@wildo-ai/saas-backend-lib';\nimport { SAAS_SERVICE_TYPES } from '@wildo-ai/saas-backend-lib';\nimport { AppLibraryType, resolvePackageCompanionEntryPath } from '@wildo-ai/platform-config-lib';\nimport { CompanionIntrospectionResultSchema } from '../../../companion-api/companion-api.schemas';\nimport type { CompanionContext } from '../../context/companion-context';\nimport { CompanionIntrospectionBehaviorRegistryService } from './companion-introspection-behavior-registry.companion.service';\nimport { IntrospectionDerivationStateCompanionService } from './introspection-derivation-state.companion.service';\nimport type {\n CompanionIntrospectionChildRequest,\n CompanionIntrospectionErrorDetails,\n CompanionIntrospectionFailureResult,\n CompanionIntrospectionHomesSnapshot,\n CompanionIntrospectionRequest,\n CompanionIntrospectionResolvedPackageTarget,\n CompanionIntrospectionResolvedTarget,\n CompanionIntrospectionResult,\n CompanionIntrospectionRouteTargetId,\n CompanionIntrospectionServiceKind,\n} from '../models/companion-introspection.models';\nimport { COMPANION_SERVICE_TYPES } from '../../inject/models/service-types';\n\nconst DEFAULT_MAX_CONCURRENCY = 4;\nconst DEFAULT_TIMEOUT_MS = 30_000;\n\n/**\n * The signals that mean SOMEONE ELSE stopped this process tree.\n *\n * Read only in the exit branch that has already established this service sent no kill of its own, so\n * membership here is what separates \"the companion is going down\" from \"the derivation failed\".\n * `SIGKILL` is deliberately absent: it is what this service's own force-kill escalation sends, and a\n * child that reaches it has already been through `requestTermination`.\n */\nconst EXTERNAL_TERMINATION_SIGNALS = new Set<string>(['SIGTERM', 'SIGINT', 'SIGHUP']);\n\n/**\n * Whether a dead introspection child was killed by SOMEONE OTHER than this service.\n *\n * Exported because it is the whole decision — the call site is one branch — and because it is the\n * part worth pinning: the plumbing around it needs a real subprocess and a real signal, while the\n * reasoning is three booleans.\n *\n * The inference rests on an invariant of this file: every termination this service performs goes\n * through `requestTermination`, which sets a pending failure BEFORE killing, and the exit handler\n * returns that failure without consulting this. So a termination signal arriving with no pending\n * failure and no parsed result means nobody here asked — the child died because its PARENT did,\n * taking the process group with it. If a future kill path forgets to set the pending failure first,\n * this starts misreporting a local kill as an external one, which is why the invariant is stated\n * here rather than left implicit at the call site.\n */\nexport function wasTerminatedFromOutside(input: {\n readonly signal: string | null;\n readonly hasPendingFailure: boolean;\n readonly hasParsedResult: boolean;\n}): boolean {\n if (input.hasPendingFailure || input.hasParsedResult) return false;\n return input.signal !== null && EXTERNAL_TERMINATION_SIGNALS.has(input.signal);\n}\n\n/**\n * Env value that turns the derivation cache off entirely.\n *\n * Read once at construction. A door rather than a design: if the cache is ever suspected of serving\n * a stale answer, an operator can settle the question in one restart instead of reasoning about the\n * invalidation, and the diagnosis stays about the application rather than about this file. The\n * default is ON — the whole point is that the workbench stops paying a cold transpile per request.\n */\nconst DISABLE_DERIVATION_CACHE_VALUE = 'off';\n\n/**\n * Env-var namespaces stripped from the spawned introspection child's\n * environment so pre-bootstrap reads surface `undefined` instead of inheriting\n * stale values from the parent shell.\n *\n * The trusted homes snapshot is delivered through the IPC handshake and\n * reapplied by `applyTrustedHomesToChildProcess()` as the first action of\n * `handleChildProcessMessage()`. Any code that happens to read these env\n * vars during the narrow window BEFORE that handler runs (for example while\n * `reflect-metadata` is loading) would otherwise see whatever the parent\n * shell had set — including stale values from a previous companion run or\n * from the operator's shell — which would reintroduce the Phase 5\n * \"env-over-context\" class of regression at the subprocess boundary.\n *\n * `WILDO_COMPANION_INTROSPECTION_CHILD` is the intentional child-mode flag\n * and is re-injected fresh for every spawn.\n */\nexport const SCRUBBED_CHILD_ENV_NAMES = [\n 'COMPANION_WORKSPACE_ROOT',\n 'COMPANION_RUNTIME_HOME',\n 'COMPANION_PACKAGE_ROOT',\n 'COMPANION_FRAMEWORK_ROOT',\n 'WILDO_COMPANION_INTROSPECTION_CHILD',\n] as const;\n\n/**\n * Render an arbitrary behavior `input` so that two structurally equal inputs produce one key.\n *\n * `JSON.stringify` alone would not: `{a:1,b:2}` and `{b:2,a:1}` are the same question and would\n * occupy two cache entries, so the second phrasing of a question would always miss. Object keys are\n * therefore sorted at every depth. Arrays keep their order, because in an input an array's order is\n * part of the question.\n *\n * A value that cannot be rendered — a cycle, a `BigInt` — yields `null`, which the caller reads as\n * \"this question is not cacheable\" rather than as an error. Nothing in the current behavior surface\n * sends such an input; treating it as uncacheable rather than throwing keeps a future one working.\n */\nexport function renderStableCacheableInput(input: unknown): string | null {\n const seen = new WeakSet<object>();\n\n const render = (value: unknown): string => {\n if (value === undefined) return 'undefined';\n if (value === null) return 'null';\n if (typeof value === 'bigint') throw new Error('BigInt is not renderable.');\n if (typeof value !== 'object') return JSON.stringify(value) ?? 'undefined';\n if (seen.has(value as object)) throw new Error('Cyclic input is not renderable.');\n seen.add(value as object);\n if (Array.isArray(value)) {\n return `[${value.map(render).join(',')}]`;\n }\n const entries = Object.entries(value as Record<string, unknown>)\n .filter(([, entryValue]) => entryValue !== undefined)\n .sort(([left], [right]) => (left < right ? -1 : left > right ? 1 : 0));\n return `{${entries.map(([key, entryValue]) => `${JSON.stringify(key)}:${render(entryValue)}`).join(',')}}`;\n };\n\n try {\n return render(input);\n } catch {\n return null;\n }\n}\n\n/**\n * The identity of a derivation on the REQUEST side.\n *\n * Everything the child is given that can change its answer: which service, which behavior, which\n * target it routes to, and the behavior input. `entryPath` and `packageRoot` are included because a\n * package whose built `./companion` export appears or disappears changes which bytes are imported\n * without changing the behavior id — and `resolvePackageCompanionEntryPath` prefers `dist` when it\n * exists and falls back to source when it does not.\n *\n * Returns `null` for an input that cannot be stably rendered, which the caller reads as\n * \"derive, do not remember\".\n */\nfunction buildDerivationCacheKey(target: CompanionIntrospectionResolvedTarget): string | null {\n const renderedInput = renderStableCacheableInput(target.input);\n if (renderedInput === null) return null;\n\n return [\n target.serviceKey,\n target.serviceKind,\n target.behavior,\n target.targetId,\n target.packageRoot,\n target.entryPath,\n renderedInput,\n ].join('\\u0001');\n}\n\n/**\n * Build the `env` object handed to the spawned introspection child process.\n *\n * Responsibilities:\n *\n * 1. Inherit the caller's `process.env` as a base, so the child still sees\n * normal environment (`PATH`, `NODE_OPTIONS`, node-debug flags, etc.).\n * 2. Scrub every `COMPANION_*` bootstrap seed that\n * `applyTrustedHomesToChildProcess()` owns on the child side. Leaving\n * them in place would let `reflect-metadata` (or anything else imported\n * before the first IPC message arrives) read a stale value from the\n * parent shell — the exact Phase 5 \"env-over-context\" regression class\n * this slice was introduced to close.\n * 3. Drop any pre-existing `WILDO_COMPANION_INTROSPECTION_CHILD` so it\n * cannot survive from a parent that was itself a child in a nested\n * spawn, then re-inject it as the exact string `'1'`. The child's\n * `shouldRegisterChildMessageHandler()` gate only accepts `'1'`, so\n * this is also the enforcement point that keeps the flag's contract\n * single-sourced here.\n *\n * Exported purely for unit testing; production code reaches it through\n * `this.runSubprocess(...)` in `CompanionIntrospectionService`.\n */\nexport function buildSubprocessEnv(): NodeJS.ProcessEnv {\n const scrubbed: NodeJS.ProcessEnv = { ...process.env };\n for (const key of SCRUBBED_CHILD_ENV_NAMES) {\n delete scrubbed[key];\n }\n scrubbed.WILDO_COMPANION_INTROSPECTION_CHILD = '1';\n return scrubbed;\n}\n\n@injectable()\nexport class CompanionIntrospectionService {\n private readonly logDebug: (message: string, context?: Record<string, unknown>) => void;\n private readonly maxConcurrency: number;\n private readonly timeoutMs: number;\n private activeCount = 0;\n private readonly queue: Array<() => void> = [];\n /** Test seam only; production always retains Node's real child-process spawn. */\n private spawnSubprocess: typeof spawn = spawn;\n /**\n * Whether compiled state may be retained at all.\n *\n * `COMPANION_INTROSPECTION_CACHE=off` still means what it always meant — every read compiles, and\n * no state is consulted or written. The flag is read here rather than inside the state service\n * because this is the door every consumer already comes through, so switching it off cannot be\n * bypassed by a caller that reaches the state service directly.\n */\n private readonly derivationCacheEnabled: boolean;\n\n constructor(\n @inject(SAAS_SERVICE_TYPES.Logger) private readonly logger: LoggerService,\n @inject(COMPANION_SERVICE_TYPES.CompanionContext) private readonly companionContext: CompanionContext,\n @inject(COMPANION_SERVICE_TYPES.IntrospectionBehaviorRegistryService)\n private readonly behaviorRegistryService: CompanionIntrospectionBehaviorRegistryService,\n @inject(COMPANION_SERVICE_TYPES.IntrospectionDerivationStateService)\n private readonly derivationState: IntrospectionDerivationStateCompanionService,\n ) {\n this.logDebug = this.logger.debugByType('CompanionIntrospectionService');\n this.logger.setDebugTypeLogging('CompanionIntrospectionService', true);\n this.maxConcurrency = Math.max(\n 1,\n Number.parseInt(process.env.COMPANION_INTROSPECTION_MAX_CONCURRENCY ?? '', 10)\n || DEFAULT_MAX_CONCURRENCY,\n );\n this.timeoutMs = Math.max(\n 1_000,\n Number.parseInt(process.env.COMPANION_INTROSPECTION_TIMEOUT_MS ?? '', 10)\n || DEFAULT_TIMEOUT_MS,\n );\n this.derivationCacheEnabled = (process.env.COMPANION_INTROSPECTION_CACHE ?? '').trim().toLowerCase()\n !== DISABLE_DERIVATION_CACHE_VALUE;\n }\n\n /**\n * Answer an introspection request, re-deriving only when the application's source has moved.\n *\n * ## The three tiers, in order\n *\n * 1. **Cache hit** — a previous derivation of this exact question, taken against a source tree\n * whose observation token still matches. No subprocess, no import, no registry materialization.\n * 2. **In-flight join** — the identical question is already being derived against the identical\n * token. The caller waits on that one rather than spawning a second child.\n * 3. **Derive** — spawn, under the existing concurrency queue.\n *\n * ## What is cached, and what deliberately is not\n *\n * Only SUCCESS. A failure is not memoized, for two separate reasons and either is sufficient: the\n * common failure here is an application whose `dist` is not built, whose remedy moves the source\n * and would invalidate anyway; and a transient failure — a timeout on a loaded machine — would\n * otherwise stick to an unchanged tree and be served as the answer forever. In-flight JOINING\n * still covers failures, because two concurrent identical questions should cost one subprocess\n * whatever the outcome.\n *\n * ## Where the source reading happens\n *\n * Outside the concurrency queue. The observation is ~125 ms of filesystem work with no subprocess\n * behind it; holding one of the four queue slots for it would make a cache HIT contend with real\n * derivations, which is the opposite of the point.\n */\n /**\n * The introspection MENU — what this running companion can answer, for a caller that has to choose.\n *\n * Serves `wildo context list` (issue #252): the door's tier-1 progressive-disclosure catalog. It is a\n * COMPANION answer rather than a CLI-side copy of the behavior definitions on purpose — the CLI and a\n * running companion can be different builds, and a menu describing behaviors the serving side does not\n * have is the staleness class `.claude/rules/staleness-presents-as-a-logic-defect.md` records. Runtime\n * truth, one hop.\n *\n * `defaultBackendServiceKey` is here for the same one-authority reason: `POST /_meta/introspect`\n * REQUIRES a `serviceKey`, and the \"first backend service\" default already exists in the playbook\n * composer (`composeWorkspaceTruthSection`). Publishing the resolved default lets a CLI caller pass it\n * explicitly instead of re-deriving the rule, so the POST contract stays strict and the rule stays in\n * companion code.\n */\n public describeCatalog(): {\n readonly behaviors: ReadonlyArray<{\n readonly behaviorId: string;\n readonly description: string;\n readonly category: string;\n readonly supportedServiceKinds: readonly CompanionIntrospectionServiceKind[];\n }>;\n readonly serviceKeys: ReadonlyArray<{ readonly key: string; readonly kind: CompanionIntrospectionServiceKind }>;\n readonly defaultBackendServiceKey: string | null;\n } {\n const behaviors = this.behaviorRegistryService.listBehaviorDefinitions().map((definition) => ({\n behaviorId: definition.behaviorId,\n description: definition.description,\n category: definition.category,\n supportedServiceKinds: definition.supportedServiceKinds,\n }));\n const serviceKeys = Object.entries(this.companionContext.servicesByKey).map(([key, service]) => ({\n key,\n kind: this.resolveServiceKind(service),\n }));\n const defaultBackendServiceKey = serviceKeys.find((service) => service.kind === 'backend')?.key ?? null;\n return { behaviors, serviceKeys, defaultBackendServiceKey };\n }\n\n public async requestInfo(request: CompanionIntrospectionRequest): Promise<CompanionIntrospectionResult> {\n const resolvedTarget = await this.resolveTarget(request);\n\n if (!this.derivationCacheEnabled) {\n return this.deriveThroughQueue(resolvedTarget);\n }\n\n const cacheKey = buildDerivationCacheKey(resolvedTarget);\n if (cacheKey === null) {\n return this.deriveThroughQueue(resolvedTarget);\n }\n\n return this.derivationState.read(\n { cacheKey, behavior: resolvedTarget.behavior, serviceKey: resolvedTarget.serviceKey },\n () => this.deriveThroughQueue(resolvedTarget),\n );\n }\n\n /**\n * Compile a derivation without consulting or writing compiled state.\n *\n * The COMPILE primitive, exposed so the state service can drive a recompilation that no read\n * asked for. It is the same path a cache miss took before, minus the memo: the concurrency queue,\n * the subprocess, the IPC result. Nothing here decides freshness, which is the separation this\n * whole change exists to make — a caller that wants the current answer asks the state service, and\n * a caller that wants a NEW answer asks this.\n */\n public async compileNow(\n request: CompanionIntrospectionRequest,\n ): Promise<CompanionIntrospectionResult> {\n return this.deriveThroughQueue(await this.resolveTarget(request));\n }\n\n /**\n * The cache key a request resolves to, for a caller that needs to talk about a derivation's\n * identity — to warm it, to stamp a notification with its generation — without running it.\n *\n * `null` means the request's input cannot be stably rendered, which every caller reads as\n * \"compile, do not remember\".\n */\n public async resolveDerivationIdentity(request: CompanionIntrospectionRequest): Promise<{\n readonly cacheKey: string;\n readonly behavior: string;\n readonly serviceKey: string;\n } | null> {\n const resolvedTarget = await this.resolveTarget(request);\n const cacheKey = buildDerivationCacheKey(resolvedTarget);\n if (cacheKey === null) return null;\n return { cacheKey, behavior: resolvedTarget.behavior, serviceKey: resolvedTarget.serviceKey };\n }\n\n /**\n * Drop every compiled derivation.\n *\n * Costs a recompilation and changes no answer — the property that makes this state per-run runtime\n * state rather than a second source of truth. Kept on this service because it is the door every\n * consumer already holds; the state itself lives one layer down.\n */\n public clearDerivationCache(): void {\n this.derivationState.clear();\n }\n\n private async deriveThroughQueue(\n resolvedTarget: CompanionIntrospectionResolvedTarget,\n ): Promise<CompanionIntrospectionResult> {\n return this.enqueue(async () => {\n this.logDebug('Executing companion introspection request', {\n serviceKey: resolvedTarget.serviceKey,\n behavior: resolvedTarget.behavior,\n targetId: resolvedTarget.targetId,\n entryPath: resolvedTarget.entryPath,\n });\n\n return this.runSubprocess(resolvedTarget);\n });\n }\n\n private async enqueue<T>(task: () => Promise<T>): Promise<T> {\n if (this.activeCount < this.maxConcurrency) {\n return this.runQueuedTask(task);\n }\n\n return new Promise<T>((resolvePromise, rejectPromise) => {\n this.queue.push(() => {\n void this.runQueuedTask(task).then(resolvePromise, rejectPromise);\n });\n });\n }\n\n private async runQueuedTask<T>(task: () => Promise<T>): Promise<T> {\n this.activeCount += 1;\n\n try {\n return await task();\n } finally {\n this.activeCount -= 1;\n const nextTask = this.queue.shift();\n if (nextTask) {\n nextTask();\n }\n }\n }\n\n private async resolveTarget(\n request: CompanionIntrospectionRequest,\n ): Promise<CompanionIntrospectionResolvedTarget> {\n const serviceDefinition = this.companionContext.servicesByKey[request.serviceKey];\n if (!serviceDefinition) {\n throw new Error(`Unknown SaaS service key \"${request.serviceKey}\".`);\n }\n\n const serviceKind = this.resolveServiceKind(serviceDefinition);\n const resolvedBehavior = this.behaviorRegistryService.resolveBehaviorForServiceKind(\n request.behavior,\n serviceKind,\n );\n\n const resolvedTargets = this.resolveCompanionTargets(serviceDefinition);\n const missingTargets = [resolvedBehavior.route.target, ...(resolvedBehavior.route.requiredTargets ?? [])]\n .filter((targetId, index, allTargetIds) => allTargetIds.indexOf(targetId) === index)\n .filter((targetId) => !resolvedTargets[targetId]);\n if (missingTargets.length > 0) {\n throw new Error(\n `Behavior \"${request.behavior}\" requires config-declared target(s) ${missingTargets.map((targetId) => `\"${targetId}\"`).join(', ')}, but they are not declared or resolvable for service \"${request.serviceKey}\".`,\n );\n }\n const behaviorTarget = resolvedTargets[resolvedBehavior.route.target]!;\n\n const servicePath = resolve(this.companionContext.saasRoot, serviceDefinition.path);\n\n return {\n serviceKey: request.serviceKey,\n servicePath,\n serviceName: serviceDefinition.serviceName,\n serviceKind,\n behavior: request.behavior,\n behaviorCategory: resolvedBehavior.category,\n materializationKind: resolvedBehavior.execution.materializationKind,\n targetId: resolvedBehavior.route.target,\n packageRoot: behaviorTarget.packageRoot,\n entryPath: behaviorTarget.entryPath,\n resolvedTargets,\n resolvedBehavior,\n input: request.input,\n };\n }\n\n private resolveServiceKind(\n serviceDefinition: CompanionContext['servicesByKey'][string],\n ): CompanionIntrospectionServiceKind {\n return serviceDefinition.frontendType ? 'frontend' : 'backend';\n }\n\n private async runSubprocess(\n target: CompanionIntrospectionResolvedTarget,\n ): Promise<CompanionIntrospectionResult> {\n const childRequest = this.buildChildRequest(target);\n const launchContext = this.resolveSubprocessLaunchContext();\n\n return new Promise<CompanionIntrospectionResult>((resolvePromise) => {\n const startedAt = Date.now();\n const child = this.spawnSubprocess(process.execPath, [\n /*\n * Silence tsx's own deprecation warning at the SOURCE.\n *\n * `tsx` registers its ESM hooks through `module.register()`, which Node 26 deprecates\n * (DEP0205). The warning is emitted by a dependency on every single introspection call, it\n * says nothing about this application, and there is nothing an application developer can do\n * about it — but it lands in the child's stderr, which is buffered and logged, so it\n * DOMINATED the one place a reader looks to find out what an introspection actually did.\n *\n * Suppressed here rather than filtered out of the log: a warning that is never emitted cannot\n * be mistaken for output, and filtering would leave the next reader wondering whether the\n * filter is hiding something real. Scoped to this ONE code, so a genuine future deprecation\n * still surfaces.\n */\n '--disable-warning=DEP0205',\n '--import',\n 'tsx',\n '--import',\n launchContext.assetNoopRegisterPath,\n launchContext.runnerPath,\n ], {\n cwd: launchContext.cwd,\n env: buildSubprocessEnv(),\n stdio: ['ignore', 'pipe', 'pipe', 'ipc'],\n });\n\n let stdout = '';\n let stderr = '';\n let settled = false;\n let parsedResult: CompanionIntrospectionResult | null = null;\n let pendingFailure: CompanionIntrospectionFailureResult | null = null;\n let naturalExitHandle: NodeJS.Timeout | null = null;\n let forceKillHandle: NodeJS.Timeout | null = null;\n\n /*\n * The child's output, as TWO named fields rather than one ` | `-joined blob.\n *\n * The blob was unreadable in practice: a routine success printed one useful line of stdout\n * glued to a multi-line third-party deprecation warning, and a reader could not tell at a\n * glance whether an introspection had worked, what it had found, or whether the stderr meant\n * anything. Stdout and stderr answer different questions — what it DID versus what went WRONG —\n * and joining them makes the log answer neither.\n */\n const buildOutputContext = (): { stdout?: string; stderr?: string } | undefined => {\n const trimmedStdout = stdout.trim();\n const trimmedStderr = stderr.trim();\n if (trimmedStdout.length === 0 && trimmedStderr.length === 0) return undefined;\n return {\n ...(trimmedStdout.length > 0 ? { stdout: trimmedStdout } : {}),\n ...(trimmedStderr.length > 0 ? { stderr: trimmedStderr } : {}),\n };\n };\n\n /** One line for a message that has no room for two fields. */\n const describeOutputContext = (context: { stdout?: string; stderr?: string } | undefined): string =>\n context === undefined\n ? ''\n : [\n ...(context.stdout ? [`stdout: ${context.stdout}`] : []),\n ...(context.stderr ? [`stderr: ${context.stderr}`] : []),\n ].join(' | ');\n\n const onStdout = (chunk: Buffer | string) => {\n stdout += chunk.toString();\n };\n const onStderr = (chunk: Buffer | string) => {\n stderr += chunk.toString();\n };\n child.stdout?.on('data', onStdout);\n child.stderr?.on('data', onStderr);\n\n const clearTimer = (handle: NodeJS.Timeout | null): void => {\n if (handle !== null) clearTimeout(handle);\n };\n\n const cleanup = () => {\n clearTimeout(timeoutHandle);\n clearTimer(naturalExitHandle);\n clearTimer(forceKillHandle);\n child.off('spawn', onSpawn);\n child.off('message', onMessage);\n child.off('error', onError);\n child.off('close', onClose);\n child.stdout?.off('data', onStdout);\n child.stderr?.off('data', onStderr);\n };\n\n const finalize = (result: CompanionIntrospectionResult) => {\n if (settled) {\n return;\n }\n\n settled = true;\n cleanup();\n const finalResult = {\n ...result,\n stdout: stdout || undefined,\n stderr: stderr || undefined,\n };\n resolvePromise(finalResult);\n };\n\n const requestTermination = (failure: CompanionIntrospectionFailureResult): void => {\n if (pendingFailure === null) pendingFailure = failure;\n clearTimeout(timeoutHandle);\n clearTimer(naturalExitHandle);\n naturalExitHandle = null;\n if (forceKillHandle !== null) return;\n try {\n child.kill('SIGTERM');\n } catch {\n // A concurrent exit can make kill throw; settlement still waits for\n // the terminal `close` event rather than guessing process state.\n }\n forceKillHandle = setTimeout(() => {\n try {\n child.kill('SIGKILL');\n } catch {\n // The terminal `close` event remains the only settlement signal.\n }\n }, 1_000);\n };\n\n const onSpawn = () => {\n child.send?.(childRequest);\n };\n\n const onMessage = (message: unknown) => {\n clearTimeout(timeoutHandle);\n if (pendingFailure !== null) return;\n if (parsedResult !== null) {\n requestTermination(this.buildFailureResult(target, startedAt, {\n message: 'Companion introspection subprocess returned more than one result payload.',\n name: 'CompanionIntrospectionDuplicateResultError',\n }));\n return;\n }\n try {\n parsedResult = CompanionIntrospectionResultSchema.parse(message) as CompanionIntrospectionResult;\n // A valid payload is provisional until the child proves that no late\n // failure occurred. Give the normal child one bounded window to\n // disconnect and exit cleanly before beginning termination.\n naturalExitHandle = setTimeout(() => {\n requestTermination(this.buildFailureResult(target, startedAt, {\n message: 'Companion introspection subprocess returned a result but did not exit cleanly within 1000ms.',\n name: 'CompanionIntrospectionResultExitTimeoutError',\n }));\n }, 1_000);\n } catch (error) {\n // describeCaughtError: N/A — this `try` wraps exactly one statement,\n // `CompanionIntrospectionResultSchema.parse(message)`, which throws a `ZodError`.\n // No engine service is called inside it, so a `WildoError_Backend` (a plain\n // object, which the test below would reject) cannot reach here. The site also\n // needs `.name` and `.stack`, which the string helper does not carry. Left as-is\n // deliberately, not overlooked by the 2026-08-21 sweep.\n const standardError = error instanceof Error ? error : new Error('Invalid companion introspection subprocess payload.');\n requestTermination(this.buildFailureResult(target, startedAt, {\n message: standardError.message,\n name: standardError.name,\n stack: standardError.stack,\n }));\n }\n };\n\n const onError = (error: Error) => {\n requestTermination(this.buildFailureResult(target, startedAt, {\n message: error.message,\n name: error.name,\n stack: error.stack,\n }));\n };\n\n const onClose = (code: number | null, signal: NodeJS.Signals | null) => {\n if (settled) return;\n const outputContext = buildOutputContext();\n if (outputContext) {\n /*\n * Named for what the reader wants to know — WHICH introspection, and whether it went\n * cleanly — rather than for the mechanism. \"exited with buffered output\" described the\n * plumbing and left the behavior buried in a field.\n */\n const cleanExit = code === 0 && signal === null;\n this.logDebug(\n `Companion introspection \"${target.behavior}\" on \"${target.serviceKey}\" ${cleanExit ? 'completed' : `exited code=${code ?? 'null'} signal=${signal ?? 'null'}`}`,\n {\n serviceKey: target.serviceKey,\n behavior: target.behavior,\n targetId: target.targetId,\n code,\n signal,\n ...outputContext,\n },\n );\n }\n if (pendingFailure !== null) {\n finalize(pendingFailure);\n return;\n }\n if (parsedResult !== null && code === 0 && signal === null) {\n finalize(parsedResult);\n return;\n }\n if (parsedResult !== null && parsedResult.success === false) {\n finalize(parsedResult);\n return;\n }\n /*\n * A signal THIS SERVICE DID NOT SEND means the kill came from outside, and saying so is the\n * difference between an actionable message and a misleading one.\n *\n * Every termination this service performs goes through `requestTermination`, which sets\n * `pendingFailure` BEFORE killing — and the branch above returns that failure. So reaching\n * here with a termination signal proves nobody here asked for it: the child died because its\n * PARENT did, taking the process group with it.\n *\n * In a dev loop that is the supervisor restarting the companion. Measured 2026-09-02 across\n * four session logs: 30 such failures at a median of 11.4 s — nowhere near the 30 s ceiling —\n * and the line immediately preceding each one is\n * `[runtime-supervisor:wildo-dev-companion] Stopping runtime before readiness...`.\n *\n * The old message named the subprocess as the thing that exited, which is true and useless:\n * it reads as a fault in the derivation, and `signal=SIGTERM` beside a 30 s timeout constant\n * reads as that timeout firing. It cost a full investigation before the log said otherwise.\n */\n const terminatedFromOutside = wasTerminatedFromOutside({\n signal,\n hasPendingFailure: pendingFailure !== null,\n hasParsedResult: parsedResult !== null,\n });\n\n finalize(this.buildFailureResult(target, startedAt, terminatedFromOutside\n ? {\n message: `Companion introspection was terminated by ${signal} that this service did not send — the companion process itself is stopping, so the derivation was cut short rather than failing. Re-run it once the companion is ready.`,\n name: 'CompanionIntrospectionParentTerminatedError',\n }\n : {\n message: parsedResult === null\n ? `Companion introspection subprocess exited before returning a result (code=${code ?? 'null'}, signal=${signal ?? 'null'})${outputContext ? ` — ${describeOutputContext(outputContext)}` : ''}.`\n : `Companion introspection subprocess returned a result then exited unsuccessfully (code=${code ?? 'null'}, signal=${signal ?? 'null'}).`,\n name: 'CompanionIntrospectionSubprocessExitError',\n }));\n };\n\n const timeoutHandle = setTimeout(() => {\n requestTermination(this.buildFailureResult(target, startedAt, {\n message: `Companion introspection timed out after ${this.timeoutMs}ms.`,\n name: 'CompanionIntrospectionTimeoutError',\n }));\n }, this.timeoutMs);\n\n child.on('spawn', onSpawn);\n child.on('message', onMessage);\n child.on('error', onError);\n // `close`, unlike `message` or `exit`, proves that the process and its\n // stdio handles are all quiescent. The parent never releases its queue\n // slot while the child can still emit output or fail late.\n child.on('close', onClose);\n });\n }\n\n private buildChildRequest(\n target: CompanionIntrospectionResolvedTarget,\n ): CompanionIntrospectionChildRequest {\n return {\n behavior: target.behavior,\n serviceKind: target.serviceKind,\n behaviorCategory: target.behaviorCategory,\n materializationKind: target.materializationKind,\n targetId: target.targetId,\n serviceKey: target.serviceKey,\n entryPath: target.entryPath,\n packageRoot: target.packageRoot,\n homes: this.buildChildHomesSnapshot(),\n resolvedTargets: target.resolvedTargets,\n input: target.input,\n };\n }\n\n /**\n * Resolve subprocess launch paths from THIS MODULE's own location, never from\n * `companionHome/src`. Under dist-only delivery (issue #64) the application's\n * `.wildo-saas/wildo-dev-companion` drop contains no source tree at all — the child runner and\n * the asset-noop register ship as COMPILED siblings of this service inside `dist/esm`, so the\n * only location that is guaranteed to hold them is the directory graph this very module runs\n * from. When the suite executes the source directly (vitest resolves the `.ts` module), the\n * sibling files are the authored `.ts` sources and the child is executable because the spawn\n * always registers `tsx` before the register hook. `cwd` stays the application's companion\n * home: the child resolves app packages and `node_modules` (including `tsx` itself) from there.\n */\n private resolveSubprocessLaunchContext(): {\n cwd: string;\n runnerPath: string;\n assetNoopRegisterPath: string;\n } {\n const isSourceExecution = import.meta.url.endsWith('.ts');\n const subprocessDir = fileURLToPath(new URL('../subprocess/', import.meta.url));\n return {\n cwd: this.companionContext.companionHome,\n runnerPath: join(subprocessDir, isSourceExecution ? 'companion-introspection-child.ts' : 'companion-introspection-child.js'),\n assetNoopRegisterPath: join(subprocessDir, isSourceExecution ? 'asset-noop-register.ts' : 'asset-noop-register.js'),\n };\n }\n\n private buildChildHomesSnapshot(): CompanionIntrospectionHomesSnapshot {\n const appLayout = this.companionContext.resolvedHomes.app.layout;\n if (!appLayout) {\n throw new Error('Companion introspection requires an app layout in the trusted homes snapshot.');\n }\n\n return {\n appDeclarationRoot: appLayout.declarationRoot,\n appRuntimeHome: appLayout.runtimeHome,\n companionHome: this.companionContext.companionHome,\n frameworkRepositoryRoot: this.companionContext.resolvedHomes.framework.repositoryRoot,\n };\n }\n\n private resolveCompanionTargets(\n serviceDefinition: CompanionContext['servicesByKey'][string],\n ): Partial<Record<CompanionIntrospectionRouteTargetId, CompanionIntrospectionResolvedPackageTarget>> {\n const sharedLibrary = this.companionContext.resolvedLibraries.shared;\n const resolvedLibraryTarget = sharedLibrary?.libraryType === AppLibraryType.FULLSTACK\n ? {\n targetId: 'library' as const,\n packageRoot: sharedLibrary.packageRoot,\n entryPath: sharedLibrary.entryPath,\n declaredPath: sharedLibrary.declaredPath,\n }\n : undefined;\n\n return {\n service: this.tryResolveCompanionTarget('service', serviceDefinition.path),\n library: resolvedLibraryTarget,\n specifications: this.companionContext.resolvedSpecifications\n ? {\n targetId: 'specifications',\n packageRoot: this.companionContext.resolvedSpecifications.packageRoot,\n entryPath: this.companionContext.resolvedSpecifications.entryPath,\n declaredPath: this.companionContext.resolvedSpecifications.declaredPath,\n }\n : undefined,\n };\n }\n\n private tryResolveCompanionTarget(\n targetId: CompanionIntrospectionRouteTargetId,\n declaredPath: string,\n ): CompanionIntrospectionResolvedPackageTarget | undefined {\n const packageRoot = resolve(this.companionContext.saasRoot, declaredPath);\n\n try {\n return {\n targetId,\n packageRoot,\n entryPath: resolvePackageCompanionEntryPath(packageRoot),\n declaredPath,\n };\n } catch {\n return undefined;\n }\n }\n\n private buildFailureResult(\n target: CompanionIntrospectionResolvedTarget,\n startedAt: number,\n error: CompanionIntrospectionErrorDetails,\n ): CompanionIntrospectionFailureResult {\n return {\n success: false,\n behavior: target.behavior,\n serviceKey: target.serviceKey,\n serviceKind: target.serviceKind,\n behaviorCategory: target.behaviorCategory,\n materializationKind: target.materializationKind,\n targetId: target.targetId,\n durationMs: Date.now() - startedAt,\n error,\n };\n }\n}\n"]}
|