zyrk 0.8.5 → 0.8.6

package/README.md

@@ -534,3 +534,12 @@ and runs real pinned React, Vite, Vitest, and Tailwind builds and HTTP asset
 checks. It uses native zyrk installation with default deny policy. Recorded
 results describe the exact tested versions and platform, without a universal
 framework or cold-install performance claim.
+
+### Inspection output
+
+Interactive `doctor`, store status/verification, and collection commands use
+command-specific summaries. A failed doctor result is marked as a failure;
+an unavailable audit result is attention, never a clean audit. Store collection
+previews distinguish eligible, retained, removed, and grace-period entries and
+keep physical reclamation explicitly unavailable when it cannot be measured.
+Redirected output and `--json` preserve their existing data contracts.

package/VERSION

@@ -1 +1 @@
-v0.8.5
+v0.8.6

package/dist/cli/terminal.d.ts

@@ -2,6 +2,15 @@ export type TerminalStyle = {
     isTTY?: boolean;
     color?: boolean;
 };
+export type HumanSummary = {
+    tone: "success" | "attention" | "failure" | "status";
+    heading: string;
+    facts: string[];
+    next?: string;
+};
+export declare function renderSummary(summary: HumanSummary, style: TerminalStyle): string;
+/** Command facts stay separate from their terminal presentation and JSON data. */
+export declare function commandSummary(command: string, value: Record<string, unknown>): HumanSummary | undefined;
 /** 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. */

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

@@ -1 +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"}
+{"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;AAEjE,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,SAAS,GAAG,WAAW,GAAG,SAAS,GAAG,QAAQ,CAAC;IACrD,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,wBAAgB,aAAa,CAC3B,OAAO,EAAE,YAAY,EACrB,KAAK,EAAE,aAAa,GACnB,MAAM,CAQR;AAED,kFAAkF;AAClF,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,YAAY,GAAG,SAAS,CAgG1B;AAQD,8EAA8E;AAC9E,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,KAAK,GAAE,aAAkB,GACxB,MAAM,CA4BR;AAED,iFAAiF;AACjF,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,MAAM,EACb,KAAK,GAAE,aAAkB,GACxB,MAAM,CAUR"}

package/dist/cli/terminal.js

@@ -1,3 +1,94 @@
+export function renderSummary(summary, style) {
+    const marker = { success: "✓", attention: "!", failure: "✖", status: "›" }[summary.tone];
+    const color = { success: 32, attention: 33, failure: 31, status: 2 }[summary.tone];
+    return `${paint(marker, color, style)} ${summary.heading}\n${summary.facts.map((fact) => `  ${fact}\n`).join("")}${summary.next ? `  Next: ${summary.next}\n` : ""}`;
+}
+/** Command facts stay separate from their terminal presentation and JSON data. */
+export function commandSummary(command, value) {
+    if (command === "doctor" &&
+        typeof value.ok === "boolean" &&
+        Array.isArray(value.diagnostics)) {
+        const diagnostics = value.diagnostics;
+        return {
+            tone: !value.ok
+                ? "failure"
+                : diagnostics.length
+                    ? "attention"
+                    : "success",
+            heading: !value.ok
+                ? "Project needs attention"
+                : diagnostics.length
+                    ? "Project checks passed with warnings"
+                    : "Project checks passed",
+            facts: diagnostics.length
+                ? diagnostics.map((d) => `${d.severity}: ${d.code}: ${d.message}`)
+                : ["Lock, links, build readiness, and store safety checked."],
+            ...(!value.ok
+                ? {
+                    next: "Review these diagnostics before choosing install or repair.",
+                }
+                : {}),
+        };
+    }
+    if (command.startsWith("store") && typeof value.initialized === "boolean") {
+        return {
+            tone: "status",
+            heading: value.initialized
+                ? "Shared store status"
+                : "Shared store is not initialized",
+            facts: value.initialized
+                ? [
+                    `Retention roots: ${value.retentionRoots ?? "unavailable"}`,
+                    `Logical bytes: ${value.logicalBytes ?? "unavailable"}`,
+                    `Allocated bytes estimate: ${value.allocatedBytesEstimate ?? "unavailable"}`,
+                    String(value.allocationMethod ??
+                        "Physical allocation measurement unavailable."),
+                    "Private builds, fetch caches, and exclusive reclaimable bytes are not measured here.",
+                ]
+                : ["No store content has been inspected."],
+        };
+    }
+    if (command.startsWith("store") && value.verified === true)
+        return {
+            tone: "success",
+            heading: "Shared store verification passed",
+            facts: [
+                `Sources: ${value.sources}; objects: ${value.objects}; realizations: ${value.realizations}`,
+            ],
+        };
+    if (command.startsWith("store") &&
+        typeof value.dryRun === "boolean" &&
+        Array.isArray(value.candidates))
+        return {
+            tone: "status",
+            heading: value.dryRun
+                ? "Store collection preview"
+                : "Store collection complete",
+            facts: [
+                `Eligible entries: ${value.candidates.length}; removed: ${value.removed}; retained: ${value.retained}`,
+                `Within grace period: ${value.graceRetained}`,
+                `Selected logical bytes: ${value.logicalBytesSelected}; physical bytes reclaimed: ${value.physicalBytesReclaimed}`,
+                ...(Array.isArray(value.retentionReasons)
+                    ? value.retentionReasons.map(String)
+                    : []),
+            ],
+            ...(value.dryRun
+                ? { next: "Review eligibility; run zyrk store gc to apply collection." }
+                : {}),
+        };
+    if (value.status === "unavailable")
+        return {
+            tone: "attention",
+            heading: `${command} is unavailable`,
+            facts: [
+                "No clean result can be established.",
+                ...Object.entries(value)
+                    .filter(([key]) => !["schemaVersion", "status", "command"].includes(key))
+                    .map(([key, item]) => `${key}: ${JSON.stringify(item)}`),
+            ],
+        };
+    return undefined;
+}
 function paint(value, code, style) {
     return style.isTTY && style.color !== false
         ? `\u001b[${code}m${value}\u001b[0m`
@@ -15,6 +106,9 @@ export function renderCommandOutput(command, output, style = {}) {
         value = undefined;
     }
     if (value && typeof value === "object" && !Array.isArray(value)) {
+        const semantic = commandSummary(command, value);
+        if (semantic)
+            return renderSummary(semantic, style);
         const summary = { ...value };
         delete summary.schemaVersion;
         delete summary.status;

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

@@ -1 +1 @@
-{"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"}
+{"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;AA2MF,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,MAAM,CAAC,CAgRjB"}

package/dist/commands/project.js

@@ -138,7 +138,9 @@ function emit(options, result, human) {
             command: options.command,
             ...result,
         }) + "\n"
-        : renderCommandOutput(options.command, `${human}\n`, {
+        : renderCommandOutput(options.command, options.command === "doctor" && options.stdout.isTTY
+            ? JSON.stringify(result)
+            : `${human}\n`, {
             ...(options.stdout.isTTY === undefined
                 ? {}
                 : { isTTY: options.stdout.isTTY }),

package/package.json

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