@artblocks/abx-cli 0.1.0-alpha.2 → 0.1.0-alpha.20

package/dist/commands/scaffold.js

@@ -0,0 +1,544 @@
+/**
+ * Scaffolding + environment commands: `doctor` (check key/RPC/balance/factory/storage — and offer
+ * to install/resync the agent skill), `mint-page` (a self-contained Next.js minting app),
+ * `scaffold-renderer` (copy the Solidity on-chain-renderer starting point), and `skill` (install
+ * the version-locked abx agent skill into a coding agent).
+ */
+import { cpSync, existsSync, mkdirSync, readdirSync, rmSync, writeFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { basename, join as joinPath, resolve as resolvePath } from 'node:path';
+import { createInterface } from 'node:readline';
+import { fileURLToPath } from 'node:url';
+import { isCurrentFactory, isCurrentOneOfOneEditionFactory, makePublicClient, makeWalletClient, oneOfOneImageAbi, probeRpcEndpoints, resolveChain, } from '@artblocks/abx-sdk';
+import { arweaveAddress, probeStorageBackend, resolveBackend } from '@artblocks/abx-storage';
+import { formatEther } from 'viem';
+import { CHAIN, activeBackendId, arweaveKeyFilePath, factoryAddress, faucetHint, fixedPriceMinterAddress, fixedPriceMinter1155Address, oneOfOneEditionFactoryAddress, loadArweaveJwk, storageOptions, } from '../config.js';
+import { CliError } from '../errors.js';
+import { detectTokenKind } from '../kind.js';
+import { PUBLIC_RPC, mintPageArtifact } from '../mintpage.js';
+import { bold, c, dim, findRepoRoot, g, info, ok, step, warn } from '../output.js';
+import { declinesSkillInstall } from '../prompt.js';
+import { listConfiguredRemotes, misnamedRemoteVars, selfTokenMigrationWarning } from '../remote.js';
+import { copyRendererScaffold } from '../scaffold.js';
+import { AGENT_SKILL_PARENTS, SKILL_DIR_NAME, binaryProvenance, checkForCliUpdate, compareVersions, installedSkillVersions, readCliVersion, readSkillVersion, } from '../update-check.js';
+// ── doctor ────────────────────────────────────────────────────────────────--
+/**
+ * Doctor's "want me to fix that?" for a missing or stale skill. Three lanes, deliberately:
+ *   `--fix`      install without asking (CI, scripts, an agent running doctor for someone)
+ *   interactive  name the exact directories, then ask — Enter accepts, since doctor's whole job is
+ *                getting setup right and this is the one check whose fix is a local file copy
+ *   non-TTY      change NOTHING and print how to do it; a diagnostic must never mutate a
+ *                scripted environment just because nobody was there to say no
+ * Honors `--global` / `--agent` so the fix can target the same place an explicit install would.
+ */
+export async function offerSkillInstall(flags, stale, indent) {
+    const opts = { global: flags.global !== undefined, agent: flags.agent };
+    const src = resolveBundledSkill();
+    if (!src)
+        return; // no bundled skill to install (dev checkout oddity) — the hint above still stands
+    const verb = stale ? 'resync' : 'install';
+    const dests = defaultSkillDests(opts);
+    if (flags.fix === undefined) {
+        if (!process.stdin.isTTY) {
+            console.log(`${indent}${dim(`non-interactive — run \`abx doctor --fix\` (or \`abx skill install\`) to ${verb} it.`)}`);
+            return;
+        }
+        const rl = createInterface({ input: process.stdin, output: process.stdout });
+        const answer = await new Promise((resolve) => {
+            // EOF (Ctrl-D) closes the interface WITHOUT firing the question callback — awaiting only the
+            // callback would hang doctor forever. Treat a closed stream as a decline: the safe direction is
+            // always "change nothing", never "write files because nobody answered".
+            rl.once('close', () => resolve('n'));
+            rl.question(`${indent}${verb} the abx skill into ${bold(dests)} now? [Y/n] `, resolve);
+        });
+        rl.close();
+        if (declinesSkillInstall(answer)) {
+            console.log(`${indent}${dim(`skipped — \`abx skill install\` when you want it.`)}`);
+            return;
+        }
+    }
+    console.log('');
+    installSkillToDefaults(src, opts);
+}
+export async function cmdDoctor(flags) {
+    console.log(bold('\n  abx doctor') + dim(`  ·  ${CHAIN}`) + '\n');
+    // Two visual tiers: PASS/FAIL checks (✓/✗) for things that are either working or broken, and an
+    // "Optional" block (·) for path-dependent setup that is fine to be unset. We deliberately do NOT
+    // use ⚠ for "unset but often fine" — that read as noise; ⚠ is reserved for a real gotcha (a
+    // range-capped RPC). Labels are padded so both tiers align.
+    const CONT = ' '.repeat(17); // continuation indent: aligns under a check/opt detail column
+    const check = (label, pass, detail = '') => console.log(`  ${pass ? g('✓') : `${c.red}✗${c.reset}`} ${label.padEnd(13)}${detail ? dim(detail) : ''}`);
+    const opt = (label, detail) => console.log(`  ${dim('·')} ${label.padEnd(13)}${dim(detail)}`);
+    const hasKey = !!process.env.ABX_DEPLOYER_PK;
+    // 1. Agent skill — FIRST and prominent. The primary way to use abx is to let a coding agent drive
+    //    it, so a missing/stale skill is a ✗: not broken infra, but the main UX isn't set up. Its
+    //    version lives in SKILL.md frontmatter (version-locked to this CLI). Notify-only — no exit code.
+    const cliVersion = readCliVersion();
+    const skillVersions = installedSkillVersions();
+    const staleSkills = skillVersions.filter((v) => compareVersions(cliVersion, v) > 0);
+    const skillMissing = skillVersions.length === 0;
+    const skillStale = !skillMissing && staleSkills.length > 0;
+    if (skillMissing) {
+        check('agent skill', false, `not installed — run ${g('abx skill install')}`);
+        console.log(`${CONT}${dim('(recommended: let a coding agent drive abx)')}`);
+    }
+    else if (skillStale) {
+        check('agent skill', false, `v${staleSkills.join(', v')} behind CLI v${cliVersion} — run ${g('abx skill install')}`);
+    }
+    else {
+        check('agent skill', true, `in sync (v${cliVersion})`);
+    }
+    // Offer to fix it here rather than only naming the command. `npm i -g` + `abx skill install` was a
+    // two-step install flow where the second step is easy to skip and invisible when skipped (an agent
+    // that never learned abx just... doesn't use it). Doctor is already the documented first run, so
+    // this collapses the flow without an npm `postinstall` hook — which could not work anyway: npm runs
+    // lifecycle scripts with cwd set to the installed package dir (so the skill would land inside
+    // node_modules), pnpm gates install scripts by default, and writing to a user's ~/.claude on
+    // install is the kind of side effect that belongs to the user, not to us.
+    if (skillMissing || skillStale) {
+        await offerSkillInstall(flags, skillStale, CONT);
+    }
+    console.log('');
+    // 2. Core environment (✓/✗). Signing-wallet balances are computed here (they need the RPC) but
+    //    printed in the Optional block below, so buffer them.
+    let signingOpt = null;
+    let minter1155Opt = null;
+    let forOpt = null;
+    try {
+        const publicClient = makePublicClient({ chainKey: CHAIN });
+        const bn = await publicClient.getBlockNumber();
+        // Collapse the RPC report to one line (best endpoint + head), and only add a ⚠ when there is a
+        // genuine problem — a range-capped-only set that will grind a resolver under load.
+        const probes = await probeRpcEndpoints({ chainKey: CHAIN });
+        const usable = probes.filter((pr) => pr.verdict !== 'unusable');
+        const best = probes.find((pr) => pr.verdict === 'best') ?? usable[0];
+        if (usable.length > 0) {
+            check('RPC', true, `${best.label} · head ${bn} · ${best.verdict === 'best' ? 'wide range + archive' : 'range-capped'}`);
+            if (!probes.some((pr) => pr.verdict === 'best')) {
+                console.log(`${CONT}${c.orange}⚠${c.reset}${dim(' every endpoint is getLogs-range-capped — add a wide-range archive RPC to ABX_RPC_URLS before running a resolver under load')}`);
+            }
+        }
+        else {
+            check('RPC', false, `${CHAIN} — no endpoint usable for reconstruction; add a wide-range archive RPC to ABX_RPC_URLS`);
+        }
+        const factory = factoryAddress();
+        if (factory) {
+            const code = await publicClient.getCode({ address: factory });
+            if (!code || code === '0x')
+                check('factory', false, `${factory} — no code on ${CHAIN}; \`abx deploy\` redeploys`);
+            else if (await isCurrentFactory(publicClient, factory))
+                check('factory', true, factory);
+            else
+                check('factory', false, `${factory} — older/incompatible; \`abx deploy\` redeploys`);
+        }
+        else {
+            check('factory', false, 'none yet — `abx demo` deploys one');
+        }
+        // The edition twin — same shape as the 721 `factory` check above (isCurrent* probe, same
+        // pass/fail posture on "no code yet"). The other two edition factories (EditionImage/
+        // EditionCode) and the two edition-related singletons that have no analogous check today
+        // either (the 1155 minter, and — same as the 721 minter — no code-version probe to run) are
+        // left to their own commands' own bootstrap (`abx deploy-series --copies` / `deploy-code
+        // --copies` / `minter configure --token-id`) rather than duplicating a fourth/fifth check here.
+        const editionFactory = oneOfOneEditionFactoryAddress();
+        if (editionFactory) {
+            const code = await publicClient.getCode({ address: editionFactory });
+            if (!code || code === '0x')
+                check('edition factory', false, `${editionFactory} — no code on ${CHAIN}; \`abx deploy --copies <n|open>\` redeploys`);
+            else if (await isCurrentOneOfOneEditionFactory(publicClient, editionFactory))
+                check('edition factory', true, editionFactory);
+            else
+                check('edition factory', false, `${editionFactory} — older/incompatible; \`abx deploy --copies <n|open>\` redeploys`);
+        }
+        else {
+            check('edition factory', false, 'none yet — `abx deploy --copies <n|open>` deploys one');
+        }
+        // The shared edition sale singleton — Optional, not pass/fail: unlike the factory (a platform
+        // allowlist anchor), a project that never sells through the shared minter has no reason to have
+        // one deployed yet (same reason there is no equivalent 721 `fixedPriceMinter` check above).
+        const minter1155 = fixedPriceMinter1155Address();
+        if (minter1155) {
+            const code = await publicClient.getCode({ address: minter1155 });
+            minter1155Opt = code && code !== '0x' ? minter1155 : `${minter1155} configured but no code on ${CHAIN} — \`abx minter configure <addr> --token-id <n> …\` redeploys`;
+        }
+        if (hasKey) {
+            const { account } = makeWalletClient({ chainKey: CHAIN });
+            const bal = await publicClient.getBalance({ address: account.address });
+            signingOpt = `env key ${account.address} · ${bal > 0n ? `funded ${formatEther(bal)} ETH` : `empty — fund it (${faucetHint(CHAIN)})`}`;
+        }
+        if (flags.for) {
+            const bal = await publicClient.getBalance({ address: flags.for });
+            forOpt = `${flags.for} · ${bal > 0n ? `funded ${formatEther(bal)} ETH` : `empty — ${faucetHint(CHAIN)}`}`;
+        }
+    }
+    catch (err) {
+        check('RPC', false, err.message);
+    }
+    // storage backend — resolve it (catches missing config), then probe liveness/creds. B4: the probe
+    // is the fuller `probeStorageBackend` (packages/storage/probe.ts), not a bare `.health()` call —
+    // for fs/ipfs that's the SAME check as before (reused, not reimplemented); for cloud it's now a
+    // real PUT (API) + GET (public base) round trip — the only thing that catches the R2/S3
+    // endpoint-vs-public-base trap `.health()` alone couldn't; arweave adds an identity+balance READ
+    // (never a paid upload). Kept fast on purpose: only runs once a backend actually resolves, bounded
+    // to 1.5s — the same budget `checkForCliUpdate` below uses for its own network check.
+    const backendId = activeBackendId();
+    try {
+        const backend = resolveBackend(storageOptions());
+        const h = await probeStorageBackend(storageOptions(), { timeoutMs: 1500 });
+        // Whether this backend can name a public URL for what it stores decides one thing operators hit
+        // later: a REMOTE effects runner needs it (the resolver serves referenced output by redirect, so
+        // it takes a URL and refuses bytes). Co-located rendering doesn't care — hence a note, not a fail.
+        const publishable = backend.locator
+            ? 'can publish to a remote resolver'
+            : 'local-only — a remote effects runner needs cloud/ipfs/arweave (co-located rendering is fine)';
+        check('storage', h.ok, `${backend.id} · ${h.detail} · ${publishable}`);
+        // On failure, name BOTH URLs the cloud check touched — the R2/S3 endpoint-vs-public-base trap is
+        // only diagnosable with both hosts on screen, not a bare "fetch failed".
+        if (!h.ok && (h.putUrl || h.publicUrl)) {
+            console.log(`${CONT}${dim(`put ${h.putUrl ?? '(none)'}  ·  get ${h.publicUrl ?? '(none)'}`)}`);
+        }
+    }
+    catch (err) {
+        check('storage', false, `${backendId} · ${err.message}`);
+    }
+    // 2b. Version & provenance — the 3-class drift ladder the skill has long taught in prose
+    //     ("Resolve the CLI before you install anything"), now checked instead of just explained.
+    //     `checkForCliUpdate` is already bounded to a ~1.5s network timeout + a 6h disk cache (see
+    //     update-check.ts), so this never adds a meaningful wait — same budget the RPC probe above uses.
+    console.log(`\n  ${dim('Version & provenance:')}`);
+    const provenance = binaryProvenance();
+    if (provenance === 'npx') {
+        check('binary', false, 'running via npx — can silently keep serving a stale cached copy after an upgrade');
+        console.log(`${CONT}${dim('install instead: `npm install --save-dev @artblocks/abx-cli` (project-local) or `-g` (machine-wide)')}`);
+    }
+    else {
+        check('binary', true, provenance === 'source' ? 'source checkout (pnpm abx)' : 'npm install');
+    }
+    const latest = await checkForCliUpdate(cliVersion);
+    if (latest)
+        check('npm', false, `v${cliVersion} → v${latest} available — npm i -g @artblocks/abx-cli@latest`);
+    else
+        check('npm', true, `v${cliVersion} (or offline — checked at most every 6h)`);
+    if (skillMissing)
+        check('skill ver', false, 'no installed skill to compare — abx skill install');
+    else if (skillStale)
+        check('skill ver', false, `v${staleSkills.join(', v')} behind CLI v${cliVersion} — abx skill install`);
+    else
+        check('skill ver', true, `v${cliVersion} matches the CLI`);
+    // 3. Optional — path-dependent setup. Unset is fine; these say WHEN you'll need each, so an unset
+    //    value never reads as a warning.
+    console.log(`\n  ${dim('Optional — depends how you deploy:')}`);
+    if (signingOpt)
+        opt('signing', signingOpt);
+    else
+        opt('signing', 'no env key → sign in your browser wallet (--sign). Preflight yours: `abx doctor --for 0x<addr>`. Set ABX_DEPLOYER_PK for the unattended hot lane.');
+    if (forOpt)
+        opt('wallet --for', forOpt);
+    const baseUrl = process.env.ABX_PUBLIC_BASE_URL;
+    if (baseUrl)
+        opt('resolver URL', baseUrl);
+    else
+        opt('resolver URL', 'ABX_PUBLIC_BASE_URL unset → needed for off-chain/resolver-served deploys; skip if fully on-chain (--onchain-image / --onchain-uri).');
+    if (minter1155Opt)
+        opt('1155 minter', minter1155Opt);
+    else
+        opt('1155 minter', 'none yet — `abx minter configure <addr> --token-id <n> …` on an edition deploys one');
+    if (!process.env.ARWEAVE_JWK && existsSync(arweaveKeyFilePath())) {
+        const jwk = loadArweaveJwk();
+        opt('arweave key', `${jwk ? arweaveAddress(jwk) + ' ' : ''}holds upload credits — back it up: \`abx storage backup-key --out <path>\``);
+    }
+    // Named remotes: report what's configured, and — the part doctor was missing — flag a credential
+    // stored under a name the CLI does NOT read. That fault presents as "it acts like I never gave it a
+    // key", and until now it only surfaced from `abx remote <name>`, which a creator reaches later
+    // (doctor is the thing they're told to run FIRST).
+    const remotes = listConfiguredRemotes();
+    if (remotes.length) {
+        opt('remotes', remotes.map((r) => `${r.name.toLowerCase()}${r.hasToken ? '' : ` ${c.orange}(no token)${c.reset}`}`).join(' · '));
+    }
+    for (const bad of misnamedRemoteVars()) {
+        check('remote key', false, `${bad.key} is set but is NOT read — the convention is ${bold(bad.suggestion)} (only _URL and _TOKEN). Rename it.`);
+    }
+    // The self-host default's credential moved to the named-remote grammar (ABX_REMOTE_SELF_TOKEN) —
+    // the OLD var is never read now, so flag it here rather than let a creator discover it as a 401
+    // that reads like a wrong key. Same condition `requireRemoteToken` hard-stops a real command on.
+    const selfTokenMigration = selfTokenMigrationWarning();
+    if (selfTokenMigration)
+        check('self token', false, selfTokenMigration);
+    console.log('');
+}
+// ── mint-page — scaffold a Next.js mint site for a collection (fixed-price minter) ─────────────
+/**
+ * Refuse a mint-page target with NO minter lane. The generated page reads
+ * `maxInvocations`/`paused` (or, for an edition, the per-id `totalSupply`/`maxSupply`) and mints
+ * through a shared fixed-price minter — none of which a plain 1/1 (`OneOfOneImage`) has, since it
+ * has no minter lane at all. Before this check, pointing `mint-page` at a 1/1 wrote a page that
+ * compiled and ran fine, then sat on "Loading…" forever with no diagnostic.
+ *
+ * `kind` is the caller's `detectTokenKind` result — every kind EXCEPT `1of1` composes a minter lane
+ * (Series/SeriesCode via `AbxFixedPriceMinter`; the three edition twins via its 1155 sibling — see
+ * the parity plan's "deliberate asymmetry" note on why even `OneOfOneEdition`, unlike its 721
+ * namesake, ships the sale stack). `undefined` means the probe itself couldn't run (RPC unreachable,
+ * address has no code, etc.) — that must NOT refuse: offline/best-effort scaffolding is allowed,
+ * same as the `name()` read a few lines above this call.
+ */
+export function assertMintableSeries(token, kind) {
+    if (kind?.kind === '1of1') {
+        throw new CliError(`${token} looks like a 1/1 (OneOfOneImage) — mint-page sells through a shared fixed-price minter, which needs a Series/EditionImage/EditionCode contract (or an edition of one artwork); a plain 1/1 has no minter lane.\n` +
+            `  Deploy a Series instead: abx deploy-series --dir <folder> --count 1\n` +
+            `  …or copies of one artwork: abx deploy --copies <n|open>`);
+    }
+}
+export async function cmdMintPage(address, flags) {
+    const usage = 'abx mint-page <token> [--dir mint-page] [--name "…"] [--rpc <public-url>] [--minter-contract 0x..]';
+    const token = address;
+    if (!token || !token.startsWith('0x')) {
+        console.error(`usage: ${usage}\n`);
+        process.exitCode = 1;
+        return;
+    }
+    const publicClient = makePublicClient({ chainKey: CHAIN });
+    // Kind decides which shared minter (721 `AbxFixedPriceMinter` vs its 1155 `…1155` sibling) and
+    // which purchase shape (one project-wide sale vs a per-`(token,id)` sale with a quantity) the
+    // generated page needs. A probe failure (RPC unreachable, no code at the address) is left
+    // `undefined` and does NOT refuse — matches the best-effort name() read below.
+    let kind;
+    try {
+        kind = await detectTokenKind(publicClient, token);
+    }
+    catch {
+        warn(`could not confirm ${token}'s kind (RPC unreachable?) — continuing without the check.`);
+    }
+    assertMintableSeries(token, kind);
+    const isEdition = !!kind?.isEdition;
+    const minter = isEdition ? fixedPriceMinter1155Address(flags['minter-contract']) : fixedPriceMinterAddress(flags['minter-contract']);
+    if (!minter) {
+        throw new Error(`no shared ${isEdition ? 'edition ' : ''}fixed-price minter known for ${CHAIN} — run ` +
+            `\`abx minter configure ${token}${isEdition ? ' --token-id <n>' : ''} …\` first (it deploys + records one), ` +
+            `or set ${isEdition ? 'ABX_FIXED_PRICE_MINTER_1155' : 'ABX_FIXED_PRICE_MINTER'}.`);
+    }
+    const chain = resolveChain(CHAIN);
+    const rpcUrl = flags.rpc && flags.rpc !== 'true' ? flags.rpc : PUBLIC_RPC[chain.id];
+    if (!rpcUrl) {
+        throw new Error(`no public RPC known for ${CHAIN} (chainId ${chain.id}) — pass --rpc <public-keyless-url> (it is embedded in the public site, so it must not contain a secret key).`);
+    }
+    // Default the display name from the token's on-chain name (read-only); --name overrides.
+    let collectionName = flags.name && flags.name !== 'true' ? flags.name : '';
+    if (!collectionName) {
+        try {
+            collectionName = (await publicClient.readContract({
+                address: token,
+                abi: oneOfOneImageAbi,
+                functionName: 'name',
+            }));
+        }
+        catch {
+            collectionName = 'ABX Collection';
+        }
+    }
+    const art = mintPageArtifact({
+        token,
+        minter,
+        chainId: chain.id,
+        chainName: chain.name,
+        rpcUrl,
+        collectionName,
+        explorer: chain.blockExplorers?.default?.url,
+        isEdition,
+    });
+    const dir = flags.dir && flags.dir !== 'true' ? flags.dir : 'mint-page';
+    const outDir = resolvePath(dir);
+    console.log(bold('\n  ABX Self-Host Toolkit — mint page'));
+    info(`collection ${bold(collectionName)}  ${dim(token)}${isEdition ? dim(`  · ${kind.label} (edition)`) : ''}`);
+    info(`minter ${minter}  ${dim('· ' + chain.name + ' · reads via ' + rpcUrl)}`);
+    if (isEdition)
+        info(dim('edition purchase shape: token id + quantity, price × qty — no minted-tokens gallery in this v1 page (see the README).'));
+    step('Write the mint-page artifact (self-contained Next.js app — reads chain directly, no backend)');
+    for (const f of art.files) {
+        const dest = joinPath(outDir, f.path);
+        mkdirSync(joinPath(dest, '..'), { recursive: true });
+        writeFileSync(dest, f.content);
+        info(`wrote ${joinPath(dir, f.path)}`);
+    }
+    step(`Next steps (run from ${bold(dir)}/)`);
+    art.steps.forEach((s, i) => console.log(`    ${g(`${i + 1}.`)} ${s}`));
+    step('Customize — this is a starting point');
+    info('Plain React + one CSS file; ask the agent for a bespoke layout per drop. ETH sales + injected wallet by default;');
+    info('the README covers RainbowKit (multi-wallet), ERC-20 (add an approve step), and RPC/gallery notes.');
+    warn('The RPC in .env.local is PUBLIC (may rate-limit). Never put a secret-keyed RPC in a NEXT_PUBLIC_ var — it ships to the browser.');
+    console.log('');
+}
+// ── flags ─────────────────────────────────────────────────────────────────--
+// parseFlags + the Flags type live in flags.ts (unit-testable; repeatable flags like --dep
+// accumulate comma-joined there).
+// ── skill: install the abx agent skill into the user's coding agent ───────────────────────
+// The skill is the agentic half of the toolkit — the CLI is only useful once an agent knows how
+// to drive it. It ships bundled inside the published package (packages/cli/skill/, created at
+// prepack); in dev the same command reads the canonical copy straight from the repo. This is the
+// CANONICAL install path precisely because the bundle is version-locked to the CLI it ships inside
+// (the version lives in SKILL.md frontmatter — see update-check.ts). By default it writes to BOTH
+// `.claude/skills` (Claude Code) and the neutral `.agents/skills` (Cursor · Codex · Gemini ·
+// Copilot all read it), so one command covers the whole ecosystem; `--agent` narrows it. A separate
+// git-based channel, `npx skills add ArtBlocks/abx --skill abx-self-host`, works once the repo is public but is NOT
+// version-locked to a local CLI — prefer `abx skill install`.
+/** Locate the skill folder: the bundled copy beside the compiled CLI (published), else the
+ *  canonical repo copy (dev). Returns null if neither is present. */
+export function resolveBundledSkill() {
+    const here = fileURLToPath(import.meta.url);
+    const pkgDir = resolvePath(here, '..', '..');
+    const bundled = joinPath(pkgDir, 'skill');
+    // Running from SOURCE (`pnpm abx`, tsx on packages/cli/src/**) means we're in the repo working
+    // tree, where the canonical skill is the source of truth and `<pkg>/skill` is gitignored PREPACK
+    // OUTPUT that may be arbitrarily old. Preferring the bundle there is actively destructive: a
+    // leftover `skill/` from a months-old `npm pack` silently overwrote the canonical skill with a
+    // copy 8 versions behind (and the drift check then reported the damage as if the user had caused
+    // it). In the published layout there is no repo and no canonical copy, so the bundle is correct.
+    const fromSource = /[/\\]src[/\\][^/\\]+$/.test(here);
+    const root = findRepoRoot();
+    const canonical = root ? joinPath(root, '.claude', 'skills', 'abx-self-host') : null;
+    if (fromSource && canonical && existsSync(joinPath(canonical, 'SKILL.md')))
+        return canonical;
+    // Published layout: dist/main.js → <pkg>/skill (see scripts/bundle-skill.mjs).
+    if (existsSync(joinPath(bundled, 'SKILL.md')))
+        return bundled;
+    if (canonical && existsSync(joinPath(canonical, 'SKILL.md')))
+        return canonical;
+    return null;
+}
+/** Locate the in-chain renderer Foundry scaffold: bundled beside the CLI (published), else the
+ *  repo copy (dev). Same layout in both — it lives under the CLI package's `assets/`. */
+export function resolveRendererScaffold() {
+    const pkgDir = resolvePath(fileURLToPath(import.meta.url), '..', '..');
+    const bundled = joinPath(pkgDir, 'assets', 'renderer-scaffold');
+    if (existsSync(joinPath(bundled, 'foundry.toml')))
+        return bundled;
+    const root = findRepoRoot();
+    if (root) {
+        const canonical = joinPath(root, 'packages', 'cli', 'assets', 'renderer-scaffold');
+        if (existsSync(joinPath(canonical, 'foundry.toml')))
+            return canonical;
+    }
+    return null;
+}
+/** `abx scaffold-renderer [<dir>]` — write a ready-to-build Foundry project for the in-chain
+ *  Solidity art lane (a seed + PostParam → SVG renderer + coherent traits + tests + a deploy
+ *  script). abx doesn't compile/deploy Solidity — the creator runs forge, then hands the deployed
+ *  address to `deploy-code --image-renderer`. Mirrors how deploy-resolver scaffolds an artifact. */
+export function cmdScaffoldRenderer(rest, flags) {
+    const dir = resolvePath(rest[0] ?? 'my-renderer');
+    const src = resolveRendererScaffold();
+    if (!src) {
+        throw new Error('bundled renderer scaffold not found (expected <pkg>/assets/renderer-scaffold). Reinstall @artblocks/abx-cli.');
+    }
+    if (existsSync(dir) && readdirSync(dir).length > 0 && flags.force === undefined) {
+        throw new Error(`${dir} already exists and is not empty — pass a fresh path, or --force to write into it.`);
+    }
+    // Copy + assert it landed. Throws rather than printing a success banner over an empty directory —
+    // the alpha.9→alpha.14 failure mode. See src/scaffold.ts for why this is not inline.
+    copyRendererScaffold(src, dir);
+    ok(`in-chain renderer scaffold → ${dir}`);
+    step('The in-chain Solidity art lane — nothing to run after deploy, tokenURI resolves from chain forever');
+    info(`${bold('src/MyRenderer.sol')} draws an SVG from the token ${bold('seed')} + a ${bold('palette')} HexColor PostParam; ${bold('src/MyTraits.sol')} reads the SAME seed for coherent on-chain traits. Fork the art; keep the invariants in ${bold('src/interfaces/IAbxFieldRenderer.sol')} (above all: render() must NEVER revert).`);
+    info('build + test + deploy it yourself with Foundry (abx does not compile/deploy Solidity):');
+    console.log(`    ${g('cd')} ${basename(dir)}`);
+    console.log(`    ${g('forge soldeer install')}   ${dim('# fetch solady + forge-std (pinned)')}`);
+    console.log(`    ${g('forge test')}              ${dim('# MUST pass — the never-revert cases')}`);
+    console.log(`    ${g('forge script script/Deploy.s.sol --rpc-url <rpc> --private-key <key> --broadcast')}`);
+    info('then wire the printed addresses into your drop:');
+    console.log(`    ${g('abx deploy-code --image-renderer <MyRenderer> --attributes-renderer <MyTraits> --onchain-uri --schema palette:HexColor:TokenOwner --name "…" --symbol …')}`);
+    info(`full walkthrough: ${bold(`${basename(dir)}/README.md`)} · interface + invariants: https://abx.docs.artblocks.io/protocol/renderers/`);
+}
+/** Human label for each skills-parent dir — which agents pick the skill up from there. */
+export const SKILL_PARENT_LABELS = {
+    '.claude/skills': 'Claude Code',
+    '.agents/skills': 'Cursor · Codex · Gemini · Copilot',
+};
+/** Resolve which skills-parent dirs `install` should write to. No `--agent` → the whole-ecosystem
+ *  default (Claude Code + the neutral `.agents/skills` everyone else reads). `--agent a,b` narrows
+ *  to those agents' dirs (de-duped, since several share `.agents/skills`). */
+export function resolveInstallParents(agentFlag) {
+    if (!agentFlag || agentFlag === 'true')
+        return ['.claude/skills', '.agents/skills'];
+    const parents = new Set();
+    for (const raw of agentFlag.split(',')) {
+        const a = raw.trim().toLowerCase();
+        const parent = AGENT_SKILL_PARENTS[a];
+        if (!parent) {
+            throw new Error(`unknown --agent '${a}'. Use one of: ${Object.keys(AGENT_SKILL_PARENTS).join(', ')} (or omit --agent to install for every agent).`);
+        }
+        parents.add(parent);
+    }
+    return [...parents];
+}
+/** Copy the bundled skill folder to `dest`, replacing any prior copy so a re-install after an
+ *  upgrade never leaves stale reference files behind.
+ *
+ *  Returns `'already-canonical'` when destination IS the source, having done nothing. That case is
+ *  not hypothetical: in a dev checkout of the abx repo `resolveBundledSkill()` resolves to the
+ *  canonical `.claude/skills/abx-self-host`, which is exactly where a cwd-relative install writes —
+ *  so the `rmSync` below would delete the canonical skill, and the copy would then have no source.
+ *  A self-destructing install is a bad way to learn that. */
+export function installSkillTo(src, dest) {
+    if (resolvePath(src) === resolvePath(dest))
+        return 'already-canonical';
+    mkdirSync(joinPath(dest, '..'), { recursive: true });
+    rmSync(dest, { recursive: true, force: true });
+    cpSync(src, dest, { recursive: true });
+    return 'installed';
+}
+/**
+ * Install the bundled skill into the default per-agent parents (or `~` with `global`), reporting
+ * each destination. Shared by `abx skill install` and `abx doctor`'s offer to fix a missing/stale
+ * skill — one implementation, so the two can't drift on where the skill lands or what it prints.
+ */
+export function installSkillToDefaults(src, opts = {}) {
+    const version = readSkillVersion(joinPath(src, 'SKILL.md')) ?? readCliVersion();
+    const base = opts.global ? homedir() : process.cwd();
+    const parents = resolveInstallParents(opts.agent);
+    ok(`installed the abx skill v${version}${opts.global ? ' (global, ~)' : ''}:`);
+    for (const parent of parents) {
+        const dest = joinPath(base, parent, SKILL_DIR_NAME);
+        const outcome = installSkillTo(src, dest);
+        const label = SKILL_PARENT_LABELS[parent];
+        const note = outcome === 'already-canonical' ? dim('  (already the canonical copy — left as is)') : label ? dim('  → ' + label) : '';
+        console.log(`    ${g(joinPath(parent, SKILL_DIR_NAME))}${note}`);
+    }
+    info('restart your agent so it loads the skill, then ask it to launch an NFT with abx.');
+    info(`the skill is version-locked to this CLI (v${version}); re-run ${g('abx skill install')} after upgrading so the two stay in sync.`);
+    return version;
+}
+/** The default skill destinations, as a display string — what doctor's prompt has to name up front. */
+export function defaultSkillDests(opts = {}) {
+    const prefix = opts.global ? '~/' : './';
+    return resolveInstallParents(opts.agent).map((p) => `${prefix}${p}`).join(' and ');
+}
+export async function cmdSkill(rest, flags) {
+    const sub = rest[0] ?? 'install';
+    const src = resolveBundledSkill();
+    if (!src) {
+        throw new Error('bundled skill not found (expected <pkg>/skill or .claude/skills/abx-self-host). ' +
+            'Reinstall @artblocks/abx-cli, or install cross-agent with: npx skills add ArtBlocks/abx --skill abx-self-host');
+    }
+    if (sub === 'path') {
+        console.log(src);
+        return;
+    }
+    if (sub === 'install') {
+        const version = readSkillVersion(joinPath(src, 'SKILL.md')) ?? readCliVersion();
+        // Escape hatch: --target <dir> writes the skill folder straight under <dir> (for an agent
+        // whose skills dir we don't special-case, or a bespoke location).
+        if (typeof flags.target === 'string' && flags.target !== 'true') {
+            const dest = joinPath(resolvePath(flags.target), SKILL_DIR_NAME);
+            if (installSkillTo(src, dest) === 'already-canonical') {
+                ok(`${dest} is already the canonical skill v${version} — nothing to install.`);
+                return;
+            }
+            ok(`installed the abx skill v${version} → ${dest}`);
+            info('restart your agent so it loads the skill, then ask it to launch an NFT with abx.');
+            return;
+        }
+        installSkillToDefaults(src, { global: flags.global !== undefined, agent: flags.agent });
+        return;
+    }
+    throw new Error('usage: abx skill <install|path> [--agent claude|cursor|codex|gemini|copilot] [--global] [--target <dir>]');
+}
+//# sourceMappingURL=scaffold.js.map

package/dist/commands/scaffold.js.map

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

package/dist/commands/service.d.ts

@@ -0,0 +1,41 @@
+import { type Address } from '@artblocks/abx-sdk';
+import { type Flags } from '../flags.js';
+/**
+ * Ensure the LOCAL client credential for your own resolver exists, generating + persisting one to
+ * `.env` (as `ABX_REMOTE_SELF_TOKEN` — the named-remote grammar's "self" entry) if not. The SAME
+ * value also has to land on the resolver itself, under ITS OWN var name (`ABX_RESOLVER_ADMIN_TOKEN`,
+ * server-side — see remote.ts's header comment for why the two names differ across that boundary);
+ * the printed deploy steps carry it across. The token authorizes remote indexing control only
+ * (never on-chain signing), and — like every other secret — lives ONLY in `.env`, never in a
+ * tool-written file or chat. Returns {token, generated} so the caller can tell the operator what
+ * happened without printing the secret itself.
+ */
+export declare function ensureAdminToken(): {
+    token: string;
+    generated: boolean;
+};
+/** Ensure an ABX_EFFECTS_TOKEN exists locally (generated + persisted to `.env` like the admin
+ *  token) — it gates a PUBLIC runner's /run + /notify, and the resolver's watcher sends it. */
+export declare function ensureEffectsToken(): {
+    token: string;
+    generated: boolean;
+};
+/**
+ * `abx effects` — run the reference effect runner LOCALLY, in-process (the local counterpart to
+ * `abx deploy-effects`, which scaffolds a HOSTED runner). This is what makes a param change / new
+ * mint **auto-render** on your own machine: it sweeps every code project the resolver serves and
+ * renders any still missing at the CURRENT inputsHash, then keeps sweeping. Co-located with a local
+ * `abx serve` (same store) it needs no admin token; against a hosted resolver it publishes via the
+ * admin token (locator bridge). Blocks like `serve` — background it. `--once` sweeps all projects a
+ * single time and exits (vs `abx render <addr>` which is the per-project repair lane).
+ */
+export declare function cmdEffects(flags: Flags): Promise<void>;
+export declare function cmdServe(flags: Flags): Promise<void>;
+export declare function cmdRemote(spec: string | undefined, flags: Flags): Promise<void>;
+export declare function cmdMigrate(address: Address | undefined, flags: Flags): Promise<void>;
+/** DEV only: copy the minimal, buildable workspace source into the artifact dir so the emitted
+ *  from-source Dockerfile has a self-contained build context — no node_modules, no repo access. */
+export declare function vendorResolverSource(root: string, outDir: string): void;
+export declare function cmdDeployResolver(flags: Flags): Promise<void>;
+export declare function cmdDeployEffects(flags: Flags): Promise<void>;
+//# sourceMappingURL=service.d.ts.map

package/dist/commands/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../src/commands/service.ts"],"names":[],"mappings":"AAmBA,OAAO,EAEL,KAAK,OAAO,EAUb,MAAM,oBAAoB,CAAC;AAK5B,OAAO,EAAC,KAAK,KAAK,EAAC,MAAM,aAAa,CAAC;AAiCvC;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,IAAI;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAC,CAStE;AAED;+FAC+F;AAC/F,wBAAgB,kBAAkB,IAAI;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAC,CASxE;AAED;;;;;;;;GAQG;AACH,wBAAsB,UAAU,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CA0C5D;AAGD,wBAAsB,QAAQ,CAAC,KAAK,EAAE,KAAK,iBAiC1C;AAQD,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,KAAK,EAAE,KAAK,iBAoFrE;AA+DD,wBAAsB,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,SAAS,EAAE,KAAK,EAAE,KAAK,iBAmI1E;AAED;mGACmG;AACnG,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CASvE;AAED,wBAAsB,iBAAiB,CAAC,KAAK,EAAE,KAAK,iBAyGnD;AAMD,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,KAAK,iBAwFlD"}