@wildo-ai/platform-config-lib 1.0.1 → 1.1.1
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/LICENSE +34 -0
- package/dist/esm/.builder.pid +9 -0
- package/dist/esm/_unimplemented/index.d.ts +3 -0
- package/dist/esm/_unimplemented/index.d.ts.map +1 -0
- package/dist/esm/_unimplemented/index.js +3 -0
- package/dist/esm/_unimplemented/index.js.map +1 -0
- package/dist/esm/_unimplemented/soft-warn.d.ts +124 -0
- package/dist/esm/_unimplemented/soft-warn.d.ts.map +1 -0
- package/dist/esm/_unimplemented/soft-warn.js +170 -0
- package/dist/esm/_unimplemented/soft-warn.js.map +1 -0
- package/dist/esm/_unimplemented/unimplemented-field-warning.d.ts +137 -0
- package/dist/esm/_unimplemented/unimplemented-field-warning.d.ts.map +1 -0
- package/dist/esm/_unimplemented/unimplemented-field-warning.js +153 -0
- package/dist/esm/_unimplemented/unimplemented-field-warning.js.map +1 -0
- package/dist/esm/bootstrap/application-backend-env.contracts.d.ts.map +1 -1
- package/dist/esm/bootstrap/application-backend-env.contracts.js +1 -1
- package/dist/esm/bootstrap/application-backend-env.contracts.js.map +1 -1
- package/dist/esm/bootstrap/application-creation-verification-env.contracts.d.ts +13 -0
- package/dist/esm/bootstrap/application-creation-verification-env.contracts.d.ts.map +1 -0
- package/dist/esm/bootstrap/application-creation-verification-env.contracts.js +14 -0
- package/dist/esm/bootstrap/application-creation-verification-env.contracts.js.map +1 -0
- package/dist/esm/bootstrap/bootstrap-planner.d.ts +1 -1
- package/dist/esm/bootstrap/bootstrap-planner.d.ts.map +1 -1
- package/dist/esm/bootstrap/bootstrap-planner.js +1 -1
- package/dist/esm/bootstrap/bootstrap-planner.js.map +1 -1
- package/dist/esm/bootstrap/bootstrap.contracts.d.ts +141 -37
- package/dist/esm/bootstrap/bootstrap.contracts.d.ts.map +1 -1
- package/dist/esm/bootstrap/bootstrap.contracts.js +104 -18
- package/dist/esm/bootstrap/bootstrap.contracts.js.map +1 -1
- package/dist/esm/bootstrap/bootstrap.schemas.d.ts +430 -421
- package/dist/esm/bootstrap/bootstrap.schemas.d.ts.map +1 -1
- package/dist/esm/bootstrap/bootstrap.schemas.js +383 -21
- package/dist/esm/bootstrap/bootstrap.schemas.js.map +1 -1
- package/dist/esm/bootstrap/platform-runtime-env.contracts.d.ts +213 -8
- package/dist/esm/bootstrap/platform-runtime-env.contracts.d.ts.map +1 -1
- package/dist/esm/bootstrap/platform-runtime-env.contracts.js +230 -5
- package/dist/esm/bootstrap/platform-runtime-env.contracts.js.map +1 -1
- package/dist/esm/bootstrap/runtime-backing-service-access.d.ts +79 -0
- package/dist/esm/bootstrap/runtime-backing-service-access.d.ts.map +1 -0
- package/dist/esm/bootstrap/runtime-backing-service-access.js +83 -0
- package/dist/esm/bootstrap/runtime-backing-service-access.js.map +1 -0
- package/dist/esm/bootstrap/runtime-network-policy.d.ts +63 -0
- package/dist/esm/bootstrap/runtime-network-policy.d.ts.map +1 -0
- package/dist/esm/bootstrap/runtime-network-policy.js +104 -0
- package/dist/esm/bootstrap/runtime-network-policy.js.map +1 -0
- package/dist/esm/bootstrap/runtime-network-topology.d.ts +78 -0
- package/dist/esm/bootstrap/runtime-network-topology.d.ts.map +1 -0
- package/dist/esm/bootstrap/runtime-network-topology.js +134 -0
- package/dist/esm/bootstrap/runtime-network-topology.js.map +1 -0
- package/dist/esm/bootstrap/runtime-platform-access.d.ts +67 -0
- package/dist/esm/bootstrap/runtime-platform-access.d.ts.map +1 -0
- package/dist/esm/bootstrap/runtime-platform-access.js +57 -0
- package/dist/esm/bootstrap/runtime-platform-access.js.map +1 -0
- package/dist/esm/bootstrap/runtime-principal.contracts.d.ts +173 -0
- package/dist/esm/bootstrap/runtime-principal.contracts.d.ts.map +1 -0
- package/dist/esm/bootstrap/runtime-principal.contracts.js +218 -0
- package/dist/esm/bootstrap/runtime-principal.contracts.js.map +1 -0
- package/dist/esm/bootstrap/runtime-topology.contracts.d.ts +112 -1
- package/dist/esm/bootstrap/runtime-topology.contracts.d.ts.map +1 -1
- package/dist/esm/bootstrap/runtime-topology.contracts.js +141 -8
- package/dist/esm/bootstrap/runtime-topology.contracts.js.map +1 -1
- package/dist/esm/config-authoring.entry.d.ts +3 -0
- package/dist/esm/config-authoring.entry.d.ts.map +1 -0
- package/dist/esm/config-authoring.entry.js +5 -0
- package/dist/esm/config-authoring.entry.js.map +1 -0
- package/dist/esm/credentials/credential-generator.service.d.ts.map +1 -1
- package/dist/esm/credentials/credential-generator.service.js +1 -1
- package/dist/esm/credentials/credential-generator.service.js.map +1 -1
- package/dist/esm/index.d.ts +30 -15
- package/dist/esm/index.d.ts.map +1 -1
- package/dist/esm/index.js +16 -1
- package/dist/esm/index.js.map +1 -1
- package/dist/esm/lockfile/canonical-json.d.ts +41 -0
- package/dist/esm/lockfile/canonical-json.d.ts.map +1 -0
- package/dist/esm/lockfile/canonical-json.js +56 -0
- package/dist/esm/lockfile/canonical-json.js.map +1 -0
- package/dist/esm/lockfile/lockfile-io.d.ts +231 -0
- package/dist/esm/lockfile/lockfile-io.d.ts.map +1 -0
- package/dist/esm/lockfile/lockfile-io.js +303 -0
- package/dist/esm/lockfile/lockfile-io.js.map +1 -0
- package/dist/esm/lockfile/materialize-infra-section.d.ts +99 -0
- package/dist/esm/lockfile/materialize-infra-section.d.ts.map +1 -0
- package/dist/esm/lockfile/materialize-infra-section.js +153 -0
- package/dist/esm/lockfile/materialize-infra-section.js.map +1 -0
- package/dist/esm/lockfile/wildo-saas-lock.shared.schemas.d.ts +522 -0
- package/dist/esm/lockfile/wildo-saas-lock.shared.schemas.d.ts.map +1 -0
- package/dist/esm/lockfile/wildo-saas-lock.shared.schemas.js +116 -0
- package/dist/esm/lockfile/wildo-saas-lock.shared.schemas.js.map +1 -0
- package/dist/esm/project-config/define-framework-config.d.ts +36 -10
- package/dist/esm/project-config/define-framework-config.d.ts.map +1 -1
- package/dist/esm/project-config/define-framework-config.js +67 -3
- package/dist/esm/project-config/define-framework-config.js.map +1 -1
- package/dist/esm/project-config/define-infra-env-config.d.ts +570 -0
- package/dist/esm/project-config/define-infra-env-config.d.ts.map +1 -0
- package/dist/esm/project-config/define-infra-env-config.js +726 -0
- package/dist/esm/project-config/define-infra-env-config.js.map +1 -0
- package/dist/esm/project-config/define-minion-config.d.ts +221 -23
- package/dist/esm/project-config/define-minion-config.d.ts.map +1 -1
- package/dist/esm/project-config/define-minion-config.js +228 -11
- package/dist/esm/project-config/define-minion-config.js.map +1 -1
- package/dist/esm/project-config/define-saas-config.d.ts +427 -218
- package/dist/esm/project-config/define-saas-config.d.ts.map +1 -1
- package/dist/esm/project-config/define-saas-config.js +704 -75
- package/dist/esm/project-config/define-saas-config.js.map +1 -1
- package/dist/esm/project-config/define-worker-config.d.ts +106 -10
- package/dist/esm/project-config/define-worker-config.d.ts.map +1 -1
- package/dist/esm/project-config/define-worker-config.js +99 -9
- package/dist/esm/project-config/define-worker-config.js.map +1 -1
- package/dist/esm/project-config/index.d.ts +28 -21
- package/dist/esm/project-config/index.d.ts.map +1 -1
- package/dist/esm/project-config/index.js +14 -7
- package/dist/esm/project-config/index.js.map +1 -1
- package/dist/esm/project-config/loader.d.ts +120 -10
- package/dist/esm/project-config/loader.d.ts.map +1 -1
- package/dist/esm/project-config/loader.js +290 -38
- package/dist/esm/project-config/loader.js.map +1 -1
- package/dist/esm/project-config/minion-local-provider-registration.d.ts +69 -0
- package/dist/esm/project-config/minion-local-provider-registration.d.ts.map +1 -0
- package/dist/esm/project-config/minion-local-provider-registration.js +72 -0
- package/dist/esm/project-config/minion-local-provider-registration.js.map +1 -0
- package/dist/esm/project-config/provider-catalog-types.d.ts +12 -0
- package/dist/esm/project-config/provider-catalog-types.d.ts.map +1 -0
- package/dist/esm/project-config/provider-catalog-types.js +49 -0
- package/dist/esm/project-config/provider-catalog-types.js.map +1 -0
- package/dist/esm/project-config/provider-companion-discovery.d.ts +24 -0
- package/dist/esm/project-config/provider-companion-discovery.d.ts.map +1 -0
- package/dist/esm/project-config/provider-companion-discovery.js +244 -0
- package/dist/esm/project-config/provider-companion-discovery.js.map +1 -0
- package/dist/esm/project-config/provider-runtime-artifacts.d.ts +297 -0
- package/dist/esm/project-config/provider-runtime-artifacts.d.ts.map +1 -0
- package/dist/esm/project-config/provider-runtime-artifacts.js +860 -0
- package/dist/esm/project-config/provider-runtime-artifacts.js.map +1 -0
- package/dist/esm/project-config/shared/application-creation-verification.schemas.d.ts +18 -0
- package/dist/esm/project-config/shared/application-creation-verification.schemas.d.ts.map +1 -0
- package/dist/esm/project-config/shared/application-creation-verification.schemas.js +25 -0
- package/dist/esm/project-config/shared/application-creation-verification.schemas.js.map +1 -0
- package/dist/esm/project-config/shared/application-modules.schemas.d.ts +10 -2
- package/dist/esm/project-config/shared/application-modules.schemas.d.ts.map +1 -1
- package/dist/esm/project-config/shared/application-modules.schemas.js +12 -1
- package/dist/esm/project-config/shared/application-modules.schemas.js.map +1 -1
- package/dist/esm/project-config/shared/application-modules.utils.d.ts +2 -1
- package/dist/esm/project-config/shared/application-modules.utils.d.ts.map +1 -1
- package/dist/esm/project-config/shared/application-modules.utils.js +6 -1
- package/dist/esm/project-config/shared/application-modules.utils.js.map +1 -1
- package/dist/esm/project-config/shared/auth.schemas.d.ts +102 -0
- package/dist/esm/project-config/shared/auth.schemas.d.ts.map +1 -0
- package/dist/esm/project-config/shared/auth.schemas.js +100 -0
- package/dist/esm/project-config/shared/auth.schemas.js.map +1 -0
- package/dist/esm/project-config/shared/backing-services.schemas.d.ts +316 -39
- package/dist/esm/project-config/shared/backing-services.schemas.d.ts.map +1 -1
- package/dist/esm/project-config/shared/backing-services.schemas.js +359 -24
- package/dist/esm/project-config/shared/backing-services.schemas.js.map +1 -1
- package/dist/esm/project-config/shared/cdn.example.d.ts +14 -0
- package/dist/esm/project-config/shared/cdn.example.d.ts.map +1 -0
- package/dist/esm/project-config/shared/cdn.example.js +38 -0
- package/dist/esm/project-config/shared/cdn.example.js.map +1 -0
- package/dist/esm/project-config/shared/cdn.schemas.d.ts +182 -0
- package/dist/esm/project-config/shared/cdn.schemas.d.ts.map +1 -0
- package/dist/esm/project-config/shared/cdn.schemas.js +151 -0
- package/dist/esm/project-config/shared/cdn.schemas.js.map +1 -0
- package/dist/esm/project-config/shared/csp-defaults.d.ts +92 -0
- package/dist/esm/project-config/shared/csp-defaults.d.ts.map +1 -0
- package/dist/esm/project-config/shared/csp-defaults.js +195 -0
- package/dist/esm/project-config/shared/csp-defaults.js.map +1 -0
- package/dist/esm/project-config/shared/csp-emit.d.ts +106 -0
- package/dist/esm/project-config/shared/csp-emit.d.ts.map +1 -0
- package/dist/esm/project-config/shared/csp-emit.js +305 -0
- package/dist/esm/project-config/shared/csp-emit.js.map +1 -0
- package/dist/esm/project-config/shared/csp.schemas.d.ts +266 -0
- package/dist/esm/project-config/shared/csp.schemas.d.ts.map +1 -0
- package/dist/esm/project-config/shared/csp.schemas.js +281 -0
- package/dist/esm/project-config/shared/csp.schemas.js.map +1 -0
- package/dist/esm/project-config/shared/data-services.schemas.d.ts +45 -9
- package/dist/esm/project-config/shared/data-services.schemas.d.ts.map +1 -1
- package/dist/esm/project-config/shared/data-services.schemas.js +45 -9
- package/dist/esm/project-config/shared/data-services.schemas.js.map +1 -1
- package/dist/esm/project-config/shared/env-example-defaults.d.ts +0 -1
- package/dist/esm/project-config/shared/env-example-defaults.d.ts.map +1 -1
- package/dist/esm/project-config/shared/env-example-defaults.js +1 -2
- package/dist/esm/project-config/shared/env-example-defaults.js.map +1 -1
- package/dist/esm/project-config/shared/environment.schemas.d.ts +134 -8
- package/dist/esm/project-config/shared/environment.schemas.d.ts.map +1 -1
- package/dist/esm/project-config/shared/environment.schemas.js +185 -2
- package/dist/esm/project-config/shared/environment.schemas.js.map +1 -1
- package/dist/esm/project-config/shared/infra-providers.schemas.d.ts +779 -0
- package/dist/esm/project-config/shared/infra-providers.schemas.d.ts.map +1 -0
- package/dist/esm/project-config/shared/infra-providers.schemas.js +210 -0
- package/dist/esm/project-config/shared/infra-providers.schemas.js.map +1 -0
- package/dist/esm/project-config/shared/infra-service.schemas.d.ts +18 -0
- package/dist/esm/project-config/shared/infra-service.schemas.d.ts.map +1 -0
- package/dist/esm/project-config/shared/infra-service.schemas.js +16 -0
- package/dist/esm/project-config/shared/infra-service.schemas.js.map +1 -0
- package/dist/esm/project-config/shared/infrastructure-defaults.schemas.d.ts +83 -1
- package/dist/esm/project-config/shared/infrastructure-defaults.schemas.d.ts.map +1 -1
- package/dist/esm/project-config/shared/infrastructure-defaults.schemas.js +99 -2
- package/dist/esm/project-config/shared/infrastructure-defaults.schemas.js.map +1 -1
- package/dist/esm/project-config/shared/k8s-utils.d.ts +51 -7
- package/dist/esm/project-config/shared/k8s-utils.d.ts.map +1 -1
- package/dist/esm/project-config/shared/k8s-utils.js +59 -12
- package/dist/esm/project-config/shared/k8s-utils.js.map +1 -1
- package/dist/esm/project-config/shared/minion-platform-access.vocabulary.d.ts +31 -0
- package/dist/esm/project-config/shared/minion-platform-access.vocabulary.d.ts.map +1 -0
- package/dist/esm/project-config/shared/minion-platform-access.vocabulary.js +32 -0
- package/dist/esm/project-config/shared/minion-platform-access.vocabulary.js.map +1 -0
- package/dist/esm/project-config/shared/minion-resource-access.validation.d.ts +142 -0
- package/dist/esm/project-config/shared/minion-resource-access.validation.d.ts.map +1 -0
- package/dist/esm/project-config/shared/minion-resource-access.validation.js +159 -0
- package/dist/esm/project-config/shared/minion-resource-access.validation.js.map +1 -0
- package/dist/esm/project-config/shared/object-storage-session-policy.d.ts +100 -0
- package/dist/esm/project-config/shared/object-storage-session-policy.d.ts.map +1 -0
- package/dist/esm/project-config/shared/object-storage-session-policy.js +130 -0
- package/dist/esm/project-config/shared/object-storage-session-policy.js.map +1 -0
- package/dist/esm/project-config/shared/platform-services.schemas.d.ts +9 -14
- package/dist/esm/project-config/shared/platform-services.schemas.d.ts.map +1 -1
- package/dist/esm/project-config/shared/platform-services.schemas.js +13 -9
- package/dist/esm/project-config/shared/platform-services.schemas.js.map +1 -1
- package/dist/esm/project-config/shared/schema-version.schemas.d.ts +15 -0
- package/dist/esm/project-config/shared/schema-version.schemas.d.ts.map +1 -0
- package/dist/esm/project-config/shared/schema-version.schemas.js +40 -0
- package/dist/esm/project-config/shared/schema-version.schemas.js.map +1 -0
- package/dist/esm/project-config/shared/service-definitions.schemas.d.ts +283 -8
- package/dist/esm/project-config/shared/service-definitions.schemas.d.ts.map +1 -1
- package/dist/esm/project-config/shared/service-definitions.schemas.js +325 -8
- package/dist/esm/project-config/shared/service-definitions.schemas.js.map +1 -1
- package/dist/esm/registry/artifact-domain.schemas.d.ts +54 -0
- package/dist/esm/registry/artifact-domain.schemas.d.ts.map +1 -0
- package/dist/esm/registry/artifact-domain.schemas.js +40 -0
- package/dist/esm/registry/artifact-domain.schemas.js.map +1 -0
- package/dist/esm/registry/companion-api.schemas.d.ts +176 -0
- package/dist/esm/registry/companion-api.schemas.d.ts.map +1 -0
- package/dist/esm/registry/companion-api.schemas.js +165 -0
- package/dist/esm/registry/companion-api.schemas.js.map +1 -0
- package/dist/esm/registry/digest.schemas.d.ts +20 -0
- package/dist/esm/registry/digest.schemas.d.ts.map +1 -0
- package/dist/esm/registry/digest.schemas.js +21 -0
- package/dist/esm/registry/digest.schemas.js.map +1 -0
- package/dist/esm/registry/index.d.ts +33 -0
- package/dist/esm/registry/index.d.ts.map +1 -0
- package/dist/esm/registry/index.js +33 -0
- package/dist/esm/registry/index.js.map +1 -0
- package/dist/esm/registry/lockfile-modules-section.schemas.d.ts +107 -0
- package/dist/esm/registry/lockfile-modules-section.schemas.d.ts.map +1 -0
- package/dist/esm/registry/lockfile-modules-section.schemas.js +67 -0
- package/dist/esm/registry/lockfile-modules-section.schemas.js.map +1 -0
- package/dist/esm/registry/module-artifact.schemas.d.ts +94 -0
- package/dist/esm/registry/module-artifact.schemas.d.ts.map +1 -0
- package/dist/esm/registry/module-artifact.schemas.js +69 -0
- package/dist/esm/registry/module-artifact.schemas.js.map +1 -0
- package/dist/esm/registry/module-manifest.schemas.d.ts +134 -0
- package/dist/esm/registry/module-manifest.schemas.d.ts.map +1 -0
- package/dist/esm/registry/module-manifest.schemas.js +155 -0
- package/dist/esm/registry/module-manifest.schemas.js.map +1 -0
- package/dist/esm/registry/registry-config.schemas.d.ts +31 -0
- package/dist/esm/registry/registry-config.schemas.d.ts.map +1 -0
- package/dist/esm/registry/registry-config.schemas.js +24 -0
- package/dist/esm/registry/registry-config.schemas.js.map +1 -0
- package/dist/esm/registry/registry-defaults.constants.d.ts +37 -0
- package/dist/esm/registry/registry-defaults.constants.d.ts.map +1 -0
- package/dist/esm/registry/registry-defaults.constants.js +37 -0
- package/dist/esm/registry/registry-defaults.constants.js.map +1 -0
- package/dist/esm/registry/registry-errors.d.ts +109 -0
- package/dist/esm/registry/registry-errors.d.ts.map +1 -0
- package/dist/esm/registry/registry-errors.js +185 -0
- package/dist/esm/registry/registry-errors.js.map +1 -0
- package/dist/esm/registry/registry-section-schemas.constants.d.ts +39 -0
- package/dist/esm/registry/registry-section-schemas.constants.d.ts.map +1 -0
- package/dist/esm/registry/registry-section-schemas.constants.js +22 -0
- package/dist/esm/registry/registry-section-schemas.constants.js.map +1 -0
- package/dist/esm/release/framework-release.constants.d.ts +26 -1
- package/dist/esm/release/framework-release.constants.d.ts.map +1 -1
- package/dist/esm/release/framework-release.constants.js +27 -2
- package/dist/esm/release/framework-release.constants.js.map +1 -1
- package/dist/esm/schemas/framework-info.schemas.d.ts +1 -1
- package/dist/esm/schemas/framework-info.schemas.d.ts.map +1 -1
- package/dist/esm/schemas/framework-info.schemas.js +1 -1
- package/dist/esm/schemas/framework-info.schemas.js.map +1 -1
- package/dist/esm/schemas/framework-secrets.schemas.d.ts +5 -5
- package/dist/esm/schemas/framework-secrets.schemas.d.ts.map +1 -1
- package/dist/esm/schemas/framework-secrets.schemas.js +1 -1
- package/dist/esm/schemas/framework-secrets.schemas.js.map +1 -1
- package/dist/esm/schemas/platform-application-config.schemas.d.ts +1 -1
- package/dist/esm/schemas/platform-application-config.schemas.d.ts.map +1 -1
- package/dist/esm/schemas/platform-application-config.schemas.js +11 -2
- package/dist/esm/schemas/platform-application-config.schemas.js.map +1 -1
- package/dist/esm/schemas/platform-application-secrets.schemas.d.ts +7 -7
- package/dist/esm/schemas/platform-application-secrets.schemas.d.ts.map +1 -1
- package/dist/esm/schemas/platform-application-secrets.schemas.js +17 -2
- package/dist/esm/schemas/platform-application-secrets.schemas.js.map +1 -1
- package/dist/esm/schemas/platform-config.schemas.d.ts +12 -13
- package/dist/esm/schemas/platform-config.schemas.d.ts.map +1 -1
- package/dist/esm/schemas/platform-config.schemas.js +15 -3
- package/dist/esm/schemas/platform-config.schemas.js.map +1 -1
- package/dist/esm/workspace-scope/application-subject-manifest.d.ts +26 -0
- package/dist/esm/workspace-scope/application-subject-manifest.d.ts.map +1 -0
- package/dist/esm/workspace-scope/application-subject-manifest.js +43 -0
- package/dist/esm/workspace-scope/application-subject-manifest.js.map +1 -0
- package/dist/esm/workspace-scope/index.d.ts +5 -2
- package/dist/esm/workspace-scope/index.d.ts.map +1 -1
- package/dist/esm/workspace-scope/index.js +4 -1
- package/dist/esm/workspace-scope/index.js.map +1 -1
- package/dist/esm/workspace-scope/resolve-homes.d.ts +20 -0
- package/dist/esm/workspace-scope/resolve-homes.d.ts.map +1 -0
- package/dist/esm/workspace-scope/resolve-homes.js +62 -0
- package/dist/esm/workspace-scope/resolve-homes.js.map +1 -0
- package/dist/esm/workspace-scope/workspace-homes.schemas.d.ts +211 -0
- package/dist/esm/workspace-scope/workspace-homes.schemas.d.ts.map +1 -0
- package/dist/esm/workspace-scope/workspace-homes.schemas.js +113 -0
- package/dist/esm/workspace-scope/workspace-homes.schemas.js.map +1 -0
- package/dist/esm/workspace-scope/workspace-scope-detector.d.ts +10 -5
- package/dist/esm/workspace-scope/workspace-scope-detector.d.ts.map +1 -1
- package/dist/esm/workspace-scope/workspace-scope-detector.js +22 -36
- package/dist/esm/workspace-scope/workspace-scope-detector.js.map +1 -1
- package/dist/esm/workspace-scope/workspace-scope.schemas.d.ts +147 -58
- package/dist/esm/workspace-scope/workspace-scope.schemas.d.ts.map +1 -1
- package/dist/esm/workspace-scope/workspace-scope.schemas.js +174 -78
- package/dist/esm/workspace-scope/workspace-scope.schemas.js.map +1 -1
- package/dist/tsconfig.build.tsbuildinfo +1 -1
- package/package.json +31 -17
- package/dist/esm/credentials/credentials-provisioner.service.d.ts +0 -190
- package/dist/esm/credentials/credentials-provisioner.service.d.ts.map +0 -1
- package/dist/esm/credentials/credentials-provisioner.service.js +0 -278
- package/dist/esm/credentials/credentials-provisioner.service.js.map +0 -1
- package/dist/esm/infra-managers/infra-manager.models.d.ts +0 -146
- package/dist/esm/infra-managers/infra-manager.models.d.ts.map +0 -1
- package/dist/esm/infra-managers/infra-manager.models.js +0 -2
- package/dist/esm/infra-managers/infra-manager.models.js.map +0 -1
- package/dist/esm/infra-managers/mongo-atlas-manager.service.d.ts +0 -64
- package/dist/esm/infra-managers/mongo-atlas-manager.service.d.ts.map +0 -1
- package/dist/esm/infra-managers/mongo-atlas-manager.service.js +0 -307
- package/dist/esm/infra-managers/mongo-atlas-manager.service.js.map +0 -1
- package/dist/esm/infra-managers/postgresql-manager.service.d.ts +0 -115
- package/dist/esm/infra-managers/postgresql-manager.service.d.ts.map +0 -1
- package/dist/esm/infra-managers/postgresql-manager.service.js +0 -403
- package/dist/esm/infra-managers/postgresql-manager.service.js.map +0 -1
- package/dist/esm/infra-managers/rabbitmq-manager.service.d.ts +0 -64
- package/dist/esm/infra-managers/rabbitmq-manager.service.d.ts.map +0 -1
- package/dist/esm/infra-managers/rabbitmq-manager.service.js +0 -288
- package/dist/esm/infra-managers/rabbitmq-manager.service.js.map +0 -1
- package/dist/esm/infra-managers/redis-manager.service.d.ts +0 -78
- package/dist/esm/infra-managers/redis-manager.service.d.ts.map +0 -1
- package/dist/esm/infra-managers/redis-manager.service.js +0 -326
- package/dist/esm/infra-managers/redis-manager.service.js.map +0 -1
- package/dist/esm/project-config/define-infra-config.d.ts +0 -128
- package/dist/esm/project-config/define-infra-config.d.ts.map +0 -1
- package/dist/esm/project-config/define-infra-config.js +0 -87
- package/dist/esm/project-config/define-infra-config.js.map +0 -1
- package/dist/esm/project-config/define-platform-config.d.ts +0 -65
- package/dist/esm/project-config/define-platform-config.d.ts.map +0 -1
- package/dist/esm/project-config/define-platform-config.js +0 -22
- package/dist/esm/project-config/define-platform-config.js.map +0 -1
- package/dist/esm/project-config/define-platform-env-config.d.ts +0 -41
- package/dist/esm/project-config/define-platform-env-config.d.ts.map +0 -1
- package/dist/esm/project-config/define-platform-env-config.js +0 -45
- package/dist/esm/project-config/define-platform-env-config.js.map +0 -1
- package/dist/esm/project-config/define-project-config.d.ts +0 -38
- package/dist/esm/project-config/define-project-config.d.ts.map +0 -1
- package/dist/esm/project-config/define-project-config.js +0 -57
- package/dist/esm/project-config/define-project-config.js.map +0 -1
- package/dist/esm/project-config/define-sharing-policy.d.ts +0 -35
- package/dist/esm/project-config/define-sharing-policy.d.ts.map +0 -1
- package/dist/esm/project-config/define-sharing-policy.js +0 -30
- package/dist/esm/project-config/define-sharing-policy.js.map +0 -1
- package/dist/esm/project-config/sharing-policy-validation.d.ts +0 -40
- package/dist/esm/project-config/sharing-policy-validation.d.ts.map +0 -1
- package/dist/esm/project-config/sharing-policy-validation.js +0 -143
- package/dist/esm/project-config/sharing-policy-validation.js.map +0 -1
- package/dist/esm/runtime-bridge/platform-runtime-bridge.contracts.d.ts +0 -23
- package/dist/esm/runtime-bridge/platform-runtime-bridge.contracts.d.ts.map +0 -1
- package/dist/esm/runtime-bridge/platform-runtime-bridge.contracts.js +0 -13
- package/dist/esm/runtime-bridge/platform-runtime-bridge.contracts.js.map +0 -1
- package/src/bootstrap/application-backend-env.contracts.ts +0 -17
- package/src/bootstrap/bootstrap-planner.ts +0 -46
- package/src/bootstrap/bootstrap.contracts.ts +0 -251
- package/src/bootstrap/bootstrap.schemas.ts +0 -164
- package/src/bootstrap/platform-runtime-env.contracts.ts +0 -99
- package/src/bootstrap/runtime-topology.contracts.ts +0 -102
- package/src/credentials/credential-generator.service.ts +0 -39
- package/src/index.ts +0 -16
- package/src/project-config/__tests__/application-modules.utils.test.ts +0 -53
- package/src/project-config/__tests__/define-framework-config.test.ts +0 -43
- package/src/project-config/__tests__/define-saas-config.test.ts +0 -210
- package/src/project-config/__tests__/loader.test.ts +0 -100
- package/src/project-config/define-framework-config.ts +0 -44
- package/src/project-config/define-infra-config.ts +0 -168
- package/src/project-config/define-minion-config.ts +0 -27
- package/src/project-config/define-platform-config.ts +0 -28
- package/src/project-config/define-platform-env-config.ts +0 -59
- package/src/project-config/define-project-config.ts +0 -63
- package/src/project-config/define-saas-config.ts +0 -171
- package/src/project-config/define-sharing-policy.ts +0 -36
- package/src/project-config/define-worker-config.ts +0 -27
- package/src/project-config/index.ts +0 -23
- package/src/project-config/loader.ts +0 -220
- package/src/project-config/shared/application-modules.schemas.ts +0 -12
- package/src/project-config/shared/application-modules.utils.ts +0 -65
- package/src/project-config/shared/backing-services.schemas.ts +0 -59
- package/src/project-config/shared/data-services.schemas.ts +0 -58
- package/src/project-config/shared/env-example-defaults.ts +0 -50
- package/src/project-config/shared/environment.schemas.ts +0 -136
- package/src/project-config/shared/infrastructure-defaults.schemas.ts +0 -47
- package/src/project-config/shared/k8s-utils.ts +0 -56
- package/src/project-config/shared/platform-services.schemas.ts +0 -33
- package/src/project-config/shared/service-definitions.schemas.ts +0 -38
- package/src/project-config/sharing-policy-validation.ts +0 -159
- package/src/release/framework-release.constants.ts +0 -2
- package/src/schemas/__tests__/platform-config.schemas.test.ts +0 -90
- package/src/schemas/framework-info.schemas.ts +0 -13
- package/src/schemas/framework-secrets.schemas.ts +0 -19
- package/src/schemas/platform-application-config.schemas.ts +0 -25
- package/src/schemas/platform-application-secrets.schemas.ts +0 -78
- package/src/schemas/platform-config.schemas.ts +0 -45
- package/src/workspace-scope/index.ts +0 -2
- package/src/workspace-scope/workspace-scope-detector.ts +0 -98
- package/src/workspace-scope/workspace-scope.schemas.ts +0 -224
package/LICENSE
ADDED
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
Copyright (c) 2026 P2C Consulting, s.à r.l.-S
|
|
2
|
+
RCS Luxembourg B307591
|
|
3
|
+
6C, Porte de France, L-4360 Esch-sur-Alzette, Luxembourg
|
|
4
|
+
|
|
5
|
+
All rights reserved.
|
|
6
|
+
|
|
7
|
+
This software and its accompanying materials (the "Software") are the
|
|
8
|
+
confidential and proprietary property of P2C Consulting, s.à r.l.-S (the
|
|
9
|
+
"Licensor"). The Software is made available for viewing only. No licence,
|
|
10
|
+
right, or permission of any kind is granted by its publication or by its
|
|
11
|
+
availability on any package registry or source repository.
|
|
12
|
+
|
|
13
|
+
Without the Licensor's prior written permission, you may not use, copy,
|
|
14
|
+
reproduce, modify, adapt, translate, merge, publish, distribute, sublicense,
|
|
15
|
+
sell, host, or create derivative works of the Software, in whole or in part,
|
|
16
|
+
nor use it to provide a service to any third party.
|
|
17
|
+
|
|
18
|
+
Publication of the Software in any public registry is for distribution to
|
|
19
|
+
authorised recipients and for technical evaluation of its packaging only. It
|
|
20
|
+
does not place the Software in the public domain, does not constitute an open
|
|
21
|
+
source release, and does not waive any right of the Licensor.
|
|
22
|
+
|
|
23
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
24
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
25
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
26
|
+
LICENSOR BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN
|
|
27
|
+
ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
|
|
28
|
+
WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
|
|
29
|
+
|
|
30
|
+
Third-party components distributed with the Software remain governed by their
|
|
31
|
+
own licences.
|
|
32
|
+
|
|
33
|
+
Contact: P2C Consulting, s.à r.l.-S, 6C, Porte de France, L-4360
|
|
34
|
+
Esch-sur-Alzette, Luxembourg.
|
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
{
|
|
2
|
+
"schemaVersion": 1,
|
|
3
|
+
"writerPid": 95412,
|
|
4
|
+
"orchestratorPid": 94847,
|
|
5
|
+
"orchestratorSessionId": null,
|
|
6
|
+
"orchestratorStartedAt": "Mon Aug 31 09:18:19 2026",
|
|
7
|
+
"distDirectory": "/Users/paulcayon/Projects/Wildo.ai/dev/wildo-ai/platform/platform-core/platform-config-lib/dist/esm",
|
|
8
|
+
"acquiredAt": "2026-08-31T07:18:20.894Z"
|
|
9
|
+
}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/_unimplemented/index.ts"],"names":[],"mappings":"AAAA,cAAc,+BAA+B,CAAC;AAC9C,cAAc,aAAa,CAAC"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/_unimplemented/index.ts"],"names":[],"mappings":"AAAA,cAAc,+BAA+B,CAAC;AAC9C,cAAc,aAAa,CAAC","sourcesContent":["export * from './unimplemented-field-warning';\nexport * from './soft-warn';\n"]}
|
|
@@ -0,0 +1,124 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @fileoverview Soft-warn utility — companion to
|
|
3
|
+
* `unimplemented-field-warning.ts` for cross-cutting authoring concerns
|
|
4
|
+
* that are NOT bound to a single `@unimplemented` field but still need
|
|
5
|
+
* a noisy-yet-non-fatal `process.stderr` channel during the v1 minions
|
|
6
|
+
* & workers rollout.
|
|
7
|
+
*
|
|
8
|
+
* Why a separate utility (and not just call `emitUnimplementedFieldWarning`)?
|
|
9
|
+
*
|
|
10
|
+
* - `@unimplemented` warnings are pinned to a SCHEMA FIELD — every
|
|
11
|
+
* surface today appears in the `cli-dx.md` table and has a tracking
|
|
12
|
+
* ID in the deferred backlog. Adding non-field-bound warnings to
|
|
13
|
+
* that channel would dilute the contract that "every line in the
|
|
14
|
+
* `@unimplemented` stream maps 1:1 to a deferred-backlog row".
|
|
15
|
+
*
|
|
16
|
+
* - The minions/workers slice (KD-11 / H-3 in
|
|
17
|
+
* `.cursor/plans/minions-and-workers-implementation.md`) needs to
|
|
18
|
+
* surface advisories like "your minion's `resourceAccess` whitelist
|
|
19
|
+
* is empty — you'll get blocked at every repository call" that are
|
|
20
|
+
* PER-MINION, not per-field. The natural authoring key is a
|
|
21
|
+
* `(scope, key)` pair (e.g. `('minions.marketingScrapper', 'resourceAccess.empty')`),
|
|
22
|
+
* not a dotted field path.
|
|
23
|
+
*
|
|
24
|
+
* - The dev watcher re-parses on every save, so without an in-process
|
|
25
|
+
* repeat-cap a verbose minion ACL would spam the log on every
|
|
26
|
+
* keystroke. The `@unimplemented` warner solves dedupe per parse
|
|
27
|
+
* call (a fresh `Set` is captured per `defineSaasConfig` call); the
|
|
28
|
+
* soft-warn utility solves dedupe + cap PER PROCESS so a noisy
|
|
29
|
+
* advisory does not drown the watcher even under tight save loops.
|
|
30
|
+
*
|
|
31
|
+
* Design choices (all pinned by `__tests__/soft-warn.test.ts`):
|
|
32
|
+
*
|
|
33
|
+
* - **Channel = `process.stderr.write`** (parity with
|
|
34
|
+
* `emitUnimplementedFieldWarning`). The dev watcher's
|
|
35
|
+
* pretty-printer hijacks `console.warn`; writing to the FD keeps
|
|
36
|
+
* the line raw and grep-friendly.
|
|
37
|
+
*
|
|
38
|
+
* - **Dedupe = process-wide on `(scope, key)`** with a configurable
|
|
39
|
+
* repeat cap (default 5, env override `WILDO_SOFT_WARN_LIMIT`).
|
|
40
|
+
* After the cap is reached the utility emits ONE final
|
|
41
|
+
* `[wildo-soft-warn:<scope>] <key>: suppressed further occurrences
|
|
42
|
+
* (cap reached: <N>; override via WILDO_SOFT_WARN_LIMIT).` line and
|
|
43
|
+
* falls silent for that pair. The cap is per-process (not per parse
|
|
44
|
+
* call) because the SAME advisory firing on every dev-watcher save
|
|
45
|
+
* is exactly the noise we're trying to suppress.
|
|
46
|
+
*
|
|
47
|
+
* - **Emit ordering vs `@unimplemented`** — soft-warns emit AFTER the
|
|
48
|
+
* `@unimplemented` block in `defineSaasConfig`. The order is the
|
|
49
|
+
* contract because operators read the stream top-to-bottom: the
|
|
50
|
+
* "canonical" backlog warnings come first, the "soft authoring
|
|
51
|
+
* advisory" lines come after. `__tests__/soft-warn.test.ts`
|
|
52
|
+
* captures stderr writes in order and asserts the ordering by
|
|
53
|
+
* interleaving an `@unimplemented` warning with a soft-warn and
|
|
54
|
+
* pinning the resulting message sequence.
|
|
55
|
+
*
|
|
56
|
+
* - **Format = single-line with `[wildo-soft-warn:<scope>]` prefix**.
|
|
57
|
+
* The `<scope>` is operator-supplied (e.g. `'minions.marketingScrapper'`,
|
|
58
|
+
* `'workers'`) so a reader can grep `wildo-soft-warn:minions` to
|
|
59
|
+
* isolate per-minion advisories. The prefix is intentionally
|
|
60
|
+
* distinct from `[wildo-saas-config]` / `[wildo-infra-env-config]`
|
|
61
|
+
* so the two streams never collide visually in the dev watcher.
|
|
62
|
+
*
|
|
63
|
+
* - **Test reset hook = `__resetSoftWarnState`** — exported strictly
|
|
64
|
+
* for test usage. The state is a module-level `Map` because the
|
|
65
|
+
* "process-wide cap" semantic requires it; tests `vi.resetModules()`
|
|
66
|
+
* is too heavy for the cross-test isolation needed in
|
|
67
|
+
* `define-saas-config.unimplemented.test.ts` (which exercises both
|
|
68
|
+
* warners interleaved). The reset hook is documented as
|
|
69
|
+
* test-only via the leading underscore convention used elsewhere
|
|
70
|
+
* in this package.
|
|
71
|
+
*
|
|
72
|
+
* NOT a replacement for schema validation:
|
|
73
|
+
*
|
|
74
|
+
* - Soft-warns DO NOT prevent parse — they are written AFTER the
|
|
75
|
+
* `WildoSaasConfigSchema.parse()` returns successfully.
|
|
76
|
+
* - The utility is intentionally NOT typed against a known list of
|
|
77
|
+
* `(scope, key)` pairs. The caller owns the taxonomy — adding a
|
|
78
|
+
* closed enum here would force a circular dep with
|
|
79
|
+
* `define-saas-config.ts` and force every new advisory to touch
|
|
80
|
+
* this file.
|
|
81
|
+
*
|
|
82
|
+
* Removal contract:
|
|
83
|
+
*
|
|
84
|
+
* - When the v1 minions & workers runtime ships and the advisories
|
|
85
|
+
* become hard parse errors (or migrate into `@unimplemented`
|
|
86
|
+
* surfaces because a backlog item is on file), the corresponding
|
|
87
|
+
* `emitSoftWarn(...)` call sites MUST be deleted in the same commit
|
|
88
|
+
* as the new behaviour. Leaving a stale soft-warn is worse than
|
|
89
|
+
* silence — operators will start ignoring the channel.
|
|
90
|
+
*/
|
|
91
|
+
/**
|
|
92
|
+
* Emit a single-line soft-warn to `process.stderr`.
|
|
93
|
+
*
|
|
94
|
+
* @param scope - Authoring scope, surfaced verbatim in the prefix
|
|
95
|
+
* (e.g. `'minions.marketingScrapper'`, `'workers'`).
|
|
96
|
+
* @param key - Stable advisory id within the scope
|
|
97
|
+
* (e.g. `'resourceAccess.empty-write'`,
|
|
98
|
+
* `'resourceAccess.unknown-resource'`).
|
|
99
|
+
* @param message - Free-form advisory text. Newline appended by the
|
|
100
|
+
* utility (do not include trailing `\n` in `message`).
|
|
101
|
+
*
|
|
102
|
+
* Behaviour:
|
|
103
|
+
*
|
|
104
|
+
* - Writes the formatted line to `process.stderr.write`.
|
|
105
|
+
* - Increments the per-`(scope, key)` counter.
|
|
106
|
+
* - When the counter reaches the configured cap, the formatted line
|
|
107
|
+
* is written normally AND followed by a single
|
|
108
|
+
* `[wildo-soft-warn:<scope>] <key>: suppressed further occurrences
|
|
109
|
+
* (cap reached: <N>)` line. Subsequent calls to the same
|
|
110
|
+
* `(scope, key)` pair are silent.
|
|
111
|
+
* - Dedupe is driven by the serialized `(scope, key)` tuple, so
|
|
112
|
+
* punctuation inside either input does NOT affect correctness.
|
|
113
|
+
*/
|
|
114
|
+
export declare function emitSoftWarn(scope: string, key: string, message: string): void;
|
|
115
|
+
/**
|
|
116
|
+
* Test-only reset hook. Clears the process-wide `(scope, key) → count`
|
|
117
|
+
* map so each test starts from a clean slate. Production call sites
|
|
118
|
+
* must NEVER invoke this — the cap is the contract.
|
|
119
|
+
*
|
|
120
|
+
* Named with a leading underscore to match the package-wide convention
|
|
121
|
+
* for "exported strictly for test usage" hooks.
|
|
122
|
+
*/
|
|
123
|
+
export declare function __resetSoftWarnState(): void;
|
|
124
|
+
//# sourceMappingURL=soft-warn.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"soft-warn.d.ts","sourceRoot":"","sources":["../../../../src/_unimplemented/soft-warn.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyFG;AAkCH;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAmB9E;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,IAAI,IAAI,CAE3C"}
|
|
@@ -0,0 +1,170 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @fileoverview Soft-warn utility — companion to
|
|
3
|
+
* `unimplemented-field-warning.ts` for cross-cutting authoring concerns
|
|
4
|
+
* that are NOT bound to a single `@unimplemented` field but still need
|
|
5
|
+
* a noisy-yet-non-fatal `process.stderr` channel during the v1 minions
|
|
6
|
+
* & workers rollout.
|
|
7
|
+
*
|
|
8
|
+
* Why a separate utility (and not just call `emitUnimplementedFieldWarning`)?
|
|
9
|
+
*
|
|
10
|
+
* - `@unimplemented` warnings are pinned to a SCHEMA FIELD — every
|
|
11
|
+
* surface today appears in the `cli-dx.md` table and has a tracking
|
|
12
|
+
* ID in the deferred backlog. Adding non-field-bound warnings to
|
|
13
|
+
* that channel would dilute the contract that "every line in the
|
|
14
|
+
* `@unimplemented` stream maps 1:1 to a deferred-backlog row".
|
|
15
|
+
*
|
|
16
|
+
* - The minions/workers slice (KD-11 / H-3 in
|
|
17
|
+
* `.cursor/plans/minions-and-workers-implementation.md`) needs to
|
|
18
|
+
* surface advisories like "your minion's `resourceAccess` whitelist
|
|
19
|
+
* is empty — you'll get blocked at every repository call" that are
|
|
20
|
+
* PER-MINION, not per-field. The natural authoring key is a
|
|
21
|
+
* `(scope, key)` pair (e.g. `('minions.marketingScrapper', 'resourceAccess.empty')`),
|
|
22
|
+
* not a dotted field path.
|
|
23
|
+
*
|
|
24
|
+
* - The dev watcher re-parses on every save, so without an in-process
|
|
25
|
+
* repeat-cap a verbose minion ACL would spam the log on every
|
|
26
|
+
* keystroke. The `@unimplemented` warner solves dedupe per parse
|
|
27
|
+
* call (a fresh `Set` is captured per `defineSaasConfig` call); the
|
|
28
|
+
* soft-warn utility solves dedupe + cap PER PROCESS so a noisy
|
|
29
|
+
* advisory does not drown the watcher even under tight save loops.
|
|
30
|
+
*
|
|
31
|
+
* Design choices (all pinned by `__tests__/soft-warn.test.ts`):
|
|
32
|
+
*
|
|
33
|
+
* - **Channel = `process.stderr.write`** (parity with
|
|
34
|
+
* `emitUnimplementedFieldWarning`). The dev watcher's
|
|
35
|
+
* pretty-printer hijacks `console.warn`; writing to the FD keeps
|
|
36
|
+
* the line raw and grep-friendly.
|
|
37
|
+
*
|
|
38
|
+
* - **Dedupe = process-wide on `(scope, key)`** with a configurable
|
|
39
|
+
* repeat cap (default 5, env override `WILDO_SOFT_WARN_LIMIT`).
|
|
40
|
+
* After the cap is reached the utility emits ONE final
|
|
41
|
+
* `[wildo-soft-warn:<scope>] <key>: suppressed further occurrences
|
|
42
|
+
* (cap reached: <N>; override via WILDO_SOFT_WARN_LIMIT).` line and
|
|
43
|
+
* falls silent for that pair. The cap is per-process (not per parse
|
|
44
|
+
* call) because the SAME advisory firing on every dev-watcher save
|
|
45
|
+
* is exactly the noise we're trying to suppress.
|
|
46
|
+
*
|
|
47
|
+
* - **Emit ordering vs `@unimplemented`** — soft-warns emit AFTER the
|
|
48
|
+
* `@unimplemented` block in `defineSaasConfig`. The order is the
|
|
49
|
+
* contract because operators read the stream top-to-bottom: the
|
|
50
|
+
* "canonical" backlog warnings come first, the "soft authoring
|
|
51
|
+
* advisory" lines come after. `__tests__/soft-warn.test.ts`
|
|
52
|
+
* captures stderr writes in order and asserts the ordering by
|
|
53
|
+
* interleaving an `@unimplemented` warning with a soft-warn and
|
|
54
|
+
* pinning the resulting message sequence.
|
|
55
|
+
*
|
|
56
|
+
* - **Format = single-line with `[wildo-soft-warn:<scope>]` prefix**.
|
|
57
|
+
* The `<scope>` is operator-supplied (e.g. `'minions.marketingScrapper'`,
|
|
58
|
+
* `'workers'`) so a reader can grep `wildo-soft-warn:minions` to
|
|
59
|
+
* isolate per-minion advisories. The prefix is intentionally
|
|
60
|
+
* distinct from `[wildo-saas-config]` / `[wildo-infra-env-config]`
|
|
61
|
+
* so the two streams never collide visually in the dev watcher.
|
|
62
|
+
*
|
|
63
|
+
* - **Test reset hook = `__resetSoftWarnState`** — exported strictly
|
|
64
|
+
* for test usage. The state is a module-level `Map` because the
|
|
65
|
+
* "process-wide cap" semantic requires it; tests `vi.resetModules()`
|
|
66
|
+
* is too heavy for the cross-test isolation needed in
|
|
67
|
+
* `define-saas-config.unimplemented.test.ts` (which exercises both
|
|
68
|
+
* warners interleaved). The reset hook is documented as
|
|
69
|
+
* test-only via the leading underscore convention used elsewhere
|
|
70
|
+
* in this package.
|
|
71
|
+
*
|
|
72
|
+
* NOT a replacement for schema validation:
|
|
73
|
+
*
|
|
74
|
+
* - Soft-warns DO NOT prevent parse — they are written AFTER the
|
|
75
|
+
* `WildoSaasConfigSchema.parse()` returns successfully.
|
|
76
|
+
* - The utility is intentionally NOT typed against a known list of
|
|
77
|
+
* `(scope, key)` pairs. The caller owns the taxonomy — adding a
|
|
78
|
+
* closed enum here would force a circular dep with
|
|
79
|
+
* `define-saas-config.ts` and force every new advisory to touch
|
|
80
|
+
* this file.
|
|
81
|
+
*
|
|
82
|
+
* Removal contract:
|
|
83
|
+
*
|
|
84
|
+
* - When the v1 minions & workers runtime ships and the advisories
|
|
85
|
+
* become hard parse errors (or migrate into `@unimplemented`
|
|
86
|
+
* surfaces because a backlog item is on file), the corresponding
|
|
87
|
+
* `emitSoftWarn(...)` call sites MUST be deleted in the same commit
|
|
88
|
+
* as the new behaviour. Leaving a stale soft-warn is worse than
|
|
89
|
+
* silence — operators will start ignoring the channel.
|
|
90
|
+
*/
|
|
91
|
+
const DEFAULT_REPEAT_LIMIT = 5;
|
|
92
|
+
/**
|
|
93
|
+
* Module-level state — process-wide, deliberately so the dev watcher's
|
|
94
|
+
* per-save re-parses do not re-emit the same advisory on every keystroke.
|
|
95
|
+
*
|
|
96
|
+
* Keys are a serialized tuple `[scope, key]`, not a raw concatenated
|
|
97
|
+
* string. This keeps the dedupe channel robust even when either input
|
|
98
|
+
* contains punctuation like `::` — author-authored identifiers must not
|
|
99
|
+
* be able to make advisory emission throw after a successful config
|
|
100
|
+
* parse.
|
|
101
|
+
*
|
|
102
|
+
* The value is the count of actual emitted advisory lines for the pair.
|
|
103
|
+
* Once the count reaches the cap, the cap-reached suppression line is
|
|
104
|
+
* written exactly once.
|
|
105
|
+
*/
|
|
106
|
+
const softWarnState = new Map();
|
|
107
|
+
function readRepeatLimit() {
|
|
108
|
+
const raw = process.env.WILDO_SOFT_WARN_LIMIT;
|
|
109
|
+
if (raw === undefined || raw === '')
|
|
110
|
+
return DEFAULT_REPEAT_LIMIT;
|
|
111
|
+
const normalized = raw.trim();
|
|
112
|
+
if (!/^[1-9]\d*$/.test(normalized))
|
|
113
|
+
return DEFAULT_REPEAT_LIMIT;
|
|
114
|
+
const parsed = Number(normalized);
|
|
115
|
+
if (!Number.isSafeInteger(parsed) || parsed < 1)
|
|
116
|
+
return DEFAULT_REPEAT_LIMIT;
|
|
117
|
+
return parsed;
|
|
118
|
+
}
|
|
119
|
+
function serializeDedupeKey(scope, key) {
|
|
120
|
+
return JSON.stringify([scope, key]);
|
|
121
|
+
}
|
|
122
|
+
/**
|
|
123
|
+
* Emit a single-line soft-warn to `process.stderr`.
|
|
124
|
+
*
|
|
125
|
+
* @param scope - Authoring scope, surfaced verbatim in the prefix
|
|
126
|
+
* (e.g. `'minions.marketingScrapper'`, `'workers'`).
|
|
127
|
+
* @param key - Stable advisory id within the scope
|
|
128
|
+
* (e.g. `'resourceAccess.empty-write'`,
|
|
129
|
+
* `'resourceAccess.unknown-resource'`).
|
|
130
|
+
* @param message - Free-form advisory text. Newline appended by the
|
|
131
|
+
* utility (do not include trailing `\n` in `message`).
|
|
132
|
+
*
|
|
133
|
+
* Behaviour:
|
|
134
|
+
*
|
|
135
|
+
* - Writes the formatted line to `process.stderr.write`.
|
|
136
|
+
* - Increments the per-`(scope, key)` counter.
|
|
137
|
+
* - When the counter reaches the configured cap, the formatted line
|
|
138
|
+
* is written normally AND followed by a single
|
|
139
|
+
* `[wildo-soft-warn:<scope>] <key>: suppressed further occurrences
|
|
140
|
+
* (cap reached: <N>)` line. Subsequent calls to the same
|
|
141
|
+
* `(scope, key)` pair are silent.
|
|
142
|
+
* - Dedupe is driven by the serialized `(scope, key)` tuple, so
|
|
143
|
+
* punctuation inside either input does NOT affect correctness.
|
|
144
|
+
*/
|
|
145
|
+
export function emitSoftWarn(scope, key, message) {
|
|
146
|
+
const cap = readRepeatLimit();
|
|
147
|
+
const dedupeKey = serializeDedupeKey(scope, key);
|
|
148
|
+
const previous = softWarnState.get(dedupeKey) ?? 0;
|
|
149
|
+
if (previous >= cap) {
|
|
150
|
+
return;
|
|
151
|
+
}
|
|
152
|
+
const next = previous + 1;
|
|
153
|
+
softWarnState.set(dedupeKey, next);
|
|
154
|
+
process.stderr.write(`[wildo-soft-warn:${scope}] ${key}: ${message}\n`);
|
|
155
|
+
if (next === cap) {
|
|
156
|
+
process.stderr.write(`[wildo-soft-warn:${scope}] ${key}: suppressed further occurrences (cap reached: ${cap}; override via WILDO_SOFT_WARN_LIMIT).\n`);
|
|
157
|
+
}
|
|
158
|
+
}
|
|
159
|
+
/**
|
|
160
|
+
* Test-only reset hook. Clears the process-wide `(scope, key) → count`
|
|
161
|
+
* map so each test starts from a clean slate. Production call sites
|
|
162
|
+
* must NEVER invoke this — the cap is the contract.
|
|
163
|
+
*
|
|
164
|
+
* Named with a leading underscore to match the package-wide convention
|
|
165
|
+
* for "exported strictly for test usage" hooks.
|
|
166
|
+
*/
|
|
167
|
+
export function __resetSoftWarnState() {
|
|
168
|
+
softWarnState.clear();
|
|
169
|
+
}
|
|
170
|
+
//# sourceMappingURL=soft-warn.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"soft-warn.js","sourceRoot":"","sources":["../../../../src/_unimplemented/soft-warn.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyFG;AAEH,MAAM,oBAAoB,GAAG,CAAC,CAAC;AAE/B;;;;;;;;;;;;;GAaG;AACH,MAAM,aAAa,GAAG,IAAI,GAAG,EAAkB,CAAC;AAEhD,SAAS,eAAe;IACtB,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC;IAC9C,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,EAAE;QAAE,OAAO,oBAAoB,CAAC;IACjE,MAAM,UAAU,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IAC9B,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,UAAU,CAAC;QAAE,OAAO,oBAAoB,CAAC;IAChE,MAAM,MAAM,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC;IAClC,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC;QAAE,OAAO,oBAAoB,CAAC;IAC7E,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,kBAAkB,CAAC,KAAa,EAAE,GAAW;IACpD,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC;AACtC,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,YAAY,CAAC,KAAa,EAAE,GAAW,EAAE,OAAe;IACtE,MAAM,GAAG,GAAG,eAAe,EAAE,CAAC;IAC9B,MAAM,SAAS,GAAG,kBAAkB,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACjD,MAAM,QAAQ,GAAG,aAAa,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IAEnD,IAAI,QAAQ,IAAI,GAAG,EAAE,CAAC;QACpB,OAAO;IACT,CAAC;IAED,MAAM,IAAI,GAAG,QAAQ,GAAG,CAAC,CAAC;IAC1B,aAAa,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IAEnC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,oBAAoB,KAAK,KAAK,GAAG,KAAK,OAAO,IAAI,CAAC,CAAC;IAExE,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;QACjB,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,oBAAoB,KAAK,KAAK,GAAG,kDAAkD,GAAG,0CAA0C,CACjI,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,oBAAoB;IAClC,aAAa,CAAC,KAAK,EAAE,CAAC;AACxB,CAAC","sourcesContent":["/**\n * @fileoverview Soft-warn utility — companion to\n * `unimplemented-field-warning.ts` for cross-cutting authoring concerns\n * that are NOT bound to a single `@unimplemented` field but still need\n * a noisy-yet-non-fatal `process.stderr` channel during the v1 minions\n * & workers rollout.\n *\n * Why a separate utility (and not just call `emitUnimplementedFieldWarning`)?\n *\n * - `@unimplemented` warnings are pinned to a SCHEMA FIELD — every\n * surface today appears in the `cli-dx.md` table and has a tracking\n * ID in the deferred backlog. Adding non-field-bound warnings to\n * that channel would dilute the contract that \"every line in the\n * `@unimplemented` stream maps 1:1 to a deferred-backlog row\".\n *\n * - The minions/workers slice (KD-11 / H-3 in\n * `.cursor/plans/minions-and-workers-implementation.md`) needs to\n * surface advisories like \"your minion's `resourceAccess` whitelist\n * is empty — you'll get blocked at every repository call\" that are\n * PER-MINION, not per-field. The natural authoring key is a\n * `(scope, key)` pair (e.g. `('minions.marketingScrapper', 'resourceAccess.empty')`),\n * not a dotted field path.\n *\n * - The dev watcher re-parses on every save, so without an in-process\n * repeat-cap a verbose minion ACL would spam the log on every\n * keystroke. The `@unimplemented` warner solves dedupe per parse\n * call (a fresh `Set` is captured per `defineSaasConfig` call); the\n * soft-warn utility solves dedupe + cap PER PROCESS so a noisy\n * advisory does not drown the watcher even under tight save loops.\n *\n * Design choices (all pinned by `__tests__/soft-warn.test.ts`):\n *\n * - **Channel = `process.stderr.write`** (parity with\n * `emitUnimplementedFieldWarning`). The dev watcher's\n * pretty-printer hijacks `console.warn`; writing to the FD keeps\n * the line raw and grep-friendly.\n *\n * - **Dedupe = process-wide on `(scope, key)`** with a configurable\n * repeat cap (default 5, env override `WILDO_SOFT_WARN_LIMIT`).\n * After the cap is reached the utility emits ONE final\n * `[wildo-soft-warn:<scope>] <key>: suppressed further occurrences\n * (cap reached: <N>; override via WILDO_SOFT_WARN_LIMIT).` line and\n * falls silent for that pair. The cap is per-process (not per parse\n * call) because the SAME advisory firing on every dev-watcher save\n * is exactly the noise we're trying to suppress.\n *\n * - **Emit ordering vs `@unimplemented`** — soft-warns emit AFTER the\n * `@unimplemented` block in `defineSaasConfig`. The order is the\n * contract because operators read the stream top-to-bottom: the\n * \"canonical\" backlog warnings come first, the \"soft authoring\n * advisory\" lines come after. `__tests__/soft-warn.test.ts`\n * captures stderr writes in order and asserts the ordering by\n * interleaving an `@unimplemented` warning with a soft-warn and\n * pinning the resulting message sequence.\n *\n * - **Format = single-line with `[wildo-soft-warn:<scope>]` prefix**.\n * The `<scope>` is operator-supplied (e.g. `'minions.marketingScrapper'`,\n * `'workers'`) so a reader can grep `wildo-soft-warn:minions` to\n * isolate per-minion advisories. The prefix is intentionally\n * distinct from `[wildo-saas-config]` / `[wildo-infra-env-config]`\n * so the two streams never collide visually in the dev watcher.\n *\n * - **Test reset hook = `__resetSoftWarnState`** — exported strictly\n * for test usage. The state is a module-level `Map` because the\n * \"process-wide cap\" semantic requires it; tests `vi.resetModules()`\n * is too heavy for the cross-test isolation needed in\n * `define-saas-config.unimplemented.test.ts` (which exercises both\n * warners interleaved). The reset hook is documented as\n * test-only via the leading underscore convention used elsewhere\n * in this package.\n *\n * NOT a replacement for schema validation:\n *\n * - Soft-warns DO NOT prevent parse — they are written AFTER the\n * `WildoSaasConfigSchema.parse()` returns successfully.\n * - The utility is intentionally NOT typed against a known list of\n * `(scope, key)` pairs. The caller owns the taxonomy — adding a\n * closed enum here would force a circular dep with\n * `define-saas-config.ts` and force every new advisory to touch\n * this file.\n *\n * Removal contract:\n *\n * - When the v1 minions & workers runtime ships and the advisories\n * become hard parse errors (or migrate into `@unimplemented`\n * surfaces because a backlog item is on file), the corresponding\n * `emitSoftWarn(...)` call sites MUST be deleted in the same commit\n * as the new behaviour. Leaving a stale soft-warn is worse than\n * silence — operators will start ignoring the channel.\n */\n\nconst DEFAULT_REPEAT_LIMIT = 5;\n\n/**\n * Module-level state — process-wide, deliberately so the dev watcher's\n * per-save re-parses do not re-emit the same advisory on every keystroke.\n *\n * Keys are a serialized tuple `[scope, key]`, not a raw concatenated\n * string. This keeps the dedupe channel robust even when either input\n * contains punctuation like `::` — author-authored identifiers must not\n * be able to make advisory emission throw after a successful config\n * parse.\n *\n * The value is the count of actual emitted advisory lines for the pair.\n * Once the count reaches the cap, the cap-reached suppression line is\n * written exactly once.\n */\nconst softWarnState = new Map<string, number>();\n\nfunction readRepeatLimit(): number {\n const raw = process.env.WILDO_SOFT_WARN_LIMIT;\n if (raw === undefined || raw === '') return DEFAULT_REPEAT_LIMIT;\n const normalized = raw.trim();\n if (!/^[1-9]\\d*$/.test(normalized)) return DEFAULT_REPEAT_LIMIT;\n const parsed = Number(normalized);\n if (!Number.isSafeInteger(parsed) || parsed < 1) return DEFAULT_REPEAT_LIMIT;\n return parsed;\n}\n\nfunction serializeDedupeKey(scope: string, key: string): string {\n return JSON.stringify([scope, key]);\n}\n\n/**\n * Emit a single-line soft-warn to `process.stderr`.\n *\n * @param scope - Authoring scope, surfaced verbatim in the prefix\n * (e.g. `'minions.marketingScrapper'`, `'workers'`).\n * @param key - Stable advisory id within the scope\n * (e.g. `'resourceAccess.empty-write'`,\n * `'resourceAccess.unknown-resource'`).\n * @param message - Free-form advisory text. Newline appended by the\n * utility (do not include trailing `\\n` in `message`).\n *\n * Behaviour:\n *\n * - Writes the formatted line to `process.stderr.write`.\n * - Increments the per-`(scope, key)` counter.\n * - When the counter reaches the configured cap, the formatted line\n * is written normally AND followed by a single\n * `[wildo-soft-warn:<scope>] <key>: suppressed further occurrences\n * (cap reached: <N>)` line. Subsequent calls to the same\n * `(scope, key)` pair are silent.\n * - Dedupe is driven by the serialized `(scope, key)` tuple, so\n * punctuation inside either input does NOT affect correctness.\n */\nexport function emitSoftWarn(scope: string, key: string, message: string): void {\n const cap = readRepeatLimit();\n const dedupeKey = serializeDedupeKey(scope, key);\n const previous = softWarnState.get(dedupeKey) ?? 0;\n\n if (previous >= cap) {\n return;\n }\n\n const next = previous + 1;\n softWarnState.set(dedupeKey, next);\n\n process.stderr.write(`[wildo-soft-warn:${scope}] ${key}: ${message}\\n`);\n\n if (next === cap) {\n process.stderr.write(\n `[wildo-soft-warn:${scope}] ${key}: suppressed further occurrences (cap reached: ${cap}; override via WILDO_SOFT_WARN_LIMIT).\\n`,\n );\n }\n}\n\n/**\n * Test-only reset hook. Clears the process-wide `(scope, key) → count`\n * map so each test starts from a clean slate. Production call sites\n * must NEVER invoke this — the cap is the contract.\n *\n * Named with a leading underscore to match the package-wide convention\n * for \"exported strictly for test usage\" hooks.\n */\nexport function __resetSoftWarnState(): void {\n softWarnState.clear();\n}\n"]}
|
|
@@ -0,0 +1,137 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @fileoverview `@unimplemented` runtime-contract warning utility
|
|
3
|
+
* (Slice 3.4 + Slice 3.5 infra extension).
|
|
4
|
+
*
|
|
5
|
+
* Some authored fields on `WildoSaasConfigSchema` and
|
|
6
|
+
* `WildoInfraEnvConfigInputSchema` are intentionally exposed in the
|
|
7
|
+
* authoring surface today but have **no runtime consumer yet**: they
|
|
8
|
+
* are "scaffolded for the next slice". Examples (full list in
|
|
9
|
+
* `.cursor/plans/post-flattening-completion-fixes.md` Slices 3.4-3.5 +
|
|
10
|
+
* the deferred-backlog table):
|
|
11
|
+
*
|
|
12
|
+
* - `WildoSaasConfig.version`, `WildoInfraEnvConfig.version` → backlog `D-5`
|
|
13
|
+
*
|
|
14
|
+
* (`WildoSaasConfig.{minions, workers}` → backlog `D-1` was retired
|
|
15
|
+
* 2026-05-05 with the close of D-1; the runtime path now ships
|
|
16
|
+
* end-to-end — see `.claude/plans/minions-and-workers-implementation.md`
|
|
17
|
+
* Phase 4. The per-entry `resourceAccess` soft-warn channel under
|
|
18
|
+
* `minions.<key>` survives because it is an authoring-contract
|
|
19
|
+
* advisory, not a "runtime missing" marker.)
|
|
20
|
+
*
|
|
21
|
+
* The framework-mindset rule of thumb (per `.cursor/rules/design-philosophy.mdc`)
|
|
22
|
+
* is that **every authored field must carry its semantic weight**. Silently
|
|
23
|
+
* stripping or silently ignoring authored values is the kind of "trick" that
|
|
24
|
+
* compounds into long-term debt — an app developer who writes a still-deferred
|
|
25
|
+
* field should NOT discover six months later that the flag never wired
|
|
26
|
+
* anything up.
|
|
27
|
+
*
|
|
28
|
+
* The honest middle-ground until the deferred slices land is:
|
|
29
|
+
*
|
|
30
|
+
* 1. Keep the field in the schema so authored configs stay forward-compatible
|
|
31
|
+
* when the runtime support DOES arrive (no breaking re-author).
|
|
32
|
+
* 2. **Loudly warn at parse time** that the field is parsed but currently
|
|
33
|
+
* has no runtime consumer, with a pointer to the tracking backlog ID.
|
|
34
|
+
* 3. Document the same set in `cli-dx.md` so a reader can audit the gap
|
|
35
|
+
* without grepping the codebase.
|
|
36
|
+
*
|
|
37
|
+
* Design choices made for this utility:
|
|
38
|
+
*
|
|
39
|
+
* - **Channel = `process.stderr`** (decided 2026-04-13). Writing directly to
|
|
40
|
+
* the FD keeps the utility usable from every context the schema runs in
|
|
41
|
+
* today — CLI commands, the dev watcher, backend bootstrap, and tests —
|
|
42
|
+
* without coupling to the CLI logger or to `console.warn` (the latter
|
|
43
|
+
* would be hijacked by the dev watcher's pretty-printer and the warning
|
|
44
|
+
* would lose its raw form). Tests stub via `vi.spyOn(process.stderr, 'write')`.
|
|
45
|
+
* - **Dedupe = "once per parse call"** (decided 2026-04-13). The utility is
|
|
46
|
+
* stateless — no module-level `Set` caching emitted warnings — and the
|
|
47
|
+
* *caller* (`defineSaasConfig`) owns a fresh `Set<string>` per parse so
|
|
48
|
+
* that authoring the same field twice in one config still warns once,
|
|
49
|
+
* but the dev watcher re-parsing on every save still re-emits the full
|
|
50
|
+
* set so authors see them on every save instead of "warning fatigue =
|
|
51
|
+
* silent after the first save". Process-wide dedupe was rejected because
|
|
52
|
+
* a long-lived dev watcher would emit each warning exactly once at boot
|
|
53
|
+
* and never again, defeating the purpose for someone who joins later.
|
|
54
|
+
* - **Format = single-line with slice ID + plan reference** (decided
|
|
55
|
+
* 2026-04-13). One line per warning is grep-friendly, fits inside dev
|
|
56
|
+
* watcher log streams without breaking layout, and embedding `D-{n}`
|
|
57
|
+
* plus the plan filename gives the reader a one-jump path to the
|
|
58
|
+
* tracking entry. The longer "two-line block" alternative was rejected
|
|
59
|
+
* because the dev watcher's per-line log prefixes break the visual
|
|
60
|
+
* indentation, and the "minimal one-liner" alternative was rejected
|
|
61
|
+
* because it required the reader to look up `D-{n}` separately.
|
|
62
|
+
*
|
|
63
|
+
* NOT a replacement for schema validation:
|
|
64
|
+
* - This utility does NOT prevent the field from being authored.
|
|
65
|
+
* - It does NOT cast / coerce / mutate the parsed value.
|
|
66
|
+
* - It is a **runtime advisory**, surfaced AFTER `WildoSaasConfigSchema.parse()`
|
|
67
|
+
* succeeds, by the `defineSaasConfig` wrapper.
|
|
68
|
+
*
|
|
69
|
+
* When the deferred backlog item lands and the runtime consumer ships, the
|
|
70
|
+
* corresponding `if (...) emitUnimplementedFieldWarning(...)` block in
|
|
71
|
+
* `defineSaasConfig.ts` MUST be removed in the same commit as the runtime
|
|
72
|
+
* wiring — leaving a stale warning is worse than silence because authors
|
|
73
|
+
* will start ignoring the channel.
|
|
74
|
+
*/
|
|
75
|
+
/**
|
|
76
|
+
* Source label embedded in the warning prefix so a reader can tell at a
|
|
77
|
+
* glance which authored config emitted the warning. Keep the literals
|
|
78
|
+
* stable — tests and operator runbooks may grep on these prefixes.
|
|
79
|
+
*/
|
|
80
|
+
export declare enum UnimplementedFieldSource {
|
|
81
|
+
SAAS_CONFIG = "wildo-saas-config",
|
|
82
|
+
INFRA_ENV_CONFIG = "wildo-infra-env-config"
|
|
83
|
+
}
|
|
84
|
+
/**
|
|
85
|
+
* Emit a single-line `@unimplemented` warning to `process.stderr`.
|
|
86
|
+
*
|
|
87
|
+
* @param source - Which authored config the field belongs to. Surfaces in
|
|
88
|
+
* the warning prefix (`[wildo-saas-config]` /
|
|
89
|
+
* `[wildo-infra-env-config]`) so the reader can match the
|
|
90
|
+
* warning back to the file they were editing without
|
|
91
|
+
* scrolling the call stack.
|
|
92
|
+
* @param fieldPath - Dotted path to the authored field, e.g.
|
|
93
|
+
* `'features.organizations'` or
|
|
94
|
+
* `'capabilities.AI_LLM.runtime'`. Used as the dedupe
|
|
95
|
+
* key by callers and surfaced verbatim in the warning
|
|
96
|
+
* text so authors can ctrl-F it in their config.
|
|
97
|
+
* @param followUpSliceId - Tracking ID in the deferred backlog
|
|
98
|
+
* (`D-1` / `D-2` / `D-3` / `D-5` today, plus
|
|
99
|
+
* auth-hardening's `B-2C`). Surfaced in the
|
|
100
|
+
* warning so readers can jump to the matching
|
|
101
|
+
* plan entry without grepping.
|
|
102
|
+
* @param followUpPlanPath - Plan file that owns the backlog ID. Defaults
|
|
103
|
+
* to `post-flattening-completion-fixes.md` so
|
|
104
|
+
* the existing D-series warnings keep their
|
|
105
|
+
* current breadcrumb, but callers can override
|
|
106
|
+
* it for backlog IDs owned by another plan.
|
|
107
|
+
*
|
|
108
|
+
* The warning is written synchronously; this is intentional so the line
|
|
109
|
+
* appears next to the offending parse in the dev watcher's interleaved
|
|
110
|
+
* log stream. Throwing here is intentionally not done — a bad warning
|
|
111
|
+
* must never block a parse, only inform.
|
|
112
|
+
*/
|
|
113
|
+
export declare function emitUnimplementedFieldWarning(source: UnimplementedFieldSource, fieldPath: string, followUpSliceId: string, followUpPlanPath?: string): void;
|
|
114
|
+
/**
|
|
115
|
+
* Convenience wrapper that owns a per-call dedupe `Set<string>` keyed by
|
|
116
|
+
* `fieldPath` alone (the `source` is bound by the closure, so embedding
|
|
117
|
+
* it in the dedupe key would be redundant — one warner instance is
|
|
118
|
+
* scoped to one source). Intended call shape:
|
|
119
|
+
*
|
|
120
|
+
* ```ts
|
|
121
|
+
* const warn = createUnimplementedFieldWarner(UnimplementedFieldSource.SAAS_CONFIG);
|
|
122
|
+
* warn('features.organizations', 'D-3');
|
|
123
|
+
* warn('features.organizations', 'D-3'); // second call is a no-op
|
|
124
|
+
* warn('csp.docs', 'B-2C', '.cursor/plans/auth-hardening.md');
|
|
125
|
+
* ```
|
|
126
|
+
*
|
|
127
|
+
* The returned closure is local to the parse call (not stored on a
|
|
128
|
+
* module / singleton) so dev-watcher re-parses still re-emit the full set
|
|
129
|
+
* — see the "once per parse call" decision in the file-level JSDoc above.
|
|
130
|
+
*
|
|
131
|
+
* The source is captured by the closure so callers (one per
|
|
132
|
+
* `defineSaasConfig` / `defineInfraEnvConfig` invocation) only have to
|
|
133
|
+
* pass field paths, matching the existing call shape used in
|
|
134
|
+
* `defineSaasConfig.emitUnimplementedRuntimeWarnings`.
|
|
135
|
+
*/
|
|
136
|
+
export declare function createUnimplementedFieldWarner(source: UnimplementedFieldSource): (fieldPath: string, followUpSliceId: string, followUpPlanPath?: string) => void;
|
|
137
|
+
//# sourceMappingURL=unimplemented-field-warning.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"unimplemented-field-warning.d.ts","sourceRoot":"","sources":["../../../../src/_unimplemented/unimplemented-field-warning.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyEG;AAEH;;;;GAIG;AACH,oBAAY,wBAAwB;IAClC,WAAW,sBAAsB;IACjC,gBAAgB,2BAA2B;CAC5C;AAID;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,6BAA6B,CAC3C,MAAM,EAAE,wBAAwB,EAChC,SAAS,EAAE,MAAM,EACjB,eAAe,EAAE,MAAM,EACvB,gBAAgB,GAAE,MAAwC,GACzD,IAAI,CAON;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,wBAAwB,GAC/B,CAAC,SAAS,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,gBAAgB,CAAC,EAAE,MAAM,KAAK,IAAI,CAOjF"}
|