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

package/dist/commands/maintenance.d.ts

@@ -0,0 +1,4 @@
+import { type Flags } from '../flags.js';
+export declare function cmdVacuum(rest: string[], flags: Flags): Promise<void>;
+export declare const VACUUM_HELP: string;
+//# sourceMappingURL=maintenance.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"maintenance.d.ts","sourceRoot":"","sources":["../../src/commands/maintenance.ts"],"names":[],"mappings":"AAuBA,OAAO,EAAC,KAAK,KAAK,EAAC,MAAM,aAAa,CAAC;AAiBvC,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAc3E;AA8DD,eAAO,MAAM,WAAW,QAQ8D,CAAC"}

package/dist/commands/maintenance.js

@@ -0,0 +1,114 @@
+/**
+ * `abx vacuum` — SQLite maintenance for the local reference store (issue #113).
+ *
+ * Two halves, matching `SqliteStore`'s split in `packages/indexer/src/store.ts`:
+ *  - `abx vacuum convert`     the one-time, EXPLICIT full `VACUUM` for a store stuck at
+ *                             `auto_vacuum='none'` — every store created before this repo started
+ *                             setting the pragma ahead of schema creation (and, until the pragma
+ *                             ordering bug this issue also fixed, every store created since too —
+ *                             see the comment on `SCHEMA` in store.ts). A full VACUUM rewrites the
+ *                             ENTIRE database file and can briefly need up to ~2x its on-disk size,
+ *                             so it never runs on its own anywhere in this codebase — this command
+ *                             is the only place it happens, and only when an operator asks for it.
+ *  - `abx vacuum incremental` a manual, bounded `PRAGMA incremental_vacuum` pass — the SAME bounded
+ *                             mechanism `abx serve` already runs automatically BETWEEN watch-loop
+ *                             ticks (`SelfHostIndexer.startVacuumMaintenance`), exposed here for an
+ *                             operator who wants one pass on demand (right after `convert`, or on a
+ *                             node that isn't running `abx serve`'s watcher at all).
+ *
+ * `abx vacuum` (or `abx vacuum status`) alone is read-only: it just reports where the store stands,
+ * so an operator can decide whether either half applies before running anything.
+ */
+import { DEFAULT_INCREMENTAL_VACUUM_PAGES, SqliteStore } from '@artblocks/abx-indexer';
+import { localIndexer } from '../config.js';
+import { bold, dim, g, info, ok, warn } from '../output.js';
+/** Vacuuming is SQLite-specific (see store.ts's docstring on why these methods aren't on the
+ *  generic `Store` interface) — a platform-scale Postgres deploy has its own manual VACUUM story
+ *  outside this codebase, so this command has nothing to do there and says so plainly. */
+function requireSqliteStore() {
+    const store = localIndexer().store;
+    if (!(store instanceof SqliteStore)) {
+        throw new Error('abx vacuum applies to the local SQLite reference store only — this node is backed by something else, ' +
+            'which owns its own maintenance story.');
+    }
+    return store;
+}
+export async function cmdVacuum(rest, flags) {
+    const sub = rest[0];
+    switch (sub) {
+        case undefined:
+        case 'status':
+            return cmdVacuumStatus();
+        case 'convert':
+            return cmdVacuumConvert();
+        case 'incremental':
+            return cmdVacuumIncremental(flags);
+        default:
+            console.error(VACUUM_USAGE);
+            process.exitCode = 1;
+    }
+}
+function cmdVacuumStatus() {
+    const store = requireSqliteStore();
+    const stats = store.vacuumStats();
+    console.log(`store        ${store.path}`);
+    console.log(`auto_vacuum  ${bold(stats.mode)}`);
+    console.log(`page_count   ${stats.pageCount}`);
+    console.log(`freelist     ${stats.freelistPages} page(s)`);
+    console.log('');
+    if (stats.mode === 'none') {
+        warn(`this store predates incremental auto-vacuum and needs a one-time conversion: ${g('abx vacuum convert')}`);
+    }
+    else if (stats.freelistPages > 0) {
+        info(`${stats.freelistPages} freed page(s) reclaimable — abx serve does this automatically between watch ticks; ` +
+            `run one pass now with ${g('abx vacuum incremental')}`);
+    }
+    else {
+        ok('nothing to reclaim');
+    }
+}
+function cmdVacuumConvert() {
+    const store = requireSqliteStore();
+    const before = store.vacuumStats();
+    if (before.mode !== 'none') {
+        ok(`already converted — auto_vacuum is '${before.mode}'; nothing to do.`);
+        return;
+    }
+    console.log(`${bold('abx vacuum convert')} runs a full SQLite ${bold('VACUUM')} on ${store.path} to enable incremental ` +
+        `auto-vacuum.\n` +
+        `${dim(`this REWRITES THE ENTIRE FILE (currently ${before.pageCount} page(s)) and can briefly need up to`)}\n` +
+        `${dim('~2x its on-disk size while it runs. This is a one-time operation — after it, freed pages reclaim')}\n` +
+        `${dim(`incrementally instead (${g('abx vacuum incremental')}, or automatically between abx serve's watch ticks).`)}\n`);
+    console.log(`converting… (auto_vacuum: none → incremental)`);
+    const mode = store.vacuumConvert();
+    const after = store.vacuumStats();
+    ok(`done — auto_vacuum is now '${mode}'; ${before.pageCount} → ${after.pageCount} page(s).`);
+}
+function cmdVacuumIncremental(flags) {
+    const store = requireSqliteStore();
+    const maxPages = flags.pages !== undefined ? Number(flags.pages) : DEFAULT_INCREMENTAL_VACUUM_PAGES;
+    if (!Number.isFinite(maxPages) || maxPages <= 0) {
+        throw new Error(`--pages must be a positive number (got ${JSON.stringify(flags.pages)})`);
+    }
+    const mode = store.autoVacuumMode();
+    if (mode !== 'incremental') {
+        warn(`auto_vacuum is '${mode}' — incremental_vacuum has nothing to do until this store is converted: ${g('abx vacuum convert')}`);
+        return;
+    }
+    const reclaimed = store.runIncrementalVacuum(maxPages);
+    if (reclaimed > 0)
+        ok(`reclaimed ${reclaimed} page(s) (bounded to ${maxPages} this pass)`);
+    else
+        info('nothing to reclaim');
+}
+const VACUUM_USAGE = `usage: abx vacuum [status|convert|incremental] [--pages <n>]`;
+export const VACUUM_HELP = `
+  ${bold('abx vacuum')} [status|convert|incremental] ${dim('— SQLite maintenance for the local reference store; read-only unless a write happens below')}
+    ${g('abx vacuum')}              ${dim('(default: status)')} report auto_vacuum mode + page/freelist counts
+    ${g('abx vacuum convert')}      one-time, EXPLICIT full VACUUM for a store stuck at auto_vacuum='none' — rewrites
+                          the whole file; can briefly need up to ~2x its on-disk size. Never runs automatically.
+    ${g('abx vacuum incremental')} [--pages <n>]  one bounded PRAGMA incremental_vacuum pass (default ${DEFAULT_INCREMENTAL_VACUUM_PAGES}
+                          pages) — the same bounded reclaim \`abx serve\` already runs automatically BETWEEN watch
+                          ticks; use this on demand (after \`convert\`, or on a node not running \`abx serve\`).
+    ${dim('c.f. site/content/docs/using-abx/self-hosting.mdx → SQLite maintenance.')}`;
+//# sourceMappingURL=maintenance.js.map

package/dist/commands/maintenance.js.map

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

package/dist/commands/project.d.ts

@@ -1,12 +1,61 @@
-import { type Address } from '@artblocks/abx-sdk';
+import { type Address, type PublicClient, type MetadataField } from '@artblocks/abx-sdk';
 import { type Flags } from '../flags.js';
 import { type RemoteTarget } from '../remote.js';
 export declare function cmdPredict(flags: Flags): Promise<void>;
 export declare function cmdAdd(address: Address | undefined, flags: Flags): Promise<void>;
 export declare function cmdIndex(address: Address | undefined, flags: Flags): Promise<void>;
 export declare function cmdVerify(address: Address | undefined, flags: Flags): Promise<void>;
+export type AvailabilityStatus = 'available' | 'partial' | 'unavailable' | 'unknown';
+export interface AvailabilityVerdict {
+    status: AvailabilityStatus;
+    note: string;
+}
+/**
+ * Pure by design — every caller (`cmdVerifyBody`'s local lane and `cmdVerifyRemote`'s hosted lane)
+ * feeds it facts it already gathered rather than each re-deriving its own verdict, so the two
+ * lanes' JSON payloads read the same word for the same situation.
+ *
+ * `isCode` selects which signal decides the verdict: a code project's render presence
+ * (`minted`/`present`), or — for everything else — whether a byte-check actually ran
+ * (`anyCheck`) versus a locator this run could not independently re-hash (`unrecomputablePointers`).
+ * The two signals are never combined into one number on purpose: "3 of 5 renders present" and "2
+ * locator commitments unconfirmed" are different facts about different projects, and mixing them
+ * would produce a verdict that answers neither question honestly.
+ */
+export declare function computeAvailability(opts: {
+    isCode: boolean;
+    minted: number;
+    present: number;
+    anyCheck: boolean;
+    unrecomputablePointers: number;
+}): AvailabilityVerdict;
+/**
+ * Does this token's `image` field carry a locator commitment `verifyProject` never produced a
+ * check for? Exported and pure (a plain `fields` array in, a verdict out — no chain, no indexer)
+ * so #112's three-way distinction is unit-testable directly, rather than only reachable through a
+ * full `cmdVerifyBody` run against real chain state.
+ *
+ * Returns the representation name to report (`ipfs`/`arweave`/`url`/`url-template`) when the image
+ * field is a bare locator, else `null` — including when there's no `image` field at all, which is
+ * "no commitment", a different fact from "an unrecomputable one".
+ */
+export declare function pointerOnlyImageCheck(fields: MetadataField[]): string | null;
 export declare function cmdVerifyBody(address: Address, flags: Flags, emit: (p: Record<string, unknown>) => void): Promise<void>;
-export declare function cmdVerifyRemote(address: Address, remote: RemoteTarget): Promise<void>;
+export declare function cmdVerifyRemote(address: Address, remote: RemoteTarget, emit: (p: Record<string, unknown>) => void): Promise<void>;
+/** What {@link reportRemoteByteIntegrity} found, structured for the JSON payload as well as its own
+ *  prose. `status` deliberately has a 4th value the local lane's `contentIntegrity` doesn't need:
+ *  `'not-checked'` — no credential, a rejected token, an older node with no `/verify` route, or an
+ *  unreachable endpoint. That is a DIFFERENT fact from `'no-commitments'` (the route answered and
+ *  said there's nothing to check) and must never collapse into it — "we didn't ask" and "we asked
+ *  and there was nothing" are different reasons for the same empty result. */
+export interface RemoteByteIntegrity {
+    status: 'ok' | 'mismatch' | 'no-commitments' | 'not-checked';
+    checks: Array<{
+        tokenId: string;
+        kind: string;
+        verified: boolean;
+    }>;
+}
 /**
  * The half `abx verify --remote` was missing: do the served BYTES still hash to the on-chain
  * commitment? Everything above it checks renders (is a thumbnail current, is it a placeholder) — a
@@ -18,7 +67,7 @@ export declare function cmdVerifyRemote(address: Address, remote: RemoteTarget):
  * outbound fetches). When we can't reach that — no credential, or an older node — say plainly that
  * byte integrity was NOT checked rather than leaving the ✓ above to imply it was.
  */
-export declare function reportRemoteByteIntegrity(address: Address, remote: RemoteTarget, base: string): Promise<void>;
+export declare function reportRemoteByteIntegrity(address: Address, remote: RemoteTarget, base: string): Promise<RemoteByteIntegrity>;
 export declare const STATE_ABI: readonly [{
     readonly type: "function";
     readonly name: "owner";
@@ -123,6 +172,48 @@ export declare const STATE_ABI: readonly [{
     readonly outputs: readonly [{
         readonly type: "address";
     }];
+}, {
+    readonly type: "function";
+    readonly name: "tokenURILocked";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly type: "bool";
+    }];
+}, {
+    readonly type: "function";
+    readonly name: "contractURILocked";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly type: "bool";
+    }];
+}, {
+    readonly type: "function";
+    readonly name: "scriptLocked";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly type: "bool";
+    }];
+}, {
+    readonly type: "function";
+    readonly name: "dependenciesLocked";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly type: "bool";
+    }];
+}, {
+    readonly type: "function";
+    readonly name: "contractFieldLocked";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly type: "bytes32";
+    }];
+    readonly outputs: readonly [{
+        readonly type: "bool";
+    }];
 }];
 /** The edition twin of {@link STATE_ABI} — `owner`/`maxInvocations`/`paused`/`minter`/
  *  `primaryPayee`/`tokenURIRenderer`/`royaltyInfo` are shared, unchanged, function names (see
@@ -238,7 +329,87 @@ export declare const EDITION_STATE_ABI: readonly [{
     readonly outputs: readonly [{
         readonly type: "address";
     }];
+}, {
+    readonly type: "function";
+    readonly name: "tokenURILocked";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly type: "bool";
+    }];
+}, {
+    readonly type: "function";
+    readonly name: "contractURILocked";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly type: "bool";
+    }];
+}, {
+    readonly type: "function";
+    readonly name: "scriptLocked";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly type: "bool";
+    }];
+}, {
+    readonly type: "function";
+    readonly name: "dependenciesLocked";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly type: "bool";
+    }];
+}, {
+    readonly type: "function";
+    readonly name: "contractFieldLocked";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly type: "bytes32";
+    }];
+    readonly outputs: readonly [{
+        readonly type: "bool";
+    }];
 }];
+/** One boolean lock, tri-state: `true` (frozen forever) · `false` (open — the owner can still
+ *  change it) · `null` (the read failed — an RPC refusal, or a wrong dialect). Never collapse
+ *  `null` into `false`: an unread lock is not proof it's off, and `state`'s whole job here is to
+ *  keep that distinction visible all the way to the JSON payload. */
+type LockRead = boolean | null;
+/** Every irreversible lock a collection can carry, as read straight from chain. */
+export interface CollectionLocks {
+    tokenURI: LockRead;
+    contractURI: LockRead;
+    /** The bounded METADATA_FIELD scan — see {@link readFieldLocks}'s doc for the caveat this carries. */
+    fields: {
+        field: string;
+        locked: LockRead;
+    }[];
+    /** `null` (the OBJECT, not the inner `locked`) ⇒ not applicable: this contract has no on-chain
+     *  script surface at all (not a code project), a different fact from "unknown" ({@link LockRead}'s
+     *  `null`), which is reserved for "the surface exists but the read failed". */
+    script: {
+        locked: LockRead;
+    } | null;
+    dependencies: {
+        locked: LockRead;
+    } | null;
+}
+/**
+ * Read every applicable irreversible lock for one collection: token/contract URI config, the
+ * bounded standard field set, and — for a code project — the script and dependency freezes.
+ * `paramHooks.locked` is deliberately NOT read here: `cmdStateBody`/`cmdStateEditionBody` already
+ * read it (`readParamHooksLocked`) as part of the existing param-hooks readout, and re-reading it
+ * would cost a second `eth_call` for a fact already on hand — see the callers, which pass it into
+ * {@link printLocks} instead.
+ *
+ * `isCode` gates `scriptLocked`/`dependenciesLocked`: those getters exist ONLY on the two code
+ * twins (SeriesCode/EditionCode), so asking a plain image/Series contract for them isn't a failed
+ * read to report as "unknown" — it's a surface that was never there, reported as `null` (not
+ * applicable) via the OUTER object rather than the boolean inside it.
+ */
+export declare function readCollectionLocks(publicClient: PublicClient, address: Address, abi: readonly unknown[], isCode: boolean): Promise<CollectionLocks>;
 export declare function cmdState(address: Address | undefined, flags: Flags): Promise<void>;
 export declare function cmdStateBody(address: Address, flags: Flags, emit: (p: Record<string, unknown>) => void): Promise<void>;
 /**
@@ -254,4 +425,5 @@ export declare function cmdStatus(address: Address | undefined, flags: Flags): P
  *  can see. `--watch` tails until everything reaches a terminal state. */
 export declare function cmdStatusRemote(address: Address | undefined, remote: RemoteTarget, flags: Flags): Promise<void>;
 export declare function cmdForget(address: Address | undefined, flags: Flags): Promise<void>;
+export {};
 //# sourceMappingURL=project.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../../src/commands/project.ts"],"names":[],"mappings":"AAQA,OAAO,EAGL,KAAK,OAAO,EA+Bb,MAAM,oBAAoB,CAAC;AAgB5B,OAAO,EAAC,KAAK,KAAK,EAA0B,MAAM,aAAa,CAAC;AAOhE,OAAO,EACL,KAAK,YAAY,EAalB,MAAM,cAAc,CAAC;AAQtB,wBAAsB,UAAU,CAAC,KAAK,EAAE,KAAK,iBA+E5C;AAMD,wBAAsB,MAAM,CAAC,OAAO,EAAE,OAAO,GAAG,SAAS,EAAE,KAAK,EAAE,KAAK,iBA4GtE;AAED,wBAAsB,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,SAAS,EAAE,KAAK,EAAE,KAAK,iBAoCxE;AAMD,wBAAsB,SAAS,CAAC,OAAO,EAAE,OAAO,GAAG,SAAS,EAAE,KAAK,EAAE,KAAK,iBAazE;AAED,wBAAsB,aAAa,CACjC,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,KAAK,EACZ,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,GACzC,OAAO,CAAC,IAAI,CAAC,CAwQf;AAMD,wBAAsB,eAAe,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,iBA+F3E;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,yBAAyB,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA6CnH;AAqBD,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAmBZ,CAAC;AAEX;;;;;oGAKoG;AACpG,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiBpB,CAAC;AAsHX,wBAAsB,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,SAAS,EAAE,KAAK,EAAE,KAAK,iBASxE;AAED,wBAAsB,YAAY,CAChC,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,KAAK,EACZ,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,GACzC,OAAO,CAAC,IAAI,CAAC,CA2Mf;AA2KD;;;;;;;GAOG;AACH,wBAAsB,SAAS,CAAC,OAAO,EAAE,OAAO,GAAG,SAAS,EAAE,KAAK,EAAE,KAAK,iBAqDzE;AAED;0EAC0E;AAC1E,wBAAsB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,KAAK,iBAgErG;AAKD,wBAAsB,SAAS,CAAC,OAAO,EAAE,OAAO,GAAG,SAAS,EAAE,KAAK,EAAE,KAAK,iBA2BzE"}
+{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../../src/commands/project.ts"],"names":[],"mappings":"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"}