@artblocks/abx-cli 0.1.0-alpha.42 → 0.1.0-alpha.44

package/dist/deploy-plan.d.ts

@@ -1,14 +1,11 @@
 /**
- * The structured `--dry-run --json` / `--json` deploy plan (issue #123).
+ * The structured `--dry-run --json` / `--json` deploy plan.
  *
- * The issue as filed asked for ONE plan object that both the JSON payload and the human prose are
- * rendered FROM. That full refactor is deliberately out of scope here: deploy is the highest-stakes
- * command family (real gas, address pinning, salt reservation), 17 test files assert on the EXACT
- * dry-run prose, and the end-user skill pattern-matches on it — rewiring the human path through a
- * shared object risks a wording regression for no consumer that needs it yet (there is no strict
- * JSON-schema integrator today). So this module only adds the other half: a versioned, typed object
- * populated from the SAME locals `commands/deploy.ts` already computed for its human narration, at
- * every existing `emit(jsonSafe({...}))` call site. The prose is untouched, byte-for-byte.
+ * The JSON payload and human prose are rendered from the same values but remain separate surfaces.
+ * Deploy is a high-stakes command family (real gas, address pinning, salt reservation), its exact
+ * dry-run prose is covered extensively, and the end-user skill depends on that prose. This module
+ * therefore provides a versioned, typed object populated from the SAME locals `commands/deploy.ts`
+ * uses for human narration at every `emit(jsonSafe({...}))` call site.
  *
  * A field a lane genuinely has no answer for is explicit `null`, never silently absent — that
  * distinction (present-but-empty vs. not-applicable-here) is the whole point of a schema. See each

package/dist/deploy-plan.d.ts.map

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

package/dist/deploy-plan.js.map

@@ -1 +1 @@
-{"version":3,"file":"deploy-plan.js","sourceRoot":"","sources":["../src/deploy-plan.ts"],"names":[],"mappings":"AAkBA;;;;;;;;;;kCAUkC;AAClC,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAU,CAAC;AA4MrD,4CAA4C;AAC5C,MAAM,IAAI,GAAG,iBAAiB,CAAC;AAE/B;iGACiG;AACjG,MAAM,UAAU,gBAAgB,CAAC,CAAS;IACxC,OAAO,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;AAC7B,CAAC"}
+{"version":3,"file":"deploy-plan.js","sourceRoot":"","sources":["../src/deploy-plan.ts"],"names":[],"mappings":"AAeA;;;;;;;;;;kCAUkC;AAClC,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAU,CAAC;AA4MrD,4CAA4C;AAC5C,MAAM,IAAI,GAAG,iBAAiB,CAAC;AAE/B;iGACiG;AACjG,MAAM,UAAU,gBAAgB,CAAC,CAAS;IACxC,OAAO,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;AAC7B,CAAC"}

package/dist/ownerops.d.ts

@@ -85,7 +85,7 @@ export declare function cmdLockDependencies(address: string | undefined, flags:
 export declare function cmdLockScript(address: string | undefined, flags: Flags): Promise<void>;
 /**
  * `abx replace-script <address> --script <path>` — the safe, first-class way to replace an
- * UNLOCKED code project's on-chain program (#119). `OnChainScript.sol` permits `setScriptChunk`/
+ * UNLOCKED code project's on-chain program. `OnChainScript.sol` permits `setScriptChunk`/
  * `removeLastScriptChunk` right up until `lock-script` — but before this command the only writer
  * was `deploy-code` (its initial setup, or its `--resume` leg for a setup that never landed).
  * Neither is "replace a program that's already live and correct on-chain", which is the gap this
@@ -414,8 +414,8 @@ export declare function cmdSetField(address: string | undefined, flags: Flags):
  * /data/{key}`, the token-api route grammar (`packages/token-api/src/server.ts`'s `/t` and `/c`
  * routes). `base` already carries its OWN `/t` or `/c` prefix (see `TokenURI.sol`/`ContractURI.sol`
  * — `deploy-code`/`deploy`/etc. bake `tokenURIBase = "${host}/t"`), so this never re-adds one.
- * Exported so a creator or an agent never hand-assembles this from the docs — the exact gap #127
- * reported (`attach` produced a bare path, not a URL anyone could actually GET).
+ * Exported so a creator or an agent never has to hand-assemble this from the docs. The old `attach`
+ * output was a bare path, not a URL anyone could actually GET.
  */
 export declare function canonicalAttachmentUrl(opts: {
     uriBase: string;
@@ -426,7 +426,7 @@ export declare function canonicalAttachmentUrl(opts: {
 }): string;
 /**
  * Is ANY resolver actually answering for this project right now — the precondition for an
- * attachment to ever become fetchable, and the check `attach` never ran before #127 (it warned on
+ * attachment to ever become fetchable, and the check `attach` did not originally run (it warned on
  * an EMPTY resolver base, but a non-empty one that answered nothing got a silent, confident "listed
  * in this project's resolver artifacts"). Reuses `cmdVerifyRemote`'s own GET-and-classify shape
  * (`served.ts`'s `fetchServedTokenUri`) rather than a second HTTP client.
@@ -478,7 +478,7 @@ export declare function probeResolverReachable(opts: {
 export declare function cmdAttach(rest: string[], flags: Flags): Promise<void>;
 /**
  * Which scope actually SERVES `field` right now — the same question `abx tokenuri`'s
- * `abx_provenance` line answers, and the one `lock-field` used not to ask (#F7, cold-agent sweep):
+ * `abx_provenance` line answers, and the one `lock-field` did not originally ask:
  * `lock-field --field description --token 0` reported "would succeed" — and DID succeed — on a
  * project where `description` is COLLECTION-scoped, freezing an empty token-scope slot while the
  * value every viewer actually sees (the collection one) stayed completely mutable. Every statement
@@ -503,8 +503,8 @@ export interface FieldScopePresence {
 }
 export type LockFieldScope = 'token' | 'collection';
 /**
- * Pure decision core for the wrong-scope lock check (#F7, cold-agent sweep) — exported so it's
- * unit-testable with no chain at all, matching `computeAvailability`'s split (project.ts): the
+ * Pure decision core for the wrong-scope lock check — exported so it is unit-testable with no chain
+ * at all, matching `computeAvailability`'s split (project.ts): the
  * chain read is a thin, low-risk passthrough; the judgment call belongs in a function a test can
  * call directly.
  *

package/dist/ownerops.js

@@ -606,7 +606,7 @@ function replaceScriptGasFloor(finalCalldata, writeByteCounts) {
 }
 /**
  * `abx replace-script <address> --script <path>` — the safe, first-class way to replace an
- * UNLOCKED code project's on-chain program (#119). `OnChainScript.sol` permits `setScriptChunk`/
+ * UNLOCKED code project's on-chain program. `OnChainScript.sol` permits `setScriptChunk`/
  * `removeLastScriptChunk` right up until `lock-script` — but before this command the only writer
  * was `deploy-code` (its initial setup, or its `--resume` leg for a setup that never landed).
  * Neither is "replace a program that's already live and correct on-chain", which is the gap this
@@ -2164,14 +2164,14 @@ async function reportUriAfterFieldWrite(contract, collection, flags) {
             `  a field renderer must NEVER revert.`);
     }
 }
-// ── attach: the canonical fetch URL + a real reachability probe (#127) ────────
+// ── attach: the canonical fetch URL + a real reachability probe ───────────────
 /**
  * The exact, directly-fetchable URL for one attached key — `{base}/{chainId}/{address}[/{tokenId}]
  * /data/{key}`, the token-api route grammar (`packages/token-api/src/server.ts`'s `/t` and `/c`
  * routes). `base` already carries its OWN `/t` or `/c` prefix (see `TokenURI.sol`/`ContractURI.sol`
  * — `deploy-code`/`deploy`/etc. bake `tokenURIBase = "${host}/t"`), so this never re-adds one.
- * Exported so a creator or an agent never hand-assembles this from the docs — the exact gap #127
- * reported (`attach` produced a bare path, not a URL anyone could actually GET).
+ * Exported so a creator or an agent never has to hand-assemble this from the docs. The old `attach`
+ * output was a bare path, not a URL anyone could actually GET.
  */
 export function canonicalAttachmentUrl(opts) {
     const base = opts.uriBase.replace(/\/+$/, '');
@@ -2180,7 +2180,7 @@ export function canonicalAttachmentUrl(opts) {
 }
 /**
  * Is ANY resolver actually answering for this project right now — the precondition for an
- * attachment to ever become fetchable, and the check `attach` never ran before #127 (it warned on
+ * attachment to ever become fetchable, and the check `attach` did not originally run (it warned on
  * an EMPTY resolver base, but a non-empty one that answered nothing got a silent, confident "listed
  * in this project's resolver artifacts"). Reuses `cmdVerifyRemote`'s own GET-and-classify shape
  * (`served.ts`'s `fetchServedTokenUri`) rather than a second HTTP client.
@@ -2308,7 +2308,7 @@ export async function cmdAttach(rest, flags) {
     for (const p of pairs) {
         console.log(`  attaching ${bold(p.key)} ${dim(`(${p.mimeType}, ${p.representation})`)} to ${scope}: ${dim(p.uri)}`);
     }
-    // Where it surfaces — and whether anything can actually SERVE it (#127). This used to be one dim
+    // Where it surfaces — and whether anything can actually SERVE it. This used to be one dim
     // line assuming a non-empty resolver base meant the artifact would be listed; it never checked.
     // An integrator attached five audio stems to a fully-on-chain token, paid to store them, and found
     // `tokenURI` listed none of them — "paid for, stored on-chain, and invisible". The on-chain
@@ -2367,7 +2367,7 @@ export async function cmdAttach(rest, flags) {
     if (sent) {
         const id = flags.token ?? '0';
         const names = pairs.map((p) => bold(p.key)).join(', ');
-        // The distinction #127 asked for: the on-chain FIELD WRITE succeeding (this line, always true
+        // Preserve the distinction between the on-chain FIELD WRITE succeeding (this line, always true
         // when we get here) is not the same fact as the artifact being SERVABLE — say both, separately,
         // rather than one "✓ attached" that a reader takes to mean "and it's live".
         const servingLine = !uriBase || uriBase.trim() === ''
@@ -2422,7 +2422,7 @@ async function refuseIfParamKey(contract, field) {
 }
 /**
  * Which scope actually SERVES `field` right now — the same question `abx tokenuri`'s
- * `abx_provenance` line answers, and the one `lock-field` used not to ask (#F7, cold-agent sweep):
+ * `abx_provenance` line answers, and the one `lock-field` did not originally ask:
  * `lock-field --field description --token 0` reported "would succeed" — and DID succeed — on a
  * project where `description` is COLLECTION-scoped, freezing an empty token-scope slot while the
  * value every viewer actually sees (the collection one) stayed completely mutable. Every statement
@@ -2449,8 +2449,8 @@ export async function fieldScopePresence(client, contract, tokenId, field) {
     return { token: tokenEntry[1] !== '0x', collection: collectionEntry[1] !== '0x' };
 }
 /**
- * Pure decision core for the wrong-scope lock check (#F7, cold-agent sweep) — exported so it's
- * unit-testable with no chain at all, matching `computeAvailability`'s split (project.ts): the
+ * Pure decision core for the wrong-scope lock check — exported so it is unit-testable with no chain
+ * at all, matching `computeAvailability`'s split (project.ts): the
  * chain read is a thin, low-risk passthrough; the judgment call belongs in a function a test can
  * call directly.
  *