@duyquangnvx/agent-cli 0.0.0-stage → 0.1.0

package/dist/update.js

@@ -0,0 +1,91 @@
+import * as z from "zod";
+import { defineCommand } from "./define.js";
+import { FailureWithData } from "./errors.js";
+import { globalInstallOf } from "./global-install.js";
+import { INTERRUPTED } from "./interrupts.js";
+import { installGlobally, latestVersion, npmContext } from "./npm.js";
+import { standingOf } from "./semver.js";
+import { skillUpdateCommand } from "./skills.js";
+import { upgradeNotes } from "./upgrade-notes.js";
+const updateSchema = z.object({
+    from: z.string(),
+    latest: z.string(),
+    installed: z.object({ version: z.string(), prefix: z.string() }).nullable(),
+    upgrades: z.array(z.object({ version: z.string(), notes: z.string() })),
+    next: z.array(z.string()),
+});
+function nothingToInstall({ from, latest }) {
+    return standingOf(from, latest) === "current"
+        ? `already on ${from}, the latest release: nothing to install`
+        : `${from} is newer than the latest release ${latest}: nothing to install`;
+}
+function renderUpdate(cli, install, update) {
+    const { installed } = update;
+    if (installed === null) {
+        return nothingToInstall(update);
+    }
+    return [
+        `installed ${install.package}@${installed.version} with the npm under ${installed.prefix}, replacing ${update.from}`,
+        ...update.upgrades.map(({ version, notes }) => `\nchanges in ${version}:\n${notes}`),
+        "",
+        ...update.next.map((command) => `next: ${command}, so the ${cli.name} skill describes ${installed.version}`),
+    ].join("\n");
+}
+// The install ran to its end, so the run reports it rather than asking for a rerun.
+function interruptedAfterInstall(plan, update) {
+    return new FailureWithData({
+        code: INTERRUPTED,
+        message: `interrupted, but ${plan.package}@${plan.latest} had already been installed with the npm under ${plan.prefix}, replacing ${plan.from}`,
+        hint: "nothing to run again: run the commands under next",
+        retryable: false,
+    }, update);
+}
+/** The built-in `update`, for a CLI installed globally with npm. */
+export function updateCommand(cli, install, bin) {
+    return defineCommand({
+        name: "update",
+        description: "install the latest version of this CLI from its registry",
+        examples: [
+            { command: `${cli.name} update`, note: "install the latest version and show what changed" },
+            { command: `${cli.name} update --dry-run`, note: "show the version it would install" },
+        ],
+        effect: "write",
+        output: updateSchema,
+        plan: async (_input, ctx) => {
+            const npm = npmContext(cli, install, ctx);
+            const copy = await globalInstallOf(bin, npm);
+            return {
+                package: install.package,
+                from: cli.version,
+                latest: await latestVersion(npm),
+                prefix: copy.prefix,
+                packageDir: copy.packageDir,
+            };
+        },
+        apply: async (plan, ctx) => {
+            const { from, latest, prefix } = plan;
+            if (standingOf(from, latest) !== "behind") {
+                return { from, latest, installed: null, upgrades: [], next: [] };
+            }
+            ctx.signal.throwIfAborted();
+            ctx.progress(`installing ${plan.package}@${latest} with the npm under ${prefix}…`);
+            await ctx.runToEnd(() => installGlobally(latest, npmContext(cli, install, ctx)));
+            const update = {
+                from,
+                latest,
+                installed: { version: latest, prefix },
+                upgrades: await upgradeNotes(plan.packageDir, from, latest),
+                next: [skillUpdateCommand(cli.name)],
+            };
+            if (ctx.signal.aborted) {
+                throw interruptedAfterInstall(plan, update);
+            }
+            return update;
+        },
+        render: (update) => renderUpdate(cli, install, update),
+        renderPlan: (plan) => standingOf(plan.from, plan.latest) === "behind"
+            ? `would install ${plan.package}@${plan.latest} with the npm under ${plan.prefix}, replacing ${plan.from}`
+            : nothingToInstall(plan),
+    });
+}
+//# sourceMappingURL=update.js.map

package/dist/update.js.map

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

package/dist/upgrade-notes.d.ts

@@ -0,0 +1,9 @@
+export interface UpgradeNotes {
+    readonly version: string;
+    readonly notes: string;
+}
+/**
+ * What changed in each release after `from` up to `to`, oldest first, from the CHANGELOG.md in
+ * `packageDir`; none when the package ships no CHANGELOG.
+ */
+export declare function upgradeNotes(packageDir: string, from: string, to: string): Promise<UpgradeNotes[]>;

package/dist/upgrade-notes.js

@@ -0,0 +1,41 @@
+import { readFile } from "node:fs/promises";
+import { join } from "node:path";
+import { isMissingFile } from "./errors.js";
+import { compareVersions, isVersion } from "./semver.js";
+const RELEASE_HEADING = /^## v?(\S+)/;
+function releasesIn(changelog) {
+    const releases = [];
+    let current;
+    for (const line of changelog.split(/\r?\n/)) {
+        const heading = RELEASE_HEADING.exec(line);
+        if (heading !== null) {
+            const version = heading[1] ?? "";
+            current = isVersion(version) ? { version, lines: [] } : undefined;
+            if (current !== undefined)
+                releases.push(current);
+        }
+        else {
+            current?.lines.push(line);
+        }
+    }
+    return releases.map(({ version, lines }) => ({ version, notes: lines.join("\n").trim() }));
+}
+/**
+ * What changed in each release after `from` up to `to`, oldest first, from the CHANGELOG.md in
+ * `packageDir`; none when the package ships no CHANGELOG.
+ */
+export async function upgradeNotes(packageDir, from, to) {
+    let changelog;
+    try {
+        changelog = await readFile(join(packageDir, "CHANGELOG.md"), "utf8");
+    }
+    catch (error) {
+        if (isMissingFile(error))
+            return [];
+        throw error;
+    }
+    return releasesIn(changelog)
+        .filter(({ version }) => compareVersions(version, from) > 0 && compareVersions(version, to) <= 0)
+        .sort((a, b) => compareVersions(a.version, b.version));
+}
+//# sourceMappingURL=upgrade-notes.js.map

package/dist/upgrade-notes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"upgrade-notes.js","sourceRoot":"","sources":["../src/upgrade-notes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAOzD,MAAM,eAAe,GAAG,aAAa,CAAC;AAEtC,SAAS,UAAU,CAAC,SAAiB;IACnC,MAAM,QAAQ,GAA2C,EAAE,CAAC;IAC5D,IAAI,OAAyD,CAAC;IAC9D,KAAK,MAAM,IAAI,IAAI,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;QAC5C,MAAM,OAAO,GAAG,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC3C,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;YACrB,MAAM,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YACjC,OAAO,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;YAClE,IAAI,OAAO,KAAK,SAAS;gBAAE,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACpD,CAAC;aAAM,CAAC;YACN,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC;IACD,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC;AAC7F,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,UAAkB,EAClB,IAAY,EACZ,EAAU;IAEV,IAAI,SAAiB,CAAC;IACtB,IAAI,CAAC;QACH,SAAS,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,UAAU,EAAE,cAAc,CAAC,EAAE,MAAM,CAAC,CAAC;IACvE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,aAAa,CAAC,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QACpC,MAAM,KAAK,CAAC;IACd,CAAC;IACD,OAAO,UAAU,CAAC,SAAS,CAAC;SACzB,MAAM,CACL,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,eAAe,CAAC,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,eAAe,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,CACzF;SACA,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;AAC3D,CAAC"}

package/dist/usage.d.ts

@@ -0,0 +1,13 @@
+import type { Command as Commander, CommanderError } from "commander";
+import { UsageError } from "./errors.js";
+import { type Invocation } from "./invocation.js";
+export declare function commandLine(cmd: Commander): string;
+/** Commander stopped parsing at `command`: help, version or a usage error. */
+export declare class ParseStop extends Error {
+    readonly reason: CommanderError;
+    readonly command: Commander;
+    constructor(reason: CommanderError, command: Commander);
+}
+export declare function stopAt(cmd: Commander): Commander;
+export declare function unknownOptionError(line: string, invocation: Invocation, flag: string, suggestions: readonly string[]): UsageError;
+export declare function usageErrorOf({ reason, command }: ParseStop, invocation: Invocation): UsageError;

package/dist/usage.js

@@ -0,0 +1,72 @@
+import { UsageError } from "./errors.js";
+import { commandLineRenaming } from "./invocation.js";
+export function commandLine(cmd) {
+    return cmd.parent === null ? cmd.name() : `${commandLine(cmd.parent)} ${cmd.name()}`;
+}
+/** Commander stopped parsing at `command`: help, version or a usage error. */
+export class ParseStop extends Error {
+    reason;
+    command;
+    constructor(reason, command) {
+        super(reason.message);
+        this.name = "ParseStop";
+        this.reason = reason;
+        this.command = command;
+    }
+}
+// Commander's error carries no reference to the command that raised it, so each command throws
+// its own ParseStop. Must be called after `.command()` creates `cmd`, which copies the parent's.
+export function stopAt(cmd) {
+    return cmd.exitOverride((reason) => {
+        throw new ParseStop(reason, cmd);
+    });
+}
+function problemOf(reason) {
+    return (reason.message.split("\n")[0] ?? "").replace(/^error: /, "");
+}
+// Commander appends "(Did you mean X?)" or "(Did you mean one of X, Y?)" to unknown names.
+function suggestionsOf(reason) {
+    const match = /\(Did you mean (?:one of )?(.+)\?\)/.exec(reason.message);
+    return match?.[1] === undefined ? [] : match[1].split(", ");
+}
+function unknownError({ code, problem, line, corrections, listed }) {
+    return new UsageError({
+        code,
+        message: `${problem} for \`${line}\``,
+        hint: corrections.length === 0
+            ? `run \`${line} --help\` to see the ${listed}`
+            : `did you mean ${corrections.map((correction) => `\`${correction}\``).join(" or ")}?`,
+    });
+}
+export function unknownOptionError(line, invocation, flag, suggestions) {
+    return unknownError({
+        code: "UNKNOWN_OPTION",
+        problem: `unknown option '${flag}'`,
+        line,
+        corrections: suggestions.map((name) => commandLineRenaming(invocation, new Map([[flag, name]]))),
+        listed: "options",
+    });
+}
+export function usageErrorOf({ reason, command }, invocation) {
+    const line = commandLine(command);
+    const suggestions = suggestionsOf(reason);
+    switch (reason.code) {
+        case "commander.unknownCommand":
+            return unknownError({
+                code: "UNKNOWN_COMMAND",
+                problem: problemOf(reason),
+                line,
+                corrections: suggestions.map((name) => `${line} ${name}`),
+                listed: "commands",
+            });
+        case "commander.unknownOption":
+            return unknownOptionError(line, invocation, /'(.+)'/.exec(problemOf(reason))?.[1] ?? "", suggestions);
+        default:
+            return new UsageError({
+                code: "INVALID_INPUT",
+                message: problemOf(reason),
+                hint: `run \`${line} --help\` to see the expected input`,
+            });
+    }
+}
+//# sourceMappingURL=usage.js.map

package/dist/usage.js.map

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

package/package.json

@@ -1,6 +1,35 @@
 {
   "name": "@duyquangnvx/agent-cli",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0",
+  "description": "Runtime for agent-first command-line tools: owns parsing, output, errors and exit codes.",
+  "type": "module",
+  "engines": {
+    "node": ">=22.12.0"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "CHANGELOG.md"
+  ],
+  "dependencies": {
+    "commander": "15.0.0"
+  },
+  "peerDependencies": {
+    "zod": "^4.6.0"
+  },
+  "devDependencies": {
+    "zod": "4.6.7"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/",
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json"
+  }
 }

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.