@intentius/chant 0.3.0 → 0.4.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intentius/chant",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Declarative infrastructure-as-code toolkit — TypeScript on Node.js",
   "license": "Apache-2.0",
   "homepage": "https://intentius.io/chant",

package/src/build.ts

@@ -143,6 +143,12 @@ export interface BuildOptions {
    * native metadata channel. Resolved from project config by the caller.
    */
   ownership?: OwnershipMarker;
+
+  /**
+   * The resolved project configuration, passed through to each serializer's
+   * {@link SerializeContext} so a dialect can read its lexicon-scoped settings.
+   */
+  config?: Record<string, unknown>;
 }
 
 export interface BuildResult {
@@ -553,10 +559,15 @@ export async function build(
         ...(outputsByLexicon.get(lexiconName) ?? []),
         ...unassignedOutputs,
       ];
-      outputs.set(
-        lexiconName,
-        serializer.serialize(lexiconEntities, lexiconLexiconOutputs, { ownership: options?.ownership }),
-      );
+      const serialized = serializer.serialize(lexiconEntities, lexiconLexiconOutputs, {
+        ownership: options?.ownership,
+        config: options?.config,
+      });
+      // Collect any non-fatal serializer diagnostics into the build warnings.
+      if (typeof serialized !== "string" && serialized.warnings) {
+        for (const w of serialized.warnings) warnings.push(w);
+      }
+      outputs.set(lexiconName, serialized);
     } else {
       warnings.push(`No serializer found for lexicon "${lexiconName}"`);
     }

package/src/cli/commands/build.ts

@@ -111,7 +111,10 @@ export async function buildCommand(options: BuildOptions): Promise<BuildResult>
     : [];
 
   // Run the build
-  const result = await build(infraPath, options.serializers, undefined, { ownership });
+  const result = await build(infraPath, options.serializers, undefined, {
+    ownership,
+    config: config as unknown as Record<string, unknown>,
+  });
 
   // Format errors
   for (const error of result.errors) {
@@ -137,11 +140,15 @@ export async function buildCommand(options: BuildOptions): Promise<BuildResult>
       const checks = plugin.postSynthChecks();
       if (checks.length === 0) continue;
 
-      // Scope outputs to this plugin's lexicon so cross-lexicon outputs don't interfere
+      // Scope outputs to this plugin's lexicon so cross-lexicon outputs don't
+      // interfere. Outputs are keyed by the serializer's lexicon name (the
+      // build partition key), which differs from plugin.name for a dialect like
+      // forgejo (plugin "forgejo", serializer "github").
+      const outputKey = plugin.serializer.name;
       const scopedOutputs = new Map<string, string | SerializerResult>();
-      const pluginOutput = result.outputs.get(plugin.name);
+      const pluginOutput = result.outputs.get(outputKey);
       if (pluginOutput !== undefined) {
-        scopedOutputs.set(plugin.name, pluginOutput);
+        scopedOutputs.set(outputKey, pluginOutput);
       }
 
       const scopedResult = { ...result, outputs: scopedOutputs };

package/src/serializer.ts

@@ -12,6 +12,14 @@ export interface SerializeContext {
    * native metadata channel (AWS/Azure tags, K8s/GCP labels).
    */
   ownership?: OwnershipMarker;
+
+  /**
+   * The resolved project configuration, when a build was driven from a project
+   * with a `chant.config.*`. Lets a serializer read its own lexicon-scoped
+   * settings (e.g. the forgejo dialect's `forgejo.runnerLabels`). Undefined for
+   * ad-hoc builds (e.g. context tools) that pass no config.
+   */
+  config?: Record<string, unknown>;
 }
 
 /**
@@ -22,6 +30,12 @@ export interface SerializerResult {
   primary: string;
   /** Additional files keyed by filename (e.g. "network.template.json" → content) */
   files?: Record<string, string>;
+  /**
+   * Non-fatal diagnostics produced during serialization (e.g. a dialect
+   * dropping keys the target platform ignores). The build pipeline collects
+   * these into its `warnings` array.
+   */
+  warnings?: string[];
 }
 
 /**