@intentius/chant-lexicon-helm 0.49.0 → 0.51.0

package/dist/index.d.ts

@@ -2,6 +2,7 @@ export { helmSerializer } from "./serializer.js";
 export { helmPlugin } from "./plugin.js";
 export { helmCapabilityPlugin, HELM_VERB_FAMILIES } from "./components/capability-plugin.js";
 export { helmUpgradeCapability, createHelmUpgradeCapability, type HelmUpgradeInput, type HelmUpgradeOutcome } from "./components/helm-upgrade.js";
+export { helmInstall, helmInstallPinned } from "./op/builders.js";
 export { Chart, Values, ValuesOverride, HelmTest, HelmNotes, HelmHook, HelmDependency, HelmMaintainer, HelmCRD } from "./resources.js";
 export { HelmRender, getHelmRenderRecords, clearHelmRenderRecords } from "./render.js";
 export type { HelmRenderProps, HelmRenderRecord } from "./render.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAG9C,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAKtC,OAAO,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAC1F,OAAO,EAAE,qBAAqB,EAAE,2BAA2B,EAAE,KAAK,gBAAgB,EAAE,KAAK,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAQ/I,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAG/D,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,cAAc,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,cAAc,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAGpI,OAAO,EAAE,UAAU,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAC;AACpF,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAGlE,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAC1G,YAAY,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAG1G,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,cAAc,EACd,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EACjB,mBAAmB,EACnB,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,gBAAgB,CAAC;AACxB,YAAY,EACV,cAAc,EACd,mBAAmB,EACnB,iBAAiB,EACjB,oBAAoB,EACpB,sBAAsB,EACtB,sBAAsB,EACtB,mBAAmB,GACpB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAClE,YAAY,EACV,YAAY,EACZ,cAAc,EACd,mBAAmB,EACnB,uBAAuB,EACvB,kBAAkB,GACnB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAC5E,YAAY,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAGhE,OAAO,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAChF,YAAY,EAAE,yBAAyB,EAAE,0BAA0B,EAAE,MAAM,kBAAkB,CAAC;AAG9F,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,EACrB,iBAAiB,EACjB,uBAAuB,GACxB,MAAM,gBAAgB,CAAC;AACxB,YAAY,EACV,kBAAkB,EAClB,oBAAoB,EACpB,oBAAoB,EACpB,kBAAkB,EAClB,mBAAmB,EACnB,WAAW,EACX,sBAAsB,EACtB,cAAc,EACd,qBAAqB,GACtB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,gBAAgB,EAChB,2BAA2B,EAC3B,wBAAwB,EACxB,yBAAyB,EACzB,oBAAoB,GACrB,MAAM,UAAU,CAAC;AAClB,YAAY,EACV,eAAe,EACf,qBAAqB,EACrB,2BAA2B,EAC3B,wBAAwB,GACzB,MAAM,UAAU,CAAC;AAGlB,OAAO,EACL,OAAO,EACP,YAAY,EACZ,WAAW,EACX,cAAc,EACd,aAAa,EACb,WAAW,EACX,gBAAgB,EAChB,WAAW,EACX,MAAM,EACN,OAAO,EACP,QAAQ,EACR,OAAO,EACP,QAAQ,EACR,WAAW,EACX,MAAM,EACN,KAAK,EACL,MAAM,EACN,GAAG,EACH,MAAM,EACN,YAAY,EACZ,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,aAAa,EACb,cAAc,EACd,MAAM,EACN,EAAE,EACF,KAAK,EACL,IAAI,EACJ,SAAS,EACT,QAAQ,GACT,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAGpD,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,YAAY,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAG/C,OAAO,EAAE,QAAQ,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACnE,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAGvE,OAAO,EACL,UAAU,EACV,mBAAmB,EACnB,WAAW,EACX,gBAAgB,EAChB,WAAW,EACX,gBAAgB,EAChB,aAAa,EACb,UAAU,EACV,kBAAkB,EAClB,YAAY,EACZ,oBAAoB,EACpB,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,cAAc,CAAC;AACtB,YAAY,EACV,eAAe,EACf,gBAAgB,EAChB,wBAAwB,EACxB,yBAAyB,EACzB,gBAAgB,EAChB,iBAAiB,EACjB,qBAAqB,EACrB,sBAAsB,EACtB,gBAAgB,EAChB,iBAAiB,EACjB,qBAAqB,EACrB,sBAAsB,EACtB,kBAAkB,EAClB,mBAAmB,EACnB,eAAe,EACf,gBAAgB,EAChB,uBAAuB,EACvB,wBAAwB,EACxB,iBAAiB,EACjB,kBAAkB,EAClB,yBAAyB,EACzB,0BAA0B,EAC1B,sBAAsB,EACtB,uBAAuB,EACvB,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,cAAc,CAAC;AAGtB,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,wBAAwB,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAC1F,YAAY,EAAE,kBAAkB,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAIlG,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,YAAY,EACV,kBAAkB,EAClB,iBAAiB,EACjB,oBAAoB,EACpB,qBAAqB,EACrB,WAAW,EACX,iBAAiB,EACjB,cAAc,GACf,MAAM,eAAe,CAAC;AAGvB,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAGxC,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/integrity.json

@@ -1,7 +1,7 @@
 {
   "algorithm": "sha256",
   "artifacts": {
-    "manifest.json": "e240eeef5865a87bce3a27111adc0c59a76c410ceb701f6510c4d559c5320767",
+    "manifest.json": "a702d052f26168d598597b235ec4cb6441cc1fb4ad68aefc24227e6076ecd762",
     "meta.json": "14243c5730a07c6a6edc35ddd351438547d58df5cf345f2233a355b0c7611ccc",
     "types/index.d.ts": "5377696ca8698cd2999e4680feb8e8e4b54a7b49fb603a87b2f27356114d1794",
     "rules/chart-metadata.ts": "8f3377e893d5e2828460b7fe5924fca098334245a9a2fdb90f6b67e490eaf091",
@@ -36,5 +36,5 @@
     "skills/chant-helm-patterns.md": "9e79e6a46391da46709d8aa57e2825a7cd9eb981cd923f02ad60836c49b2561e",
     "skills/chant-helm-security.md": "bfc367eabceed2e84f1cf94501b407df78aeed963cec104f24a321d0962063c9"
   },
-  "composite": "b26091a74a2371c308b68c2a63b99428d753ef68dc49564774295ac611a4e094"
+  "composite": "4d09c2f23e9a06fe6472abbea195d9f7db144e196f14361aeef277cad453aa4f"
 }

package/dist/manifest.json

@@ -1,6 +1,6 @@
 {
   "name": "helm",
-  "version": "0.49.0",
+  "version": "0.51.0",
   "chantVersion": ">=0.1.0",
   "namespace": "Helm",
   "intrinsics": [
@@ -22,42 +22,50 @@
     {
       "name": "include",
       "description": "Include a named template: {{ include \"name\" . }}",
-      "isTag": false
+      "isTag": false,
+      "foldsAsCall": true
     },
     {
       "name": "required",
       "description": "Require a value: {{ required \"msg\" .Values.x }}",
-      "isTag": false
+      "isTag": false,
+      "foldsAsCall": true
     },
     {
       "name": "helmDefault",
       "description": "Default value: {{ default \"def\" .Values.x }}",
-      "isTag": false
+      "isTag": false,
+      "foldsAsCall": true
     },
     {
       "name": "toYaml",
       "description": "Convert to YAML: {{ toYaml .Values.x | nindent N }}",
-      "isTag": false
+      "isTag": false,
+      "foldsAsCall": true
     },
     {
       "name": "quote",
       "description": "Quote a value: {{ .Values.x | quote }}",
-      "isTag": false
+      "isTag": false,
+      "foldsAsCall": true
     },
     {
       "name": "printf",
       "description": "Format string: {{ printf \"%s\" .Values.x }}",
-      "isTag": false
+      "isTag": false,
+      "foldsAsCall": true
     },
     {
       "name": "tpl",
       "description": "Evaluate template: {{ tpl .Values.x . }}",
-      "isTag": false
+      "isTag": false,
+      "foldsAsCall": true
     },
     {
       "name": "lookup",
       "description": "Lookup resource: {{ lookup \"v1\" \"Secret\" \"ns\" \"name\" }}",
-      "isTag": false
+      "isTag": false,
+      "foldsAsCall": true
     },
     {
       "name": "Capabilities",
@@ -72,22 +80,26 @@
     {
       "name": "filesGet",
       "description": ".Files.Get: {{ .Files.Get \"path\" }}",
-      "isTag": false
+      "isTag": false,
+      "foldsAsCall": true
     },
     {
       "name": "filesGlob",
       "description": ".Files.Glob: {{ .Files.Glob \"pattern\" }}",
-      "isTag": false
+      "isTag": false,
+      "foldsAsCall": true
     },
     {
       "name": "filesAsConfig",
       "description": ".Files.Glob.AsConfig for ConfigMap data",
-      "isTag": false
+      "isTag": false,
+      "foldsAsCall": true
     },
     {
       "name": "filesAsSecrets",
       "description": ".Files.Glob.AsSecrets for Secret data",
-      "isTag": false
+      "isTag": false,
+      "foldsAsCall": true
     },
     {
       "name": "ElseIf",

package/dist/op/builders.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Typed step-builder wrappers for this lexicon's `helmInstall` activity
+ * (chant #1288 Stage 2 — "regenerate the step builders as fully typed
+ * wrappers"). Core cannot import a lexicon's `*Args` types (lexicons depend
+ * on core, not the other way around), so a fully typed `helmInstall` /
+ * `helmInstallPinned` has to live beside {@link HelmInstallArgs} — here,
+ * next to `./activities/helm.ts`. `opts`'s type in each wrapper below IS
+ * `HelmInstallArgs` itself (via `Omit`/`WithStepRefs`) — never a
+ * hand-restated mirror — so the option surface Stage 1's zod contracts
+ * deliberately skipped (`capabilityProfile`, `set`, `deleteMode`-adjacent
+ * cross-field options) is authoring-time typed for free.
+ *
+ * Every field also accepts a {@link StepOutputRef} in its place
+ * ({@link WithStepRefs}, chant #1950).
+ *
+ * `core`'s own `helmInstall`/`helmInstallPinned` (in `@intentius/chant/op`,
+ * re-exported from `@intentius/chant-lexicon-temporal`) are UNCHANGED and
+ * produce byte-identical `ActivityStep` output for the same inputs — these
+ * are purely additive. Deliberately not swapped into the temporal barrel
+ * (see `lexicons/k8s/src/op/builders.ts`'s module doc for why: it would make
+ * temporal depend on this package at runtime, undoing the product-agnostic
+ * split #809 did). An author who wants the typed surface imports it from
+ * here — `@intentius/chant-lexicon-helm` — which a project using
+ * `helmInstall` already depends on.
+ */
+import { type ActivityStep, type NamedActivityStep, type WithStepRefs } from "@intentius/chant/op";
+import type { HelmInstallArgs } from "./activities/helm.js";
+/** Extra opts every wrapper below accepts alongside its activity's own fields. */
+type StepOpts = {
+    profile?: ActivityStep["profile"];
+    id?: string;
+};
+/**
+ * Deploy a helm release — the fully typed twin of core's `helmInstall`.
+ * `opts` is {@link HelmInstallArgs} itself, minus the positional `name`/
+ * `chart`. Defaults to the `longInfra` profile.
+ */
+export declare const helmInstall: (name: string, chart: string, opts?: WithStepRefs<Omit<HelmInstallArgs, "name" | "chart">> & StepOpts) => NamedActivityStep;
+/**
+ * Deploy a recorded pinned render by its `sha256:` content digest (#1242) —
+ * the fully typed twin of core's `helmInstallPinned`. `opts` is
+ * {@link HelmInstallArgs} itself, minus the positional `name`/
+ * `contentDigest`. Defaults to the `longInfra` profile.
+ */
+export declare const helmInstallPinned: (name: string, contentDigest: string, opts?: WithStepRefs<Omit<HelmInstallArgs, "name" | "contentDigest">> & StepOpts) => NamedActivityStep;
+export {};
+//# sourceMappingURL=builders.d.ts.map

package/dist/op/builders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builders.d.ts","sourceRoot":"","sources":["../../src/op/builders.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,EAGL,KAAK,YAAY,EACjB,KAAK,iBAAiB,EACtB,KAAK,YAAY,EAClB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEzD,kFAAkF;AAClF,KAAK,QAAQ,GAAG;IAAE,OAAO,CAAC,EAAE,YAAY,CAAC,SAAS,CAAC,CAAC;IAAC,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAEnE;;;;GAIG;AACH,eAAO,MAAM,WAAW,GACtB,MAAM,MAAM,EACZ,OAAO,MAAM,EACb,OAAO,YAAY,CAAC,IAAI,CAAC,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,QAAQ,KACtE,iBAGF,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,GAC5B,MAAM,MAAM,EACZ,eAAe,MAAM,EACrB,OAAO,YAAY,CAAC,IAAI,CAAC,eAAe,EAAE,MAAM,GAAG,eAAe,CAAC,CAAC,GAAG,QAAQ,KAC9E,iBAGF,CAAC"}

package/dist/plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAiC,MAAM,0BAA0B,CAAC;AAiB7F,eAAO,MAAM,UAAU,EAAE,aA+ZxB,CAAC"}
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAiC,MAAM,0BAA0B,CAAC;AAiB7F,eAAO,MAAM,UAAU,EAAE,aAqcxB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intentius/chant-lexicon-helm",
-  "version": "0.49.0",
+  "version": "0.51.0",
   "description": "Helm chart lexicon for chant — declarative IaC in TypeScript",
   "license": "Apache-2.0",
   "homepage": "https://intentius.io/chant",
@@ -86,7 +86,7 @@
     "@types/js-yaml": "^4.0.9"
   },
   "peerDependencies": {
-    "@intentius/chant": "^0.49.0",
+    "@intentius/chant": "^0.51.0",
     "typescript": "^5.9.3",
     "zod": "^4.3.6"
   }

package/src/index.ts

@@ -10,6 +10,14 @@ export { helmPlugin } from "./plugin";
 export { helmCapabilityPlugin, HELM_VERB_FAMILIES } from "./components/capability-plugin";
 export { helmUpgradeCapability, createHelmUpgradeCapability, type HelmUpgradeInput, type HelmUpgradeOutcome } from "./components/helm-upgrade";
 
+// Typed Op step-builder wrappers (chant #1288 Stage 2) — helmInstall/
+// helmInstallPinned with authoring-time types derived from this lexicon's
+// own HelmInstallArgs (see ./op/builders.ts's module doc for why these live
+// here rather than in core or the temporal barrel). Opt-in:
+// `@intentius/chant-lexicon-temporal`'s same-named exports are core's
+// original untyped builders, unchanged, for cloud-agnostic authoring.
+export { helmInstall, helmInstallPinned } from "./op/builders";
+
 // Resources
 export { Chart, Values, ValuesOverride, HelmTest, HelmNotes, HelmHook, HelmDependency, HelmMaintainer, HelmCRD } from "./resources";
 

package/src/op/builders.test.ts

@@ -0,0 +1,70 @@
+/**
+ * Typed step-builder wrappers (chant #1288 Stage 2) — see
+ * `lexicons/k8s/src/op/builders.test.ts`'s module doc for what's asserted
+ * and why (backward compat against core's original, step-output-ref
+ * composition, compile-time-only `@ts-expect-error` checks walked by
+ * `npm run typecheck`).
+ */
+
+import { describe, test, expect } from "vitest";
+import {
+  helmInstall as helmInstallOld,
+  helmInstallPinned as helmInstallPinnedOld,
+  stepOutput,
+  type StepOutputRef,
+} from "@intentius/chant/op";
+import { helmInstall, helmInstallPinned } from "./builders";
+
+describe("helm typed step builders (#1288 Stage 2)", () => {
+  test("helmInstall: identical ActivityStep to core's original for a minimal call", () => {
+    expect(helmInstall("api", "./chart")).toEqual(helmInstallOld("api", "./chart"));
+  });
+
+  test("helmInstall: identical ActivityStep with opts (namespace, values, set, capabilityProfile)", () => {
+    const opts = {
+      namespace: "prod",
+      values: "values.yaml",
+      set: { "image.tag": "v2" },
+      capabilityProfile: { kubeVersion: "1.29" },
+      profile: "fastIdempotent" as const,
+    };
+    expect(helmInstall("api", "./chart", opts)).toEqual(helmInstallOld("api", "./chart", opts));
+  });
+
+  test("helmInstallPinned: identical ActivityStep to core's original", () => {
+    const opts = { namespace: "prod" };
+    expect(helmInstallPinned("api", "sha256:abc", opts)).toEqual(helmInstallPinnedOld("api", "sha256:abc", opts));
+  });
+
+  test("helmInstall: accepts a StepOutputRef in a typed slot", () => {
+    const ref = stepOutput("render-step", "namespace");
+    const step = helmInstall("api", "./chart", { namespace: ref });
+    expect(step.args?.namespace).toBe(ref);
+  });
+
+  test("helmInstall: .out is reachable when an id is given", () => {
+    const step = helmInstall("api", "./chart", { id: "deploy" });
+    const ref: StepOutputRef = step.out.releaseName;
+    expect(ref.step).toBe("deploy");
+    expect(ref.path).toBe("releaseName");
+  });
+});
+
+// ── Compile-time-only: authoring-time type errors (never executed) ──────────
+function _typeChecksOnly(): void {
+  // @ts-expect-error — "nameSpace" is not a key of HelmInstallArgs (the exact
+  // typo class chant #1288 names: helmInstall("api", "./chart", { nameSpace:
+  // "prod" }) silently no-opped before this).
+  helmInstall("api", "./chart", { nameSpace: "prod" });
+
+  // @ts-expect-error — set's values must be strings, not numbers.
+  helmInstall("api", "./chart", { set: { replicas: 3 } });
+
+  // @ts-expect-error — overrideProfileAssertion must be boolean.
+  helmInstall("api", "./chart", { overrideProfileAssertion: "true" });
+
+  // @ts-expect-error — contentDigest must be a string (the `sha256:...`
+  // digest), not a number.
+  helmInstall("api", "./chart", { contentDigest: 5 });
+}
+void _typeChecksOnly;

package/src/op/builders.ts

@@ -0,0 +1,66 @@
+/**
+ * Typed step-builder wrappers for this lexicon's `helmInstall` activity
+ * (chant #1288 Stage 2 — "regenerate the step builders as fully typed
+ * wrappers"). Core cannot import a lexicon's `*Args` types (lexicons depend
+ * on core, not the other way around), so a fully typed `helmInstall` /
+ * `helmInstallPinned` has to live beside {@link HelmInstallArgs} — here,
+ * next to `./activities/helm.ts`. `opts`'s type in each wrapper below IS
+ * `HelmInstallArgs` itself (via `Omit`/`WithStepRefs`) — never a
+ * hand-restated mirror — so the option surface Stage 1's zod contracts
+ * deliberately skipped (`capabilityProfile`, `set`, `deleteMode`-adjacent
+ * cross-field options) is authoring-time typed for free.
+ *
+ * Every field also accepts a {@link StepOutputRef} in its place
+ * ({@link WithStepRefs}, chant #1950).
+ *
+ * `core`'s own `helmInstall`/`helmInstallPinned` (in `@intentius/chant/op`,
+ * re-exported from `@intentius/chant-lexicon-temporal`) are UNCHANGED and
+ * produce byte-identical `ActivityStep` output for the same inputs — these
+ * are purely additive. Deliberately not swapped into the temporal barrel
+ * (see `lexicons/k8s/src/op/builders.ts`'s module doc for why: it would make
+ * temporal depend on this package at runtime, undoing the product-agnostic
+ * split #809 did). An author who wants the typed surface imports it from
+ * here — `@intentius/chant-lexicon-helm` — which a project using
+ * `helmInstall` already depends on.
+ */
+
+import {
+  activity,
+  takeProfileAndId,
+  type ActivityStep,
+  type NamedActivityStep,
+  type WithStepRefs,
+} from "@intentius/chant/op";
+import type { HelmInstallArgs } from "./activities/helm";
+
+/** Extra opts every wrapper below accepts alongside its activity's own fields. */
+type StepOpts = { profile?: ActivityStep["profile"]; id?: string };
+
+/**
+ * Deploy a helm release — the fully typed twin of core's `helmInstall`.
+ * `opts` is {@link HelmInstallArgs} itself, minus the positional `name`/
+ * `chart`. Defaults to the `longInfra` profile.
+ */
+export const helmInstall = (
+  name: string,
+  chart: string,
+  opts?: WithStepRefs<Omit<HelmInstallArgs, "name" | "chart">> & StepOpts,
+): NamedActivityStep => {
+  const { args, profile, id } = takeProfileAndId(opts as Record<string, unknown> | undefined);
+  return activity("helmInstall", { name, chart, ...args }, { profile: profile ?? "longInfra", ...(id ? { id } : {}) });
+};
+
+/**
+ * Deploy a recorded pinned render by its `sha256:` content digest (#1242) —
+ * the fully typed twin of core's `helmInstallPinned`. `opts` is
+ * {@link HelmInstallArgs} itself, minus the positional `name`/
+ * `contentDigest`. Defaults to the `longInfra` profile.
+ */
+export const helmInstallPinned = (
+  name: string,
+  contentDigest: string,
+  opts?: WithStepRefs<Omit<HelmInstallArgs, "name" | "contentDigest">> & StepOpts,
+): NamedActivityStep => {
+  const { args, profile, id } = takeProfileAndId(opts as Record<string, unknown> | undefined);
+  return activity("helmInstall", { name, contentDigest, ...args }, { profile: profile ?? "longInfra", ...(id ? { id } : {}) });
+};

package/src/plugin.ts

@@ -62,25 +62,63 @@ export const helmPlugin: LexiconPlugin = {
   completionProvider: helmCompletions,
   hoverProvider: helmHover,
 
+  // chant #1174 — `foldsAsCall: true` opts an intrinsic's PLAIN-CALL form
+  // into `chant build --fold` (chant #1044's mechanism, previously unused by
+  // this lexicon: every helm intrinsic is a plain call — helm has no tagged
+  // templates at all — so before this PR NONE of them folded, and a single
+  // `include(...)`/`printf(...)` anywhere in a chart's resources forced the
+  // whole file back to the run path).
+  //
+  // Audited one at a time against `IntrinsicDef.foldsAsCall`'s criterion
+  // (../../../packages/core/src/lexicon.ts): "calling the intrinsic is a
+  // pure function of its arguments that builds a deterministic data
+  // envelope". Every function below (`include`/`required`/`helmDefault`/
+  // `toYaml`/`quote`/`printf`/`tpl`/`lookup`/`filesGet`/`filesGlob`/
+  // `filesAsConfig`/`filesAsSecrets`, ./intrinsics.ts) does exactly that: it
+  // builds a `HelmTpl` (or, for `lookup`, a string) by interpolating its
+  // arguments into a Go template expression string — no I/O, no mutation, no
+  // dependency on anything but the arguments. `lookup`'s own side effect
+  // (a live cluster read) happens when HELM renders the resulting template
+  // at deploy time, not when this JS function runs at `chant build` time, so
+  // it is just as pure here as the rest.
+  //
+  // Left OUT, each for a specific reason rather than an oversight:
+  //   - `values`/`Release`/`ChartRef`/`Capabilities`/`Template` are proxy
+  //     OBJECTS, never called (`values(...)` isn't valid source) — nothing
+  //     to opt in.
+  //   - `withOrder`/`argoWave` return a PLAIN record meant to be spread
+  //     (`{...withOrder(1)}`), not a `HelmTpl`. `fold()`'s object-spread
+  //     handling (`Object.assign(obj, src)`, ../fold/fold.ts) runs
+  //     SYNCHRONOUSLY on the immediately-folded value, before the async
+  //     revival that would turn a folded call into its real result — opting
+  //     these in would spread the folded `{__intrinsic, args}` envelope's
+  //     own keys into the object instead of the real record. A real
+  //     soundness hazard, not a "not yet audited."
+  //   - `If`/`ElseIf`/`Range`/`With` take an arbitrary `body`/`elseBody`
+  //     that is often an arrow function (`Range(list, (item) => ({...}))`)
+  //     or a nested Declarable — `fold()` already rejects a function used as
+  //     a value on its own terms, so opting these in buys nothing measured
+  //     on this corpus and is left for a future PR to size against real
+  //     usage rather than widened on speculation.
   intrinsics(): IntrinsicDef[] {
     return [
       { name: "values", description: "Proxy accessor for {{ .Values.x }} references", isTag: false },
       { name: "Release", description: "Built-in Release object (Name, Namespace, etc.)", isTag: false },
       { name: "ChartRef", description: "Built-in Chart object (Name, Version, AppVersion)", isTag: false },
-      { name: "include", description: 'Include a named template: {{ include "name" . }}', isTag: false },
-      { name: "required", description: 'Require a value: {{ required "msg" .Values.x }}', isTag: false },
-      { name: "helmDefault", description: 'Default value: {{ default "def" .Values.x }}', isTag: false },
-      { name: "toYaml", description: "Convert to YAML: {{ toYaml .Values.x | nindent N }}", isTag: false },
-      { name: "quote", description: "Quote a value: {{ .Values.x | quote }}", isTag: false },
-      { name: "printf", description: 'Format string: {{ printf "%s" .Values.x }}', isTag: false },
-      { name: "tpl", description: "Evaluate template: {{ tpl .Values.x . }}", isTag: false },
-      { name: "lookup", description: 'Lookup resource: {{ lookup "v1" "Secret" "ns" "name" }}', isTag: false },
+      { name: "include", description: 'Include a named template: {{ include "name" . }}', isTag: false, foldsAsCall: true },
+      { name: "required", description: 'Require a value: {{ required "msg" .Values.x }}', isTag: false, foldsAsCall: true },
+      { name: "helmDefault", description: 'Default value: {{ default "def" .Values.x }}', isTag: false, foldsAsCall: true },
+      { name: "toYaml", description: "Convert to YAML: {{ toYaml .Values.x | nindent N }}", isTag: false, foldsAsCall: true },
+      { name: "quote", description: "Quote a value: {{ .Values.x | quote }}", isTag: false, foldsAsCall: true },
+      { name: "printf", description: 'Format string: {{ printf "%s" .Values.x }}', isTag: false, foldsAsCall: true },
+      { name: "tpl", description: "Evaluate template: {{ tpl .Values.x . }}", isTag: false, foldsAsCall: true },
+      { name: "lookup", description: 'Lookup resource: {{ lookup "v1" "Secret" "ns" "name" }}', isTag: false, foldsAsCall: true },
       { name: "Capabilities", description: "Built-in Capabilities object (KubeVersion, APIVersions, HelmVersion)", isTag: false },
       { name: "Template", description: "Built-in Template object (Name, BasePath)", isTag: false },
-      { name: "filesGet", description: '.Files.Get: {{ .Files.Get "path" }}', isTag: false },
-      { name: "filesGlob", description: '.Files.Glob: {{ .Files.Glob "pattern" }}', isTag: false },
-      { name: "filesAsConfig", description: ".Files.Glob.AsConfig for ConfigMap data", isTag: false },
-      { name: "filesAsSecrets", description: ".Files.Glob.AsSecrets for Secret data", isTag: false },
+      { name: "filesGet", description: '.Files.Get: {{ .Files.Get "path" }}', isTag: false, foldsAsCall: true },
+      { name: "filesGlob", description: '.Files.Glob: {{ .Files.Glob "pattern" }}', isTag: false, foldsAsCall: true },
+      { name: "filesAsConfig", description: ".Files.Glob.AsConfig for ConfigMap data", isTag: false, foldsAsCall: true },
+      { name: "filesAsSecrets", description: ".Files.Glob.AsSecrets for Secret data", isTag: false, foldsAsCall: true },
       { name: "ElseIf", description: "Else-if chaining: {{- else if .Values.x }}...{{- end }}", isTag: false },
       { name: "If", description: "Conditional: {{- if .Values.x }}...{{- end }}", isTag: false },
       { name: "Range", description: "Range loop: {{- range .Values.x }}...{{- end }}", isTag: false },