@united-workforce/cli 0.3.0 → 0.5.0

package/dist/concurrency/concurrency.js

@@ -0,0 +1,216 @@
+import { unlinkSync } from "node:fs";
+import { mkdir, readdir, rm, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+import { isPidAlive } from "../background/index.js";
+/** Default concurrency limit when no config or flag is provided. */
+export const DEFAULT_MAX_RUNNING = 2;
+/** Default poll interval (ms) for waiting on a slot. */
+const DEFAULT_POLL_INTERVAL_MS = 2000;
+/**
+ * Get the path to the slots directory.
+ */
+export function getSlotsDir(storageRoot) {
+    return join(storageRoot, "slots");
+}
+/**
+ * Count active slot files (alive PIDs only). Stale slots are skipped but not removed.
+ */
+export async function countActiveSlots(storageRoot) {
+    const slotsDir = getSlotsDir(storageRoot);
+    let files;
+    try {
+        files = await readdir(slotsDir);
+    }
+    catch {
+        return 0;
+    }
+    let count = 0;
+    for (const file of files) {
+        if (!file.endsWith(".slot")) {
+            continue;
+        }
+        const pidStr = file.slice(0, -5);
+        const pid = Number(pidStr);
+        if (Number.isNaN(pid)) {
+            continue;
+        }
+        if (isPidAlive(pid)) {
+            count++;
+        }
+    }
+    return count;
+}
+/**
+ * Remove slot files whose PIDs are no longer alive.
+ * Returns the number of stale slots cleaned.
+ */
+export async function cleanStaleSlots(storageRoot) {
+    const slotsDir = getSlotsDir(storageRoot);
+    let files;
+    try {
+        files = await readdir(slotsDir);
+    }
+    catch {
+        return 0;
+    }
+    let cleaned = 0;
+    for (const file of files) {
+        if (!file.endsWith(".slot")) {
+            continue;
+        }
+        const pidStr = file.slice(0, -5);
+        const pid = Number(pidStr);
+        if (Number.isNaN(pid)) {
+            continue;
+        }
+        if (!isPidAlive(pid)) {
+            try {
+                await rm(join(slotsDir, file), { force: true });
+                cleaned++;
+            }
+            catch {
+                // Ignore removal errors (race with another cleanup)
+            }
+        }
+    }
+    return cleaned;
+}
+/**
+ * Create a slot file for the current process. Returns the path to the created file.
+ */
+async function writeSlotFile(storageRoot) {
+    const slotsDir = getSlotsDir(storageRoot);
+    await mkdir(slotsDir, { recursive: true });
+    const slotPath = join(slotsDir, `${process.pid}.slot`);
+    await writeFile(slotPath, "", "utf8");
+    return slotPath;
+}
+/**
+ * Remove a slot file. Idempotent — silently ignores missing file.
+ */
+async function removeSlotFile(slotPath) {
+    try {
+        await rm(slotPath, { force: true });
+    }
+    catch {
+        // Already removed or race condition — safe to ignore
+    }
+}
+function sleep(ms, signal) {
+    return new Promise((resolve, reject) => {
+        if (signal?.aborted) {
+            reject(new Error("aborted"));
+            return;
+        }
+        const timer = setTimeout(resolve, ms);
+        if (signal !== null) {
+            const onAbort = () => {
+                clearTimeout(timer);
+                reject(new Error("aborted"));
+            };
+            signal.addEventListener("abort", onAbort, { once: true });
+        }
+    });
+}
+/**
+ * Try to claim a slot. Returns the slot path on success, null if a race was
+ * detected (post-write count exceeds maxRunning → rolls back).
+ */
+async function tryClaimSlot(storageRoot, maxRunning) {
+    const slotPath = await writeSlotFile(storageRoot);
+    const postWriteCount = await countActiveSlots(storageRoot);
+    if (postWriteCount > maxRunning) {
+        await removeSlotFile(slotPath);
+        return null;
+    }
+    return slotPath;
+}
+function createSlotHandle(slotPath) {
+    let released = false;
+    return {
+        slotPath,
+        release: async () => {
+            if (released)
+                return;
+            released = true;
+            await removeSlotFile(slotPath);
+        },
+    };
+}
+function resolveOptions(options) {
+    return {
+        onWaiting: options.onWaiting ?? null,
+        onAcquired: options.onAcquired ?? null,
+        pollIntervalMs: options.pollIntervalMs ?? DEFAULT_POLL_INTERVAL_MS,
+        signal: options.signal ?? null,
+    };
+}
+function notifyWaiting(opts, waited, message) {
+    if (!waited && opts.onWaiting !== null) {
+        opts.onWaiting(message);
+        return true;
+    }
+    return waited;
+}
+/**
+ * Acquire a concurrency slot. If all slots are occupied, polls until one is available.
+ *
+ * Race protection: after writing the slot file, double-checks countActiveSlots.
+ * If the count exceeds maxRunning, rolls back (removes own slot) and retries.
+ */
+export async function acquireSlot(storageRoot, maxRunning, options = {}) {
+    const opts = resolveOptions(options);
+    let waited = false;
+    while (true) {
+        await cleanStaleSlots(storageRoot);
+        const currentCount = await countActiveSlots(storageRoot);
+        if (currentCount >= maxRunning) {
+            waited = notifyWaiting(opts, waited, `${currentCount}/${maxRunning} running`);
+            await sleep(opts.pollIntervalMs, opts.signal);
+            continue;
+        }
+        const slotPath = await tryClaimSlot(storageRoot, maxRunning);
+        if (slotPath === null) {
+            waited = notifyWaiting(opts, waited, `race detected, retrying`);
+            await sleep(opts.pollIntervalMs, opts.signal);
+            continue;
+        }
+        if (waited && opts.onAcquired !== null) {
+            opts.onAcquired();
+        }
+        return createSlotHandle(slotPath);
+    }
+}
+/**
+ * Alias for SlotHandle.release() — explicit function form for callers that
+ * prefer passing the handle as an argument.
+ */
+export async function releaseSlot(handle) {
+    await handle.release();
+}
+/**
+ * Install process signal handlers that release the slot on SIGINT/SIGTERM.
+ * Returns a cleanup function that removes the handlers (call on normal exit).
+ */
+export function installSlotCleanup(handle) {
+    const cleanup = () => {
+        try {
+            unlinkSync(handle.slotPath);
+        }
+        catch {
+            // Already removed
+        }
+    };
+    const onSignal = () => {
+        cleanup();
+        process.exit(1);
+    };
+    process.on("SIGINT", onSignal);
+    process.on("SIGTERM", onSignal);
+    // Return a function to uninstall the handlers
+    return () => {
+        process.removeListener("SIGINT", onSignal);
+        process.removeListener("SIGTERM", onSignal);
+    };
+}
+//# sourceMappingURL=concurrency.js.map

package/dist/concurrency/concurrency.js.map

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

package/dist/concurrency/index.d.ts

@@ -0,0 +1,3 @@
+export { acquireSlot, cleanStaleSlots, countActiveSlots, DEFAULT_MAX_RUNNING, getSlotsDir, installSlotCleanup, releaseSlot, } from "./concurrency.js";
+export type { AcquireSlotOptions, SlotHandle } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/concurrency/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/concurrency/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EACX,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,WAAW,EACX,kBAAkB,EAClB,WAAW,GACZ,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC"}

package/dist/concurrency/index.js

@@ -0,0 +1,2 @@
+export { acquireSlot, cleanStaleSlots, countActiveSlots, DEFAULT_MAX_RUNNING, getSlotsDir, installSlotCleanup, releaseSlot, } from "./concurrency.js";
+//# sourceMappingURL=index.js.map

package/dist/concurrency/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/concurrency/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EACX,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,WAAW,EACX,kBAAkB,EAClB,WAAW,GACZ,MAAM,kBAAkB,CAAC"}

package/dist/concurrency/types.d.ts

@@ -0,0 +1,19 @@
+/** Handle returned by acquireSlot; call release() to free the slot. */
+export type SlotHandle = {
+    /** Remove the slot file. Idempotent — second call is a no-op. */
+    release: () => Promise<void>;
+    /** The slot file path (for signal-handler cleanup). */
+    slotPath: string;
+};
+/** Options for acquireSlot polling behavior and callbacks. */
+export type AcquireSlotOptions = {
+    /** Called when the function starts waiting (all slots occupied). */
+    onWaiting: ((info: string) => void) | null;
+    /** Called when a slot becomes available after waiting. */
+    onAcquired: (() => void) | null;
+    /** Poll interval in milliseconds (default: 2000). */
+    pollIntervalMs: number;
+    /** AbortSignal to cancel waiting. */
+    signal: AbortSignal | null;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/concurrency/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/concurrency/types.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,MAAM,MAAM,UAAU,GAAG;IACvB,iEAAiE;IACjE,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B,uDAAuD;IACvD,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,8DAA8D;AAC9D,MAAM,MAAM,kBAAkB,GAAG;IAC/B,oEAAoE;IACpE,SAAS,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC;IAC3C,0DAA0D;IAC1D,UAAU,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,CAAC;IAChC,qDAAqD;IACrD,cAAc,EAAE,MAAM,CAAC;IACvB,qCAAqC;IACrC,MAAM,EAAE,WAAW,GAAG,IAAI,CAAC;CAC5B,CAAC"}

package/dist/concurrency/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/concurrency/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/concurrency/types.ts"],"names":[],"mappings":""}

package/dist/format.d.ts

@@ -1,3 +1,70 @@
-export type OutputFormat = "json" | "yaml";
-export declare function formatOutput(data: unknown, format: OutputFormat): string;
+import type { Hash, Store } from "@ocas/core";
+import type { OutputSchemaName } from "@united-workforce/protocol";
+import type { UwfSchemaHashes } from "./schemas.js";
+/**
+ * Five output formats supported by the uwf CLI. `text` is the default and
+ * produces a Liquid-rendered human-readable view. `json` and `yaml` wrap the
+ * payload in an ocas envelope `{ type, value }` for self-describing output.
+ * `raw-json` and `raw-yaml` emit the bare value, preserving 0.5.0 byte-for-byte
+ * output for backward-compat consumers.
+ */
+export type OutputFormat = "text" | "json" | "yaml" | "raw-json" | "raw-yaml";
+export declare const SUPPORTED_FORMATS: readonly OutputFormat[];
+export declare function isOutputFormat(v: string): v is OutputFormat;
+/**
+ * Per-command text renderer registry. Maps a fully-qualified command path
+ * (e.g. `"thread list"`, `"workflow show"`) to a function that converts
+ * the command's payload into a human-readable string.
+ *
+ * Renderers must:
+ * - Always return a `string` (never `undefined`).
+ * - Tolerate missing/null fields without throwing.
+ *
+ * The Liquid template path inside `writeEnvelope` is the primary rendering
+ * implementation. This registry exists so callers without a CAS store
+ * (tests, library consumers) can resolve `text` rendering, and so
+ * `formatOutput(data, "text", commandPath)` returns a meaningful string.
+ */
+export type TextRenderer = (data: unknown) => string;
+export declare const TEXT_RENDERERS: Record<string, TextRenderer>;
+/** Look up a registered text renderer by command path. */
+export declare function getTextRenderer(commandPath: string): TextRenderer | undefined;
+/** Register (or override) a text renderer for a command path. */
+export declare function registerTextRenderer(commandPath: string, renderer: TextRenderer): void;
+/**
+ * Format a payload as a string in the requested output format.
+ *
+ * For `"text"`, `formatOutput` looks up the registered renderer for
+ * `commandPath` (when provided) and falls back to a JSON serialization when
+ * no renderer is registered. The result is always a `string` — never
+ * `undefined`. For `"json"` and `"yaml"` the bare value is serialized.
+ * For `"raw-json"` and `"raw-yaml"` the output is identical to `"json"` /
+ * `"yaml"` (both modes emit the bare value; envelope wrapping happens in
+ * `writeEnvelope`).
+ *
+ * Note: this is the legacy in-process formatter used by raw output paths
+ * (`thread cancel`, `step fork`, `setup`, `log/config`) and tests. Production
+ * commands with a registered output schema go through `writeEnvelope`.
+ */
+export declare function formatOutput(data: unknown, format: OutputFormat, commandPath?: string): string;
+/**
+ * Resolve the CAS hash for an output schema by short name, caching the result
+ * for the lifetime of the process.
+ */
+export declare function resolveOutputSchemaHash(outputs: Record<OutputSchemaName, Hash>, schemaName: OutputSchemaName): Hash;
+export type WriteEnvelopeOptions = {
+    format: OutputFormat;
+    store: Store;
+    schemas: UwfSchemaHashes;
+};
+/**
+ * Wrap a CLI command payload in the chosen format and write it to stdout.
+ *
+ * - `text`     → Liquid template at `@ocas/template/text/<hash>` (fallback YAML envelope)
+ * - `json`     → `{"type":<hash>,"value":<payload>}` (envelope JSON)
+ * - `yaml`     → envelope as multi-line YAML
+ * - `raw-json` → bare `<payload>` (legacy 0.5.0 shape)
+ * - `raw-yaml` → bare `<payload>` (legacy 0.5.0 shape)
+ */
+export declare function writeEnvelope(payload: unknown, schemaName: OutputSchemaName, options: WriteEnvelopeOptions): Promise<void>;
 //# sourceMappingURL=format.d.ts.map

package/dist/format.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../src/format.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,MAAM,CAAC;AAE3C,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,GAAG,MAAM,CAOxE"}
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../src/format.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAGnE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAkBpD;;;;;;GAMG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,UAAU,GAAG,UAAU,CAAC;AAE9E,eAAO,MAAM,iBAAiB,EAAE,SAAS,YAAY,EAMpD,CAAC;AAEF,wBAAgB,cAAc,CAAC,CAAC,EAAE,MAAM,GAAG,CAAC,IAAI,YAAY,CAE3D;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,IAAI,EAAE,OAAO,KAAK,MAAM,CAAC;AAErD,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAevD,CAAC;AAEF,0DAA0D;AAC1D,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAE7E;AAED,iEAAiE;AACjE,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,GAAG,IAAI,CAEtF;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAoB9F;AAID;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,MAAM,CAAC,gBAAgB,EAAE,IAAI,CAAC,EACvC,UAAU,EAAE,gBAAgB,GAC3B,IAAI,CASN;AAED,MAAM,MAAM,oBAAoB,GAAG;IACjC,MAAM,EAAE,YAAY,CAAC;IACrB,KAAK,EAAE,KAAK,CAAC;IACb,OAAO,EAAE,eAAe,CAAC;CAC1B,CAAC;AAEF;;;;;;;;GAQG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,OAAO,EAChB,UAAU,EAAE,gBAAgB,EAC5B,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,IAAI,CAAC,CA2Bf"}

package/dist/format.js

@@ -1,10 +1,207 @@
+import { Liquid } from "liquidjs";
 import { stringify } from "yaml";
-export function formatOutput(data, format) {
+import { renderConfigGet, renderConfigList, renderConfigSet, renderLogList, renderLogShow, renderStepList, renderStepShow, renderThreadCancel, renderThreadList, renderThreadShow, renderThreadStart, renderThreadStop, renderWorkflowList, renderWorkflowShow, } from "./text-renderers.js";
+export const SUPPORTED_FORMATS = [
+    "text",
+    "json",
+    "yaml",
+    "raw-json",
+    "raw-yaml",
+];
+export function isOutputFormat(v) {
+    return SUPPORTED_FORMATS.includes(v);
+}
+export const TEXT_RENDERERS = {
+    "thread list": renderThreadList,
+    "thread show": renderThreadShow,
+    "thread start": renderThreadStart,
+    "thread cancel": renderThreadCancel,
+    "thread stop": renderThreadStop,
+    "workflow list": renderWorkflowList,
+    "workflow show": renderWorkflowShow,
+    "step list": renderStepList,
+    "step show": renderStepShow,
+    "config list": renderConfigList,
+    "config get": renderConfigGet,
+    "config set": renderConfigSet,
+    "log list": renderLogList,
+    "log show": renderLogShow,
+};
+/** Look up a registered text renderer by command path. */
+export function getTextRenderer(commandPath) {
+    return TEXT_RENDERERS[commandPath];
+}
+/** Register (or override) a text renderer for a command path. */
+export function registerTextRenderer(commandPath, renderer) {
+    TEXT_RENDERERS[commandPath] = renderer;
+}
+/**
+ * Format a payload as a string in the requested output format.
+ *
+ * For `"text"`, `formatOutput` looks up the registered renderer for
+ * `commandPath` (when provided) and falls back to a JSON serialization when
+ * no renderer is registered. The result is always a `string` — never
+ * `undefined`. For `"json"` and `"yaml"` the bare value is serialized.
+ * For `"raw-json"` and `"raw-yaml"` the output is identical to `"json"` /
+ * `"yaml"` (both modes emit the bare value; envelope wrapping happens in
+ * `writeEnvelope`).
+ *
+ * Note: this is the legacy in-process formatter used by raw output paths
+ * (`thread cancel`, `step fork`, `setup`, `log/config`) and tests. Production
+ * commands with a registered output schema go through `writeEnvelope`.
+ */
+export function formatOutput(data, format, commandPath) {
     switch (format) {
         case "json":
+        case "raw-json":
             return JSON.stringify(data);
         case "yaml":
+        case "raw-yaml":
             return stringify(data, { aliasDuplicateObjects: false }).trimEnd();
+        case "text": {
+            if (commandPath !== undefined) {
+                const renderer = TEXT_RENDERERS[commandPath];
+                if (renderer !== undefined) {
+                    return renderer(data);
+                }
+            }
+            // Fallback: JSON pretty-printed so `formatOutput(_, "text")` never returns
+            // `"undefined"` (the bug from issue #327).
+            return JSON.stringify(data, null, 2);
+        }
+    }
+}
+const schemaHashCache = new Map();
+/**
+ * Resolve the CAS hash for an output schema by short name, caching the result
+ * for the lifetime of the process.
+ */
+export function resolveOutputSchemaHash(outputs, schemaName) {
+    const cached = schemaHashCache.get(schemaName);
+    if (cached !== undefined)
+        return cached;
+    const hash = outputs[schemaName];
+    if (hash === undefined) {
+        throw new Error(`output schema not registered: @uwf/output/${schemaName}`);
+    }
+    schemaHashCache.set(schemaName, hash);
+    return hash;
+}
+/**
+ * Wrap a CLI command payload in the chosen format and write it to stdout.
+ *
+ * - `text`     → Liquid template at `@ocas/template/text/<hash>` (fallback YAML envelope)
+ * - `json`     → `{"type":<hash>,"value":<payload>}` (envelope JSON)
+ * - `yaml`     → envelope as multi-line YAML
+ * - `raw-json` → bare `<payload>` (legacy 0.5.0 shape)
+ * - `raw-yaml` → bare `<payload>` (legacy 0.5.0 shape)
+ */
+export async function writeEnvelope(payload, schemaName, options) {
+    const { format, store, schemas } = options;
+    const schemaHash = resolveOutputSchemaHash(schemas.outputs, schemaName);
+    let body;
+    switch (format) {
+        case "json":
+            body = JSON.stringify({ type: schemaHash, value: payload });
+            break;
+        case "yaml":
+            body = stringify({ type: schemaHash, value: payload }, { aliasDuplicateObjects: false }).trimEnd();
+            break;
+        case "raw-json":
+            body = JSON.stringify(payload);
+            break;
+        case "raw-yaml":
+            body = stringify(payload, { aliasDuplicateObjects: false }).trimEnd();
+            break;
+        case "text":
+            body = await renderEnvelopeText(store, schemaHash, payload, schemaName);
+            break;
+    }
+    process.stdout.write(`${body}\n`);
+}
+let liquidEngine = null;
+function firstRole(graph, current) {
+    const transitions = graph[current];
+    if (!transitions)
+        return null;
+    const firstKey = Object.keys(transitions)[0];
+    if (firstKey === undefined)
+        return null;
+    const next = transitions[firstKey]?.role;
+    return typeof next === "string" ? next : null;
+}
+function buildGraphPath(graph, start, limit) {
+    const out = [start];
+    const seen = new Set([start]);
+    let cur = start;
+    while (out.length < limit) {
+        const next = firstRole(graph, cur);
+        if (next === null || next === "$END") {
+            out.push("$END");
+            break;
+        }
+        if (seen.has(next))
+            break;
+        seen.add(next);
+        out.push(next);
+        cur = next;
+    }
+    return out;
+}
+function getLiquidEngine() {
+    if (liquidEngine !== null)
+        return liquidEngine;
+    const engine = new Liquid({ cache: false, strictFilters: false, strictVariables: false });
+    engine.registerFilter("keys", (input) => input !== null && typeof input === "object" ? Object.keys(input) : []);
+    engine.registerFilter("graph_path", (graph, start, max) => {
+        if (graph === null || typeof graph !== "object")
+            return [];
+        const limit = typeof max === "number" ? max : 5;
+        const startNode = typeof start === "string" ? start : "$START";
+        return buildGraphPath(graph, startNode, limit);
+    });
+    liquidEngine = engine;
+    return engine;
+}
+function readTemplateContent(store, schemaHash) {
+    const varName = `@ocas/template/text/${schemaHash}`;
+    const variable = store.var.get(varName);
+    if (variable === null)
+        return null;
+    const node = store.cas.get(variable.value);
+    if (node === null)
+        return null;
+    if (typeof node.payload !== "string")
+        return null;
+    return node.payload;
+}
+function buildLiquidContext(payload, schemaHash) {
+    const ctx = { payload, type: schemaHash };
+    if (payload !== null && typeof payload === "object" && !Array.isArray(payload)) {
+        for (const [k, v] of Object.entries(payload)) {
+            if (k !== "payload" && k !== "type") {
+                ctx[k] = v;
+            }
+        }
+    }
+    return ctx;
+}
+async function renderEnvelopeText(store, schemaHash, payload, schemaName) {
+    const template = readTemplateContent(store, schemaHash);
+    if (template === null) {
+        process.stderr.write(`warning: missing text template for @uwf/output/${schemaName} (var @ocas/template/text/${schemaHash}); falling back to YAML\n`);
+        return stringify({ type: schemaHash, value: payload }, { aliasDuplicateObjects: false }).trimEnd();
+    }
+    try {
+        const engine = getLiquidEngine();
+        const context = buildLiquidContext(payload, schemaHash);
+        const out = await engine.parseAndRender(template, context);
+        return out.replace(/\n+$/, "");
+    }
+    catch (e) {
+        const message = e instanceof Error ? e.message : String(e);
+        process.stderr.write(`warning: failed to render text template for @uwf/output/${schemaName}: ${message}; falling back to YAML\n`);
+        return stringify({ type: schemaHash, value: payload }, { aliasDuplicateObjects: false }).trimEnd();
     }
 }
 //# sourceMappingURL=format.js.map

package/dist/format.js.map

@@ -1 +1 @@
-{"version":3,"file":"format.js","sourceRoot":"","sources":["../src/format.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,MAAM,CAAC;AAIjC,MAAM,UAAU,YAAY,CAAC,IAAa,EAAE,MAAoB;IAC9D,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,MAAM;YACT,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAC9B,KAAK,MAAM;YACT,OAAO,SAAS,CAAC,IAAI,EAAE,EAAE,qBAAqB,EAAE,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;IACvE,CAAC;AACH,CAAC"}
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../src/format.ts"],"names":[],"mappings":"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"}