Phase 8b: Helm contract extraction + diagram support

- extractHelmContracts() in contracts.js: values, services, workloads, deps
- Merged Helm contracts into main pipeline (124 contracts on Foxtrot)
- diagrams.js: generateContractDiagram now handles Helm types
- Sanitized Mermaid class names for Helm contracts
- 1601-line contracts index with full classDiagram

contracts.js

@@ -205,6 +205,98 @@ function buildContractXref(contracts, graph, relPathFn) {
   return xref;
 }
 
+/**
+ * Extract contracts from Helm chart data (from extract-helm.js).
+ * Produces contracts in the same shape as TypeScript ones for diagram/xref compatibility.
+ * @param {Array} helmCharts - From discoverCharts()
+ * @returns {object} { contracts, bySubsystem }
+ */
+function extractHelmContracts(helmCharts) {
+  const allContracts = [];
+  const bySubsystem = {};
+
+  for (const c of helmCharts) {
+    const sub = c.dir.split('/')[0] || 'root';
+    if (!bySubsystem[sub]) bySubsystem[sub] = [];
+
+    // Chart itself as a contract (its values.yaml is the API surface)
+    if (c.values.keys.length > 0) {
+      const contract = {
+        id: `${c.dir}/values.yaml:${c.chart.name}`,
+        type: 'HelmValues',
+        name: `${c.chart.name} (values)`,
+        visibility: 'public',
+        fields: c.values.keys.map(k => ({
+          name: k.name,
+          type: k.type || 'unknown',
+        })),
+      };
+      allContracts.push(contract);
+      bySubsystem[sub].push(contract);
+    }
+
+    // Services produced by this chart
+    const services = c.templates.resources.filter(r => r.kind === 'Service');
+    if (services.length > 0) {
+      const contract = {
+        id: `${c.dir}/templates:${c.chart.name}-services`,
+        type: 'HelmServices',
+        name: `${c.chart.name} (services)`,
+        visibility: 'public',
+        fields: services.map(s => ({
+          name: s.name === '(templated)' ? `${c.chart.name}-svc` : s.name,
+          type: 'Service',
+        })),
+      };
+      // Add port info from interactions
+      const ports = c.interactions.filter(i => i.type === 'port' && i.target !== '0');
+      for (const p of ports) {
+        contract.fields.push({ name: `port:${p.target}`, type: 'port' });
+      }
+      allContracts.push(contract);
+      bySubsystem[sub].push(contract);
+    }
+
+    // Deployments/StatefulSets/DaemonSets as workload contracts
+    const workloads = c.templates.resources.filter(r =>
+      ['Deployment', 'StatefulSet', 'DaemonSet', 'Rollout', 'CronJob', 'Job'].includes(r.kind)
+    );
+    if (workloads.length > 0) {
+      const contract = {
+        id: `${c.dir}/templates:${c.chart.name}-workloads`,
+        type: 'HelmWorkloads',
+        name: `${c.chart.name} (workloads)`,
+        visibility: 'public',
+        fields: workloads.map(w => ({
+          name: w.name === '(templated)' ? `${c.chart.name}-${w.kind.toLowerCase()}` : w.name,
+          type: w.kind,
+        })),
+      };
+      allContracts.push(contract);
+      bySubsystem[sub].push(contract);
+    }
+
+    // External interactions as dependency contracts
+    const extInteractions = c.interactions.filter(i => i.type === 'k8s-service' || i.type === 'config-ref');
+    if (extInteractions.length > 0) {
+      const contract = {
+        id: `${c.dir}/templates:${c.chart.name}-deps`,
+        type: 'HelmDependencies',
+        name: `${c.chart.name} (external deps)`,
+        visibility: 'public',
+        fields: extInteractions.map(i => ({
+          name: i.target,
+          type: i.type,
+        })),
+      };
+      allContracts.push(contract);
+      bySubsystem[sub].push(contract);
+    }
+  }
+
+  return { contracts: allContracts, bySubsystem };
+}
+
 if (require.main === module) {
   const srcRoot = process.argv[2];
   if (!srcRoot) {
@@ -245,4 +337,4 @@ if (require.main === module) {
   }
 }
 
-module.exports = { extractContracts, extractAllContracts, buildContractXref };
+module.exports = { extractContracts, extractAllContracts, buildContractXref, extractHelmContracts };