zyrk 0.8.4 → 0.8.6

package/README.md

@@ -191,6 +191,12 @@ paths. Older platform-pruned locks need an intentional non-frozen refresh; incom
 npm locks must be freshly resolved before portable adoption. macOS, Windows, and
 broad framework compatibility have not passed their release gates.
 
+Zyrk writes the npm-compatible lock layout alongside its portable graph. Peer
+dependencies are placed beside or above their consumers, as npm requires. If
+an older Zyrk lock makes `npm ci` report missing peer packages, run
+`zyrk install --lockfile-only` with the updated CLI to refresh that layout
+without installing dependencies or running lifecycle scripts.
+
 ### Workspaces
 
 Standard `package.json` workspaces use one root lock and a recoverable transaction
@@ -528,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.4
+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/dist/lockfile/write.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"write.d.ts","sourceRoot":"","sources":["../../src/lockfile/write.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAGjE,OAAO,EAGL,KAAK,UAAU,EAGhB,MAAM,YAAY,CAAC;AAEpB,MAAM,MAAM,mBAAmB,GAAG;IAChC,KAAK,EAAE,kBAAkB,EAAE,CAAC;IAC5B,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAChD,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,oDAAoD;IACpD,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,sEAAsE;IACtE,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,oBAAoB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9C,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAC1D,QAAQ,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;IAC7B,UAAU,EAAE,mBAAmB,CAAC;IAChC,YAAY,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IACpE,eAAe,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;CACzB,CAAC;AAEF,wBAAsB,aAAa,CACjC,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,UAAU,CAAC,CAqPrB"}
+{"version":3,"file":"write.d.ts","sourceRoot":"","sources":["../../src/lockfile/write.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAGjE,OAAO,EAGL,KAAK,UAAU,EAGhB,MAAM,YAAY,CAAC;AAEpB,MAAM,MAAM,mBAAmB,GAAG;IAChC,KAAK,EAAE,kBAAkB,EAAE,CAAC;IAC5B,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAChD,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,oDAAoD;IACpD,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,sEAAsE;IACtE,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,oBAAoB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9C,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAC1D,QAAQ,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;IAC7B,UAAU,EAAE,mBAAmB,CAAC;IAChC,YAAY,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IACpE,eAAe,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;CACzB,CAAC;AAEF,wBAAsB,aAAa,CACjC,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,UAAU,CAAC,CAiQrB"}

package/dist/lockfile/write.js

@@ -123,13 +123,19 @@ export async function writeLockfile(options) {
             ...node.platform,
             ...(node.engines === undefined ? {} : { engines: node.engines }),
         };
-        for (const edge of node.edges) {
-            const found = lookup(location, edge.name);
+        // Establish peers before descending into ordinary children. A peer must be
+        // visible beside or above its consumer; its own node_modules is invalid to
+        // npm even if that directory already contains the requested version.
+        const placementEdges = [...node.edges].sort((a, b) => Number(b.kind === "peer") - Number(a.kind === "peer"));
+        for (const edge of placementEdges) {
+            const base = edge.kind === "peer"
+                ? location.slice(0, Math.max(0, location.lastIndexOf("/node_modules/")))
+                : location;
+            const found = lookup(base, edge.name);
             if (found !== undefined && placements.get(found) === edge.target)
                 continue;
             if (edge.kind === "peer") {
-                const parent = location.slice(0, Math.max(0, location.lastIndexOf("node_modules/")));
-                populate(`${parent}node_modules/${edge.name}`, edge.target);
+                populate(`${base ? `${base}/` : ""}node_modules/${edge.name}`, edge.target);
             }
             else {
                 populate(`${location}/node_modules/${edge.name}`, edge.target);

package/package.json

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