zyrk 0.6.2 → 0.6.3

package/README.md

@@ -394,7 +394,12 @@ 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 phase messages. `--json` disables progress.
+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.
 
 Install resolution has a five-minute deadline; each archive extraction has a
 two-minute deadline. Set `ZYRK_RESOLVE_TIMEOUT_MS` or `ZYRK_EXTRACT_TIMEOUT_MS`

package/VERSION

@@ -1 +1 @@
-v0.6.2
+v0.6.3

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

@@ -1 +1 @@
-{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../src/cli/main.ts"],"names":[],"mappings":"AA2BA,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;AA2DzC,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAyBhD;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,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;AAEF,gFAAgF;AAChF,wBAAsB,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CA4ZpE"}
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../src/cli/main.ts"],"names":[],"mappings":"AA2BA,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;AA2DzC,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAyBhD;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,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;AAEF,gFAAgF;AAChF,wBAAsB,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CAkapE"}

package/dist/cli/main.js

@@ -480,11 +480,13 @@ export async function runCli(options) {
             parsed.command === "remove" ||
             parsed.command === "update" ||
             parsed.command === "import")) {
+        const progress = createInstallProgress(options.stderr, parsed.json);
         try {
             const tools = options.tools === undefined
                 ? await defaultTools(options.env, version, options.cwd ?? process.cwd())
                 : await options.tools();
             const result = await runDependencyCommand({
+                onProgress: progress.update,
                 command: parsed.command,
                 env: options.env,
                 args: parsed.commandArgs,
@@ -492,6 +494,7 @@ export async function runCli(options) {
                 store: tools.store,
                 registry: tools.registry,
             });
+            progress.close();
             if (parsed.json) {
                 return emit({
                     exitCode: 0,
@@ -501,13 +504,17 @@ export async function runCli(options) {
             }
             return emit({
                 exitCode: 0,
-                stdout: `Dependency command ${parsed.command} completed.\n`,
-                stderr: "",
+                stdout: `Dependency command ${parsed.command} completed: ${result.packages} packages, ${result.reused} realizations reused; ${result.readiness}.\n`,
+                stderr: result.warnings.map((w) => `zyrk: ${w}\n`).join(""),
             });
         }
         catch (error) {
+            progress.close();
             return emit(fail(toZyrkError(error, `zyrk ${parsed.command} failed.`), parsed));
         }
+        finally {
+            progress.close();
+        }
     }
     // Project commands: run, exec, list, why, doctor, repair
     if (!parsed.help &&

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;AAWzD,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,CAuCzD"}
+{"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"}

package/dist/cli/progress.js

@@ -5,11 +5,13 @@ const labels = {
     realizing: "Preparing shared realizations",
     building: "Preparing approved private builds",
     linking: "Linking project dependencies",
+    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;
+    let lastDownload = 0;
     const write = (text) => {
         try {
             stream.write(text);
@@ -23,11 +25,33 @@ export function createInstallProgress(stream, quiet) {
         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
+                ? `${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`);
+                return;
+            }
+            const downloading = pkg?.status === "downloading";
+            if (downloading && pkg.bytes && Date.now() - lastDownload < 100)
+                return;
+            if (downloading)
+                lastDownload = Date.now();
             current =
-                labels[event.phase] +
+                (downloading
+                    ? `Downloading ${label}: ${((pkg.bytes ?? 0) / 1024).toFixed(1)} KiB`
+                    : labels[event.phase]) +
                     (event.total === undefined
                         ? ""
-                        : ` (${event.completed ?? 0}/${event.total})`);
+                        : ` (${event.completed ?? 0}/${event.total})`) +
+                    (event.reused === undefined
+                        ? ""
+                        : ` — reused ${event.reused}, downloaded ${event.downloaded ?? 0}`);
             if (stream.isTTY) {
                 render();
                 if (!timer) {

package/dist/commands/dependencies.d.ts

@@ -1,6 +1,6 @@
 import type { RegistryClient } from "../fetch/registry.ts";
 import type { Store } from "../store/layout.ts";
-import { type InstallResult } from "../install/run.ts";
+import { type InstallOptions, type InstallResult } from "../install/run.ts";
 export type DependencyCommand = "add" | "remove" | "update" | "import";
 export declare function runDependencyCommand(options: {
     command: DependencyCommand;
@@ -9,5 +9,6 @@ export declare function runDependencyCommand(options: {
     store: Store;
     registry: RegistryClient;
     env?: NodeJS.ProcessEnv;
+    onProgress?: InstallOptions["onProgress"];
 }): Promise<InstallResult>;
 //# sourceMappingURL=dependencies.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"dependencies.d.ts","sourceRoot":"","sources":["../../src/commands/dependencies.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAEhD,OAAO,EAGL,KAAK,aAAa,EACnB,MAAM,mBAAmB,CAAC;AAE3B,MAAM,MAAM,iBAAiB,GAAG,KAAK,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAavE,wBAAsB,oBAAoB,CAAC,OAAO,EAAE;IAClD,OAAO,EAAE,iBAAiB,CAAC;IAC3B,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,KAAK,CAAC;IACb,QAAQ,EAAE,cAAc,CAAC;IACzB,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CACzB,GAAG,OAAO,CAAC,aAAa,CAAC,CA2HzB"}
+{"version":3,"file":"dependencies.d.ts","sourceRoot":"","sources":["../../src/commands/dependencies.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAEhD,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,aAAa,EACnB,MAAM,mBAAmB,CAAC;AAE3B,MAAM,MAAM,iBAAiB,GAAG,KAAK,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAavE,wBAAsB,oBAAoB,CAAC,OAAO,EAAE;IAClD,OAAO,EAAE,iBAAiB,CAAC;IAC3B,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,KAAK,CAAC;IACb,QAAQ,EAAE,cAAc,CAAC;IACzB,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,UAAU,CAAC,EAAE,cAAc,CAAC,YAAY,CAAC,CAAC;CAC3C,GAAG,OAAO,CAAC,aAAa,CAAC,CA4HzB"}

package/dist/commands/dependencies.js

@@ -15,6 +15,7 @@ export async function runDependencyCommand(options) {
         store: options.store,
         registry: options.registry,
         ...(options.env ? { env: options.env } : {}),
+        ...(options.onProgress ? { onProgress: options.onProgress } : {}),
     };
     const names = [];
     let from;

package/dist/install/progress.d.ts

@@ -0,0 +1,14 @@
+import type { InstallOptions } from "./run.ts";
+type Package = {
+    name: string;
+    version: string;
+};
+/** Counts verified source identities, independent of peer-split realizations. */
+export declare function sourceProgress(onProgress: InstallOptions["onProgress"], total: number): {
+    downloading(pkg: Package): (chunk: number) => void;
+    verified(pkg: Package, status: "reused" | "downloaded"): void;
+};
+/** Only called after transactional projection publication succeeds. */
+export declare function reportLinked(onProgress: InstallOptions["onProgress"], packages: readonly Package[]): void;
+export {};
+//# sourceMappingURL=progress.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"progress.d.ts","sourceRoot":"","sources":["../../src/install/progress.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAmB,MAAM,UAAU,CAAC;AAEhE,KAAK,OAAO,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AACjD,iFAAiF;AACjF,wBAAgB,cAAc,CAC5B,UAAU,EAAE,cAAc,CAAC,YAAY,CAAC,EACxC,KAAK,EAAE,MAAM;IAcX,WAAW,MAAM,OAAO,WAGP,MAAM;IAKvB,QAAQ,MAAM,OAAO,UAAU,QAAQ,GAAG,YAAY;EAMzD;AACD,uEAAuE;AACvE,wBAAgB,YAAY,CAC1B,UAAU,EAAE,cAAc,CAAC,YAAY,CAAC,EACxC,QAAQ,EAAE,SAAS,OAAO,EAAE,QAU7B"}

package/dist/install/progress.js

@@ -0,0 +1,38 @@
+/** Counts verified source identities, independent of peer-split realizations. */
+export function sourceProgress(onProgress, total) {
+    let reused = 0, downloaded = 0;
+    const emit = (pkg) => onProgress?.({
+        phase: "fetching",
+        total,
+        completed: reused + downloaded,
+        reused,
+        downloaded,
+        ...(pkg ? { package: pkg } : {}),
+    });
+    return {
+        downloading(pkg) {
+            let bytes = 0;
+            emit({ ...pkg, status: "downloading", bytes });
+            return (chunk) => {
+                bytes += chunk;
+                emit({ ...pkg, status: "downloading", bytes });
+            };
+        },
+        verified(pkg, status) {
+            if (status === "reused")
+                reused++;
+            else
+                downloaded++;
+            emit({ ...pkg, status });
+        },
+    };
+}
+/** Only called after transactional projection publication succeeds. */
+export function reportLinked(onProgress, packages) {
+    const unique = new Map(packages.map((pkg) => [JSON.stringify([pkg.name, pkg.version]), pkg]));
+    for (const pkg of unique.values())
+        onProgress?.({
+            phase: "complete",
+            package: { name: pkg.name, version: pkg.version, status: "linked" },
+        });
+}

package/dist/install/run.d.ts

@@ -5,9 +5,17 @@ import type { ResolverLimits } from "../resolve/resolver.ts";
 import type { ExtractionLimits } from "../extract/tarball.ts";
 import { Store } from "../store/layout.ts";
 export type InstallProgress = {
-    phase: "planning" | "resolving" | "fetching" | "realizing" | "building" | "linking";
+    phase: "planning" | "resolving" | "fetching" | "realizing" | "building" | "linking" | "complete";
     completed?: number;
     total?: number;
+    reused?: number;
+    downloaded?: number;
+    package?: {
+        name: string;
+        version: string;
+        status: "downloading" | "downloaded" | "reused" | "linked";
+        bytes?: number;
+    };
 };
 export type InstallOptions = {
     onProgress?: (event: InstallProgress) => void;

package/dist/install/run.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../src/install/run.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAK9D,OAAO,EAOL,KAAK,cAAc,EACpB,MAAM,cAAc,CAAC;AAYtB,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAG9D,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AA+B3C,MAAM,MAAM,eAAe,GAAG;IAC5B,KAAK,EACD,UAAU,GACV,WAAW,GACX,UAAU,GACV,WAAW,GACX,UAAU,GACV,SAAS,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AACF,MAAM,MAAM,cAAc,GAAG;IAC3B,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,CAAC;IAC9C,UAAU,EAAE,MAAM,CAAC;IACnB,sEAAsE;IACtE,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B,KAAK,EAAE,KAAK,CAAC;IACb,QAAQ,EAAE,cAAc,CAAC;IACzB,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,QAAQ,CAAC,EAAE;QACT,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;QAC3B,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;QAC3B,MAAM,CAAC,EAAE,OAAO,CAAC;KAClB,CAAC;IACF,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,aAAa,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;IACxC,aAAa,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAC1C,WAAW,CAAC,EAAE;QACZ,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC;CACH,CAAC;AACF,MAAM,MAAM,aAAa,GAAG;IAC1B,SAAS,EACL,OAAO,GACP,uBAAuB,GACvB,eAAe,GACf,SAAS,GACT,cAAc,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,MAAM,CAAC,EAAE,cAAc,EAAE,CAAC;CAC3B,CAAC;AA4GF,wBAAsB,cAAc,CAClC,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,aAAa,CAAC,CAoyBxB"}
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../src/install/run.ts"],"names":[],"mappings":"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"}

package/dist/install/run.js

@@ -1,3 +1,4 @@
+import { sourceProgress, reportLinked } from "./progress.js";
 import { selectPlatformGraph } from "./platform.js";
 import { findWorkspaceRoot } from "./workspaces.js";
 import { assertSupportedSourcePayload } from "./source-policy.js";
@@ -441,7 +442,7 @@ export async function installProject(options) {
             })
             : undefined;
         const unique = new Map(activeNodes.map((n) => [n.sourceId, n]));
-        let completedSources = 0;
+        const progress = sourceProgress(options.onProgress, unique.size);
         options.onProgress?.({
             phase: "fetching",
             completed: 0,
@@ -451,21 +452,21 @@ export async function installProject(options) {
             operation.operation.checkpoint();
             if (await pathExists(sourceManifestPath(options.store, node.sourceId))) {
                 await readSourceManifest(options.store, node.sourceId);
-                options.onProgress?.({
-                    phase: "fetching",
-                    completed: ++completedSources,
-                    total: unique.size,
-                });
+                progress.verified(node, "reused");
                 continue;
             }
             if (options.offline)
                 throw error("ZYRK_OFFLINE_MISSING", `Verified source for ${node.name}@${node.version} is missing from the store.`);
             const tarball = path.join(txn.dir, `${node.sourceId}.tgz`);
+            const downloadProgress = progress.downloading(node);
             const download = await options.registry
                 .forPackage(node.name)
                 .downloadTarball({
                 signal: operation.operation.signal,
-                onBytes: operation.operation.consumeArchiveBytes,
+                onBytes(bytes) {
+                    operation.operation.consumeArchiveBytes(bytes);
+                    downloadProgress(bytes);
+                },
                 url: node.tarballUrl,
                 expectedIntegrity: node.integrity,
                 destPath: tarball,
@@ -490,11 +491,7 @@ export async function installProject(options) {
             if (source.sourceId !== node.sourceId)
                 throw lockMismatch("download identity disagrees with the locked source");
             await rm(tarball, { force: true });
-            options.onProgress?.({
-                phase: "fetching",
-                completed: ++completedSources,
-                total: unique.size,
-            });
+            progress.verified(node, "downloaded");
         }
         for (const node of unique.values())
             assertSupportedSourcePayload(node, await readSourceManifest(options.store, node.sourceId));
@@ -707,6 +704,7 @@ export async function installProject(options) {
         });
         registration.activate();
         await txn.setState("committed");
+        reportLinked(options.onProgress, activeNodes);
         return {
             readiness,
             packages: activeNodes.length,

package/dist/install/workspace-install.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workspace-install.d.ts","sourceRoot":"","sources":["../../src/install/workspace-install.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAuH9D,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,aAAa,CAAC,CAmrBxB"}
+{"version":3,"file":"workspace-install.d.ts","sourceRoot":"","sources":["../../src/install/workspace-install.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAuH9D,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,aAAa,CAAC,CAqrBxB"}

package/dist/install/workspace-install.js

@@ -1,3 +1,4 @@
+import { sourceProgress, reportLinked } from "./progress.js";
 import { selectWorkspacePlatform } from "./platform.js";
 /** Multi-importer live workspace installation with one publication journal. */
 import { chmod, copyFile, lstat, mkdir, readFile, realpath, rename, rm, symlink, } from "node:fs/promises";
@@ -264,7 +265,7 @@ export async function installWorkspaceProject(options) {
             })
             : undefined;
         const uniqueSources = new Map(nodes.map((n) => [n.sourceId, n]));
-        let completedSources = 0;
+        const progress = sourceProgress(options.onProgress, uniqueSources.size);
         options.onProgress?.({
             phase: "fetching",
             completed: 0,
@@ -272,11 +273,13 @@ export async function installWorkspaceProject(options) {
         });
         for (const node of uniqueSources.values()) {
             operation.operation.checkpoint();
-            if (!(await pathExists(sourceManifestPath(options.store, node.sourceId)))) {
+            const cached = await pathExists(sourceManifestPath(options.store, node.sourceId));
+            if (!cached) {
                 if (options.offline)
                     throw new ZyrkError("ZYRK_OFFLINE_MISSING", `Verified workspace dependency ${node.name}@${node.version} is missing.`, {
                         remedy: "Fetch the exact locked sources online before retrying offline.",
                     });
+                const downloadProgress = progress.downloading(node);
                 const archive = path.join(txn.dir, `${node.sourceId}.tgz`), download = await options.registry
                     .forPackage(node.name)
                     .downloadTarball({
@@ -285,7 +288,10 @@ export async function installWorkspaceProject(options) {
                     destPath: archive,
                     label: `${node.name}@${node.version}`,
                     signal: operation.operation.signal,
-                    onBytes: operation.operation.consumeArchiveBytes,
+                    onBytes(bytes) {
+                        operation.operation.consumeArchiveBytes(bytes);
+                        downloadProgress(bytes);
+                    },
                 });
                 const extraction = await extractTarball({
                     limits: options.extractBudget,
@@ -308,11 +314,7 @@ export async function installWorkspaceProject(options) {
                 await rm(archive, { force: true });
             }
             assertSupportedSourcePayload(node, await readSourceManifest(options.store, node.sourceId));
-            options.onProgress?.({
-                phase: "fetching",
-                completed: ++completedSources,
-                total: uniqueSources.size,
-            });
+            progress.verified(node, cached ? "reused" : "downloaded");
         }
         if (options.fetchOnly)
             return {
@@ -562,6 +564,7 @@ export async function installWorkspaceProject(options) {
                 throw lockMismatch("workspace manifest changed during install");
         await publishWorkspaceProjection(root, generationId, project.importers.map((i) => i.id), lockText, manifestChanges);
         registration.activate();
+        reportLinked(options.onProgress, nodes);
         return {
             readiness,
             packages: nodes.length,

package/package.json

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