agent-kitchen 0.4.0 → 0.6.0

package/dist/tools.js

@@ -1,7 +1,7 @@
 /**
  * @file How agent-kitchen reaches the other tools and their releases: `npx` to run them (always
  * by their scoped name or GitHub spec, because the unscoped names on npm belong to other
- * people), `npm view` for the latest version on npm, and `git ls-remote` for the latest
+ * people), `npm view` for the latest version on npm and a version's dependencies, and `git ls-remote` for the latest
  * `vX.Y.Z` tag on GitHub. Everything is asynchronous so the lookups run at the same time,
  * and each lookup runs once per process. A lookup that fails, or takes over 20 seconds,
  * gives null: the piece is shown, not offered. git never asks for credentials here.
@@ -67,7 +67,10 @@ export function isRelease(version) {
  */
 function run(program, args, options = {}) {
     return new Promise((resolve) => {
-        const child = spawn(program, args, { cwd: options.cwd, env: { ...process.env, ...options.env }, stdio: options.inherit === true ? "inherit" : ["ignore", "pipe", "pipe"] });
+        const env = { ...process.env, ...options.env };
+        for (const name of options.unset ?? [])
+            delete env[name];
+        const child = spawn(program, args, { cwd: options.cwd, env, stdio: options.inherit === true ? "inherit" : ["ignore", "pipe", "pipe"] });
         let out = "";
         let err = "";
         child.stdout?.on("data", (chunk) => (out += chunk.toString()));
@@ -108,6 +111,26 @@ export function npmLatest(name) {
         return isRelease(version) ? version : null;
     });
 }
+/**
+ * The dependencies a version of a package declares on npm.
+ * @param spec - The package and its version, as `name@x.y.z`.
+ * @returns Each dependency's range, or null if npm cannot tell.
+ * @example await npmDependencies("@ramon-sg/issue-flow@0.3.0") // { "@ramon-sg/github-rest": "^0.3.0" }
+ */
+export function npmDependencies(spec) {
+    return once(`npm-deps:${spec}`, async () => {
+        const result = await run("npm", ["view", spec, "dependencies", "--json", "--fetch-retries=0"], { timeout: LOOKUP_TIMEOUT_MS });
+        if (result.status !== 0)
+            return null;
+        try {
+            const found = JSON.parse(result.out);
+            return typeof found === "object" && found !== null && !Array.isArray(found) ? found : null;
+        }
+        catch {
+            return null;
+        }
+    });
+}
 /**
  * The highest `vX.Y.Z` tag of a GitHub repo.
  * @param repo - The repo, as owner/name.
@@ -162,14 +185,38 @@ export function failedOutput(output) {
     return lines.slice(-FAILED_LINES).map((line) => `    ${line}\n`).join("");
 }
 /**
- * Runs `npx --yes <args>` in the repo and returns what it printed on stdout.
+ * Runs `npx --yes <args>` in the repo and returns what it printed.
  * @param root - The repo.
  * @param args - The package and its arguments.
  * @param lookup - True to give up after the lookups' time limit, for a read that only informs.
- * @returns Its stdout and exit code, or null if npx could not start.
+ * @returns Its stdout, stderr and exit code, or null if npx could not start.
  * @example await captureNpx(root, ["@ramon-sg/issue-flow@0.2.0", "doctor", "--json"])
  */
 export async function captureNpx(root, args, lookup = false) {
     const result = await run("npx", ["--yes", ...args], { cwd: root, ...(lookup ? { timeout: LOOKUP_TIMEOUT_MS } : {}) });
-    return result.status === null && result.out === "" ? null : { out: result.out, status: result.status };
+    return result.status === null && result.out === "" ? null : { out: result.out, err: result.err, status: result.status };
+}
+/**
+ * Runs the repo's package manager's install: quietly, or with its output on the terminal
+ * with `--verbose`.
+ * @param root - The repo.
+ * @param manager - `npm`, `pnpm`, `bun` or `yarn`.
+ * @returns Whether it worked and, if it ran quietly, what it printed.
+ * @example await runInstall(root, "pnpm")
+ */
+export async function runInstall(root, manager) {
+    const result = await run(manager, ["install"], { cwd: root, inherit: verbose });
+    return { ok: result.status === 0, output: `${result.out}${result.err}` };
+}
+/**
+ * Runs `npx --yes <args>` in the repo without some variables of the environment, and returns
+ * what it printed.
+ * @param root - The repo.
+ * @param args - The package and its arguments.
+ * @param unset - The variables left out.
+ * @returns Its stdout, stderr and exit code.
+ * @example await captureNpxWithout(root, ["@ramon-sg/github-rest@0.3.0", "pr", "create"], ["GH_REPO"])
+ */
+export async function captureNpxWithout(root, args, unset) {
+    return run("npx", ["--yes", ...args], { cwd: root, unset });
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-kitchen",
-  "version": "0.4.0",
+  "version": "0.6.0",
   "description": "One command to install, update and check a repo's agent tooling: the issue flow and its skills, the general skills, Claude cloud sessions, claude-repo-guard and the installed-versions rule in AGENTS.md.",
   "license": "MIT",
   "type": "module",