zyrk 0.6.3 → 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

package/VERSION

@@ -1 +1 @@
-v0.6.3
+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,CAkapE"}
+{"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")) {
@@ -621,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/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.map

@@ -1 +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"}
+{"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

@@ -12,10 +12,20 @@ export function sourceProgress(onProgress, total) {
     return {
         downloading(pkg) {
             let bytes = 0;
-            emit({ ...pkg, status: "downloading", bytes });
+            emit({
+                name: pkg.name,
+                version: pkg.version,
+                status: "downloading",
+                bytes,
+            });
             return (chunk) => {
                 bytes += chunk;
-                emit({ ...pkg, status: "downloading", bytes });
+                emit({
+                    name: pkg.name,
+                    version: pkg.version,
+                    status: "downloading",
+                    bytes,
+                });
             };
         },
         verified(pkg, status) {
@@ -23,7 +33,7 @@ export function sourceProgress(onProgress, total) {
                 reused++;
             else
                 downloaded++;
-            emit({ ...pkg, status });
+            emit({ name: pkg.name, version: pkg.version, status });
         },
     };
 }

package/package.json

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