@wildo-ai/platform-core-shared 1.1.11 → 1.1.13

package/dist/esm/core/resources/resources-operations.custom.shared.definitions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resources-operations.custom.shared.definitions.d.ts","sourceRoot":"","sources":["../../../../../src/core/resources/resources-operations.custom.shared.definitions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,8CAA8C,EAAE,MAAM,uBAAuB,CAAC;AACvF,OAAO,EAAE,yBAAyB,EAAE,MAAM,yCAAyC,CAAC;AAapF,eAAO,MAAM,8CAA8C,EAAE,8CAA8C,CAAC,yBAAyB,CAYpI,CAAC"}
+{"version":3,"file":"resources-operations.custom.shared.definitions.d.ts","sourceRoot":"","sources":["../../../../src/core/resources/resources-operations.custom.shared.definitions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,8CAA8C,EAAE,MAAM,uBAAuB,CAAC;AACvF,OAAO,EAAE,yBAAyB,EAAE,MAAM,yCAAyC,CAAC;AAapF,eAAO,MAAM,8CAA8C,EAAE,8CAA8C,CAAC,yBAAyB,CAYpI,CAAC"}

package/dist/esm/core/resources/resources-operations.custom.shared.definitions.js.map

@@ -1 +1 @@
-{"version":3,"file":"resources-operations.custom.shared.definitions.js","sourceRoot":"","sources":["../../../../../src/core/resources/resources-operations.custom.shared.definitions.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,yBAAyB,EAAE,MAAM,yCAAyC,CAAC;AAEpF,yBAAyB;AACzB,OAAO,EAAE,6DAA6D,EAAE,MAAM,oFAAoF,CAAC;AACnK,OAAO,EAAE,oEAAoE,EAAE,MAAM,sGAAsG,CAAC;AAC5L,OAAO,EACL,iFAAiF,EACjF,gFAAgF,GACjF,MAAM,wGAAwG,CAAC;AAChH,OAAO,EACL,sEAAsE,GACvE,MAAM,8FAA8F,CAAC;AAEtG,MAAM,CAAC,MAAM,8CAA8C,GAA8E;IACvI,gFAAgF;IAChF,yBAAyB;IACzB,gFAAgF;IAChF,CAAC,yBAAyB,CAAC,iBAAiB,CAAC,EAAE,6DAA6D;IAC5G,CAAC,yBAAyB,CAAC,0BAA0B,CAAC,EAAE,oEAAoE;IAC5H,CAAC,yBAAyB,CAAC,yCAAyC,CAAC,EACnE,iFAAiF;IACnF,CAAC,yBAAyB,CAAC,wCAAwC,CAAC,EAClE,gFAAgF;IAClF,CAAC,yBAAyB,CAAC,6BAA6B,CAAC,EACvD,sEAAsE;CACzE,CAAC","sourcesContent":["import { ResourceConfiguration_InitializationFactoryMap } from '@wildo-ai/saas-models';\nimport { CustomShared_ResourceType } from './resources-types.custom.shared.schemas';\n\n// Application Management\nimport { wildoApplications_ResourceConfiguration_InitializationFactory } from '../../wildo-applications/wildo-applications.custom.shared.resources-config.schemas';\nimport { wildoApplicationVersions_ResourceConfiguration_InitializationFactory } from '../../wildo-applications-versions/wildo-applications-versions.custom.shared.resources-config.schemas';\nimport {\n  wildoApplicationActorSystemExecutions_ResourceConfiguration_InitializationFactory,\n  wildoApplicationFlowSystemExecutions_ResourceConfiguration_InitializationFactory,\n} from '../../wildo-application-executions/wildo-application-executions.custom.shared.resources-config.schemas';\nimport {\n  wildoApplicationActorTasks_ResourceConfiguration_InitializationFactory,\n} from '../../wildo-application-tasks/wildo-application-tasks.custom.shared.resources-config.schemas';\n\nexport const customShared_ResourcesConfigurationsFactoryMap: ResourceConfiguration_InitializationFactoryMap<CustomShared_ResourceType> = {\n  // ─────────────────────────────────────────────────────────────────────────────\n  // Application Management\n  // ─────────────────────────────────────────────────────────────────────────────\n  [CustomShared_ResourceType.WILDO_APPLICATION]: wildoApplications_ResourceConfiguration_InitializationFactory,\n  [CustomShared_ResourceType.WILDO_APPLICATION_VERSIONS]: wildoApplicationVersions_ResourceConfiguration_InitializationFactory,\n  [CustomShared_ResourceType.WILDO_APPLICATION_ACTOR_SYSTEM_EXECUTIONS]:\n    wildoApplicationActorSystemExecutions_ResourceConfiguration_InitializationFactory,\n  [CustomShared_ResourceType.WILDO_APPLICATION_FLOW_SYSTEM_EXECUTIONS]:\n    wildoApplicationFlowSystemExecutions_ResourceConfiguration_InitializationFactory,\n  [CustomShared_ResourceType.WILDO_APPLICATION_ACTOR_TASKS]:\n    wildoApplicationActorTasks_ResourceConfiguration_InitializationFactory,\n};\n"]}
+{"version":3,"file":"resources-operations.custom.shared.definitions.js","sourceRoot":"","sources":["../../../../src/core/resources/resources-operations.custom.shared.definitions.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,yBAAyB,EAAE,MAAM,yCAAyC,CAAC;AAEpF,yBAAyB;AACzB,OAAO,EAAE,6DAA6D,EAAE,MAAM,oFAAoF,CAAC;AACnK,OAAO,EAAE,oEAAoE,EAAE,MAAM,sGAAsG,CAAC;AAC5L,OAAO,EACL,iFAAiF,EACjF,gFAAgF,GACjF,MAAM,wGAAwG,CAAC;AAChH,OAAO,EACL,sEAAsE,GACvE,MAAM,8FAA8F,CAAC;AAEtG,MAAM,CAAC,MAAM,8CAA8C,GAA8E;IACvI,gFAAgF;IAChF,yBAAyB;IACzB,gFAAgF;IAChF,CAAC,yBAAyB,CAAC,iBAAiB,CAAC,EAAE,6DAA6D;IAC5G,CAAC,yBAAyB,CAAC,0BAA0B,CAAC,EAAE,oEAAoE;IAC5H,CAAC,yBAAyB,CAAC,yCAAyC,CAAC,EACnE,iFAAiF;IACnF,CAAC,yBAAyB,CAAC,wCAAwC,CAAC,EAClE,gFAAgF;IAClF,CAAC,yBAAyB,CAAC,6BAA6B,CAAC,EACvD,sEAAsE;CACzE,CAAC","sourcesContent":["import { ResourceConfiguration_InitializationFactoryMap } from '@wildo-ai/saas-models';\nimport { CustomShared_ResourceType } from './resources-types.custom.shared.schemas';\n\n// Application Management\nimport { wildoApplications_ResourceConfiguration_InitializationFactory } from '../../wildo-applications/wildo-applications.custom.shared.resources-config.schemas';\nimport { wildoApplicationVersions_ResourceConfiguration_InitializationFactory } from '../../wildo-applications-versions/wildo-applications-versions.custom.shared.resources-config.schemas';\nimport {\n  wildoApplicationActorSystemExecutions_ResourceConfiguration_InitializationFactory,\n  wildoApplicationFlowSystemExecutions_ResourceConfiguration_InitializationFactory,\n} from '../../wildo-application-executions/wildo-application-executions.custom.shared.resources-config.schemas';\nimport {\n  wildoApplicationActorTasks_ResourceConfiguration_InitializationFactory,\n} from '../../wildo-application-tasks/wildo-application-tasks.custom.shared.resources-config.schemas';\n\nexport const customShared_ResourcesConfigurationsFactoryMap: ResourceConfiguration_InitializationFactoryMap<CustomShared_ResourceType> = {\n  // ─────────────────────────────────────────────────────────────────────────────\n  // Application Management\n  // ─────────────────────────────────────────────────────────────────────────────\n  [CustomShared_ResourceType.WILDO_APPLICATION]: wildoApplications_ResourceConfiguration_InitializationFactory,\n  [CustomShared_ResourceType.WILDO_APPLICATION_VERSIONS]: wildoApplicationVersions_ResourceConfiguration_InitializationFactory,\n  [CustomShared_ResourceType.WILDO_APPLICATION_ACTOR_SYSTEM_EXECUTIONS]:\n    wildoApplicationActorSystemExecutions_ResourceConfiguration_InitializationFactory,\n  [CustomShared_ResourceType.WILDO_APPLICATION_FLOW_SYSTEM_EXECUTIONS]:\n    wildoApplicationFlowSystemExecutions_ResourceConfiguration_InitializationFactory,\n  [CustomShared_ResourceType.WILDO_APPLICATION_ACTOR_TASKS]:\n    wildoApplicationActorTasks_ResourceConfiguration_InitializationFactory,\n};\n"]}

package/dist/esm/core/resources/resources-relationships.custom.shared.definitions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resources-relationships.custom.shared.definitions.d.ts","sourceRoot":"","sources":["../../../../../src/core/resources/resources-relationships.custom.shared.definitions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmD,oBAAoB,EAA+G,MAAM,uBAAuB,CAAC;AAG3N;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,mCAAmC,EAAE,oBAAoB,EA4KrE,CAAC"}
+{"version":3,"file":"resources-relationships.custom.shared.definitions.d.ts","sourceRoot":"","sources":["../../../../src/core/resources/resources-relationships.custom.shared.definitions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmD,oBAAoB,EAA+G,MAAM,uBAAuB,CAAC;AAG3N;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,mCAAmC,EAAE,oBAAoB,EA4KrE,CAAC"}

package/dist/esm/core/resources/resources-relationships.custom.shared.definitions.js.map

@@ -1 +1 @@
-{"version":3,"file":"resources-relationships.custom.shared.definitions.js","sourceRoot":"","sources":["../../../../../src/core/resources/resources-relationships.custom.shared.definitions.ts"],"names":[],"mappings":"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","sourcesContent":["import { createResourcesRelationship, RelationshipNature, ResourceRelationship, ResourceRelationshipCardinality, CoreResourceType, CoreResourceOperation, ResourceParentResourceRequirement } from \"@wildo-ai/saas-models\";\nimport { CustomShared_ResourceType } from \"./resources-types.custom.shared.schemas\";\n\n/**\n * ⚠️ APPLICATION-CHILD RETENTION (compliance decision, Paul — 2026-07-29).\n *\n * `wildoApplicationVersions`, `wildoApplicationActorSystemExecutions`,\n * `wildoApplicationFlowSystemExecutions` and `wildoApplicationActorTasks` are RETAINED AS AUDIT\n * MATERIAL when their `wildoApplication` is deleted — the deployment/execution history of an\n * application outlives the application record itself. Every `onParentDelete` below is therefore\n * DISABLED.\n *\n * This also FIXES A LATENT BUG rather than merely expressing a preference: these children declare no\n * core DELETE op (`wildoApplicationVersions` exposes READ/LIST/CREATE only), so the cascade would have\n * thrown `ErrorType.CONFIGURATION` inside the parent's delete transaction and ROLLED BACK the\n * application delete as soon as one child row existed. Surfaced by the startup\n * composition-cascade-deletability guard on a live apps-manager boot (2026-07-29) — it was invisible to\n * the engine's regression test, which only rebuilds the CORE registry.\n *\n * A COMPOSITION without `onParentDelete` is an explicitly supported combination: the children are left\n * behind by design choice. The nature stays COMPOSITION because these rows genuinely belong to their\n * application; only the dies-with-parent behaviour is declined.\n */\nexport const customShared_ResourcesRelationships: ResourceRelationship[] = [\n  // ═══════════════════════════════════════════════════════════════════════════\n  // APPLICATION MANAGEMENT\n  // \n  // WildoApplication is a resource (not a scope). It represents applications\n  // created by users using the wildo-ai-application (the app factory).\n  // Primary scope for all resources is Organizations.\n  // ═══════════════════════════════════════════════════════════════════════════\n  \n  // Organizations → WildoApplication (1:N)\n  // Primary scope: Applications belong to organizations\n  createResourcesRelationship(\n    CoreResourceType.ORGANIZATIONS, CustomShared_ResourceType.WILDO_APPLICATION, \n    ResourceRelationshipCardinality.ONE, ResourceRelationshipCardinality.MANY,\n    { \n      nature: RelationshipNature.COMPOSITION,\n      isPrimaryScope: true,\n      contextPolicy: {}\n    }\n  ),\n\n  // Organizations → WildoApplicationVersions (1:N)\n  // Primary scope: Versions belong to organizations\n  createResourcesRelationship(\n    CoreResourceType.ORGANIZATIONS, CustomShared_ResourceType.WILDO_APPLICATION_VERSIONS, \n    ResourceRelationshipCardinality.ONE, ResourceRelationshipCardinality.MANY,\n    { \n      nature: RelationshipNature.COMPOSITION,\n      isPrimaryScope: true,\n      contextPolicy: {}\n    }\n  ),\n\n  // WildoApplication → WildoApplicationVersions (1:N)\n  // Parent relationship (NOT primary scope)\n  createResourcesRelationship(\n    CustomShared_ResourceType.WILDO_APPLICATION, CustomShared_ResourceType.WILDO_APPLICATION_VERSIONS, \n    ResourceRelationshipCardinality.ONE, ResourceRelationshipCardinality.MANY,\n    { \n      nature: RelationshipNature.COMPOSITION,\n      contextPolicy: {\n        operationOverrides: {\n          [CoreResourceOperation.LIST]: { enabled: false },\n          [CoreResourceOperation.SEARCH]: { enabled: false },\n        }\n      },\n      childOperations: {\n        lifecycle: {\n          onParentDelete: { enabled: false }, // RETAIN as audit material (compliance decision 2026-07-29) — see the note at the top of this file.\n        }\n      }\n    }\n  ),\n\n  // Organizations → WildoApplicationActorSystemExecutions (1:N)\n  createResourcesRelationship(\n    CoreResourceType.ORGANIZATIONS,\n    CustomShared_ResourceType.WILDO_APPLICATION_ACTOR_SYSTEM_EXECUTIONS,\n    ResourceRelationshipCardinality.ONE,\n    ResourceRelationshipCardinality.MANY,\n    {\n      nature: RelationshipNature.COMPOSITION,\n      isPrimaryScope: true,\n      contextPolicy: {},\n    }\n  ),\n\n  // WildoApplication → WildoApplicationActorSystemExecutions (1:N)\n  createResourcesRelationship(\n    CustomShared_ResourceType.WILDO_APPLICATION,\n    CustomShared_ResourceType.WILDO_APPLICATION_ACTOR_SYSTEM_EXECUTIONS,\n    ResourceRelationshipCardinality.ONE,\n    ResourceRelationshipCardinality.MANY,\n    {\n      nature: RelationshipNature.COMPOSITION,\n      contextPolicy: {\n        operationOverrides: {\n          [CoreResourceOperation.LIST]: { enabled: false },\n          [CoreResourceOperation.SEARCH]: { enabled: false },\n        },\n      },\n      childOperations: {\n        lifecycle: {\n          onParentDelete: { enabled: false }, // RETAIN as audit material (compliance decision 2026-07-29) — see the note at the top of this file.\n        },\n      },\n    }\n  ),\n\n  // Organizations → WildoApplicationFlowSystemExecutions (1:N)\n  createResourcesRelationship(\n    CoreResourceType.ORGANIZATIONS,\n    CustomShared_ResourceType.WILDO_APPLICATION_FLOW_SYSTEM_EXECUTIONS,\n    ResourceRelationshipCardinality.ONE,\n    ResourceRelationshipCardinality.MANY,\n    {\n      nature: RelationshipNature.COMPOSITION,\n      isPrimaryScope: true,\n      contextPolicy: {},\n    }\n  ),\n\n  // WildoApplication → WildoApplicationFlowSystemExecutions (1:N)\n  createResourcesRelationship(\n    CustomShared_ResourceType.WILDO_APPLICATION,\n    CustomShared_ResourceType.WILDO_APPLICATION_FLOW_SYSTEM_EXECUTIONS,\n    ResourceRelationshipCardinality.ONE,\n    ResourceRelationshipCardinality.MANY,\n    {\n      nature: RelationshipNature.COMPOSITION,\n      contextPolicy: {\n        operationOverrides: {\n          [CoreResourceOperation.LIST]: { enabled: false },\n          [CoreResourceOperation.SEARCH]: { enabled: false },\n        },\n      },\n      childOperations: {\n        lifecycle: {\n          onParentDelete: { enabled: false }, // RETAIN as audit material (compliance decision 2026-07-29) — see the note at the top of this file.\n        },\n      },\n    }\n  ),\n\n  // Organizations → WildoApplicationActorTasks (1:N)\n  createResourcesRelationship(\n    CoreResourceType.ORGANIZATIONS,\n    CustomShared_ResourceType.WILDO_APPLICATION_ACTOR_TASKS,\n    ResourceRelationshipCardinality.ONE,\n    ResourceRelationshipCardinality.MANY,\n    {\n      nature: RelationshipNature.COMPOSITION,\n      isPrimaryScope: true,\n      contextPolicy: {},\n    }\n  ),\n\n  // WildoApplication → WildoApplicationActorTasks (1:N)\n  createResourcesRelationship(\n    CustomShared_ResourceType.WILDO_APPLICATION,\n    CustomShared_ResourceType.WILDO_APPLICATION_ACTOR_TASKS,\n    ResourceRelationshipCardinality.ONE,\n    ResourceRelationshipCardinality.MANY,\n    {\n      nature: RelationshipNature.COMPOSITION,\n      contextPolicy: {\n        operationOverrides: {\n          [CoreResourceOperation.LIST]: { enabled: false },\n          [CoreResourceOperation.SEARCH]: { enabled: false },\n        },\n      },\n      childOperations: {\n        lifecycle: {\n          onParentDelete: { enabled: false }, // RETAIN as audit material (compliance decision 2026-07-29) — see the note at the top of this file.\n        },\n      },\n    }\n  ),\n\n  // ActorSystemExecution → WildoApplicationActorTasks (1:N reference)\n  createResourcesRelationship(\n    CustomShared_ResourceType.WILDO_APPLICATION_ACTOR_SYSTEM_EXECUTIONS,\n    CustomShared_ResourceType.WILDO_APPLICATION_ACTOR_TASKS,\n    ResourceRelationshipCardinality.ONE,\n    ResourceRelationshipCardinality.MANY,\n    {\n      nature: RelationshipNature.REFERENCE,\n      foreignKeyField: 'wildoApplicationActorSystemExecutionId',\n      parentResourceRequirement: ResourceParentResourceRequirement.OPTIONAL,\n      contextPolicy: {},\n    }\n  ),\n];\n"]}
+{"version":3,"file":"resources-relationships.custom.shared.definitions.js","sourceRoot":"","sources":["../../../../src/core/resources/resources-relationships.custom.shared.definitions.ts"],"names":[],"mappings":"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","sourcesContent":["import { createResourcesRelationship, RelationshipNature, ResourceRelationship, ResourceRelationshipCardinality, CoreResourceType, CoreResourceOperation, ResourceParentResourceRequirement } from \"@wildo-ai/saas-models\";\nimport { CustomShared_ResourceType } from \"./resources-types.custom.shared.schemas\";\n\n/**\n * ⚠️ APPLICATION-CHILD RETENTION (compliance decision, Paul — 2026-07-29).\n *\n * `wildoApplicationVersions`, `wildoApplicationActorSystemExecutions`,\n * `wildoApplicationFlowSystemExecutions` and `wildoApplicationActorTasks` are RETAINED AS AUDIT\n * MATERIAL when their `wildoApplication` is deleted — the deployment/execution history of an\n * application outlives the application record itself. Every `onParentDelete` below is therefore\n * DISABLED.\n *\n * This also FIXES A LATENT BUG rather than merely expressing a preference: these children declare no\n * core DELETE op (`wildoApplicationVersions` exposes READ/LIST/CREATE only), so the cascade would have\n * thrown `ErrorType.CONFIGURATION` inside the parent's delete transaction and ROLLED BACK the\n * application delete as soon as one child row existed. Surfaced by the startup\n * composition-cascade-deletability guard on a live apps-manager boot (2026-07-29) — it was invisible to\n * the engine's regression test, which only rebuilds the CORE registry.\n *\n * A COMPOSITION without `onParentDelete` is an explicitly supported combination: the children are left\n * behind by design choice. The nature stays COMPOSITION because these rows genuinely belong to their\n * application; only the dies-with-parent behaviour is declined.\n */\nexport const customShared_ResourcesRelationships: ResourceRelationship[] = [\n  // ═══════════════════════════════════════════════════════════════════════════\n  // APPLICATION MANAGEMENT\n  // \n  // WildoApplication is a resource (not a scope). It represents applications\n  // created by users using the wildo-ai-application (the app factory).\n  // Primary scope for all resources is Organizations.\n  // ═══════════════════════════════════════════════════════════════════════════\n  \n  // Organizations → WildoApplication (1:N)\n  // Primary scope: Applications belong to organizations\n  createResourcesRelationship(\n    CoreResourceType.ORGANIZATIONS, CustomShared_ResourceType.WILDO_APPLICATION, \n    ResourceRelationshipCardinality.ONE, ResourceRelationshipCardinality.MANY,\n    { \n      nature: RelationshipNature.COMPOSITION,\n      isPrimaryScope: true,\n      contextPolicy: {}\n    }\n  ),\n\n  // Organizations → WildoApplicationVersions (1:N)\n  // Primary scope: Versions belong to organizations\n  createResourcesRelationship(\n    CoreResourceType.ORGANIZATIONS, CustomShared_ResourceType.WILDO_APPLICATION_VERSIONS, \n    ResourceRelationshipCardinality.ONE, ResourceRelationshipCardinality.MANY,\n    { \n      nature: RelationshipNature.COMPOSITION,\n      isPrimaryScope: true,\n      contextPolicy: {}\n    }\n  ),\n\n  // WildoApplication → WildoApplicationVersions (1:N)\n  // Parent relationship (NOT primary scope)\n  createResourcesRelationship(\n    CustomShared_ResourceType.WILDO_APPLICATION, CustomShared_ResourceType.WILDO_APPLICATION_VERSIONS, \n    ResourceRelationshipCardinality.ONE, ResourceRelationshipCardinality.MANY,\n    { \n      nature: RelationshipNature.COMPOSITION,\n      contextPolicy: {\n        operationOverrides: {\n          [CoreResourceOperation.LIST]: { enabled: false },\n          [CoreResourceOperation.SEARCH]: { enabled: false },\n        }\n      },\n      childOperations: {\n        lifecycle: {\n          onParentDelete: { enabled: false }, // RETAIN as audit material (compliance decision 2026-07-29) — see the note at the top of this file.\n        }\n      }\n    }\n  ),\n\n  // Organizations → WildoApplicationActorSystemExecutions (1:N)\n  createResourcesRelationship(\n    CoreResourceType.ORGANIZATIONS,\n    CustomShared_ResourceType.WILDO_APPLICATION_ACTOR_SYSTEM_EXECUTIONS,\n    ResourceRelationshipCardinality.ONE,\n    ResourceRelationshipCardinality.MANY,\n    {\n      nature: RelationshipNature.COMPOSITION,\n      isPrimaryScope: true,\n      contextPolicy: {},\n    }\n  ),\n\n  // WildoApplication → WildoApplicationActorSystemExecutions (1:N)\n  createResourcesRelationship(\n    CustomShared_ResourceType.WILDO_APPLICATION,\n    CustomShared_ResourceType.WILDO_APPLICATION_ACTOR_SYSTEM_EXECUTIONS,\n    ResourceRelationshipCardinality.ONE,\n    ResourceRelationshipCardinality.MANY,\n    {\n      nature: RelationshipNature.COMPOSITION,\n      contextPolicy: {\n        operationOverrides: {\n          [CoreResourceOperation.LIST]: { enabled: false },\n          [CoreResourceOperation.SEARCH]: { enabled: false },\n        },\n      },\n      childOperations: {\n        lifecycle: {\n          onParentDelete: { enabled: false }, // RETAIN as audit material (compliance decision 2026-07-29) — see the note at the top of this file.\n        },\n      },\n    }\n  ),\n\n  // Organizations → WildoApplicationFlowSystemExecutions (1:N)\n  createResourcesRelationship(\n    CoreResourceType.ORGANIZATIONS,\n    CustomShared_ResourceType.WILDO_APPLICATION_FLOW_SYSTEM_EXECUTIONS,\n    ResourceRelationshipCardinality.ONE,\n    ResourceRelationshipCardinality.MANY,\n    {\n      nature: RelationshipNature.COMPOSITION,\n      isPrimaryScope: true,\n      contextPolicy: {},\n    }\n  ),\n\n  // WildoApplication → WildoApplicationFlowSystemExecutions (1:N)\n  createResourcesRelationship(\n    CustomShared_ResourceType.WILDO_APPLICATION,\n    CustomShared_ResourceType.WILDO_APPLICATION_FLOW_SYSTEM_EXECUTIONS,\n    ResourceRelationshipCardinality.ONE,\n    ResourceRelationshipCardinality.MANY,\n    {\n      nature: RelationshipNature.COMPOSITION,\n      contextPolicy: {\n        operationOverrides: {\n          [CoreResourceOperation.LIST]: { enabled: false },\n          [CoreResourceOperation.SEARCH]: { enabled: false },\n        },\n      },\n      childOperations: {\n        lifecycle: {\n          onParentDelete: { enabled: false }, // RETAIN as audit material (compliance decision 2026-07-29) — see the note at the top of this file.\n        },\n      },\n    }\n  ),\n\n  // Organizations → WildoApplicationActorTasks (1:N)\n  createResourcesRelationship(\n    CoreResourceType.ORGANIZATIONS,\n    CustomShared_ResourceType.WILDO_APPLICATION_ACTOR_TASKS,\n    ResourceRelationshipCardinality.ONE,\n    ResourceRelationshipCardinality.MANY,\n    {\n      nature: RelationshipNature.COMPOSITION,\n      isPrimaryScope: true,\n      contextPolicy: {},\n    }\n  ),\n\n  // WildoApplication → WildoApplicationActorTasks (1:N)\n  createResourcesRelationship(\n    CustomShared_ResourceType.WILDO_APPLICATION,\n    CustomShared_ResourceType.WILDO_APPLICATION_ACTOR_TASKS,\n    ResourceRelationshipCardinality.ONE,\n    ResourceRelationshipCardinality.MANY,\n    {\n      nature: RelationshipNature.COMPOSITION,\n      contextPolicy: {\n        operationOverrides: {\n          [CoreResourceOperation.LIST]: { enabled: false },\n          [CoreResourceOperation.SEARCH]: { enabled: false },\n        },\n      },\n      childOperations: {\n        lifecycle: {\n          onParentDelete: { enabled: false }, // RETAIN as audit material (compliance decision 2026-07-29) — see the note at the top of this file.\n        },\n      },\n    }\n  ),\n\n  // ActorSystemExecution → WildoApplicationActorTasks (1:N reference)\n  createResourcesRelationship(\n    CustomShared_ResourceType.WILDO_APPLICATION_ACTOR_SYSTEM_EXECUTIONS,\n    CustomShared_ResourceType.WILDO_APPLICATION_ACTOR_TASKS,\n    ResourceRelationshipCardinality.ONE,\n    ResourceRelationshipCardinality.MANY,\n    {\n      nature: RelationshipNature.REFERENCE,\n      foreignKeyField: 'wildoApplicationActorSystemExecutionId',\n      parentResourceRequirement: ResourceParentResourceRequirement.OPTIONAL,\n      contextPolicy: {},\n    }\n  ),\n];\n"]}

package/dist/esm/core/resources/resources-types.custom.shared.schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resources-types.custom.shared.schemas.d.ts","sourceRoot":"","sources":["../../../../../src/core/resources/resources-types.custom.shared.schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,oBAAY,yBAAyB;IAEnC,iBAAiB,qBAAqB;IACtC,0BAA0B,6BAA6B;IACvD,yCAAyC,0CAA0C;IACnF,wCAAwC,yCAAyC;IACjF,6BAA6B,+BAA+B;CAC7D;AAED,eAAO,MAAM,oCAAoC,EAAE;KAAG,GAAG,IAAI,yBAAyB,GAAG,MAAM;CAO9F,CAAC"}
+{"version":3,"file":"resources-types.custom.shared.schemas.d.ts","sourceRoot":"","sources":["../../../../src/core/resources/resources-types.custom.shared.schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,oBAAY,yBAAyB;IAEnC,iBAAiB,qBAAqB;IACtC,0BAA0B,6BAA6B;IACvD,yCAAyC,0CAA0C;IACnF,wCAAwC,yCAAyC;IACjF,6BAA6B,+BAA+B;CAC7D;AAED,eAAO,MAAM,oCAAoC,EAAE;KAAG,GAAG,IAAI,yBAAyB,GAAG,MAAM;CAO9F,CAAC"}

package/dist/esm/core/resources/resources-types.custom.shared.schemas.js.map

@@ -1 +1 @@
-{"version":3,"file":"resources-types.custom.shared.schemas.js","sourceRoot":"","sources":["../../../../../src/core/resources/resources-types.custom.shared.schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,CAAN,IAAY,yBAOX;AAPD,WAAY,yBAAyB;IACnC,yBAAyB;IACzB,mEAAsC,CAAA;IACtC,oFAAuD,CAAA;IACvD,gHAAmF,CAAA;IACnF,8GAAiF,CAAA;IACjF,yFAA4D,CAAA;AAC9D,CAAC,EAPW,yBAAyB,KAAzB,yBAAyB,QAOpC;AAED,MAAM,CAAC,MAAM,oCAAoC,GAAmD;IAClG,yBAAyB;IACzB,CAAC,yBAAyB,CAAC,iBAAiB,CAAC,EAAE,oBAAoB;IACnE,CAAC,yBAAyB,CAAC,0BAA0B,CAAC,EAAE,2BAA2B;IACnF,CAAC,yBAAyB,CAAC,yCAAyC,CAAC,EAAE,wCAAwC;IAC/G,CAAC,yBAAyB,CAAC,wCAAwC,CAAC,EAAE,uCAAuC;IAC7G,CAAC,yBAAyB,CAAC,6BAA6B,CAAC,EAAE,6BAA6B;CACzF,CAAC","sourcesContent":["/**\n * Shared platform resource types that still participate in the active\n * platform resource registry.\n *\n * Deprecated WAML meta-resources were intentionally removed from this enum:\n * they no longer have live resource configuration factories in the platform,\n * and the archived implementation remains in code archives for future reuse.\n */\nexport enum CustomShared_ResourceType {\n  // Application management\n  WILDO_APPLICATION = 'wildoApplication',\n  WILDO_APPLICATION_VERSIONS = 'wildoApplicationVersions',\n  WILDO_APPLICATION_ACTOR_SYSTEM_EXECUTIONS = 'wildoApplicationActorSystemExecutions',\n  WILDO_APPLICATION_FLOW_SYSTEM_EXECUTIONS = 'wildoApplicationFlowSystemExecutions',\n  WILDO_APPLICATION_ACTOR_TASKS = 'wildoApplicationActorTasks',\n}\n\nexport const CustomShared_ResourceFieldIdentifier: { [key in CustomShared_ResourceType]: string } = {\n  // Application management\n  [CustomShared_ResourceType.WILDO_APPLICATION]: 'wildoApplicationId',\n  [CustomShared_ResourceType.WILDO_APPLICATION_VERSIONS]: 'wildoApplicationVersionId',\n  [CustomShared_ResourceType.WILDO_APPLICATION_ACTOR_SYSTEM_EXECUTIONS]: 'wildoApplicationActorSystemExecutionId',\n  [CustomShared_ResourceType.WILDO_APPLICATION_FLOW_SYSTEM_EXECUTIONS]: 'wildoApplicationFlowSystemExecutionId',\n  [CustomShared_ResourceType.WILDO_APPLICATION_ACTOR_TASKS]: 'wildoApplicationActorTaskId',\n};\n"]}
+{"version":3,"file":"resources-types.custom.shared.schemas.js","sourceRoot":"","sources":["../../../../src/core/resources/resources-types.custom.shared.schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,CAAN,IAAY,yBAOX;AAPD,WAAY,yBAAyB;IACnC,yBAAyB;IACzB,mEAAsC,CAAA;IACtC,oFAAuD,CAAA;IACvD,gHAAmF,CAAA;IACnF,8GAAiF,CAAA;IACjF,yFAA4D,CAAA;AAC9D,CAAC,EAPW,yBAAyB,KAAzB,yBAAyB,QAOpC;AAED,MAAM,CAAC,MAAM,oCAAoC,GAAmD;IAClG,yBAAyB;IACzB,CAAC,yBAAyB,CAAC,iBAAiB,CAAC,EAAE,oBAAoB;IACnE,CAAC,yBAAyB,CAAC,0BAA0B,CAAC,EAAE,2BAA2B;IACnF,CAAC,yBAAyB,CAAC,yCAAyC,CAAC,EAAE,wCAAwC;IAC/G,CAAC,yBAAyB,CAAC,wCAAwC,CAAC,EAAE,uCAAuC;IAC7G,CAAC,yBAAyB,CAAC,6BAA6B,CAAC,EAAE,6BAA6B;CACzF,CAAC","sourcesContent":["/**\n * Shared platform resource types that still participate in the active\n * platform resource registry.\n *\n * Deprecated WAML meta-resources were intentionally removed from this enum:\n * they no longer have live resource configuration factories in the platform,\n * and the archived implementation remains in code archives for future reuse.\n */\nexport enum CustomShared_ResourceType {\n  // Application management\n  WILDO_APPLICATION = 'wildoApplication',\n  WILDO_APPLICATION_VERSIONS = 'wildoApplicationVersions',\n  WILDO_APPLICATION_ACTOR_SYSTEM_EXECUTIONS = 'wildoApplicationActorSystemExecutions',\n  WILDO_APPLICATION_FLOW_SYSTEM_EXECUTIONS = 'wildoApplicationFlowSystemExecutions',\n  WILDO_APPLICATION_ACTOR_TASKS = 'wildoApplicationActorTasks',\n}\n\nexport const CustomShared_ResourceFieldIdentifier: { [key in CustomShared_ResourceType]: string } = {\n  // Application management\n  [CustomShared_ResourceType.WILDO_APPLICATION]: 'wildoApplicationId',\n  [CustomShared_ResourceType.WILDO_APPLICATION_VERSIONS]: 'wildoApplicationVersionId',\n  [CustomShared_ResourceType.WILDO_APPLICATION_ACTOR_SYSTEM_EXECUTIONS]: 'wildoApplicationActorSystemExecutionId',\n  [CustomShared_ResourceType.WILDO_APPLICATION_FLOW_SYSTEM_EXECUTIONS]: 'wildoApplicationFlowSystemExecutionId',\n  [CustomShared_ResourceType.WILDO_APPLICATION_ACTOR_TASKS]: 'wildoApplicationActorTaskId',\n};\n"]}

package/dist/esm/dev-runtime/dependency-install-record.d.ts

@@ -0,0 +1,111 @@
+import { LocalDevDependencyInstallPhase, type LocalDevDependencyInstallRecord } from '../runtime/local-dev-runtime-signals.contracts';
+/**
+ * A dependency install is a STACK EVENT (#3552): the file-system half of {@link LocalDevDependencyInstallRecord_Schema},
+ * and the two decisions every dev-loop reader takes from it.
+ *
+ * The installer brackets its install with {@link withDependencyInstallRecord} (or {@link withDependencyInstallRecordSync}
+ * for a synchronous one). The readers are the runtime supervisors and the compile loops of BOTH dev loops: this package's
+ * `NodeRuntimeDevSupervisor` and `PackageCompileLoop` for an app-creator install, and the monorepo's
+ * `runtime-supervisor.mjs` and `local-dev-compile-observer.mjs` for a framework developer. The monorepo scripts are
+ * dependency-free and keep their own copy of {@link classifyDependencyInstall} and the two decisions in
+ * `scripts/dev-orchestrator/local-dev-protocol.mjs`; `dev-runtime-decisions.test.ts` runs both copies over the same cases.
+ */
+/** Where the record lives in an application. */
+export declare function dependencyInstallRecordPath(appRoot: string): string;
+/** The record, or undefined when there is none or it is not one this protocol version reads. */
+export declare function readDependencyInstallRecord(appRoot: string): LocalDevDependencyInstallRecord | undefined;
+/** Where an install stands, and the instants a reader compares against. */
+export interface DependencyInstallStatus {
+    readonly phase: LocalDevDependencyInstallPhase;
+    /** Identifies ONE install (`<pid>:<startedAt ms>`), so a reader acts once per install; `null` when there is none. */
+    readonly key: string | null;
+    readonly startedAtMs: number | null;
+    /**
+     * When the install is taken to have ended (`ENDED` only): its `finishedAt`; its deadline when it outlived it; its
+     * START when its writer died without finishing. The last is deliberately early: the end of a killed install cannot be
+     * known, and any later instant would make every compile that starts before it look stale, so a reader would restart
+     * it over and over. A watcher that compiled DURING a killed install is therefore not restarted by this rule, a
+     * residual of a writer that was SIGKILLed mid-install.
+     */
+    readonly endedAtMs: number | null;
+}
+/**
+ * Judge a record. Pure but for `isAlive`, which a test replaces. A record that does not parse is NONE: a reader that
+ * cannot read the signal behaves as it did before the signal existed, never holds the stack on it.
+ */
+export declare function classifyDependencyInstall(record: LocalDevDependencyInstallRecord | undefined, nowMs: number, isAlive?: (pid: number) => boolean): DependencyInstallStatus;
+/** What a runtime supervisor does about the application's dependency install. */
+export declare enum RuntimeDependencyInstallDecision {
+    /** Nothing: no install, or this one was already acted on, or the runtime started after it. */
+    NONE = "NONE",
+    /** An install is running: start nothing, restart nothing, and do not count a crash against the budget. */
+    HOLD = "HOLD",
+    /** The install ended after the runtime started (or while it was down): relaunch it with a fresh crash budget. */
+    RELAUNCH = "RELAUNCH"
+}
+/**
+ * The supervisor's decision. `runtimeStartedAtMs` is when the current (or last) runtime child was started, `0` when none
+ * ever was. `handledInstallKey` is the install this supervisor already acted on: seed it, at the supervisor's own start,
+ * with the key of an install that had ALREADY ended, so a supervisor started after an install does not relaunch onto it.
+ */
+export declare function decideRuntimeAfterDependencyInstall(input: {
+    readonly install: DependencyInstallStatus;
+    readonly runtimeStartedAtMs: number;
+    readonly handledInstallKey: string | null;
+}): RuntimeDependencyInstallDecision;
+/**
+ * The file pnpm rewrites at the END of every install in a workspace, application-relative. Its modification time is
+ * when the workspace's `node_modules` last finished changing, whoever ran the install.
+ */
+export declare const PNPM_MODULES_MANIFEST_RELATIVE_PATH = "node_modules/.modules.yaml";
+/** When pnpm last finished an install in the application, or null when it never did (or the file cannot be read). */
+export declare function readNodeModulesInstalledAtMs(appRoot: string): number | null;
+/**
+ * Whether a package's compile watcher must be restarted because an install ended after it last read the tree: its
+ * latest compilation (or, when it has none yet, its own start) began before the install ended.
+ *
+ * Two witnesses of an install's end, and the later wins. The RECORD names an install a Wildo tool ran (the foundation
+ * step, the CLI). pnpm's own {@link PNPM_MODULES_MANIFEST_RELATIVE_PATH} names EVERY install, including one a coding
+ * agent or a person ran by hand, which writes no record: reference run 42713670241 (2026-11-10) had a mid-run install
+ * leave the frontend library and the specifications on `TS6053 lib.dom.d.ts not found` / `TS2318 Cannot find global type
+ * 'Array'` — a live `tsc --watch` whose TypeScript lib vanished under it — and they never compiled again: the library's
+ * dist stayed 20 hours stale and blocked 80 build tasks. Nothing the watcher watches changes after such an install, so
+ * only the install's own end can wake it.
+ *
+ * A FAILED watcher is judged by its PROCESS start alone. The same run's frontend library watcher compiled ONE more cycle
+ * after the install ended, failed it again on the lib it had lost, and went silent: a compiler that saw its toolchain
+ * disappear keeps that state in memory, so a compile it runs after the install proves nothing. A READY watcher's
+ * post-install compile did read the whole tree, so for it the latest compile start counts too.
+ *
+ * Self-limiting: the restarted watcher starts after the install ended, so the rule does not fire for it again. Never
+ * while a recorded install is still in flight, which would only compile the half-installed tree once more. Driven by
+ * the reader's own timer (the observer's heartbeat, the compile loop's check), never by a later compile, which may not
+ * come.
+ */
+export declare function compilerReadTreeBeforeDependencyInstallEnded(input: {
+    readonly install: DependencyInstallStatus;
+    /** {@link readNodeModulesInstalledAtMs}; omitted or null when unknown. */
+    readonly nodeModulesInstalledAtMs?: number | null;
+    readonly lastCompilationStartedAtMs: number | null;
+    readonly watcherStartedAtMs: number;
+    /** Whether the watcher's latest compile FAILED (see above). */
+    readonly compilerFailed?: boolean;
+}): boolean;
+/** The longest an install is trusted to run before readers stop holding for it, when the installer names no bound. */
+export declare const DEFAULT_DEPENDENCY_INSTALL_DEADLINE_MS: number;
+export interface DependencyInstallRecordOptions {
+    /** Who installs, recorded for a reader: `foundation`, `wildo update`, … */
+    readonly initiator: string;
+    /** The install's own bound; the deadline is this plus a minute of slack. Default {@link DEFAULT_DEPENDENCY_INSTALL_DEADLINE_MS}. */
+    readonly timeoutMs?: number;
+    /** Reports a record that could not be written. The install runs either way. */
+    readonly reportFailure?: (message: string, error: unknown) => void;
+}
+/**
+ * Run an install bracketed by the record. The record never fails the install: a write that fails is reported and the
+ * install runs as it would have without it. A throwing install is recorded as failed and rethrown.
+ */
+export declare function withDependencyInstallRecord<T>(appRoot: string, options: DependencyInstallRecordOptions, install: () => Promise<T>): Promise<T>;
+/** {@link withDependencyInstallRecord} for a synchronous install, whose result says whether it succeeded. */
+export declare function withDependencyInstallRecordSync(appRoot: string, options: DependencyInstallRecordOptions, install: () => boolean): boolean;
+//# sourceMappingURL=dependency-install-record.d.ts.map

package/dist/esm/dev-runtime/dependency-install-record.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependency-install-record.d.ts","sourceRoot":"","sources":["../../../src/dev-runtime/dependency-install-record.ts"],"names":[],"mappings":"AAGA,OAAO,EAKL,8BAA8B,EAE9B,KAAK,+BAA+B,EACrC,MAAM,gDAAgD,CAAC;AAIxD;;;;;;;;;;GAUG;AAEH,gDAAgD;AAChD,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEnE;AAED,gGAAgG;AAChG,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,MAAM,GAAG,+BAA+B,GAAG,SAAS,CAOxG;AAED,2EAA2E;AAC3E,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,KAAK,EAAE,8BAA8B,CAAC;IAC/C,qHAAqH;IACrH,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC;;;;;;OAMG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CACnC;AAID;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,+BAA+B,GAAG,SAAS,EACnD,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAwB,GACjD,uBAAuB,CAWzB;AAED,iFAAiF;AACjF,oBAAY,gCAAgC;IAC1C,8FAA8F;IAC9F,IAAI,SAAS;IACb,0GAA0G;IAC1G,IAAI,SAAS;IACb,iHAAiH;IACjH,QAAQ,aAAa;CACtB;AAED;;;;GAIG;AACH,wBAAgB,mCAAmC,CAAC,KAAK,EAAE;IACzD,QAAQ,CAAC,OAAO,EAAE,uBAAuB,CAAC;IAC1C,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3C,GAAG,gCAAgC,CAOnC;AAED;;;GAGG;AACH,eAAO,MAAM,mCAAmC,+BAA+B,CAAC;AAEhF,qHAAqH;AACrH,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAM3E;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,4CAA4C,CAAC,KAAK,EAAE;IAClE,QAAQ,CAAC,OAAO,EAAE,uBAAuB,CAAC;IAC1C,0EAA0E;IAC1E,QAAQ,CAAC,wBAAwB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAClD,QAAQ,CAAC,0BAA0B,EAAE,MAAM,GAAG,IAAI,CAAC;IACnD,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,+DAA+D;IAC/D,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;CACnC,GAAG,OAAO,CAWV;AAED,sHAAsH;AACtH,eAAO,MAAM,sCAAsC,QAAc,CAAC;AAElE,MAAM,WAAW,8BAA8B;IAC7C,2EAA2E;IAC3E,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,oIAAoI;IACpI,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,+EAA+E;IAC/E,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CACpE;AAsCD;;;GAGG;AACH,wBAAsB,2BAA2B,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,8BAA8B,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAUpJ;AAED,6GAA6G;AAC7G,wBAAgB,+BAA+B,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,8BAA8B,EAAE,OAAO,EAAE,MAAM,OAAO,GAAG,OAAO,CASzI"}

package/dist/esm/dev-runtime/dependency-install-record.js

@@ -0,0 +1,185 @@
+import { existsSync, readFileSync, statSync } from 'node:fs';
+import { join } from 'node:path';
+import { APPLICATION_RUNTIME_SIGNALS_RELATIVE_DIRECTORY, LOCAL_DEV_DEPENDENCY_INSTALL_RECORD_FILE, LOCAL_DEV_DEPENDENCY_INSTALL_RECORD_KIND, LOCAL_DEV_RUNTIME_SIGNALS_PROTOCOL_VERSION, LocalDevDependencyInstallPhase, LocalDevDependencyInstallRecord_Schema, } from '../runtime/local-dev-runtime-signals.contracts.js';
+import { isProcessAlive } from './dev-runtime-processes.js';
+import { APPLICATION_ROOT_MARKER, writeRuntimeSignalRecord } from './dev-runtime-signals.js';
+/**
+ * A dependency install is a STACK EVENT (#3552): the file-system half of {@link LocalDevDependencyInstallRecord_Schema},
+ * and the two decisions every dev-loop reader takes from it.
+ *
+ * The installer brackets its install with {@link withDependencyInstallRecord} (or {@link withDependencyInstallRecordSync}
+ * for a synchronous one). The readers are the runtime supervisors and the compile loops of BOTH dev loops: this package's
+ * `NodeRuntimeDevSupervisor` and `PackageCompileLoop` for an app-creator install, and the monorepo's
+ * `runtime-supervisor.mjs` and `local-dev-compile-observer.mjs` for a framework developer. The monorepo scripts are
+ * dependency-free and keep their own copy of {@link classifyDependencyInstall} and the two decisions in
+ * `scripts/dev-orchestrator/local-dev-protocol.mjs`; `dev-runtime-decisions.test.ts` runs both copies over the same cases.
+ */
+/** Where the record lives in an application. */
+export function dependencyInstallRecordPath(appRoot) {
+    return join(appRoot, APPLICATION_RUNTIME_SIGNALS_RELATIVE_DIRECTORY, LOCAL_DEV_DEPENDENCY_INSTALL_RECORD_FILE);
+}
+/** The record, or undefined when there is none or it is not one this protocol version reads. */
+export function readDependencyInstallRecord(appRoot) {
+    try {
+        const parsed = LocalDevDependencyInstallRecord_Schema.safeParse(JSON.parse(readFileSync(dependencyInstallRecordPath(appRoot), 'utf8')));
+        return parsed.success ? parsed.data : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+const NO_INSTALL = { phase: LocalDevDependencyInstallPhase.NONE, key: null, startedAtMs: null, endedAtMs: null };
+/**
+ * Judge a record. Pure but for `isAlive`, which a test replaces. A record that does not parse is NONE: a reader that
+ * cannot read the signal behaves as it did before the signal existed, never holds the stack on it.
+ */
+export function classifyDependencyInstall(record, nowMs, isAlive = isProcessAlive) {
+    if (record === undefined)
+        return NO_INSTALL;
+    const startedAtMs = Date.parse(record.startedAt);
+    const deadlineAtMs = Date.parse(record.deadlineAt);
+    if (!Number.isFinite(startedAtMs) || !Number.isFinite(deadlineAtMs))
+        return NO_INSTALL;
+    const key = `${record.pid}:${startedAtMs}`;
+    const finishedAtMs = record.finishedAt === null ? Number.NaN : Date.parse(record.finishedAt);
+    if (Number.isFinite(finishedAtMs))
+        return { phase: LocalDevDependencyInstallPhase.ENDED, key, startedAtMs, endedAtMs: finishedAtMs };
+    if (nowMs >= deadlineAtMs)
+        return { phase: LocalDevDependencyInstallPhase.ENDED, key, startedAtMs, endedAtMs: deadlineAtMs };
+    if (!isAlive(record.pid))
+        return { phase: LocalDevDependencyInstallPhase.ENDED, key, startedAtMs, endedAtMs: startedAtMs };
+    return { phase: LocalDevDependencyInstallPhase.IN_FLIGHT, key, startedAtMs, endedAtMs: null };
+}
+/** What a runtime supervisor does about the application's dependency install. */
+export var RuntimeDependencyInstallDecision;
+(function (RuntimeDependencyInstallDecision) {
+    /** Nothing: no install, or this one was already acted on, or the runtime started after it. */
+    RuntimeDependencyInstallDecision["NONE"] = "NONE";
+    /** An install is running: start nothing, restart nothing, and do not count a crash against the budget. */
+    RuntimeDependencyInstallDecision["HOLD"] = "HOLD";
+    /** The install ended after the runtime started (or while it was down): relaunch it with a fresh crash budget. */
+    RuntimeDependencyInstallDecision["RELAUNCH"] = "RELAUNCH";
+})(RuntimeDependencyInstallDecision || (RuntimeDependencyInstallDecision = {}));
+/**
+ * The supervisor's decision. `runtimeStartedAtMs` is when the current (or last) runtime child was started, `0` when none
+ * ever was. `handledInstallKey` is the install this supervisor already acted on: seed it, at the supervisor's own start,
+ * with the key of an install that had ALREADY ended, so a supervisor started after an install does not relaunch onto it.
+ */
+export function decideRuntimeAfterDependencyInstall(input) {
+    const { install } = input;
+    if (install.phase === LocalDevDependencyInstallPhase.IN_FLIGHT)
+        return RuntimeDependencyInstallDecision.HOLD;
+    if (install.phase !== LocalDevDependencyInstallPhase.ENDED || install.key === input.handledInstallKey || install.endedAtMs === null) {
+        return RuntimeDependencyInstallDecision.NONE;
+    }
+    return input.runtimeStartedAtMs < install.endedAtMs ? RuntimeDependencyInstallDecision.RELAUNCH : RuntimeDependencyInstallDecision.NONE;
+}
+/**
+ * The file pnpm rewrites at the END of every install in a workspace, application-relative. Its modification time is
+ * when the workspace's `node_modules` last finished changing, whoever ran the install.
+ */
+export const PNPM_MODULES_MANIFEST_RELATIVE_PATH = 'node_modules/.modules.yaml';
+/** When pnpm last finished an install in the application, or null when it never did (or the file cannot be read). */
+export function readNodeModulesInstalledAtMs(appRoot) {
+    try {
+        return statSync(join(appRoot, PNPM_MODULES_MANIFEST_RELATIVE_PATH)).mtimeMs;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Whether a package's compile watcher must be restarted because an install ended after it last read the tree: its
+ * latest compilation (or, when it has none yet, its own start) began before the install ended.
+ *
+ * Two witnesses of an install's end, and the later wins. The RECORD names an install a Wildo tool ran (the foundation
+ * step, the CLI). pnpm's own {@link PNPM_MODULES_MANIFEST_RELATIVE_PATH} names EVERY install, including one a coding
+ * agent or a person ran by hand, which writes no record: reference run 42713670241 (2026-11-10) had a mid-run install
+ * leave the frontend library and the specifications on `TS6053 lib.dom.d.ts not found` / `TS2318 Cannot find global type
+ * 'Array'` — a live `tsc --watch` whose TypeScript lib vanished under it — and they never compiled again: the library's
+ * dist stayed 20 hours stale and blocked 80 build tasks. Nothing the watcher watches changes after such an install, so
+ * only the install's own end can wake it.
+ *
+ * A FAILED watcher is judged by its PROCESS start alone. The same run's frontend library watcher compiled ONE more cycle
+ * after the install ended, failed it again on the lib it had lost, and went silent: a compiler that saw its toolchain
+ * disappear keeps that state in memory, so a compile it runs after the install proves nothing. A READY watcher's
+ * post-install compile did read the whole tree, so for it the latest compile start counts too.
+ *
+ * Self-limiting: the restarted watcher starts after the install ended, so the rule does not fire for it again. Never
+ * while a recorded install is still in flight, which would only compile the half-installed tree once more. Driven by
+ * the reader's own timer (the observer's heartbeat, the compile loop's check), never by a later compile, which may not
+ * come.
+ */
+export function compilerReadTreeBeforeDependencyInstallEnded(input) {
+    const { install } = input;
+    if (install.phase === LocalDevDependencyInstallPhase.IN_FLIGHT)
+        return false;
+    const endedAtMs = Math.max(install.phase === LocalDevDependencyInstallPhase.ENDED && install.endedAtMs !== null ? install.endedAtMs : 0, input.nodeModulesInstalledAtMs ?? 0);
+    if (endedAtMs <= 0)
+        return false;
+    const watcherStartedAtMs = Number.isFinite(input.watcherStartedAtMs) ? input.watcherStartedAtMs : 0;
+    const lastReadAtMs = input.compilerFailed === true ? watcherStartedAtMs : Math.max(input.lastCompilationStartedAtMs ?? 0, watcherStartedAtMs);
+    return lastReadAtMs > 0 && lastReadAtMs < endedAtMs;
+}
+/** The longest an install is trusted to run before readers stop holding for it, when the installer names no bound. */
+export const DEFAULT_DEPENDENCY_INSTALL_DEADLINE_MS = 30 * 60_000;
+/** Start an install record; returns the closer. A root that is not an application gets no record (and a no-op closer). */
+function openDependencyInstallRecord(appRoot, options) {
+    if (!existsSync(join(appRoot, APPLICATION_ROOT_MARKER)))
+        return () => undefined;
+    const path = dependencyInstallRecordPath(appRoot);
+    const started = new Date();
+    // Spelled out rather than `Omit<…>`: the record schema is loose (an index signature), and `Omit` over it drops every key.
+    const base = {
+        kind: LOCAL_DEV_DEPENDENCY_INSTALL_RECORD_KIND,
+        schemaVersion: LOCAL_DEV_RUNTIME_SIGNALS_PROTOCOL_VERSION,
+        pid: process.pid,
+        startedAt: started.toISOString(),
+        deadlineAt: new Date(started.getTime() + (options.timeoutMs ?? DEFAULT_DEPENDENCY_INSTALL_DEADLINE_MS) + 60_000).toISOString(),
+        initiator: options.initiator,
+    };
+    const write = (record) => {
+        try {
+            writeRuntimeSignalRecord(path, record);
+        }
+        catch (error) {
+            try {
+                options.reportFailure?.('The dependency-install record could not be written; the dev loop will not know about this install', error);
+            }
+            catch {
+                // Reporting is a courtesy.
+            }
+        }
+    };
+    write({ ...base, finishedAt: null, succeeded: null });
+    return (succeeded) => write({ ...base, finishedAt: new Date().toISOString(), succeeded });
+}
+/**
+ * Run an install bracketed by the record. The record never fails the install: a write that fails is reported and the
+ * install runs as it would have without it. A throwing install is recorded as failed and rethrown.
+ */
+export async function withDependencyInstallRecord(appRoot, options, install) {
+    const close = openDependencyInstallRecord(appRoot, options);
+    let succeeded = false;
+    try {
+        const result = await install();
+        succeeded = true;
+        return result;
+    }
+    finally {
+        close(succeeded);
+    }
+}
+/** {@link withDependencyInstallRecord} for a synchronous install, whose result says whether it succeeded. */
+export function withDependencyInstallRecordSync(appRoot, options, install) {
+    const close = openDependencyInstallRecord(appRoot, options);
+    let succeeded = false;
+    try {
+        succeeded = install();
+        return succeeded;
+    }
+    finally {
+        close(succeeded);
+    }
+}
+//# sourceMappingURL=dependency-install-record.js.map

package/dist/esm/dev-runtime/dependency-install-record.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependency-install-record.js","sourceRoot":"","sources":["../../../src/dev-runtime/dependency-install-record.ts"],"names":[],"mappings":"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","sourcesContent":["import { existsSync, readFileSync, statSync } from 'node:fs';\nimport { join } from 'node:path';\n\nimport {\n  APPLICATION_RUNTIME_SIGNALS_RELATIVE_DIRECTORY,\n  LOCAL_DEV_DEPENDENCY_INSTALL_RECORD_FILE,\n  LOCAL_DEV_DEPENDENCY_INSTALL_RECORD_KIND,\n  LOCAL_DEV_RUNTIME_SIGNALS_PROTOCOL_VERSION,\n  LocalDevDependencyInstallPhase,\n  LocalDevDependencyInstallRecord_Schema,\n  type LocalDevDependencyInstallRecord,\n} from '../runtime/local-dev-runtime-signals.contracts';\nimport { isProcessAlive } from './dev-runtime-processes';\nimport { APPLICATION_ROOT_MARKER, writeRuntimeSignalRecord } from './dev-runtime-signals';\n\n/**\n * A dependency install is a STACK EVENT (#3552): the file-system half of {@link LocalDevDependencyInstallRecord_Schema},\n * and the two decisions every dev-loop reader takes from it.\n *\n * The installer brackets its install with {@link withDependencyInstallRecord} (or {@link withDependencyInstallRecordSync}\n * for a synchronous one). The readers are the runtime supervisors and the compile loops of BOTH dev loops: this package's\n * `NodeRuntimeDevSupervisor` and `PackageCompileLoop` for an app-creator install, and the monorepo's\n * `runtime-supervisor.mjs` and `local-dev-compile-observer.mjs` for a framework developer. The monorepo scripts are\n * dependency-free and keep their own copy of {@link classifyDependencyInstall} and the two decisions in\n * `scripts/dev-orchestrator/local-dev-protocol.mjs`; `dev-runtime-decisions.test.ts` runs both copies over the same cases.\n */\n\n/** Where the record lives in an application. */\nexport function dependencyInstallRecordPath(appRoot: string): string {\n  return join(appRoot, APPLICATION_RUNTIME_SIGNALS_RELATIVE_DIRECTORY, LOCAL_DEV_DEPENDENCY_INSTALL_RECORD_FILE);\n}\n\n/** The record, or undefined when there is none or it is not one this protocol version reads. */\nexport function readDependencyInstallRecord(appRoot: string): LocalDevDependencyInstallRecord | undefined {\n  try {\n    const parsed = LocalDevDependencyInstallRecord_Schema.safeParse(JSON.parse(readFileSync(dependencyInstallRecordPath(appRoot), 'utf8')));\n    return parsed.success ? parsed.data : undefined;\n  } catch {\n    return undefined;\n  }\n}\n\n/** Where an install stands, and the instants a reader compares against. */\nexport interface DependencyInstallStatus {\n  readonly phase: LocalDevDependencyInstallPhase;\n  /** Identifies ONE install (`<pid>:<startedAt ms>`), so a reader acts once per install; `null` when there is none. */\n  readonly key: string | null;\n  readonly startedAtMs: number | null;\n  /**\n   * When the install is taken to have ended (`ENDED` only): its `finishedAt`; its deadline when it outlived it; its\n   * START when its writer died without finishing. The last is deliberately early: the end of a killed install cannot be\n   * known, and any later instant would make every compile that starts before it look stale, so a reader would restart\n   * it over and over. A watcher that compiled DURING a killed install is therefore not restarted by this rule, a\n   * residual of a writer that was SIGKILLed mid-install.\n   */\n  readonly endedAtMs: number | null;\n}\n\nconst NO_INSTALL: DependencyInstallStatus = { phase: LocalDevDependencyInstallPhase.NONE, key: null, startedAtMs: null, endedAtMs: null };\n\n/**\n * Judge a record. Pure but for `isAlive`, which a test replaces. A record that does not parse is NONE: a reader that\n * cannot read the signal behaves as it did before the signal existed, never holds the stack on it.\n */\nexport function classifyDependencyInstall(\n  record: LocalDevDependencyInstallRecord | undefined,\n  nowMs: number,\n  isAlive: (pid: number) => boolean = isProcessAlive,\n): DependencyInstallStatus {\n  if (record === undefined) return NO_INSTALL;\n  const startedAtMs = Date.parse(record.startedAt);\n  const deadlineAtMs = Date.parse(record.deadlineAt);\n  if (!Number.isFinite(startedAtMs) || !Number.isFinite(deadlineAtMs)) return NO_INSTALL;\n  const key = `${record.pid}:${startedAtMs}`;\n  const finishedAtMs = record.finishedAt === null ? Number.NaN : Date.parse(record.finishedAt);\n  if (Number.isFinite(finishedAtMs)) return { phase: LocalDevDependencyInstallPhase.ENDED, key, startedAtMs, endedAtMs: finishedAtMs };\n  if (nowMs >= deadlineAtMs) return { phase: LocalDevDependencyInstallPhase.ENDED, key, startedAtMs, endedAtMs: deadlineAtMs };\n  if (!isAlive(record.pid)) return { phase: LocalDevDependencyInstallPhase.ENDED, key, startedAtMs, endedAtMs: startedAtMs };\n  return { phase: LocalDevDependencyInstallPhase.IN_FLIGHT, key, startedAtMs, endedAtMs: null };\n}\n\n/** What a runtime supervisor does about the application's dependency install. */\nexport enum RuntimeDependencyInstallDecision {\n  /** Nothing: no install, or this one was already acted on, or the runtime started after it. */\n  NONE = 'NONE',\n  /** An install is running: start nothing, restart nothing, and do not count a crash against the budget. */\n  HOLD = 'HOLD',\n  /** The install ended after the runtime started (or while it was down): relaunch it with a fresh crash budget. */\n  RELAUNCH = 'RELAUNCH',\n}\n\n/**\n * The supervisor's decision. `runtimeStartedAtMs` is when the current (or last) runtime child was started, `0` when none\n * ever was. `handledInstallKey` is the install this supervisor already acted on: seed it, at the supervisor's own start,\n * with the key of an install that had ALREADY ended, so a supervisor started after an install does not relaunch onto it.\n */\nexport function decideRuntimeAfterDependencyInstall(input: {\n  readonly install: DependencyInstallStatus;\n  readonly runtimeStartedAtMs: number;\n  readonly handledInstallKey: string | null;\n}): RuntimeDependencyInstallDecision {\n  const { install } = input;\n  if (install.phase === LocalDevDependencyInstallPhase.IN_FLIGHT) return RuntimeDependencyInstallDecision.HOLD;\n  if (install.phase !== LocalDevDependencyInstallPhase.ENDED || install.key === input.handledInstallKey || install.endedAtMs === null) {\n    return RuntimeDependencyInstallDecision.NONE;\n  }\n  return input.runtimeStartedAtMs < install.endedAtMs ? RuntimeDependencyInstallDecision.RELAUNCH : RuntimeDependencyInstallDecision.NONE;\n}\n\n/**\n * The file pnpm rewrites at the END of every install in a workspace, application-relative. Its modification time is\n * when the workspace's `node_modules` last finished changing, whoever ran the install.\n */\nexport const PNPM_MODULES_MANIFEST_RELATIVE_PATH = 'node_modules/.modules.yaml';\n\n/** When pnpm last finished an install in the application, or null when it never did (or the file cannot be read). */\nexport function readNodeModulesInstalledAtMs(appRoot: string): number | null {\n  try {\n    return statSync(join(appRoot, PNPM_MODULES_MANIFEST_RELATIVE_PATH)).mtimeMs;\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Whether a package's compile watcher must be restarted because an install ended after it last read the tree: its\n * latest compilation (or, when it has none yet, its own start) began before the install ended.\n *\n * Two witnesses of an install's end, and the later wins. The RECORD names an install a Wildo tool ran (the foundation\n * step, the CLI). pnpm's own {@link PNPM_MODULES_MANIFEST_RELATIVE_PATH} names EVERY install, including one a coding\n * agent or a person ran by hand, which writes no record: reference run 42713670241 (2026-11-10) had a mid-run install\n * leave the frontend library and the specifications on `TS6053 lib.dom.d.ts not found` / `TS2318 Cannot find global type\n * 'Array'` — a live `tsc --watch` whose TypeScript lib vanished under it — and they never compiled again: the library's\n * dist stayed 20 hours stale and blocked 80 build tasks. Nothing the watcher watches changes after such an install, so\n * only the install's own end can wake it.\n *\n * A FAILED watcher is judged by its PROCESS start alone. The same run's frontend library watcher compiled ONE more cycle\n * after the install ended, failed it again on the lib it had lost, and went silent: a compiler that saw its toolchain\n * disappear keeps that state in memory, so a compile it runs after the install proves nothing. A READY watcher's\n * post-install compile did read the whole tree, so for it the latest compile start counts too.\n *\n * Self-limiting: the restarted watcher starts after the install ended, so the rule does not fire for it again. Never\n * while a recorded install is still in flight, which would only compile the half-installed tree once more. Driven by\n * the reader's own timer (the observer's heartbeat, the compile loop's check), never by a later compile, which may not\n * come.\n */\nexport function compilerReadTreeBeforeDependencyInstallEnded(input: {\n  readonly install: DependencyInstallStatus;\n  /** {@link readNodeModulesInstalledAtMs}; omitted or null when unknown. */\n  readonly nodeModulesInstalledAtMs?: number | null;\n  readonly lastCompilationStartedAtMs: number | null;\n  readonly watcherStartedAtMs: number;\n  /** Whether the watcher's latest compile FAILED (see above). */\n  readonly compilerFailed?: boolean;\n}): boolean {\n  const { install } = input;\n  if (install.phase === LocalDevDependencyInstallPhase.IN_FLIGHT) return false;\n  const endedAtMs = Math.max(\n    install.phase === LocalDevDependencyInstallPhase.ENDED && install.endedAtMs !== null ? install.endedAtMs : 0,\n    input.nodeModulesInstalledAtMs ?? 0,\n  );\n  if (endedAtMs <= 0) return false;\n  const watcherStartedAtMs = Number.isFinite(input.watcherStartedAtMs) ? input.watcherStartedAtMs : 0;\n  const lastReadAtMs = input.compilerFailed === true ? watcherStartedAtMs : Math.max(input.lastCompilationStartedAtMs ?? 0, watcherStartedAtMs);\n  return lastReadAtMs > 0 && lastReadAtMs < endedAtMs;\n}\n\n/** The longest an install is trusted to run before readers stop holding for it, when the installer names no bound. */\nexport const DEFAULT_DEPENDENCY_INSTALL_DEADLINE_MS = 30 * 60_000;\n\nexport interface DependencyInstallRecordOptions {\n  /** Who installs, recorded for a reader: `foundation`, `wildo update`, … */\n  readonly initiator: string;\n  /** The install's own bound; the deadline is this plus a minute of slack. Default {@link DEFAULT_DEPENDENCY_INSTALL_DEADLINE_MS}. */\n  readonly timeoutMs?: number;\n  /** Reports a record that could not be written. The install runs either way. */\n  readonly reportFailure?: (message: string, error: unknown) => void;\n}\n\n/** Start an install record; returns the closer. A root that is not an application gets no record (and a no-op closer). */\nfunction openDependencyInstallRecord(appRoot: string, options: DependencyInstallRecordOptions): (succeeded: boolean) => void {\n  if (!existsSync(join(appRoot, APPLICATION_ROOT_MARKER))) return () => undefined;\n  const path = dependencyInstallRecordPath(appRoot);\n  const started = new Date();\n  // Spelled out rather than `Omit<…>`: the record schema is loose (an index signature), and `Omit` over it drops every key.\n  const base: {\n    readonly kind: typeof LOCAL_DEV_DEPENDENCY_INSTALL_RECORD_KIND;\n    readonly schemaVersion: typeof LOCAL_DEV_RUNTIME_SIGNALS_PROTOCOL_VERSION;\n    readonly pid: number;\n    readonly startedAt: string;\n    readonly deadlineAt: string;\n    readonly initiator: string;\n  } = {\n    kind: LOCAL_DEV_DEPENDENCY_INSTALL_RECORD_KIND,\n    schemaVersion: LOCAL_DEV_RUNTIME_SIGNALS_PROTOCOL_VERSION,\n    pid: process.pid,\n    startedAt: started.toISOString(),\n    deadlineAt: new Date(started.getTime() + (options.timeoutMs ?? DEFAULT_DEPENDENCY_INSTALL_DEADLINE_MS) + 60_000).toISOString(),\n    initiator: options.initiator,\n  };\n  const write = (record: LocalDevDependencyInstallRecord): void => {\n    try {\n      writeRuntimeSignalRecord(path, record);\n    } catch (error) {\n      try {\n        options.reportFailure?.('The dependency-install record could not be written; the dev loop will not know about this install', error);\n      } catch {\n        // Reporting is a courtesy.\n      }\n    }\n  };\n  write({ ...base, finishedAt: null, succeeded: null });\n  return (succeeded) => write({ ...base, finishedAt: new Date().toISOString(), succeeded });\n}\n\n/**\n * Run an install bracketed by the record. The record never fails the install: a write that fails is reported and the\n * install runs as it would have without it. A throwing install is recorded as failed and rethrown.\n */\nexport async function withDependencyInstallRecord<T>(appRoot: string, options: DependencyInstallRecordOptions, install: () => Promise<T>): Promise<T> {\n  const close = openDependencyInstallRecord(appRoot, options);\n  let succeeded = false;\n  try {\n    const result = await install();\n    succeeded = true;\n    return result;\n  } finally {\n    close(succeeded);\n  }\n}\n\n/** {@link withDependencyInstallRecord} for a synchronous install, whose result says whether it succeeded. */\nexport function withDependencyInstallRecordSync(appRoot: string, options: DependencyInstallRecordOptions, install: () => boolean): boolean {\n  const close = openDependencyInstallRecord(appRoot, options);\n  let succeeded = false;\n  try {\n    succeeded = install();\n    return succeeded;\n  } finally {\n    close(succeeded);\n  }\n}\n"]}

package/dist/esm/dev-runtime/dev-runtime-command.d.ts

@@ -0,0 +1,50 @@
+/**
+ * `wildo-dev-runtime` — the dev loop of an application created from the PUBLISHED framework (#3214, #3215, #3216,
+ * #3257).
+ *
+ * ```
+ * wildo-dev-runtime compile [--project tsconfig.build.json] [--dist dist/esm]
+ *     Keep one package's dist current and publish its compile state (the shared library's and the specifications' `dev`).
+ * wildo-dev-runtime serve --entry dist/index.js --label <runtime> [--project tsconfig.build.json] [--dist dist] [--node-arg <arg>]...
+ *     Compile a node runtime's package AND supervise its process: the backend's `dev` (`--label backend-api`), a minion's
+ *     and a node worker's (`--label <its directory>`).
+ * wildo-dev-runtime frontend --command vite [--project tsconfig.library.json] [--dist dist/library]
+ *     Keep the frontend's config library current AND run its dev server (the frontend's `dev`, #3226).
+ * ```
+ *
+ * Runs in the package directory (the generated `dev` scripts are run there by `pnpm`). The application root is found
+ * by the `wildo.saas.config.ts` walk; the package's name and its workspace dependencies come from its `package.json`.
+ * Exit 2 when it cannot run at all (no application root, an unknown verb), exit 1 when it refuses (another dev process
+ * already owns the package).
+ *
+ * A framework developer's application does not use this: its packages run the monorepo's own observer and supervisor
+ * (`scripts/dev-orchestrator/`), which publish the same records.
+ */
+interface ParsedArguments {
+    readonly verb: string | undefined;
+    readonly values: Map<string, string>;
+    readonly nodeArguments: string[];
+}
+export declare function parseDevRuntimeArguments(argv: readonly string[]): ParsedArguments;
+/** The workspace packages a package depends on (`workspace:` specifiers), in a stable order. */
+export declare function readWorkspaceDependencyNames(manifest: {
+    readonly dependencies?: Record<string, string>;
+    readonly devDependencies?: Record<string, string>;
+}): string[];
+/**
+ * The two arguments `serve` cannot run without. Neither has a default.
+ *
+ * The LABEL in particular (#3257): it names the supervisor record, and that record is how a second supervisor of the
+ * same runtime is refused. Had it kept its old default of `backend-api`, a minion would have been refused as a second
+ * backend — or, started first, would have made the backend's own supervisor refuse.
+ */
+export declare function readServeArguments(parsed: ParsedArguments): {
+    readonly entry: string;
+    readonly label: string;
+} | {
+    readonly refusal: string;
+};
+/** Run one `wildo-dev-runtime` invocation to its end; resolves with the process exit code. */
+export declare function runDevRuntimeCommand(argv: readonly string[]): Promise<number>;
+export {};
+//# sourceMappingURL=dev-runtime-command.d.ts.map

package/dist/esm/dev-runtime/dev-runtime-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev-runtime-command.d.ts","sourceRoot":"","sources":["../../../src/dev-runtime/dev-runtime-command.ts"],"names":[],"mappings":"AAQA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,UAAU,eAAe;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,QAAQ,CAAC,aAAa,EAAE,MAAM,EAAE,CAAC;CAClC;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,eAAe,CAajF;AAED,gGAAgG;AAChG,wBAAgB,4BAA4B,CAAC,QAAQ,EAAE;IAAE,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,GAAG,MAAM,EAAE,CAMtK;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,eAAe,GAAG;IAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAM7I;AAED,8FAA8F;AAC9F,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CA0FnF"}