Skip to main content

Release 0.4.11 — Skills Gallery Controls & Cleaner Metrics

Sri Aradhyula
Sri Aradhyula

Released: 2026-05-12 Chart: oci://ghcr.io/cnoe-io/charts/ai-platform-engineering:0.4.11 Previous release: 0.4.10

Highlights​

0.4.11 gives operators finer control over which skills appear in the Skills Gallery: a new HIDE_BUILTIN_SKILLS flag and a default of BUILTIN_SKILL_IDS: "none" keep built-in templates out of the gallery until you import them explicitly. The VictorOps MCP is consolidated around the v2 incidents reporting API and stops silently dropping fields. Several charts fixes stop Prometheus from firing spurious TargetDown alerts on services that never exposed /metrics, and the session-expiry sign-in flow no longer relies on a brittle new-tab refresh. This is a drop-in Helm upgrade — no values.yaml edits are required.

What's New​

  • HIDE_BUILTIN_SKILLS flag — when set to true, GET /api/skills skips loading disk-based skill templates so built-in skills do not appear in the gallery; operators load them on demand via Import template skills. Pairs cleanly with BUILTIN_SKILL_IDS=none for an empty starting gallery. The same PR also lets X-Caipe-Catalog-Key holders call POST /skills/refresh without a browser OIDC session — the catalog key is still validated against MongoDB, so security is unchanged (#1383)
  • Built-in skill auto-seeding off by default — the caipe-ui chart now defaults BUILTIN_SKILL_IDS: "none", disabling automatic seeding of template skills on startup. Restore the previous behavior with BUILTIN_SKILL_IDS: "" (seed all) or a comma-separated allow-list of template IDs (#1382)
  • Streamlined Skills Gateway quick-install — a series of refinements to the /skills gateway page: simplified quick-install flow, clearer API-key gating, collapsed advanced options, and corrected launch guidance (#1399)

VictorOps​

  • Consolidated v2 incident reporting — get_api_reporting_v2_incidents becomes the single incident-query tool with all_orgs=True fan-out (per-org payloads under by_org[slug], per-org errors under errors[slug], plus a total_count_by_phase summary). Removes redundant v1 GET endpoints and drops slim/projection logic that was silently dropping fields (notably the on-call user's name); all tools now return pretty-printed JSON so grep/glob over results works again (#1377)

Bug Fixes​

  • auth: replace the brittle "Refresh in New Tab" session-expiry flow with a current-tab sign-in that preserves the user's URL and shows a visible countdown when silent token refresh fails, routing through /login?session_expired=true to avoid AuthGuard redirect loops (#1386)
  • charts: exclude rag-server, agent-ontology, and skill-scanner from ServiceMonitor scraping — these services do not expose /metrics, so Prometheus was recording up=0 and firing TargetDown for healthy pods (#1388)
  • charts: exclude caipe-ui from ServiceMonitor scraping for the same reason (#1394)

Breaking Changes​

No breaking changes. Drop-in upgrade from 0.4.10.

Known Issues​

None known at this time.

Upgrade​

helm upgrade ai-platform-engineering \
  oci://ghcr.io/cnoe-io/charts/ai-platform-engineering \
  --version 0.4.11 \
  -f your-values.yaml

Upgrade Guide: 0.4.10 → 0.4.11​

Overview​

0.4.11 is a drop-in Helm upgrade. The only chart values change is a cosmetic comment update ("Skills API Gateway" → "Skills Gateway"). The new Skills Gallery behavior is driven by caipe-ui env vars (HIDE_BUILTIN_SKILLS, BUILTIN_SKILL_IDS), not by new top-level chart keys.

Helm Values Changes​

No functional Helm values changes between 0.4.10 and 0.4.11 — the only diff is a comment label updated to "Skills Gateway". Drop-in upgrade — no values.yaml edits required.

These caipe-ui config values changed defaults / gained meaning in this release:

Env VarDefaultDescription
BUILTIN_SKILL_IDS"none"Which built-in template skills to auto-seed on startup. "none" = seed none; "" = seed all; comma-separated list = seed specific IDs
HIDE_BUILTIN_SKILLSunset (false)When true, hides built-in skill templates from GET /api/skills / the gallery until imported via Import template skills

To restore pre-0.4.11 auto-seeding behavior, set BUILTIN_SKILL_IDS: "" in your caipe-ui config.

Data Migrations​

No MongoDB schema or data migrations required.

Upgrade Runbook​

1. Update chart version​

helm upgrade ai-platform-engineering \
  oci://ghcr.io/cnoe-io/charts/ai-platform-engineering \
  --version 0.4.11 \
  -f your-values.yaml

2. (Optional) Decide on built-in skill seeding​

If you rely on built-in template skills appearing automatically, set BUILTIN_SKILL_IDS: "" (or an explicit allow-list) in your caipe-ui config. Otherwise, the gallery starts empty and templates are imported on demand.

3. Verify​

kubectl get pods -n <namespace>

# Confirm the previously noisy services are no longer scraped as down
kubectl get servicemonitor -n <namespace>

Full Values Diff​

Raw diff (0.4.10 → 0.4.11)
@@ -217,7 +217,7 @@

 # ---------------------------------------------------------------------------
 # Live-skills command template (rendered as the `/skills` slash command
-# in the "Skills API Gateway" UI page). Customizable per-deployment.
+# in the "Skills Gateway" UI page). Customizable per-deployment.
 #
 # Resolution order (mirrors promptConfig):
 #   1. .Values.skillsLiveSkills          - inline multi-line string (highest)