@intentius/chant-lexicon-k8s 0.0.12

package/src/validate-cli.ts

@@ -0,0 +1,21 @@
+#!/usr/bin/env bun
+/**
+ * CLI entry point for Kubernetes lexicon validation.
+ */
+
+import { validate } from "./validate";
+import { printValidationResult } from "@intentius/chant/codegen/validate";
+
+async function main() {
+  const result = await validate();
+  printValidationResult(result);
+
+  if (!result.success) {
+    process.exit(1);
+  }
+}
+
+main().catch((err) => {
+  console.error("Validation failed:", err);
+  process.exit(1);
+});

package/src/validate.test.ts

@@ -0,0 +1,29 @@
+import { describe, test, expect } from "bun:test";
+import { validate } from "./validate";
+
+describe("validate", () => {
+  test("validate function exists and returns ValidateResult", async () => {
+    // validate runs against generated files — may fail if not generated
+    try {
+      const result = await validate();
+      expect(result).toBeDefined();
+      expect(typeof result.success).toBe("boolean");
+      expect(Array.isArray(result.checks)).toBe(true);
+    } catch {
+      // Expected if generated files don't exist
+    }
+  });
+
+  test("result has checks array", async () => {
+    try {
+      const result = await validate();
+      expect(Array.isArray(result.checks)).toBe(true);
+      for (const check of result.checks) {
+        expect(check).toHaveProperty("name");
+        expect(check).toHaveProperty("passed");
+      }
+    } catch {
+      // Expected if generated files don't exist
+    }
+  });
+});

package/src/validate.ts

@@ -0,0 +1,46 @@
+/**
+ * Validate generated lexicon-k8s artifacts.
+ *
+ * Thin wrapper around the core validation framework
+ * with Kubernetes-specific configuration.
+ */
+
+import { dirname } from "path";
+import { fileURLToPath } from "url";
+import { validateLexiconArtifacts, type ValidateResult } from "@intentius/chant/codegen/validate";
+
+export type { ValidateCheck, ValidateResult } from "@intentius/chant/codegen/validate";
+
+const REQUIRED_NAMES = [
+  // Core resources
+  "Pod", "Service", "ConfigMap", "Secret", "Namespace",
+  "ServiceAccount", "PersistentVolume", "PersistentVolumeClaim",
+  // Apps
+  "Deployment", "StatefulSet", "DaemonSet", "ReplicaSet",
+  // Batch
+  "Job", "CronJob",
+  // Networking
+  "Ingress", "NetworkPolicy",
+  // RBAC
+  "Role", "ClusterRole", "RoleBinding", "ClusterRoleBinding",
+  // Autoscaling
+  "HorizontalPodAutoscaler",
+  // Policy
+  "PodDisruptionBudget",
+  // Property types
+  "Container", "Volume", "VolumeMount", "EnvVar", "ServicePort",
+  "Probe", "ResourceRequirements", "SecurityContext",
+];
+
+/**
+ * Validate the generated lexicon-k8s artifacts.
+ */
+export async function validate(opts?: { basePath?: string }): Promise<ValidateResult> {
+  const basePath = opts?.basePath ?? dirname(dirname(fileURLToPath(import.meta.url)));
+
+  return validateLexiconArtifacts({
+    lexiconJsonFilename: "lexicon-k8s.json",
+    requiredNames: REQUIRED_NAMES,
+    basePath,
+  });
+}

package/src/variables.ts

@@ -0,0 +1,36 @@
+/**
+ * Kubernetes pseudo-parameters / well-known variables.
+ *
+ * Unlike AWS which has built-in pseudo-parameters (AWS::Region, etc.),
+ * Kubernetes doesn't have equivalent built-in variables. This module
+ * provides common label key constants for use in resource definitions.
+ */
+
+/**
+ * Well-known Kubernetes label keys from the standard label taxonomy.
+ * These are string constants, not runtime-resolved pseudo-parameters.
+ */
+export const K8sLabels = {
+  /** app.kubernetes.io/name */
+  AppName: "app.kubernetes.io/name",
+  /** app.kubernetes.io/instance */
+  AppInstance: "app.kubernetes.io/instance",
+  /** app.kubernetes.io/version */
+  AppVersion: "app.kubernetes.io/version",
+  /** app.kubernetes.io/component */
+  AppComponent: "app.kubernetes.io/component",
+  /** app.kubernetes.io/part-of */
+  AppPartOf: "app.kubernetes.io/part-of",
+  /** app.kubernetes.io/managed-by */
+  AppManagedBy: "app.kubernetes.io/managed-by",
+} as const;
+
+/**
+ * Well-known Kubernetes annotation keys.
+ */
+export const K8sAnnotations = {
+  /** kubernetes.io/change-cause */
+  ChangeCause: "kubernetes.io/change-cause",
+  /** kubernetes.io/description */
+  Description: "kubernetes.io/description",
+} as const;