@telorun/cli 0.70.0 → 0.72.0

package/dist/bundle/partition-layers.d.ts

@@ -1,4 +1,4 @@
-import { type ArtifactSelector } from "@telorun/analyzer";
+import { type ArtifactSelector, type ModuleFileClaim } from "@telorun/analyzer";
 import type { PayloadLayer } from "@telorun/kernel";
 /** Manifest-relative POSIX path of a selected file, grouped into the layer it
  *  belongs to. Content is read by the caller — this module decides membership
@@ -16,29 +16,13 @@ export interface Partition {
     /** `assets:` patterns that matched nothing — almost always a typo, and invisible
      *  in `layers` because an empty layer is dropped. */
     unmatchedAssets: string[];
-    /** `siblings=` patterns that matched nothing, with the candidate that declared
+    /** `siblings=` patterns that matched nothing, with the claim that declared
      *  each one. */
     unmatchedSiblings: Array<{
-        purl: string;
+        origin: string;
         pattern: string;
     }>;
 }
-interface ControllerClaim {
-    selector: ArtifactSelector;
-    /** Entry-point path exactly as `path=` names it, manifest-relative. */
-    entry: string;
-    /** Sibling patterns declared on the same candidate. */
-    siblings: string[];
-    /** For diagnostics: the PURL this claim came from. */
-    purl: string;
-}
-/**
- * Every bundled-controller candidate declared anywhere in the manifest, with its
- * selector and the files it claims. Read from `controllers:` on each doc — the
- * manifest already names each entry point, so the partition is derived rather
- * than declared.
- */
-export declare function readControllerClaims(manifestText: string): ControllerClaim[];
 /**
  * Partition the selected payload into the layers a module artifact ships.
  *
@@ -53,13 +37,15 @@ export declare function readControllerClaims(manifestText: string): ControllerCl
  * therefore costs bytes, never a module-not-found at runtime. Both declarations
  * are optional and only ever buy laziness.
  *
- * `files` are the manifest-relative paths `selectFiles` produced; `assetPatterns`
- * is the author's `assets:` list. Every bundled controller's `path=` entry joins
- * the payload whether or not `files:` selected it — the manifest already names
- * it, so restating it would be pure duplication. Layers with no files are
- * dropped, so a controller-only module publishes exactly one payload layer.
+ * `claims` is everything the manifest names — read by `collectModuleFileClaims`,
+ * which asks each syntax's own owner (this module recognises neither a PURL nor
+ * a YAML tag). `files` are the manifest-relative paths `selectFiles` produced;
+ * `assetPatterns` is the author's `assets:` list. A claimed file joins the
+ * payload whether or not `files:` selected it — the manifest already names it,
+ * so restating it would be pure duplication. Layers with no files are dropped,
+ * so a controller-only module publishes exactly one payload layer.
  */
-export declare function partitionLayers(manifestText: string, files: string[], assetPatterns: string[]): Partition;
+export declare function partitionLayers(claims: readonly ModuleFileClaim[], files: string[], assetPatterns: string[]): Partition;
 /**
  * One line per layer for the publish output, so an author can see that a file they
  * meant as a sidecar or an asset landed in `common` instead.
@@ -69,5 +55,4 @@ export declare function partitionLayers(manifestText: string, files: string[], a
  * silence about the single mistake this output exists to catch.
  */
 export declare function describePartition(partition: Partition): string[];
-export {};
 //# sourceMappingURL=partition-layers.d.ts.map

package/dist/bundle/partition-layers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"partition-layers.d.ts","sourceRoot":"","sources":["../../src/bundle/partition-layers.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,gBAAgB,EACtB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAKpD;;uDAEuD;AACvD,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC;IAC3B,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAC5B,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED;;uEAEuE;AACvE,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB;yDACqD;IACrD,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B;oBACgB;IAChB,iBAAiB,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC7D;AAgBD,UAAU,eAAe;IACvB,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,uEAAuE;IACvE,KAAK,EAAE,MAAM,CAAC;IACd,uDAAuD;IACvD,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,sDAAsD;IACtD,IAAI,EAAE,MAAM,CAAC;CACd;AAQD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,YAAY,EAAE,MAAM,GAAG,eAAe,EAAE,CAmC5E;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,eAAe,CAC7B,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,MAAM,EAAE,EACf,aAAa,EAAE,MAAM,EAAE,GACtB,SAAS,CAgEX;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM,EAAE,CAYhE"}
+{"version":3,"file":"partition-layers.d.ts","sourceRoot":"","sources":["../../src/bundle/partition-layers.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACrB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEpD;;uDAEuD;AACvD,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC;IAC3B,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAC5B,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED;;uEAEuE;AACvE,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB;yDACqD;IACrD,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B;oBACgB;IAChB,iBAAiB,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC/D;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,SAAS,eAAe,EAAE,EAClC,KAAK,EAAE,MAAM,EAAE,EACf,aAAa,EAAE,MAAM,EAAE,GACtB,SAAS,CA4EX;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM,EAAE,CAYhE"}

package/dist/bundle/partition-layers.js

@@ -1,67 +1,5 @@
-import { describeSelector, selectorFromQualifiers, selectorKey, } from "@telorun/analyzer";
+import { describeSelector, selectorKey, } from "@telorun/analyzer";
 import { selectByPatterns } from "@telorun/glob";
-import { defaultCustomTags } from "@telorun/templating";
-import { PackageURL } from "packageurl-js";
-import { parseAllDocuments } from "yaml";
-/** `pkg:telo/local/<format>?path=…` — the bundled-controller delivery mode.
- *  Anything else (`pkg:npm`, `pkg:cargo`) fetches from its own ecosystem and
- *  contributes no layer. */
-const BUNDLED_TYPE = "telo";
-const BUNDLED_NAMESPACE = "local";
-/** Qualifier naming extra files that belong in a controller's layer — what an
- *  entry point loads but the manifest cannot otherwise see (a `.wasm` beside its
- *  glue, a native library opened at runtime). Comma-separated
- *  `.gitignore`-style patterns, matched through the one glob engine. Optional:
- *  an unclaimed sidecar joins the common layer, which every controller-hosting
- *  kernel pulls, so omitting it costs bytes rather than a broken import. */
-const SIBLINGS_QUALIFIER = "siblings";
-/** Normalize a `path=` / sibling value to the manifest-relative POSIX form
- *  `selectFiles` returns, so membership is a string comparison. */
-function normalizeRelative(value) {
-    return value.replace(/^\.\//, "").replace(/\\/g, "/");
-}
-/**
- * Every bundled-controller candidate declared anywhere in the manifest, with its
- * selector and the files it claims. Read from `controllers:` on each doc — the
- * manifest already names each entry point, so the partition is derived rather
- * than declared.
- */
-export function readControllerClaims(manifestText) {
-    const claims = [];
-    for (const doc of parseAllDocuments(manifestText, { customTags: defaultCustomTags() })) {
-        const json = doc.toJSON();
-        const candidates = Array.isArray(json?.controllers) ? json.controllers : [];
-        for (const candidate of candidates) {
-            if (typeof candidate !== "string")
-                continue;
-            let parsed;
-            try {
-                parsed = PackageURL.fromString(candidate);
-            }
-            catch {
-                // Not a parseable PURL — publish is not the place to reject it; the
-                // analyzer and the controller loader both report it with better context.
-                continue;
-            }
-            if (parsed.type !== BUNDLED_TYPE || parsed.namespace !== BUNDLED_NAMESPACE)
-                continue;
-            const entry = parsed.qualifiers?.path;
-            if (typeof entry !== "string" || entry === "")
-                continue;
-            const siblings = String(parsed.qualifiers?.[SIBLINGS_QUALIFIER] ?? "")
-                .split(",")
-                .map((p) => p.trim())
-                .filter((p) => p !== "");
-            claims.push({
-                selector: selectorFromQualifiers(parsed.name, parsed.qualifiers, `controller "${candidate}"`),
-                entry: normalizeRelative(entry),
-                siblings,
-                purl: candidate,
-            });
-        }
-    }
-    return claims;
-}
 /**
  * Partition the selected payload into the layers a module artifact ships.
  *
@@ -76,24 +14,30 @@ export function readControllerClaims(manifestText) {
  * therefore costs bytes, never a module-not-found at runtime. Both declarations
  * are optional and only ever buy laziness.
  *
- * `files` are the manifest-relative paths `selectFiles` produced; `assetPatterns`
- * is the author's `assets:` list. Every bundled controller's `path=` entry joins
- * the payload whether or not `files:` selected it — the manifest already names
- * it, so restating it would be pure duplication. Layers with no files are
- * dropped, so a controller-only module publishes exactly one payload layer.
+ * `claims` is everything the manifest names — read by `collectModuleFileClaims`,
+ * which asks each syntax's own owner (this module recognises neither a PURL nor
+ * a YAML tag). `files` are the manifest-relative paths `selectFiles` produced;
+ * `assetPatterns` is the author's `assets:` list. A claimed file joins the
+ * payload whether or not `files:` selected it — the manifest already names it,
+ * so restating it would be pure duplication. Layers with no files are dropped,
+ * so a controller-only module publishes exactly one payload layer.
  */
-export function partitionLayers(manifestText, files, assetPatterns) {
-    const claims = readControllerClaims(manifestText);
-    // A controller entry point is part of the payload because `controllers:` names
-    // it, not because `files:` restates it. `files:` keeps its role for everything
-    // the manifest cannot otherwise see — assets, static files, sidecars — and a
-    // module whose only payload is its controller declares no `files:` at all.
+export function partitionLayers(claims, files, assetPatterns) {
+    // Narrowing predicates, so the controller branch reaches `selector` and
+    // `siblings` as declared fields rather than through a non-null assertion —
+    // the claim type is a discriminated union precisely so this is checked.
+    const controllers = claims.filter((claim) => claim.role === "controller");
+    const claimedAssets = claims.filter((claim) => claim.role === "assets");
+    // A claimed file is part of the payload because the manifest names it, not
+    // because `files:` restates it. `files:` keeps its role for everything the
+    // manifest cannot otherwise see — static files, sidecars — and a module whose
+    // only payload is its controller declares no `files:` at all.
     //
     // Sibling patterns are still matched against `files:` alone: a sibling is a
     // glob over the payload, so a pattern that selects nothing there means the
     // author forgot to include the file, which `unmatchedSiblings` reports.
-    const selected = new Set([...files, ...claims.map((claim) => claim.entry)]);
-    const unclaimed = new Set(files);
+    const selected = new Set([...files, ...claims.map((claim) => claim.path)]);
+    const unclaimed = new Set([...files, ...claimedAssets.map((claim) => claim.path)]);
     // Controller layers first: a file an entry point or sibling claims belongs to
     // that selector, never to assets or common, so the layer a kernel skips is
     // genuinely skippable. A file several candidates claim is copied into each of
@@ -102,30 +46,35 @@ export function partitionLayers(manifestText, files, assetPatterns) {
     // would break the "a declaration never costs correctness" guarantee.
     const bySelector = new Map();
     const unmatchedSiblings = [];
-    for (const claim of claims) {
+    for (const claim of controllers) {
         const key = selectorKey(claim.selector);
         let plan = bySelector.get(key);
         if (!plan) {
             plan = { role: "controller", selector: claim.selector, files: [] };
             bySelector.set(key, plan);
         }
-        const siblings = selectByPatterns([...selected], claim.siblings, {
-            applyDefaultIgnore: false,
-        });
-        for (const pattern of claim.siblings) {
+        const patterns = [...claim.siblings];
+        const siblings = selectByPatterns([...selected], patterns, { applyDefaultIgnore: false });
+        for (const pattern of patterns) {
             if (selectByPatterns([...selected], [pattern], { applyDefaultIgnore: false }).length === 0) {
-                unmatchedSiblings.push({ purl: claim.purl, pattern });
+                unmatchedSiblings.push({ origin: claim.origin, pattern });
             }
         }
-        for (const file of [claim.entry, ...siblings]) {
+        for (const file of [claim.path, ...siblings]) {
             unclaimed.delete(file);
             if (!plan.files.includes(file))
                 plan.files.push(file);
         }
     }
-    const assetFiles = selectByPatterns([...unclaimed], assetPatterns, {
-        applyDefaultIgnore: false,
-    });
+    // A file a tag embeds is an asset by declaration, so it needs no `assets:`
+    // pattern to be lazy — the manifest already said what it is. A pattern can
+    // still claim more, and a file claimed both ways is one file.
+    const assetFiles = [
+        ...new Set([
+            ...claimedAssets.map((claim) => claim.path).filter((file) => unclaimed.has(file)),
+            ...selectByPatterns([...unclaimed], assetPatterns, { applyDefaultIgnore: false }),
+        ]),
+    ].sort();
     for (const file of assetFiles)
         unclaimed.delete(file);
     const unmatchedAssets = assetPatterns.filter((pattern) => !pattern.startsWith("!") &&
@@ -157,8 +106,8 @@ export function describePartition(partition) {
     for (const pattern of partition.unmatchedAssets) {
         lines.push(`assets pattern '${pattern}' matched no file`);
     }
-    for (const { purl, pattern } of partition.unmatchedSiblings) {
-        lines.push(`siblings pattern '${pattern}' matched no file (from ${purl})`);
+    for (const { origin, pattern } of partition.unmatchedSiblings) {
+        lines.push(`siblings pattern '${pattern}' matched no file (from ${origin})`);
     }
     return lines;
 }

package/dist/bundle/partition-layers.js.map

@@ -1 +1 @@
-{"version":3,"file":"partition-layers.js","sourceRoot":"","sources":["../../src/bundle/partition-layers.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,sBAAsB,EACtB,WAAW,GAEZ,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,iBAAiB,EAAE,MAAM,MAAM,CAAC;AAwBzC;;4BAE4B;AAC5B,MAAM,YAAY,GAAG,MAAM,CAAC;AAC5B,MAAM,iBAAiB,GAAG,OAAO,CAAC;AAElC;;;;;4EAK4E;AAC5E,MAAM,kBAAkB,GAAG,UAAU,CAAC;AAYtC;mEACmE;AACnE,SAAS,iBAAiB,CAAC,KAAa;IACtC,OAAO,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;AACxD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,YAAoB;IACvD,MAAM,MAAM,GAAsB,EAAE,CAAC;IACrC,KAAK,MAAM,GAAG,IAAI,iBAAiB,CAAC,YAAY,EAAE,EAAE,UAAU,EAAE,iBAAiB,EAAE,EAAE,CAAC,EAAE,CAAC;QACvF,MAAM,IAAI,GAAG,GAAG,CAAC,MAAM,EAAsC,CAAC;QAC9D,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5E,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;YACnC,IAAI,OAAO,SAAS,KAAK,QAAQ;gBAAE,SAAS;YAC5C,IAAI,MAAkB,CAAC;YACvB,IAAI,CAAC;gBACH,MAAM,GAAG,UAAU,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;YAC5C,CAAC;YAAC,MAAM,CAAC;gBACP,oEAAoE;gBACpE,yEAAyE;gBACzE,SAAS;YACX,CAAC;YACD,IAAI,MAAM,CAAC,IAAI,KAAK,YAAY,IAAI,MAAM,CAAC,SAAS,KAAK,iBAAiB;gBAAE,SAAS;YACrF,MAAM,KAAK,GAAG,MAAM,CAAC,UAAU,EAAE,IAAI,CAAC;YACtC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,EAAE;gBAAE,SAAS;YACxD,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC,kBAAkB,CAAC,IAAI,EAAE,CAAC;iBACnE,KAAK,CAAC,GAAG,CAAC;iBACV,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;iBACpB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;YAC3B,MAAM,CAAC,IAAI,CAAC;gBACV,QAAQ,EAAE,sBAAsB,CAC9B,MAAM,CAAC,IAAI,EACX,MAAM,CAAC,UAAU,EACjB,eAAe,SAAS,GAAG,CAC5B;gBACD,KAAK,EAAE,iBAAiB,CAAC,KAAK,CAAC;gBAC/B,QAAQ;gBACR,IAAI,EAAE,SAAS;aAChB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,eAAe,CAC7B,YAAoB,EACpB,KAAe,EACf,aAAuB;IAEvB,MAAM,MAAM,GAAG,oBAAoB,CAAC,YAAY,CAAC,CAAC;IAElD,+EAA+E;IAC/E,+EAA+E;IAC/E,6EAA6E;IAC7E,2EAA2E;IAC3E,EAAE;IACF,4EAA4E;IAC5E,2EAA2E;IAC3E,wEAAwE;IACxE,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,KAAK,EAAE,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC5E,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC;IAEjC,8EAA8E;IAC9E,2EAA2E;IAC3E,8EAA8E;IAC9E,2EAA2E;IAC3E,+EAA+E;IAC/E,qEAAqE;IACrE,MAAM,UAAU,GAAG,IAAI,GAAG,EAAqB,CAAC;IAChD,MAAM,iBAAiB,GAA6C,EAAE,CAAC;IACvE,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,GAAG,GAAG,WAAW,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QACxC,IAAI,IAAI,GAAG,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC/B,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,IAAI,GAAG,EAAE,IAAI,EAAE,YAAY,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;YACnE,UAAU,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAC5B,CAAC;QACD,MAAM,QAAQ,GAAG,gBAAgB,CAAC,CAAC,GAAG,QAAQ,CAAC,EAAE,KAAK,CAAC,QAAQ,EAAE;YAC/D,kBAAkB,EAAE,KAAK;SAC1B,CAAC,CAAC;QACH,KAAK,MAAM,OAAO,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;YACrC,IAAI,gBAAgB,CAAC,CAAC,GAAG,QAAQ,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,EAAE,kBAAkB,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC3F,iBAAiB,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;YACxD,CAAC;QACH,CAAC;QACD,KAAK,MAAM,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,QAAQ,CAAC,EAAE,CAAC;YAC9C,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YACvB,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC;gBAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACxD,CAAC;IACH,CAAC;IAED,MAAM,UAAU,GAAG,gBAAgB,CAAC,CAAC,GAAG,SAAS,CAAC,EAAE,aAAa,EAAE;QACjE,kBAAkB,EAAE,KAAK;KAC1B,CAAC,CAAC;IACH,KAAK,MAAM,IAAI,IAAI,UAAU;QAAE,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACtD,MAAM,eAAe,GAAG,aAAa,CAAC,MAAM,CAC1C,CAAC,OAAO,EAAE,EAAE,CACV,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC;QACxB,gBAAgB,CAAC,CAAC,GAAG,QAAQ,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,EAAE,kBAAkB,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,KAAK,CAAC,CACzF,CAAC;IAEF,MAAM,MAAM,GAAgB;QAC1B,GAAG,CAAC,GAAG,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAClF,EAAE,IAAI,EAAE,QAAiB,EAAE,KAAK,EAAE,UAAU,EAAE;QAC9C,EAAE,IAAI,EAAE,QAAiB,EAAE,KAAK,EAAE,CAAC,GAAG,SAAS,CAAC,CAAC,IAAI,EAAE,EAAE;KAC1D,CAAC;IAEF,OAAO;QACL,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;QAChD,eAAe;QACf,iBAAiB;KAClB,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,iBAAiB,CAAC,SAAoB;IACpD,MAAM,KAAK,GAAG,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QAC3C,MAAM,KAAK,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,IAAI,IAAI,gBAAgB,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC;QAChG,OAAO,GAAG,KAAK,KAAK,KAAK,CAAC,KAAK,CAAC,MAAM,UAAU,CAAC;IACnD,CAAC,CAAC,CAAC;IACH,KAAK,MAAM,OAAO,IAAI,SAAS,CAAC,eAAe,EAAE,CAAC;QAChD,KAAK,CAAC,IAAI,CAAC,mBAAmB,OAAO,mBAAmB,CAAC,CAAC;IAC5D,CAAC;IACD,KAAK,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,SAAS,CAAC,iBAAiB,EAAE,CAAC;QAC5D,KAAK,CAAC,IAAI,CAAC,qBAAqB,OAAO,2BAA2B,IAAI,GAAG,CAAC,CAAC;IAC7E,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}
+{"version":3,"file":"partition-layers.js","sourceRoot":"","sources":["../../src/bundle/partition-layers.ts"],"names":[],"mappings":"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"}

package/dist/cli.js

@@ -1,6 +1,7 @@
 #!/usr/bin/env node
 import yargs from "yargs";
 import { hideBin } from "yargs/helpers";
+import { OUTPUT_FORMATS, configureOutput, parseOutputFormat } from "./output.js";
 import { celCommand } from "./commands/cel.js";
 import { checkCommand } from "./commands/check.js";
 import { installCommand } from "./commands/install.js";
@@ -47,6 +48,16 @@ cli
     default: true,
     describe: "Persist the analysis/validator cache to disk. Use --no-cache-write for an ephemeral, read-only run (validates in-memory, reads the baked cache but never writes it).",
 })
+    .option("output", {
+    alias: "o",
+    type: "string",
+    choices: OUTPUT_FORMATS,
+    default: "text",
+    describe: "Output format for the CLI's own output. `json` is a machine contract and never carries colour. Note `telo run` streams the app's stdout/stderr through untouched — the app picks its own encoding via its `logging:` block.",
+})
+    // Runs before any handler, so a call site deep inside a command reaches the
+    // same decision without the format being threaded through every signature.
+    .middleware((argv) => configureOutput(parseOutputFormat(argv.output)), true)
     .demandCommand(1, "Please specify a command or path to run")
     .strict()
     .help()

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD,IAAI,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;KACnC,UAAU,CAAC,MAAM,CAAC;KAClB,KAAK,CAAC,wBAAwB,CAAC,CAAC;AAEnC,GAAG,GAAG,UAAU,CAAC,GAAG,CAAe,CAAC;AACpC,GAAG,GAAG,YAAY,CAAC,GAAG,CAAe,CAAC;AACtC,GAAG,GAAG,cAAc,CAAC,GAAG,CAAe,CAAC;AACxC,GAAG,GAAG,aAAa,CAAC,GAAG,CAAe,CAAC;AACvC,GAAG,GAAG,cAAc,CAAC,GAAG,CAAe,CAAC;AACxC,GAAG,GAAG,UAAU,CAAC,GAAG,CAAe,CAAC;AACpC,GAAG,GAAG,aAAa,CAAC,GAAG,CAAe,CAAC;AACvC,GAAG,GAAG,cAAc,CAAC,GAAG,CAAe,CAAC;AAExC,GAAG;KACA,MAAM,CAAC,SAAS,EAAE;IACjB,IAAI,EAAE,SAAS;IACf,OAAO,EAAE,KAAK;IACd,QAAQ,EAAE,wBAAwB;CACnC,CAAC;KACD,MAAM,CAAC,OAAO,EAAE;IACf,IAAI,EAAE,SAAS;IACf,OAAO,EAAE,KAAK;IACd,QAAQ,EAAE,8BAA8B;CACzC,CAAC;KACD,MAAM,CAAC,kBAAkB,EAAE;IAC1B,IAAI,EAAE,SAAS;IACf,OAAO,EAAE,KAAK;IACd,QAAQ,EAAE,4BAA4B;CACvC,CAAC;KACD,MAAM,CAAC,OAAO,EAAE;IACf,KAAK,EAAE,GAAG;IACV,IAAI,EAAE,SAAS;IACf,OAAO,EAAE,KAAK;IACd,QAAQ,EAAE,2CAA2C;CACtD,CAAC;KACD,MAAM,CAAC,aAAa,EAAE;IACrB,IAAI,EAAE,SAAS;IACf,OAAO,EAAE,IAAI;IACb,QAAQ,EACN,sKAAsK;CACzK,CAAC;KACD,aAAa,CAAC,CAAC,EAAE,yCAAyC,CAAC;KAC3D,MAAM,EAAE;KACR,IAAI,EAAE;KACN,OAAO,EAAE;KACT,KAAK,EAAE,CAAC"}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACjF,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD,IAAI,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;KACnC,UAAU,CAAC,MAAM,CAAC;KAClB,KAAK,CAAC,wBAAwB,CAAC,CAAC;AAEnC,GAAG,GAAG,UAAU,CAAC,GAAG,CAAe,CAAC;AACpC,GAAG,GAAG,YAAY,CAAC,GAAG,CAAe,CAAC;AACtC,GAAG,GAAG,cAAc,CAAC,GAAG,CAAe,CAAC;AACxC,GAAG,GAAG,aAAa,CAAC,GAAG,CAAe,CAAC;AACvC,GAAG,GAAG,cAAc,CAAC,GAAG,CAAe,CAAC;AACxC,GAAG,GAAG,UAAU,CAAC,GAAG,CAAe,CAAC;AACpC,GAAG,GAAG,aAAa,CAAC,GAAG,CAAe,CAAC;AACvC,GAAG,GAAG,cAAc,CAAC,GAAG,CAAe,CAAC;AAExC,GAAG;KACA,MAAM,CAAC,SAAS,EAAE;IACjB,IAAI,EAAE,SAAS;IACf,OAAO,EAAE,KAAK;IACd,QAAQ,EAAE,wBAAwB;CACnC,CAAC;KACD,MAAM,CAAC,OAAO,EAAE;IACf,IAAI,EAAE,SAAS;IACf,OAAO,EAAE,KAAK;IACd,QAAQ,EAAE,8BAA8B;CACzC,CAAC;KACD,MAAM,CAAC,kBAAkB,EAAE;IAC1B,IAAI,EAAE,SAAS;IACf,OAAO,EAAE,KAAK;IACd,QAAQ,EAAE,4BAA4B;CACvC,CAAC;KACD,MAAM,CAAC,OAAO,EAAE;IACf,KAAK,EAAE,GAAG;IACV,IAAI,EAAE,SAAS;IACf,OAAO,EAAE,KAAK;IACd,QAAQ,EAAE,2CAA2C;CACtD,CAAC;KACD,MAAM,CAAC,aAAa,EAAE;IACrB,IAAI,EAAE,SAAS;IACf,OAAO,EAAE,IAAI;IACb,QAAQ,EACN,sKAAsK;CACzK,CAAC;KACD,MAAM,CAAC,QAAQ,EAAE;IAChB,KAAK,EAAE,GAAG;IACV,IAAI,EAAE,QAAQ;IACd,OAAO,EAAE,cAAc;IACvB,OAAO,EAAE,MAAe;IACxB,QAAQ,EACN,6NAA6N;CAChO,CAAC;IACF,4EAA4E;IAC5E,2EAA2E;KAC1E,UAAU,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,eAAe,CAAC,iBAAiB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,EAAE,IAAI,CAAC;KAC3E,aAAa,CAAC,CAAC,EAAE,yCAAyC,CAAC;KAC3D,MAAM,EAAE;KACR,IAAI,EAAE;KACN,OAAO,EAAE;KACT,KAAK,EAAE,CAAC"}

package/dist/commands/cel.d.ts

@@ -1,3 +1,21 @@
+import { type CelFunctionInfo } from "@telorun/templating";
 import type { Argv } from "yargs";
+/** A CEL built-in, in the same shape as a catalog entry so one listing covers
+ *  both halves of what a manifest may call. `receiver` is what the catalog
+ *  cannot express: a built-in is usually a METHOD, and calling it as a global
+ *  does not type-check. Leaving them out was the reason an author could read
+ *  this command end to end and still write `startsWith(key, 'x')`. */
+interface CelBuiltinInfo {
+    name: string;
+    signature: string;
+    category: "builtin";
+    receiver: string | null;
+}
+/** The `--json` document: Telo's catalog followed by CEL's built-ins. Exported
+ *  for tests — the listing is what every new CEL diagnostic points a reader at,
+ *  so "does it contain the functions those diagnostics are about" is worth
+ *  asserting without spawning a CLI. */
+export declare function functionListing(): (CelFunctionInfo | CelBuiltinInfo)[];
 export declare function celCommand(yargs: Argv): Argv;
+export {};
 //# sourceMappingURL=cel.d.ts.map

package/dist/commands/cel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cel.d.ts","sourceRoot":"","sources":["../../src/commands/cel.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC;AAiElC,wBAAgB,UAAU,CAAC,KAAK,EAAE,IAAI,GAAG,IAAI,CAkC5C"}
+{"version":3,"file":"cel.d.ts","sourceRoot":"","sources":["../../src/commands/cel.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,eAAe,EACrB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC;AAGlC;;;;sEAIsE;AACtE,UAAU,cAAc;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,SAAS,CAAC;IACpB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAWD;;;wCAGwC;AACxC,wBAAgB,eAAe,IAAI,CAAC,eAAe,GAAG,cAAc,CAAC,EAAE,CAEtE;AAiGD,wBAAgB,UAAU,CAAC,KAAK,EAAE,IAAI,GAAG,IAAI,CAkC5C"}

package/dist/commands/cel.js

@@ -1,9 +1,31 @@
-import { buildCelEnvironment, celFunctionCatalog } from "@telorun/templating";
+import { buildCelEnvironment, celBuiltinFunctions, celFunctionCatalog, } from "@telorun/templating";
 import { enableBigIntJson, nodeCelHandlers } from "@telorun/kernel";
+import { output } from "../output.js";
+function builtins() {
+    return celBuiltinFunctions().map((fn) => ({
+        name: fn.name,
+        signature: fn.signature,
+        category: "builtin",
+        receiver: fn.receiverType,
+    }));
+}
+/** The `--json` document: Telo's catalog followed by CEL's built-ins. Exported
+ *  for tests — the listing is what every new CEL diagnostic points a reader at,
+ *  so "does it contain the functions those diagnostics are about" is worth
+ *  asserting without spawning a CLI. */
+export function functionListing() {
+    return [...celFunctionCatalog(), ...builtins()];
+}
 function printFunctions(asJson) {
     const catalog = celFunctionCatalog();
-    if (asJson) {
-        console.log(JSON.stringify(catalog, null, 2));
+    const out = output();
+    // `--json` predates the global flag and is an alias for it. The array IS the
+    // contract, so it is emitted bare rather than inside an envelope. Built-ins
+    // are appended rather than merged into a new shape: a consumer reading
+    // `signature` and `name` keeps working, and one reading `category` sees a
+    // new value rather than a changed one.
+    if (asJson || out.isJson) {
+        out.document(functionListing());
         return;
     }
     const byCategory = new Map();
@@ -13,18 +35,33 @@ function printFunctions(asJson) {
         byCategory.set(fn.category, list);
     }
     for (const [category, fns] of byCategory) {
-        console.log(`\n${category}`);
+        out.line(`\n${category}`);
         for (const fn of fns) {
             const tags = [
                 fn.hostBacked ? "host" : null,
                 fn.deterministic ? null : "non-deterministic",
             ].filter(Boolean);
             const suffix = tags.length ? `  [${tags.join(", ")}]` : "";
-            console.log(`  ${fn.signature}${suffix}`);
-            console.log(`      ${fn.summary}`);
+            out.line(`  ${fn.signature}${suffix}`);
+            out.line(`      ${fn.summary}`);
         }
     }
-    console.log();
+    // Grouped by receiver, because the grouping IS the information: everything
+    // under `on string` must be called on a value, and the globals must not be.
+    const byReceiver = new Map();
+    for (const fn of builtins()) {
+        const key = fn.receiver ?? "";
+        const list = byReceiver.get(key) ?? [];
+        list.push(fn.signature);
+        byReceiver.set(key, list);
+    }
+    out.line("\nCEL built-ins (provided by CEL itself)");
+    for (const [receiver, signatures] of [...byReceiver].sort(([a], [b]) => a.localeCompare(b))) {
+        out.line(`  ${receiver === "" ? "global functions" : `on ${receiver}`}`);
+        for (const signature of signatures.sort())
+            out.line(`      ${signature}`);
+    }
+    out.line();
 }
 function evalExpression(expr, contextJson, asJson) {
     // The one command that evaluates CEL without a kernel, so it installs the
@@ -33,12 +70,17 @@ function evalExpression(expr, contextJson, asJson) {
     // it through `boot()`, which is what keeps the CLI and an embedding Node app
     // identical: hosting a kernel is the only thing that installs it.
     enableBigIntJson();
+    const out = output();
     let context;
     try {
         context = contextJson ? JSON.parse(contextJson) : {};
     }
     catch (err) {
-        console.error(`Invalid --context JSON: ${err instanceof Error ? err.message : String(err)}`);
+        const message = `Invalid --context JSON: ${err instanceof Error ? err.message : String(err)}`;
+        // Prose on stderr plus a non-zero exit — never an envelope on stdout.
+        // stdout is the document, and an error object there would be
+        // indistinguishable from a CEL expression that evaluated to one.
+        out.errLine(message);
         process.exit(1);
     }
     // Real Node handlers so host-backed functions (sha256, base64, …) behave
@@ -49,14 +91,20 @@ function evalExpression(expr, contextJson, asJson) {
         result = env.parse(expr)(context);
     }
     catch (err) {
-        console.error(err instanceof Error ? err.message : String(err));
+        const message = err instanceof Error ? err.message : String(err);
+        // Prose on stderr plus a non-zero exit — never an envelope on stdout.
+        // stdout is the document, and an error object there would be
+        // indistinguishable from a CEL expression that evaluated to one.
+        out.errLine(message);
         process.exit(1);
     }
-    if (asJson) {
-        console.log(JSON.stringify(result, null, 2));
+    // The evaluated value IS the contract — emitted bare, exactly as `--json`
+    // already did, so the int64 encoding installed above stays observable.
+    if (asJson || out.isJson) {
+        out.document(result);
     }
     else {
-        console.log(typeof result === "bigint" ? result.toString() : result);
+        out.line(String(typeof result === "bigint" ? result.toString() : result));
     }
 }
 export function celCommand(yargs) {

package/dist/commands/cel.js.map

@@ -1 +1 @@
-{"version":3,"file":"cel.js","sourceRoot":"","sources":["../../src/commands/cel.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"cel.js","sourceRoot":"","sources":["../../src/commands/cel.ts"],"names":[],"mappings":"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"}

package/dist/commands/check.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"check.d.ts","sourceRoot":"","sources":["../../src/commands/check.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC;AAwOlC,wBAAsB,KAAK,CAAC,IAAI,EAAE;IAChC,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB,GAAG,OAAO,CAAC,IAAI,CAAC,CA0DhB;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,IAAI,GAAG,IAAI,CAoB9C"}
+{"version":3,"file":"check.d.ts","sourceRoot":"","sources":["../../src/commands/check.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC;AA+PlC,wBAAsB,KAAK,CAAC,IAAI,EAAE;IAChC,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB,GAAG,OAAO,CAAC,IAAI,CAAC,CA4EhB;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,IAAI,GAAG,IAAI,CAoB9C"}

package/dist/commands/check.js

@@ -6,7 +6,8 @@ import { defaultTransportRegistry } from "@telorun/kernel/transports";
 import * as fs from "fs/promises";
 import * as path from "path";
 import { pathToFileURL } from "url";
-import { createLogger, formatAnalysisDiagnostics, formatDiagnostics } from "../logger.js";
+import { createLogger, formatAnalysisDiagnostics, formatDiagnostics, } from "../logger.js";
+import { outErrLine, output } from "../output.js";
 import { RecordingCacheSource, readOriginDigests, revalidateMutableOciRefs, writeOriginDigests, } from "../manifest-freshness.js";
 const DEFAULT_REGISTRY_URL = "https://registry.telo.run";
 function cacheTargetFor(entryPath) {
@@ -70,7 +71,7 @@ async function dropStaleEntry(file, session, log) {
         await fs.rm(file, { force: true });
     }
     catch (err) {
-        process.stderr.write(`${log.warn(`[manifest-cache] could not remove stale entry ${file}: ${err instanceof Error ? err.message : String(err)}`)}\n`);
+        outErrLine(`${log.err.warn(`[manifest-cache] could not remove stale entry ${file}: ${err instanceof Error ? err.message : String(err)}`)}\n`);
     }
     session.loader.forget(pathToFileURL(file).href);
     for (const recorder of session.recorders) {
@@ -110,6 +111,7 @@ knownDigests, log) {
                 return {
                     errorCount: 0,
                     warnCount: 0,
+                    diagnostics: [],
                     staleFiles: freshness.staleFiles,
                     digests: freshness.digests,
                 };
@@ -141,7 +143,7 @@ knownDigests, log) {
                 await writeOriginDigests(cacheTarget.manifestsDir, digests);
             }
             catch (err) {
-                process.stderr.write(`${log.warn(`[manifest-cache] write failed: ${err instanceof Error ? err.message : String(err)}`)}\n`);
+                outErrLine(`${log.err.warn(`[manifest-cache] write failed: ${err instanceof Error ? err.message : String(err)}`)}\n`);
             }
         }
         return { ...counts, staleFiles: [], digests };
@@ -150,8 +152,25 @@ knownDigests, log) {
         const sourceLine = err.sourceLine;
         const displayPath = isUrl ? entryPath : path.relative(process.cwd(), entryPath);
         const loc = sourceLine !== undefined ? `:${sourceLine + 1}` : "";
-        formatDiagnostics([{ message: err instanceof Error ? err.message : String(err) }], log, `${displayPath}${loc}`);
-        return { errorCount: 1, warnCount: 0, staleFiles: [], digests: new Map() };
+        const message = err instanceof Error ? err.message : String(err);
+        formatDiagnostics([{ message }], log, `${displayPath}${loc}`);
+        // A load failure is a diagnostic like any other to a `-o json` consumer;
+        // dropping it there would make the payload disagree with the exit code.
+        return {
+            errorCount: 1,
+            warnCount: 0,
+            diagnostics: [
+                {
+                    file: displayPath,
+                    line: sourceLine !== undefined ? sourceLine + 1 : 1,
+                    column: 1,
+                    severity: "error",
+                    message,
+                },
+            ],
+            staleFiles: [],
+            digests: new Map(),
+        };
     }
 }
 export async function check(argv) {
@@ -168,6 +187,7 @@ export async function check(argv) {
     const session = openSession([...cacheTargets.values()], registryUrl);
     let totalErrors = 0;
     let totalWarns = 0;
+    const allDiagnostics = [];
     for (const p of argv.paths) {
         const cacheTarget = cacheTargetFor(resolveEntryPath(p));
         let outcome = await checkOne(p, registryUrl, session, cacheTarget, cacheWrite, null, log);
@@ -184,9 +204,11 @@ export async function check(argv) {
         }
         totalErrors += outcome.errorCount;
         totalWarns += outcome.warnCount;
+        allDiagnostics.push(...outcome.diagnostics);
     }
+    const out = output();
     if (totalErrors === 0 && totalWarns === 0) {
-        console.log(log.ok("✓") + "  No issues found");
+        out.line(log.ok("✓") + "  No issues found");
     }
     else {
         const parts = [];
@@ -194,10 +216,23 @@ export async function check(argv) {
             parts.push(log.error(`${totalErrors} error${totalErrors !== 1 ? "s" : ""}`));
         if (totalWarns > 0)
             parts.push(log.warn(`${totalWarns} warning${totalWarns !== 1 ? "s" : ""}`));
-        console.log(`\n${parts.join(", ")}`);
+        out.line(`\n${parts.join(", ")}`);
     }
+    // Emitted even when clean: an empty `diagnostics` array is the answer, and a
+    // consumer must not have to treat "no output" as success.
+    out.emit({
+        ok: totalErrors === 0,
+        errorCount: totalErrors,
+        warnCount: totalWarns,
+        diagnostics: allDiagnostics,
+    });
+    // `process.exitCode`, not `process.exit()`: the structured payload was just
+    // written, and on a pipe `write` is asynchronous while `exit` does not flush. A
+    // large diagnostic set exceeds the 64 KB pipe buffer, and truncated JSON is a
+    // parse failure for the one consumer this format exists for. Returning lets
+    // the event loop drain.
     if (totalErrors > 0)
-        process.exit(1);
+        process.exitCode = 1;
 }
 export function checkCommand(yargs) {
     return yargs.command("check <paths..>", "Check one or more Telo manifests for errors without running them", (y) => y