timonel 2.9.0 → 2.9.2

package/CHANGELOG.md

@@ -1,3 +1,16 @@
+## [2.9.2](https://github.com/KenkoGeek/timonel/compare/v2.9.1...v2.9.2) (2025-09-19)
+
+### Bug Fixes
+
+- **helm:** implement Helm-aware YAML serializer ([#112](https://github.com/KenkoGeek/timonel/issues/112)) ([daf4276](https://github.com/KenkoGeek/timonel/commit/daf427618eea73db832682f6b37287a9176bc31e))
+
+## [2.9.1](https://github.com/KenkoGeek/timonel/compare/v2.9.0...v2.9.1) (2025-09-19)
+
+### Bug Fixes
+
+- **deps:** merge conflict solved [skip ci] ([3422464](https://github.com/KenkoGeek/timonel/commit/3422464ddee4a1408019ba4617b6f8e6f6c8fd12))
+- **deps:** upgrade timonel version [skip ci] ([63901ef](https://github.com/KenkoGeek/timonel/commit/63901ef4277a1ebf702fc55337ed1eb7f6b226ea))
+
 # [2.9.0](https://github.com/KenkoGeek/timonel/compare/v2.8.3...v2.9.0) (2025-09-17)
 
 ### Features

package/README.md

@@ -0,0 +1,109 @@
+# Timonel
+
+[![License: MIT][license-badge]][license-url]
+[![npm version][npm-badge]][npm-url]
+[![Security][security-badge]][security-url]
+[![CodeQL][codeql-badge]][codeql-url]
+[![CI][ci-badge]][ci-url]
+[![pnpm][pnpm-badge]][pnpm-url]
+[![Node.js][node-badge]][node-url]
+[![TypeScript][ts-badge]][ts-url]
+[![Maintained by KenkoGeek][maintained-badge]][maintained-url]
+
+Timonel (Spanish for "helmsman") is a TypeScript library to programmatically generate Helm charts
+using cdk8s. Define Kubernetes resources with classes and synthesize a full Helm chart with
+`Chart.yaml`, `values.yaml`, per‑environment values files, and `templates/`.
+
+## ✨ Key Features
+
+- **Type-safe API** with strict TypeScript and cdk8s constructs.
+- **Flexible resource creation** with built-in methods and `addManifest()` for custom resources.
+- **Multi-environment support** with automatic values files generation.
+- **Umbrella Charts** for managing multiple subcharts as a single unit.
+- **AWS integrations**:
+  - **AWS**: EBS/EFS StorageClass, ALB Ingress, IRSA ServiceAccount.
+- **Security-first approach** with NetworkPolicies and best practices.
+- **Minimal CLI** (`tl`) for scaffolding and chart generation.
+
+## 🚀 Quick Start
+
+```bash
+# Install Timonel globally
+npm install -g timonel
+
+# Create your first chart
+tl init my-app
+
+# Generate Helm chart
+tl synth charts/my-app charts/my-app-dist
+
+# Use with Helm
+helm install my-app charts/my-app-dist
+```
+
+## 📚 Documentation
+
+## 🔧 Troubleshooting
+
+### CDK8s Module Not Found Error
+
+If you get `Error: Cannot find module 'cdk8s'` when running `tl umbrella synth`:
+
+**Problem**: Timonel is installed globally, but your project needs CDK8s dependencies locally.
+
+**Solution**: Create a `package.json` in your project directory:
+
+```json
+{
+  "name": "my-timonel-project",
+  "version": "1.0.0",
+  "type": "module",
+  "dependencies": {
+    "cdk8s": "^2.70.11",
+    "cdk8s-plus-33": "^2.3.5",
+    "constructs": "^10.4.2",
+    "timonel": "^2.9.0"
+  },
+  "devDependencies": {
+    "@types/node": "^24.3.0",
+    "typescript": "^5.9.2"
+  }
+}
+```
+
+Then run:
+
+```bash
+npm install
+tl umbrella synth  # Now it works!
+```
+
+## 🤝 Contributing
+
+See our [Contributing Guide](https://github.com/KenkoGeek/timonel/wiki/Contributing) for development
+setup and guidelines.
+
+## 📄 License
+
+MIT
+
+<!-- Badges -->
+
+[license-badge]: https://img.shields.io/badge/License-MIT-yellow.svg
+[license-url]: https://opensource.org/licenses/MIT
+[npm-badge]: https://img.shields.io/npm/v/timonel.svg
+[npm-url]: https://www.npmjs.com/package/timonel
+[security-badge]: https://img.shields.io/badge/Security-Policy-2ea44f?logo=security&logoColor=fff
+[security-url]: SECURITY.md
+[pnpm-badge]: https://img.shields.io/badge/pm-pnpm-ffd95a?logo=pnpm&logoColor=fff&labelColor=24292e
+[pnpm-url]: https://pnpm.io/
+[node-badge]: https://img.shields.io/badge/node-%3E%3D20-339933?logo=node.js&logoColor=fff
+[node-url]: https://nodejs.org/
+[ts-badge]: https://img.shields.io/badge/TypeScript-5.x-3178C6?logo=typescript&logoColor=fff
+[ts-url]: https://www.typescriptlang.org/
+[maintained-badge]: https://img.shields.io/badge/maintained%20by-KenkoGeek-6C78AF?style=flat
+[maintained-url]: https://github.com/kenkogeek/
+[ci-badge]: https://github.com/KenkoGeek/timonel/actions/workflows/test.yaml/badge.svg?branch=main
+[ci-url]: https://github.com/KenkoGeek/timonel/actions/workflows/teast.yaml
+[codeql-badge]: https://github.com/KenkoGeek/timonel/actions/workflows/codeql.yaml/badge.svg
+[codeql-url]: https://github.com/KenkoGeek/timonel/actions/workflows/codeql.yaml

package/dist/cli.js

@@ -13,42 +13,50 @@ function log(msg, silent = false) {
         console.log(msg);
     }
 }
-function usageAndExit(msg) {
+function logError(msg, silent = false) {
+    if (!silent) {
+        console.error(msg);
+    }
+}
+function usageAndExit(msg, silent = false) {
     if (msg) {
-        console.error(`Error: ${msg}`);
-    }
-    console.log([
-        'Usage: tl <command> [options]',
-        '',
-        'Commands:',
-        '  tl init <chart-name>              Create new chart',
-        '  tl synth [outDir]                 Generate Helm chart',
-        '  tl validate                       Validate chart',
-        '  tl deploy <release> [namespace]   Deploy chart',
-        '  tl templates                      List available templates',
-        '',
-        'Umbrella Charts:',
-        '  tl umbrella init <n>              Create umbrella chart structure',
-        '  tl umbrella add <subchart>           Add subchart to umbrella',
-        '  tl umbrella synth [outDir]           Generate umbrella chart',
-        '',
-        'Flags:',
-        '  --dry-run                            Show what would be done without executing',
-        '  --silent                             Suppress output (useful for CI)',
-        '  --env <environment>                  Use environment-specific values',
-        '  --set <key=value>                    Override values (can be used multiple times)',
-        '  --version, -v                        Show version information',
-        '  --help, -h                           Show this help message',
-        '',
-        'Examples:',
-        '  tl init my-app',
-        '  tl synth my-app my-app/dist',
-        '  tl validate my-app',
-        '  tl deploy my-app my-release --env prod',
-        '  tl synth my-app --dry-run --silent',
-        '  tl synth my-app --set replicas=5 --set image.tag=v2.0.0',
-        '  tl deploy my-app my-release --set service.port=8080',
-    ].join('\n'));
+        logError(`Error: ${msg}`, silent);
+    }
+    if (!silent) {
+        console.log([
+            'Usage: tl <command> [options]',
+            '',
+            'Commands:',
+            '  tl init <chart-name>              Create new chart',
+            '  tl synth [outDir]                 Generate Helm chart',
+            '  tl validate                       Validate chart',
+            '  tl deploy <release> [namespace]   Deploy chart',
+            '  tl templates                      List available templates',
+            '  tl help                           Show this help message',
+            '',
+            'Umbrella Charts:',
+            '  tl umbrella init <n>              Create umbrella chart structure',
+            '  tl umbrella add <subchart>           Add subchart to umbrella',
+            '  tl umbrella synth [outDir]           Generate umbrella chart',
+            '',
+            'Flags:',
+            '  --dry-run                            Show what would be done without executing',
+            '  --silent                             Suppress output (useful for CI)',
+            '  --env <environment>                  Use environment-specific values',
+            '  --set <key=value>                    Override values (can be used multiple times)',
+            '  --help, -h                           Show this help message',
+            '  --version, -v                        Show version information',
+            '',
+            'Examples:',
+            '  tl init my-app',
+            '  tl synth my-app my-app/dist',
+            '  tl validate my-app',
+            '  tl deploy my-app my-release --env prod',
+            '  tl synth --dry-run --silent',
+            '  tl synth --set replicas=5 --set image.tag=v2.0.0',
+            '  tl deploy my-app my-release --set service.port=8080',
+        ].join('\n'));
+    }
     process.exit(msg ? 1 : 0);
 }
 async function cmdInit(name, silent = false) {
@@ -166,14 +174,13 @@ async function cmdTemplates(flags) {
         },
     ];
     if (flags?.silent) {
-        console.log(JSON.stringify(templates));
+        console.log(JSON.stringify(templates, null, 2));
     }
     else {
         console.log('Available templates:');
         templates.forEach((t) => {
-            console.log(`\n${t.name}`);
-            console.log(`  Description: ${t.description}`);
-            console.log(`  Usage: ${t.usage}`);
+            console.log(`  ${t.name.padEnd(15)} - ${t.description}`);
+            console.log(`  ${''.padEnd(15)}   Usage: ${t.usage}`);
         });
     }
 }
@@ -389,15 +396,17 @@ function parseFlags(args) {
             }
             case '--version':
             case '-v':
-                console.log('Timonel v0.1.0');
+                if (!flags.silent) {
+                    console.log('Timonel v0.1.0');
+                }
                 process.exit(0);
                 break;
             case '--help':
             case '-h':
-                usageAndExit();
+                usageAndExit(undefined, flags.silent);
                 break;
             default:
-                usageAndExit(`Unknown flag: ${flag}`);
+                usageAndExit(`Unknown flag: ${flag}`, flags.silent);
         }
     }
     return flags;
@@ -422,20 +431,35 @@ async function executeCommand(command, args, flags) {
         case 'umbrella':
             await cmdUmbrella(args[0], args.slice(1), flags);
             break;
+        case 'help':
         case undefined:
-            usageAndExit('Missing command');
+            usageAndExit(undefined, flags.silent);
             break;
         default:
-            usageAndExit(`Unknown command: ${command}`);
+            usageAndExit(`Unknown command: ${command}`, flags.silent);
     }
 }
 async function main() {
     const args = process.argv.slice(2);
+    const isSilent = args.includes('--silent');
+    if (args.includes('--help') || args.includes('-h')) {
+        usageAndExit(undefined, isSilent);
+        return;
+    }
+    if (args.includes('--version') || args.includes('-v')) {
+        if (!isSilent) {
+            console.log('Timonel v0.1.0');
+        }
+        process.exit(0);
+    }
     const command = args.shift();
     const flags = parseFlags(args);
     await executeCommand(command, args, flags);
 }
 main().catch((error) => {
-    console.error('Error:', error.message);
+    const flags = parseFlags(process.argv.slice(2));
+    if (!flags.silent) {
+        console.error('Error:', error.message);
+    }
     process.exit(1);
 });

package/dist/lib/helmChartWriter.js

@@ -1,31 +1,27 @@
 import * as fs from 'fs';
 import * as path from 'path';
-import YAML from 'yaml';
 import { SecurityUtils } from './security.js';
+import { dumpHelmAwareYaml } from './utils/helmYamlSerializer.js';
 export class HelmChartWriter {
     static write(opts) {
         const { outDir, meta, defaultValues = {}, envValues = {}, assets, helpersTpl, notesTpl, valuesSchema, } = opts;
+        console.log(`📝 Writing Helm chart: ${meta.name} v${meta.version} to ${outDir}`);
         const validatedOutDir = SecurityUtils.validatePath(outDir, process.cwd());
-        console.log('📝 Validated outDir:', validatedOutDir);
         this.createDirectories(validatedOutDir);
-        console.log('📝 Directories created');
         this.writeChartYaml(validatedOutDir, meta);
-        console.log('📝 Chart.yaml written');
         this.writeValuesFiles(validatedOutDir, defaultValues, envValues);
-        console.log('📝 Values files written');
         this.writeAssets(validatedOutDir, assets);
-        console.log('📝 Assets written');
         this.writeHelpers(validatedOutDir, helpersTpl);
         this.writeNotes(validatedOutDir, notesTpl);
         this.writeSchema(validatedOutDir, valuesSchema);
         this.writeHelmIgnore(validatedOutDir);
-        console.log('📝 HelmChartWriter.write completed');
+        console.log(`✅ Helm chart written successfully to ${validatedOutDir}`);
     }
     static createDirectories(outDir) {
         fs.mkdirSync(path.join(outDir, 'templates'), { recursive: true });
     }
     static writeChartYaml(outDir, meta) {
-        const chartYaml = YAML.stringify({
+        const chartYaml = dumpHelmAwareYaml({
             apiVersion: 'v2',
             name: meta.name,
             version: meta.version,
@@ -43,10 +39,10 @@ export class HelmChartWriter {
         fs.writeFileSync(path.join(outDir, 'Chart.yaml'), chartYaml);
     }
     static writeValuesFiles(outDir, defaultValues, envValues) {
-        fs.writeFileSync(path.join(outDir, 'values.yaml'), YAML.stringify(defaultValues));
+        fs.writeFileSync(path.join(outDir, 'values.yaml'), dumpHelmAwareYaml(defaultValues));
         for (const [env, values] of Object.entries(envValues)) {
             const sanitizedEnv = SecurityUtils.sanitizeEnvironmentName(env);
-            fs.writeFileSync(path.join(outDir, `values-${sanitizedEnv}.yaml`), YAML.stringify(values));
+            fs.writeFileSync(path.join(outDir, `values-${sanitizedEnv}.yaml`), dumpHelmAwareYaml(values));
         }
     }
     static writeAssets(outDir, assets) {
@@ -112,25 +108,24 @@ function splitDocs(yamlStr) {
         .filter((p) => p.length);
 }
 function writeAssets(outDir, assets) {
-    console.log('🔍 writeAssets called with', assets.length, 'assets');
     for (const asset of assets) {
         const sanitizedId = asset.id.replace(/[^a-zA-Z0-9-_]/g, '');
         if (sanitizedId !== asset.id) {
+            console.error(`❌ Invalid asset ID detected: ${SecurityUtils.sanitizeLogMessage(asset.id)}`);
             throw new Error(`Invalid asset ID: ${SecurityUtils.sanitizeLogMessage(asset.id)}`);
         }
         const targetDir = getTargetDirectory(asset.target);
-        console.log(`🔍 Processing asset: ${asset.id} -> ${sanitizedId}, singleFile: ${asset.singleFile}, target: ${asset.target}`);
-        if (asset.id === 'ingress') {
-            console.log('🔍 Ingress asset YAML preview:', asset.yaml.substring(0, 200));
-            if (asset.yaml.includes('number:')) {
-                console.log('🔍 Ingress contains number field:', asset.yaml.split('\n').filter((line) => line.includes('number:')));
+        try {
+            if (asset.singleFile) {
+                writeSingleAssetFile(outDir, targetDir, sanitizedId, asset.yaml);
+            }
+            else {
+                writeMultipleAssetFiles(outDir, targetDir, sanitizedId, asset.yaml);
             }
         }
-        if (asset.singleFile) {
-            writeSingleAssetFile(outDir, targetDir, sanitizedId, asset.yaml);
-        }
-        else {
-            writeMultipleAssetFiles(outDir, targetDir, sanitizedId, asset.yaml);
+        catch (error) {
+            console.error(`❌ Failed to write asset ${asset.id}:`, error);
+            throw error;
         }
     }
 }

package/dist/lib/rutter.js

@@ -1,14 +1,15 @@
 import { ApiObject, App, Chart, Testing } from 'cdk8s';
-import Handlebars from 'handlebars';
-import YAML from 'yaml';
-import { helm, include } from './helm.js';
+import * as jsYaml from 'js-yaml';
+import { include } from './helm.js';
 import { HelmChartWriter } from './helmChartWriter.js';
+import { dumpHelmAwareYaml } from './utils/helmYamlSerializer.js';
 import { AWSResources } from './resources/cloud/aws/awsResources.js';
 import { KarpenterResources } from './resources/cloud/aws/karpenterResources.js';
 import { generateHelpersTemplate } from './utils/helmHelpers.js';
 export class Rutter {
     constructor(props) {
         this.assets = [];
+        console.log(`🚀 Initializing Rutter chart: ${props.meta.name} v${props.meta.version}`);
         this.defaultValues = props.defaultValues ?? {};
         this.envValues = props.envValues ?? {};
         this.meta = props.meta;
@@ -55,7 +56,7 @@ export class Rutter {
         let manifestObject;
         if (typeof yamlOrObject === 'string') {
             try {
-                manifestObject = YAML.parse(yamlOrObject);
+                manifestObject = jsYaml.load(yamlOrObject);
             }
             catch (error) {
                 throw new Error(`Invalid YAML provided to addManifest(): ${error instanceof Error ? error.message : 'Unknown error'}`);
@@ -101,20 +102,12 @@ export class Rutter {
             helmCondition = `.Values.${condition}`;
         }
         try {
-            const yamlContent = YAML.stringify(manifestObject, {
+            const yamlContent = dumpHelmAwareYaml(manifestObject, {
                 lineWidth: 0,
-                doubleQuotedAsJSON: false,
-                simpleKeys: true,
-            });
-            const conditionalTemplate = `\\{{- if ${helmCondition} }}
-{{{manifestYaml}}}
-\\{{- end }}`;
-            const template = Handlebars.compile(conditionalTemplate, {
-                noEscape: true,
-            });
-            const conditionalYaml = template({
-                manifestYaml: yamlContent.trim(),
             });
+            const conditionalYaml = `{{- if ${helmCondition} }}
+${yamlContent.trim()}
+{{- end }}`;
             const conditionalAsset = {
                 id,
                 yaml: conditionalYaml,
@@ -123,7 +116,7 @@ export class Rutter {
             this.assets.push(conditionalAsset);
         }
         catch (error) {
-            throw new Error(`Failed to compile Handlebars template for manifest '${id}': ${error instanceof Error ? error.message : 'Unknown error'}`);
+            throw new Error(`Failed to generate conditional template for manifest '${id}': ${error instanceof Error ? error.message : 'Unknown error'}`);
         }
         return new ApiObject(this.chart, `${id}-placeholder`, {
             apiVersion: manifestObject['apiVersion'],
@@ -140,33 +133,26 @@ export class Rutter {
         });
     }
     validateManifestStructure(manifest) {
-        if (!manifest['apiVersion'] || typeof manifest['apiVersion'] !== 'string') {
-            throw new Error('Kubernetes manifest must have a valid apiVersion');
+        if (!manifest.apiVersion) {
+            console.error('❌ Manifest validation failed: Missing apiVersion');
+            throw new Error('Manifest must have an apiVersion');
         }
-        if (!manifest['kind'] || typeof manifest['kind'] !== 'string') {
-            throw new Error('Kubernetes manifest must have a valid kind');
+        if (!manifest.kind) {
+            console.error('❌ Manifest validation failed: Missing kind');
+            throw new Error('Manifest must have a kind');
         }
-        if (!manifest['metadata'] ||
-            typeof manifest['metadata'] !== 'object' ||
-            manifest['metadata'] === null) {
-            throw new Error('Kubernetes manifest must have valid metadata');
+        if (!manifest.metadata) {
+            console.error('❌ Manifest validation failed: Missing metadata');
+            throw new Error('Manifest must have metadata');
         }
-        const metadata = manifest['metadata'];
-        if (!metadata['name'] || typeof metadata['name'] !== 'string') {
-            throw new Error('Kubernetes manifest metadata must have a valid name');
+        const metadata = manifest.metadata;
+        if (!metadata.name) {
+            console.error('❌ Manifest validation failed: Missing metadata.name');
+            throw new Error('Manifest metadata must have a name');
         }
-        const kind = manifest['kind'];
-        if (kind === 'CustomResourceDefinition') {
-            if (!manifest['spec'] || typeof manifest['spec'] !== 'object' || manifest['spec'] === null) {
-                throw new Error('CustomResourceDefinition must have a valid spec');
-            }
-            const spec = manifest['spec'];
-            if (!spec['group'] || typeof spec['group'] !== 'string') {
-                throw new Error('CustomResourceDefinition spec must have a valid group');
-            }
-            if (!Array.isArray(spec['versions']) || spec['versions'].length === 0) {
-                throw new Error('CustomResourceDefinition must have at least one version in spec.versions');
-            }
+        if (typeof metadata.name !== 'string') {
+            console.error('❌ Manifest validation failed: metadata.name must be a string');
+            throw new Error('Manifest metadata.name must be a string');
         }
     }
     getMeta() {
@@ -182,7 +168,7 @@ export class Rutter {
         return [...this.assets];
     }
     toSynthArray() {
-        console.log('🔍 toSynthArray called');
+        console.log(`📦 Synthesizing chart assets for: ${this.meta.name}`);
         const apiObjectIds = [];
         for (const child of this.chart.node.children) {
             if (child instanceof ApiObject && !child.node.id.endsWith('-placeholder')) {
@@ -198,6 +184,7 @@ export class Rutter {
             }
             return true;
         });
+        console.log(`📋 Found ${manifestObjs.length} manifest objects to process`);
         const enriched = manifestObjs.map((obj) => {
             if (obj && typeof obj === 'object') {
                 const o = obj;
@@ -205,12 +192,12 @@ export class Rutter {
                 o.metadata.labels = o.metadata.labels ?? {};
                 const labels = o.metadata.labels;
                 const defaults = {
-                    'helm.sh/chart': '{{ .Chart.Name }}-{{ .Chart.Version }}',
-                    'app.kubernetes.io/name': include(Rutter.HELPER_NAME),
-                    'app.kubernetes.io/instance': helm.releaseName,
-                    'app.kubernetes.io/version': helm.chartVersion,
+                    'helm.sh/chart': `{{ .Chart.Name }}-{{ .Chart.Version }}`,
+                    'app.kubernetes.io/name': `{{ ${include} "${Rutter.HELPER_NAME}" . }}`,
+                    'app.kubernetes.io/instance': '{{ .Release.Name }}',
+                    'app.kubernetes.io/version': '{{ .Chart.Version }}',
                     'app.kubernetes.io/managed-by': '{{ .Release.Service }}',
-                    'app.kubernetes.io/part-of': helm.chartName,
+                    'app.kubernetes.io/part-of': '{{ .Chart.Name }}',
                 };
                 for (const [key, value] of Object.entries(defaults)) {
                     if (!(key in labels)) {
@@ -221,10 +208,9 @@ export class Rutter {
             return obj;
         });
         const synthAssets = [];
-        console.log('🔍 singleManifestFile:', this.props.singleManifestFile);
         if (this.props.singleManifestFile) {
             const combinedYaml = enriched
-                .map((obj) => this.processHelmTemplates(YAML.stringify(obj).trim()))
+                .map((obj) => this.processHelmTemplates(dumpHelmAwareYaml(obj).trim()))
                 .filter(Boolean)
                 .join('\n---\n');
             const manifestId = this.props.manifestPrefix ?? 'manifests';
@@ -234,8 +220,7 @@ export class Rutter {
             enriched.forEach((obj, index) => {
                 const apiObjectId = apiObjectIds[index];
                 const manifestId = apiObjectId || `manifest-${index + 1}`;
-                console.log(`🔍 Processing asset ${manifestId} (index ${index})`);
-                const yaml = this.processHelmTemplates(YAML.stringify(obj).trim());
+                const yaml = this.processHelmTemplates(dumpHelmAwareYaml(obj).trim());
                 if (yaml) {
                     synthAssets.push({ id: manifestId, yaml });
                 }
@@ -247,15 +232,8 @@ export class Rutter {
         return synthAssets;
     }
     processHelmTemplates(yaml) {
-        console.log('🔍 processHelmTemplates called with YAML length:', yaml.length);
-        if (yaml.includes('{{ .Values.port }}')) {
-            console.log('🎯 Found YAML with port template:');
-            const portIndex = yaml.indexOf('{{ .Values.port }}');
-            console.log(yaml.substring(Math.max(0, portIndex - 50), portIndex + 100));
-        }
         let processed = this.fixCharacterMappingIssues(yaml);
         processed = this.applyHelmTemplateReplacements(processed);
-        console.log('✅ processHelmTemplates completed');
         return processed;
     }
     fixCharacterMappingIssues(yaml) {
@@ -317,38 +295,11 @@ export class Rutter {
         return { nextIndex: j };
     }
     applyHelmTemplateReplacements(processed) {
-        processed = this.fixIncludeStatements(processed);
-        processed = this.fixFunctionCalls(processed);
-        processed = this.fixChartReferences(processed);
-        processed = this.removeHelmExpressionQuotes(processed);
-        if (processed.includes('number:')) {
-            console.log('DEBUG: Before fixConditionalBlocks:', processed.split('\n').filter((line) => line.includes('number:')));
-        }
         processed = this.fixConditionalBlocks(processed);
-        if (processed.includes('number:')) {
-            console.log('DEBUG: After fixConditionalBlocks:', processed.split('\n').filter((line) => line.includes('number:')));
-        }
-        if (processed.includes('number:')) {
-            console.log('DEBUG: Before fixPipeExpressions:', processed.split('\n').filter((line) => line.includes('number:')));
-        }
         processed = this.fixPipeExpressions(processed);
-        if (processed.includes('number:')) {
-            console.log('DEBUG: After fixPipeExpressions:', processed.split('\n').filter((line) => line.includes('number:')));
-        }
-        if (processed.includes('number:')) {
-            console.log('DEBUG: Before fixNestedQuotes:', processed.split('\n').filter((line) => line.includes('number:')));
-        }
         processed = this.fixNestedQuotes(processed);
-        if (processed.includes('number:')) {
-            console.log('DEBUG: After fixNestedQuotes:', processed.split('\n').filter((line) => line.includes('number:')));
-        }
-        if (processed.includes('number:')) {
-            console.log('DEBUG: Before cleanupArtifacts:', processed.split('\n').filter((line) => line.includes('number:')));
-        }
         processed = this.cleanupArtifacts(processed);
-        if (processed.includes('number:')) {
-            console.log('DEBUG: After cleanupArtifacts:', processed.split('\n').filter((line) => line.includes('number:')));
-        }
+        processed = this.removeHelmExpressionQuotes(processed);
         return processed;
     }
     fixIncludeStatements(processed) {
@@ -364,10 +315,6 @@ export class Rutter {
     }
     removeHelmExpressionQuotes(processed) {
         const HELM_EXPRESSION_REPLACEMENT = '$1$2: {{$3}}';
-        console.log('🔧 removeHelmExpressionQuotes called');
-        if (processed.includes('number:')) {
-            console.log('DEBUG: removeHelmExpressionQuotes input contains number:', processed.split('\n').filter((line) => line.includes('number:')));
-        }
         processed = processed.replace(/^(\s*)([^:\s]+):\s*"\{\{([^}]*\|\s*(?:int|float|bool|number)[^}]*)\}\}"/gm, HELM_EXPRESSION_REPLACEMENT);
         processed = processed.replace(/^(\s*)(port):\s*"\{\{([^}]*)\}\}"/gm, HELM_EXPRESSION_REPLACEMENT);
         processed = processed.replace(/^(\s*)(port\.number):\s*"\{\{([^}]*)\}\}"/gm, HELM_EXPRESSION_REPLACEMENT);
@@ -375,23 +322,7 @@ export class Rutter {
         processed = processed.replace(/^(\s*)(backend\.service\.port\.number):\s*"\{\{([^}]*)\}\}"/gm, HELM_EXPRESSION_REPLACEMENT);
         processed = processed.replace(/^(\s*)(spec\.port):\s*"\{\{([^}]*)\}\}"/gm, HELM_EXPRESSION_REPLACEMENT);
         processed = processed.replace(/^(\s*)([^:\s]*\.number):\s*"\{\{([^}]*)\}\}"/gm, HELM_EXPRESSION_REPLACEMENT);
-        const numberMatches = processed.match(/^(\s*)(number):\s*"\{\{([^}]*)\}\}"/gm);
-        if (numberMatches) {
-            console.log('DEBUG: Found number pattern matches:', numberMatches);
-        }
-        else {
-            const anyNumberFields = processed.match(/number:\s*"[^"]*"/gm);
-            if (anyNumberFields) {
-                console.log('DEBUG: Found number fields but regex did not match:', anyNumberFields);
-                const lines = processed.split('\n');
-                const numberLines = lines.filter((line) => line.includes('number:'));
-                console.log('DEBUG: Number field lines:', numberLines);
-            }
-        }
         processed = processed.replace(/^(\s*)(number):\s*"\{\{([^}]*)\}\}"/gm, HELM_EXPRESSION_REPLACEMENT);
-        if (processed.includes('number:')) {
-            console.log('DEBUG: removeHelmExpressionQuotes after number replacement:', processed.split('\n').filter((line) => line.includes('number:')));
-        }
         processed = processed.replace(/^(\s*)(replicas):\s*"\{\{([^}]*)\}\}"/gm, HELM_EXPRESSION_REPLACEMENT);
         processed = processed.replace(/^(\s*)(targetPort):\s*"\{\{([^}]*)\}\}"/gm, HELM_EXPRESSION_REPLACEMENT);
         processed = processed.replace(/^(\s*)(nodePort):\s*"\{\{([^}]*)\}\}"/gm, HELM_EXPRESSION_REPLACEMENT);
@@ -468,8 +399,7 @@ export class Rutter {
         return processed;
     }
     write(outDir) {
-        console.log('🚀 Rutter.write called with outDir:', outDir);
-        console.log('📊 Assets count:', this.assets.length);
+        console.log(`✍️  Writing Helm chart '${this.meta.name}' to: ${outDir}`);
         let helpersContent;
         if (this.props.helpersTpl) {
             if (typeof this.props.helpersTpl === 'string') {
@@ -490,7 +420,7 @@ ${helper.template}
             helpersContent = generateHelpersTemplate(this.props.cloudProvider);
         }
         const synthAssets = this.toSynthArray();
-        console.log('📦 Generated synth assets:', synthAssets.length);
+        console.log(`📄 Generated ${synthAssets.length} assets for chart`);
         HelmChartWriter.write({
             outDir,
             meta: this.meta,
@@ -499,7 +429,7 @@ ${helper.template}
             assets: synthAssets,
             helpersTpl: helpersContent,
         });
-        console.log('✅ Rutter.write completed');
+        console.log(`✅ Helm chart '${this.meta.name}' written successfully`);
     }
 }
 Rutter.HELPER_NAME = 'chart.name';

package/dist/lib/templates/basic-chart.js

@@ -1,5 +1,6 @@
 import { Chart, ApiObject } from 'cdk8s';
 import { Rutter } from '../rutter.js';
+import { generateHelpersTemplate } from '../utils/helmHelpers.js';
 export class BasicChart extends Chart {
     constructor(scope, id, props = {}) {
         super(scope, id, props);
@@ -24,6 +25,10 @@ export class BasicChart extends Chart {
                 replicas,
                 createNamespace,
             },
+            helpersTpl: generateHelpersTemplate('aws', undefined, {
+                includeKubernetes: true,
+                includeSprig: true,
+            }),
         });
         if (createNamespace) {
             this.rutter.addConditionalManifest({
@@ -41,6 +46,11 @@ export class BasicChart extends Chart {
                 name: `{{ .Values.appName }}`,
                 labels: {
                     app: `{{ .Values.appName }}`,
+                    'helm.sh/chart': `{{ .Chart.Name }}-{{ .Chart.Version }}`,
+                    'app.kubernetes.io/name': `{{ .Chart.Name }}`,
+                    'app.kubernetes.io/instance': `{{ .Release.Name }}`,
+                    'app.kubernetes.io/version': `{{ .Chart.AppVersion }}`,
+                    'app.kubernetes.io/managed-by': `{{ .Release.Service }}`,
                 },
             },
             spec: {
@@ -48,12 +58,16 @@ export class BasicChart extends Chart {
                 selector: {
                     matchLabels: {
                         app: `{{ .Values.appName }}`,
+                        'app.kubernetes.io/name': `{{ .Chart.Name }}`,
+                        'app.kubernetes.io/instance': `{{ .Release.Name }}`,
                     },
                 },
                 template: {
                     metadata: {
                         labels: {
                             app: `{{ .Values.appName }}`,
+                            'app.kubernetes.io/name': `{{ .Chart.Name }}`,
+                            'app.kubernetes.io/instance': `{{ .Release.Name }}`,
                         },
                     },
                     spec: {
@@ -79,6 +93,11 @@ export class BasicChart extends Chart {
                 name: `{{ .Values.appName }}`,
                 labels: {
                     app: `{{ .Values.appName }}`,
+                    'helm.sh/chart': `{{ .Chart.Name }}-{{ .Chart.Version }}`,
+                    'app.kubernetes.io/name': `{{ .Chart.Name }}`,
+                    'app.kubernetes.io/instance': `{{ .Release.Name }}`,
+                    'app.kubernetes.io/version': `{{ .Chart.AppVersion }}`,
+                    'app.kubernetes.io/managed-by': `{{ .Release.Service }}`,
                 },
             },
             spec: {
@@ -90,6 +109,8 @@ export class BasicChart extends Chart {
                 ],
                 selector: {
                     app: `{{ .Values.appName }}`,
+                    'app.kubernetes.io/name': `{{ .Chart.Name }}`,
+                    'app.kubernetes.io/instance': `{{ .Release.Name }}`,
                 },
             },
         }, 'service');

package/dist/lib/templates/subchart.js

@@ -1,5 +1,6 @@
 import { App, Chart } from 'cdk8s';
 import { Rutter } from '../rutter.js';
+import { generateHelpersTemplate } from '../utils/helmHelpers.js';
 export class Subchart extends Chart {
     constructor(scope, id, props = {}) {
         super(scope, id, props);
@@ -39,6 +40,10 @@ export class Subchart extends Chart {
                     tls: [],
                 },
             },
+            helpersTpl: generateHelpersTemplate('aws', undefined, {
+                includeKubernetes: true,
+                includeSprig: true,
+            }),
         });
         this.rutter.addManifest({
             apiVersion: 'v1',
@@ -131,63 +136,53 @@ export class Subchart extends Chart {
                 },
             },
         }, 'service');
-        this.rutter.addTemplateManifest(`{{- if .Values.enableIngress }}
-apiVersion: networking.k8s.io/v1
-kind: Ingress
-metadata:
-  name: {{ include "chart.fullname" . }}
-  labels:
-    {{- include "chart.labels" . | nindent 4 }}
-  {{- with .Values.ingress.annotations }}
-  annotations:
-    {{- toYaml . | nindent 4 }}
-  {{- end }}
-spec:
-  {{- if and .Values.ingress.className (not (hasKey .Values.ingress.annotations "kubernetes.io/ingress.class")) }}
-  ingressClassName: {{ .Values.ingress.className }}
-  {{- end }}
-  {{- if .Values.ingress.tls }}
-  tls:
-    {{- range .Values.ingress.tls }}
-    - hosts:
-        {{- range .hosts }}
-        - {{ . | quote }}
-        {{- end }}
-      secretName: {{ .secretName }}
-    {{- end }}
-  {{- end }}
-  rules:
-    {{- range .Values.ingress.hosts }}
-    - host: {{ .host | quote }}
-      http:
-        paths:
-          {{- range .paths }}
-          - path: {{ .path }}
-            {{- if and .pathType (semverCompare ">=1.18-0" $.Capabilities.KubeVersion.GitVersion) }}
-            pathType: {{ .pathType }}
-            {{- end }}
-            backend:
-              {{- if semverCompare ">=1.19-0" $.Capabilities.KubeVersion.GitVersion }}
-              service:
-                name: {{ include "chart.fullname" $ }}
-                port:
-                  number: {{ $.Values.port | int }}
-              {{- else }}
-              serviceName: {{ include "chart.fullname" $ }}
-              servicePort: {{ $.Values.port | int }}
-              {{- end }}
-          {{- end }}
-    {{- end }}
-{{- end }}`, 'ingress');
+        this.rutter.addConditionalManifest({
+            apiVersion: 'networking.k8s.io/v1',
+            kind: 'Ingress',
+            metadata: {
+                name: `{{ .Release.Name }}-{{ .Values.appName }}`,
+                labels: {
+                    app: `{{ .Values.appName }}`,
+                    'helm.sh/chart': `{{ .Chart.Name }}-{{ .Chart.Version }}`,
+                    'app.kubernetes.io/name': `{{ .Chart.Name }}`,
+                    'app.kubernetes.io/instance': `{{ .Release.Name }}`,
+                    'app.kubernetes.io/version': `{{ .Chart.AppVersion }}`,
+                    'app.kubernetes.io/managed-by': `{{ .Release.Service }}`,
+                },
+                annotations: `{{ toYaml .Values.ingress.annotations | nindent 4 }}`,
+            },
+            spec: {
+                ingressClassName: `{{ .Values.ingress.className }}`,
+                tls: `{{ toYaml .Values.ingress.tls | nindent 4 }}`,
+                rules: [
+                    {
+                        host: `{{ .Values.ingressHost }}`,
+                        http: {
+                            paths: [
+                                {
+                                    path: '/',
+                                    pathType: 'Prefix',
+                                    backend: {
+                                        service: {
+                                            name: `{{ .Release.Name }}-{{ .Values.appName }}`,
+                                            port: {
+                                                number: `{{ .Values.port }}`,
+                                            },
+                                        },
+                                    },
+                                },
+                            ],
+                        },
+                    },
+                ],
+            },
+        }, 'enableIngress', 'ingress');
     }
     get rutterInstance() {
         return this.rutter;
     }
     writeHelmChart(outDir) {
-        console.log('🔧 Subchart.writeHelmChart called with outDir:', outDir);
-        console.log('🔧 Rutter instance exists:', !!this.rutter);
         this.rutter.write(outDir);
-        console.log('🔧 Subchart.writeHelmChart completed');
     }
 }
 export function generateSubchart(props = {}, outDir = 'dist') {

package/dist/lib/templates/umbrella-chart.js

@@ -1,7 +1,8 @@
 import { writeFileSync, mkdirSync, existsSync } from 'fs';
 import { join } from 'path';
 import { Chart, ApiObject } from 'cdk8s';
-import YAML from 'yaml';
+import { dumpHelmAwareYaml } from '../utils/helmYamlSerializer.js';
+import { generateHelpersTemplate } from '../utils/helmHelpers.js';
 export function generateUmbrellaChart(name) {
     return `import { App } from 'cdk8s';
 import { UmbrellaChart } from 'timonel';
@@ -110,7 +111,7 @@ export class UmbrellaChartTemplate extends Chart {
                 repository: 'file://./charts/' + subchart.name,
             })) || [],
         };
-        writeFileSync(join(outputDir, 'Chart.yaml'), YAML.stringify(chartYaml));
+        writeFileSync(join(outputDir, 'Chart.yaml'), dumpHelmAwareYaml(chartYaml));
         const valuesYaml = {
             global: {
                 namespace: this.config.name,
@@ -122,7 +123,7 @@ export class UmbrellaChartTemplate extends Chart {
                 },
             ]) || []),
         };
-        writeFileSync(join(outputDir, 'values.yaml'), YAML.stringify(valuesYaml));
+        writeFileSync(join(outputDir, 'values.yaml'), dumpHelmAwareYaml(valuesYaml));
         const chartsDir = join(outputDir, 'charts');
         if (!existsSync(chartsDir)) {
             mkdirSync(chartsDir, { recursive: true });
@@ -159,64 +160,18 @@ export class UmbrellaChartTemplate extends Chart {
             metadata: {
                 name: '{{ .Values.global.namespace | default .Release.Name }}',
                 labels: {
-                    'app.kubernetes.io/name': '{{ include "chart.name" . }}',
+                    'app.kubernetes.io/name': '{{ .Chart.Name }}',
                     'app.kubernetes.io/instance': '{{ .Release.Name }}',
                     'app.kubernetes.io/version': '{{ .Chart.AppVersion }}',
                     'app.kubernetes.io/managed-by': '{{ .Release.Service }}',
                 },
             },
         };
-        writeFileSync(join(templatesDir, 'namespace.yaml'), YAML.stringify(namespaceYaml));
-        const helpersTpl = `{{/*
-Expand the name of the chart.
-*/}}
-{{- define "chart.name" -}}
-{{- default .Chart.Name .Values.nameOverride | trunc 63 | trimSuffix "-" }}
-{{- end }}
-
-{{/*
-Create a default fully qualified app name.
-*/}}
-{{- define "chart.fullname" -}}
-{{- if .Values.fullnameOverride }}
-{{- .Values.fullnameOverride | trunc 63 | trimSuffix "-" }}
-{{- else }}
-{{- $name := default .Chart.Name .Values.nameOverride }}
-{{- if contains $name .Release.Name }}
-{{- .Release.Name | trunc 63 | trimSuffix "-" }}
-{{- else }}
-{{- printf "%s-%s" .Release.Name $name | trunc 63 | trimSuffix "-" }}
-{{- end }}
-{{- end }}
-{{- end }}
-
-{{/*
-Create chart name and version as used by the chart label.
-*/}}
-{{- define "chart.chart" -}}
-{{- printf "%s-%s" .Chart.Name .Chart.Version | replace "+" "_" | trunc 63 | trimSuffix "-" }}
-{{- end }}
-
-{{/*
-Common labels
-*/}}
-{{- define "chart.labels" -}}
-helm.sh/chart: {{ include "chart.chart" . }}
-{{ include "chart.selectorLabels" . }}
-{{- if .Chart.AppVersion }}
-app.kubernetes.io/version: {{ .Chart.AppVersion | quote }}
-{{- end }}
-app.kubernetes.io/managed-by: {{ .Release.Service }}
-{{- end }}
-
-{{/*
-Selector labels
-*/}}
-{{- define "chart.selectorLabels" -}}
-app.kubernetes.io/name: {{ include "chart.name" . }}
-app.kubernetes.io/instance: {{ .Release.Name }}
-{{- end }}
-`;
+        writeFileSync(join(templatesDir, 'namespace.yaml'), dumpHelmAwareYaml(namespaceYaml));
+        const helpersTpl = generateHelpersTemplate('aws', undefined, {
+            includeKubernetes: true,
+            includeSprig: true,
+        });
         writeFileSync(join(templatesDir, '_helpers.tpl'), helpersTpl);
     }
 }

package/dist/lib/umbrellaRutter.js

@@ -1,7 +1,7 @@
 import { writeFileSync, mkdirSync } from 'fs';
 import { join } from 'path';
-import YAML from 'yaml';
 import { SecurityUtils } from './security.js';
+import { dumpHelmAwareYaml } from './utils/helmYamlSerializer.js';
 export class UmbrellaRutter {
     constructor(props) {
         this.validateMetadata(props.meta);
@@ -54,7 +54,7 @@ export class UmbrellaRutter {
                 };
             }),
         };
-        writeFileSync(join(outDir, 'Chart.yaml'), YAML.stringify(chartYaml));
+        writeFileSync(join(outDir, 'Chart.yaml'), dumpHelmAwareYaml(chartYaml));
     }
     writeParentValues(outDir) {
         const values = {
@@ -68,12 +68,12 @@ export class UmbrellaRutter {
                 };
             }
         }
-        writeFileSync(join(outDir, 'values.yaml'), YAML.stringify(values));
+        writeFileSync(join(outDir, 'values.yaml'), dumpHelmAwareYaml(values));
         if (this.props.envValues) {
             for (const [env, envVals] of Object.entries(this.props.envValues)) {
                 const sanitizedEnv = SecurityUtils.sanitizeEnvironmentName(env);
                 const envValues = this.deepMerge(values, envVals);
-                writeFileSync(join(outDir, `values-${sanitizedEnv}.yaml`), YAML.stringify(envValues));
+                writeFileSync(join(outDir, `values-${sanitizedEnv}.yaml`), dumpHelmAwareYaml(envValues));
             }
         }
     }

package/dist/lib/utils/helmYamlSerializer.d.ts

@@ -0,0 +1,8 @@
+import * as jsYaml from 'js-yaml';
+export declare function dumpHelmAwareYaml(obj: unknown, options?: jsYaml.DumpOptions): string;
+export declare function stringify(obj: unknown, options?: {
+    lineWidth?: number;
+    doubleQuotedAsJSON?: boolean;
+    simpleKeys?: boolean;
+}): string;
+export declare function validateHelmExpressions(yaml: string): boolean;

package/dist/lib/utils/helmYamlSerializer.js

@@ -0,0 +1,88 @@
+import * as jsYaml from 'js-yaml';
+const HELM_EXPRESSION_PATTERNS = [
+    /\{\{\s*[^}]+\s*\}\}/g,
+    /\{\{\s*include\s+[^}]+\s*\}\}/g,
+    /\{\{\s*if\s+[^}]+\s*\}\}/g,
+    /\{\{\s*else\s*\}\}/g,
+    /\{\{\s*end\s*\}\}/g,
+    /\{\{\s*range\s+[^}]+\s*\}\}/g,
+    /\{\{\s*with\s+[^}]+\s*\}\}/g,
+    /\{\{\s*\$[^}]+\s*\}\}/g,
+    /\{\{\s*[^}]*\|\s*[^}]+\s*\}\}/g,
+];
+function createHelmExpression(value) {
+    return {
+        __helmExpression: true,
+        value,
+    };
+}
+function isHelmExpression(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        '__helmExpression' in value &&
+        value.__helmExpression === true);
+}
+function containsHelmExpression(str) {
+    return HELM_EXPRESSION_PATTERNS.some((pattern) => pattern.test(str));
+}
+function preprocessHelmExpressions(obj) {
+    if (typeof obj === 'string') {
+        if (containsHelmExpression(obj)) {
+            return createHelmExpression(obj);
+        }
+        return obj;
+    }
+    if (Array.isArray(obj)) {
+        return obj.map(preprocessHelmExpressions);
+    }
+    if (obj && typeof obj === 'object') {
+        const result = {};
+        for (const [key, value] of Object.entries(obj)) {
+            Object.defineProperty(result, key, {
+                value: preprocessHelmExpressions(value),
+                writable: true,
+                enumerable: true,
+                configurable: true,
+            });
+        }
+        return result;
+    }
+    return obj;
+}
+function helmAwareReplacer(key, value) {
+    if (isHelmExpression(value)) {
+        return value.value;
+    }
+    return value;
+}
+export function dumpHelmAwareYaml(obj, options = {}) {
+    const preprocessed = preprocessHelmExpressions(obj);
+    const helmOptions = {
+        forceQuotes: false,
+        lineWidth: options.lineWidth ?? 0,
+        flowLevel: options.flowLevel ?? -1,
+        replacer: helmAwareReplacer,
+        ...options,
+    };
+    let yamlOutput = jsYaml.dump(preprocessed, helmOptions);
+    yamlOutput = postProcessHelmExpressions(yamlOutput);
+    return yamlOutput;
+}
+function postProcessHelmExpressions(yaml) {
+    let processed = yaml;
+    processed = processed.replace(/'(\{\{[^}]*\}\})'/g, '$1');
+    processed = processed.replace(/"(\{\{[^}]*\}\})"/g, '$1');
+    processed = processed.replace(/\\(\{\{[^}]*\}\})/g, '$1');
+    return processed;
+}
+export function stringify(obj, options = {}) {
+    const jsYamlOptions = {
+        lineWidth: options.lineWidth ?? 0,
+        quotingType: options.doubleQuotedAsJSON ? '"' : "'",
+    };
+    return dumpHelmAwareYaml(obj, jsYamlOptions);
+}
+export function validateHelmExpressions(yaml) {
+    const quotedHelmExpressions = [/'(\{\{[^}]*\}\})'/g, /"(\{\{[^}]*\}\})"/g];
+    return !quotedHelmExpressions.some((pattern) => pattern.test(yaml));
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "timonel",
   "type": "module",
-  "version": "2.9.0",
+  "version": "2.9.2",
   "description": "Timonel: programmatic Helm chart generator using cdk8s (TypeScript)",
   "bin": {
     "timonel": "dist/cli.js",
@@ -37,13 +37,9 @@
     "deps:update": "pnpm update --latest",
     "md:lint": "markdownlint \"**/*.md\"",
     "md:fix": "markdownlint --fix \"**/*.md\"",
-    "_comment_tests": "ALL TEST SCRIPTS DISABLED TEMPORARILY",
-    "_test": "pnpm test:unit && pnpm test:integration",
-    "_test:unit": "vitest run --config vitest.config.ts",
-    "_test:integration": "vitest run --config vitest.integration.config.ts",
-    "_test:watch": "vitest",
-    "_test:coverage": "vitest run --coverage",
-    "_test:basic-integration": "vitest run tests/integration/basic-chart-generation.int.spec.ts --config vitest.integration.config.ts",
+    "test:integration": "vitest run --config vitest.config.ts",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
     "ci:check": "pnpm typecheck && pnpm lint && pnpm format:check && pnpm build",
     "release": "semantic-release",
     "release:dry": "semantic-release --dry-run",
@@ -89,6 +85,8 @@
     "cdk8s-plus-33": "^2.3.5",
     "constructs": "^10.4.2",
     "handlebars": "^4.7.8",
+    "js-yaml": "^4.1.0",
+    "timonel": "^2.9.0",
     "ts-node": "^10.9.2",
     "yaml": "^2.8.1"
   },
@@ -99,6 +97,7 @@
     "@semantic-release/changelog": "^6.0.3",
     "@semantic-release/exec": "^7.1.0",
     "@semantic-release/git": "^10.0.1",
+    "@types/js-yaml": "^4.0.9",
     "@types/node": "^24.3.0",
     "@typescript-eslint/eslint-plugin": "^8.42.0",
     "@typescript-eslint/parser": "^8.42.0",