@telorun/cli 0.73.0 → 0.75.0

package/dist/commands/release.js

@@ -0,0 +1,376 @@
+/**
+ * `telo release` — one release system over the modules of a declared workspace.
+ *
+ * `add` writes a fragment; `status` explains what would bump and why; `check` is
+ * the CI gate; `apply` produces the Version PR; `verify` reconciles the ledger
+ * against the registry. `telo publish` still keys off version movement.
+ *
+ * The command reads `telo-workspace.yaml` and **nothing else does**: `run`,
+ * `check`, `publish`, `install`, `upgrade`, `migrate`, `module` and the kernel
+ * behave identically with or without one, which is what keeps a single-manifest
+ * repo, a bare `examples/` directory and a third-party module checkout working
+ * with nothing added.
+ */
+import { LEDGER_PATH, LOCALLY_DERIVED_LAYERS, diffLayerDigests, isFragmentKind, orderByImports, planRelease, serializeFragment, } from "@telorun/analyzer";
+import * as path from "node:path";
+import { readPublishedDigests } from "../bundle/payload-drift.js";
+import { ModulePayloadBuilder } from "../bundle/module-payload.js";
+import { createLogger } from "../logger.js";
+import { outEmit, outErrLine, outLine, outProgress } from "../output.js";
+import { recordLedger, writePlannedVersions } from "../release/apply-plan.js";
+import { collectEvidence, destinationFor } from "../release/evidence.js";
+import { deleteFragment, readFragments, readLedger, writeFragment, writeLedger, } from "../release/ledger-store.js";
+import { planPayload, renderDiagnostics, renderPlan } from "../release/render.js";
+import { loadWorkspace, requireModule } from "../release/workspace.js";
+/**
+ * The publish destination base.
+ *
+ * The ledger's recorded base wins, because the digests beside it were taken
+ * against it — building against a different one produces different manifest
+ * layers and would report every module as changed. A flag or the ambient
+ * variable seeds it for a workspace that has published nothing yet.
+ */
+function resolveRegistry(workspace, argv, ledger) {
+    const recorded = ledger.registry;
+    const requested = argv.registry ?? process.env.TELO_OCI_REGISTRY;
+    if (recorded && requested && recorded !== requested) {
+        throw new Error(`${LEDGER_PATH} records its digests against '${recorded}', but '${requested}' was requested. ` +
+            `Canonicalization writes the destination into every relative import, so the two produce ` +
+            `different manifest bytes. Publish to the recorded base, or re-record the ledger with ` +
+            `\`telo release verify --registry ${requested}\`.`);
+    }
+    const registry = recorded ?? requested;
+    if (!registry) {
+        throw new Error(`No publish destination is known. ${LEDGER_PATH} records none (nothing has been published ` +
+            `from this workspace yet), so pass --registry oci://host/org or set TELO_OCI_REGISTRY. ` +
+            `It is recorded on the first \`telo release apply\`, because the digests only mean ` +
+            `anything against the base they were taken at.`);
+    }
+    return registry.replace(/\/+$/, "");
+}
+async function buildPlan(argv, log) {
+    const workspace = loadWorkspace();
+    const ledger = readLedger(workspace.root);
+    const registry = resolveRegistry(workspace, argv, ledger);
+    const fragments = readFragments(workspace.root);
+    const modules = await collectEvidence(workspace, {
+        registry,
+        baseRef: argv.base,
+        // A ticker, not a diagnostic: sixty-one of these are what a human watching a
+        // two-minute build wants and what a CI log or a `-o json` consumer does not.
+        onModule: (module, index, total) => outProgress(log.err.dim(`  [${index + 1}/${total}] ${module.key}`)),
+    });
+    return { workspace, registry, plan: planRelease({ modules, ledger, fragments, registry }) };
+}
+/** The registry-verifiable half of a digest map. */
+function withoutLocallyDerived(layers) {
+    return Object.fromEntries(Object.entries(layers).filter(([layer]) => !LOCALLY_DERIVED_LAYERS.has(layer)));
+}
+/** The half the registry cannot answer for, kept across a reconciliation. */
+function localOnly(layers) {
+    return Object.fromEntries(Object.entries(layers).filter(([layer]) => LOCALLY_DERIVED_LAYERS.has(layer)));
+}
+function reportDiagnostics(plan, log) {
+    for (const line of renderDiagnostics(plan, log))
+        outErrLine(line);
+    return plan.diagnostics.filter((diagnostic) => diagnostic.severity === "error").length;
+}
+// ---------------------------------------------------------------------------
+// add
+// ---------------------------------------------------------------------------
+/** `<kind>-<slug>.yaml`, so the pending directory sorts by kind and a second
+ *  fragment for the same change is a visible duplicate rather than an
+ *  overwrite. Deliberately not timestamped: a timestamp made every changie
+ *  filename unique and therefore meaningless to read. */
+function fragmentFilename(kinds, body) {
+    const kind = [...kinds][0] ?? "Fixed";
+    const slug = body
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-|-$/g, "")
+        .split("-")
+        .slice(0, 6)
+        .join("-") || "change";
+    return `${kind.toLowerCase()}-${slug}.yaml`;
+}
+async function add(argv) {
+    const log = createLogger(false);
+    const workspace = loadWorkspace();
+    if (!isFragmentKind(argv.kind)) {
+        outErrLine(log.err.error("error") +
+            `  '${argv.kind}' is not a release kind. Use Added, Changed, Deprecated, Removed, ` +
+            `Fixed or Security.`);
+        process.exitCode = 1;
+        return;
+    }
+    const modules = new Map();
+    for (const key of argv.module) {
+        modules.set(requireModule(workspace, key).key, argv.kind);
+    }
+    const source = writeFragment(workspace.root, fragmentFilename(modules.values(), argv.body), serializeFragment(modules, argv.body));
+    outLine(`${log.ok("✓")}  ${source}`);
+    outEmit({ ok: true, fragment: source, modules: [...modules.keys()] });
+}
+// ---------------------------------------------------------------------------
+// status / check
+// ---------------------------------------------------------------------------
+async function status(argv) {
+    const log = createLogger(false);
+    const { plan } = await buildPlan(argv, log);
+    for (const line of renderPlan(plan, log))
+        outLine(line);
+    reportDiagnostics(plan, log);
+    outEmit({ ok: true, ...planPayload(plan) });
+}
+/**
+ * The CI gate.
+ *
+ * It does **not** fail because a payload moved. Under a toolchain bump every
+ * module's digest moves, and demanding sixty hand-written fragments for that
+ * would be a tax on nobody's behalf — those land in the unattributed case, take
+ * a patch, and ship. What it fails on is a plan that cannot be formed: a
+ * fragment naming an unknown module, a major-inducing kind, a manifest version
+ * that disagrees with its ledger entry, or digests taken against another
+ * registry base.
+ */
+async function check(argv) {
+    const log = createLogger(false);
+    const { plan } = await buildPlan(argv, log);
+    for (const line of renderPlan(plan, log))
+        outLine(line);
+    const errors = reportDiagnostics(plan, log);
+    outEmit({ ok: errors === 0, ...planPayload(plan) });
+    if (errors > 0)
+        process.exitCode = 1;
+}
+// ---------------------------------------------------------------------------
+// apply
+// ---------------------------------------------------------------------------
+/**
+ * Write the plan: every manifest a module owns, its changelog, the ledger, and
+ * the fragments consumed.
+ *
+ * The writes live in `release/apply-plan.ts`; this is the wiring — resolve, plan,
+ * report, hand over.
+ */
+async function apply(argv) {
+    const log = createLogger(false);
+    const { workspace, registry, plan } = await buildPlan(argv, log);
+    const errors = reportDiagnostics(plan, log);
+    if (errors > 0) {
+        outEmit({ ok: false, ...planPayload(plan) });
+        process.exitCode = 1;
+        return;
+    }
+    if (plan.modules.length === 0) {
+        outLine("Nothing to release — every module matches the ledger.");
+        outEmit({ ok: true, modules: [] });
+        return;
+    }
+    const applied = writePlannedVersions(workspace, plan, argv.date ?? new Date().toISOString().slice(0, 10));
+    for (const module of applied) {
+        outLine(`${log.ok("✓")}  ${module.key}  ${module.from} → ${module.to}`);
+    }
+    writeLedger(workspace.root, await recordLedger(workspace.root, registry, plan));
+    for (const fragment of plan.fragments)
+        deleteFragment(workspace.root, fragment);
+    outLine(`${log.ok("✓")}  ${LEDGER_PATH}, ${plan.fragments.length} fragment(s) consumed`);
+    outEmit({
+        ok: true,
+        ...planPayload(plan),
+        written: [...applied.flatMap((module) => module.files), LEDGER_PATH],
+    });
+}
+// ---------------------------------------------------------------------------
+// order
+// ---------------------------------------------------------------------------
+/**
+ * The workspace's modules in publish order — a dependency before its dependents.
+ *
+ * Not optional at publish time: canonicalization rewrites a relative import to
+ * `<base>/<sibling>@<version>` and publish then hard-fails when that ref does not
+ * already resolve, so a sibling has to be pushed first. This replaced a regex
+ * that read `imports:` out of the first YAML document by line shape.
+ *
+ * Reads the import graph only — no payloads are built, so it is cheap enough to
+ * call from a release script.
+ */
+async function order(argv) {
+    const workspace = loadWorkspace();
+    const registry = resolveRegistry(workspace, argv, readLedger(workspace.root));
+    const builder = new ModulePayloadBuilder({ cacheRoot: path.join(workspace.root, ".telo") });
+    const byDir = new Map(workspace.modules.map((module) => [path.resolve(module.dir), module]));
+    const evidence = [];
+    for (const module of workspace.modules) {
+        // Only the manifest transform runs here, which is what carries the imports.
+        const imports = module.artifactKind === "image"
+            ? []
+            : (await builder.relativeImportsOf(module.manifestPath, destinationFor(registry, module)))
+                .map((entry) => byDir.get(path.resolve(path.dirname(entry.manifestPath)))?.key)
+                .filter((key) => key !== undefined && key !== module.key);
+        evidence.push({
+            key: module.key,
+            name: module.name,
+            version: module.version,
+            artifactKind: module.artifactKind,
+            layers: {},
+            inlines: new Map(),
+            imports,
+            ownFilesChanged: false,
+        });
+    }
+    const ordered = orderByImports(evidence).map((module) => module.key);
+    for (const key of ordered)
+        outLine(key);
+    outEmit({ ok: true, order: ordered });
+}
+// ---------------------------------------------------------------------------
+// verify
+// ---------------------------------------------------------------------------
+/**
+ * Reconcile the ledger against the registry.
+ *
+ * **Ledger versus registry, not working copy versus registry.** The ledger is a
+ * cache of the registry's answer, so the only question here is whether the cache
+ * is stale — a hand edit, an `apply` whose publish then failed, a push made
+ * outside the pipeline. It builds nothing and reads no local bytes.
+ *
+ * Comparing the local build instead would answer the PUBLISH gate's question
+ * ("am I about to ship changed bytes at an unchanged version?"), which is
+ * `payload-drift.ts`'s job and fires for every module on any commit after a
+ * release — a shared-library edit, a lockfile bump, any source change at all
+ * makes the working copy differ from what is published at the current version.
+ * That is normal and is what `check` plans a bump for; reporting it here made
+ * `verify` shout about all 59 modules and, worse, made `--write` fail to settle
+ * anything, because re-recording the ledger cannot change what the working copy
+ * builds.
+ */
+async function verify(argv) {
+    const log = createLogger(false);
+    const workspace = loadWorkspace();
+    const ledger = readLedger(workspace.root);
+    const registry = resolveRegistry(workspace, argv, ledger);
+    const drifted = [];
+    const repaired = new Map(ledger.modules);
+    const reportDrift = (key, detail) => {
+        drifted.push({ key, detail });
+        outErrLine(`${log.err.warn("drift")}  ${key}: ${detail}`);
+    };
+    // Only the registry-artifact modules are reconciled — an image module has no
+    // published artifact to read a layer index from — so the count is theirs, not
+    // the workspace's, or the ticker would stall at a number it never reaches.
+    const reconciled = workspace.modules.filter((module) => module.artifactKind !== "image");
+    for (const [index, module] of reconciled.entries()) {
+        outProgress(log.err.dim(`  [${index + 1}/${reconciled.length}] ${module.key}`));
+        const recorded = ledger.modules.get(module.key);
+        const published = await readPublishedDigests(destinationFor(registry, module), module.version, registry);
+        if (published === null) {
+            // Nothing published at this version. Not drift on its own — a module that
+            // has never shipped has nothing to disagree with — but a ledger entry for
+            // it is a claim about a version the registry does not have.
+            if (recorded) {
+                reportDrift(module.key, `the ledger records ${module.version}, which is not published`);
+                if (argv.write)
+                    repaired.delete(module.key);
+            }
+            continue;
+        }
+        if (!recorded) {
+            reportDrift(module.key, `published at ${module.version}, but the ledger has no entry`);
+            // Recorded without a `manifest` digest, which nothing here can supply.
+            // `check` then reads that as drift and plans a patch — the safe direction
+            // (bump rather than miss), and the next `apply` fills it in.
+            if (argv.write)
+                repaired.set(module.key, { version: module.version, layers: published });
+            continue;
+        }
+        // Compare only what the registry can answer for. The `manifest` digest is
+        // locally derived and unverifiable by construction (see
+        // LOCALLY_DERIVED_LAYERS), so diffing the whole map would report it as
+        // removed for every module, every run — a permanent false finding.
+        const changes = diffLayerDigests(withoutLocallyDerived(recorded.layers), withoutLocallyDerived(published));
+        if (changes.length > 0) {
+            reportDrift(module.key, `${changes.map((change) => change.layer).join(", ")} — the ledger disagrees with what ` +
+                `is published at ${module.version}`);
+        }
+        // Merge rather than replace, so reconciling the verifiable half does not
+        // discard the half that has no other source.
+        if (argv.write) {
+            repaired.set(module.key, {
+                version: module.version,
+                layers: { ...localOnly(recorded.layers), ...published },
+            });
+        }
+    }
+    if (argv.write) {
+        writeLedger(workspace.root, { registry, modules: repaired });
+        outLine(`${log.ok("✓")}  ${LEDGER_PATH} re-recorded from the registry`);
+    }
+    else if (drifted.length === 0) {
+        outLine(`${log.ok("✓")}  ${LEDGER_PATH} matches the registry`);
+    }
+    outEmit({ ok: drifted.length === 0 || argv.write, drifted });
+    if (drifted.length > 0 && !argv.write)
+        process.exitCode = 1;
+}
+// ---------------------------------------------------------------------------
+// Command
+// ---------------------------------------------------------------------------
+/** Wrap a handler so a workspace/ledger/fragment problem is one actionable line
+ *  rather than a stack trace — these are all "fix the repo state" errors. */
+function guarded(handler) {
+    return async (argv) => {
+        try {
+            await handler(argv);
+        }
+        catch (err) {
+            outErrLine(createLogger(false).err.error("error") +
+                `  ${err instanceof Error ? err.message : String(err)}`);
+            outEmit({ ok: false });
+            process.exitCode = 1;
+        }
+    };
+}
+export function releaseCommand(yargs) {
+    return yargs.command("release <subcommand>", "Plan and apply module version bumps across a workspace", (y) => y
+        .option("registry", {
+        type: "string",
+        describe: "Publish destination base (oci://host/org). Defaults to the ledger's recorded base, then TELO_OCI_REGISTRY.",
+    })
+        .option("base", {
+        type: "string",
+        default: "origin/main",
+        describe: "Git ref the changed-files reading diffs against. Decides only whether a changelog entry is requested.",
+    })
+        .command("add", "Write a pending fragment describing a change", (c) => c
+        .option("module", {
+        type: "string",
+        array: true,
+        demandOption: true,
+        describe: "Module path (modules/sql). Repeat for a change that spans several modules.",
+    })
+        .option("kind", {
+        type: "string",
+        default: "Fixed",
+        describe: "Added | Changed | Deprecated | Removed | Fixed | Security",
+    })
+        .option("body", {
+        type: "string",
+        demandOption: true,
+        describe: "The changelog line",
+    }), guarded(add))
+        .command("status", "Show what would bump and why", (c) => c, guarded(status))
+        .command("order", "List the workspace's modules in publish order (a dependency before its dependents)", (c) => c, guarded(order))
+        .command("check", "Fail when no consistent release plan can be formed", (c) => c, guarded(check))
+        .command("apply", "Write versions, changelogs and the ledger, and consume the fragments", (c) => c.option("date", {
+        type: "string",
+        describe: "Release date for the changelog entries (YYYY-MM-DD). Defaults to today.",
+    }), guarded(apply))
+        .command("verify", "Reconcile the ledger against the registry", (c) => c.option("write", {
+        type: "boolean",
+        default: false,
+        describe: "Re-record the ledger from what the registry actually serves",
+    }), guarded(verify))
+        .demandCommand(1, "Specify a release subcommand (add | status | order | check | apply | verify)"), () => { });
+}
+//# sourceMappingURL=release.js.map

package/dist/commands/release.js.map

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

package/dist/output.d.ts

@@ -20,6 +20,11 @@ export interface Palette {
  *  in a recording pair, so `Output` never reads process globals. */
 export interface OutputStream {
     isTTY?: boolean;
+    /** Terminal width, when the stream is one. A transient progress line is
+     *  truncated to it: a line that wraps occupies two rows, and the erase
+     *  sequence clears only the row the cursor is on, so the overflow would be
+     *  left on screen for the next line to be written over. */
+    columns?: number;
     write(chunk: string): unknown;
 }
 export interface OutputOptions {
@@ -48,13 +53,46 @@ export declare class Output {
     private readonly outStream;
     private readonly errStream;
     constructor(options: OutputOptions);
+    /** Whether a transient progress line is currently on screen, waiting to be
+     *  overwritten. Owned here because the rule it implies — every other write
+     *  must erase it first — has to hold for every write method, and a call site
+     *  that forgot would leave its output glued to the end of a ticker. */
+    private transient;
     get isJson(): boolean;
+    /** Erase a pending transient line, so the next write starts on a clean row.
+     *  `\r` returns to column 0 and `\x1b[2K` clears the row; both are cursor
+     *  control rather than colour, so they are gated on the stream being a TTY and
+     *  not on the palette — a `NO_COLOR` terminal still has a cursor. */
+    private clearTransient;
+    /** Drop any pending progress line without writing anything else. For a
+     *  command that finishes without a further write and would otherwise leave the
+     *  shell prompt sitting after a half-drawn ticker. */
+    endProgress(): void;
     /** Human-readable line on stdout. Suppressed under `-o json`, where stdout is
      *  reserved for the payload. */
     line(text?: string): void;
     /** Human-readable line on stderr. Written in BOTH formats — stderr is not the
      *  machine contract, and silencing it loses the reason a command failed. */
     errLine(text?: string): void;
+    /**
+     * A progress tick on stderr, written only in text format and only to a TTY.
+     *
+     * The distinction this draws is between a **diagnostic** and a **progress
+     * indicator**, and it is why the rule is not the one `errLine` follows.
+     * `errLine` must write in every format because silencing it would lose the
+     * reason a command failed — that is error swallowing. A tick explains nothing.
+     * It is an affordance of the human-formatted mode: something for a person
+     * watching a long operation, so that a two-minute build does not look hung.
+     *
+     * BOTH conditions, because either one alone leaves a case wrong. `-o json`
+     * says the output is a contract, and decorating that run with prose the caller
+     * did not ask for is noise in their terminal whether or not they are looking
+     * at it — the format is the caller's statement of intent, not a guess about
+     * where the bytes land. And a text run redirected into a file or a CI log has
+     * nobody watching either, where sixty ticks bury the output the reader came
+     * for.
+     */
+    progress(text: string): void;
     /** Emit a command's structured RESULT ENVELOPE. A no-op in text mode.
      *
      *  Every command that owns its stdout calls this exactly once, including when
@@ -108,4 +146,6 @@ export declare const outLine: (text?: string) => void;
 export declare const outErrLine: (text?: string) => void;
 export declare const outEmit: (payload: unknown) => void;
 export declare const outDocument: (payload: unknown) => void;
+export declare const outProgress: (text: string) => void;
+export declare const outEndProgress: () => void;
 //# sourceMappingURL=output.d.ts.map

package/dist/output.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../src/output.ts"],"names":[],"mappings":"AAEA;+EAC+E;AAC/E,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,MAAM,CAAC;AAE3C,eAAO,MAAM,cAAc,EAAE,YAAY,EAAqB,CAAC;AAE/D;;;;;;;+DAO+D;AAC/D,MAAM,WAAW,OAAO;IACtB,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAC3B,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAC5B,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;CAC3B;AAiBD;oEACoE;AACpE,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;CAC/B;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CACzB;AAED;;;;;;;;;;;;gEAYgE;AAChE,qBAAa,MAAM;IACjB,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAe;IACzC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAe;gBAE7B,OAAO,EAAE,aAAa;IAkBlC,IAAI,MAAM,IAAI,OAAO,CAEpB;IAED;oCACgC;IAChC,IAAI,CAAC,IAAI,SAAK,GAAG,IAAI;IAIrB;gFAC4E;IAC5E,OAAO,CAAC,IAAI,SAAK,GAAG,IAAI;IAIxB;;;;;;;;;;;;;;kBAcc;IACd,IAAI,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAI5B;;;;;;2EAMuE;IACvE,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAIhC;;;;;;gBAMY;IACZ,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;CAG3B;AAWD,wBAAgB,eAAe,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAE1D;AAED;;;;2CAI2C;AAC3C,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,IAAI,CAM7D;AAED,wBAAgB,MAAM,IAAI,MAAM,CAE/B;AAED;;;gDAGgD;AAChD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,YAAY,CAK9D;AAED;;+EAE+E;AAC/E,eAAO,MAAM,OAAO,GAAI,aAAS,KAAG,IAA0B,CAAC;AAC/D,eAAO,MAAM,UAAU,GAAI,aAAS,KAAG,IAA6B,CAAC;AACrE,eAAO,MAAM,OAAO,GAAI,SAAS,OAAO,KAAG,IAA6B,CAAC;AACzE,eAAO,MAAM,WAAW,GAAI,SAAS,OAAO,KAAG,IAAiC,CAAC"}
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../src/output.ts"],"names":[],"mappings":"AAEA;+EAC+E;AAC/E,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,MAAM,CAAC;AAE3C,eAAO,MAAM,cAAc,EAAE,YAAY,EAAqB,CAAC;AAE/D;;;;;;;+DAO+D;AAC/D,MAAM,WAAW,OAAO;IACtB,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAC3B,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAC5B,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;CAC3B;AAiBD;oEACoE;AACpE,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB;;;+DAG2D;IAC3D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;CAC/B;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CACzB;AAED;;;;;;;;;;;;gEAYgE;AAChE,qBAAa,MAAM;IACjB,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAe;IACzC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAe;gBAE7B,OAAO,EAAE,aAAa;IAkBlC;;;2EAGuE;IACvE,OAAO,CAAC,SAAS,CAAS;IAE1B,IAAI,MAAM,IAAI,OAAO,CAEpB;IAED;;;yEAGqE;IACrE,OAAO,CAAC,cAAc;IAMtB;;0DAEsD;IACtD,WAAW,IAAI,IAAI;IAInB;oCACgC;IAChC,IAAI,CAAC,IAAI,SAAK,GAAG,IAAI;IASrB;gFAC4E;IAC5E,OAAO,CAAC,IAAI,SAAK,GAAG,IAAI;IAKxB;;;;;;;;;;;;;;;;;OAiBG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAW5B;;;;;;;;;;;;;;kBAcc;IACd,IAAI,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAQ5B;;;;;;2EAMuE;IACvE,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAKhC;;;;;;gBAMY;IACZ,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;CAI3B;AA6BD,wBAAgB,eAAe,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAE1D;AAED;;;;2CAI2C;AAC3C,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,IAAI,CAM7D;AAED,wBAAgB,MAAM,IAAI,MAAM,CAE/B;AAED;;;gDAGgD;AAChD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,YAAY,CAK9D;AAED;;+EAE+E;AAC/E,eAAO,MAAM,OAAO,GAAI,aAAS,KAAG,IAA0B,CAAC;AAC/D,eAAO,MAAM,UAAU,GAAI,aAAS,KAAG,IAA6B,CAAC;AACrE,eAAO,MAAM,OAAO,GAAI,SAAS,OAAO,KAAG,IAA6B,CAAC;AACzE,eAAO,MAAM,WAAW,GAAI,SAAS,OAAO,KAAG,IAAiC,CAAC;AACjF,eAAO,MAAM,WAAW,GAAI,MAAM,MAAM,KAAG,IAA8B,CAAC;AAC1E,eAAO,MAAM,cAAc,QAAO,IAA6B,CAAC"}

package/dist/output.js

@@ -45,20 +45,76 @@ export class Output {
         this.stdout = format === "text" ? paletteFor(Boolean(stdout.isTTY), env) : PLAIN;
         this.stderr = paletteFor(Boolean(stderr.isTTY), env);
     }
+    /** Whether a transient progress line is currently on screen, waiting to be
+     *  overwritten. Owned here because the rule it implies — every other write
+     *  must erase it first — has to hold for every write method, and a call site
+     *  that forgot would leave its output glued to the end of a ticker. */
+    transient = false;
     get isJson() {
         return this.format === "json";
     }
+    /** Erase a pending transient line, so the next write starts on a clean row.
+     *  `\r` returns to column 0 and `\x1b[2K` clears the row; both are cursor
+     *  control rather than colour, so they are gated on the stream being a TTY and
+     *  not on the palette — a `NO_COLOR` terminal still has a cursor. */
+    clearTransient() {
+        if (!this.transient)
+            return;
+        this.transient = false;
+        this.errStream.write("\r\x1b[2K");
+    }
+    /** Drop any pending progress line without writing anything else. For a
+     *  command that finishes without a further write and would otherwise leave the
+     *  shell prompt sitting after a half-drawn ticker. */
+    endProgress() {
+        this.clearTransient();
+    }
     /** Human-readable line on stdout. Suppressed under `-o json`, where stdout is
      *  reserved for the payload. */
     line(text = "") {
-        if (this.format === "text")
-            this.outStream.write(`${text}\n`);
+        if (this.format !== "text")
+            return;
+        // Cleared even though this writes to the OTHER stream: both usually land on
+        // one terminal, so a stdout line written over a pending stderr ticker would
+        // start halfway across the row.
+        this.clearTransient();
+        this.outStream.write(`${text}\n`);
     }
     /** Human-readable line on stderr. Written in BOTH formats — stderr is not the
      *  machine contract, and silencing it loses the reason a command failed. */
     errLine(text = "") {
+        this.clearTransient();
         this.errStream.write(`${text}\n`);
     }
+    /**
+     * A progress tick on stderr, written only in text format and only to a TTY.
+     *
+     * The distinction this draws is between a **diagnostic** and a **progress
+     * indicator**, and it is why the rule is not the one `errLine` follows.
+     * `errLine` must write in every format because silencing it would lose the
+     * reason a command failed — that is error swallowing. A tick explains nothing.
+     * It is an affordance of the human-formatted mode: something for a person
+     * watching a long operation, so that a two-minute build does not look hung.
+     *
+     * BOTH conditions, because either one alone leaves a case wrong. `-o json`
+     * says the output is a contract, and decorating that run with prose the caller
+     * did not ask for is noise in their terminal whether or not they are looking
+     * at it — the format is the caller's statement of intent, not a guess about
+     * where the bytes land. And a text run redirected into a file or a CI log has
+     * nobody watching either, where sixty ticks bury the output the reader came
+     * for.
+     */
+    progress(text) {
+        if (this.format !== "text" || !this.errStream.isTTY)
+            return;
+        this.clearTransient();
+        // No newline: this line is TRANSIENT. The next tick overwrites it and any
+        // real output erases it, so a 59-module run leaves behind only the findings
+        // rather than 59 ticks interleaved with them — which is the whole reason a
+        // ticker is bearable at this length at all.
+        this.errStream.write(truncate(text, this.errStream.columns));
+        this.transient = true;
+    }
     /** Emit a command's structured RESULT ENVELOPE. A no-op in text mode.
      *
      *  Every command that owns its stdout calls this exactly once, including when
@@ -75,6 +131,10 @@ export class Output {
      *  whose wire protocol is framed per event precisely because it shares a
      *  stream. */
     emit(payload) {
+        // Unconditionally, including under `text` where nothing is written: every
+        // command reports its result exactly once, so this is the lifecycle point at
+        // which a leftover ticker has to go.
+        this.clearTransient();
         if (this.format === "json")
             this.outStream.write(serialize(payload));
     }
@@ -86,6 +146,7 @@ export class Output {
      *  must keep working under the default `text` format. One serializer with
      *  `emit`, so the CLI has a single JSON encoding rather than three. */
     document(payload) {
+        this.clearTransient();
         this.outStream.write(serialize(payload));
     }
     /** Write verbatim content to stdout, unconditionally and with no framing.
@@ -96,9 +157,30 @@ export class Output {
      *  — the `--json` path wraps them in a document instead and never reaches
      *  here. */
     raw(content) {
+        this.clearTransient();
         this.outStream.write(content);
     }
 }
+/** Clip to the terminal width, measuring PRINTABLE characters so the escapes a
+ *  palette wrapped the text in do not count toward it. A line that wraps
+ *  occupies two rows and the erase sequence clears one. */
+function truncate(text, columns) {
+    if (!columns || columns < 8)
+        return text;
+    let printable = 0;
+    for (let i = 0; i < text.length; i++) {
+        // Skip a CSI sequence wholesale: `\x1b[` … a final byte in `@`–`~`.
+        if (text[i] === "\x1b" && text[i + 1] === "[") {
+            i += 2;
+            while (i < text.length && !/[@-~]/.test(text[i]))
+                i++;
+            continue;
+        }
+        if (++printable > columns - 1)
+            return `${text.slice(0, i)}…`;
+    }
+    return text;
+}
 function serialize(payload) {
     return `${JSON.stringify(payload, null, 2)}\n`;
 }
@@ -140,4 +222,6 @@ export const outLine = (text = "") => current.line(text);
 export const outErrLine = (text = "") => current.errLine(text);
 export const outEmit = (payload) => current.emit(payload);
 export const outDocument = (payload) => current.document(payload);
+export const outProgress = (text) => current.progress(text);
+export const outEndProgress = () => current.endProgress();
 //# sourceMappingURL=output.js.map

package/dist/output.js.map

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