zyrk 0.6.2 → 0.6.6

package/README.md

@@ -178,7 +178,14 @@ For `create next-app`, the native adapter accepts resolved create-next-app
 scaffold check covers 16.4.2. Other versions fail before execution. zyrk passes the official `--skip-install` flag to
 create-next-app, validates the generated project manifest, then installs its
 dependencies through zyrk using the same store and registry configuration. An
-explicit `--skip-install` leaves the generated project uninstalled. The official
+explicit `--skip-install` leaves the generated project uninstalled.
+The private initializer displays `Using zyrk.` for native installation, or
+`Scaffolding only; dependency installation skipped.` for an explicit skip. This
+adapts verified upstream display statements without changing shared source
+files, installer execution, generated metadata, or unrelated npm text. An
+unrecognized display contract fails before the initializer runs. Conflicting
+`--use-npm`, `--use-pnpm`, `--use-yarn`, and `--use-bun` selections require an
+explicit `--skip-install`; remove them to install with zyrk. The official
 flag can select create-next-app's configuration defaults instead of prompting
 for each choice; pass its explicit configuration flags to customize them. Its
 interactive project-name prompt remains available. Supply an explicit target
@@ -187,9 +194,13 @@ limited to one newly created direct child directory. If generation exits without
 a valid manifest, zyrk reports failure and retains any generated files for review.
 
 For Next.js 16.4.2 with dependencies in the external shared store, use
-`zyrk run dev -- --webpack` and `zyrk run build -- --webpack`. Strict-root
-Turbopack rejects that layout. The [Next compatibility report](docs/next-compatibility.md)
-records the tested scaffold, native install, build and HTTP runtime.
+`zyrk run dev -- --webpack` and `zyrk run build -- --webpack`, or explicitly opt
+into Turbopack with `zyrk next --turbopack` before normal `zyrk run dev` / build.
+The [Turbopack guide](docs/next-turbopack.md) explains the experimental additional
+roots, preserved configuration, portable local-state lookup, and deployment
+boundary. The [Next compatibility report](docs/next-compatibility.md) records
+the tested scaffold, native install, build and HTTP runtime. These checks cover
+Linux x64; they do not establish universal framework or device support.
 
 Other initializers control their own dependency-install step and may invoke
 another package manager. Use their skip-install option, when available, then run
@@ -394,7 +405,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.6

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":"AA4BA,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,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,CA8bpE"}

package/dist/cli/main.js

@@ -1,3 +1,4 @@
+import { runNextCommand } from "../commands/next.js";
 import { createInstallProgress } from "./progress.js";
 import { runMaintenanceCommand } from "../commands/maintenance.js";
 import { runDeployCommand } from "../commands/deploy.js";
@@ -37,6 +38,7 @@ const NATIVE_COMMANDS = [
     ["exec", "Run an installed executable (never fetches)."],
     ["dlx", "Explicitly fetch and run a temporary tool environment."],
     ["create", "Scaffold from a create-* starter package."],
+    ["next", "Explicitly configure Next Turbopack: next --turbopack."],
     ["list, why", "Show the installed graph / why a dependency is selected."],
     ["doctor", "Diagnose filesystem, links, policy, install-state issues."],
     ["approve-builds, rebuild", "Review script permissions / rebuild."],
@@ -58,6 +60,7 @@ for (const [names] of NATIVE_COMMANDS) {
 const IMPLEMENTED_COMMANDS = new Set([
     "dlx",
     "create",
+    "next",
     "install",
     "i",
     "add",
@@ -375,6 +378,30 @@ export async function runCli(options) {
             return emit(fail(toZyrkError(error, `zyrk ${parsed.command} failed.`), parsed));
         }
     }
+    if (!parsed.help && !parsed.version && parsed.command === "next") {
+        try {
+            const result = await runNextCommand({
+                args: parsed.commandArgs,
+                cwd: options.cwd ?? process.cwd(),
+                env: options.env,
+            });
+            return emit({
+                exitCode: 0,
+                stdout: parsed.json
+                    ? JSON.stringify({
+                        schemaVersion: CLI_JSON_SCHEMA_VERSION,
+                        command: "next",
+                        status: "ok",
+                        ...result,
+                    }) + "\n"
+                    : `${result.changed ? "Configured" : "Already configured"} Next Turbopack with the project's strict root and the installed external shared realizations. Experimental additional roots require Next.js 16.4+. Backup: ${result.backup}.\n`,
+                stderr: "",
+            });
+        }
+        catch (error) {
+            return emit(fail(toZyrkError(error, "Next Turbopack configuration failed."), parsed));
+        }
+    }
     if (!parsed.help &&
         !parsed.version &&
         (parsed.command === "install" || parsed.command === "i")) {
@@ -480,11 +507,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 +521,7 @@ export async function runCli(options) {
                 store: tools.store,
                 registry: tools.registry,
             });
+            progress.close();
             if (parsed.json) {
                 return emit({
                     exitCode: 0,
@@ -501,13 +531,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 &&
@@ -614,7 +648,7 @@ async function runToolCommand(command, parsed, options, version) {
     options.stderr.write(isNext
         ? tail.includes("--skip-install")
             ? "zyrk: Next scaffolding only; dependency installation was explicitly skipped.\n"
-            : "zyrk: Next scaffolder runs with --skip-install; zyrk will install dependencies.\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);
     try {

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/commands/next.d.ts

@@ -0,0 +1,10 @@
+export declare function runNextCommand(options: {
+    args: readonly string[];
+    cwd: string;
+    env: NodeJS.ProcessEnv;
+}): Promise<{
+    changed: boolean;
+    config: string;
+    backup: string;
+}>;
+//# sourceMappingURL=next.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"next.d.ts","sourceRoot":"","sources":["../../src/commands/next.ts"],"names":[],"mappings":"AAqFA,wBAAsB,cAAc,CAAC,OAAO,EAAE;IAC5C,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;CACxB,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CA0LhE"}

package/dist/commands/next.js

@@ -0,0 +1,185 @@
+/** Explicit Next.js configuration editing; ordinary installs never call this. */
+import { constants } from "node:fs";
+import { chmod, copyFile, lstat, readFile, realpath, readdir, rm, writeFile, } from "node:fs/promises";
+import * as path from "node:path";
+import { satisfies } from "semver";
+import { findProjectBoundary, resolveStoreRoot } from "../config/paths.js";
+import { ZyrkError } from "../errors.js";
+import { lockedGraph } from "../install/lock.js";
+import { selectPlatformGraph } from "../install/platform.js";
+import { validateLockDoc } from "../lockfile/read.js";
+import { manifestFingerprint } from "../lockfile/fingerprints.js";
+import { Store } from "../store/layout.js";
+import { createGraphDoc, contextIdFor } from "../store/graph.js";
+import { packageDirIn, selectRealizationDirs } from "../store/realize.js";
+import { verifyRealization } from "../store/verify.js";
+import { acquireLock } from "../util/locks.js";
+import { isErrno, writeFileAtomic } from "../util/fsx.js";
+import { sha512Hex } from "../util/hash.js";
+import { canonicalJson } from "../util/json.js";
+const HELPER = "next.config.zyrk-turbopack.cjs";
+const DECLARATION = "next.config.zyrk-turbopack.d.cts";
+const MARKER = "// Managed by explicit zyrk next --turbopack; original configuration is preserved.\n";
+const TYPES = "declare function withZyrkTurbopack<T>(configuration: T, projectDir: string): T;\nexport = withZyrkTurbopack;\n";
+const RUNTIME = `// Local paths are discovered at Next startup, never committed into configuration.
+const fs = require("node:fs");
+const path = require("node:path");
+const crypto = require("node:crypto");
+const canonical = value => JSON.stringify(value && typeof value === "object" ? Array.isArray(value) ? value.map(v => JSON.parse(canonical(v))) : Object.fromEntries(Object.keys(value).sort().map(k => [k, JSON.parse(canonical(value[k]))])) : value);
+const inside = (root, file) => { const relative = path.relative(root, file); return relative === "" || (!relative.startsWith(".." + path.sep) && relative !== ".." && !path.isAbsolute(relative)); };
+module.exports = (configuration, directory) => async (phase, context) => {
+  if (process.platform === "win32") throw new Error("zyrk Turbopack Windows support has not passed its compatibility gate.");
+  const project = fs.realpathSync(directory);
+  const state = JSON.parse(fs.readFileSync(path.join(project, "node_modules/.zyrk/install-state.json"), "utf8"));
+  if (state.schemaVersion !== 1 || state.readiness !== "ready" || state.linker !== "shared" || typeof state.storeRoot !== "string" || !path.isAbsolute(state.storeRoot)) throw new Error("zyrk Turbopack requires a ready shared installation; run zyrk install.");
+  const lock = JSON.parse(fs.readFileSync(path.join(project, "package-lock.json"), "utf8"));
+  if (crypto.createHash("sha512").update(canonical(lock)).digest("hex") !== state.lockDigest) throw new Error("zyrk Turbopack installation and lock disagree; run zyrk install.");
+  const next = fs.realpathSync(path.join(project, "node_modules/next"));
+  const version = JSON.parse(fs.readFileSync(path.join(next, "package.json"), "utf8")).version;
+  if (typeof version !== "string" || !/^16\\.(?:[4-9]|[1-9][0-9]+)\\.[0-9]+$/.test(version)) throw new Error("zyrk Turbopack additional roots require stable Next.js 16.4.x through 16.x.");
+  const store = fs.realpathSync(path.join(state.storeRoot, "realizations"));
+  const direct = Array.isArray(state.direct) && state.direct.find(edge => edge.name === "next");
+  if (!direct || fs.realpathSync(direct.target) !== next || !inside(store, next) || inside(project, store) || inside(store, project)) throw new Error("zyrk Turbopack requires the recorded external shared dependency projection.");
+  const resolved = await (typeof configuration === "function" ? configuration(phase, context) : configuration);
+  if (!resolved || typeof resolved !== "object" || Array.isArray(resolved)) throw new Error("The original Next configuration must return an object.");
+  const roots = resolved.experimental?.turbopackAdditionalRoots || {};
+  if (roots.zyrkStore && fs.realpathSync(roots.zyrkStore.path) !== store) throw new Error("The existing zyrkStore Turbopack root conflicts with the installed store.");
+  return { ...resolved, turbopack: { ...resolved.turbopack, root: project }, experimental: { ...resolved.experimental, turbopackAdditionalRoots: { ...roots, zyrkStore: { path: store } } } };
+};
+`;
+function denied(message) {
+    return new ZyrkError("ZYRK_USAGE", message, {
+        remedy: "Run zyrk next --turbopack in a ready shared Next.js 16.4+ project; restore or review existing configuration files before retrying.",
+    });
+}
+async function regular(file) {
+    const info = await lstat(file);
+    if (!info.isFile() || info.isSymbolicLink())
+        throw denied("Next configuration editing requires regular files.");
+}
+function wrapper(name, esm) {
+    const original = name.replace(/\.(ts|mjs|js)$/, ".zyrk-original.$1");
+    if (!esm)
+        return `${MARKER}module.exports = require("./${HELPER}")(require("./${original}"), __dirname);\n`;
+    const importedOriginal = name.endsWith(".ts")
+        ? original.slice(0, -3)
+        : original;
+    const directory = name.endsWith(".mjs") || name.endsWith(".js")
+        ? 'fileURLToPath(new URL(".", import.meta.url))'
+        : "__dirname";
+    return `${MARKER}${directory === "__dirname" ? "" : 'import { fileURLToPath } from "node:url";\n'}import original from "./${importedOriginal}";\nimport withZyrkTurbopack from "./${HELPER}";\n\nexport default withZyrkTurbopack(original, ${directory});\n`;
+}
+export async function runNextCommand(options) {
+    if (process.platform === "win32")
+        throw new ZyrkError("ZYRK_PLATFORM_UNSUPPORTED", "Next Turbopack configuration is not verified on Windows.", {
+            remedy: "Use a platform with a verified zyrk store; Windows support remains gated.",
+        });
+    if (options.args.length !== 1 || options.args[0] !== "--turbopack")
+        throw denied("Next configuration editing requires the explicit --turbopack option.");
+    const boundary = await findProjectBoundary(options.cwd);
+    if (!boundary)
+        throw denied("Cannot find a Next project manifest.");
+    const project = await realpath(boundary);
+    const control = await lstat(path.join(project, ".zyrk-local"));
+    if (!control.isDirectory() || control.isSymbolicLink())
+        throw denied("Next project control directory is unsafe.");
+    const held = await acquireLock(path.join(project, ".zyrk-local/project.lock"), { name: "Next Turbopack configuration" });
+    try {
+        const state = JSON.parse(await readFile(path.join(project, "node_modules/.zyrk/install-state.json"), "utf8"));
+        const doc = validateLockDoc(JSON.parse(await readFile(path.join(project, "package-lock.json"), "utf8")), "project package-lock.json");
+        if (state.schemaVersion !== 1 ||
+            state.readiness !== "ready" ||
+            state.linker !== "shared" ||
+            state.lockDigest !== sha512Hex(canonicalJson(doc)))
+            throw denied("Next configuration requires a ready shared installation matching its lock.");
+        const manifest = JSON.parse(await readFile(path.join(project, "package.json"), "utf8"));
+        if (doc.zyrk?.manifest !== manifestFingerprint(manifest))
+            throw denied("The Next project manifest differs from its installed lock.");
+        const resolved = lockedGraph(doc);
+        const selected = selectPlatformGraph({
+            ...resolved,
+            roots: resolved.roots.filter((root) => Array.isArray(state.direct) &&
+                state.direct.some((edge) => edge.name === root.name)),
+        }, new Set(Object.keys(doc.packages?.[""]?.optionalDependencies ?? {})));
+        const next = selected.nodes.find((node) => node.name === "next" &&
+            selected.roots.some((root) => root.name === "next" && root.target === node.key));
+        if (!next || !satisfies(next.version, ">=16.4.0 <17.0.0"))
+            throw denied("The additional-root adapter requires stable Next.js 16.4.x through 16.x.");
+        const store = await Store.open({
+            root: resolveStoreRoot({ env: options.env }).root,
+        });
+        store.requireInitialized();
+        if (state.storeRoot !== store.root)
+            throw denied("The installed Next store differs from the selected user store.");
+        const storeRealizations = await realpath(store.paths.realizationsDir);
+        const contains = (root, file) => {
+            const relative = path.relative(root, file);
+            return (relative === "" ||
+                (!relative.startsWith(".." + path.sep) &&
+                    relative !== ".." &&
+                    !path.isAbsolute(relative)));
+        };
+        if (contains(project, storeRealizations) ||
+            contains(storeRealizations, project))
+            throw denied("The Turbopack adapter requires shared realizations outside the project root.");
+        const graph = createGraphDoc(selected.nodes.map((node) => ({ ...node, deps: node.edges })));
+        const directories = selectRealizationDirs(store, graph);
+        await verifyRealization({
+            store,
+            graph,
+            rootKey: next.key,
+            contextId: contextIdFor(graph, next.key),
+            realizationDirs: directories,
+        });
+        if ((await realpath(path.join(project, "node_modules/next"))) !==
+            (await realpath(packageDirIn(directories.get(next.key), "next"))))
+            throw denied("The installed Next link differs from its verified context.");
+        const names = (await readdir(project)).filter((name) => ["next.config.ts", "next.config.js", "next.config.mjs"].includes(name));
+        if (names.length !== 1)
+            throw denied("Select a project with exactly one supported Next configuration file.");
+        const name = names[0];
+        const original = name.replace(/\.(ts|mjs|js)$/, ".zyrk-original.$1");
+        const target = path.join(project, name);
+        await regular(target);
+        const contents = await readFile(target, "utf8");
+        const generated = wrapper(name, name !== "next.config.js" || manifest.type === "module");
+        if (contents === generated) {
+            for (const file of [original, HELPER, DECLARATION])
+                await regular(path.join(project, file));
+            if ((await readFile(path.join(project, HELPER), "utf8")) !== RUNTIME ||
+                (await readFile(path.join(project, DECLARATION), "utf8")) !== TYPES)
+                throw denied("The existing Turbopack adapter was changed; review it before retrying.");
+            return { changed: false, config: name, backup: original };
+        }
+        const created = [];
+        let configWriteAttempted = false;
+        try {
+            await copyFile(target, path.join(project, original), constants.COPYFILE_EXCL);
+            created.push(original);
+            await chmod(path.join(project, original), 0o444);
+            for (const [file, text] of [
+                [HELPER, RUNTIME],
+                [DECLARATION, TYPES],
+            ]) {
+                await writeFile(path.join(project, file), text, { flag: "wx" });
+                created.push(file);
+            }
+            configWriteAttempted = true;
+            await writeFileAtomic(target, generated);
+        }
+        catch (cause) {
+            // The atomic write may have renamed successfully before a durability
+            // error. Retain its dependencies and original backup for recovery.
+            if (!configWriteAttempted)
+                for (const file of created.reverse())
+                    await rm(path.join(project, file)).catch(() => { });
+            if (isErrno(cause, "EEXIST"))
+                throw denied("A Next configuration backup or adapter already exists; no existing files were overwritten.");
+            throw cause;
+        }
+        return { changed: true, config: name, backup: original };
+    }
+    finally {
+        await held.release();
+    }
+}

package/dist/dlx/next-display.d.ts

@@ -0,0 +1,2 @@
+export declare function adaptNextDisplay(script: string, version: string, skipInstall: boolean): Promise<void>;
+//# sourceMappingURL=next-display.d.ts.map

package/dist/dlx/next-display.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"next-display.d.ts","sourceRoot":"","sources":["../../src/dlx/next-display.ts"],"names":[],"mappings":"AAQA,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,OAAO,GACnB,OAAO,CAAC,IAAI,CAAC,CA8Cf"}

package/dist/dlx/next-display.js

@@ -0,0 +1,36 @@
+/** A display-only adaptation of verified create-next-app statement shapes.
+ * Official source: v16.4.2 create-app.ts and templates/index.ts. Installer
+ * selection and executable logic stay upstream; --skip-install keeps the
+ * native zyrk installation separate. Only the private initializer is edited.
+ */
+import { lstat, readFile, writeFile } from "node:fs/promises";
+import { ZyrkError } from "../errors.js";
+export async function adaptNextDisplay(script, version, skipInstall) {
+    const file = await lstat(script);
+    if (!file.isFile() || file.nlink !== 1 || (file.mode & 0o200) === 0)
+        throw new ZyrkError("ZYRK_INTERNAL", "Cannot adapt the Next initializer without an independent writable script.", {
+            remedy: "Retry with a private initializer generation; never make shared store files writable.",
+        });
+    const original = await readFile(script, "utf8");
+    // Match complete neighboring statements, not arbitrary output strings. Minifier
+    // variable names can vary; the verified statement structure must match once.
+    const header = /console\.log\(`Creating a new Next\.js app in \$\{\(0,([A-Za-z_$][\w$]*)\.green\)\(([A-Za-z_$][\w$]*)\)\}\.`\);console\.log\(\);process\.chdir\(\2\);/g;
+    const label = /console\.log\(\(0,([A-Za-z_$][\w$]*)\.bold\)\(`Using \$\{[A-Za-z_$][\w$]*\}\.`\)\);(?=console\.log\("\\nInitializing project with template:",[A-Za-z_$][\w$]*,"\\n"\);)/g;
+    const headers = [...original.matchAll(header)];
+    const labels = [...original.matchAll(label)];
+    if (headers.length !== 1 ||
+        labels.length !== 1 ||
+        headers[0][1] !== labels[0][1])
+        throw new ZyrkError("ZYRK_RESOLUTION_FAILED", "Cannot adapt the selected Next initializer: its display contract is unsupported.", {
+            detail: { package: "create-next-app", version },
+            remedy: "Select create-next-app@16.4.2 or report this version so its upstream display contract can be verified.",
+        });
+    const message = skipInstall
+        ? "Scaffolding only; dependency installation skipped."
+        : "Using zyrk.";
+    const adapted = original
+        .replace(label, "")
+        .replace(header, (statement, color, target) => statement.slice(0, -`process.chdir(${target});`.length) +
+        `console.log((0,${color}.bold)(${JSON.stringify(message)}));console.log();process.chdir(${target});`);
+    await writeFile(script, adapted);
+}

package/dist/dlx/next.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"next.d.ts","sourceRoot":"","sources":["../../src/dlx/next.ts"],"names":[],"mappings":"AAQA,OAAO,EAAkB,KAAK,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAExE,OAAO,EAAkB,KAAK,UAAU,EAAE,KAAK,SAAS,EAAE,MAAM,UAAU,CAAC;AAuC3E,wBAAgB,UAAU,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,GAAG,SAAS,CAEtE;AA4CD,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,UAAU,GAAG;IAAE,iBAAiB,CAAC,EAAE,cAAc,CAAC,YAAY,CAAC,CAAA;CAAE,GACzE,OAAO,CAAC,SAAS,CAAC,CAkGpB"}
+{"version":3,"file":"next.d.ts","sourceRoot":"","sources":["../../src/dlx/next.ts"],"names":[],"mappings":"AASA,OAAO,EAAkB,KAAK,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAExE,OAAO,EAAkB,KAAK,UAAU,EAAE,KAAK,SAAS,EAAE,MAAM,UAAU,CAAC;AAuC3E,wBAAgB,UAAU,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,GAAG,SAAS,CAEtE;AA4CD,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,UAAU,GAAG;IAAE,iBAAiB,CAAC,EAAE,cAAc,CAAC,YAAY,CAAC,CAAA;CAAE,GACzE,OAAO,CAAC,SAAS,CAAC,CAoHpB"}

package/dist/dlx/next.js

@@ -5,6 +5,7 @@
 import { lstat, readFile, readdir } from "node:fs/promises";
 import * as path from "node:path";
 import { satisfies } from "semver";
+import { adaptNextDisplay } from "./next-display.js";
 import { ZyrkError } from "../errors.js";
 import { installProject } from "../install/run.js";
 import { isErrno } from "../util/fsx.js";
@@ -106,6 +107,11 @@ export async function runNextInitializer(options) {
         throw failed("Next initializer target already has a project manifest.");
     const entries = explicit === undefined ? new Set(await readdir(cwd)) : undefined;
     const skipInstall = flags.has("--skip-install");
+    if (!skipInstall &&
+        [...flags].some((flag) => ["--use-npm", "--use-pnpm", "--use-yarn", "--use-bun"].includes(flag)))
+        throw new ZyrkError("ZYRK_USAGE", "Cannot select another dependency installer for zyrk create next-app.", {
+            remedy: "Remove --use-npm/--use-pnpm/--use-yarn/--use-bun to install with zyrk, or pass --skip-install to scaffold only.",
+        });
     // Insert before -- so it remains an option when the user supplies a literal target.
     const forwarded = [...args];
     if (!skipInstall) {
@@ -123,7 +129,7 @@ export async function runNextInitializer(options) {
                     remedy: "Select create-next-app 15.x or 16.x; the native create adapter requires the verified --skip-install contract.",
                 });
         },
-    });
+    }, async ({ script, version }) => adaptNextDisplay(script, version, skipInstall));
     if (result.exitCode !== 0)
         return result;
     let directory = explicit;

package/dist/dlx/run.d.ts

@@ -57,5 +57,9 @@ export declare function splitDlxSpec(spec: string): {
 export declare function runDlx(options: DlxOptions): Promise<DlxResult>;
 /** Initializers copy and rewrite their shipped templates, so their full
  * closure must use independent writable files (I-001, I-002, F-017). */
-export declare function runInitializer(options: DlxOptions): Promise<DlxResult>;
+export declare function runInitializer(options: DlxOptions, prepare?: (tool: {
+    script: string;
+    name: string;
+    version: string;
+}) => Promise<void>): Promise<DlxResult>;
 //# sourceMappingURL=run.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../src/dlx/run.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAgBH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAGxC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAgBhD,MAAM,MAAM,UAAU,GAAG;IACvB,KAAK,EAAE,KAAK,CAAC;IACb,QAAQ,EAAE,cAAc,CAAC;IACzB,uEAAuE;IACvE,IAAI,EAAE,MAAM,CAAC;IACb,8CAA8C;IAC9C,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACzB,mEAAmE;IACnE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,4EAA4E;IAC5E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8DAA8D;IAC9D,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iFAAiF;IACjF,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;CAClE,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,iEAAiE;IACjE,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,kEAAkE;IAClE,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,kEAAkE;AAClE,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACrB,CAqBA;AAED,wBAAsB,MAAM,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC,CAEpE;AAED;wEACwE;AACxE,wBAAsB,cAAc,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC,CAE5E"}
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../src/dlx/run.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAgBH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAGxC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAgBhD,MAAM,MAAM,UAAU,GAAG;IACvB,KAAK,EAAE,KAAK,CAAC;IACb,QAAQ,EAAE,cAAc,CAAC;IACzB,uEAAuE;IACvE,IAAI,EAAE,MAAM,CAAC;IACb,8CAA8C;IAC9C,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACzB,mEAAmE;IACnE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,4EAA4E;IAC5E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8DAA8D;IAC9D,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iFAAiF;IACjF,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;CAClE,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,iEAAiE;IACjE,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,kEAAkE;IAClE,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,kEAAkE;AAClE,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACrB,CAqBA;AAED,wBAAsB,MAAM,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC,CAEpE;AAED;wEACwE;AACxE,wBAAsB,cAAc,CAClC,OAAO,EAAE,UAAU,EACnB,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE;IACf,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB,KAAK,OAAO,CAAC,IAAI,CAAC,GAClB,OAAO,CAAC,SAAS,CAAC,CAEpB"}

package/dist/dlx/run.js

@@ -59,10 +59,10 @@ export async function runDlx(options) {
 }
 /** Initializers copy and rewrite their shipped templates, so their full
  * closure must use independent writable files (I-001, I-002, F-017). */
-export async function runInitializer(options) {
-    return runTemporaryTool(options, true);
+export async function runInitializer(options, prepare) {
+    return runTemporaryTool(options, true, prepare);
 }
-async function runTemporaryTool(options, writable) {
+async function runTemporaryTool(options, writable, prepare) {
     const { store, registry } = options;
     const args = options.args ?? [];
     const cwd = options.cwd ?? process.cwd();
@@ -148,6 +148,7 @@ async function runTemporaryTool(options, writable) {
         if (binTarget === undefined)
             throw internal(`selected bin ${binKey} vanished`);
         const script = await resolveBinScript(toolPkgDir, tool, binKey, binTarget);
+        await prepare?.({ script, name: tool.name, version: tool.version });
         const bins = {};
         for (const [name, target] of Object.entries(tool.bin)) {
             bins[name] = await resolveBinScript(toolPkgDir, tool, name, target);

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,WAQP,MAAM;IAUvB,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,48 @@
+/** 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({
+                name: pkg.name,
+                version: pkg.version,
+                status: "downloading",
+                bytes,
+            });
+            return (chunk) => {
+                bytes += chunk;
+                emit({
+                    name: pkg.name,
+                    version: pkg.version,
+                    status: "downloading",
+                    bytes,
+                });
+            };
+        },
+        verified(pkg, status) {
+            if (status === "reused")
+                reused++;
+            else
+                downloaded++;
+            emit({ name: pkg.name, version: pkg.version, 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":"AAEA,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,GACT,UAAU,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE;QACR,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,aAAa,GAAG,YAAY,GAAG,QAAQ,GAAG,QAAQ,CAAC;QAC3D,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;CACH,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,CAiyBxB"}

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.6",
   "description": "Storage-efficient Node package manager: one verified store per user, shared across projects through links.",
   "license": "MIT",
   "type": "module",