Skip to content

Evenfire is an intelligence layer platform for running LLM agents that take real actions, on your infrastructure

TypeScript

feat(minikube): enable GFS upload v2 T2 profile

Alfredo Lopez664ad370e847
diff --git a/.github/workflows/ci-public.yml b/.github/workflows/ci-public.yml
index 5843ac1ad..1d25dd19c 100644
--- a/.github/workflows/ci-public.yml
+++ b/.github/workflows/ci-public.yml
@@ -391,6 +391,9 @@ jobs:
- name: Test minikube Makefile targets
run: bash scripts/tests/test-minikube-makefile.sh
+ - name: Test minikube GFS Upload v2 profile contract
+ run: bash scripts/tests/test-minikube-gfs-upload-v2-profile.sh
+
# The NetworkPolicy probe runs on an E2E-only fixture that the default
# (pulled) setup never acquires. This proves the target says so up front
# instead of timing out on ErrImageNeverPull, and that it still builds
diff --git a/deploy/overlays/minikube/kustomization.yaml b/deploy/overlays/minikube/kustomization.yaml
index d6c431aad..c20b09cb9 100644
--- a/deploy/overlays/minikube/kustomization.yaml
+++ b/deploy/overlays/minikube/kustomization.yaml
@@ -81,6 +81,9 @@ images:
patchesStrategicMerge:
- patches/resource-limits.yaml
- patches/dynamic-images.yaml
+ # Minikube is the owned T2/dev activation environment for GFS Upload v2.
+ # Public base and production-safe defaults remain disabled.
+ - patches/gfs-upload-v2.yaml
- patches/image-pull-policy.yaml
- patches/service-tokens.yaml
- patches/nginx-workflow-approval-gateway.yaml
diff --git a/deploy/overlays/minikube/patches/gfs-upload-v2.yaml b/deploy/overlays/minikube/patches/gfs-upload-v2.yaml
new file mode 100644
index 000000000..580bafe74
--- /dev/null
+++ b/deploy/overlays/minikube/patches/gfs-upload-v2.yaml
@@ -0,0 +1,55 @@
+# Local/T2 activation for the upload-v2 release contract. The public base and
+# production overlays remain disabled until their separately authorized
+# rollout. HCC owns generated GFSC configuration; never patch gfsc Deployments
+# directly or add these operator settings to GlobalFileSystem.spec.
+apiVersion: apps/v1
+kind: Deployment
+metadata:
+ name: host-context-controller
+ namespace: control-plane
+spec:
+ template:
+ spec:
+ containers:
+ - name: host-context-controller
+ env:
+ - name: CONTEXT_MAPPER_GFSC_UPLOAD_V2_ENABLED
+ value: 'true'
+ - name: CONTEXT_MAPPER_GFSC_UPLOAD_PROTOCOL_MAX_FILE_BYTES
+ value: '1073741824'
+ - name: CONTEXT_MAPPER_GFSC_UPLOAD_PRODUCT_MAX_FILE_BYTES
+ value: '209715200'
+ - name: CONTEXT_MAPPER_GFSC_UPLOAD_MAX_FILE_BYTES
+ value: '209715200'
+ - name: CONTEXT_MAPPER_GFSC_UPLOAD_PREFERRED_CHUNK_BYTES
+ value: '8388608'
+ - name: CONTEXT_MAPPER_GFSC_UPLOAD_MAX_CHUNK_BYTES
+ value: '16777216'
+ - name: CONTEXT_MAPPER_GFSC_UPLOAD_MIN_PART_BYTES
+ value: '1048576'
+ - name: CONTEXT_MAPPER_GFSC_UPLOAD_MAX_PART_COUNT
+ value: '1024'
+ - name: CONTEXT_MAPPER_GFSC_UPLOAD_SESSION_TTL_MS
+ value: '86400000'
+ - name: CONTEXT_MAPPER_GFSC_UPLOAD_COMPLETED_RECEIPT_TTL_MS
+ value: '86400000'
+ - name: CONTEXT_MAPPER_GFSC_UPLOAD_STALE_PART_LEASE_MS
+ value: '600000'
+ - name: CONTEXT_MAPPER_GFSC_UPLOAD_MAX_ACTIVE_PER_SUBJECT
+ value: '2'
+ - name: CONTEXT_MAPPER_GFSC_UPLOAD_MAX_ACTIVE_GLOBAL
+ value: '8'
+ - name: CONTEXT_MAPPER_GFSC_UPLOAD_MAX_CONCURRENT_PARTS_PER_SESSION
+ value: '4'
+ - name: CONTEXT_MAPPER_GFSC_UPLOAD_MAX_CONCURRENT_PART_STREAMS_GLOBAL
+ value: '16'
+ - name: CONTEXT_MAPPER_GFSC_UPLOAD_INSTABILITY_FAILURE_THRESHOLD
+ value: '3'
+ - name: CONTEXT_MAPPER_GFSC_UPLOAD_MAX_CONCURRENT_FINALIZATIONS
+ value: '1'
+ - name: CONTEXT_MAPPER_GFSC_UPLOAD_MIN_FREE_BYTES
+ value: '10737418240'
+ - name: CONTEXT_MAPPER_GFSC_UPLOAD_PART_TIMEOUT_MS
+ value: '300000'
+ - name: CONTEXT_MAPPER_GFSC_UPLOAD_FINALIZE_TIMEOUT_MS
+ value: '600000'
diff --git a/docs/deploy/gfs-permission-store.md b/docs/deploy/gfs-permission-store.md
index 8594d0dfa..82ae51761 100644
--- a/docs/deploy/gfs-permission-store.md
+++ b/docs/deploy/gfs-permission-store.md
@@ -91,6 +91,12 @@ the canonical `sync-auth-key.sh --require-gfs` path. It must copy the non-empty
`gfs-config.jwt-public-key` before GFS credentials are restored or either GFSC
deployment is scaled up. Missing source or target resources abort recovery and
retain the fail-closed replica state; no reset path patches the key ad hoc.
+The Minikube T2 profile separately enables Upload v2 through the committed HCC
+patch `deploy/overlays/minikube/patches/gfs-upload-v2.yaml`. The
+`GlobalFileSystem` instance remains declarative storage/layout input; HCC env is
+the sole owner of feature activation and the exact 200 MiB/part/concurrency
+contract passed into generated GFSC workloads. Public-base and production
+activation remain disabled and separate from this local profile contract.
Any later convergence failure reasserts the Control API fence together with the
other database-dependent controllers and waits for the Control API Pods to
terminate before returning.
@@ -164,14 +170,14 @@ grants flips the pod NotReady within roughly a minute, visibly in
`/readyz` reasons you may see:
-| Reason | Meaning |
-| --- | --- |
-| `storage volume not mounted …` | Drive PVC missing/unmounted (not a credential issue) |
-| `permission store unreachable: password authentication failed …` | DSN/password drift — re-run provisioning |
-| `permission store unreachable: … coherence check failed … gfs_resources … 0048` | Role exists but the SELECT grants/migration are missing — run control-api migrations, then provisioning |
-| `permission store unreachable: … coherence check failed … gfs_audit …` | Audit INSERT grant missing — every request would 503 (audit-write failures propagate); run migrations + provisioning |
-| `permission store unreachable: … timed out after Nms` | Black-hole partition (unreachable, not refusing) — the probe hard-bounds connect/query (default 5s) instead of dangling |
-| `permission store unreachable: connect ECONNREFUSED …` | PostgreSQL down/unreachable |
+| Reason | Meaning |
+| ------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
+| `storage volume not mounted …` | Drive PVC missing/unmounted (not a credential issue) |
+| `permission store unreachable: password authentication failed …` | DSN/password drift — re-run provisioning |
+| `permission store unreachable: … coherence check failed … gfs_resources … 0048` | Role exists but the SELECT grants/migration are missing — run control-api migrations, then provisioning |
+| `permission store unreachable: … coherence check failed … gfs_audit …` | Audit INSERT grant missing — every request would 503 (audit-write failures propagate); run migrations + provisioning |
+| `permission store unreachable: … timed out after Nms` | Black-hole partition (unreachable, not refusing) — the probe hard-bounds connect/query (default 5s) instead of dangling |
+| `permission store unreachable: connect ECONNREFUSED …` | PostgreSQL down/unreachable |
## Verification
diff --git a/docs/deploy/minikube.md b/docs/deploy/minikube.md
index 9d4ae971b..345a2aee5 100644
--- a/docs/deploy/minikube.md
+++ b/docs/deploy/minikube.md
@@ -285,6 +285,28 @@ Desktop App
| **Issuer** | All RPC tokens have `iss: "control-api"`. mcp-host must have `CLERUM_AUTH_JWT_ISSUER=control-api` |
| **Edge headers** | `rpc-proxy/src/services/controlApiRestService.ts` returns `headers: {}` on purpose; `mcpProxyService.ts` then adds `x-clerum-edge-caller: rpc-proxy`, `x-clerum-edge-host-ref`, `x-clerum-edge-user-id`. Adding an `Authorization` header here would make every mcp-host call fail 401. |
+### GFS Upload v2 local/T2 profile
+
+The committed Minikube overlay enables GFS Upload v2 through
+`patches/gfs-upload-v2.yaml`. It patches the host-context-controller, which is
+the owner of generated GFSC workload configuration, with the exact release
+contract: 200 MiB files, preferred 8 MiB / maximum 16 MiB parts, four parts per
+session, sixteen global part streams, and the documented TTL, admission, and
+free-space limits. `minikube-ghcr`, `minikube-no-uis`, and
+`minikube-no-uis-ghcr` inherit the same patch from the base Minikube overlay.
+
+The `GlobalFileSystem` resource intentionally does not carry
+`uploadV2Enabled`. Feature activation and product limits are operator-owned HCC
+configuration; editing an HCC-generated `gfsc-writer` Deployment would be
+overwritten by reconciliation. The public deployment base remains disabled,
+and this local activation does not authorize enabling a production overlay.
+
+Validate the committed profile without touching a cluster:
+
+```bash
+bash scripts/tests/test-minikube-gfs-upload-v2-profile.sh
+```
+
### Required Configuration Per Service
#### rpc-proxy-secrets (Secret, namespace: rpc-proxy)
diff --git a/host-context-controller/src/gfsConfig.test.ts b/host-context-controller/src/gfsConfig.test.ts
index 62ea23510..941322ec6 100644
--- a/host-context-controller/src/gfsConfig.test.ts
+++ b/host-context-controller/src/gfsConfig.test.ts
@@ -51,14 +51,52 @@ describe('gfsDefaultFactoryConfig', () => {
expect(c.maxWriteBodyBytes).toBe('25165824')
})
- it('maps the private-infra upload prefix to writer-owned gfsc settings', () => {
- process.env.CONTEXT_MAPPER_GFSC_UPLOAD_V2_ENABLED = 'true'
- process.env.CONTEXT_MAPPER_GFSC_UPLOAD_PRODUCT_MAX_FILE_BYTES = '209715200'
- process.env.CONTEXT_MAPPER_GFSC_UPLOAD_PREFERRED_CHUNK_BYTES = '8388608'
+ it('maps the exact private-infra upload profile to writer-owned gfsc settings', () => {
+ Object.assign(process.env, {
+ CONTEXT_MAPPER_GFSC_UPLOAD_V2_ENABLED: 'true',
+ CONTEXT_MAPPER_GFSC_UPLOAD_PROTOCOL_MAX_FILE_BYTES: '1073741824',
+ CONTEXT_MAPPER_GFSC_UPLOAD_PRODUCT_MAX_FILE_BYTES: '209715200',
+ CONTEXT_MAPPER_GFSC_UPLOAD_MAX_FILE_BYTES: '209715200',
+ CONTEXT_MAPPER_GFSC_UPLOAD_PREFERRED_CHUNK_BYTES: '8388608',
+ CONTEXT_MAPPER_GFSC_UPLOAD_MAX_CHUNK_BYTES: '16777216',
+ CONTEXT_MAPPER_GFSC_UPLOAD_MIN_PART_BYTES: '1048576',
+ CONTEXT_MAPPER_GFSC_UPLOAD_MAX_PART_COUNT: '1024',
+ CONTEXT_MAPPER_GFSC_UPLOAD_SESSION_TTL_MS: '86400000',
+ CONTEXT_MAPPER_GFSC_UPLOAD_COMPLETED_RECEIPT_TTL_MS: '86400000',
+ CONTEXT_MAPPER_GFSC_UPLOAD_STALE_PART_LEASE_MS: '600000',
+ CONTEXT_MAPPER_GFSC_UPLOAD_MAX_ACTIVE_PER_SUBJECT: '2',
+ CONTEXT_MAPPER_GFSC_UPLOAD_MAX_ACTIVE_GLOBAL: '8',
+ CONTEXT_MAPPER_GFSC_UPLOAD_MAX_CONCURRENT_PARTS_PER_SESSION: '4',
+ CONTEXT_MAPPER_GFSC_UPLOAD_MAX_CONCURRENT_PART_STREAMS_GLOBAL: '16',
+ CONTEXT_MAPPER_GFSC_UPLOAD_INSTABILITY_FAILURE_THRESHOLD: '3',
+ CONTEXT_MAPPER_GFSC_UPLOAD_MAX_CONCURRENT_FINALIZATIONS: '1',
+ CONTEXT_MAPPER_GFSC_UPLOAD_MIN_FREE_BYTES: '10737418240',
+ CONTEXT_MAPPER_GFSC_UPLOAD_PART_TIMEOUT_MS: '300000',
+ CONTEXT_MAPPER_GFSC_UPLOAD_FINALIZE_TIMEOUT_MS: '600000',
+ })
const c = gfsDefaultFactoryConfig()
- expect(c.uploadV2Enabled).toBe('true')
- expect(c.uploadProductMaxFileBytes).toBe('209715200')
- expect(c.uploadPreferredChunkBytes).toBe('8388608')
+ expect(c).toMatchObject({
+ uploadV2Enabled: 'true',
+ uploadProtocolMaxFileBytes: '1073741824',
+ uploadProductMaxFileBytes: '209715200',
+ uploadMaxFileBytes: '209715200',
+ uploadPreferredChunkBytes: '8388608',
+ uploadMaxChunkBytes: '16777216',
+ uploadMinPartBytes: '1048576',
+ uploadMaxPartCount: '1024',
+ uploadSessionTtlMs: '86400000',
+ uploadCompletedReceiptTtlMs: '86400000',
+ uploadStalePartLeaseMs: '600000',
+ uploadMaxActivePerSubject: '2',
+ uploadMaxActiveGlobal: '8',
+ uploadMaxConcurrentPartsPerSession: '4',
+ uploadMaxConcurrentPartStreamsGlobal: '16',
+ uploadInstabilityFailureThreshold: '3',
+ uploadMaxConcurrentFinalizations: '1',
+ uploadMinFreeBytes: '10737418240',
+ uploadPartTimeoutMs: '300000',
+ uploadFinalizeTimeoutMs: '600000',
+ })
})
it('fails loud on an invalid image pull policy (no silent default)', () => {
diff --git a/host-context-controller/src/k8s/gfsFactory.test.ts b/host-context-controller/src/k8s/gfsFactory.test.ts
index 8068a7675..e6def1af2 100644
--- a/host-context-controller/src/k8s/gfsFactory.test.ts
+++ b/host-context-controller/src/k8s/gfsFactory.test.ts
@@ -154,7 +154,7 @@ describe('gfsFactory writer Deployment', () => {
expect(byName('GFS_UPLOAD_V2_ENABLED')).toBeUndefined()
})
- it('passes configured synchronous copy limits verbatim to writer and reader', () => {
+ it('passes configured copy and exact upload-v2 limits to generated workloads', () => {
const configured = {
...config,
syncCopyMaxObjects: '2500',
@@ -162,10 +162,47 @@ describe('gfsFactory writer Deployment', () => {
syncCopyTimeoutMs: '45000',
maxWriteBodyBytes: '25165824',
uploadV2Enabled: 'true',
+ uploadProtocolMaxFileBytes: '1073741824',
uploadProductMaxFileBytes: '209715200',
+ uploadMaxFileBytes: '209715200',
uploadPreferredChunkBytes: '8388608',
uploadMaxChunkBytes: '16777216',
+ uploadMinPartBytes: '1048576',
+ uploadMaxPartCount: '1024',
+ uploadSessionTtlMs: '86400000',
+ uploadCompletedReceiptTtlMs: '86400000',
+ uploadStalePartLeaseMs: '600000',
+ uploadMaxActivePerSubject: '2',
+ uploadMaxActiveGlobal: '8',
+ uploadMaxConcurrentPartsPerSession: '4',
+ uploadMaxConcurrentPartStreamsGlobal: '16',
+ uploadInstabilityFailureThreshold: '3',
+ uploadMaxConcurrentFinalizations: '1',
+ uploadMinFreeBytes: '10737418240',
+ uploadPartTimeoutMs: '300000',
+ uploadFinalizeTimeoutMs: '600000',
}
+ const uploadEnv = {
+ GFS_UPLOAD_PROTOCOL_MAX_FILE_BYTES: '1073741824',
+ GFS_UPLOAD_PRODUCT_MAX_FILE_BYTES: '209715200',
+ GFS_UPLOAD_MAX_FILE_BYTES: '209715200',
+ GFS_UPLOAD_PREFERRED_CHUNK_BYTES: '8388608',
+ GFS_UPLOAD_MAX_CHUNK_BYTES: '16777216',
+ GFS_UPLOAD_MIN_PART_BYTES: '1048576',
+ GFS_UPLOAD_MAX_PART_COUNT: '1024',
+ GFS_UPLOAD_SESSION_TTL_MS: '86400000',
+ GFS_UPLOAD_COMPLETED_RECEIPT_TTL_MS: '86400000',
+ GFS_UPLOAD_STALE_PART_LEASE_MS: '600000',
+ GFS_UPLOAD_MAX_ACTIVE_PER_SUBJECT: '2',
+ GFS_UPLOAD_MAX_ACTIVE_GLOBAL: '8',
+ GFS_UPLOAD_MAX_CONCURRENT_PARTS_PER_SESSION: '4',
+ GFS_UPLOAD_MAX_CONCURRENT_PART_STREAMS_GLOBAL: '16',
+ GFS_UPLOAD_INSTABILITY_FAILURE_THRESHOLD: '3',
+ GFS_UPLOAD_MAX_CONCURRENT_FINALIZATIONS: '1',
+ GFS_UPLOAD_MIN_FREE_BYTES: '10737418240',
+ GFS_UPLOAD_PART_TIMEOUT_MS: '300000',
+ GFS_UPLOAD_FINALIZE_TIMEOUT_MS: '600000',
+ } as const
for (const role of ['writer', 'reader'] as const) {
const env =
@@ -174,12 +211,11 @@ describe('gfsFactory writer Deployment', () => {
expect(byName('GFS_SYNC_COPY_MAX_OBJECTS')?.value).toBe('2500')
expect(byName('GFS_SYNC_COPY_MAX_BYTES')?.value).toBe('')
expect(byName('GFS_SYNC_COPY_TIMEOUT_MS')?.value).toBe('45000')
- // The 16MB upload cap depends on this reaching gfsc; a dropped passthrough
- // leaves gfsc on its 16MiB default and 413s a 16MB file.
+ // The legacy buffered cap remains independent from upload-v2 part limits.
expect(byName('GFS_MAX_WRITE_BODY_BYTES')?.value).toBe('25165824')
- expect(byName('GFS_UPLOAD_PRODUCT_MAX_FILE_BYTES')?.value).toBe('209715200')
- expect(byName('GFS_UPLOAD_PREFERRED_CHUNK_BYTES')?.value).toBe('8388608')
- expect(byName('GFS_UPLOAD_MAX_CHUNK_BYTES')?.value).toBe('16777216')
+ for (const [name, value] of Object.entries(uploadEnv)) {
+ expect(byName(name)?.value).toBe(value)
+ }
if (role === 'writer') expect(byName('GFS_UPLOAD_V2_ENABLED')?.value).toBe('true')
else expect(byName('GFS_UPLOAD_V2_ENABLED')).toBeUndefined()
}
diff --git a/scripts/tests/test-minikube-gfs-upload-v2-profile.sh b/scripts/tests/test-minikube-gfs-upload-v2-profile.sh
new file mode 100755
index 000000000..2cdd9091c
--- /dev/null
+++ b/scripts/tests/test-minikube-gfs-upload-v2-profile.sh
@@ -0,0 +1,90 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)"
+OVERLAY="$ROOT/deploy/overlays/minikube"
+PATCH="$OVERLAY/patches/gfs-upload-v2.yaml"
+
+fail() {
+ printf 'FAIL: %s\n' "$*" >&2
+ exit 1
+}
+
+command -v kubectl >/dev/null 2>&1 || fail 'kubectl is required to validate the committed minikube render'
+[[ -f "$PATCH" ]] || fail 'minikube has no versioned GFS Upload v2 profile patch'
+grep -Eq '^[[:space:]]*-[[:space:]]+patches/gfs-upload-v2\.yaml$' "$OVERLAY/kustomization.yaml" \
+ || fail 'minikube kustomization does not include its GFS Upload v2 profile patch'
+
+TMP="$(mktemp -d)"
+trap 'rm -rf "$TMP"' EXIT
+cp -R "$ROOT/deploy" "$TMP/deploy"
+sed 's#__K8S_API_IP__#10.96.0.1#g' \
+ "$TMP/deploy/overlays/minikube/patches/k8s-api-ip.yaml.template" \
+ >"$TMP/deploy/overlays/minikube/patches/k8s-api-ip.yaml"
+
+if ! kubectl kustomize "$TMP/deploy/overlays/minikube" \
+ >"$TMP/render.yaml" 2>"$TMP/render.err"; then
+ cat "$TMP/render.err" >&2
+ fail 'committed minikube overlay does not render'
+fi
+awk '
+ BEGIN { RS="---\n" }
+ /kind: Deployment/ && /name: host-context-controller/ { print; found=1; exit }
+ END { if (!found) exit 1 }
+' "$TMP/render.yaml" >"$TMP/hcc.yaml" \
+ || fail 'rendered minikube overlay has no host-context-controller Deployment'
+
+env_value() {
+ local key="$1"
+ awk -v key="$key" '
+ $0 ~ "^[[:space:]]*-[[:space:]]+name:[[:space:]]+" key "$" {
+ if (getline <= 0 || $0 !~ "^[[:space:]]+value:[[:space:]]+") exit 2
+ sub("^[[:space:]]+value:[[:space:]]+", "")
+ gsub(/^\"|\"$/, "")
+ print
+ found=1
+ exit
+ }
+ END { if (!found) exit 1 }
+ ' "$TMP/hcc.yaml"
+}
+
+expected=(
+ 'CONTEXT_MAPPER_GFSC_UPLOAD_V2_ENABLED=true'
+ 'CONTEXT_MAPPER_GFSC_UPLOAD_PROTOCOL_MAX_FILE_BYTES=1073741824'
+ 'CONTEXT_MAPPER_GFSC_UPLOAD_PRODUCT_MAX_FILE_BYTES=209715200'
+ 'CONTEXT_MAPPER_GFSC_UPLOAD_MAX_FILE_BYTES=209715200'
+ 'CONTEXT_MAPPER_GFSC_UPLOAD_PREFERRED_CHUNK_BYTES=8388608'
+ 'CONTEXT_MAPPER_GFSC_UPLOAD_MAX_CHUNK_BYTES=16777216'
+ 'CONTEXT_MAPPER_GFSC_UPLOAD_MIN_PART_BYTES=1048576'
+ 'CONTEXT_MAPPER_GFSC_UPLOAD_MAX_PART_COUNT=1024'
+ 'CONTEXT_MAPPER_GFSC_UPLOAD_SESSION_TTL_MS=86400000'
+ 'CONTEXT_MAPPER_GFSC_UPLOAD_COMPLETED_RECEIPT_TTL_MS=86400000'
+ 'CONTEXT_MAPPER_GFSC_UPLOAD_STALE_PART_LEASE_MS=600000'
+ 'CONTEXT_MAPPER_GFSC_UPLOAD_MAX_ACTIVE_PER_SUBJECT=2'
+ 'CONTEXT_MAPPER_GFSC_UPLOAD_MAX_ACTIVE_GLOBAL=8'
+ 'CONTEXT_MAPPER_GFSC_UPLOAD_MAX_CONCURRENT_PARTS_PER_SESSION=4'
+ 'CONTEXT_MAPPER_GFSC_UPLOAD_MAX_CONCURRENT_PART_STREAMS_GLOBAL=16'
+ 'CONTEXT_MAPPER_GFSC_UPLOAD_INSTABILITY_FAILURE_THRESHOLD=3'
+ 'CONTEXT_MAPPER_GFSC_UPLOAD_MAX_CONCURRENT_FINALIZATIONS=1'
+ 'CONTEXT_MAPPER_GFSC_UPLOAD_MIN_FREE_BYTES=10737418240'
+ 'CONTEXT_MAPPER_GFSC_UPLOAD_PART_TIMEOUT_MS=300000'
+ 'CONTEXT_MAPPER_GFSC_UPLOAD_FINALIZE_TIMEOUT_MS=600000'
+)
+
+for contract in "${expected[@]}"; do
+ key="${contract%%=*}"
+ want="${contract#*=}"
+ got="$(env_value "$key")" \
+ || fail "rendered HCC omits $key"
+ [[ "$got" == "$want" ]] \
+ || fail "rendered HCC sets $key=$got, expected $want"
+done
+
+# Enabling a local T2 profile must not enable the production-safe public base.
+if grep -A2 -F 'name: CONTEXT_MAPPER_GFSC_UPLOAD_V2_ENABLED' \
+ "$ROOT/deploy/base/control-plane/host-context-controller.yaml" | grep -Eq "value:[[:space:]]*['\"]?true['\"]?[[:space:]]*$"; then
+ fail 'public base enables GFS Upload v2 instead of leaving activation to an environment overlay'
+fi
+
+printf 'PASS: minikube renders the exact enabled GFS Upload v2 200 MiB profile while public base stays disabled\n'