Skip to content

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

TypeScript

docs(hcc): describe the stateless pull-policy condition as advisory

Alfredo Lopezbaf07bd75d6d
diff --git a/host-context-controller/package-lock.json b/host-context-controller/package-lock.json
index af0244469..657156c65 100644
--- a/host-context-controller/package-lock.json
+++ b/host-context-controller/package-lock.json
@@ -1,12 +1,12 @@
{
"name": "clerum-host-context-controller",
- "version": "0.1.390",
+ "version": "0.1.391",
"lockfileVersion": 3,
"requires": true,
"packages": {
"": {
"name": "clerum-host-context-controller",
- "version": "0.1.390",
+ "version": "0.1.391",
"license": "SEE LICENSE IN LICENSE",
"dependencies": {
"@clerum/codex-catalog-projection": "file:../packages/codex-catalog-projection",
diff --git a/host-context-controller/package.json b/host-context-controller/package.json
index e2170dab1..2a731c36a 100644
--- a/host-context-controller/package.json
+++ b/host-context-controller/package.json
@@ -1,6 +1,6 @@
{
"name": "clerum-host-context-controller",
- "version": "0.1.390",
+ "version": "0.1.391",
"description": "Host Context Controller - provides McpServer CRDs to mcp-host via REST API",
"main": "dist/main.js",
"engines": {
diff --git a/host-context-controller/src/config.ts b/host-context-controller/src/config.ts
index a38396937..696678ac4 100644
--- a/host-context-controller/src/config.ts
+++ b/host-context-controller/src/config.ts
@@ -93,11 +93,11 @@ export interface Config {
hostImage: string
hostImagePullPolicy: 'Always' | 'IfNotPresent' | 'Never'
// Pull policy override for STATELESS host pods (Stage 6, W5). Empty =
- // inherit hostImagePullPolicy. IfNotPresent is honored only for immutable
- // image references (@sha256: digest or a sha-<gitsha> tag); a mutable
- // reference is refused loudly (error log + StatelessPullPolicyRejected
- // condition) and the pod keeps Always — see hostReconciler's
- // resolveStatelessImagePullPolicy.
+ // inherit hostImagePullPolicy. The configured policy is always applied.
+ // IfNotPresent on a mutable image reference (no @sha256: digest, tag not
+ // sha-<gitsha>) is only reported: a once-per-(host,image) warning and the
+ // advisory StatelessPullPolicyRejected=True condition. Always is not
+ // enforced — see resolveStatelessImagePullPolicy.
statelessImagePullPolicy: '' | 'Always' | 'IfNotPresent' | 'Never'
mcpServerImagePullPolicy: 'Always' | 'IfNotPresent' | 'Never'
hostImagePullSecretName: string
diff --git a/host-context-controller/src/hostReconciler.ts b/host-context-controller/src/hostReconciler.ts
index d7ca0d993..44dafb31e 100644
--- a/host-context-controller/src/hostReconciler.ts
+++ b/host-context-controller/src/hostReconciler.ts
@@ -3571,8 +3571,8 @@ export class HostReconciler {
const isStateless = effectiveLifecycle.stateless
const image = isDesktop ? config.desktopImage : config.hostImage
const resources = isDesktop ? config.desktopResources : config.hostResources
- // Stage 6 (W5): stateless pods may override the pull policy (guarded —
- // see resolveStatelessImagePullPolicy). Non-stateless pods keep the
+ // Stage 6 (W5): stateless pods may override the pull policy (a mutable
+ // image is reported, not refused — see resolveStatelessImagePullPolicy). Non-stateless pods keep the
// global policy so their manifest stays byte-identical.
const imagePullPolicy = isStateless
? this.statelessImagePullPolicyForHost(host, image)
diff --git a/host-context-controller/src/statelessDeployment.ts b/host-context-controller/src/statelessDeployment.ts
index 55f31d019..38b5a4bfd 100644
--- a/host-context-controller/src/statelessDeployment.ts
+++ b/host-context-controller/src/statelessDeployment.ts
@@ -8,9 +8,10 @@ import { config } from './config'
import { HostCondition } from './types'
/**
- * Condition surfacing a refused CONTEXT_MAPPER_STATELESS_IMAGE_PULL_POLICY
- * (Stage 6, W5). Mirrors the StatelessEnableRejected pattern: durable,
- * operator-visible, True only while the misconfiguration persists.
+ * Advisory condition for CONTEXT_MAPPER_STATELESS_IMAGE_PULL_POLICY (Stage 6,
+ * W5): True while IfNotPresent is applied to a mutable image reference. The
+ * policy is not overridden. Durable and operator-visible like
+ * StatelessEnableRejected, True only while the configuration persists.
*/
export const STATELESS_PULL_POLICY_REJECTED_CONDITION_TYPE = 'StatelessPullPolicyRejected'
/** Immutable CI image tag shape (sha-<gitsha>), as pushed by deploy-dev. */
@@ -247,8 +248,8 @@ export function resolveStatelessImagePullPolicy(image: string): StatelessPullPol
}
/**
- * Durable condition for the stateless pull-policy guard (Stage 6, W5): True
- * (MutableImageReference) while IfNotPresent is refused for a mutable image,
+ * Durable advisory condition for the stateless pull policy (Stage 6, W5): True
+ * (MutableImageReference) while IfNotPresent is applied to a mutable image,
* False (StatelessPullPolicyAccepted) otherwise. The message states the
* enforced outcome so the operator sees what the pod actually runs with.
*/