zyrk 0.7.7 → 0.7.9

package/README.md

@@ -45,6 +45,13 @@ zyrk --help
 zyrk --version
 ```
 
+Native commands also provide focused help without starting an install or
+initializing the store. For example, use `zyrk install --help`,
+`zyrk docker init --help`, or `zyrk store --help`. Registry publishing and
+account commands are delegated to npm, so their help remains npm's own. The
+`zyrk <script>` shortcut is listed by `zyrk run --help` and is equivalent to
+`zyrk run <script>`.
+
 Requires **Node.js 24 or newer**. Published packages contain compiled JavaScript. A checkout runs TypeScript
 through Node's native type stripping; the check gate also builds and tests the
 source-free package layout. Installing zyrk requires no native toolchain.

package/VERSION

@@ -1 +1 @@
-v0.7.7
+v0.7.9

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

@@ -1 +1 @@
-{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../src/cli/main.ts"],"names":[],"mappings":"AAoCA,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;AAmFzC,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CA0BhD;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,KAAK,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IAC1B,MAAM,EAAE;QAAE,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IAC3D,MAAM,EAAE;QAAE,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IAC3D,WAAW,CAAC,EAAE,MAAM,MAAM,CAAC;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,OAAO,CAAC,eAAe,CAAC,CAAC;CACxC,CAAC;AAuDF,gFAAgF;AAChF,wBAAsB,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CAiiBpE"}
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../src/cli/main.ts"],"names":[],"mappings":"AAoCA,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;AAmFzC,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CA0BhD;AA0MD,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,KAAK,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IAC1B,MAAM,EAAE;QAAE,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IAC3D,MAAM,EAAE;QAAE,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IAC3D,WAAW,CAAC,EAAE,MAAM,MAAM,CAAC;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,OAAO,CAAC,eAAe,CAAC,CAAC;CACxC,CAAC;AAuDF,gFAAgF;AAChF,wBAAsB,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CAqiBpE"}

package/dist/cli/main.js

@@ -127,6 +127,195 @@ export function helpText(version) {
     lines.push("", "Install timeouts: ZYRK_RESOLVE_TIMEOUT_MS and ZYRK_EXTRACT_TIMEOUT_MS (1..900000 ms); ZYRK_REQUEST_TIMEOUT_MS (1..3600000 ms); ZYRK_FETCH_TIMEOUT_MS (1..3600000 ms).", "zyrk never installs packages globally and never runs npm to do it.", "Need a global package? Run npm directly: npm install --global <package-spec>");
     return `${lines.join("\n")}\n`;
 }
+const COMMAND_HELP = {
+    install: `Usage: zyrk install [package[@version] ...] [options]
+
+Install the project graph, or add the supplied packages. A portable package-lock.json records selections; the user store path stays machine-local.
+
+Options:
+  --frozen-lockfile  Fail if the lock does not match the project
+  --offline          Use verified local sources only
+  --ignore-scripts   Skip dependency lifecycle scripts
+  --lockfile-only    Write selections without linking dependencies
+  --omit=dev         Omit development dependencies
+  -D, --save-dev     Save added packages as development dependencies
+  -E, --save-exact   Save exact versions when adding packages
+  --registry=URL     Use the selected registry for this operation
+
+Examples:
+  zyrk install
+  zyrk install --frozen-lockfile
+  zyrk install prettier -D`,
+    i: `Usage: zyrk i [package[@version] ...] [options]
+
+Alias for zyrk install. See zyrk install --help for supported options and examples.`,
+    add: `Usage: zyrk add <package[@version] ...> [options]
+
+Add packages and install the updated project graph.
+
+Options:
+  -D, --save-dev       Save as development dependencies
+  -O, --save-optional  Save as optional dependencies
+  -E, --save-exact     Save exact versions
+  --ignore-scripts     Skip dependency lifecycle scripts
+  --lockfile-only      Update the lock without linking dependencies
+
+Example: zyrk add prettier -D`,
+    remove: `Usage: zyrk remove <package ...> [--ignore-scripts] [--lockfile-only]
+
+Remove direct dependencies and install the resulting graph.
+
+Example: zyrk remove prettier`,
+    update: `Usage: zyrk update [package ...] [options]
+
+Update selected packages, or all direct dependencies when no package is named.
+
+Options:
+  --latest           Select the latest versions, ignoring declared ranges
+  -E, --save-exact   Save exact versions
+  --ignore-scripts   Skip dependency lifecycle scripts
+  --lockfile-only    Update the lock without linking dependencies
+
+Example: zyrk update typescript`,
+    import: `Usage: zyrk import --from npm [--ignore-scripts] [--lockfile-only]
+
+Import supported selections from package-lock.json and install the graph.
+
+Example: zyrk import --from npm`,
+    run: `Usage: zyrk run [--workspace <name-or-path>] <script> [-- <args...>]
+       zyrk <script> [args...]
+
+Run a declared package script with local executable paths. The script runs in its package directory.
+
+Examples:
+  zyrk run build
+  zyrk dev
+  zyrk run --workspace web dev`,
+    exec: `Usage: zyrk exec [--workspace <name-or-path>] <executable> [args...]
+
+Run an executable already installed in the project. This command never fetches packages.
+
+Example: zyrk exec tsc --noEmit`,
+    list: `Usage: zyrk list [--workspace <name-or-path>] [--json]
+
+Show the installed project dependency graph. Use --json for machine-readable output.`,
+    why: `Usage: zyrk why [--workspace <name-or-path>] <package> [--json]
+
+Show the selected installed instances for a package. Use --json for machine-readable output.`,
+    doctor: `Usage: zyrk doctor [--workspace <name-or-path>] [--json]
+
+Read-only diagnostics for project files, installed links, policy, and installation state.`,
+    fetch: `Usage: zyrk fetch --frozen-lockfile [--offline]
+
+Fetch and verify the locked source closure without linking project dependencies.
+
+Example: zyrk fetch --frozen-lockfile --offline`,
+    audit: `Usage: zyrk audit [--audit-level <severity>] [--offline]
+
+Report advisories using the configured privacy policy. Severity is info, low, moderate, high, or critical.
+
+Example: zyrk audit --audit-level high`,
+    repair: `Usage: zyrk repair [--offline]
+
+Reconstruct project links from verified sources selected by the existing lockfile.`,
+    "approve-builds": `Usage: zyrk approve-builds [package ... | --all]
+
+Review build candidates without running package code. Select exact candidates to persist approval, or use --all to approve every candidate shown.
+
+Example: zyrk approve-builds`,
+    rebuild: `Usage: zyrk rebuild [--offline]
+
+Run previously approved dependency builds for the complete locked project graph.`,
+    next: `Usage: zyrk next --turbopack
+
+Explicitly configure the supported Next.js Turbopack adapter. The command preserves the existing configuration and writes a backup.
+
+Example: zyrk next --turbopack`,
+    dlx: `Usage: zyrk dlx <package[@version]> [args...]
+
+Fetch a temporary tool environment and run its executable. Tool arguments after the package are passed to that executable.
+
+Example: zyrk dlx vite --help`,
+    create: `Usage: zyrk create <initializer[@version]> [args...]
+
+Run a supported project initializer. Next.js scaffolds install dependencies with Zyrk; initializer arguments are passed through.
+
+Example: zyrk create next-app web`,
+    patch: `Usage: zyrk patch <package>
+
+Create a private editing area for a selected installed package source.
+
+Example: zyrk patch left-pad`,
+    "patch-commit": `Usage: zyrk patch-commit <package>
+
+Validate edits in a private package editing area and record the project patch.
+
+Example: zyrk patch-commit left-pad`,
+    store: `Usage: zyrk store <action>
+
+Actions:
+  path                 Print the configured store path
+  status               Show store initialization and counts
+  verify --full        Verify stored objects and realizations
+  gc [--dry-run]       Collect eligible unreferenced data
+  pin <project>        Retain a project closure
+  unpin <pin-id>       Remove a retention pin
+
+Use zyrk store gc --dry-run to preview collection.`,
+    projects: `Usage: zyrk projects <list | forget> [project-id]
+
+List registered projects or explicitly drop a retention root.
+
+Examples:
+  zyrk projects list
+  zyrk projects forget <project-id>`,
+    deploy: `Usage: zyrk deploy --out <new-directory> [options]
+
+Create a self-contained production output from an installed, verified project. The output directory's parent must already exist and the output directory must be new.
+
+Options:
+  --omit=dev         Omit development dependencies
+  --files <path>     Include a runtime file (repeatable), or declare package.json files
+  --entry <path>     Select the direct Node entry point
+
+Example: zyrk deploy --out release --files dist --entry dist/server.js`,
+    docker: `Usage: zyrk docker <init | build | run> [options]
+
+Generate a pinned Docker setup, build its image, or run it locally.
+
+Examples:
+  zyrk docker init --help
+  zyrk docker build --tag app:local
+  zyrk docker run --tag app:local`,
+};
+function commandHelpText(command) {
+    const help = COMMAND_HELP[command];
+    return help === undefined ? undefined : `${help}\n`;
+}
+function requestedCommandHelp(command, args) {
+    if (command === "docker" &&
+        args[1] !== undefined &&
+        ["-h", "--help"].includes(args[1])) {
+        const action = args[0];
+        if (action === "init")
+            return `Usage: zyrk docker init --node-image <image@sha256:digest> --cli-artifact <path> --cli-sha512 <digest> [options]\n\nGenerate reviewable Docker setup files. The pinned Node image and Zyrk CLI artifact are required.\n\nOptions: --build-script <script> --entry <file> --files <file>... --port <1..65535>\n`;
+        if (action === "build")
+            return `Usage: zyrk docker build --tag <local-image>\n\nBuild the generated Dockerfile with the explicit local image tag.\n`;
+        if (action === "run")
+            return `Usage: zyrk docker run --tag <local-image> [--port <host-port>]\n\nRun the generated application container and publish its configured port.\n`;
+    }
+    if (command === "store" &&
+        args[1] !== undefined &&
+        ["-h", "--help"].includes(args[1]))
+        return commandHelpText("store");
+    if (command === "projects" &&
+        args[1] !== undefined &&
+        ["-h", "--help"].includes(args[1]))
+        return commandHelpText("projects");
+    if (args[0] !== "--help" && args[0] !== "-h")
+        return undefined;
+    return commandHelpText(command);
+}
 function ok(stdout, parsed) {
     if (!parsed.json)
         return { exitCode: 0, stdout, stderr: "" };
@@ -332,6 +521,11 @@ export async function runCli(options) {
             return emit(fail(toZyrkError(error, "zyrk failed while delegating to npm."), parsed));
         }
     }
+    if (!parsed.help && !parsed.version && parsed.command !== undefined) {
+        const help = requestedCommandHelp(parsed.command, parsed.commandArgs);
+        if (help !== undefined)
+            return emit(ok(help, parsed));
+    }
     if (!parsed.help &&
         !parsed.version &&
         parsed.command &&

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

@@ -1 +1 @@
-{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../src/install/run.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../src/install/run.ts"],"names":[],"mappings":"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"}

package/dist/install/run.js

@@ -37,8 +37,15 @@ import { sha512Hex } from "../util/hash.js";
 import { canonicalJson } from "../util/json.js";
 import { lockedGraph, packageName, cleanUrl, lockMismatch } from "./lock.js";
 function error(code, message) {
+    const remedy = {
+        ZYRK_MANIFEST_INVALID: "Correct the package.json syntax or dependency declarations, then run zyrk install again.",
+        ZYRK_NOT_IMPLEMENTED: "Remove the unsupported project setting or use a supported workflow; run zyrk --help to review available commands.",
+        ZYRK_POLICY_DENIED: "Review the project and user policy settings involved in this operation, then retry with an explicitly supported configuration.",
+        ZYRK_USAGE: "Run zyrk install --help to review supported install options and correct the invocation.",
+        ZYRK_OFFLINE_MISSING: "Connect to the configured registry and run zyrk install to verify and cache the required sources; retry offline after that succeeds.",
+    }[code];
     return new ZyrkError(code, message, {
-        remedy: "Review package.json and the documented zyrk install options, then retry.",
+        remedy,
     });
 }
 function object(value) {

package/package.json

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