biblioplex 0.1.0 → 0.2.0

package/README.md

@@ -1,92 +0,0 @@
-# biblioplex cli
-
-manage your [biblioplex](https://biblioplex.bensonperry.com) magic: the gathering
-collection from the terminal — search, edit, import, and export, all against your
-live cloud collection.
-
-cloud-first: every command reads and writes the same collection the web app uses,
-so the cli and the website stay perfectly in sync.
-
-## install
-
-requires **node 20+**.
-
-```sh
-npm install -g biblioplex      # then run `biblioplex` or `bp`
-# or, no install:
-npx biblioplex login
-```
-
-> the global command is `biblioplex`. it also installs a short `bp` alias; if some
-> other tool already owns `bp` on your machine, just use `biblioplex` (or add your
-> own alias).
-
-## sign in
-
-```sh
-bp login            # read-only (search/export)
-bp login --write    # also allow edits/imports
-```
-
-`bp login` opens your browser once to authorize the cli, then stores a refresh
-token locally so you stay signed in for ~30 days. `bp logout` revokes it.
-
-on a headless box: `bp login --no-browser` prints a url to open elsewhere.
-
-## examples
-
-```sh
-# search with the same query grammar as the web app
-bp search "t:creature c:rg cmc<=3 -t:legendary"
-bp search rare f:foil --sort price --desc --limit 20
-
-# totals and your most valuable cards
-bp summary
-
-# containers
-bp ls decks
-bp show "deck:breya"
-bp deck show breya
-bp deck export breya --preset moxfield > breya.txt
-
-# edits (need `bp login --write`)
-bp add "Sol Ring" --set c21 --cn 263 --qty 2 --location "box:bulk"
-bp edit "Sol Ring" --condition lightly_played
-bp move "Sol Ring" --to "deck:breya"
-bp tag add trade "Sol Ring"
-bp rm "Sol Ring"
-bp undo                      # revert the last cli change
-
-# bulk import / export (cloud stays the source of truth)
-bp import moxfield-export.csv          # auto-detects the format
-bp export "f:foil" --format moxfield > foils.txt
-bp export --archive --output backup.json
-```
-
-ambiguous card names list the matching stacks; narrow with
-`--set/--cn/--finish/--condition/--location`, or apply to all with `--all`.
-
-## scripting / agents
-
-every command accepts `--json` and prints a stable envelope to stdout:
-
-```json
-{ "ok": true, "data": { ... } }
-{ "ok": false, "error": { "message": "..." } }
-```
-
-diagnostics go to stderr, so `--json` stdout is always a single json document.
-exit codes: `0` ok · `1` error · `2` usage · `3` auth (run `bp login`) · `4` rate-limited.
-
-## configuration
-
-- credentials: `~/.config/biblioplex/credentials.json` (mode 600)
-- override the api endpoint: `--api <url>` or `BIBLIOPLEX_API_BASE`
-- override the config dir: `BIBLIOPLEX_CONFIG_DIR`
-
-## notes
-
-- zero runtime dependencies (node built-ins only).
-- card search/sort, csv adapters, and the collection model are shared verbatim
-  with the web app (see `vendor/`), so behavior matches exactly.
-- macOS and linux are supported in this release.

package/src/api.mjs

@@ -1,110 +0,0 @@
-// Authenticated transport to the biblioplex worker.
-//  - reads:  GET /sync/bootstrap (full snapshot)
-//  - writes: POST /sync/push (granular ops built locally from a diff)
-//  - tools:  POST /mcp JSON-RPC (search_card_printings, preview_*/apply, undo)
-// Refreshes the access token proactively (near expiry) and reactively (on 401),
-// persisting rotated tokens. The token is sent only in the Authorization header.
-import { refreshTokens } from './oauth.mjs';
-import { CliError, authError, rateLimitError } from './errors.mjs';
-import { CLIENT_LABEL } from './constants.mjs';
-
-export class Session {
-  constructor({ base, credentials, persist, fetchImpl = fetch }) {
-    this.base = base;
-    this.creds = credentials;
-    this.persist = persist || (() => {});
-    this.fetchImpl = fetchImpl;
-    this._rpcId = 0;
-  }
-
-  get scopes() { return (this.creds?.scope || '').split(/\s+/).filter(Boolean); }
-  hasScope(scope) { return this.scopes.includes(scope); }
-
-  async _refresh() {
-    if (!this.creds?.refreshToken) throw authError('session expired — run `bp login`');
-    this._absorb(await refreshTokens({ base: this.base, refreshToken: this.creds.refreshToken, fetchImpl: this.fetchImpl }));
-  }
-
-  _absorb(tokens) {
-    this.creds = {
-      ...this.creds,
-      accessToken: tokens.access_token,
-      refreshToken: tokens.refresh_token || this.creds.refreshToken,
-      accessExpiresAt: Date.now() + (Number(tokens.expires_in) || 3600) * 1000,
-      scope: tokens.scope || this.creds.scope,
-    };
-    this.persist(this.creds);
-  }
-
-  async _authedFetch(path, opts = {}, retried = false) {
-    if (!this.creds?.accessToken) throw authError();
-    if (!retried && this.creds.accessExpiresAt && this.creds.accessExpiresAt - Date.now() < 30000) {
-      await this._refresh();
-    }
-    const headers = { ...(opts.headers || {}), Authorization: 'Bearer ' + this.creds.accessToken };
-    const res = await this.fetchImpl(this.base + path, { ...opts, headers });
-    if (res.status === 401 && !retried) { await this._refresh(); return this._authedFetch(path, opts, true); }
-    if (res.status === 401) throw authError('session expired — run `bp login`');
-    if (res.status === 403) {
-      const body = await res.json().catch(() => ({}));
-      const msg = body.error === 'insufficient_scope'
-        ? 'this session lacks write access — run `bp login --write`'
-        : (body.error || 'forbidden');
-      throw new CliError(msg, 1, body);
-    }
-    if (res.status === 429) throw rateLimitError();
-    return res;
-  }
-
-  async bootstrap() {
-    const res = await this._authedFetch('/sync/bootstrap');
-    if (!res.ok) throw new CliError('could not load collection (' + res.status + ')');
-    return res.json();
-  }
-
-  async push({ ops, baseRevision }) {
-    const res = await this._authedFetch('/sync/push', {
-      method: 'POST',
-      headers: { 'Content-Type': 'application/json' },
-      body: JSON.stringify({ clientId: CLIENT_LABEL, baseRevision, requireBaseRevision: true, ops }),
-    });
-    if (res.status === 409) {
-      const data = await res.json().catch(() => ({}));
-      const err = new CliError('the cloud collection changed since this command started', 1, data);
-      err.conflict = true;
-      throw err;
-    }
-    if (!res.ok) {
-      const data = await res.json().catch(() => ({}));
-      throw new CliError('push failed: ' + (data.error || res.status), 1, data);
-    }
-    return res.json();
-  }
-
-  async mcp(method, params = {}) {
-    const id = ++this._rpcId;
-    const res = await this._authedFetch('/mcp', {
-      method: 'POST',
-      headers: { 'Content-Type': 'application/json', Accept: 'application/json' },
-      body: JSON.stringify({ jsonrpc: '2.0', id, method, params }),
-    });
-    if (!res.ok) throw new CliError('mcp request failed (' + res.status + ')');
-    const data = await res.json().catch(() => ({}));
-    if (data.error) {
-      if (data.error.code === -32003 || /insufficient_scope/.test(data.error.message || '')) {
-        throw new CliError('this session lacks write access — run `bp login --write`', 1, data.error);
-      }
-      throw new CliError(data.error.message || 'mcp error', 1, data.error);
-    }
-    return data.result;
-  }
-
-  async callTool(name, args = {}) {
-    const result = await this.mcp('tools/call', { name, arguments: args });
-    if (result?.isError) {
-      const text = (result.content || []).map(c => c.text).filter(Boolean).join(' ');
-      throw new CliError(text || ('tool ' + name + ' failed'), 1, result);
-    }
-    return result?.structuredContent ?? result ?? null;
-  }
-}

package/src/commands/container.mjs

@@ -1,83 +0,0 @@
-import { locationKey } from '../../vendor/collection.js';
-import { applyMutation } from '../mutate.mjs';
-import { parseContainerRef } from '../snapshot.mjs';
-import { boolFlag } from '../args.mjs';
-import { requireWrite, parseLocationFlag, ensureContainer, persistUndo, printWrite } from './writeHelpers.mjs';
-import { usageError, CliError } from '../errors.mjs';
-
-function resolveContainer(draft, ref) {
-  const containers = draft.app.containers || {};
-  const loc = parseLocationFlag(ref);
-  if (loc && containers[loc.type + ':' + loc.name]) return { key: loc.type + ':' + loc.name, container: containers[loc.type + ':' + loc.name] };
-  const name = parseContainerRef(ref).name;
-  const matches = Object.entries(containers).filter(([, c]) => c.name === name);
-  if (!matches.length) throw new CliError(`no container "${ref}"`);
-  if (matches.length > 1) throw new CliError(`"${ref}" is ambiguous — use type:name (${matches.map(([k]) => k).join(', ')})`);
-  return { key: matches[0][0], container: matches[0][1] };
-}
-
-export default {
-  summary: 'create / rename / delete a container',
-  help: [
-    'usage: bp container create <type:name>            (type = deck|container)',
-    '       bp container rename <type:name> <new-name>',
-    '       bp container delete <type:name> [--force]   (--force unfiles its cards)',
-    '',
-    'legacy "binder:"/"box:" prefixes are accepted and treated as containers.',
-  ].join('\n'),
-  async run(ctx) {
-    const { out, flags, args } = ctx;
-    const session = ctx.makeSession();
-    requireWrite(session);
-    const [sub, ref, ...rest] = args;
-
-    if (sub === 'create') {
-      const loc = parseLocationFlag(ref);
-      if (!loc) throw usageError('usage: bp container create <type:name>');
-      const result = await applyMutation(session, (draft) => { ensureContainer(draft, loc); return { created: loc.type + ':' + loc.name }; }, { dryRun: boolFlag(flags, 'dry-run') });
-      persistUndo(result);
-      printWrite(out, result, () => out.info(out.c.green('✓ created') + ` ${loc.type}:${loc.name}`));
-      return 0;
-    }
-
-    if (sub === 'rename') {
-      const newName = parseContainerRef(rest.join(' ')).name;
-      if (!ref || !newName) throw usageError('usage: bp container rename <type:name> <new-name>');
-      const result = await applyMutation(session, (draft) => {
-        const { key, container } = resolveContainer(draft, ref);
-        const newKey = container.type + ':' + newName;
-        if (draft.app.containers[newKey]) throw new CliError(`a ${container.type} named "${newName}" already exists`);
-        const renamed = { ...container, name: newName };
-        // Keep the deck's display title in sync if it tracked the old name.
-        if (renamed.deck && (!renamed.deck.title || renamed.deck.title === container.name)) {
-          renamed.deck = { ...renamed.deck, title: newName };
-        }
-        draft.app.containers[newKey] = renamed;
-        delete draft.app.containers[key];
-        for (const e of draft.app.collection) if (locationKey(e.location) === key) e.location = { type: container.type, name: newName };
-        return { renamed: key, to: newKey };
-      }, { dryRun: boolFlag(flags, 'dry-run') });
-      persistUndo(result);
-      printWrite(out, result, () => out.info(out.c.green('✓ renamed') + ` ${result.meta.renamed} → ${result.meta.to}`));
-      return 0;
-    }
-
-    if (sub === 'delete') {
-      const result = await applyMutation(session, (draft) => {
-        const { key, container } = resolveContainer(draft, ref);
-        const cards = draft.app.collection.filter(e => locationKey(e.location) === key);
-        if (cards.length && !boolFlag(flags, 'force')) {
-          throw new CliError(`${container.type}:${container.name} holds ${cards.length} stack(s) — pass --force to delete and unfile them`);
-        }
-        for (const e of draft.app.collection) if (locationKey(e.location) === key) { e.location = null; delete e.deckBoard; }
-        delete draft.app.containers[key];
-        return { deleted: key, unfiled: cards.length };
-      }, { dryRun: boolFlag(flags, 'dry-run') });
-      persistUndo(result);
-      printWrite(out, result, () => out.info(out.c.green('✓ deleted') + ` ${result.meta.deleted}` + (result.meta.unfiled ? ` (unfiled ${result.meta.unfiled})` : '')));
-      return 0;
-    }
-
-    throw usageError('usage: bp container <create|rename|delete> <type:name>');
-  },
-};

package/src/commands/deckExport.mjs

@@ -1,48 +0,0 @@
-import { writeFileSync } from 'node:fs';
-import { loadSnapshot } from '../mutate.mjs';
-import { findContainer, containerCards } from '../snapshot.mjs';
-import { buildDeckExport } from '../../vendor/deckExport.js';
-import { strFlag } from '../args.mjs';
-import { usageError, CliError } from '../errors.mjs';
-
-// `bp deck export <name> [--preset ...] [--boards a,b] [--output file]`
-export async function runDeckExport(ctx, args) {
-  const { out, flags } = ctx;
-  const name = args.join(' ');
-  if (!name) throw usageError('usage: bp deck export <name> [--preset plain|moxfield|arena|mtgo|csv|json]');
-
-  const session = ctx.makeSession();
-  const { snapshot } = await loadSnapshot(session);
-  const { matches } = findContainer(snapshot, 'deck:' + name);
-  const decks = matches.filter(m => m.type === 'deck');
-  if (!decks.length) throw new CliError(`no deck named "${name}"`);
-
-  const deck = decks[0];
-  const cards = containerCards(snapshot, deck);
-  const preset = strFlag(flags, 'preset') || 'plain';
-  const boardsFlag = strFlag(flags, 'boards');
-  const boards = boardsFlag ? boardsFlag.split(',').map(s => s.trim()).filter(Boolean) : undefined;
-  const dm = deck.deck || {};
-  // buildDeckExport expects commander/partner as plain name strings; the app
-  // stores them as { name, scryfallId, ... } objects.
-  const meta = {
-    title: deck.name,
-    format: dm.format,
-    commander: dm.commander?.name || (typeof dm.commander === 'string' ? dm.commander : undefined),
-    partner: dm.partner?.name || (typeof dm.partner === 'string' ? dm.partner : undefined),
-  };
-
-  const result = buildDeckExport(cards, meta, { preset, ...(boards ? { boards } : {}) });
-  for (const w of result.warnings || []) out.info(out.c.yellow('! ' + w));
-
-  const file = strFlag(flags, 'output', 'o');
-  if (file) {
-    writeFileSync(file, result.body.endsWith('\n') ? result.body : result.body + '\n');
-    out.emit({ file, filename: result.filename, preset }, () => out.info(`wrote ${file}`));
-  } else if (out.json) {
-    out.emit({ preset, filename: result.filename, body: result.body, warnings: result.warnings });
-  } else {
-    out.raw(result.body);
-  }
-  return 0;
-}

package/src/commands/show.mjs

@@ -1,33 +0,0 @@
-import { loadSnapshot } from '../mutate.mjs';
-import { findContainer, containerCards } from '../snapshot.mjs';
-import { runQuery } from '../snapshot.mjs';
-import { cardRow, CARD_COLUMNS, cardsToCsv } from '../render.mjs';
-import { strFlag, boolFlag } from '../args.mjs';
-import { usageError, CliError } from '../errors.mjs';
-
-export default {
-  summary: 'show the cards in a container',
-  help: 'usage: bp show <container> [--sort field] [--csv|--json]\n\ncontainer may be "deck:breya", "binder:rares", or just "breya" if unambiguous.',
-  async run(ctx) {
-    const { out, args, flags } = ctx;
-    const ref = args.join(' ');
-    if (!ref) throw usageError('usage: bp show <container>');
-    const session = ctx.makeSession();
-    const { snapshot } = await loadSnapshot(session);
-    const { matches, name } = findContainer(snapshot, ref);
-    if (!matches.length) throw new CliError(`no container named "${name}"`);
-    if (matches.length > 1) {
-      throw new CliError(`"${name}" is ambiguous — try ${matches.map(m => m.type + ':' + m.name).join(', ')}`);
-    }
-    const container = matches[0];
-    const cards = runQuery(containerCards(snapshot, container), '', { sort: strFlag(flags, 'sort') || 'name', dir: boolFlag(flags, 'desc') ? 'desc' : 'asc' });
-
-    if (boolFlag(flags, 'csv')) { out.raw(cardsToCsv(cards, strFlag(flags, 'format') || 'canonical')); return 0; }
-    out.emit({ container: { type: container.type, name: container.name }, count: cards.length, cards }, () => {
-      out.line(out.c.bold(container.type + ':' + container.name));
-      if (!cards.length) { out.info('(empty)'); return; }
-      out.table(CARD_COLUMNS, cards.map(cardRow));
-    });
-    return 0;
-  },
-};

package/src/commands/tag.mjs

@@ -1,40 +0,0 @@
-import { collectionKey, normalizeTag } from '../../vendor/collection.js';
-import { applyMutation } from '../mutate.mjs';
-import { boolFlag } from '../args.mjs';
-import { requireWrite, selectorFrom, requireStacks, persistUndo, printWrite } from './writeHelpers.mjs';
-import { usageError } from '../errors.mjs';
-
-export default {
-  summary: 'add or remove a tag on a stack',
-  help: [
-    'usage: bp tag add <tag> <name> [--set --cn --finish ...] [--all]',
-    '       bp tag rm  <tag> <name> [...]',
-    '',
-    'adds/removes a single tag on matching stacks.',
-  ].join('\n'),
-  async run(ctx) {
-    const { out, flags, args } = ctx;
-    const session = ctx.makeSession();
-    requireWrite(session);
-    const [op, rawTag, ...nameParts] = args;
-    if ((op !== 'add' && op !== 'rm') || !rawTag) throw usageError('usage: bp tag <add|rm> <tag> <name>');
-    const tag = normalizeTag(rawTag);
-    const sel = selectorFrom(flags, nameParts);
-
-    const result = await applyMutation(session, (draft) => {
-      const stacks = requireStacks(draft.app.collection, sel, { all: boolFlag(flags, 'all') });
-      const keys = new Set(stacks.map(collectionKey));
-      for (const e of draft.app.collection) {
-        if (!keys.has(collectionKey(e))) continue;
-        const tags = new Set((e.tags || []).map(normalizeTag).filter(Boolean));
-        if (op === 'add') tags.add(tag); else tags.delete(tag);
-        e.tags = [...tags];
-      }
-      return { tagged: stacks.length, op, tag };
-    }, { dryRun: boolFlag(flags, 'dry-run') });
-
-    persistUndo(result);
-    printWrite(out, result, () => out.info(out.c.green('✓ ' + (op === 'add' ? 'tagged' : 'untagged')) + ` ${result.meta.tagged} stack(s) (${tag})`));
-    return 0;
-  },
-};

package/src/commands/writeHelpers.mjs

@@ -1,82 +0,0 @@
-import { normalizeLocation, locationKey, makeContainer } from '../../vendor/collection.js';
-import { saveUndo } from '../store.mjs';
-import { CliError } from '../errors.mjs';
-import { strFlag, intFlag } from '../args.mjs';
-
-export function requireWrite(session) {
-  if (!session.hasScope('collection.write')) {
-    throw new CliError('this session is read-only — run `bp login --write`', 3);
-  }
-}
-
-export function parseLocationFlag(value) {
-  return value ? normalizeLocation(value) : null;
-}
-
-// Build a stack selector from the card name (positional) + qualifier flags.
-export function selectorFrom(flags, nameParts) {
-  const name = (nameParts || []).join(' ').trim();
-  return {
-    name: name || null,
-    scryfallId: strFlag(flags, 'scryfall-id', 'id'),
-    set: strFlag(flags, 'set', 's'),
-    cn: strFlag(flags, 'cn'),
-    finish: strFlag(flags, 'finish'),
-    condition: strFlag(flags, 'condition', 'cond'),
-    location: parseLocationFlag(strFlag(flags, 'location', 'loc')),
-  };
-}
-
-export function matchStack(c, sel) {
-  if (sel.scryfallId && c.scryfallId !== sel.scryfallId) return false;
-  if (sel.name && !(String(c.resolvedName || c.name || '').toLowerCase().includes(sel.name.toLowerCase()))) return false;
-  if (sel.set && String(c.setCode || '').toLowerCase() !== sel.set.toLowerCase()) return false;
-  if (sel.cn && String(c.cn) !== String(sel.cn)) return false;
-  if (sel.finish && c.finish !== sel.finish) return false;
-  if (sel.condition && c.condition !== sel.condition) return false;
-  if (sel.location && locationKey(c.location) !== locationKey(sel.location)) return false;
-  return true;
-}
-
-export function findStacks(collection, sel) {
-  return (collection || []).filter(c => matchStack(c, sel));
-}
-
-// Resolve a selector to exactly one stack unless `all`, with a helpful
-// disambiguation error listing the candidates.
-export function requireStacks(collection, sel, { all = false } = {}) {
-  if (!sel.name && !sel.scryfallId && !sel.set) throw new CliError('specify a card (name, or --set/--cn, or --scryfall-id)');
-  const stacks = findStacks(collection, sel);
-  if (!stacks.length) throw new CliError('no matching card in your collection');
-  if (stacks.length > 1 && !all) {
-    const lines = stacks.slice(0, 10).map(c =>
-      `  ${c.resolvedName || c.name} · ${(c.setCode || '').toUpperCase()} ${c.cn} · ${c.finish} · ${c.condition} · ${locationKey(c.location) || '—'}`);
-    throw new CliError(`${stacks.length} stacks match — narrow with --set/--cn/--finish/--condition/--location, or pass --all:\n${lines.join('\n')}`);
-  }
-  return stacks;
-}
-
-export function ensureContainer(draft, location) {
-  if (!location) return;
-  const key = location.type + ':' + location.name;
-  if (!draft.app.containers) draft.app.containers = {};
-  if (!draft.app.containers[key]) draft.app.containers[key] = makeContainer({ type: location.type, name: location.name });
-}
-
-export function persistUndo(result) {
-  if (result?.undo && !result.dryRun && !result.noop) saveUndo(result.undo);
-}
-
-export function printWrite(out, result, humanFn) {
-  if (result.noop) { out.emit({ changed: false }, () => out.info('no change.')); return; }
-  if (result.dryRun) {
-    out.emit(
-      { dryRun: true, ops: result.ops.length, opTypes: result.ops.map(o => o.type) },
-      () => out.info(out.c.dim(`dry run — ${result.ops.length} op(s): ${result.ops.map(o => o.type).join(', ')}`)),
-    );
-    return;
-  }
-  out.emit({ changed: true, revision: result.revision, ops: result.ops.length, ...(result.meta || {}) }, humanFn);
-}
-
-export { intFlag };

package/src/scryfall.mjs

@@ -1,81 +0,0 @@
-// Direct Scryfall lookups for resolving printings on `add` and `import`.
-// Direct (not via the server's MCP tool) so bulk imports aren't throttled by the
-// worker's 60/60s MCP limit; we apply our own polite delay instead. Scryfall is
-// already the product's card-data source.
-import { VERSION } from './constants.mjs';
-import { getUsdPrice } from '../vendor/collection.js';
-import { CliError } from './errors.mjs';
-
-const SCRYFALL = 'https://api.scryfall.com';
-const USER_AGENT = `biblioplex-cli/${VERSION} (+https://biblioplex.bensonperry.com)`;
-
-export const sleep = (ms) => new Promise(r => setTimeout(r, ms));
-
-async function sfGet(path, fetchImpl) {
-  const res = await fetchImpl(SCRYFALL + path, { headers: { 'User-Agent': USER_AGENT, Accept: 'application/json' } });
-  if (res.status === 404) return null;
-  const data = await res.json().catch(() => ({}));
-  if (res.status === 429) throw new CliError('scryfall rate limit — slow down and retry', 4);
-  if (!res.ok) throw new CliError('scryfall error: ' + (data.details || res.status));
-  return data;
-}
-
-export function getById(id, fetchImpl = fetch) {
-  return sfGet('/cards/' + encodeURIComponent(id), fetchImpl);
-}
-
-export function getBySetCn(set, cn, fetchImpl = fetch) {
-  return sfGet(`/cards/${encodeURIComponent(String(set).toLowerCase())}/${encodeURIComponent(cn)}`, fetchImpl);
-}
-
-export function getByName(name, { set, fetchImpl = fetch } = {}) {
-  const q = new URLSearchParams({ fuzzy: name });
-  if (set) q.set('set', String(set).toLowerCase());
-  return sfGet('/cards/named?' + q.toString(), fetchImpl);
-}
-
-// Resolve the most specific identifier available to a Scryfall card object.
-export async function resolvePrinting({ scryfallId, set, cn, name, fetchImpl = fetch }) {
-  let card = null;
-  if (scryfallId) card = await getById(scryfallId, fetchImpl);
-  else if (set && cn) card = await getBySetCn(set, cn, fetchImpl);
-  else if (name) card = await getByName(name, { set, fetchImpl });
-  if (!card || card.object === 'error') return null;
-  return card;
-}
-
-// Map a Scryfall card to the resolved-field shape normalizeCollectionEntry
-// expects (handles double-faced cards for colors/image/oracle).
-export function cardToFields(card, finish = 'normal') {
-  const faces = Array.isArray(card.card_faces) ? card.card_faces : [];
-  const front = faces[0] || {};
-  const back = faces[1];
-  const colors = card.colors ?? (faces.length ? [...new Set(faces.flatMap(f => f.colors || []))] : []);
-  // Match the web app's resolution: join faces with " // " and use getUsdPrice
-  // (which falls back to the non-foil price for foil/etched when the exact-finish
-  // price is missing, setting priceFallback).
-  const oracleText = card.oracle_text ?? (faces.length ? faces.map(f => f.oracle_text || '').join(' // ') : '');
-  const typeLine = card.type_line || (faces.length ? faces.map(f => f.type_line || '').filter(Boolean).join(' // ') : '') || '';
-  const { price, fallback } = getUsdPrice(card, finish);
-  return {
-    scryfallId: card.id,
-    setCode: card.set,
-    setName: card.set_name,
-    cn: card.collector_number,
-    name: card.name,
-    rarity: card.rarity,
-    cmc: card.cmc,
-    colors,
-    colorIdentity: card.color_identity || [],
-    typeLine,
-    oracleText,
-    legalities: card.legalities || {},
-    finishes: card.finishes || [],
-    imageUrl: card.image_uris?.normal || front.image_uris?.normal || null,
-    backImageUrl: back?.image_uris?.normal || null,
-    resolvedName: card.name,
-    scryfallUri: card.scryfall_uri || null,
-    price,
-    priceFallback: fallback,
-  };
-}

package/src/snapshot.mjs

@@ -1,77 +0,0 @@
-// Read-side helpers over a bootstrap snapshot, reusing the app's search core.
-import { tokenizeSearch, matchSearch, passesMultiselectFilters, compareCards } from '../vendor/searchCore.js';
-import { locationKey } from '../vendor/collection.js';
-
-export function emptySnapshot() {
-  return {
-    app: { schemaVersion: 1, collection: [], containers: {}, ui: { selectedFormat: '' } },
-    history: [],
-    shares: [],
-  };
-}
-
-export function collectionOf(snapshot) {
-  return snapshot?.app?.collection || [];
-}
-
-export function containersOf(snapshot) {
-  return snapshot?.app?.containers || {};
-}
-
-// Filter + sort a collection with the exact app grammar and sort order.
-export function runQuery(collection, query = '', { sort = 'name', dir = 'asc', filters = {} } = {}) {
-  const tokens = tokenizeSearch(query || '');
-  const filtered = (collection || []).filter(c => matchSearch(c, tokens) && passesMultiselectFilters(c, filters));
-  const sign = dir === 'desc' ? -1 : 1;
-  return [...filtered].sort((a, b) => sign * compareCards(a, b, sort));
-}
-
-// Parse a container reference like "deck:breya", "breya", or "binder:rares".
-// Returns { type, name } where type may be null if unqualified.
-export function parseContainerRef(ref) {
-  const m = String(ref || '').trim().match(/^(deck|container|binder|box)\s*[:]\s*(.+)$/i);
-  if (m) {
-    const t = m[1].toLowerCase();
-    return { type: t === 'deck' ? 'deck' : 'container', name: m[2].trim().toLowerCase() };
-  }
-  return { type: null, name: String(ref || '').trim().toLowerCase() };
-}
-
-export function listContainers(snapshot, type = null) {
-  const containers = Object.values(containersOf(snapshot));
-  const collection = collectionOf(snapshot);
-  return containers
-    .filter(c => !type || c.type === type)
-    .map(c => {
-      const key = c.type + ':' + c.name;
-      const cards = collection.filter(card => locationKey(card.location) === key);
-      const stats = summarize(cards);
-      return { type: c.type, name: c.name, unique: stats.unique, total: stats.total, value: stats.value, meta: c.deck || null };
-    })
-    .sort((a, b) => a.type.localeCompare(b.type) || a.name.localeCompare(b.name));
-}
-
-export function findContainer(snapshot, ref) {
-  const { type, name } = parseContainerRef(ref);
-  const containers = Object.values(containersOf(snapshot));
-  const matches = containers.filter(c => c.name === name && (!type || c.type === type));
-  return { matches, type, name };
-}
-
-export function containerCards(snapshot, container) {
-  const key = container.type + ':' + container.name;
-  return collectionOf(snapshot).filter(card => locationKey(card.location) === key);
-}
-
-export function summarize(collection) {
-  let unique = 0;
-  let total = 0;
-  let value = 0;
-  for (const c of collection || []) {
-    unique += 1;
-    const qty = parseInt(c.qty, 10) || 0;
-    total += qty;
-    if (typeof c.price === 'number') value += c.price * qty;
-  }
-  return { unique, total, value: Math.round(value * 100) / 100 };
-}

package/vendor/README.md

@@ -1,20 +0,0 @@
-# vendor/
-
-Generated by `scripts/sync-vendor.mjs` — do not edit by hand.
-
-These files are byte-identical copies of the biblioplex web app modules the
-CLI reuses (search grammar, CSV adapters, collection model, sync op diffing,
-deck export). The web app is the source of truth; re-run `npm run sync-vendor`
-after changing any of them.
-
-Vendored modules:
-- adapters.js
-- collection.js
-- deckExport.js
-- importMerge.js
-- importParsing.js
-- portableArchive.js
-- searchCore.js
-- state.js
-- storageSchema.js
-- syncOps.js