@intentius/chant-lexicon-helm 0.0.18 → 0.0.24

package/src/import/roundtrip.test.ts

@@ -0,0 +1,144 @@
+import { describe, test, expect } from "bun:test";
+import { HelmParser } from "./parser";
+import { HelmGenerator } from "./generator";
+
+const parser = new HelmParser();
+const generator = new HelmGenerator();
+
+describe("roundtrip: parse -> generate", () => {
+  test("minimal chart roundtrip", () => {
+    const files = {
+      "Chart.yaml": "apiVersion: v2\nname: my-app\nversion: 0.1.0\n",
+    };
+    const ir = parser.parseFiles(files);
+    const generated = generator.generate(ir);
+
+    expect(generated).toHaveLength(1);
+    expect(generated[0].path).toBe("chart.ts");
+    expect(generated[0].content).toContain("import");
+    expect(generated[0].content).toContain("export const chart = new Chart(");
+  });
+
+  test("chart with values roundtrip", () => {
+    const files = {
+      "Chart.yaml": "apiVersion: v2\nname: my-app\nversion: 0.1.0\n",
+      "values.yaml": "replicaCount: 2\nimage:\n  repository: nginx\n  tag: latest\n",
+    };
+    const ir = parser.parseFiles(files);
+    expect(ir.parameters.length).toBeGreaterThan(0);
+
+    const generated = generator.generate(ir);
+    const content = generated[0].content;
+    expect(content).toContain("Chart");
+    expect(content).toContain("Values");
+    expect(content).toContain("export const valuesSchema = new Values(");
+  });
+
+  test("Deployment template roundtrip", () => {
+    const files = {
+      "Chart.yaml": "apiVersion: v2\nname: my-app\nversion: 0.1.0\n",
+      "templates/deploy.yaml": "apiVersion: apps/v1\nkind: Deployment\nmetadata:\n  name: my-app\nspec:\n  replicas: 1\n",
+    };
+    const ir = parser.parseFiles(files);
+    const deploy = ir.resources.find((r) => r.type === "K8s::Apps::Deployment");
+    expect(deploy).toBeDefined();
+
+    const generated = generator.generate(ir);
+    const content = generated[0].content;
+    expect(content).toContain("@intentius/chant-lexicon-k8s");
+    expect(content).toContain("Deployment");
+    expect(content).toContain("export const");
+  });
+
+  test("Service template roundtrip", () => {
+    const files = {
+      "Chart.yaml": "apiVersion: v2\nname: my-app\nversion: 0.1.0\n",
+      "templates/svc.yaml": "apiVersion: v1\nkind: Service\nmetadata:\n  name: my-app\nspec:\n  type: ClusterIP\n  ports:\n    - port: 80\n",
+    };
+    const ir = parser.parseFiles(files);
+    const svc = ir.resources.find((r) => r.type === "K8s::Core::Service");
+    expect(svc).toBeDefined();
+
+    const generated = generator.generate(ir);
+    const content = generated[0].content;
+    expect(content).toContain("Service");
+  });
+
+  test("template expressions produce intrinsic imports", () => {
+    const files = {
+      "Chart.yaml": "apiVersion: v2\nname: my-app\nversion: 0.1.0\n",
+      "templates/deploy.yaml": 'apiVersion: apps/v1\nkind: Deployment\nmetadata:\n  name: {{ include "my-app.fullname" . }}\nspec:\n  replicas: {{ .Values.replicaCount }}\n',
+    };
+    const ir = parser.parseFiles(files);
+    const generated = generator.generate(ir);
+    const content = generated[0].content;
+    expect(content).toContain("include");
+    expect(content).toContain("values");
+  });
+
+  test("NOTES.txt roundtrip", () => {
+    const files = {
+      "Chart.yaml": "apiVersion: v2\nname: my-app\nversion: 0.1.0\n",
+      "templates/NOTES.txt": "Thank you for installing {{ .Chart.Name }}",
+    };
+    const ir = parser.parseFiles(files);
+    const notes = ir.resources.find((r) => r.type === "Helm::Notes");
+    expect(notes).toBeDefined();
+
+    const generated = generator.generate(ir);
+    expect(generated[0].content).toContain("HelmNotes");
+  });
+
+  test("full chart with multiple resources roundtrip", () => {
+    const files = {
+      "Chart.yaml": "apiVersion: v2\nname: my-app\nversion: 0.1.0\n",
+      "values.yaml": "replicaCount: 1\nimage:\n  repository: nginx\n  tag: stable\n",
+      "templates/deploy.yaml": "apiVersion: apps/v1\nkind: Deployment\nmetadata:\n  name: my-app\nspec:\n  replicas: {{ .Values.replicaCount }}\n",
+      "templates/svc.yaml": "apiVersion: v1\nkind: Service\nmetadata:\n  name: my-app\nspec:\n  type: ClusterIP\n",
+      "templates/NOTES.txt": "Thank you for installing my-app!",
+    };
+    const ir = parser.parseFiles(files);
+    expect(ir.resources.length).toBeGreaterThanOrEqual(4);
+
+    const generated = generator.generate(ir);
+    const content = generated[0].content;
+    expect(content).toContain("Chart");
+    expect(content).toContain("Values");
+    expect(content).toContain("Deployment");
+    expect(content).toContain("Service");
+    expect(content).toContain("HelmNotes");
+    expect(content).toContain("export const");
+  });
+
+  test("IR metadata captures chart name", () => {
+    const files = {
+      "Chart.yaml": "apiVersion: v2\nname: cool-app\nversion: 1.0.0\n",
+    };
+    const ir = parser.parseFiles(files);
+    expect(ir.metadata?.chartName).toBe("cool-app");
+  });
+
+  test("ConfigMap template roundtrip", () => {
+    const files = {
+      "Chart.yaml": "apiVersion: v2\nname: my-app\nversion: 0.1.0\n",
+      "templates/configmap.yaml": "apiVersion: v1\nkind: ConfigMap\nmetadata:\n  name: my-config\ndata:\n  key: value\n",
+    };
+    const ir = parser.parseFiles(files);
+    const cm = ir.resources.find((r) => r.type === "K8s::Core::ConfigMap");
+    expect(cm).toBeDefined();
+
+    const generated = generator.generate(ir);
+    expect(generated[0].content).toContain("ConfigMap");
+  });
+
+  test("skips _helpers.tpl files", () => {
+    const files = {
+      "Chart.yaml": "apiVersion: v2\nname: my-app\nversion: 0.1.0\n",
+      "templates/_helpers.tpl": '{{- define "my-app.fullname" -}}\n{{ .Release.Name }}\n{{- end -}}\n',
+    };
+    const ir = parser.parseFiles(files);
+    // Only the chart resource, no template from _helpers.tpl
+    expect(ir.resources).toHaveLength(1);
+    expect(ir.resources[0].type).toBe("Helm::Chart");
+  });
+});

package/src/lint/post-synth/whm101.test.ts

@@ -0,0 +1,69 @@
+import { describe, test, expect } from "bun:test";
+import type { PostSynthContext } from "@intentius/chant/lint/post-synth";
+import type { SerializerResult } from "@intentius/chant/serializer";
+import { whm101 } from "./whm101";
+
+function makeCtx(files: Record<string, string>): PostSynthContext {
+  const result: SerializerResult = { primary: files["Chart.yaml"] ?? "", files };
+  const outputs = new Map<string, string | SerializerResult>();
+  outputs.set("helm", result);
+  return {
+    outputs,
+    entities: new Map(),
+    buildResult: {
+      outputs,
+      entities: new Map(),
+      warnings: [],
+      errors: [],
+      sourceFileCount: 1,
+    },
+  };
+}
+
+describe("WHM101: Chart.yaml validation", () => {
+  test("passes with valid Chart.yaml", () => {
+    const ctx = makeCtx({
+      "Chart.yaml": "apiVersion: v2\nname: test\nversion: 0.1.0\n",
+    });
+    expect(whm101.check(ctx)).toHaveLength(0);
+  });
+
+  test("fails when Chart.yaml is missing", () => {
+    const ctx = makeCtx({});
+    const diags = whm101.check(ctx);
+    expect(diags.length).toBeGreaterThan(0);
+    expect(diags[0].message).toContain("missing");
+  });
+
+  test("fails when apiVersion is not v2", () => {
+    const ctx = makeCtx({
+      "Chart.yaml": "apiVersion: v1\nname: test\nversion: 0.1.0\n",
+    });
+    const diags = whm101.check(ctx);
+    expect(diags.some((d) => d.message.includes("v2"))).toBe(true);
+  });
+
+  test("fails when name is missing", () => {
+    const ctx = makeCtx({
+      "Chart.yaml": "apiVersion: v2\nversion: 0.1.0\n",
+    });
+    const diags = whm101.check(ctx);
+    expect(diags.some((d) => d.message.includes("name"))).toBe(true);
+  });
+
+  test("fails when version is missing", () => {
+    const ctx = makeCtx({
+      "Chart.yaml": "apiVersion: v2\nname: test\n",
+    });
+    const diags = whm101.check(ctx);
+    expect(diags.some((d) => d.message.includes("version"))).toBe(true);
+  });
+
+  test("all diagnostics have checkId WHM101", () => {
+    const ctx = makeCtx({});
+    const diags = whm101.check(ctx);
+    for (const d of diags) {
+      expect(d.checkId).toBe("WHM101");
+    }
+  });
+});

package/src/lint/post-synth/whm102.test.ts

@@ -0,0 +1,57 @@
+import { describe, test, expect } from "bun:test";
+import type { PostSynthContext } from "@intentius/chant/lint/post-synth";
+import type { SerializerResult } from "@intentius/chant/serializer";
+import { whm102 } from "./whm102";
+
+function makeCtx(files: Record<string, string>): PostSynthContext {
+  const result: SerializerResult = { primary: files["Chart.yaml"] ?? "", files };
+  const outputs = new Map<string, string | SerializerResult>();
+  outputs.set("helm", result);
+  return {
+    outputs,
+    entities: new Map(),
+    buildResult: {
+      outputs,
+      entities: new Map(),
+      warnings: [],
+      errors: [],
+      sourceFileCount: 1,
+    },
+  };
+}
+
+describe("WHM102: values.schema.json", () => {
+  test("passes when schema exists", () => {
+    const ctx = makeCtx({
+      "Chart.yaml": "apiVersion: v2\nname: test\nversion: 0.1.0\n",
+      "values.yaml": "replicaCount: 1\n",
+      "values.schema.json": "{}",
+    });
+    expect(whm102.check(ctx)).toHaveLength(0);
+  });
+
+  test("warns when values are non-empty but schema is missing", () => {
+    const ctx = makeCtx({
+      "Chart.yaml": "apiVersion: v2\nname: test\nversion: 0.1.0\n",
+      "values.yaml": "replicaCount: 1\n",
+    });
+    const diags = whm102.check(ctx);
+    expect(diags).toHaveLength(1);
+    expect(diags[0].checkId).toBe("WHM102");
+  });
+
+  test("passes when values.yaml is empty object", () => {
+    const ctx = makeCtx({
+      "Chart.yaml": "apiVersion: v2\nname: test\nversion: 0.1.0\n",
+      "values.yaml": "{}",
+    });
+    expect(whm102.check(ctx)).toHaveLength(0);
+  });
+
+  test("passes when values.yaml is absent", () => {
+    const ctx = makeCtx({
+      "Chart.yaml": "apiVersion: v2\nname: test\nversion: 0.1.0\n",
+    });
+    expect(whm102.check(ctx)).toHaveLength(0);
+  });
+});

package/src/lint/post-synth/whm103.test.ts

@@ -0,0 +1,58 @@
+import { describe, test, expect } from "bun:test";
+import type { PostSynthContext } from "@intentius/chant/lint/post-synth";
+import type { SerializerResult } from "@intentius/chant/serializer";
+import { whm103 } from "./whm103";
+
+function makeCtx(files: Record<string, string>): PostSynthContext {
+  const result: SerializerResult = { primary: files["Chart.yaml"] ?? "", files };
+  const outputs = new Map<string, string | SerializerResult>();
+  outputs.set("helm", result);
+  return {
+    outputs,
+    entities: new Map(),
+    buildResult: {
+      outputs,
+      entities: new Map(),
+      warnings: [],
+      errors: [],
+      sourceFileCount: 1,
+    },
+  };
+}
+
+describe("WHM103: template syntax", () => {
+  test("passes with balanced braces", () => {
+    const ctx = makeCtx({
+      "Chart.yaml": "apiVersion: v2\nname: test\nversion: 0.1.0\n",
+      "templates/deploy.yaml": "name: {{ .Values.name }}\n",
+    });
+    expect(whm103.check(ctx)).toHaveLength(0);
+  });
+
+  test("fails with unbalanced braces (missing closing)", () => {
+    const ctx = makeCtx({
+      "Chart.yaml": "apiVersion: v2\nname: test\nversion: 0.1.0\n",
+      "templates/deploy.yaml": "name: {{ .Values.name }\n",
+    });
+    const diags = whm103.check(ctx);
+    expect(diags).toHaveLength(1);
+    expect(diags[0].message).toContain("Unbalanced");
+    expect(diags[0].checkId).toBe("WHM103");
+  });
+
+  test("passes with multiple balanced expressions", () => {
+    const ctx = makeCtx({
+      "Chart.yaml": "apiVersion: v2\nname: test\nversion: 0.1.0\n",
+      "templates/deploy.yaml": "name: {{ .Values.name }}\nimage: {{ .Values.image }}\n",
+    });
+    expect(whm103.check(ctx)).toHaveLength(0);
+  });
+
+  test("ignores non-template files", () => {
+    const ctx = makeCtx({
+      "Chart.yaml": "apiVersion: v2\nname: test\nversion: 0.1.0\n",
+      "values.yaml": "name: {{ broken\n",
+    });
+    expect(whm103.check(ctx)).toHaveLength(0);
+  });
+});

package/src/lint/post-synth/whm104.test.ts

@@ -0,0 +1,57 @@
+import { describe, test, expect } from "bun:test";
+import type { PostSynthContext } from "@intentius/chant/lint/post-synth";
+import type { SerializerResult } from "@intentius/chant/serializer";
+import { whm104 } from "./whm104";
+
+function makeCtx(files: Record<string, string>): PostSynthContext {
+  const result: SerializerResult = { primary: files["Chart.yaml"] ?? "", files };
+  const outputs = new Map<string, string | SerializerResult>();
+  outputs.set("helm", result);
+  return {
+    outputs,
+    entities: new Map(),
+    buildResult: {
+      outputs,
+      entities: new Map(),
+      warnings: [],
+      errors: [],
+      sourceFileCount: 1,
+    },
+  };
+}
+
+describe("WHM104: NOTES.txt", () => {
+  test("info when NOTES.txt is missing for application chart", () => {
+    const ctx = makeCtx({
+      "Chart.yaml": "apiVersion: v2\nname: test\nversion: 0.1.0\ntype: application\n",
+    });
+    const diags = whm104.check(ctx);
+    expect(diags).toHaveLength(1);
+    expect(diags[0].severity).toBe("info");
+    expect(diags[0].checkId).toBe("WHM104");
+  });
+
+  test("passes for library charts without NOTES.txt", () => {
+    const ctx = makeCtx({
+      "Chart.yaml": "apiVersion: v2\nname: test\nversion: 0.1.0\ntype: library\n",
+    });
+    expect(whm104.check(ctx)).toHaveLength(0);
+  });
+
+  test("passes when NOTES.txt exists", () => {
+    const ctx = makeCtx({
+      "Chart.yaml": "apiVersion: v2\nname: test\nversion: 0.1.0\ntype: application\n",
+      "templates/NOTES.txt": "Hello!",
+    });
+    expect(whm104.check(ctx)).toHaveLength(0);
+  });
+
+  test("info when type is absent (defaults to application)", () => {
+    const ctx = makeCtx({
+      "Chart.yaml": "apiVersion: v2\nname: test\nversion: 0.1.0\n",
+    });
+    const diags = whm104.check(ctx);
+    expect(diags).toHaveLength(1);
+    expect(diags[0].severity).toBe("info");
+  });
+});

package/src/lint/post-synth/whm105.test.ts

@@ -0,0 +1,41 @@
+import { describe, test, expect } from "bun:test";
+import type { PostSynthContext } from "@intentius/chant/lint/post-synth";
+import type { SerializerResult } from "@intentius/chant/serializer";
+import { whm105 } from "./whm105";
+
+function makeCtx(files: Record<string, string>): PostSynthContext {
+  const result: SerializerResult = { primary: files["Chart.yaml"] ?? "", files };
+  const outputs = new Map<string, string | SerializerResult>();
+  outputs.set("helm", result);
+  return {
+    outputs,
+    entities: new Map(),
+    buildResult: {
+      outputs,
+      entities: new Map(),
+      warnings: [],
+      errors: [],
+      sourceFileCount: 1,
+    },
+  };
+}
+
+describe("WHM105: _helpers.tpl", () => {
+  test("warns when _helpers.tpl is missing", () => {
+    const ctx = makeCtx({
+      "Chart.yaml": "apiVersion: v2\nname: test\nversion: 0.1.0\n",
+    });
+    const diags = whm105.check(ctx);
+    expect(diags).toHaveLength(1);
+    expect(diags[0].checkId).toBe("WHM105");
+    expect(diags[0].severity).toBe("warning");
+  });
+
+  test("passes when _helpers.tpl exists", () => {
+    const ctx = makeCtx({
+      "Chart.yaml": "apiVersion: v2\nname: test\nversion: 0.1.0\n",
+      "templates/_helpers.tpl": "{{/* helpers */}}",
+    });
+    expect(whm105.check(ctx)).toHaveLength(0);
+  });
+});

package/src/lint/post-synth/whm201.test.ts

@@ -0,0 +1,59 @@
+import { describe, test, expect } from "bun:test";
+import type { PostSynthContext } from "@intentius/chant/lint/post-synth";
+import type { SerializerResult } from "@intentius/chant/serializer";
+import { whm201 } from "./whm201";
+
+function makeCtx(files: Record<string, string>): PostSynthContext {
+  const result: SerializerResult = { primary: files["Chart.yaml"] ?? "", files };
+  const outputs = new Map<string, string | SerializerResult>();
+  outputs.set("helm", result);
+  return {
+    outputs,
+    entities: new Map(),
+    buildResult: {
+      outputs,
+      entities: new Map(),
+      warnings: [],
+      errors: [],
+      sourceFileCount: 1,
+    },
+  };
+}
+
+describe("WHM201: standard labels", () => {
+  test("info when template lacks labels", () => {
+    const ctx = makeCtx({
+      "Chart.yaml": "apiVersion: v2\nname: test\nversion: 0.1.0\n",
+      "templates/deploy.yaml": "apiVersion: apps/v1\nkind: Deployment\nmetadata:\n  name: test\n",
+    });
+    const diags = whm201.check(ctx);
+    expect(diags).toHaveLength(1);
+    expect(diags[0].checkId).toBe("WHM201");
+    expect(diags[0].severity).toBe("info");
+  });
+
+  test("passes when template includes labels helper", () => {
+    const ctx = makeCtx({
+      "Chart.yaml": "apiVersion: v2\nname: test\nversion: 0.1.0\n",
+      "templates/deploy.yaml": 'apiVersion: apps/v1\nkind: Deployment\nmetadata:\n  labels: {{ include "test.labels" . }}\n',
+    });
+    expect(whm201.check(ctx)).toHaveLength(0);
+  });
+
+  test("passes when template has helm.sh/chart annotation", () => {
+    const ctx = makeCtx({
+      "Chart.yaml": "apiVersion: v2\nname: test\nversion: 0.1.0\n",
+      "templates/deploy.yaml": "apiVersion: apps/v1\nkind: Deployment\nmetadata:\n  labels:\n    helm.sh/chart: test\n",
+    });
+    expect(whm201.check(ctx)).toHaveLength(0);
+  });
+
+  test("skips _helpers.tpl and NOTES.txt", () => {
+    const ctx = makeCtx({
+      "Chart.yaml": "apiVersion: v2\nname: test\nversion: 0.1.0\n",
+      "templates/_helpers.tpl": "kind: something\n",
+      "templates/NOTES.txt": "kind: something\n",
+    });
+    expect(whm201.check(ctx)).toHaveLength(0);
+  });
+});

package/src/lint/post-synth/whm202.test.ts

@@ -0,0 +1,62 @@
+import { describe, test, expect } from "bun:test";
+import type { PostSynthContext } from "@intentius/chant/lint/post-synth";
+import type { SerializerResult } from "@intentius/chant/serializer";
+import { whm202 } from "./whm202";
+
+function makeCtx(files: Record<string, string>): PostSynthContext {
+  const result: SerializerResult = { primary: files["Chart.yaml"] ?? "", files };
+  const outputs = new Map<string, string | SerializerResult>();
+  outputs.set("helm", result);
+  return {
+    outputs,
+    entities: new Map(),
+    buildResult: {
+      outputs,
+      entities: new Map(),
+      warnings: [],
+      errors: [],
+      sourceFileCount: 1,
+    },
+  };
+}
+
+describe("WHM202: hook weights", () => {
+  test("warns when multiple hooks exist and some lack weights", () => {
+    const ctx = makeCtx({
+      "Chart.yaml": "apiVersion: v2\nname: test\nversion: 0.1.0\n",
+      "templates/pre-install.yaml": "helm.sh/hook: pre-install\nhelm.sh/hook-weight: \"-5\"\n",
+      "templates/post-install.yaml": "helm.sh/hook: post-install\n",
+    });
+    const diags = whm202.check(ctx);
+    expect(diags).toHaveLength(1);
+    expect(diags[0].checkId).toBe("WHM202");
+    expect(diags[0].severity).toBe("warning");
+    expect(diags[0].message).toContain("hook-weight");
+  });
+
+  test("passes when all hooks have weights", () => {
+    const ctx = makeCtx({
+      "Chart.yaml": "apiVersion: v2\nname: test\nversion: 0.1.0\n",
+      "templates/pre-install.yaml": "helm.sh/hook: pre-install\nhelm.sh/hook-weight: \"-5\"\n",
+      "templates/post-install.yaml": "helm.sh/hook: post-install\nhelm.sh/hook-weight: \"5\"\n",
+    });
+    expect(whm202.check(ctx)).toHaveLength(0);
+  });
+
+  test("passes with a single hook without weight", () => {
+    const ctx = makeCtx({
+      "Chart.yaml": "apiVersion: v2\nname: test\nversion: 0.1.0\n",
+      "templates/pre-install.yaml": "helm.sh/hook: pre-install\n",
+    });
+    expect(whm202.check(ctx)).toHaveLength(0);
+  });
+
+  test("ignores test hooks", () => {
+    const ctx = makeCtx({
+      "Chart.yaml": "apiVersion: v2\nname: test\nversion: 0.1.0\n",
+      "templates/test.yaml": "helm.sh/hook: test\n",
+      "templates/pre-install.yaml": "helm.sh/hook: pre-install\n",
+    });
+    expect(whm202.check(ctx)).toHaveLength(0);
+  });
+});

package/src/lint/post-synth/whm203.test.ts

@@ -0,0 +1,58 @@
+import { describe, test, expect } from "bun:test";
+import type { PostSynthContext } from "@intentius/chant/lint/post-synth";
+import type { SerializerResult } from "@intentius/chant/serializer";
+import { whm203 } from "./whm203";
+
+function makeCtx(files: Record<string, string>): PostSynthContext {
+  const result: SerializerResult = { primary: files["Chart.yaml"] ?? "", files };
+  const outputs = new Map<string, string | SerializerResult>();
+  outputs.set("helm", result);
+  return {
+    outputs,
+    entities: new Map(),
+    buildResult: {
+      outputs,
+      entities: new Map(),
+      warnings: [],
+      errors: [],
+      sourceFileCount: 1,
+    },
+  };
+}
+
+describe("WHM203: values documentation", () => {
+  test("info when values exist but no schema", () => {
+    const ctx = makeCtx({
+      "Chart.yaml": "apiVersion: v2\nname: test\nversion: 0.1.0\n",
+      "values.yaml": "replicaCount: 1\n",
+    });
+    const diags = whm203.check(ctx);
+    expect(diags).toHaveLength(1);
+    expect(diags[0].checkId).toBe("WHM203");
+    expect(diags[0].severity).toBe("info");
+  });
+
+  test("passes when schema exists", () => {
+    const ctx = makeCtx({
+      "Chart.yaml": "apiVersion: v2\nname: test\nversion: 0.1.0\n",
+      "values.yaml": "replicaCount: 1\n",
+      "values.schema.json": '{"type":"object"}',
+    });
+    expect(whm203.check(ctx)).toHaveLength(0);
+  });
+
+  test("passes when values.yaml is empty object", () => {
+    const ctx = makeCtx({
+      "Chart.yaml": "apiVersion: v2\nname: test\nversion: 0.1.0\n",
+      "values.yaml": "{}",
+    });
+    expect(whm203.check(ctx)).toHaveLength(0);
+  });
+
+  test("passes when no values.yaml exists", () => {
+    const ctx = makeCtx({
+      "Chart.yaml": "apiVersion: v2\nname: test\nversion: 0.1.0\n",
+    });
+    expect(whm203.check(ctx)).toHaveLength(0);
+  });
+});

package/src/lint/post-synth/whm204.test.ts

@@ -0,0 +1,56 @@
+import { describe, test, expect } from "bun:test";
+import type { PostSynthContext } from "@intentius/chant/lint/post-synth";
+import type { SerializerResult } from "@intentius/chant/serializer";
+import { whm204 } from "./whm204";
+
+function makeCtx(files: Record<string, string>): PostSynthContext {
+  const result: SerializerResult = { primary: files["Chart.yaml"] ?? "", files };
+  const outputs = new Map<string, string | SerializerResult>();
+  outputs.set("helm", result);
+  return {
+    outputs,
+    entities: new Map(),
+    buildResult: {
+      outputs,
+      entities: new Map(),
+      warnings: [],
+      errors: [],
+      sourceFileCount: 1,
+    },
+  };
+}
+
+describe("WHM204: dependency semver ranges", () => {
+  test("info when dependency uses pinned version", () => {
+    const ctx = makeCtx({
+      "Chart.yaml": "apiVersion: v2\nname: test\nversion: 0.1.0\ndependencies:\n  - name: redis\n    version: 1.2.3\n    repository: https://charts.bitnami.com\n",
+    });
+    const diags = whm204.check(ctx);
+    expect(diags).toHaveLength(1);
+    expect(diags[0].checkId).toBe("WHM204");
+    expect(diags[0].severity).toBe("info");
+    expect(diags[0].message).toContain("redis");
+    expect(diags[0].message).toContain("1.2.3");
+  });
+
+  test("passes when dependency uses tilde range", () => {
+    const ctx = makeCtx({
+      "Chart.yaml": "apiVersion: v2\nname: test\nversion: 0.1.0\ndependencies:\n  - name: redis\n    version: ~1.2.3\n    repository: https://charts.bitnami.com\n",
+    });
+    expect(whm204.check(ctx)).toHaveLength(0);
+  });
+
+  test("passes when dependency uses caret range", () => {
+    const ctx = makeCtx({
+      "Chart.yaml": "apiVersion: v2\nname: test\nversion: 0.1.0\ndependencies:\n  - name: redis\n    version: ^1.2.3\n    repository: https://charts.bitnami.com\n",
+    });
+    expect(whm204.check(ctx)).toHaveLength(0);
+  });
+
+  test("passes when no dependencies section", () => {
+    const ctx = makeCtx({
+      "Chart.yaml": "apiVersion: v2\nname: test\nversion: 0.1.0\n",
+    });
+    expect(whm204.check(ctx)).toHaveLength(0);
+  });
+});