@intentius/chant-lexicon-helm 0.17.0 → 0.18.0

package/dist/integrity.json

@@ -1,7 +1,7 @@
 {
   "algorithm": "sha256",
   "artifacts": {
-    "manifest.json": "50d45f66eb86a8a1560618842a3686a7d8b67db0c7bbfc27ce61df8e1526eeaa",
+    "manifest.json": "6fe42a935e40ffd478f06d3dd4e129eaadd925308b0e8ccee85f50263a422eb0",
     "meta.json": "14243c5730a07c6a6edc35ddd351438547d58df5cf345f2233a355b0c7611ccc",
     "types/index.d.ts": "5377696ca8698cd2999e4680feb8e8e4b54a7b49fb603a87b2f27356114d1794",
     "rules/chart-metadata.ts": "8f3377e893d5e2828460b7fe5924fca098334245a9a2fdb90f6b67e490eaf091",
@@ -34,5 +34,5 @@
     "skills/chant-helm-patterns.md": "9e79e6a46391da46709d8aa57e2825a7cd9eb981cd923f02ad60836c49b2561e",
     "skills/chant-helm-security.md": "bfc367eabceed2e84f1cf94501b407df78aeed963cec104f24a321d0962063c9"
   },
-  "composite": "f9e747897852299396438f4c0d4a02f3fd2cef43e30eb7cdc223c2896ee72420"
+  "composite": "66032a060d3b275af4c22fac9d3d4ed6a70c008770e93dbb6d9e65ca48b00e01"
 }

package/dist/manifest.json

@@ -1,6 +1,6 @@
 {
   "name": "helm",
-  "version": "0.17.0",
+  "version": "0.18.0",
   "chantVersion": ">=0.1.0",
   "namespace": "Helm",
   "intrinsics": [

package/dist/op/activities/helm.d.ts

@@ -0,0 +1,18 @@
+export interface HelmInstallArgs {
+    /** Helm release name. */
+    name: string;
+    /** Chart reference (local path or `repo/chart`). */
+    chart: string;
+    /** Path to a values file. */
+    values?: string;
+    /** Kubernetes namespace. */
+    namespace?: string;
+    /** Additional --set arguments. */
+    set?: Record<string, string>;
+}
+/**
+ * Run `helm upgrade --install <name> <chart>`.
+ * Uses longInfra profile — 20m timeout, heartbeat every 15s.
+ */
+export declare function helmInstall(args: HelmInstallArgs, signal?: AbortSignal): Promise<void>;
+//# sourceMappingURL=helm.d.ts.map

package/dist/op/activities/helm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helm.d.ts","sourceRoot":"","sources":["../../../src/op/activities/helm.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,eAAe;IAC9B,yBAAyB;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,oDAAoD;IACpD,KAAK,EAAE,MAAM,CAAC;IACd,6BAA6B;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,4BAA4B;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kCAAkC;IAClC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,eAAe,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAiB5F"}

package/dist/op/activities/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * helm Op activities — resolved by the core activity registry when a project's
+ * `chant.config.ts` lists the `helm` lexicon. `helmInstall` shells out to the
+ * helm CLI with heartbeat/retry semantics; relocated from the temporal lexicon
+ * (#809) so helm's imperative activity lives with its product, not in temporal.
+ * The `helmInstall` step builder stays in core (@intentius/chant/op), re-exported
+ * from the temporal Op-authoring barrel like the other core builders.
+ */
+export { helmInstall } from "./helm.js";
+export type { HelmInstallArgs } from "./helm.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/op/activities/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/op/activities/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AACrC,YAAY,EAAE,eAAe,EAAE,MAAM,QAAQ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intentius/chant-lexicon-helm",
-  "version": "0.17.0",
+  "version": "0.18.0",
   "description": "Helm chart lexicon for chant — declarative IaC in TypeScript",
   "license": "Apache-2.0",
   "homepage": "https://intentius.io/chant",
@@ -49,6 +49,11 @@
       "types": "./dist/lint/post-synth/index.d.ts",
       "default": "./src/lint/post-synth/index.ts"
     },
+    "./op/activities": {
+      "development": "./src/op/activities/index.ts",
+      "types": "./dist/op/activities/index.d.ts",
+      "default": "./src/op/activities/index.ts"
+    },
     "./manifest": "./dist/manifest.json",
     "./meta": "./dist/meta.json",
     "./types": "./dist/types/index.d.ts"
@@ -69,6 +74,6 @@
     "typescript": "^5.9.3"
   },
   "peerDependencies": {
-    "@intentius/chant": "^0.17.0"
+    "@intentius/chant": "^0.18.0"
   }
 }

package/src/op/activities/helm.ts

@@ -0,0 +1,41 @@
+import { exec } from "node:child_process";
+import { promisify } from "node:util";
+import { safeHeartbeat } from "@intentius/chant/op";
+
+const execAsync = promisify(exec);
+
+export interface HelmInstallArgs {
+  /** Helm release name. */
+  name: string;
+  /** Chart reference (local path or `repo/chart`). */
+  chart: string;
+  /** Path to a values file. */
+  values?: string;
+  /** Kubernetes namespace. */
+  namespace?: string;
+  /** Additional --set arguments. */
+  set?: Record<string, string>;
+}
+
+/**
+ * Run `helm upgrade --install <name> <chart>`.
+ * Uses longInfra profile — 20m timeout, heartbeat every 15s.
+ */
+export async function helmInstall(args: HelmInstallArgs, signal?: AbortSignal): Promise<void> {
+  const parts = ["helm", "upgrade", "--install", "--wait", args.name, args.chart];
+  if (args.namespace) parts.push("--namespace", args.namespace, "--create-namespace");
+  if (args.values) parts.push("-f", args.values);
+  for (const [k, v] of Object.entries(args.set ?? {})) parts.push("--set", `${k}=${v}`);
+
+  const heartbeatInterval = setInterval(() => {
+    safeHeartbeat({ step: "helm install", release: args.name });
+  }, 15_000);
+
+  try {
+    const { stdout, stderr } = await execAsync(parts.join(" "), { signal });
+    if (stdout) console.log(stdout);
+    if (stderr) console.error(stderr);
+  } finally {
+    clearInterval(heartbeatInterval);
+  }
+}

package/src/op/activities/index.ts

@@ -0,0 +1,10 @@
+/**
+ * helm Op activities — resolved by the core activity registry when a project's
+ * `chant.config.ts` lists the `helm` lexicon. `helmInstall` shells out to the
+ * helm CLI with heartbeat/retry semantics; relocated from the temporal lexicon
+ * (#809) so helm's imperative activity lives with its product, not in temporal.
+ * The `helmInstall` step builder stays in core (@intentius/chant/op), re-exported
+ * from the temporal Op-authoring barrel like the other core builders.
+ */
+export { helmInstall } from "./helm";
+export type { HelmInstallArgs } from "./helm";