@wildo-ai/platform-config-lib 1.1.1 → 1.1.3

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.
Files changed (91) hide show
  1. package/dist/esm/bootstrap/bootstrap.schemas.d.ts +67 -1
  2. package/dist/esm/bootstrap/bootstrap.schemas.d.ts.map +1 -1
  3. package/dist/esm/bootstrap/bootstrap.schemas.js +51 -2
  4. package/dist/esm/bootstrap/bootstrap.schemas.js.map +1 -1
  5. package/dist/esm/bootstrap/platform-runtime-env.contracts.d.ts +2 -3
  6. package/dist/esm/bootstrap/platform-runtime-env.contracts.d.ts.map +1 -1
  7. package/dist/esm/bootstrap/platform-runtime-env.contracts.js +2 -3
  8. package/dist/esm/bootstrap/platform-runtime-env.contracts.js.map +1 -1
  9. package/dist/esm/bootstrap/runtime-network-topology.d.ts +0 -1
  10. package/dist/esm/bootstrap/runtime-network-topology.d.ts.map +1 -1
  11. package/dist/esm/bootstrap/runtime-network-topology.js +0 -2
  12. package/dist/esm/bootstrap/runtime-network-topology.js.map +1 -1
  13. package/dist/esm/bootstrap/wildo-owner-organization.contracts.d.ts +52 -0
  14. package/dist/esm/bootstrap/wildo-owner-organization.contracts.d.ts.map +1 -0
  15. package/dist/esm/bootstrap/wildo-owner-organization.contracts.js +5 -0
  16. package/dist/esm/bootstrap/wildo-owner-organization.contracts.js.map +1 -0
  17. package/dist/esm/config-authoring.entry.d.ts +1 -2
  18. package/dist/esm/config-authoring.entry.d.ts.map +1 -1
  19. package/dist/esm/config-authoring.entry.js +35 -2
  20. package/dist/esm/config-authoring.entry.js.map +1 -1
  21. package/dist/esm/index.d.ts +1 -0
  22. package/dist/esm/index.d.ts.map +1 -1
  23. package/dist/esm/index.js +1 -0
  24. package/dist/esm/index.js.map +1 -1
  25. package/dist/esm/lockfile/wildo-saas-lock.shared.schemas.d.ts +0 -20
  26. package/dist/esm/lockfile/wildo-saas-lock.shared.schemas.d.ts.map +1 -1
  27. package/dist/esm/lockfile/wildo-saas-lock.shared.schemas.js +0 -1
  28. package/dist/esm/lockfile/wildo-saas-lock.shared.schemas.js.map +1 -1
  29. package/dist/esm/project-config/define-framework-config.d.ts +4 -4
  30. package/dist/esm/project-config/define-infra-env-config.d.ts +3 -39
  31. package/dist/esm/project-config/define-infra-env-config.d.ts.map +1 -1
  32. package/dist/esm/project-config/define-infra-env-config.js +2 -2
  33. package/dist/esm/project-config/define-infra-env-config.js.map +1 -1
  34. package/dist/esm/project-config/define-saas-config.d.ts +378 -14
  35. package/dist/esm/project-config/define-saas-config.d.ts.map +1 -1
  36. package/dist/esm/project-config/define-saas-config.js +122 -11
  37. package/dist/esm/project-config/define-saas-config.js.map +1 -1
  38. package/dist/esm/project-config/provider-companion-discovery.d.ts +74 -1
  39. package/dist/esm/project-config/provider-companion-discovery.d.ts.map +1 -1
  40. package/dist/esm/project-config/provider-companion-discovery.js +203 -6
  41. package/dist/esm/project-config/provider-companion-discovery.js.map +1 -1
  42. package/dist/esm/project-config/provider-runtime-artifacts.d.ts +42 -16
  43. package/dist/esm/project-config/provider-runtime-artifacts.d.ts.map +1 -1
  44. package/dist/esm/project-config/provider-runtime-artifacts.js +75 -6
  45. package/dist/esm/project-config/provider-runtime-artifacts.js.map +1 -1
  46. package/dist/esm/project-config/shared/backing-services.schemas.d.ts +7 -43
  47. package/dist/esm/project-config/shared/backing-services.schemas.d.ts.map +1 -1
  48. package/dist/esm/project-config/shared/backing-services.schemas.js +13 -30
  49. package/dist/esm/project-config/shared/backing-services.schemas.js.map +1 -1
  50. package/dist/esm/project-config/shared/csp-emit.d.ts +36 -5
  51. package/dist/esm/project-config/shared/csp-emit.d.ts.map +1 -1
  52. package/dist/esm/project-config/shared/csp-emit.js +65 -5
  53. package/dist/esm/project-config/shared/csp-emit.js.map +1 -1
  54. package/dist/esm/project-config/shared/csp.schemas.d.ts +46 -10
  55. package/dist/esm/project-config/shared/csp.schemas.d.ts.map +1 -1
  56. package/dist/esm/project-config/shared/csp.schemas.js +45 -10
  57. package/dist/esm/project-config/shared/csp.schemas.js.map +1 -1
  58. package/dist/esm/project-config/shared/environment.schemas.d.ts +8 -6
  59. package/dist/esm/project-config/shared/environment.schemas.d.ts.map +1 -1
  60. package/dist/esm/project-config/shared/environment.schemas.js +7 -5
  61. package/dist/esm/project-config/shared/environment.schemas.js.map +1 -1
  62. package/dist/esm/project-config/shared/infra-providers.schemas.d.ts +18 -3
  63. package/dist/esm/project-config/shared/infra-providers.schemas.d.ts.map +1 -1
  64. package/dist/esm/project-config/shared/infra-providers.schemas.js +34 -2
  65. package/dist/esm/project-config/shared/infra-providers.schemas.js.map +1 -1
  66. package/dist/esm/project-config/shared/infrastructure-defaults.schemas.d.ts +0 -2
  67. package/dist/esm/project-config/shared/infrastructure-defaults.schemas.d.ts.map +1 -1
  68. package/dist/esm/project-config/shared/infrastructure-defaults.schemas.js +0 -2
  69. package/dist/esm/project-config/shared/infrastructure-defaults.schemas.js.map +1 -1
  70. package/dist/esm/project-config/shared/k8s-utils.d.ts +70 -10
  71. package/dist/esm/project-config/shared/k8s-utils.d.ts.map +1 -1
  72. package/dist/esm/project-config/shared/k8s-utils.js +75 -11
  73. package/dist/esm/project-config/shared/k8s-utils.js.map +1 -1
  74. package/dist/esm/project-config/shared/minion-platform-access.vocabulary.d.ts +15 -15
  75. package/dist/esm/project-config/shared/minion-platform-access.vocabulary.js +15 -15
  76. package/dist/esm/project-config/shared/minion-platform-access.vocabulary.js.map +1 -1
  77. package/dist/esm/project-config/shared/platform-services.schemas.d.ts +30 -0
  78. package/dist/esm/project-config/shared/platform-services.schemas.d.ts.map +1 -1
  79. package/dist/esm/project-config/shared/platform-services.schemas.js +31 -0
  80. package/dist/esm/project-config/shared/platform-services.schemas.js.map +1 -1
  81. package/dist/esm/release/framework-release.constants.d.ts +24 -19
  82. package/dist/esm/release/framework-release.constants.d.ts.map +1 -1
  83. package/dist/esm/release/framework-release.constants.js +24 -19
  84. package/dist/esm/release/framework-release.constants.js.map +1 -1
  85. package/dist/esm/workspace-scope/workspace-homes.schemas.d.ts +14 -0
  86. package/dist/esm/workspace-scope/workspace-homes.schemas.d.ts.map +1 -1
  87. package/dist/esm/workspace-scope/workspace-homes.schemas.js +2 -0
  88. package/dist/esm/workspace-scope/workspace-homes.schemas.js.map +1 -1
  89. package/dist/tsconfig.build.tsbuildinfo +1 -1
  90. package/package.json +7 -7
  91. package/dist/esm/.builder.pid +0 -9
@@ -75,16 +75,14 @@ export function k8sServiceConfigMapName(service) {
75
75
  * (`k8s-secrets-generator.service.ts` § 5) calls this helper with the app's
76
76
  * backend `serviceName`.
77
77
  *
78
- * ⚠️ KNOWN GAP — the K8s app lane is not yet runtime-verified (no live cluster
79
- * run). `wildo-ai-application/deployment.yaml.hbs` hardcodes the mount name
80
- * `wildo-ai-application-secret` (and the image `wildo-ai-application:{{imageTag}}`),
81
- * i.e. the manifests assume one canonical app identity, while this helper is
82
- * called with the app's REAL backend `serviceName` (e.g.
83
- * `wonder-todos-backend-api`). The two only line up when the backend is literally
84
- * named `wildo-ai-application`. The mount is fail-closed (no `optional: true`),
85
- * so a mismatch means the pod cannot boot. Resolve by either parameterizing the
86
- * template's secret name or pinning the emit to the canonical app identity —
87
- * see `.claude/plans/self-host-domain-subdomain-model.md`.
78
+ * The name-mismatch gap this JSDoc used to warn about is CLOSED (#377): the templates no longer
79
+ * spell a Secret name at all — each receives the resolved `{{runtimeEnvSecretName}}` from
80
+ * {@link k8sRuntimeEnvSecretName}, which is the same function the emit side calls. The mount stays
81
+ * fail-closed (no `optional: true`), so were the two ever to diverge again the pod would refuse to
82
+ * boot rather than start without its environment.
83
+ *
84
+ * ⚠️ Still true: the K8s app lane has never had a live cluster run. What is verified is that emit
85
+ * and mount agree, pinned from both sides.
88
86
  *
89
87
  * Application backends emit a single Secret per app (no companion ConfigMap):
90
88
  * envFrom mounts every entry as `process.env.*`, so splitting sensitive vs
@@ -92,6 +90,72 @@ export function k8sServiceConfigMapName(service) {
92
90
  * See `k8s-secrets-generator.service.ts` § 5 for the design note.
93
91
  */
94
92
  export function k8sAppBackendSecretName(serviceName) {
95
- return `${serviceName}-secret`;
93
+ return k8sRuntimeEnvSecretName(serviceName);
94
+ }
95
+ /**
96
+ * K8s Secret name carrying ONE runtime's ENVIRONMENT: `<runtimeServiceName>-secret`.
97
+ *
98
+ * The companion of {@link k8sRuntimeProvidersSecretName} — that one carries a runtime's provider
99
+ * CREDENTIALS, this one everything else it boots with. Same keying: the app slug for the backend
100
+ * pod, {@link buildMinionServiceName} / {@link buildWorkerServiceName} for a minion or worker.
101
+ *
102
+ * ## Why minions and workers stopped sharing the backend's (issue #377)
103
+ *
104
+ * Every minion and worker pod used to `envFrom`-mount the BACKEND's `{appSlug}-secret`, so each
105
+ * received the backend's whole environment: the platform bootstrap contract, MongoDB / PostgreSQL /
106
+ * Redis / RabbitMQ topology, storage configuration — and, once #360 composed it, the backend's
107
+ * `OTEL_EXPORTER_OTLP_HEADERS`, which carries the telemetry provider's token. So the per-runtime
108
+ * confinement that #329, #360 and #369 established was defeated one level up: a minion scoped to
109
+ * `openai` alone got no telemetry token in its own provider Secret and received it anyway, from a
110
+ * different runtime's environment.
111
+ *
112
+ * `buildApplicationMinionEnv` and `buildApplicationWorkerEnv` already existed, already took a
113
+ * `RuntimeProviderScope`, and already produced the correctly-scoped environment for the compose
114
+ * lane. The Kubernetes lane simply never called them.
115
+ *
116
+ * ## Every mount name is now resolved here, including the backend's
117
+ *
118
+ * `k8sAppBackendSecretName` delegates rather than repeating `${x}-secret`, so there is ONE format
119
+ * string for this concept. The templates receive the resolved name as `{{runtimeEnvSecretName}}`
120
+ * and no longer compose `{{appName}}-secret` themselves — which is what the older JSDoc on
121
+ * `k8sAppBackendSecretName` warned about, from the era when a template hardcoded a name the emit
122
+ * never produced and the pod failed closed at boot.
123
+ *
124
+ * Unlike the provider Secret, this mount is NOT `optional`: a runtime cannot boot without its
125
+ * environment, and a missing one must fail loudly rather than start a pod that cannot work.
126
+ */
127
+ export function k8sRuntimeEnvSecretName(runtimeServiceName) {
128
+ return `${runtimeServiceName}-secret`;
129
+ }
130
+ /**
131
+ * K8s Secret name carrying ONE runtime's provider credentials:
132
+ * `<runtimeServiceName>-providers-secret`.
133
+ *
134
+ * `runtimeServiceName` is the runtime's own DNS name — the app slug for the backend pod,
135
+ * {@link buildMinionServiceName} / {@link buildWorkerServiceName} for a minion or worker — so every
136
+ * application runtime gets its own Secret and no two can collide.
137
+ *
138
+ * ## Why this replaced one shared `providers-secret` (issue #369)
139
+ *
140
+ * There used to be a single cluster-wide `providers-secret` holding the application's ENTIRE
141
+ * `providerEnv`, `envFrom`-mounted by the backend, every minion AND every worker. `envFrom` merges,
142
+ * so a provider key the per-app Secret withheld arrived from that second reference: on Kubernetes a
143
+ * worker authoring `providers: {}` received every provider key the application had, in its process
144
+ * environment, which is exactly what LLM-driven minion code reads. The per-runtime confinement
145
+ * (#329) held in the compose lane and did not exist here at all — one contract, two deployment
146
+ * lanes, one swept.
147
+ *
148
+ * **The name is a function, not a format string repeated in a template, and that is the point.**
149
+ * This file already carries a scar from the other direction: `k8sAppBackendSecretName` documents a
150
+ * mount whose name the template hardcodes, and a mismatch there means a pod that cannot boot. Here
151
+ * the emit side (`k8s-secrets-generator.service.ts`) and the mount side (the three
152
+ * `*.deployment.yaml.hbs` renderers) both call THIS function, and the templates receive the
153
+ * resolved name as `{{providersSecretName}}` rather than composing it themselves.
154
+ *
155
+ * The mount stays `optional: true`: a runtime that declares no providers gets no Secret emitted,
156
+ * which is the correct outcome and must not fail pod start.
157
+ */
158
+ export function k8sRuntimeProvidersSecretName(runtimeServiceName) {
159
+ return `${runtimeServiceName}-providers-secret`;
96
160
  }
97
161
  //# sourceMappingURL=k8s-utils.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"k8s-utils.js","sourceRoot":"","sources":["../../../../../src/project-config/shared/k8s-utils.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAAe,EAAE,IAAY,EAAE,SAAiB;IAClF,OAAO,UAAU,OAAO,IAAI,SAAS,sBAAsB,IAAI,EAAE,CAAC;AACpE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAAe,EAAE,SAAiB;IACrE,OAAO,GAAG,OAAO,IAAI,SAAS,oBAAoB,CAAC;AACrD,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAe,EAAE,YAAoB;IACrE,OAAO,WAAW,OAAO,IAAI,YAAY,EAAE,CAAC;AAC9C,CAAC;AAgCD;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CAAC,MAA+B;IACpE,MAAM,EAAE,UAAU,EAAE,YAAY,EAAE,YAAY,EAAE,GAAG,MAAM,CAAC;IAC1D,6EAA6E;IAC7E,8EAA8E;IAC9E,8EAA8E;IAC9E,4EAA4E;IAC5E,+EAA+E;IAC/E,4EAA4E;IAC5E,6CAA6C;IAC7C,MAAM,IAAI,GAAG,YAAY,EAAE,CAAC,UAAU,CAAC,IAAI,UAAU,CAAC,WAAW,EAAE,CAAC;IACpE,OAAO,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,YAAY,EAAE,CAAC;AAChE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,MAA+B;IACnE,OAAO,WAAW,sBAAsB,CAAC,MAAM,CAAC,EAAE,CAAC;AACrD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAAe;IAClD,OAAO,GAAG,OAAO,SAAS,CAAC;AAC7B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,uBAAuB,CAAC,OAAe;IACrD,OAAO,GAAG,OAAO,SAAS,CAAC;AAC7B,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,UAAU,uBAAuB,CAAC,WAAmB;IACzD,OAAO,GAAG,WAAW,SAAS,CAAC;AACjC,CAAC","sourcesContent":["/**\n * Kubernetes URL builders and naming conventions.\n * Single source of truth for constructing K8s-style addresses and resource names.\n *\n * Used by CLI (ServiceAddressResolver, K8s manifest gen) and apps-manager\n * (application lifecycle) to ensure consistent URL/naming patterns.\n */\n\n/**\n * Builds a K8s cluster-internal URL: `http://<service>.<namespace>.svc.cluster.local:<port>`\n */\nexport function buildK8sInternalUrl(service: string, port: number, namespace: string): string {\n return `http://${service}.${namespace}.svc.cluster.local:${port}`;\n}\n\n/**\n * Builds a K8s cluster-internal hostname (without scheme/port).\n */\nexport function buildK8sInternalHost(service: string, namespace: string): string {\n return `${service}.${namespace}.svc.cluster.local`;\n}\n\n/**\n * Builds an ingress-based public URL: `https://<service>.<publicDomain>`\n *\n * `publicDomain` is the runtime-agnostic external hostname (browsers /\n * reverse proxy / DNS terminate here). See `WildoInfraEnvConfig.publicDomain`.\n *\n * Used for PLATFORM services (apps-manager, module-registry, …) whose\n * subdomain is always the service name. Application services (frontends +\n * backend API) resolve their public host through {@link buildServicePublicHost}\n * so the operator's authored `serviceHosts` map wins.\n */\nexport function buildK8sPublicUrl(service: string, publicDomain: string): string {\n return `https://${service}.${publicDomain}`;\n}\n\n// ============================================================================\n// Application public-host resolution (serviceHosts-driven)\n// ============================================================================\n//\n// Single source of truth for an application service's PUBLIC hostname, shared\n// by every producer so ingress routing, `runtime.endPoints[*].publicUrl`, and\n// CORS never diverge (a divergence breaks the browser's next `fetch` on CORS —\n// see `.claude/plans/self-host-domain-subdomain-model.md`).\n//\n// The self-hosted, single-app, mono-env model: each service lives at a\n// subdomain of the operator's own `publicDomain`. Greenfield — there is NO\n// multi-tenant `{service}-{appSlug}-{env}` fan-out.\n//\n// - `serviceHosts[serviceKey]` authored → `<host>.<publicDomain>`\n// (`app` → `app.example.com`), or `<publicDomain>` when the authored value\n// is the empty string (apex — `''` → `example.com`).\n// - key NOT authored → `<serviceKey>.<publicDomain>`: the service key IS its\n// own subdomain, the same convention platform services use via\n// {@link buildK8sPublicUrl}. A DEFINED fallback (never a silent error — the\n// `serviceHosts` schema requires consumers handle \"not mapped\" explicitly).\n\nexport interface ServicePublicHostParams {\n /** The application service key (`config.services.<key>` / `serviceHosts` key). */\n serviceKey: string;\n /** Authored per-service subdomain map from `wildo.infra.<env>.config.ts`. */\n serviceHosts: Record<string, string> | undefined;\n /** The operator's public domain (`WildoInfraEnvConfig.publicDomain`). */\n publicDomain: string;\n}\n\n/**\n * Resolve an application service's PUBLIC hostname (no scheme). `serviceHosts`\n * wins; the service key is its own subdomain when unauthored; `''` = apex.\n * See the section header.\n */\nexport function buildServicePublicHost(params: ServicePublicHostParams): string {\n const { serviceKey, serviceHosts, publicDomain } = params;\n // Fallback uses the service key AS the subdomain, lowercased: DNS labels are\n // case-insensitive and Let's Encrypt / `new URL()` canonicalize to lowercase,\n // so a camelCase key like `backendApi` must become `backendapi` to round-trip\n // (and to match the ingress host). Authored serviceHosts values are already\n // lowercase-validated upstream (`SERVICE_HOST_LABEL`). NOTE: a config key with\n // a DNS-invalid char (e.g. `_`) still yields an invalid host — the operator\n // must author a `serviceHosts` entry for it.\n const host = serviceHosts?.[serviceKey] ?? serviceKey.toLowerCase();\n return host === '' ? publicDomain : `${host}.${publicDomain}`;\n}\n\n/**\n * Resolve an application service's PUBLIC URL (`https://<host>`), where the\n * host comes from {@link buildServicePublicHost}.\n */\nexport function buildServicePublicUrl(params: ServicePublicHostParams): string {\n return `https://${buildServicePublicHost(params)}`;\n}\n\n/**\n * K8s Secret name for a platform service: `<service>-secret`\n */\nexport function k8sServiceSecretName(service: string): string {\n return `${service}-secret`;\n}\n\n/**\n * K8s ConfigMap name for a platform service: `<service>-config`\n */\nexport function k8sServiceConfigMapName(service: string): string {\n return `${service}-config`;\n}\n\n/**\n * K8s Secret name for an app backend: `<serviceName>-secret`\n *\n * The emitted name MUST match the `envFrom: secretRef.name` the application\n * deployment template mounts. The CLI static emit lane\n * (`k8s-secrets-generator.service.ts` § 5) calls this helper with the app's\n * backend `serviceName`.\n *\n * ⚠️ KNOWN GAP — the K8s app lane is not yet runtime-verified (no live cluster\n * run). `wildo-ai-application/deployment.yaml.hbs` hardcodes the mount name\n * `wildo-ai-application-secret` (and the image `wildo-ai-application:{{imageTag}}`),\n * i.e. the manifests assume one canonical app identity, while this helper is\n * called with the app's REAL backend `serviceName` (e.g.\n * `wonder-todos-backend-api`). The two only line up when the backend is literally\n * named `wildo-ai-application`. The mount is fail-closed (no `optional: true`),\n * so a mismatch means the pod cannot boot. Resolve by either parameterizing the\n * template's secret name or pinning the emit to the canonical app identity —\n * see `.claude/plans/self-host-domain-subdomain-model.md`.\n *\n * Application backends emit a single Secret per app (no companion ConfigMap):\n * envFrom mounts every entry as `process.env.*`, so splitting sensitive vs\n * non-sensitive added zero runtime value and fragmented the canonical sink.\n * See `k8s-secrets-generator.service.ts` § 5 for the design note.\n */\nexport function k8sAppBackendSecretName(serviceName: string): string {\n return `${serviceName}-secret`;\n}\n"]}
1
+ {"version":3,"file":"k8s-utils.js","sourceRoot":"","sources":["../../../../../src/project-config/shared/k8s-utils.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAAe,EAAE,IAAY,EAAE,SAAiB;IAClF,OAAO,UAAU,OAAO,IAAI,SAAS,sBAAsB,IAAI,EAAE,CAAC;AACpE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAAe,EAAE,SAAiB;IACrE,OAAO,GAAG,OAAO,IAAI,SAAS,oBAAoB,CAAC;AACrD,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAe,EAAE,YAAoB;IACrE,OAAO,WAAW,OAAO,IAAI,YAAY,EAAE,CAAC;AAC9C,CAAC;AAgCD;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CAAC,MAA+B;IACpE,MAAM,EAAE,UAAU,EAAE,YAAY,EAAE,YAAY,EAAE,GAAG,MAAM,CAAC;IAC1D,6EAA6E;IAC7E,8EAA8E;IAC9E,8EAA8E;IAC9E,4EAA4E;IAC5E,+EAA+E;IAC/E,4EAA4E;IAC5E,6CAA6C;IAC7C,MAAM,IAAI,GAAG,YAAY,EAAE,CAAC,UAAU,CAAC,IAAI,UAAU,CAAC,WAAW,EAAE,CAAC;IACpE,OAAO,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,YAAY,EAAE,CAAC;AAChE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,MAA+B;IACnE,OAAO,WAAW,sBAAsB,CAAC,MAAM,CAAC,EAAE,CAAC;AACrD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAAe;IAClD,OAAO,GAAG,OAAO,SAAS,CAAC;AAC7B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,uBAAuB,CAAC,OAAe;IACrD,OAAO,GAAG,OAAO,SAAS,CAAC;AAC7B,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,uBAAuB,CAAC,WAAmB;IACzD,OAAO,uBAAuB,CAAC,WAAW,CAAC,CAAC;AAC9C,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,MAAM,UAAU,uBAAuB,CAAC,kBAA0B;IAChE,OAAO,GAAG,kBAAkB,SAAS,CAAC;AACxC,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,UAAU,6BAA6B,CAAC,kBAA0B;IACtE,OAAO,GAAG,kBAAkB,mBAAmB,CAAC;AAClD,CAAC","sourcesContent":["/**\n * Kubernetes URL builders and naming conventions.\n * Single source of truth for constructing K8s-style addresses and resource names.\n *\n * Used by CLI (ServiceAddressResolver, K8s manifest gen) and apps-manager\n * (application lifecycle) to ensure consistent URL/naming patterns.\n */\n\n/**\n * Builds a K8s cluster-internal URL: `http://<service>.<namespace>.svc.cluster.local:<port>`\n */\nexport function buildK8sInternalUrl(service: string, port: number, namespace: string): string {\n return `http://${service}.${namespace}.svc.cluster.local:${port}`;\n}\n\n/**\n * Builds a K8s cluster-internal hostname (without scheme/port).\n */\nexport function buildK8sInternalHost(service: string, namespace: string): string {\n return `${service}.${namespace}.svc.cluster.local`;\n}\n\n/**\n * Builds an ingress-based public URL: `https://<service>.<publicDomain>`\n *\n * `publicDomain` is the runtime-agnostic external hostname (browsers /\n * reverse proxy / DNS terminate here). See `WildoInfraEnvConfig.publicDomain`.\n *\n * Used for PLATFORM services (apps-manager, module-registry, …) whose\n * subdomain is always the service name. Application services (frontends +\n * backend API) resolve their public host through {@link buildServicePublicHost}\n * so the operator's authored `serviceHosts` map wins.\n */\nexport function buildK8sPublicUrl(service: string, publicDomain: string): string {\n return `https://${service}.${publicDomain}`;\n}\n\n// ============================================================================\n// Application public-host resolution (serviceHosts-driven)\n// ============================================================================\n//\n// Single source of truth for an application service's PUBLIC hostname, shared\n// by every producer so ingress routing, `runtime.endPoints[*].publicUrl`, and\n// CORS never diverge (a divergence breaks the browser's next `fetch` on CORS —\n// see `.claude/plans/self-host-domain-subdomain-model.md`).\n//\n// The self-hosted, single-app, mono-env model: each service lives at a\n// subdomain of the operator's own `publicDomain`. Greenfield — there is NO\n// multi-tenant `{service}-{appSlug}-{env}` fan-out.\n//\n// - `serviceHosts[serviceKey]` authored → `<host>.<publicDomain>`\n// (`app` → `app.example.com`), or `<publicDomain>` when the authored value\n// is the empty string (apex — `''` → `example.com`).\n// - key NOT authored → `<serviceKey>.<publicDomain>`: the service key IS its\n// own subdomain, the same convention platform services use via\n// {@link buildK8sPublicUrl}. A DEFINED fallback (never a silent error — the\n// `serviceHosts` schema requires consumers handle \"not mapped\" explicitly).\n\nexport interface ServicePublicHostParams {\n /** The application service key (`config.services.<key>` / `serviceHosts` key). */\n serviceKey: string;\n /** Authored per-service subdomain map from `wildo.infra.<env>.config.ts`. */\n serviceHosts: Record<string, string> | undefined;\n /** The operator's public domain (`WildoInfraEnvConfig.publicDomain`). */\n publicDomain: string;\n}\n\n/**\n * Resolve an application service's PUBLIC hostname (no scheme). `serviceHosts`\n * wins; the service key is its own subdomain when unauthored; `''` = apex.\n * See the section header.\n */\nexport function buildServicePublicHost(params: ServicePublicHostParams): string {\n const { serviceKey, serviceHosts, publicDomain } = params;\n // Fallback uses the service key AS the subdomain, lowercased: DNS labels are\n // case-insensitive and Let's Encrypt / `new URL()` canonicalize to lowercase,\n // so a camelCase key like `backendApi` must become `backendapi` to round-trip\n // (and to match the ingress host). Authored serviceHosts values are already\n // lowercase-validated upstream (`SERVICE_HOST_LABEL`). NOTE: a config key with\n // a DNS-invalid char (e.g. `_`) still yields an invalid host — the operator\n // must author a `serviceHosts` entry for it.\n const host = serviceHosts?.[serviceKey] ?? serviceKey.toLowerCase();\n return host === '' ? publicDomain : `${host}.${publicDomain}`;\n}\n\n/**\n * Resolve an application service's PUBLIC URL (`https://<host>`), where the\n * host comes from {@link buildServicePublicHost}.\n */\nexport function buildServicePublicUrl(params: ServicePublicHostParams): string {\n return `https://${buildServicePublicHost(params)}`;\n}\n\n/**\n * K8s Secret name for a platform service: `<service>-secret`\n */\nexport function k8sServiceSecretName(service: string): string {\n return `${service}-secret`;\n}\n\n/**\n * K8s ConfigMap name for a platform service: `<service>-config`\n */\nexport function k8sServiceConfigMapName(service: string): string {\n return `${service}-config`;\n}\n\n/**\n * K8s Secret name for an app backend: `<serviceName>-secret`\n *\n * The emitted name MUST match the `envFrom: secretRef.name` the application\n * deployment template mounts. The CLI static emit lane\n * (`k8s-secrets-generator.service.ts` § 5) calls this helper with the app's\n * backend `serviceName`.\n *\n * The name-mismatch gap this JSDoc used to warn about is CLOSED (#377): the templates no longer\n * spell a Secret name at all — each receives the resolved `{{runtimeEnvSecretName}}` from\n * {@link k8sRuntimeEnvSecretName}, which is the same function the emit side calls. The mount stays\n * fail-closed (no `optional: true`), so were the two ever to diverge again the pod would refuse to\n * boot rather than start without its environment.\n *\n * ⚠️ Still true: the K8s app lane has never had a live cluster run. What is verified is that emit\n * and mount agree, pinned from both sides.\n *\n * Application backends emit a single Secret per app (no companion ConfigMap):\n * envFrom mounts every entry as `process.env.*`, so splitting sensitive vs\n * non-sensitive added zero runtime value and fragmented the canonical sink.\n * See `k8s-secrets-generator.service.ts` § 5 for the design note.\n */\nexport function k8sAppBackendSecretName(serviceName: string): string {\n return k8sRuntimeEnvSecretName(serviceName);\n}\n\n/**\n * K8s Secret name carrying ONE runtime's ENVIRONMENT: `<runtimeServiceName>-secret`.\n *\n * The companion of {@link k8sRuntimeProvidersSecretName} — that one carries a runtime's provider\n * CREDENTIALS, this one everything else it boots with. Same keying: the app slug for the backend\n * pod, {@link buildMinionServiceName} / {@link buildWorkerServiceName} for a minion or worker.\n *\n * ## Why minions and workers stopped sharing the backend's (issue #377)\n *\n * Every minion and worker pod used to `envFrom`-mount the BACKEND's `{appSlug}-secret`, so each\n * received the backend's whole environment: the platform bootstrap contract, MongoDB / PostgreSQL /\n * Redis / RabbitMQ topology, storage configuration — and, once #360 composed it, the backend's\n * `OTEL_EXPORTER_OTLP_HEADERS`, which carries the telemetry provider's token. So the per-runtime\n * confinement that #329, #360 and #369 established was defeated one level up: a minion scoped to\n * `openai` alone got no telemetry token in its own provider Secret and received it anyway, from a\n * different runtime's environment.\n *\n * `buildApplicationMinionEnv` and `buildApplicationWorkerEnv` already existed, already took a\n * `RuntimeProviderScope`, and already produced the correctly-scoped environment for the compose\n * lane. The Kubernetes lane simply never called them.\n *\n * ## Every mount name is now resolved here, including the backend's\n *\n * `k8sAppBackendSecretName` delegates rather than repeating `${x}-secret`, so there is ONE format\n * string for this concept. The templates receive the resolved name as `{{runtimeEnvSecretName}}`\n * and no longer compose `{{appName}}-secret` themselves — which is what the older JSDoc on\n * `k8sAppBackendSecretName` warned about, from the era when a template hardcoded a name the emit\n * never produced and the pod failed closed at boot.\n *\n * Unlike the provider Secret, this mount is NOT `optional`: a runtime cannot boot without its\n * environment, and a missing one must fail loudly rather than start a pod that cannot work.\n */\nexport function k8sRuntimeEnvSecretName(runtimeServiceName: string): string {\n return `${runtimeServiceName}-secret`;\n}\n\n/**\n * K8s Secret name carrying ONE runtime's provider credentials:\n * `<runtimeServiceName>-providers-secret`.\n *\n * `runtimeServiceName` is the runtime's own DNS name — the app slug for the backend pod,\n * {@link buildMinionServiceName} / {@link buildWorkerServiceName} for a minion or worker — so every\n * application runtime gets its own Secret and no two can collide.\n *\n * ## Why this replaced one shared `providers-secret` (issue #369)\n *\n * There used to be a single cluster-wide `providers-secret` holding the application's ENTIRE\n * `providerEnv`, `envFrom`-mounted by the backend, every minion AND every worker. `envFrom` merges,\n * so a provider key the per-app Secret withheld arrived from that second reference: on Kubernetes a\n * worker authoring `providers: {}` received every provider key the application had, in its process\n * environment, which is exactly what LLM-driven minion code reads. The per-runtime confinement\n * (#329) held in the compose lane and did not exist here at all — one contract, two deployment\n * lanes, one swept.\n *\n * **The name is a function, not a format string repeated in a template, and that is the point.**\n * This file already carries a scar from the other direction: `k8sAppBackendSecretName` documents a\n * mount whose name the template hardcodes, and a mismatch there means a pod that cannot boot. Here\n * the emit side (`k8s-secrets-generator.service.ts`) and the mount side (the three\n * `*.deployment.yaml.hbs` renderers) both call THIS function, and the templates receive the\n * resolved name as `{{providersSecretName}}` rather than composing it themselves.\n *\n * The mount stays `optional: true`: a runtime that declares no providers gets no Secret emitted,\n * which is the correct outcome and must not fail pod start.\n */\nexport function k8sRuntimeProvidersSecretName(runtimeServiceName: string): string {\n return `${runtimeServiceName}-providers-secret`;\n}\n"]}
@@ -3,22 +3,22 @@
3
3
  *
4
4
  * ## Why it lives under `project-config` and not beside its derivation
5
5
  *
6
- * An authored `wildo.saas.config.ts` does NOT see the package root barrel. The
7
- * config loader resolves `@wildo-ai/platform-config-lib` to
8
- * `src/config-authoring.entry.ts`, which exports `./project-config` and
9
- * `./workspace-scope` and nothing else — so a symbol under `bootstrap/` is
10
- * invisible to the very file that has to name it.
6
+ * The split is by AUDIENCE: the vocabulary an app author writes lives with the
7
+ * other authoring vocabularies; {@link buildOwnCronRecordFilter} and the
8
+ * declaration type stay in `bootstrap/`, because a runtime derivation is not
9
+ * something an authored config should be reaching for.
11
10
  *
12
- * This was measured, not guessed. With the enum in `bootstrap/`, an app config
13
- * importing it alongside `AppFrontendType` — same package, same import statement
14
- * — got `AppFrontendType` fine and `undefined` for this one, and
15
- * `wildo config sync` failed with `Cannot read properties of undefined (reading
16
- * 'OWN_CRON_RECORDS')`. Nothing in that message points at an entrypoint.
17
- *
18
- * So the split is by AUDIENCE: the vocabulary an app author writes lives where
19
- * app authors can reach it; {@link buildOwnCronRecordFilter} and the declaration
20
- * type stay in `bootstrap/`, because a runtime derivation is not something an
21
- * authored config should be able to call.
11
+ * It first moved here for a worse reason, kept as history because the defect
12
+ * shape recurred. Until 2026-09-09 the config loader resolved
13
+ * `@wildo-ai/platform-config-lib` to a `config-authoring.entry.ts` that exported
14
+ * `./project-config` and `./workspace-scope` and nothing else, so an app config
15
+ * importing this enum from `bootstrap/` beside `AppFrontendType` — same package,
16
+ * same statement — got `AppFrontendType` and `undefined` for this one, and
17
+ * `wildo config sync` died on `reading 'OWN_CRON_RECORDS'`. Moving the enum cured
18
+ * that name; the next symbol the engine composed at module load from the same
19
+ * package hit the same wall. The entry now re-exports the whole root (see its
20
+ * header), so placement under `project-config` is a statement about who authors
21
+ * the value, no longer about what the loader can see.
22
22
  */
23
23
  export declare enum MinionPlatformAccessScope {
24
24
  /**
@@ -3,22 +3,22 @@
3
3
  *
4
4
  * ## Why it lives under `project-config` and not beside its derivation
5
5
  *
6
- * An authored `wildo.saas.config.ts` does NOT see the package root barrel. The
7
- * config loader resolves `@wildo-ai/platform-config-lib` to
8
- * `src/config-authoring.entry.ts`, which exports `./project-config` and
9
- * `./workspace-scope` and nothing else — so a symbol under `bootstrap/` is
10
- * invisible to the very file that has to name it.
6
+ * The split is by AUDIENCE: the vocabulary an app author writes lives with the
7
+ * other authoring vocabularies; {@link buildOwnCronRecordFilter} and the
8
+ * declaration type stay in `bootstrap/`, because a runtime derivation is not
9
+ * something an authored config should be reaching for.
11
10
  *
12
- * This was measured, not guessed. With the enum in `bootstrap/`, an app config
13
- * importing it alongside `AppFrontendType` — same package, same import statement
14
- * — got `AppFrontendType` fine and `undefined` for this one, and
15
- * `wildo config sync` failed with `Cannot read properties of undefined (reading
16
- * 'OWN_CRON_RECORDS')`. Nothing in that message points at an entrypoint.
17
- *
18
- * So the split is by AUDIENCE: the vocabulary an app author writes lives where
19
- * app authors can reach it; {@link buildOwnCronRecordFilter} and the declaration
20
- * type stay in `bootstrap/`, because a runtime derivation is not something an
21
- * authored config should be able to call.
11
+ * It first moved here for a worse reason, kept as history because the defect
12
+ * shape recurred. Until 2026-09-09 the config loader resolved
13
+ * `@wildo-ai/platform-config-lib` to a `config-authoring.entry.ts` that exported
14
+ * `./project-config` and `./workspace-scope` and nothing else, so an app config
15
+ * importing this enum from `bootstrap/` beside `AppFrontendType` — same package,
16
+ * same statement — got `AppFrontendType` and `undefined` for this one, and
17
+ * `wildo config sync` died on `reading 'OWN_CRON_RECORDS'`. Moving the enum cured
18
+ * that name; the next symbol the engine composed at module load from the same
19
+ * package hit the same wall. The entry now re-exports the whole root (see its
20
+ * header), so placement under `project-config` is a statement about who authors
21
+ * the value, no longer about what the loader can see.
22
22
  */
23
23
  export var MinionPlatformAccessScope;
24
24
  (function (MinionPlatformAccessScope) {
@@ -1 +1 @@
1
- {"version":3,"file":"minion-platform-access.vocabulary.js","sourceRoot":"","sources":["../../../../../src/project-config/shared/minion-platform-access.vocabulary.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,MAAM,CAAN,IAAY,yBAOX;AAPD,WAAY,yBAAyB;IACnC;;;;OAIG;IACH,kEAAqC,CAAA;AACvC,CAAC,EAPW,yBAAyB,KAAzB,yBAAyB,QAOpC","sourcesContent":["/**\n * The PLATFORM-ACCESS vocabulary a minion declaration is authored with (R4 / R5).\n *\n * ## Why it lives under `project-config` and not beside its derivation\n *\n * An authored `wildo.saas.config.ts` does NOT see the package root barrel. The\n * config loader resolves `@wildo-ai/platform-config-lib` to\n * `src/config-authoring.entry.ts`, which exports `./project-config` and\n * `./workspace-scope` and nothing else — so a symbol under `bootstrap/` is\n * invisible to the very file that has to name it.\n *\n * This was measured, not guessed. With the enum in `bootstrap/`, an app config\n * importing it alongside `AppFrontendType` — same package, same import statement\n * — got `AppFrontendType` fine and `undefined` for this one, and\n * `wildo config sync` failed with `Cannot read properties of undefined (reading\n * 'OWN_CRON_RECORDS')`. Nothing in that message points at an entrypoint.\n *\n * So the split is by AUDIENCE: the vocabulary an app author writes lives where\n * app authors can reach it; {@link buildOwnCronRecordFilter} and the declaration\n * type stay in `bootstrap/`, because a runtime derivation is not something an\n * authored config should be able to call.\n */\n\nexport enum MinionPlatformAccessScope {\n /**\n * The minion's OWN cron/schedule records. There is deliberately no\n * `ALL_CRON_RECORDS` member: a scope that could name another minion is a scope\n * somebody will eventually grant.\n */\n OWN_CRON_RECORDS = 'own_cron_records',\n}\n"]}
1
+ {"version":3,"file":"minion-platform-access.vocabulary.js","sourceRoot":"","sources":["../../../../../src/project-config/shared/minion-platform-access.vocabulary.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,MAAM,CAAN,IAAY,yBAOX;AAPD,WAAY,yBAAyB;IACnC;;;;OAIG;IACH,kEAAqC,CAAA;AACvC,CAAC,EAPW,yBAAyB,KAAzB,yBAAyB,QAOpC","sourcesContent":["/**\n * The PLATFORM-ACCESS vocabulary a minion declaration is authored with (R4 / R5).\n *\n * ## Why it lives under `project-config` and not beside its derivation\n *\n * The split is by AUDIENCE: the vocabulary an app author writes lives with the\n * other authoring vocabularies; {@link buildOwnCronRecordFilter} and the\n * declaration type stay in `bootstrap/`, because a runtime derivation is not\n * something an authored config should be reaching for.\n *\n * It first moved here for a worse reason, kept as history because the defect\n * shape recurred. Until 2026-09-09 the config loader resolved\n * `@wildo-ai/platform-config-lib` to a `config-authoring.entry.ts` that exported\n * `./project-config` and `./workspace-scope` and nothing else, so an app config\n * importing this enum from `bootstrap/` beside `AppFrontendType` — same package,\n * same statement — got `AppFrontendType` and `undefined` for this one, and\n * `wildo config sync` died on `reading 'OWN_CRON_RECORDS'`. Moving the enum cured\n * that name; the next symbol the engine composed at module load from the same\n * package hit the same wall. The entry now re-exports the whole root (see its\n * header), so placement under `project-config` is a statement about who authors\n * the value, no longer about what the loader can see.\n */\n\nexport enum MinionPlatformAccessScope {\n /**\n * The minion's OWN cron/schedule records. There is deliberately no\n * `ALL_CRON_RECORDS` member: a scope that could name another minion is a scope\n * somebody will eventually grant.\n */\n OWN_CRON_RECORDS = 'own_cron_records',\n}\n"]}
@@ -1,3 +1,4 @@
1
+ import { PlatformApplicationType } from '@wildo-ai/platform-core-shared';
1
2
  /**
2
3
  * Platform microservices. All use the same Docker image (wildo-platform)
3
4
  * differentiated at runtime via PLATFORM_SERVICE env var.
@@ -18,6 +19,35 @@ export declare enum PlatformWildoServices {
18
19
  }
19
20
  export declare const BOOTSTRAP_PLATFORM_SERVICES: readonly [PlatformWildoServices.CRONTABS_BATCHES_MANAGER, PlatformWildoServices.MODULE_REGISTRY];
20
21
  export type BootstrapPlatformService = (typeof BOOTSTRAP_PLATFORM_SERVICES)[number];
22
+ /**
23
+ * The platform-application TYPES the platform provisions credentials for — the same three the
24
+ * apps-manager provisioner iterates. Named here so the runtime-slug ledger below can be REQUIRED per
25
+ * member: a fourth provisioned service that is not mapped fails to compile before it provisions a
26
+ * grant nobody can use.
27
+ */
28
+ export type ProvisionedPlatformApplicationType = PlatformApplicationType.PLATFORM_APPS_MANAGER | PlatformApplicationType.PLATFORM_CRONTABS_BATCHES_MANAGER | PlatformApplicationType.PLATFORM_MODULE_REGISTRY;
29
+ /**
30
+ * ONE service, TWO spellings — and this is the join between them.
31
+ *
32
+ * `PlatformApplicationType` (`platform_crontabs_batches_manager`, underscores) is the platform-
33
+ * application RECORD type: the row in `platformApplications`, the Redis ACL USERNAME, the RabbitMQ
34
+ * user. `PlatformWildoServices` (`platform-crontabs-batches-manager`, hyphens) is the RUNTIME SLUG:
35
+ * the Docker/K8s service name and, since 2026-09-09, the `appSlug` each service process boots with.
36
+ *
37
+ * Why the join matters: every Redis key a platform process writes is rooted at its runtime slug —
38
+ * the engine's `RedisService` roots at `${appSlug}:`, the platform's `PlatformRedisService` at the
39
+ * same slug through this ledger — and the ACL grant minted for the service must therefore be
40
+ * `~<runtime slug>:*`. Two writers rooted at the USERNAME instead (the provisioner's grant, then the
41
+ * platform Redis service's prefix) each produced `NOPERM` on the service's first key, one after the
42
+ * other, once the other side was corrected. Both sides now read this one table.
43
+ */
44
+ export declare const PLATFORM_SERVICE_RUNTIME_SLUG: Record<ProvisionedPlatformApplicationType, PlatformWildoServices>;
45
+ /**
46
+ * The runtime slug for a platform-application type name, or `undefined` when the name is not a
47
+ * provisioned platform service — a caller then reports or refuses rather than rooting a key
48
+ * namespace, or a grant, on a guess.
49
+ */
50
+ export declare function resolvePlatformServiceRuntimeSlug(serviceName: string | undefined): PlatformWildoServices | undefined;
21
51
  export declare enum AppsManagerMode {
22
52
  NORMAL = "normal",
23
53
  INIT = "init"
@@ -1 +1 @@
1
- {"version":3,"file":"platform-services.schemas.d.ts","sourceRoot":"","sources":["../../../../../src/project-config/shared/platform-services.schemas.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,oBAAY,qBAAqB;IAC/B,aAAa,kBAAkB;IAC/B,YAAY,0BAA0B;IACtC,wBAAwB,sCAAsC;IAC9D;;;;OAIG;IACH,eAAe,6BAA6B;CAC7C;AA4BD,eAAO,MAAM,2BAA2B,kGAGyB,CAAC;AAElE,MAAM,MAAM,wBAAwB,GAAG,CAAC,OAAO,2BAA2B,CAAC,CAAC,MAAM,CAAC,CAAC;AAepF,oBAAY,eAAe;IACzB,MAAM,WAAW;IACjB,IAAI,SAAS;CACd"}
1
+ {"version":3,"file":"platform-services.schemas.d.ts","sourceRoot":"","sources":["../../../../../src/project-config/shared/platform-services.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AAEzE;;;;;;GAMG;AACH,oBAAY,qBAAqB;IAC/B,aAAa,kBAAkB;IAC/B,YAAY,0BAA0B;IACtC,wBAAwB,sCAAsC;IAC9D;;;;OAIG;IACH,eAAe,6BAA6B;CAC7C;AA4BD,eAAO,MAAM,2BAA2B,kGAGyB,CAAC;AAElE,MAAM,MAAM,wBAAwB,GAAG,CAAC,OAAO,2BAA2B,CAAC,CAAC,MAAM,CAAC,CAAC;AAEpF;;;;;GAKG;AACH,MAAM,MAAM,kCAAkC,GAC1C,uBAAuB,CAAC,qBAAqB,GAC7C,uBAAuB,CAAC,iCAAiC,GACzD,uBAAuB,CAAC,wBAAwB,CAAC;AAErD;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,6BAA6B,EAAE,MAAM,CAAC,kCAAkC,EAAE,qBAAqB,CAI3G,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,iCAAiC,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,GAAG,qBAAqB,GAAG,SAAS,CAGpH;AAeD,oBAAY,eAAe;IACzB,MAAM,WAAW;IACjB,IAAI,SAAS;CACd"}
@@ -1,3 +1,4 @@
1
+ import { PlatformApplicationType } from '@wildo-ai/platform-core-shared';
1
2
  /**
2
3
  * Platform microservices. All use the same Docker image (wildo-platform)
3
4
  * differentiated at runtime via PLATFORM_SERVICE env var.
@@ -21,6 +22,36 @@ export const BOOTSTRAP_PLATFORM_SERVICES = [
21
22
  PlatformWildoServices.CRONTABS_BATCHES_MANAGER,
22
23
  PlatformWildoServices.MODULE_REGISTRY,
23
24
  ];
25
+ /**
26
+ * ONE service, TWO spellings — and this is the join between them.
27
+ *
28
+ * `PlatformApplicationType` (`platform_crontabs_batches_manager`, underscores) is the platform-
29
+ * application RECORD type: the row in `platformApplications`, the Redis ACL USERNAME, the RabbitMQ
30
+ * user. `PlatformWildoServices` (`platform-crontabs-batches-manager`, hyphens) is the RUNTIME SLUG:
31
+ * the Docker/K8s service name and, since 2026-09-09, the `appSlug` each service process boots with.
32
+ *
33
+ * Why the join matters: every Redis key a platform process writes is rooted at its runtime slug —
34
+ * the engine's `RedisService` roots at `${appSlug}:`, the platform's `PlatformRedisService` at the
35
+ * same slug through this ledger — and the ACL grant minted for the service must therefore be
36
+ * `~<runtime slug>:*`. Two writers rooted at the USERNAME instead (the provisioner's grant, then the
37
+ * platform Redis service's prefix) each produced `NOPERM` on the service's first key, one after the
38
+ * other, once the other side was corrected. Both sides now read this one table.
39
+ */
40
+ export const PLATFORM_SERVICE_RUNTIME_SLUG = {
41
+ [PlatformApplicationType.PLATFORM_APPS_MANAGER]: PlatformWildoServices.APPS_MANAGER,
42
+ [PlatformApplicationType.PLATFORM_CRONTABS_BATCHES_MANAGER]: PlatformWildoServices.CRONTABS_BATCHES_MANAGER,
43
+ [PlatformApplicationType.PLATFORM_MODULE_REGISTRY]: PlatformWildoServices.MODULE_REGISTRY,
44
+ };
45
+ /**
46
+ * The runtime slug for a platform-application type name, or `undefined` when the name is not a
47
+ * provisioned platform service — a caller then reports or refuses rather than rooting a key
48
+ * namespace, or a grant, on a guess.
49
+ */
50
+ export function resolvePlatformServiceRuntimeSlug(serviceName) {
51
+ if (serviceName === undefined)
52
+ return undefined;
53
+ return PLATFORM_SERVICE_RUNTIME_SLUG[serviceName];
54
+ }
24
55
  const _assertExhaustiveBootstrapCoverage = true;
25
56
  void _assertExhaustiveBootstrapCoverage;
26
57
  export var AppsManagerMode;
@@ -1 +1 @@
1
- {"version":3,"file":"platform-services.schemas.js","sourceRoot":"","sources":["../../../../../src/project-config/shared/platform-services.schemas.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,CAAN,IAAY,qBAUX;AAVD,WAAY,qBAAqB;IAC/B,wDAA+B,CAAA;IAC/B,+DAAsC,CAAA;IACtC,uFAA8D,CAAA;IAC9D;;;;OAIG;IACH,qEAA4C,CAAA;AAC9C,CAAC,EAVW,qBAAqB,KAArB,qBAAqB,QAUhC;AA4BD,MAAM,CAAC,MAAM,2BAA2B,GAAG;IACzC,qBAAqB,CAAC,wBAAwB;IAC9C,qBAAqB,CAAC,eAAe;CAC0B,CAAC;AAclE,MAAM,kCAAkC,GAAuC,IAAI,CAAC;AACpF,KAAK,kCAAkC,CAAC;AAExC,MAAM,CAAN,IAAY,eAGX;AAHD,WAAY,eAAe;IACzB,oCAAiB,CAAA;IACjB,gCAAa,CAAA;AACf,CAAC,EAHW,eAAe,KAAf,eAAe,QAG1B","sourcesContent":["/**\n * Platform microservices. All use the same Docker image (wildo-platform)\n * differentiated at runtime via PLATFORM_SERVICE env var.\n *\n * For app developers: deployed as Docker containers.\n * For framework developers: run natively from source (hot-reload).\n */\nexport enum PlatformWildoServices {\n PLATFORM_INIT = 'platform-init',\n APPS_MANAGER = 'platform-apps-manager',\n CRONTABS_BATCHES_MANAGER = 'platform-crontabs-batches-manager',\n /**\n * Module-registry server (`platform-module-registry`, KD-7).\n * Hosts the central `wildo registry *` HTTP surface; pinned port\n * `PLATFORM_DEFAULT_PORTS.MODULE_REGISTRY` (5154).\n */\n MODULE_REGISTRY = 'platform-module-registry',\n}\n\n/**\n * Bootstrap platform services — long-running platform microservices that boot\n * from the same env contract via `PlatformEnvVarsBuilder.buildBootstrapEnv`.\n *\n * Excludes:\n * - `PLATFORM_INIT` — one-shot initialization job, not a long-running service.\n * - `APPS_MANAGER` — has its own dedicated full-env builder\n * (`PlatformEnvVarsBuilder.buildAppsManagerFullEnv`) with extra wiring\n * (Atlas creds, GitHub provisioning keys, etc.).\n *\n * Single source of truth for everything that iterates \"all bootstrap services\":\n * K8s Secret/ConfigMap emit (`k8s-secrets-generator.service.ts`), Compose\n * runtime catalog, and tests asserting cross-service env contracts.\n *\n * The `satisfies` clause below forces this list to cover every member of\n * `PlatformWildoServices` other than the two explicitly excluded ones —\n * adding a new enum member without listing it here is a compile error.\n * Without that coupling, the previous `Exclude<…>`-based local type alias\n * silently widened to include any future enum member, which masked the\n * \"service in enum but not yet handled by the bootstrap path\" drift class.\n */\ntype BootstrapPlatformServiceCandidate = Exclude<\n PlatformWildoServices,\n PlatformWildoServices.PLATFORM_INIT | PlatformWildoServices.APPS_MANAGER\n>;\n\nexport const BOOTSTRAP_PLATFORM_SERVICES = [\n PlatformWildoServices.CRONTABS_BATCHES_MANAGER,\n PlatformWildoServices.MODULE_REGISTRY,\n] as const satisfies readonly BootstrapPlatformServiceCandidate[];\n\nexport type BootstrapPlatformService = (typeof BOOTSTRAP_PLATFORM_SERVICES)[number];\n\n/**\n * Compile-time assertion: every non-excluded `PlatformWildoServices` member\n * MUST appear in `BOOTSTRAP_PLATFORM_SERVICES`. Adding a new member to the\n * enum without listing it above triggers a `Type 'X' is not assignable to\n * type 'never'` error pointing here, so the exhaustiveness check the\n * `addServiceExtras` switch used to provide for `Exclude<…>`-derived types\n * is preserved.\n */\ntype _AssertExhaustiveBootstrapCoverage =\n Exclude<BootstrapPlatformServiceCandidate, BootstrapPlatformService> extends never ? true : never;\nconst _assertExhaustiveBootstrapCoverage: _AssertExhaustiveBootstrapCoverage = true;\nvoid _assertExhaustiveBootstrapCoverage;\n\nexport enum AppsManagerMode {\n NORMAL = 'normal',\n INIT = 'init',\n}\n\n"]}
1
+ {"version":3,"file":"platform-services.schemas.js","sourceRoot":"","sources":["../../../../../src/project-config/shared/platform-services.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AAEzE;;;;;;GAMG;AACH,MAAM,CAAN,IAAY,qBAUX;AAVD,WAAY,qBAAqB;IAC/B,wDAA+B,CAAA;IAC/B,+DAAsC,CAAA;IACtC,uFAA8D,CAAA;IAC9D;;;;OAIG;IACH,qEAA4C,CAAA;AAC9C,CAAC,EAVW,qBAAqB,KAArB,qBAAqB,QAUhC;AA4BD,MAAM,CAAC,MAAM,2BAA2B,GAAG;IACzC,qBAAqB,CAAC,wBAAwB;IAC9C,qBAAqB,CAAC,eAAe;CAC0B,CAAC;AAelE;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAsE;IAC9G,CAAC,uBAAuB,CAAC,qBAAqB,CAAC,EAAE,qBAAqB,CAAC,YAAY;IACnF,CAAC,uBAAuB,CAAC,iCAAiC,CAAC,EAAE,qBAAqB,CAAC,wBAAwB;IAC3G,CAAC,uBAAuB,CAAC,wBAAwB,CAAC,EAAE,qBAAqB,CAAC,eAAe;CAC1F,CAAC;AAEF;;;;GAIG;AACH,MAAM,UAAU,iCAAiC,CAAC,WAA+B;IAC/E,IAAI,WAAW,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAChD,OAAQ,6BAAmF,CAAC,WAAW,CAAC,CAAC;AAC3G,CAAC;AAYD,MAAM,kCAAkC,GAAuC,IAAI,CAAC;AACpF,KAAK,kCAAkC,CAAC;AAExC,MAAM,CAAN,IAAY,eAGX;AAHD,WAAY,eAAe;IACzB,oCAAiB,CAAA;IACjB,gCAAa,CAAA;AACf,CAAC,EAHW,eAAe,KAAf,eAAe,QAG1B","sourcesContent":["import { PlatformApplicationType } from '@wildo-ai/platform-core-shared';\n\n/**\n * Platform microservices. All use the same Docker image (wildo-platform)\n * differentiated at runtime via PLATFORM_SERVICE env var.\n *\n * For app developers: deployed as Docker containers.\n * For framework developers: run natively from source (hot-reload).\n */\nexport enum PlatformWildoServices {\n PLATFORM_INIT = 'platform-init',\n APPS_MANAGER = 'platform-apps-manager',\n CRONTABS_BATCHES_MANAGER = 'platform-crontabs-batches-manager',\n /**\n * Module-registry server (`platform-module-registry`, KD-7).\n * Hosts the central `wildo registry *` HTTP surface; pinned port\n * `PLATFORM_DEFAULT_PORTS.MODULE_REGISTRY` (5154).\n */\n MODULE_REGISTRY = 'platform-module-registry',\n}\n\n/**\n * Bootstrap platform services — long-running platform microservices that boot\n * from the same env contract via `PlatformEnvVarsBuilder.buildBootstrapEnv`.\n *\n * Excludes:\n * - `PLATFORM_INIT` — one-shot initialization job, not a long-running service.\n * - `APPS_MANAGER` — has its own dedicated full-env builder\n * (`PlatformEnvVarsBuilder.buildAppsManagerFullEnv`) with extra wiring\n * (Atlas creds, GitHub provisioning keys, etc.).\n *\n * Single source of truth for everything that iterates \"all bootstrap services\":\n * K8s Secret/ConfigMap emit (`k8s-secrets-generator.service.ts`), Compose\n * runtime catalog, and tests asserting cross-service env contracts.\n *\n * The `satisfies` clause below forces this list to cover every member of\n * `PlatformWildoServices` other than the two explicitly excluded ones —\n * adding a new enum member without listing it here is a compile error.\n * Without that coupling, the previous `Exclude<…>`-based local type alias\n * silently widened to include any future enum member, which masked the\n * \"service in enum but not yet handled by the bootstrap path\" drift class.\n */\ntype BootstrapPlatformServiceCandidate = Exclude<\n PlatformWildoServices,\n PlatformWildoServices.PLATFORM_INIT | PlatformWildoServices.APPS_MANAGER\n>;\n\nexport const BOOTSTRAP_PLATFORM_SERVICES = [\n PlatformWildoServices.CRONTABS_BATCHES_MANAGER,\n PlatformWildoServices.MODULE_REGISTRY,\n] as const satisfies readonly BootstrapPlatformServiceCandidate[];\n\nexport type BootstrapPlatformService = (typeof BOOTSTRAP_PLATFORM_SERVICES)[number];\n\n/**\n * The platform-application TYPES the platform provisions credentials for — the same three the\n * apps-manager provisioner iterates. Named here so the runtime-slug ledger below can be REQUIRED per\n * member: a fourth provisioned service that is not mapped fails to compile before it provisions a\n * grant nobody can use.\n */\nexport type ProvisionedPlatformApplicationType =\n | PlatformApplicationType.PLATFORM_APPS_MANAGER\n | PlatformApplicationType.PLATFORM_CRONTABS_BATCHES_MANAGER\n | PlatformApplicationType.PLATFORM_MODULE_REGISTRY;\n\n/**\n * ONE service, TWO spellings — and this is the join between them.\n *\n * `PlatformApplicationType` (`platform_crontabs_batches_manager`, underscores) is the platform-\n * application RECORD type: the row in `platformApplications`, the Redis ACL USERNAME, the RabbitMQ\n * user. `PlatformWildoServices` (`platform-crontabs-batches-manager`, hyphens) is the RUNTIME SLUG:\n * the Docker/K8s service name and, since 2026-09-09, the `appSlug` each service process boots with.\n *\n * Why the join matters: every Redis key a platform process writes is rooted at its runtime slug —\n * the engine's `RedisService` roots at `${appSlug}:`, the platform's `PlatformRedisService` at the\n * same slug through this ledger — and the ACL grant minted for the service must therefore be\n * `~<runtime slug>:*`. Two writers rooted at the USERNAME instead (the provisioner's grant, then the\n * platform Redis service's prefix) each produced `NOPERM` on the service's first key, one after the\n * other, once the other side was corrected. Both sides now read this one table.\n */\nexport const PLATFORM_SERVICE_RUNTIME_SLUG: Record<ProvisionedPlatformApplicationType, PlatformWildoServices> = {\n [PlatformApplicationType.PLATFORM_APPS_MANAGER]: PlatformWildoServices.APPS_MANAGER,\n [PlatformApplicationType.PLATFORM_CRONTABS_BATCHES_MANAGER]: PlatformWildoServices.CRONTABS_BATCHES_MANAGER,\n [PlatformApplicationType.PLATFORM_MODULE_REGISTRY]: PlatformWildoServices.MODULE_REGISTRY,\n};\n\n/**\n * The runtime slug for a platform-application type name, or `undefined` when the name is not a\n * provisioned platform service — a caller then reports or refuses rather than rooting a key\n * namespace, or a grant, on a guess.\n */\nexport function resolvePlatformServiceRuntimeSlug(serviceName: string | undefined): PlatformWildoServices | undefined {\n if (serviceName === undefined) return undefined;\n return (PLATFORM_SERVICE_RUNTIME_SLUG as Record<string, PlatformWildoServices | undefined>)[serviceName];\n}\n\n/**\n * Compile-time assertion: every non-excluded `PlatformWildoServices` member\n * MUST appear in `BOOTSTRAP_PLATFORM_SERVICES`. Adding a new member to the\n * enum without listing it above triggers a `Type 'X' is not assignable to\n * type 'never'` error pointing here, so the exhaustiveness check the\n * `addServiceExtras` switch used to provide for `Exclude<…>`-derived types\n * is preserved.\n */\ntype _AssertExhaustiveBootstrapCoverage =\n Exclude<BootstrapPlatformServiceCandidate, BootstrapPlatformService> extends never ? true : never;\nconst _assertExhaustiveBootstrapCoverage: _AssertExhaustiveBootstrapCoverage = true;\nvoid _assertExhaustiveBootstrapCoverage;\n\nexport enum AppsManagerMode {\n NORMAL = 'normal',\n INIT = 'init',\n}\n\n"]}
@@ -2,27 +2,32 @@ export declare const FRAMEWORK_RELEASE_NPM_SCOPE = "@wildo-ai";
2
2
  /**
3
3
  * Container registry that hosts the published framework images.
4
4
  *
5
- * Declared EXPLICITLY rather than left to Docker's default resolution. A bare
6
- * `<namespace>/<image>` reference silently means Docker Hub, which is how this
7
- * framework's registry came to be chosen by default rather than by decision.
8
- * Naming the host makes the choice reviewable and makes a future move a config
9
- * change instead of an archaeology exercise.
5
+ * Declared EXPLICITLY rather than left to Docker's default resolution: a bare
6
+ * `<namespace>/<image>` reference silently means Docker Hub, and naming the host
7
+ * makes the choice reviewable and a future move a config change instead of an
8
+ * archaeology exercise. Every consumer-side reference (the compose template's
9
+ * `platformImageRef`) is built from these two constants, and the publish lane
10
+ * refuses any framework config that names a different pair.
10
11
  *
11
- * GHCR is used because publication authenticates with the workflow's own
12
- * run-scoped `GITHUB_TOKEN` (`packages: write`) — no long-lived registry
13
- * credential has to exist — and because public GHCR pulls are not subject to
14
- * Docker Hub's anonymous pull-rate limits, which would otherwise throttle
15
- * consumer CI pulling the base images.
12
+ * ## History, because it moved twice
13
+ *
14
+ * Docker Hub (`wildoai`) was the original home; the images `wildoai/wildo-platform:0.2.0`
15
+ * and `:1.0.1` were pushed there in April 2026. On 2026-08-26 the lane was moved to GHCR
16
+ * (`ghcr.io/wildo-ai`) for two reasons: publication could authenticate with a workflow's
17
+ * own run-scoped `GITHUB_TOKEN`, and public GHCR pulls carry no anonymous pull-rate limit.
18
+ * Neither reason was ever exercised — no publish CI exists, and the lane runs from a
19
+ * developer machine — while the only container credential the framework holds is the
20
+ * Docker Hub one. The first real GHCR publish (2026-09-04) was refused for exactly that.
21
+ * Paul decided on 2026-09-05 to go BACK to Docker Hub rather than mint a second credential.
22
+ *
23
+ * If the lane ever moves to CI, the GHCR argument returns; move both constants and the
24
+ * framework config together, and the publish-lane pin and the compose pins will say so.
16
25
  */
17
- export declare const FRAMEWORK_RELEASE_DOCKER_REGISTRY_HOST = "ghcr.io";
26
+ export declare const FRAMEWORK_RELEASE_DOCKER_REGISTRY_HOST = "docker.io";
18
27
  /**
19
- * Owner namespace under {@link FRAMEWORK_RELEASE_DOCKER_REGISTRY_HOST}.
20
- *
21
- * On GHCR this MUST equal the GitHub organization that owns the repository
22
- * (`wildo-ai`), because GHCR derives package ownership and permissions from it.
23
- * The former Docker Hub namespace was `wildoai` (no hyphen); it is deliberately
24
- * not reused, and that Docker Hub namespace should be retained but left
25
- * unpublished so the name cannot be squatted.
28
+ * Owner namespace under {@link FRAMEWORK_RELEASE_DOCKER_REGISTRY_HOST} — the Docker Hub
29
+ * organization (`wildoai`, no hyphen: Docker Hub namespaces cannot carry one, which is why
30
+ * it differs from the GitHub organization `wildo-ai` and the npm scope `@wildo-ai`).
26
31
  */
27
- export declare const FRAMEWORK_RELEASE_DOCKER_NAMESPACE = "wildo-ai";
32
+ export declare const FRAMEWORK_RELEASE_DOCKER_NAMESPACE = "wildoai";
28
33
  //# sourceMappingURL=framework-release.constants.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"framework-release.constants.d.ts","sourceRoot":"","sources":["../../../../src/release/framework-release.constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,2BAA2B,cAAc,CAAC;AAEvD;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,sCAAsC,YAAY,CAAC;AAEhE;;;;;;;;GAQG;AACH,eAAO,MAAM,kCAAkC,aAAa,CAAC"}
1
+ {"version":3,"file":"framework-release.constants.d.ts","sourceRoot":"","sources":["../../../../src/release/framework-release.constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,2BAA2B,cAAc,CAAC;AAEvD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,sCAAsC,cAAc,CAAC;AAElE;;;;GAIG;AACH,eAAO,MAAM,kCAAkC,YAAY,CAAC"}
@@ -2,27 +2,32 @@ export const FRAMEWORK_RELEASE_NPM_SCOPE = '@wildo-ai';
2
2
  /**
3
3
  * Container registry that hosts the published framework images.
4
4
  *
5
- * Declared EXPLICITLY rather than left to Docker's default resolution. A bare
6
- * `<namespace>/<image>` reference silently means Docker Hub, which is how this
7
- * framework's registry came to be chosen by default rather than by decision.
8
- * Naming the host makes the choice reviewable and makes a future move a config
9
- * change instead of an archaeology exercise.
5
+ * Declared EXPLICITLY rather than left to Docker's default resolution: a bare
6
+ * `<namespace>/<image>` reference silently means Docker Hub, and naming the host
7
+ * makes the choice reviewable and a future move a config change instead of an
8
+ * archaeology exercise. Every consumer-side reference (the compose template's
9
+ * `platformImageRef`) is built from these two constants, and the publish lane
10
+ * refuses any framework config that names a different pair.
10
11
  *
11
- * GHCR is used because publication authenticates with the workflow's own
12
- * run-scoped `GITHUB_TOKEN` (`packages: write`) — no long-lived registry
13
- * credential has to exist — and because public GHCR pulls are not subject to
14
- * Docker Hub's anonymous pull-rate limits, which would otherwise throttle
15
- * consumer CI pulling the base images.
12
+ * ## History, because it moved twice
13
+ *
14
+ * Docker Hub (`wildoai`) was the original home; the images `wildoai/wildo-platform:0.2.0`
15
+ * and `:1.0.1` were pushed there in April 2026. On 2026-08-26 the lane was moved to GHCR
16
+ * (`ghcr.io/wildo-ai`) for two reasons: publication could authenticate with a workflow's
17
+ * own run-scoped `GITHUB_TOKEN`, and public GHCR pulls carry no anonymous pull-rate limit.
18
+ * Neither reason was ever exercised — no publish CI exists, and the lane runs from a
19
+ * developer machine — while the only container credential the framework holds is the
20
+ * Docker Hub one. The first real GHCR publish (2026-09-04) was refused for exactly that.
21
+ * Paul decided on 2026-09-05 to go BACK to Docker Hub rather than mint a second credential.
22
+ *
23
+ * If the lane ever moves to CI, the GHCR argument returns; move both constants and the
24
+ * framework config together, and the publish-lane pin and the compose pins will say so.
16
25
  */
17
- export const FRAMEWORK_RELEASE_DOCKER_REGISTRY_HOST = 'ghcr.io';
26
+ export const FRAMEWORK_RELEASE_DOCKER_REGISTRY_HOST = 'docker.io';
18
27
  /**
19
- * Owner namespace under {@link FRAMEWORK_RELEASE_DOCKER_REGISTRY_HOST}.
20
- *
21
- * On GHCR this MUST equal the GitHub organization that owns the repository
22
- * (`wildo-ai`), because GHCR derives package ownership and permissions from it.
23
- * The former Docker Hub namespace was `wildoai` (no hyphen); it is deliberately
24
- * not reused, and that Docker Hub namespace should be retained but left
25
- * unpublished so the name cannot be squatted.
28
+ * Owner namespace under {@link FRAMEWORK_RELEASE_DOCKER_REGISTRY_HOST} — the Docker Hub
29
+ * organization (`wildoai`, no hyphen: Docker Hub namespaces cannot carry one, which is why
30
+ * it differs from the GitHub organization `wildo-ai` and the npm scope `@wildo-ai`).
26
31
  */
27
- export const FRAMEWORK_RELEASE_DOCKER_NAMESPACE = 'wildo-ai';
32
+ export const FRAMEWORK_RELEASE_DOCKER_NAMESPACE = 'wildoai';
28
33
  //# sourceMappingURL=framework-release.constants.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"framework-release.constants.js","sourceRoot":"","sources":["../../../../src/release/framework-release.constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,2BAA2B,GAAG,WAAW,CAAC;AAEvD;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,sCAAsC,GAAG,SAAS,CAAC;AAEhE;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,kCAAkC,GAAG,UAAU,CAAC","sourcesContent":["export const FRAMEWORK_RELEASE_NPM_SCOPE = '@wildo-ai';\n\n/**\n * Container registry that hosts the published framework images.\n *\n * Declared EXPLICITLY rather than left to Docker's default resolution. A bare\n * `<namespace>/<image>` reference silently means Docker Hub, which is how this\n * framework's registry came to be chosen by default rather than by decision.\n * Naming the host makes the choice reviewable and makes a future move a config\n * change instead of an archaeology exercise.\n *\n * GHCR is used because publication authenticates with the workflow's own\n * run-scoped `GITHUB_TOKEN` (`packages: write`) — no long-lived registry\n * credential has to exist — and because public GHCR pulls are not subject to\n * Docker Hub's anonymous pull-rate limits, which would otherwise throttle\n * consumer CI pulling the base images.\n */\nexport const FRAMEWORK_RELEASE_DOCKER_REGISTRY_HOST = 'ghcr.io';\n\n/**\n * Owner namespace under {@link FRAMEWORK_RELEASE_DOCKER_REGISTRY_HOST}.\n *\n * On GHCR this MUST equal the GitHub organization that owns the repository\n * (`wildo-ai`), because GHCR derives package ownership and permissions from it.\n * The former Docker Hub namespace was `wildoai` (no hyphen); it is deliberately\n * not reused, and that Docker Hub namespace should be retained but left\n * unpublished so the name cannot be squatted.\n */\nexport const FRAMEWORK_RELEASE_DOCKER_NAMESPACE = 'wildo-ai';\n"]}
1
+ {"version":3,"file":"framework-release.constants.js","sourceRoot":"","sources":["../../../../src/release/framework-release.constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,2BAA2B,GAAG,WAAW,CAAC;AAEvD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,CAAC,MAAM,sCAAsC,GAAG,WAAW,CAAC;AAElE;;;;GAIG;AACH,MAAM,CAAC,MAAM,kCAAkC,GAAG,SAAS,CAAC","sourcesContent":["export const FRAMEWORK_RELEASE_NPM_SCOPE = '@wildo-ai';\n\n/**\n * Container registry that hosts the published framework images.\n *\n * Declared EXPLICITLY rather than left to Docker's default resolution: a bare\n * `<namespace>/<image>` reference silently means Docker Hub, and naming the host\n * makes the choice reviewable and a future move a config change instead of an\n * archaeology exercise. Every consumer-side reference (the compose template's\n * `platformImageRef`) is built from these two constants, and the publish lane\n * refuses any framework config that names a different pair.\n *\n * ## History, because it moved twice\n *\n * Docker Hub (`wildoai`) was the original home; the images `wildoai/wildo-platform:0.2.0`\n * and `:1.0.1` were pushed there in April 2026. On 2026-08-26 the lane was moved to GHCR\n * (`ghcr.io/wildo-ai`) for two reasons: publication could authenticate with a workflow's\n * own run-scoped `GITHUB_TOKEN`, and public GHCR pulls carry no anonymous pull-rate limit.\n * Neither reason was ever exercised — no publish CI exists, and the lane runs from a\n * developer machine — while the only container credential the framework holds is the\n * Docker Hub one. The first real GHCR publish (2026-09-04) was refused for exactly that.\n * Paul decided on 2026-09-05 to go BACK to Docker Hub rather than mint a second credential.\n *\n * If the lane ever moves to CI, the GHCR argument returns; move both constants and the\n * framework config together, and the publish-lane pin and the compose pins will say so.\n */\nexport const FRAMEWORK_RELEASE_DOCKER_REGISTRY_HOST = 'docker.io';\n\n/**\n * Owner namespace under {@link FRAMEWORK_RELEASE_DOCKER_REGISTRY_HOST} — the Docker Hub\n * organization (`wildoai`, no hyphen: Docker Hub namespaces cannot carry one, which is why\n * it differs from the GitHub organization `wildo-ai` and the npm scope `@wildo-ai`).\n */\nexport const FRAMEWORK_RELEASE_DOCKER_NAMESPACE = 'wildoai';\n"]}
@@ -22,6 +22,20 @@ export interface FrameworkLayoutPaths {
22
22
  pnpmLockfilePath: string;
23
23
  engineHome: string;
24
24
  platformHome: string;
25
+ /**
26
+ * The THIRD workspace home (plan D9): one package per provider, several facet barrels each,
27
+ * deliberately OUTSIDE `engine/` so that "out of the core engine" is a directory rather than a
28
+ * convention. Named for the HOME, never for a package in it — which provider inhabits it first is
29
+ * a decision of the slice that generates providers, not of the layout.
30
+ *
31
+ * It is a field here because this interface is what makes a home VISIBLE to tooling: publish
32
+ * discovery, framework-knowledge generation and the anchor audit all take their scan roots from
33
+ * `engineHome` + `platformHome`, and a home absent from that pair is not excluded — it is
34
+ * unseen. An unseen home reports clean, which is the shape
35
+ * `negative-results-require-a-positive-probe.md` exists for: a `@wildo_source` anchor in a
36
+ * provider package would never reach a skill, and nothing would say so.
37
+ */
38
+ providersHome: string;
25
39
  examplesHome: string;
26
40
  markerHome: string;
27
41
  declarationConfigPath: string;
@@ -1 +1 @@
1
- {"version":3,"file":"workspace-homes.schemas.d.ts","sourceRoot":"","sources":["../../../../src/workspace-scope/workspace-homes.schemas.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACtE,OAAO,EAML,cAAc,EACf,MAAM,2BAA2B,CAAC;AAEnC,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,eAAe,EAAE,MAAM,CAAC;IACxB,4EAA4E;IAC5E,cAAc,EAAE,MAAM,CAAC;IACvB;;;;;;OAMG;IACH,qCAAqC,EAAE,MAAM,CAAC;IAC9C,oEAAoE;IACpE,qBAAqB,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,oBAAoB;IACnC,cAAc,EAAE,MAAM,CAAC;IACvB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,gBAAgB,EAAE,MAAM,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,aAAa,EAAE,MAAM,CAAC;IACtB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,0BAA0B,EAAE,MAAM,CAAC;IACnC,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;IACzB,yBAAyB,EAAE,MAAM,CAAC;IAClC,0BAA0B,EAAE,MAAM,CAAC;IACnC,yBAAyB,EAAE,MAAM,CAAC;IAClC,yBAAyB,EAAE,MAAM,CAAC;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,6BAA6B,EAAE,MAAM,CAAC;IACtC,4BAA4B,EAAE,MAAM,CAAC;IACrC;;;;;;OAMG;IACH,oCAAoC,EAAE,MAAM,CAAC;IAC7C;;;;;;;;;OASG;IACH,uCAAuC,EAAE,MAAM,CAAC;IAChD;;;;;;;OAOG;IACH,mCAAmC,EAAE,MAAM,CAAC;IAC5C,4BAA4B,EAAE,MAAM,CAAC;IACrC,gCAAgC,EAAE,MAAM,CAAC;IACzC,4BAA4B,EAAE,MAAM,CAAC;IACrC,gCAAgC,EAAE,MAAM,CAAC;IACzC,2EAA2E;IAC3E,+BAA+B,EAAE,MAAM,CAAC;IACxC,mEAAmE;IACnE,2BAA2B,EAAE,MAAM,CAAC;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,uBAAuB,EAAE,MAAM,CAAC;IAChC,yBAAyB,EAAE,MAAM,CAAC;CACnC;AAED,MAAM,WAAW,cAAc;IAC7B,eAAe,EAAE,MAAM,CAAC;IACxB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,0BAA0B,EAAE,MAAM,CAAC;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,uEAAuE;IACvE,cAAc,EAAE,MAAM,CAAC;IACvB,8BAA8B,EAAE,MAAM,CAAC;IACvC,yCAAyC,EAAE,MAAM,CAAC;IAClD,QAAQ,EAAE,MAAM,CAAC;IACjB,2DAA2D;IAC3D,iCAAiC,EAAE,MAAM,CAAC;IAC1C,uCAAuC,EAAE,MAAM,CAAC;IAChD,SAAS,EAAE,MAAM,CAAC;IAClB,wEAAwE;IACxE,aAAa,EAAE,MAAM,CAAC;IACtB,6BAA6B,EAAE,MAAM,CAAC;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,yBAAyB,EAAE,MAAM,CAAC;IAClC,uBAAuB,EAAE,MAAM,CAAC;IAChC;;;;OAIG;IACH,mBAAmB,EAAE,MAAM,CAAC;IAC5B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,sBAAsB,EAAE,MAAM,CAAC;IAC/B,yBAAyB,EAAE,MAAM,CAAC;CACnC;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,kBAAkB,CAAC;IAC3B,kBAAkB,EAAE,OAAO,CAAC;CAC7B;AAED,MAAM,WAAW,sBAAsB;IACrC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,qBAAqB,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,MAAM,EAAE,oBAAoB,GAAG,IAAI,CAAC;IACpC;;;;;;;;;;OAUG;IACH,sBAAsB,EAAE,OAAO,CAAC;CACjC;AAED,MAAM,WAAW,gBAAgB;IAC/B,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,MAAM,EAAE,cAAc,GAAG,IAAI,CAAC;IAC9B,gBAAgB,EAAE,OAAO,CAAC;CAC3B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,MAAM,WAAW,wBAAwB;IACvC,qBAAqB,EAAE,OAAO,CAAC;IAC/B,qBAAqB,EAAE,OAAO,CAAC;IAC/B,eAAe,EAAE,OAAO,CAAC;IACzB,iCAAiC,EAAE,OAAO,CAAC;IAC3C,qBAAqB,EAAE,OAAO,CAAC;IAC/B,oBAAoB,EAAE,OAAO,CAAC;CAC/B;AAED,MAAM,WAAW,aAAa;IAC5B,cAAc,EAAE,oBAAoB,CAAC;IACrC,KAAK,EAAE,cAAc,CAAC;IACtB,OAAO,EAAE,oBAAoB,CAAC;IAC9B,SAAS,EAAE,sBAAsB,CAAC;IAClC,GAAG,EAAE,gBAAgB,CAAC;IACtB,YAAY,EAAE,wBAAwB,CAAC;CACxC;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,GAAE,MAAkB,GAAG,kBAAkB,CAarF;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,aAAa,EAAE,MAAM,GAAG,oBAAoB,CAoElF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,CA2DhE"}
1
+ {"version":3,"file":"workspace-homes.schemas.d.ts","sourceRoot":"","sources":["../../../../src/workspace-scope/workspace-homes.schemas.ts"],"names":[],"mappings":"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"}
@@ -22,6 +22,7 @@ export function resolveFrameworkLayout(frameworkRoot) {
22
22
  const markerHome = join(frameworkRoot, WORKSPACE_HOME_NAMES.FRAMEWORK_HOME);
23
23
  const engineHome = join(frameworkRoot, 'engine');
24
24
  const platformHome = join(frameworkRoot, 'platform');
25
+ const providersHome = join(frameworkRoot, 'providers');
25
26
  const examplesHome = join(frameworkRoot, 'examples');
26
27
  const templatesHome = join(frameworkRoot, 'templates');
27
28
  const infraTemplatesHome = join(templatesHome, 'infra');
@@ -39,6 +40,7 @@ export function resolveFrameworkLayout(frameworkRoot) {
39
40
  pnpmLockfilePath: join(frameworkRoot, 'pnpm-lock.yaml'),
40
41
  engineHome,
41
42
  platformHome,
43
+ providersHome,
42
44
  examplesHome,
43
45
  markerHome,
44
46
  declarationConfigPath: join(markerHome, AUTHORED_CONFIG_FILE_NAMES.FRAMEWORK),