zyrk 0.7.2 → 0.7.3

package/README.md

@@ -143,7 +143,9 @@ still take precedence.
 
 Use `zyrk run <script>` or the package-manager shortcut `zyrk <script>`; both
 use the same project-script policy, installed-generation checks, and local
-binary path. Arguments after `--` are passed to the script:
+binary path. Run the shortcut from a directory whose `package.json` declares
+that script; for example, run `cd web` before `zyrk dev` when the script belongs
+to `web/package.json`. Arguments after `--` are passed to the script:
 
 ```bash
 zyrk dev
@@ -456,14 +458,18 @@ overrides are ignored, matching npm root-only policy. Override rule order is
 recorded in the manifest fingerprint; frozen installs reject policy drift.
 
 `zyrk help` and `zyrk --help` both show help successfully. Installs report
-preparation, resolution, verified source counts, realization, approved builds,
-and project linking on stderr. Interactive terminals show an activity spinner;
-redirected output contains plain progress messages. Both `zyrk add prettier` and
-`zyrk install prettier` show these details. Source counters distinguish verified
-reuse from newly downloaded sources; downloads show received bytes. A checkmark
-lists each unique package/version linked after the project transaction commits.
-Source counts differ from dependency contexts when peers split a package.
-`--json` disables progress.
+preparation, verified source counts, realization, approved builds, and project
+linking on stderr. Interactive terminals show the stages as a calm, multi-line
+sequence, followed by a success footer; package downloads show received bytes,
+and a checkmark lists each unique package/version linked after the project
+transaction commits. Both `zyrk add prettier` and `zyrk install prettier` show
+these details. Redirected output uses plain progress messages. Source counters
+distinguish verified reuse from newly downloaded sources. Source counts differ
+from dependency contexts when peers split a package. `--json` disables progress.
+Other native commands use the same terminal language: successful summaries get
+a checkmark, structured inspection output is rendered readably, and actionable
+errors show their stable code and remedy together. `NO_COLOR=1` or `TERM=dumb`
+disables color; redirected output and `--json` remain plain and script-friendly.
 
 Install resolution has a five-minute deadline, registry requests (including
 archive downloads) have a fifteen-minute deadline, a complete fetch operation

package/VERSION

@@ -1 +1 @@
-v0.7.2
+v0.7.3

package/dist/cli/main.d.ts

@@ -28,6 +28,7 @@ export type RunCliOptions = {
     stdin?: NodeJS.ReadStream;
     stdout: {
         write(chunk: string): unknown;
+        isTTY?: boolean;
     };
     stderr: {
         write(chunk: string): unknown;

package/dist/cli/main.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../src/cli/main.ts"],"names":[],"mappings":"AA+BA,OAAO,EAAe,SAAS,EAAe,MAAM,cAAc,CAAC;AACnE,OAAO,EAAE,SAAS,EAAE,CAAC;AACrB,OAAO,EAAoB,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAExE,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAM3C,OAAO,EAAqC,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AAEhF,eAAO,MAAM,uBAAuB,IAAI,CAAC;AA6DzC,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CA0BhD;AAED,MAAM,MAAM,SAAS,GAAG;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AA6EF;;;GAGG;AACH,wBAAgB,QAAQ,CACtB,MAAM,EAAE,UAAU,EAClB,OAAO,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC,UAAU,CAAA;CAAE,GACnD,SAAS,CAgDX;AAmBD,MAAM,MAAM,eAAe,GAAG;IAC5B,KAAK,EAAE,KAAK,CAAC;IACb,QAAQ,EAAE,cAAc,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACxB,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IAC1B,MAAM,EAAE;QAAE,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC;IAC1C,MAAM,EAAE;QAAE,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IAC3D,WAAW,CAAC,EAAE,MAAM,MAAM,CAAC;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,OAAO,CAAC,eAAe,CAAC,CAAC;CACxC,CAAC;AAuDF,gFAAgF;AAChF,wBAAsB,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CA2fpE"}
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../src/cli/main.ts"],"names":[],"mappings":"AAoCA,OAAO,EAAe,SAAS,EAAe,MAAM,cAAc,CAAC;AACnE,OAAO,EAAE,SAAS,EAAE,CAAC;AACrB,OAAO,EAAoB,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAExE,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAM3C,OAAO,EAAqC,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AAEhF,eAAO,MAAM,uBAAuB,IAAI,CAAC;AAmFzC,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CA0BhD;AAED,MAAM,MAAM,SAAS,GAAG;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AA6EF;;;GAGG;AACH,wBAAgB,QAAQ,CACtB,MAAM,EAAE,UAAU,EAClB,OAAO,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC,UAAU,CAAA;CAAE,GACnD,SAAS,CAgDX;AAmBD,MAAM,MAAM,eAAe,GAAG;IAC5B,KAAK,EAAE,KAAK,CAAC;IACb,QAAQ,EAAE,cAAc,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACxB,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IAC1B,MAAM,EAAE;QAAE,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IAC3D,MAAM,EAAE;QAAE,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IAC3D,WAAW,CAAC,EAAE,MAAM,MAAM,CAAC;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,OAAO,CAAC,eAAe,CAAC,CAAC;CACxC,CAAC;AAuDF,gFAAgF;AAChF,wBAAsB,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CAiiBpE"}

package/dist/cli/main.js

@@ -1,5 +1,6 @@
 import { runNextCommand } from "../commands/next.js";
 import { createInstallProgress } from "./progress.js";
+import { renderCommandError, renderCommandOutput } from "./terminal.js";
 import { runMaintenanceCommand } from "../commands/maintenance.js";
 import { runDeployCommand } from "../commands/deploy.js";
 import { runPatchCommand } from "../commands/patch.js";
@@ -9,7 +10,7 @@ import { sanitizeDiagnostic, redactSecrets } from "../log.js";
  * operations preserve npm arguments. Global install rejection precedes effects.
  * Unsupported command modes fail explicitly in their handler.
  */
-import { installProject } from "../install/run.js";
+import { installProject, } from "../install/run.js";
 import { installRegistry } from "../install/registry.js";
 import { readFileSync } from "node:fs";
 import { readFile } from "node:fs/promises";
@@ -29,6 +30,26 @@ import { Store } from "../store/layout.js";
 import { delegateToNpm, delegatedHelpLines, isDelegatedCommand, } from "./npm-delegate.js";
 import { isGlobalInstallRequest, parseArgs } from "./parse.js";
 export const CLI_JSON_SCHEMA_VERSION = 1;
+function installCompletion(readiness) {
+    switch (readiness) {
+        case "ready":
+            return {
+                title: "Installed from the verified shared store.",
+                detail: "Your project still uses node_modules and normal imports.",
+            };
+        case "intentionally-unbuilt":
+            return {
+                title: "Installed; some dependency builds were intentionally skipped.",
+                detail: "Review build policy before running packages that need those builds.",
+            };
+        case "fetched":
+            return { title: "Verified package sources in the shared store." };
+        case "lockfile-only":
+            return { title: "Lockfile updated; dependencies were not installed." };
+        case "build-review":
+            return { title: "Build review saved; dependency scripts were not run." };
+    }
+}
 /** Spec-defined dependency commands (SPEC 15.1-15.2, fetch, docker). */
 const NATIVE_COMMANDS = [
     ["install, i", "Install the locked or newly resolved graph."],
@@ -253,10 +274,29 @@ export async function runCli(options) {
     const parsed = parseArgs(options.argv);
     const version = (options.readVersion ?? readCliVersion)();
     const emit = (result) => {
+        const interactive = !parsed.json &&
+            !parsed.help &&
+            !parsed.version &&
+            options.stdout.isTTY === true &&
+            parsed.command !== undefined &&
+            !isDelegatedCommand(parsed.command);
+        const style = {
+            isTTY: interactive,
+            color: interactive &&
+                options.env.NO_COLOR === undefined &&
+                options.env.TERM !== "dumb",
+        };
         if (result.stdout !== "")
-            options.stdout.write(result.stdout);
+            options.stdout.write(interactive
+                ? renderCommandOutput(parsed.command ?? "command", result.stdout, style)
+                : result.stdout);
         if (result.stderr !== "")
-            options.stderr.write(result.stderr);
+            options.stderr.write(result.exitCode !== 0
+                ? renderCommandError(result.stderr, {
+                    ...style,
+                    isTTY: options.stderr.isTTY === true && !parsed.json,
+                })
+                : result.stderr);
         return result.exitCode;
     };
     if (!parsed.help &&
@@ -443,7 +483,9 @@ export async function runCli(options) {
         (parsed.command === "install" || parsed.command === "i")) {
         if (isGlobalInstallRequest(parsed.command, parsed.commandArgs, options.env))
             return emit(fail(globalInstallError(parsed.command), parsed));
-        const progress = createInstallProgress(options.stderr, parsed.json);
+        const progress = createInstallProgress(options.stderr, parsed.json, {
+            color: options.env.NO_COLOR === undefined && options.env.TERM !== "dumb",
+        });
         try {
             if (parsed.commandArgs.includes("--help") ||
                 parsed.commandArgs.includes("-h")) {
@@ -507,7 +549,7 @@ export async function runCli(options) {
                     : {}),
                 ...tools,
             });
-            progress.close();
+            progress.close(installCompletion(result.readiness));
             if (parsed.json)
                 return emit({
                     exitCode: 0,
@@ -548,7 +590,9 @@ export async function runCli(options) {
             parsed.command === "remove" ||
             parsed.command === "update" ||
             parsed.command === "import")) {
-        const progress = createInstallProgress(options.stderr, parsed.json);
+        const progress = createInstallProgress(options.stderr, parsed.json, {
+            color: options.env.NO_COLOR === undefined && options.env.TERM !== "dumb",
+        });
         try {
             const tools = options.tools === undefined
                 ? await defaultTools(options.env, version, options.cwd ?? process.cwd())
@@ -567,7 +611,10 @@ export async function runCli(options) {
                     }
                     : {}),
             });
-            progress.close();
+            progress.close({
+                title: `Dependency changes installed from the verified shared store.`,
+                detail: `${result.packages} packages; ${result.reused} realizations reused.`,
+            });
             if (parsed.json) {
                 return emit({
                     exitCode: 0,
@@ -730,7 +777,13 @@ async function runToolCommand(command, parsed, options, version) {
         env: options.env,
     };
     if (command === "dlx") {
-        return (await runDlx({ ...base, spec: first })).exitCode;
+        const result = await runDlx({ ...base, spec: first });
+        if (result.exitCode === 0 && options.stderr.isTTY)
+            options.stderr.write(renderCommandOutput("dlx", `zyrk dlx finished ${result.name}@${result.version}.\n`, {
+                isTTY: true,
+                color: options.env.NO_COLOR === undefined && options.env.TERM !== "dumb",
+            }));
+        return result.exitCode;
     }
     const isNext = starterSpecFor(first).startsWith("create-next-app@");
     options.stderr.write(isNext
@@ -738,13 +791,22 @@ async function runToolCommand(command, parsed, options, version) {
             ? "zyrk: Next scaffolding only; dependency installation was explicitly skipped.\n"
             : "zyrk: Creating Next.js application; dependencies will install with zyrk.\n"
         : "zyrk: This initializer controls its own dependency installation.\n");
-    const progress = createInstallProgress(options.stderr, false);
+    const progress = createInstallProgress(options.stderr, false, {
+        color: options.env.NO_COLOR === undefined && options.env.TERM !== "dumb",
+    });
     try {
-        return (await runCreate({
+        const result = await runCreate({
             ...base,
             input: first,
             onInstallProgress: progress.update,
-        })).exitCode;
+        });
+        progress.close(result.exitCode === 0
+            ? {
+                title: "Project created successfully.",
+                detail: "Open the project directory and run its declared scripts with zyrk.",
+            }
+            : undefined);
+        return result.exitCode;
     }
     finally {
         progress.close();

package/dist/cli/progress.d.ts

@@ -1,10 +1,16 @@
 import type { InstallProgress } from "../install/run.ts";
+export type InstallCompletion = {
+    title: string;
+    detail?: string;
+};
 /** Presentation only: never writes to stdout or exposes package URLs or paths. */
 export declare function createInstallProgress(stream: {
     write(chunk: string): unknown;
     isTTY?: boolean;
-}, quiet: boolean): {
+}, quiet: boolean, options?: {
+    color?: boolean;
+}): {
     update(event: InstallProgress): void;
-    close(): void;
+    close(completion?: InstallCompletion): void;
 };
 //# sourceMappingURL=progress.d.ts.map

package/dist/cli/progress.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"progress.d.ts","sourceRoot":"","sources":["../../src/cli/progress.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAYzD,kFAAkF;AAClF,wBAAgB,qBAAqB,CACnC,MAAM,EAAE;IAAE,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,EAC1D,KAAK,EAAE,OAAO,GACb;IAAE,MAAM,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI,CAAC;IAAC,KAAK,IAAI,IAAI,CAAA;CAAE,CA2DzD"}
+{"version":3,"file":"progress.d.ts","sourceRoot":"","sources":["../../src/cli/progress.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAYzD,MAAM,MAAM,iBAAiB,GAAG;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,kFAAkF;AAClF,wBAAgB,qBAAqB,CACnC,MAAM,EAAE;IAAE,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,EAC1D,KAAK,EAAE,OAAO,EACd,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAO,GAChC;IACD,MAAM,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI,CAAC;IACrC,KAAK,CAAC,UAAU,CAAC,EAAE,iBAAiB,GAAG,IAAI,CAAC;CAC7C,CA2FA"}

package/dist/cli/progress.js

@@ -1,6 +1,6 @@
 const labels = {
     planning: "Preparing installation",
-    resolving: "Resolving dependencies",
+    resolving: "Preparing installation",
     fetching: "Verifying package sources",
     realizing: "Preparing shared realizations",
     building: "Preparing approved private builds",
@@ -8,10 +8,16 @@ const labels = {
     complete: "Installation complete",
 };
 /** Presentation only: never writes to stdout or exposes package URLs or paths. */
-export function createInstallProgress(stream, quiet) {
-    let timer;
-    let current = "", last = "", frame = 0, closed = false;
+export function createInstallProgress(stream, quiet, options = {}) {
+    const tty = Boolean(stream.isTTY);
+    const color = tty && options.color !== false;
+    const dim = (value) => (color ? `\u001b[2m${value}\u001b[0m` : value);
+    const green = (value) => color ? `\u001b[32m${value}\u001b[0m` : value;
+    let closed = false;
+    let currentStage = "";
+    let statusLine = false;
     let lastDownload = 0;
+    let lastPlain = "";
     const write = (text) => {
         try {
             stream.write(text);
@@ -20,57 +26,77 @@ export function createInstallProgress(stream, quiet) {
             /* A display failure cannot alter installation. */
         }
     };
-    const render = () => write(`\r\u001b[2K${["|", "/", "-", "\\"][frame++ % 4]} ${current}`);
+    const clearStatus = (lineBreak) => {
+        if (!statusLine)
+            return;
+        write(`\r\u001b[2K${lineBreak ? "\n" : ""}`);
+        statusLine = false;
+    };
     return {
         update(event) {
             if (quiet || closed)
                 return;
             const pkg = event.package;
-            // Registry names are validated elsewhere; strip control characters here
-            // as presentation defense for direct API callers and hostile metadata.
-            const label = pkg
+            // Strip control characters as presentation defense for direct API
+            // callers and hostile registry metadata.
+            const packageLabel = pkg
                 ? `${pkg.name}@${pkg.version}`.replace(/[\x00-\x1f\x7f-\x9f]/g, "")
                 : "";
             if (pkg?.status === "linked") {
-                if (stream.isTTY)
-                    write("\r\u001b[2K");
-                write(`✓ ${label} linked\n`);
+                if (tty)
+                    clearStatus(true);
+                write(`${green("✓")} ${packageLabel} linked\n`);
                 return;
             }
-            const downloading = pkg?.status === "downloading";
-            if (downloading && pkg.bytes && Date.now() - lastDownload < 100)
-                return;
-            if (downloading)
-                lastDownload = Date.now();
-            current =
-                (downloading
-                    ? `Downloading ${label}: ${((pkg.bytes ?? 0) / 1024).toFixed(1)} KiB`
-                    : labels[event.phase]) +
-                    (event.total === undefined
-                        ? ""
-                        : ` (${event.completed ?? 0}/${event.total})`) +
-                    (event.reused === undefined
-                        ? ""
-                        : ` — reused ${event.reused}, downloaded ${event.downloaded ?? 0}`);
-            if (stream.isTTY) {
-                render();
-                if (!timer) {
-                    timer = setInterval(render, 100);
-                    timer.unref();
+            const stage = labels[event.phase];
+            if (tty) {
+                if (stage !== "Installation complete" && stage !== currentStage) {
+                    clearStatus(true);
+                    write(`${dim(`› zyrk: ${stage}`)}\n`);
+                    currentStage = stage;
                 }
+                if (pkg?.status === "downloading" || event.phase === "fetching") {
+                    if (pkg?.status === "downloading" &&
+                        pkg.bytes &&
+                        Date.now() - lastDownload < 100)
+                        return;
+                    lastDownload = Date.now();
+                    const status = pkg?.status === "downloading"
+                        ? `  Downloading ${packageLabel}: ${((pkg.bytes ?? 0) / 1024).toFixed(1)} KiB`
+                        : `  Sources verified ${event.completed ?? 0}/${event.total ?? 0} · reused ${event.reused ?? 0} · downloaded ${event.downloaded ?? 0}`;
+                    write(`\r\u001b[2K${dim(status)}`);
+                    statusLine = true;
+                }
+                return;
             }
-            else if (current !== last)
+            const current = (pkg?.status === "downloading"
+                ? `Downloading ${packageLabel}: ${((pkg.bytes ?? 0) / 1024).toFixed(1)} KiB`
+                : stage) +
+                (event.total === undefined
+                    ? ""
+                    : ` (${event.completed ?? 0}/${event.total})`) +
+                (event.reused === undefined
+                    ? ""
+                    : ` — reused ${event.reused}, downloaded ${event.downloaded ?? 0}`);
+            if (current !== lastPlain)
                 write(`zyrk: ${current}\n`);
-            last = current;
+            lastPlain = current;
         },
-        close() {
+        close(completion) {
             if (closed)
                 return;
             closed = true;
-            if (timer)
-                clearInterval(timer);
-            if (!quiet && stream.isTTY && current)
-                write("\r\u001b[2K");
+            if (quiet)
+                return;
+            if (tty) {
+                clearStatus(true);
+                if (completion) {
+                    write(`${dim("─".repeat(46))}\n`);
+                    write(`${green("✓")} ${completion.title}\n`);
+                    if (completion.detail)
+                        write(`${dim(completion.detail)}\n`);
+                }
+            }
         },
     };
 }

package/dist/cli/terminal.d.ts

@@ -0,0 +1,9 @@
+export type TerminalStyle = {
+    isTTY?: boolean;
+    color?: boolean;
+};
+/** Render command summaries for people while preserving redirected output. */
+export declare function renderCommandOutput(command: string, output: string, style?: TerminalStyle): string;
+/** Make stable CLI diagnostics easier to scan without changing their content. */
+export declare function renderCommandError(error: string, style?: TerminalStyle): string;
+//# sourceMappingURL=terminal.d.ts.map

package/dist/cli/terminal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal.d.ts","sourceRoot":"","sources":["../../src/cli/terminal.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,aAAa,GAAG;IAAE,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AAQjE,8EAA8E;AAC9E,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,KAAK,GAAE,aAAkB,GACxB,MAAM,CA0BR;AAED,iFAAiF;AACjF,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,MAAM,EACb,KAAK,GAAE,aAAkB,GACxB,MAAM,CAUR"}

package/dist/cli/terminal.js

@@ -0,0 +1,41 @@
+function paint(value, code, style) {
+    return style.isTTY && style.color !== false
+        ? `\u001b[${code}m${value}\u001b[0m`
+        : value;
+}
+/** Render command summaries for people while preserving redirected output. */
+export function renderCommandOutput(command, output, style = {}) {
+    if (!style.isTTY || output === "")
+        return output;
+    let value;
+    try {
+        value = JSON.parse(output);
+    }
+    catch {
+        value = undefined;
+    }
+    if (value && typeof value === "object" && !Array.isArray(value)) {
+        const summary = { ...value };
+        delete summary.schemaVersion;
+        delete summary.status;
+        delete summary.command;
+        const body = JSON.stringify(summary, null, 2).replace(/^(\s*)"([^\"]+)":/gm, (_match, indent, key) => `${indent}${paint(`${key}:`, 2, style)}`);
+        return `${paint("✓", 32, style)} zyrk ${command}\n${body}\n`;
+    }
+    const lines = output.trimEnd().split("\n");
+    const first = lines.shift() ?? "";
+    const heading = first.startsWith("✓")
+        ? `${paint("✓", 32, style)}${first.slice(1)}`
+        : `${paint("✓", 32, style)} ${first}`;
+    return `${heading}${lines.length ? `\n${lines.join("\n")}` : ""}\n`;
+}
+/** Make stable CLI diagnostics easier to scan without changing their content. */
+export function renderCommandError(error, style = {}) {
+    if (!style.isTTY)
+        return error;
+    const match = /^zyrk: error ([A-Z0-9_]+): ([^\n]+)(?:\n([\s\S]*?))?\n?$/.exec(error);
+    if (!match)
+        return error;
+    const [, code, message, remedy] = match;
+    return `${paint("✖", 31, style)} zyrk ${code}\n  ${message}${remedy ? `\n  ${paint("↳", 33, style)} ${remedy}` : ""}\n`;
+}

package/dist/commands/deploy.d.ts

@@ -5,9 +5,11 @@ export type DeployCommandOptions = {
     env: NodeJS.ProcessEnv;
     stdout: {
         write(chunk: string): unknown;
+        isTTY?: boolean;
     };
     stderr: {
         write(chunk: string): unknown;
+        isTTY?: boolean;
     };
     json?: boolean;
 };

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

@@ -1 +1 @@
-{"version":3,"file":"deploy.d.ts","sourceRoot":"","sources":["../../src/commands/deploy.ts"],"names":[],"mappings":"AAwEA,MAAM,MAAM,oBAAoB,GAAG;IACjC,OAAO,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC7B,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IACvB,MAAM,EAAE;QAAE,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC;IAC1C,MAAM,EAAE;QAAE,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC;IAC1C,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB,CAAC;AAwEF,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,MAAM,CAAC,CAoajB"}
+{"version":3,"file":"deploy.d.ts","sourceRoot":"","sources":["../../src/commands/deploy.ts"],"names":[],"mappings":"AAyEA,MAAM,MAAM,oBAAoB,GAAG;IACjC,OAAO,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC7B,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IACvB,MAAM,EAAE;QAAE,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IAC3D,MAAM,EAAE;QAAE,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IAC3D,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB,CAAC;AA8EF,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,MAAM,CAAC,CAoajB"}

package/dist/commands/deploy.js

@@ -10,6 +10,7 @@ import { validateNativeExport } from "./native-export.js";
 import { workspaceRegistryOccurrences, workspaceContextId, } from "../install/workspace-graph.js";
 import { findProjectBoundary, resolveStoreRoot } from "../config/paths.js";
 import { ZyrkError } from "../errors.js";
+import { renderCommandOutput } from "../cli/terminal.js";
 import { lockedGraph } from "../install/lock.js";
 import { loadProjectPatches } from "./patch.js";
 import { currentPlatform } from "../resolve/resolver.js";
@@ -84,7 +85,12 @@ function output(options, result, human) {
             command: options.command,
             ...result,
         }) + "\n"
-        : human + "\n");
+        : renderCommandOutput(options.command, `${human}\n`, {
+            ...(options.stdout.isTTY === undefined
+                ? {}
+                : { isTTY: options.stdout.isTTY }),
+            color: options.env.NO_COLOR === undefined && options.env.TERM !== "dumb",
+        }));
 }
 export async function runDeployCommand(options) {
     const boundary = (await findWorkspaceRoot(options.cwd)) ??

package/dist/commands/project.d.ts

@@ -5,9 +5,11 @@ export type ProjectCommandOptions = {
     env: NodeJS.ProcessEnv;
     stdout: {
         write(chunk: string): unknown;
+        isTTY?: boolean;
     };
     stderr: {
         write(chunk: string): unknown;
+        isTTY?: boolean;
     };
     json?: boolean;
     workspaceLockHeld?: boolean;

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

@@ -1 +1 @@
-{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../../src/commands/project.ts"],"names":[],"mappings":"AA4DA,MAAM,MAAM,qBAAqB,GAAG;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IACvB,MAAM,EAAE;QAAE,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC;IAC1C,MAAM,EAAE;QAAE,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC;IAC1C,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AA+LF,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,MAAM,CAAC,CAgRjB"}
+{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../../src/commands/project.ts"],"names":[],"mappings":"AA6DA,MAAM,MAAM,qBAAqB,GAAG;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IACvB,MAAM,EAAE;QAAE,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IAC3D,MAAM,EAAE;QAAE,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IAC3D,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAqMF,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,MAAM,CAAC,CAgRjB"}

package/dist/commands/project.js

@@ -21,6 +21,7 @@ import { randomId } from "../util/ids.js";
 import { canonicalJson } from "../util/json.js";
 import { sha512Hex } from "../util/hash.js";
 import { CLI_VERSION } from "../version.js";
+import { renderCommandOutput } from "../cli/terminal.js";
 function object(value) {
     return typeof value === "object" && value !== null && !Array.isArray(value);
 }
@@ -137,7 +138,12 @@ function emit(options, result, human) {
             command: options.command,
             ...result,
         }) + "\n"
-        : human + "\n");
+        : renderCommandOutput(options.command, `${human}\n`, {
+            ...(options.stdout.isTTY === undefined
+                ? {}
+                : { isTTY: options.stdout.isTTY }),
+            color: options.env.NO_COLOR === undefined && options.env.TERM !== "dumb",
+        }));
 }
 export async function runProjectCommand(options) {
     const selectors = [];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zyrk",
-  "version": "0.7.2",
+  "version": "0.7.3",
   "description": "Storage-efficient Node package manager: one verified store per user, shared across projects through links.",
   "license": "MIT",
   "type": "module",