@artblocks/abx-cli 0.1.0-alpha.0 → 0.1.0-alpha.1

package/dist/flags.d.ts

@@ -12,6 +12,12 @@
 export type Flags = Record<string, string | undefined>;
 /** Flags where every occurrence counts (values comma-join, in argv order). */
 export declare const REPEATABLE_FLAGS: ReadonlySet<string>;
+/**
+ * Flags valid on ANY command (handled centrally in main, not by a command handler), so
+ * {@link unknownFlags} never flags them as unrecognized regardless of the per-command allowlist.
+ * `no-update-check` opts out of the startup update nudge (see update-check.ts).
+ */
+export declare const GLOBAL_FLAGS: ReadonlySet<string>;
 export declare function parseFlags(args: string[]): Flags;
 /**
  * The flag keys in `flags` that are NOT in `allowed` — for a non-fatal "unrecognized flag"

package/dist/flags.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"flags.d.ts","sourceRoot":"","sources":["../src/flags.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,MAAM,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;AAEvD,8EAA8E;AAC9E,eAAO,MAAM,gBAAgB,EAAE,WAAW,CAAC,MAAM,CAA8B,CAAC;AAEhF,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,KAAK,CAchD;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,MAAM,EAAE,CAG9E"}
+{"version":3,"file":"flags.d.ts","sourceRoot":"","sources":["../src/flags.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,MAAM,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;AAEvD,8EAA8E;AAC9E,eAAO,MAAM,gBAAgB,EAAE,WAAW,CAAC,MAAM,CAA8B,CAAC;AAEhF;;;;GAIG;AACH,eAAO,MAAM,YAAY,EAAE,WAAW,CAAC,MAAM,CAAgC,CAAC;AAE9E,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,KAAK,CAchD;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,MAAM,EAAE,CAG9E"}

package/dist/flags.js

@@ -1,5 +1,11 @@
 /** Flags where every occurrence counts (values comma-join, in argv order). */
 export const REPEATABLE_FLAGS = new Set(['dep', 'schema']);
+/**
+ * Flags valid on ANY command (handled centrally in main, not by a command handler), so
+ * {@link unknownFlags} never flags them as unrecognized regardless of the per-command allowlist.
+ * `no-update-check` opts out of the startup update nudge (see update-check.ts).
+ */
+export const GLOBAL_FLAGS = new Set(['no-update-check']);
 export function parseFlags(args) {
     const out = {};
     const set = (k, v) => {
@@ -29,6 +35,6 @@ export function parseFlags(args) {
  */
 export function unknownFlags(flags, allowed) {
     const ok = new Set(allowed);
-    return Object.keys(flags).filter((k) => !ok.has(k));
+    return Object.keys(flags).filter((k) => !ok.has(k) && !GLOBAL_FLAGS.has(k));
 }
 //# sourceMappingURL=flags.js.map

package/dist/flags.js.map

@@ -1 +1 @@
-{"version":3,"file":"flags.js","sourceRoot":"","sources":["../src/flags.ts"],"names":[],"mappings":"AAaA,8EAA8E;AAC9E,MAAM,CAAC,MAAM,gBAAgB,GAAwB,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC;AAEhF,MAAM,UAAU,UAAU,CAAC,IAAc;IACvC,MAAM,GAAG,GAAU,EAAE,CAAC;IACtB,MAAM,GAAG,GAAG,CAAC,CAAS,EAAE,CAAS,EAAE,EAAE;QACnC,GAAG,CAAC,CAAC,CAAC,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAClF,CAAC,CAAC;IACF,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC;YAAE,SAAS;QAClC,MAAM,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAC1B,IAAI,EAAE,KAAK,CAAC,CAAC;YAAE,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;aAC/C,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC;YAAE,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;;YAC7E,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IAC/B,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,YAAY,CAAC,KAAY,EAAE,OAAyB;IAClE,MAAM,EAAE,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC;IAC5B,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;AACtD,CAAC"}
+{"version":3,"file":"flags.js","sourceRoot":"","sources":["../src/flags.ts"],"names":[],"mappings":"AAaA,8EAA8E;AAC9E,MAAM,CAAC,MAAM,gBAAgB,GAAwB,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC;AAEhF;;;;GAIG;AACH,MAAM,CAAC,MAAM,YAAY,GAAwB,IAAI,GAAG,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC;AAE9E,MAAM,UAAU,UAAU,CAAC,IAAc;IACvC,MAAM,GAAG,GAAU,EAAE,CAAC;IACtB,MAAM,GAAG,GAAG,CAAC,CAAS,EAAE,CAAS,EAAE,EAAE;QACnC,GAAG,CAAC,CAAC,CAAC,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAClF,CAAC,CAAC;IACF,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC;YAAE,SAAS;QAClC,MAAM,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAC1B,IAAI,EAAE,KAAK,CAAC,CAAC;YAAE,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;aAC/C,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC;YAAE,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;;YAC7E,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IAC/B,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,YAAY,CAAC,KAAY,EAAE,OAAyB;IAClE,MAAM,EAAE,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC;IAC5B,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;AAC9E,CAAC"}

package/dist/main.js

@@ -54,6 +54,7 @@ import { DEP_RESOLUTION, deploySeedSource, deploySeriesCodeFactory, prepareCodeS
 import { checkRegistryDeps, dependencySetupCalls, parseDepFlag, resolveDepRegistryPointer } from './deps.js';
 import { composeParamsKeys, expectedChainComplete, hasOnChainUriLane, onchainUriSetupCalls, onChainUriReport } from './onchain-uri.js';
 import { parseFlags, unknownFlags } from './flags.js';
+import { checkForCliUpdate, compareVersions, installedSkillVersions, readCliVersion, SKILL_VERSION_MARKER } from './update-check.js';
 import { analyzeScript, recommendLane } from './inspect.js';
 import { parseSchemaSpecs, describeSchema } from './schema.js';
 import { parseSeriesTraits, looksPerTokenAttributes, parseSeriesTraitsById } from './series-traits.js';
@@ -110,10 +111,49 @@ const step = (s) => console.log(`\n${p(`[${++stepN}]`)} ${bold(s)}`);
 const ok = (s) => console.log(`    ${g('✓')} ${s}`);
 const info = (s) => console.log(`    ${dim(s)}`);
 const warn = (s) => console.log(`    ${c.orange}⚠${c.reset}  ${s}`);
+/**
+ * Notify-only update nudge. Prints an upgrade one-liner to STDERR (never stdout — an agent may be
+ * parsing that) when a newer @artblocks/abx-cli is published, plus a nudge when a locally-installed
+ * skill has drifted behind the running CLI. Fully suppressed by CI / ABX_NO_UPDATE_CHECK /
+ * --no-update-check, and wrapped so it can NEVER break a command (all failures are swallowed).
+ */
+async function maybeNotifyUpdate(flags) {
+    try {
+        if (flags['no-update-check'] !== undefined || process.env.ABX_NO_UPDATE_CHECK || process.env.CI)
+            return;
+        const current = readCliVersion();
+        // Skill drift (cheap, offline): the skill and CLI are co-versioned, but a separately-installed
+        // skill copy doesn't move when the CLI upgrades. Nudge a reinstall when the CLI is ahead.
+        for (const v of installedSkillVersions()) {
+            if (compareVersions(current, v) > 0) {
+                console.error(`    ${c.orange}⚠${c.reset}  installed abx skill is v${v} but the CLI is v${current} — refresh it: ${g('abx skill install')}`);
+                break;
+            }
+        }
+        const latest = await checkForCliUpdate(current);
+        if (latest) {
+            console.error(`\n    ${c.orange}⚠${c.reset}  update available: ${bold('abx')} ${dim(current)} → ${g(latest)}\n` +
+                `       upgrade: ${g('npm i -g @artblocks/abx-cli@latest')} ${dim('· or invoke:')} ${g('npx abx@latest <command>')}\n` +
+                `       release notes: https://github.com/ArtBlocks/abx/releases ${dim('· silence: ABX_NO_UPDATE_CHECK=1')}\n`);
+        }
+    }
+    catch {
+        /* an update check must never break a command */
+    }
+}
 async function main() {
     loadDotEnv();
     const [cmd, ...rest] = process.argv.slice(2);
     const flags = parseFlags(rest);
+    // `version` / --version / -v is a crisp query — print and exit, no update nag around it.
+    if (cmd === 'version' || cmd === '--version' || cmd === '-v') {
+        console.log(readCliVersion());
+        return;
+    }
+    // Notify-only "you're behind" nudge (cached, opt-out, stderr — see update-check.ts). Awaited so
+    // the notice lands before command output, but it hits the network at most once a day and never
+    // throws, so it can't break or meaningfully slow a command. Skipped for the pure help path below.
+    await maybeNotifyUpdate(flags);
     // SAFETY: --help / -h on ANY command is read-only — print usage, never execute.
     // (A write command must never deploy/mint/spend just because someone asked for help.)
     if (cmd && cmd !== 'help' && (flags.help !== undefined || rest.includes('-h'))) {
@@ -4980,8 +5020,10 @@ function help() {
     ${g('abx status')}              list indexed projects + node info
     ${g('abx doctor')}              check environment (key, RPC, balance, factory, storage)
     ${g('abx skill install')}       install the abx agent skill into your agent   [--global] [--target <dir>]  ·  ${g('abx skill path')} prints the bundled skill
+    ${g('abx version')}             print the installed CLI version
 
   ${dim('Run')} ${g('abx <command> --help')} ${dim('for per-command usage. --help / -h never executes — it only prints usage.')}
+  ${dim('abx checks npm for a newer release (once a day, notify-only). Silence with')} ${g('ABX_NO_UPDATE_CHECK=1')} ${dim('or')} ${g('--no-update-check')}${dim('.')}
 `);
 }
 /** Validate an explicit --salt (a 32-byte hex). Undefined when absent. */
@@ -5081,6 +5123,14 @@ async function cmdSkill(rest, flags) {
         const dest = joinPath(destParent, 'abx-self-host');
         mkdirSync(destParent, { recursive: true });
         cpSync(src, dest, { recursive: true });
+        // Stamp the CLI version so a later run can notice the skill has drifted behind an upgraded CLI
+        // (the two are co-versioned). Best-effort — a missing marker just means "no drift nudge".
+        try {
+            writeFileSync(joinPath(dest, SKILL_VERSION_MARKER), readCliVersion());
+        }
+        catch {
+            /* non-fatal */
+        }
         ok(`installed the abx skill → ${dest}`);
         info('restart your agent (Claude Code / Cursor) so it loads the skill, then ask it to launch an NFT with abx.');
         info('cross-agent alternative (git-based): npx skills add ArtBlocks/abx');