logomarks 1.0.0 → 2.0.0

package/CHANGELOG.md

@@ -5,6 +5,50 @@ All notable changes to `logomarks` are documented here.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [Unreleased]
+
+## [2.0.0] — 2026-11-07
+
+### Changed
+
+- **Breaking: the set is fetched, not bundled.** The package no longer ships the marks (`data/index.bin`, 3 MB). On
+  first use the CLI and the MCP server download the set from `https://logomarks.ai/cli/index.bin`, check it against
+  the manifest's sha256 (`/cli/index.json`), and cache it in the user cache folder (`$XDG_CACHE_HOME/logomarks`,
+  `~/Library/Caches/logomarks` on macOS, `%LOCALAPPDATA%\logomarks\Cache` on Windows, `~/.cache/logomarks`
+  elsewhere). The first run needs the network; after that it works offline. A new drop on the site reaches the CLI
+  without a new release: the manifest is checked at most once a day. The package is about 470 kB (from 3.5 MB).
+- **Breaking: library use.** Call `await ensureIndex()` before the functions that read the live set (`findMarks`,
+  `similar`, `sheet`, `loadMark` by slug …); without it `loadIndex()` reads `LOGOMARKS_INDEX` or the cache, and throws
+  an `IndexError` when there's neither. `writeIndex` takes a file (there's no bundled path, `INDEX_FILE`, any more).
+- **Node 22 or later** (global `fetch`).
+
+### Added
+
+- **`logomarks update`** downloads the latest set now.
+- **`--offline`** on every command, and `LOGOMARKS_OFFLINE=1`: the cache alone, never the network. `LOGOMARKS_INDEX`
+  uses a local index file; `LOGOMARKS_INDEX_URL` downloads from elsewhere.
+- **A format version** in the index's manifest and header (`INDEX_FORMAT`, 3): a CLI refuses a format it doesn't read
+  and says to update, so it never misreads a newer file.
+- **Clear errors** (`IndexError`, with a `code`): no network and nothing cached, offline with nothing cached, a bad
+  checksum (nothing is saved), a newer format. With a cached set, a failed check warns and uses the cache.
+- **`buildIndex`**, which builds the index and its manifest (the site serves them), `ensureIndex`, `cacheDir`,
+  `encodeIndex` and `decodeIndex`, with TypeScript declarations. Docs: `docs/data.md`.
+
+## [1.1.0] — 2026-11-07
+
+### Added
+
+- **Drops 20–25.** The bundled index holds 4,115 marks (from 3,797): font editions, the future-industries round
+  (cybersecurity, data centres, smart home, quantum, longevity, hydrogen, carbon removal, circular economy, vertical
+  farming, battery storage), wellness and Thailand. `find` reaches the ten new industry pages.
+- **Find by subject.** The bundled index carries each mark's `subject` (what it depicts: letter, animal, food-drink …),
+  and `find` matches its label words as the site does ("buildings", "food").
+
+### Changed
+
+- **On `@logomarks/core` ^0.1.8:** shape tags (round, square, wide, tall, symmetric, radial, solid, light) are measured
+  from each mark's geometry, so `find round` and the shape filters agree with the site.
+
 ## [1.0.0] — 2026-11-06
 
 The first public release (0.2.0 was never published).

package/README.md

@@ -1,6 +1,6 @@
 # logomarks
 
-Find, check, edit and build on free geometric logomarks from the command line or an AI agent. The [Logomarks](https://logomarks.ai) set is bundled (CC0, searched offline); the CLI checks marks against the set's house rules, edits and glitches them, and builds a brand kit, social pack, mockups and covers. It also runs as an MCP server. Pure JavaScript (resvg in WebAssembly), no native binaries, Node 20 or later.
+Find, check, edit and build on free geometric logomarks from the command line or an AI agent. It searches the [Logomarks](https://logomarks.ai) set (CC0), checks marks against the set's house rules, edits and glitches them, and builds a brand kit, social pack, mockups and covers. It also runs as an MCP server. Pure JavaScript (resvg in WebAssembly), no native binaries, Node 22 or later.
 
 ```bash
 npx logomarks find coffee
@@ -19,7 +19,14 @@ npx logomarks kit hex-gem --name "Hexa Labs" --color '#ff5c3a' -o hexa/
 npx logomarks mockup hex-gem --name "Hexa Labs" --object card -o card.png
 ```
 
-Also `specks`, `sheet`, `parts`, `combine`, `social`, `cover` and `mcp`. Run `logomarks --help` for the list and `logomarks <command> --help` for a command's options. A mark is a live slug or name, or the path to your own `.svg`. Every edit comes back fitted to the grid and checked. Every command takes `--json`. Exit codes: 0 ok, 1 a check failed or the command failed, 2 usage.
+Also `specks`, `sheet`, `parts`, `combine`, `social`, `cover`, `mcp` and `update`. Run `logomarks --help` for the list and `logomarks <command> --help` for a command's options. A mark is a live slug or name, or the path to your own `.svg`. Every edit comes back fitted to the grid and checked. Every command takes `--json`. Exit codes: 0 ok, 1 a check failed or the command failed, 2 usage.
+
+## The set
+
+The marks aren't in the package. On first use the CLI downloads the set from logomarks.ai (about 3 MB, checked by
+sha256) and caches it in your user cache folder (`~/.cache/logomarks`, `~/Library/Caches/logomarks` on macOS). It looks
+for a newer set at most once a day; `logomarks update` checks now, and `--offline` (or `LOGOMARKS_OFFLINE=1`) uses the
+cache alone. See [the live set](docs/data.md).
 
 ## AI agents
 
@@ -49,6 +56,7 @@ codex mcp add logomarks -- npx -y logomarks mcp
 - [Editing](docs/editing.md): glitch presets, edit ops and combining.
 - [MCP tools](docs/mcp.md): each tool, its arguments and what it returns.
 - [API](docs/api.md): the functions behind them, for use as a library.
+- [The live set](docs/data.md): where the marks come from, the cache, offline use and the environment variables.
 
 Built on [`@logomarks/core`](https://github.com/Logomarks/core), [`@logomarks/editor`](https://github.com/Logomarks/editor), [`@logomarks/brand-kit`](https://github.com/Logomarks/brand-kit), [`@logomarks/mockups`](https://github.com/Logomarks/mockups) and [`@arraypress/covers`](https://github.com/arraypress/covers).
 

package/docs/api.md

@@ -1,10 +1,14 @@
 # API
 
 ```js
-import { check, glitchMark, kit } from 'logomarks';
+import { ensureIndex, findMarks, check, glitchMark, kit } from 'logomarks';
 import { createServer, TOOLS } from 'logomarks/mcp';
+
+await ensureIndex(); // the live set: cached, or downloaded from logomarks.ai
 ```
 
+Call `ensureIndex()` once before anything that reads the live set (`findMarks`, `similar`, `sheet`, `loadMark` by slug …).
+
 | Export | |
 |---|---|
 | `check(svg, { name, ignore, strict })` | `{ ok, errors, warnings, notes, size, findings }`. |
@@ -13,6 +17,9 @@ import { createServer, TOOLS } from 'logomarks/mcp';
 | `sheet([{ name, svg }])` | `{ png, svg, marks }`. |
 | `findMarks(query, { style, tags, industry, letter, limit })`, `facets()` | `{ total, marks }`; the filters' values. |
 | `fitMark(svg)`, `loadIndex()`, `FINDINGS`, `rules` | The fitter, the live set, every finding id, the house rules. |
+| `ensureIndex({ force, offline, url, dir, maxAge, timeout, warn })` | `{ file, source, checked, manifest }`: the live set, cached or downloaded and verified. Throws an `IndexError` (`code`: `network`, `offline`, `checksum`, `format`, `missing`). |
+| `cacheDir()`, `DEFAULT_INDEX_URL`, `INDEX_FORMAT` | Where it's cached, where it's from, the format this version reads. |
+| `buildIndex({ marks, search })`, `encodeIndex`, `decodeIndex` | `{ bytes, manifest }`: the index as the site builds it; the format both ways. |
 | `loadMark(ref)`, `paint(svg, color)`, `markPng(svg, { size, color })` | A mark by slug, name or file; as a file in a colour; as a PNG. |
 | `glitchMark(svg, { preset, angle, place, slide, gap, cuts, seed })` | `{ svg, checks, glitch }`. |
 | `editMark(svg, ops)`, `markParts(svg)` | `{ svg, checks, parts }`; the parts by index. |
@@ -28,4 +35,4 @@ import { createServer, TOOLS } from 'logomarks/mcp';
 
 The palette, lockups and artwork are [`@logomarks/brand-kit`](https://github.com/Logomarks/brand-kit)'s (`palette`, `lockup`, `artwork`), and the edits are [`@logomarks/editor`](https://github.com/Logomarks/editor)'s.
 
-The live set is bundled (`data/index.bin`: each mark's SVG, tags, style, mood, description and industries, and its signatures; rebuilt with `npm run index`). The marks are CC0. The typefaces (IBM Plex Mono for labels; Inter, Space Grotesk, Instrument Sans, Bricolage Grotesque, Instrument Serif, and for restaurants Fraunces, Cagliostro, Limelight and Shrikhand, for names) are SIL OFL, in `data/fonts/` (`OFL.txt`; `scripts/fonts.js` writes them): latin subsets, except the faces with a Reserved Font Name (Cagliostro, Limelight, IBM Plex Mono), bundled whole and pinned by sha256.
+The live set isn't bundled: logomarks.ai serves it (each mark's SVG, tags, style, mood, subject, description and industries, its signatures and the search), and the CLI caches it ([the live set](data.md)). The marks are CC0. The typefaces (IBM Plex Mono for labels; Inter, Space Grotesk, Instrument Sans, Bricolage Grotesque, Instrument Serif, and for restaurants Fraunces, Cagliostro, Limelight and Shrikhand, for names) are SIL OFL, in `data/fonts/` (`OFL.txt`; `scripts/fonts.js` writes them): latin subsets, except the faces with a Reserved Font Name (Cagliostro, Limelight, IBM Plex Mono), bundled whole and pinned by sha256.

package/docs/commands.md

@@ -7,12 +7,14 @@ logomarks <command> --help
 
 A `<mark>` is a live slug or name (`hex-gem`, `"Hex Gem"`) or the path to your own `.svg`, fitted to the grid first. A miss suggests the closest slugs.
 
-Every command takes `--json` (machine-readable output on stdout) and `-h, --help`. `logomarks --version` prints the version.
+Every command takes `--json` (machine-readable output on stdout), `--offline` (use the cached set only) and `-h, --help`. `logomarks --version` prints the version.
+
+The live set is downloaded from logomarks.ai on first use and cached; a newer one is looked for at most once a day. See [the live set](data.md) for the cache, offline use and the environment variables.
 
 | Exit code | Meaning |
 |---|---|
 | 0 | OK: every mark passed, or the file was written. |
-| 1 | A check failed (`check`, `similar`, `specks`, `sheet`, and an edit whose result fails a check), nothing matched (`find`), or the command failed (a file it can't read or write). |
+| 1 | A check failed (`check`, `similar`, `specks`, `sheet`, and an edit whose result fails a check), nothing matched (`find`), or the command failed (a file it can't read or write, or the live set it needs can't be had). |
 | 2 | Usage: an unknown command or option, a missing argument, or a value out of range. |
 
 Set `LOGOMARKS_DEBUG=1` to print the stack trace behind an exit 1.
@@ -22,6 +24,7 @@ Set `LOGOMARKS_DEBUG=1` to print the stack trace behind an exit 1.
 - Edit: [`parts`](#parts), [`edit`](#edit), [`glitch`](#glitch), [`combine`](#combine)
 - Build: [`kit`](#kit), [`social`](#social), [`mockup`](#mockup), [`cover`](#cover)
 - Agents: [`mcp`](#mcp)
+- The set: [`update`](#update)
 
 ## find
 
@@ -127,7 +130,7 @@ Compares outlines, rotations and mirrors included. A score of 0.72 or more is to
 |---|---|---|
 | `--top <n>` | 5 | How many matches per mark. |
 | `--letters` | off | Compare a badge's knocked-out letter instead of its outline (0.7 too close, 0.85 a near-copy). |
-| `--against <dir>` | the bundled set | Compare with a folder of SVGs instead. |
+| `--against <dir>` | the live set | Compare with a folder of SVGs instead. |
 | `--each` | off | Compare the candidates with each other too (marked `*`). |
 | `--all <data dir>` | | Write every mark's 8 nearest for a whole set ("More like this"), from its `marks.json`, `descriptions.json` and `svg/`. |
 | `-o, --out <file>` | stdout | Where `--all` writes. |
@@ -410,3 +413,16 @@ codex mcp add logomarks -- npx -y logomarks mcp
 ```
 
 PNGs are drawn by resvg in WebAssembly, so nothing needs `sharp` or a native build.
+
+## update
+
+Download the latest set now, rather than waiting for the daily check.
+
+```
+logomarks update
+```
+
+It asks logomarks.ai for the manifest and downloads the index when its sha256 differs from the cached one, checked
+before it's saved. With `--json`: `{ source, file, format, built, marks, bytes, sha256 }`, where `source` is `download`,
+`cache` (already up to date) or `file` (`LOGOMARKS_INDEX` is set). Exit 1 when the set can't be had, or with
+`--offline`.

package/docs/data.md

@@ -0,0 +1,84 @@
+# The live set
+
+The Logomarks set isn't in the package. logomarks.ai serves it, as one index of every live mark (its SVG, name, tags,
+style, mood, subject, description, industries, similarity signatures and the site's search), about 3 MB:
+
+- `https://logomarks.ai/cli/index.bin`: the index;
+- `https://logomarks.ai/cli/index.json`: its manifest, `{ format, marks, letters, bytes, sha256, built }`.
+
+The marks are CC0. The site rebuilds both with every deploy, so a new drop reaches the CLI without a new release.
+
+## Download and cache
+
+The first command that can use the set (every one but `check`, `specks` and `update`; the MCP server as it starts)
+downloads it, checks its size and sha256 against the manifest, and caches it:
+
+| Platform | Cache folder |
+|---|---|
+| Any, with `XDG_CACHE_HOME` set | `$XDG_CACHE_HOME/logomarks` |
+| macOS | `~/Library/Caches/logomarks` |
+| Windows | `%LOCALAPPDATA%\logomarks\Cache` |
+| Linux and the rest | `~/.cache/logomarks` |
+
+The folder holds `index.bin` and `index.json` (the manifest it matched, its URL and when it was last checked). Delete
+the folder to start over.
+
+After that, every command uses the cache. At most once a day it asks for the manifest again, and downloads the index
+only when its sha256 has changed. `logomarks update` asks now.
+
+When the set can't be had, commands that only read your own files (`check`, `specks`, and `parts`, `edit`, `glitch`
+and the rest given an `.svg`) still run. Commands that need a live mark (`find`, `get hex-gem`, `similar`, `sheet` …)
+fail with the reason.
+
+## Offline
+
+`--offline` (any command) or `LOGOMARKS_OFFLINE=1` uses the cache alone, never the network. With nothing cached, the
+command says so: run `logomarks update` once online.
+
+When the site can't be reached, or sends a file that doesn't match its manifest, a command with a cached set warns and
+uses the cache. `logomarks update` fails instead.
+
+## Environment
+
+| Variable | |
+|---|---|
+| `LOGOMARKS_OFFLINE=1` | Use the cache alone (as `--offline`). |
+| `LOGOMARKS_INDEX=<file>` | Use this index file: no network, no cache (for tests, CI and air-gapped machines). |
+| `LOGOMARKS_INDEX_URL=<url>` | Download the index from here instead; the manifest is `index.json` beside it. |
+| `XDG_CACHE_HOME` | Where the cache folder goes. |
+
+## Errors
+
+Each comes as one line naming the command, exit 1 (an `IndexError` with a `code`, from the library):
+
+| Code | When |
+|---|---|
+| `network` | The site couldn't be reached or answered with an error, and nothing is cached. |
+| `offline` | Offline with nothing cached, or `update` run offline. |
+| `checksum` | The download didn't match the manifest's size or sha256. Nothing was saved. |
+| `format` | The site serves a newer index format than this version reads: update logomarks. |
+| `missing` | `LOGOMARKS_INDEX` names no file, or a library call came before `ensureIndex()`. |
+
+## Format
+
+The index carries a format version (`INDEX_FORMAT`, now 3), in its manifest and in its own header. A CLI checks both,
+and refuses a format it doesn't read, so an old CLI never misreads a newer file. A change to the layout bumps the
+version. The site must then keep serving the old format where old CLIs look for it, or they keep their cache and warn.
+
+## In code
+
+```js
+import { ensureIndex, findMarks } from 'logomarks';
+
+await ensureIndex();            // cached, or downloaded; { file, source, checked, manifest }
+findMarks('coffee');            // and every other function that reads the set
+```
+
+`ensureIndex({ force, offline, url, dir, maxAge, timeout, warn })` takes the same choices as the CLI. Without it,
+`loadIndex()` reads `LOGOMARKS_INDEX` or the cache, and throws an `IndexError` when neither exists.
+
+## Building it
+
+`buildIndex({ marks, search })` builds the index and its manifest from the Logomarks data. The site calls it at build
+time; in the Logomarks monorepo, `npm run index` writes `data/index.bin` for the tests, which read it through
+`LOGOMARKS_INDEX`.

package/docs/mcp.md

@@ -1,6 +1,6 @@
 # MCP tools
 
-`logomarks mcp` runs the CLI's functions as MCP tools on stdio, locally: nothing leaves the machine. Relative paths resolve against the server's working folder (the project the agent is in). The renderer, the typefaces and the live set load once and stay warm.
+`logomarks mcp` runs the CLI's functions as MCP tools on stdio, locally: nothing leaves the machine. Relative paths resolve against the server's working folder (the project the agent is in). The renderer, the typefaces and the live set load once and stay warm. The live set is the CLI's: downloaded from logomarks.ai on first use and cached (see [the live set](data.md)); every tool call waits for it, and `logomarks mcp --offline` uses the cache alone.
 
 ```bash
 claude mcp add logomarks -- npx -y logomarks mcp        # Claude Code
@@ -38,8 +38,8 @@ Every argument is described, with its type, choices and default, in the tool's i
 
 ## Annotations
 
-`find_marks`, `similar_marks` and `list_parts` are read-only. `check_mark` (with `fix`), `build_brand_kit` and `build_social_pack` are marked destructive: they rewrite files in place or replace files in a folder. The other tools write only when given `out`, and replace that file. No tool reaches the network (`openWorldHint: false`).
+`find_marks`, `similar_marks` and `list_parts` are read-only. `check_mark` (with `fix`), `build_brand_kit` and `build_social_pack` are marked destructive: they rewrite files in place or replace files in a folder. The other tools write only when given `out`, and replace that file. No tool reaches the network (`openWorldHint: false`); only the server does, to fetch the live set.
 
 ## Errors
 
-A tool that fails returns a tool error (`isError`) with a message to act on: a missing mark comes with the closest slugs, an unknown part with how many the mark has, a missing file with its path.
+A tool that fails returns a tool error (`isError`) with a message to act on: a missing mark comes with the closest slugs, an unknown part with how many the mark has, a missing file with its path, and a live set that can't be had with the reason (no network and nothing cached, a bad checksum, a newer format).

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "logomarks",
-  "version": "1.0.0",
-  "description": "Find, check, edit and build on free geometric logomarks from the command line or an AI agent: search the CC0 Logomarks set, check marks against its house rules, edit and glitch them, and build a brand kit, social pack, mockups and covers. Includes an MCP server.",
+  "version": "2.0.0",
+  "description": "Find, check, edit and build on free geometric logomarks from the command line or an AI agent: search the CC0 Logomarks set (downloaded from logomarks.ai and cached), check marks against its house rules, edit and glitch them, and build a brand kit, social pack, mockups and covers. Includes an MCP server.",
   "keywords": [
     "logo",
     "logomark",
@@ -59,17 +59,17 @@
   "files": [
     "bin",
     "src",
-    "data",
+    "data/fonts",
     "docs",
     "README.md",
     "CHANGELOG.md",
     "LICENSE"
   ],
   "engines": {
-    "node": ">=20.0.0"
+    "node": ">=22.0.0"
   },
   "scripts": {
-    "test": "node --test tests/*.test.js",
+    "test": "node --import ./tests/setup.js --test tests/*.test.js",
     "typecheck": "tsc --noEmit",
     "index": "node scripts/index.js"
   },
@@ -78,13 +78,13 @@
     "registry": "https://registry.npmjs.org/"
   },
   "dependencies": {
-    "@logomarks/brand-kit": "^0.4.1",
     "@arraypress/color-utils": "^1.5.0",
-    "@arraypress/covers": "^1.3.1",
-    "@logomarks/core": "^0.1.3",
-    "@logomarks/mockups": "^0.5.0",
+    "@arraypress/covers": "^1.8.0",
     "@arraypress/search": "^0.1.0",
+    "@logomarks/brand-kit": "^0.4.1",
+    "@logomarks/core": "^0.1.8",
     "@logomarks/editor": "^0.2.4",
+    "@logomarks/mockups": "^0.5.0",
     "@modelcontextprotocol/sdk": "1.32.1",
     "@resvg/resvg-wasm": "2.6.2",
     "zod": "4.6.7"

package/src/brand/mark.js

@@ -2,7 +2,7 @@
  * @module logomarks/brand/mark
  *
  * The mark a brand is built on: a live mark by slug or name (from the
- * bundled index), or your own SVG, fitted to the standard. Painted in a
+ * live set, ../live), or your own SVG, fitted to the standard. Painted in a
  * colour and drawn at a size.
  */
 
@@ -50,7 +50,7 @@ export const titleCase = (slug) => slug.split('-').filter(Boolean).map((w) => w[
  * A live mark by slug or name, any case.
  *
  * @param {string} ref The slug (`hex-gem`) or name (`Hex Gem`).
- * @param {import('../similar/store.js').MarkIndex} [index] The live set (the bundled index).
+ * @param {import('../similar/store.js').MarkIndex} [index] The live set (the cached index).
  * @returns {import('../similar/store.js').IndexedMark | undefined} The mark.
  */
 export function findMark(ref, index = loadIndex()) {

package/src/cli/commands/combine.d.ts

@@ -2,6 +2,8 @@ import type { ArgSpec, Parsed } from '../args.js';
 import type { IO } from '../index.js';
 import type { CommandHelp } from '../help.js';
 
+/** It reads the live set: the CLI gets it first. */
+export const live: true;
 /** What `combine` takes. */
 export const spec: ArgSpec;
 /** What `logomarks combine --help` prints. */

package/src/cli/commands/combine.js

@@ -10,6 +10,9 @@ import { UsageError } from '../args.js';
 import { markOf, numArg, asUsage } from '../options.js';
 import { output } from '../edited.js';
 
+/** It reads the live set: the CLI gets it first. */
+export const live = true;
+
 /** What `combine` takes. */
 export const spec = { flags: ['json'], options: { out: 'o', op: '', scale: '', rotate: '', flip: '', x: '', y: '' } };
 

package/src/cli/commands/cover.d.ts

@@ -2,6 +2,8 @@ import type { ArgSpec, Parsed } from '../args.js';
 import type { IO } from '../index.js';
 import type { CommandHelp } from '../help.js';
 
+/** It reads the live set: the CLI gets it first. */
+export const live: true;
 /** What `cover` takes. */
 export const spec: ArgSpec;
 /** What `logomarks cover --help` prints. */

package/src/cli/commands/cover.js

@@ -10,6 +10,9 @@ import { UsageError } from '../args.js';
 import { markArg, colorArg, intArg, writeFile } from '../options.js';
 import { style } from '../style.js';
 
+/** It reads the live set: the CLI gets it first. */
+export const live = true;
+
 /** What `cover` takes. */
 export const spec = { flags: ['json'], options: { out: 'o', recipe: '', title: '', label: '', color: '', aspect: '', width: '', seed: '' } };
 

package/src/cli/commands/edit.d.ts

@@ -2,6 +2,8 @@ import type { ArgSpec, Parsed } from '../args.js';
 import type { IO } from '../index.js';
 import type { CommandHelp } from '../help.js';
 
+/** It reads the live set: the CLI gets it first. */
+export const live: true;
 /** What `edit` takes. */
 export const spec: ArgSpec;
 /** What `logomarks edit --help` prints. */

package/src/cli/commands/edit.js

@@ -13,6 +13,9 @@ import { output } from '../edited.js';
 import { OPS } from '../../edit/ops.js';
 import { wrapList } from '../help.js';
 
+/** It reads the live set: the CLI gets it first. */
+export const live = true;
+
 /** What `edit` takes. */
 export const spec = { flags: ['json'], options: { out: 'o', ops: '' } };
 

package/src/cli/commands/find.d.ts

@@ -2,6 +2,8 @@ import type { ArgSpec, Parsed } from '../args.js';
 import type { IO } from '../index.js';
 import type { CommandHelp } from '../help.js';
 
+/** It reads the live set: the CLI gets it first. */
+export const live: true;
 /** What `find` takes. */
 export const spec: ArgSpec;
 /** What `logomarks find --help` prints. */

package/src/cli/commands/find.js

@@ -1,7 +1,7 @@
 /**
  * @module logomarks/cli/commands/find
  *
- * `logomarks find <words…>`: search the bundled live set by words, style,
+ * `logomarks find <words…>`: search the live set by words, style,
  * tags, industry or letter. With nothing to search by, the values the
  * filters take.
  */
@@ -10,6 +10,9 @@ import { findMarks, facets } from '../../find/index.js';
 import { intArg } from '../options.js';
 import { style, pad } from '../style.js';
 
+/** It reads the live set: the CLI gets it first. */
+export const live = true;
+
 /** What `find` takes. */
 export const spec = { flags: ['json'], options: { style: '', tag: '', industry: '', letter: '', top: '' } };
 

package/src/cli/commands/get.d.ts

@@ -2,6 +2,8 @@ import type { ArgSpec, Parsed } from '../args.js';
 import type { IO } from '../index.js';
 import type { CommandHelp } from '../help.js';
 
+/** It reads the live set: the CLI gets it first. */
+export const live: true;
 /** What `get` takes. */
 export const spec: ArgSpec;
 /** What `logomarks get --help` prints. */

package/src/cli/commands/get.js

@@ -1,7 +1,7 @@
 /**
  * @module logomarks/cli/commands/get
  *
- * `logomarks get <slug|name>`: a live mark's SVG (from the bundled index) to
+ * `logomarks get <slug|name>`: a live mark's SVG (from the live set) to
  * stdout or a file, in a colour, or a PNG at a size.
  */
 
@@ -10,6 +10,9 @@ import { UsageError } from '../args.js';
 import { markArg, colorArg, intArg, writeFile } from '../options.js';
 import { style } from '../style.js';
 
+/** It reads the live set: the CLI gets it first. */
+export const live = true;
+
 /** What `get` takes. */
 export const spec = { flags: ['json'], options: { out: 'o', color: '', size: '', format: '' } };
 

package/src/cli/commands/glitch.d.ts

@@ -2,6 +2,8 @@ import type { ArgSpec, Parsed } from '../args.js';
 import type { IO } from '../index.js';
 import type { CommandHelp } from '../help.js';
 
+/** It reads the live set: the CLI gets it first. */
+export const live: true;
 /** What `glitch` takes. */
 export const spec: ArgSpec;
 /** What `logomarks glitch --help` prints. */

package/src/cli/commands/glitch.js

@@ -10,6 +10,9 @@ import { UsageError } from '../args.js';
 import { markArg, numArg, intArg, asUsage } from '../options.js';
 import { output } from '../edited.js';
 
+/** It reads the live set: the CLI gets it first. */
+export const live = true;
+
 /** What `glitch` takes. */
 export const spec = { flags: ['json'], options: { out: 'o', preset: '', angle: '', place: '', slide: '', gap: '', cuts: '', seed: '' } };
 

package/src/cli/commands/index.d.ts

@@ -1,5 +1,5 @@
 import type { ArgSpec, Parsed } from '../args.js';
-import type { IO } from '../index.js';
+import type { IO, RunContext } from '../index.js';
 import type { CommandHelp } from '../help.js';
 
 /** A verb: the arguments it takes and how it runs. */
@@ -7,9 +7,11 @@ export interface Command {
 	spec: ArgSpec;
 	/** What `logomarks <verb> --help` prints. */
 	help: CommandHelp;
+	/** Whether it may read the live set: the CLI gets the set (cached or downloaded) before running it. */
+	live?: boolean;
 	/** Runs the verb and resolves to its exit code (0 pass, 1 fail). */
-	run(args: Parsed, io: IO): Promise<number>;
+	run(args: Parsed, io: IO, ctx?: RunContext): Promise<number>;
 }
 
 /** Every verb the CLI runs. */
-export const COMMANDS: Readonly<Record<'check' | 'similar' | 'specks' | 'sheet' | 'find' | 'parts' | 'glitch' | 'edit' | 'combine' | 'get' | 'kit' | 'social' | 'mockup' | 'cover' | 'mcp', Command>>;
+export const COMMANDS: Readonly<Record<'check' | 'similar' | 'specks' | 'sheet' | 'find' | 'parts' | 'glitch' | 'edit' | 'combine' | 'get' | 'kit' | 'social' | 'mockup' | 'cover' | 'mcp' | 'update', Command>>;

package/src/cli/commands/index.js

@@ -19,6 +19,7 @@ import * as combine from './combine.js';
 import * as social from './social.js';
 import * as find from './find.js';
 import * as mcp from './mcp.js';
+import * as update from './update.js';
 
 /** Every verb the CLI runs. */
-export const COMMANDS = { check, similar, specks, sheet, find, parts, glitch, edit, combine, get, kit, social, mockup, cover, mcp };
+export const COMMANDS = { check, similar, specks, sheet, find, parts, glitch, edit, combine, get, kit, social, mockup, cover, mcp, update };

package/src/cli/commands/kit.d.ts

@@ -2,6 +2,8 @@ import type { ArgSpec, Parsed } from '../args.js';
 import type { IO } from '../index.js';
 import type { CommandHelp } from '../help.js';
 
+/** It reads the live set: the CLI gets it first. */
+export const live: true;
 /** What `kit` takes. */
 export const spec: ArgSpec;
 /** What `logomarks kit --help` prints. */

package/src/cli/commands/kit.js

@@ -14,6 +14,9 @@ import { FONTS } from '../../brand/fonts.js';
 import { STYLE_IDS, DEFAULT_STYLES } from '@logomarks/brand-kit';
 import { wrapList } from '../help.js';
 
+/** It reads the live set: the CLI gets it first. */
+export const live = true;
+
 /** What `kit` takes. */
 export const spec = { flags: ['json', 'animated', 'no-social'], options: { out: 'o', name: '', color: '', font: '', tagline: '', url: '', handle: '', styles: '', platforms: '' } };
 

package/src/cli/commands/mcp.d.ts

@@ -1,4 +1,5 @@
-import type { ArgSpec } from '../args.js';
+import type { ArgSpec, Parsed } from '../args.js';
+import type { IO, RunContext } from '../index.js';
 import type { CommandHelp } from '../help.js';
 
 /** What `mcp` takes: nothing. */
@@ -6,4 +7,4 @@ export const spec: ArgSpec;
 /** What `logomarks mcp --help` prints. */
 export const help: CommandHelp;
 /** Starts the MCP server on stdio; resolves to 0 once it is connected. */
-export function run(): Promise<number>;
+export function run(args?: Parsed, io?: IO, ctx?: RunContext): Promise<number>;

package/src/cli/commands/mcp.js

@@ -14,7 +14,8 @@ export const help = {
 	summary: 'Run the MCP server on stdio, for Claude Code, Codex, Cursor and other agents.',
 	usage: [''],
 	about: [
-		'Every verb as an MCP tool, run locally; nothing leaves the machine. Add it to an agent:',
+		'Every verb as an MCP tool, run locally; nothing leaves the machine (the set itself is downloaded',
+		'from logomarks.ai on first use and cached). Add it to an agent:',
 		'  claude mcp add logomarks -- npx -y logomarks mcp',
 		'  codex mcp add logomarks -- npx -y logomarks mcp',
 		'Or install the Claude Code plugin, which adds the skills too:',
@@ -27,10 +28,13 @@ export const help = {
 /**
  * Runs `mcp`: starts the server and returns; the process lives until the client hangs up.
  *
+ * @param {import('../args.js').Parsed} [_args] The parsed arguments (none).
+ * @param {import('../index.js').IO} [_io] Where output goes (unused: stdout is the protocol's).
+ * @param {import('../index.js').RunContext} [ctx] Whether `--offline` was given.
  * @returns {Promise<number>} The exit code: 0.
  */
-export async function run() {
+export async function run(_args, _io, { offline } = {}) {
 	const { serve } = await import('../../mcp/index.js');
-	await serve();
+	await serve({ offline });
 	return 0;
 }

package/src/cli/commands/mockup.d.ts

@@ -2,6 +2,8 @@ import type { ArgSpec, Parsed } from '../args.js';
 import type { IO } from '../index.js';
 import type { CommandHelp } from '../help.js';
 
+/** It reads the live set: the CLI gets it first. */
+export const live: true;
 /** What `mockup` takes. */
 export const spec: ArgSpec;
 /** What `logomarks mockup --help` prints. */

package/src/cli/commands/mockup.js

@@ -12,6 +12,9 @@ import { style } from '../style.js';
 import { FONTS } from '../../brand/fonts.js';
 import { wrapList } from '../help.js';
 
+/** It reads the live set: the CLI gets it first. */
+export const live = true;
+
 /** What `mockup` takes. */
 export const spec = { flags: ['json'], options: { out: 'o', object: '', name: '', color: '', font: '', layout: '', surface: '', view: '', base: '', size: '', seed: '' } };
 

package/src/cli/commands/parts.d.ts

@@ -2,6 +2,8 @@ import type { ArgSpec, Parsed } from '../args.js';
 import type { IO } from '../index.js';
 import type { CommandHelp } from '../help.js';
 
+/** It reads the live set: the CLI gets it first. */
+export const live: true;
 /** What `parts` takes. */
 export const spec: ArgSpec;
 /** What `logomarks parts --help` prints. */

package/src/cli/commands/parts.js

@@ -10,6 +10,9 @@ import { partsPreview } from '../../edit/preview.js';
 import { markArg, writeFile } from '../options.js';
 import { style, pad } from '../style.js';
 
+/** It reads the live set: the CLI gets it first. */
+export const live = true;
+
 /** What `parts` takes. */
 export const spec = { flags: ['json'], options: { out: 'o' } };
 

package/src/cli/commands/sheet.d.ts

@@ -2,6 +2,8 @@ import type { ArgSpec, Parsed } from '../args.js';
 import type { IO } from '../index.js';
 import type { CommandHelp } from '../help.js';
 
+/** It reads the live set: the CLI gets it first. */
+export const live: true;
 /** What `sheet` takes. */
 export const spec: ArgSpec;
 /** What `logomarks sheet --help` prints. */