zyrk 0.5.2 → 0.5.3

package/README.md

@@ -362,3 +362,8 @@ version-qualified selectors, self rules (`.`), and `$direct` references. Direct
 dependency overrides must match the declared specification. Workspace member
 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 phase messages. `--json` disables progress.

package/VERSION

@@ -1 +1 @@
-v0.5.2
+v0.5.3

package/dist/cli/main.d.ts

@@ -30,6 +30,7 @@ export type RunCliOptions = {
     };
     stderr: {
         write(chunk: string): unknown;
+        isTTY?: boolean;
     };
     readVersion?: () => string;
     cwd?: string;

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

@@ -1 +1 @@
-{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../src/cli/main.ts"],"names":[],"mappings":"AA0BA,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,CAwBhD;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,CAAA;KAAE,CAAC;IAC1C,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,CAqZpE"}
+{"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,CAwBhD;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"}

package/dist/cli/main.js

@@ -1,3 +1,4 @@
+import { createInstallProgress } from "./progress.js";
 import { runMaintenanceCommand } from "../commands/maintenance.js";
 import { runDeployCommand } from "../commands/deploy.js";
 import { runPatchCommand } from "../commands/patch.js";
@@ -379,6 +380,7 @@ 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);
         try {
             if (parsed.commandArgs.includes("--help") ||
                 parsed.commandArgs.includes("-h")) {
@@ -413,6 +415,7 @@ export async function runCli(options) {
                 else
                     specs.push(token);
             }
+            progress.update({ phase: "planning" });
             const cwd = options.cwd ?? process.cwd();
             const tools = options.tools
                 ? await options.tools()
@@ -429,12 +432,14 @@ export async function runCli(options) {
                     }),
                 };
             const result = await installProject({
+                onProgress: progress.update,
                 ...flags,
                 env: options.env,
                 specs,
                 projectDir: cwd,
                 ...tools,
             });
+            progress.close();
             if (parsed.json)
                 return emit({
                     exitCode: 0,
@@ -451,8 +456,12 @@ export async function runCli(options) {
             });
         }
         catch (error) {
+            progress.close();
             return emit(fail(toZyrkError(error, "zyrk install failed."), parsed));
         }
+        finally {
+            progress.close();
+        }
     }
     if (!parsed.help &&
         !parsed.version &&

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

@@ -1 +1 @@
-{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../src/cli/parse.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,MAAM,UAAU,GAAG;IACvB,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,+DAA+D;IAC/D,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,6EAA6E;IAC7E,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,wEAAwE;IACxE,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B;;;;OAIG;IACH,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,IAAI,EAAE,OAAO,CAAC;CACf,CAAC;AAEF,wBAAgB,SAAS,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,UAAU,CAkD7D;AAKD;;;;;;;;;;GAUG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,SAAS,MAAM,EAAE,EAC9B,GAAG,EAAE,MAAM,CAAC,UAAU,GACrB,OAAO,CAOT"}
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../src/cli/parse.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,MAAM,UAAU,GAAG;IACvB,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,+DAA+D;IAC/D,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,6EAA6E;IAC7E,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,wEAAwE;IACxE,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B;;;;OAIG;IACH,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,IAAI,EAAE,OAAO,CAAC;CACf,CAAC;AAEF,wBAAgB,SAAS,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,UAAU,CAmD7D;AAKD;;;;;;;;;;GAUG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,SAAS,MAAM,EAAE,EAC9B,GAAG,EAAE,MAAM,CAAC,UAAU,GACrB,OAAO,CAOT"}

package/dist/cli/parse.js

@@ -45,6 +45,8 @@ export function parseArgs(argv) {
         }
         if (parsed.command === undefined && !token.startsWith("-")) {
             parsed.command = token;
+            if (token === "help")
+                parsed.help = true;
             commandIndex = index;
             return;
         }

package/dist/cli/progress.d.ts

@@ -0,0 +1,10 @@
+import type { InstallProgress } from "../install/run.ts";
+/** 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): {
+    update(event: InstallProgress): void;
+    close(): void;
+};
+//# sourceMappingURL=progress.d.ts.map

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

@@ -0,0 +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"}

package/dist/cli/progress.js

@@ -0,0 +1,52 @@
+const labels = {
+    planning: "Preparing installation",
+    resolving: "Resolving dependencies",
+    fetching: "Verifying package sources",
+    realizing: "Preparing shared realizations",
+    building: "Preparing approved private builds",
+    linking: "Linking project dependencies",
+};
+/** 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;
+    const write = (text) => {
+        try {
+            stream.write(text);
+        }
+        catch {
+            /* A display failure cannot alter installation. */
+        }
+    };
+    const render = () => write(`\r\u001b[2K${["|", "/", "-", "\\"][frame++ % 4]} ${current}`);
+    return {
+        update(event) {
+            if (quiet || closed)
+                return;
+            current =
+                labels[event.phase] +
+                    (event.total === undefined
+                        ? ""
+                        : ` (${event.completed ?? 0}/${event.total})`);
+            if (stream.isTTY) {
+                render();
+                if (!timer) {
+                    timer = setInterval(render, 100);
+                    timer.unref();
+                }
+            }
+            else if (current !== last)
+                write(`zyrk: ${current}\n`);
+            last = current;
+        },
+        close() {
+            if (closed)
+                return;
+            closed = true;
+            if (timer)
+                clearInterval(timer);
+            if (!quiet && stream.isTTY && current)
+                write("\r\u001b[2K");
+        },
+    };
+}

package/dist/install/run.d.ts

@@ -1,7 +1,13 @@
 import { type BuildCandidate } from "./private.ts";
 import { RegistryClient } from "../fetch/registry.ts";
 import { Store } from "../store/layout.ts";
+export type InstallProgress = {
+    phase: "planning" | "resolving" | "fetching" | "realizing" | "building" | "linking";
+    completed?: number;
+    total?: number;
+};
 export type InstallOptions = {
+    onProgress?: (event: InstallProgress) => void;
     projectDir: string;
     store: Store;
     registry: RegistryClient;

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

@@ -1 +1 @@
-{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../src/install/run.ts"],"names":[],"mappings":"AAIA,OAAO,EAOL,KAAK,cAAc,EACpB,MAAM,cAAc,CAAC;AAYtB,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAGtD,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAgC3C,MAAM,MAAM,cAAc,GAAG;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,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,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,CAyyBxB"}
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../src/install/run.ts"],"names":[],"mappings":"AAIA,OAAO,EAOL,KAAK,cAAc,EACpB,MAAM,cAAc,CAAC;AAYtB,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAGtD,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAgC3C,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,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,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,CA8zBxB"}

package/dist/install/run.js

@@ -93,6 +93,7 @@ function scriptPolicy(manifest) {
     return object(manifest.zyrk) ? manifest.zyrk.scripts : undefined;
 }
 export async function installProject(options) {
+    options.onProgress?.({ phase: "planning" });
     if (await findWorkspaceRoot(options.projectDir)) {
         const { installWorkspaceProject } = await import("./workspace-install.js");
         return installWorkspaceProject(options);
@@ -248,6 +249,7 @@ export async function installProject(options) {
                 throw error("ZYRK_OFFLINE_MISSING", "Offline installation requires an existing compatible zyrk lockfile.");
             const prior = existing?.zyrk ? lockedGraph(existing) : undefined;
             const fresh = new Set(specs.map((spec) => npa(spec).name));
+            options.onProgress?.({ phase: "resolving" });
             resolved = await resolveRequirements({
                 overrides,
                 provider: {
@@ -460,10 +462,21 @@ export async function installProject(options) {
             })
             : undefined;
         const unique = new Map(activeNodes.map((n) => [n.sourceId, n]));
+        let completedSources = 0;
+        options.onProgress?.({
+            phase: "fetching",
+            completed: 0,
+            total: unique.size,
+        });
         for (const node of unique.values()) {
             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,
+                });
                 continue;
             }
             if (options.offline)
@@ -497,6 +510,11 @@ 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,
+            });
         }
         for (const node of unique.values())
             assertSupportedSourcePayload(node, await readSourceManifest(options.store, node.sourceId));
@@ -509,6 +527,7 @@ export async function installProject(options) {
                 warnings,
             };
         const graph = createGraphDoc(activeNodes.map((n) => ({ ...n, deps: n.edges })));
+        options.onProgress?.({ phase: "realizing" });
         const sharedRealized = await realizeGraph({
             store: options.store,
             graph,
@@ -581,6 +600,7 @@ export async function installProject(options) {
                 });
                 privateGraph = true;
             }
+            options.onProgress?.({ phase: "building" });
             await buildPrivate({
                 project,
                 generationId,
@@ -667,6 +687,7 @@ export async function installProject(options) {
             roots: selectedRoots.map((r) => r.target),
             readiness,
         });
+        options.onProgress?.({ phase: "linking" });
         const published = await installProjection(project, entries, {
             generationId,
             lockHeld: true,

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":"AAcA,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAyH9D,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,aAAa,CAAC,CA6pBxB"}
+{"version":3,"file":"workspace-install.d.ts","sourceRoot":"","sources":["../../src/install/workspace-install.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAyH9D,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,aAAa,CAAC,CA6qBxB"}

package/dist/install/workspace-install.js

@@ -161,6 +161,7 @@ export async function installWorkspaceProject(options) {
         if (!graph) {
             if (options.frozen || options.offline)
                 throw lockMismatch("offline/frozen workspace install needs a compatible lock");
+            options.onProgress?.({ phase: "resolving" });
             graph = await resolveWorkspaceGraph(project, {
                 origin: options.registry.origin,
                 originFor: (name) => options.registry.originFor(name),
@@ -261,7 +262,14 @@ export async function installWorkspaceProject(options) {
                 offline: options.offline === true,
             })
             : undefined;
-        for (const node of new Map(nodes.map((n) => [n.sourceId, n])).values()) {
+        const uniqueSources = new Map(nodes.map((n) => [n.sourceId, n]));
+        let completedSources = 0;
+        options.onProgress?.({
+            phase: "fetching",
+            completed: 0,
+            total: uniqueSources.size,
+        });
+        for (const node of uniqueSources.values()) {
             operation.operation.checkpoint();
             if (!(await pathExists(sourceManifestPath(options.store, node.sourceId)))) {
                 if (options.offline)
@@ -298,6 +306,11 @@ 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,
+            });
         }
         if (options.fetchOnly)
             return {
@@ -306,6 +319,7 @@ export async function installWorkspaceProject(options) {
                 reused: 0,
                 warnings,
             };
+        options.onProgress?.({ phase: "realizing" });
         const shared = await realizeGraph({
             store: options.store,
             graph: pureGraph,
@@ -443,6 +457,7 @@ export async function installWorkspaceProject(options) {
             });
             // Approved writes need a coherent fully private registry closure.
             await allocatePrivate(new Set(nodes.map((n) => n.key)));
+            options.onProgress?.({ phase: "building" });
             await buildPrivate({
                 project: root,
                 generationId,
@@ -498,6 +513,7 @@ export async function installWorkspaceProject(options) {
                     bins[name] = actual;
                 }
             }
+            options.onProgress?.({ phase: "linking" });
             await installProjection(holder, node.edges.map((e) => ({
                 name: e.name,
                 linkTarget: realized.packageDirByKey.get(e.target),

package/package.json

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