logomarks 0.0.0-stage → 1.1.0

package/docs/commands.md

@@ -0,0 +1,412 @@
+# Commands
+
+```
+logomarks <command> [arguments] [options]
+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.
+
+| 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). |
+| 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.
+
+- Find and get: [`find`](#find), [`get`](#get)
+- Check: [`check`](#check), [`similar`](#similar), [`specks`](#specks), [`sheet`](#sheet)
+- Edit: [`parts`](#parts), [`edit`](#edit), [`glitch`](#glitch), [`combine`](#combine)
+- Build: [`kit`](#kit), [`social`](#social), [`mockup`](#mockup), [`cover`](#cover)
+- Agents: [`mcp`](#mcp)
+
+## find
+
+Search the live set by words, style, tag, industry or letter.
+
+```
+logomarks find <words…> [options]
+logomarks find [options]
+```
+
+It searches as logomarks.ai does: every word must match a mark's name, search words, industries, style, tags, mood, letter or description (synonyms, plurals, and UK and US trade names included), and the best fits come first. With no words or filters it lists every style, tag, mood and industry, with counts.
+
+| Option | Default | |
+|---|---|---|
+| `--style <style>` | | One style: `bold`, `badge`, `letter`, `monogram`, `animal`, `iso`, `grid`, `glitch`, `line`, `modular`, `woven`, `detailed`, `inflated`, `organic`, `glyph`. |
+| `--tag <tags>` | | Tags a mark must all have, comma-separated: `round`, `square`, `symmetric`, `radial`, `solid`, `light`, `wide`, `tall`, `letter`, `number`, `new`. |
+| `--industry <id>` | | An industry it suits, e.g. `coffee-shop`, `fintech`, `law-firm`. `logomarks find` lists them all. |
+| `--letter <char>` | | The letter or number a lettermark shows. |
+| `--top <n>` | 20 | How many marks to list (1–500). |
+
+Exit 1 when nothing matches.
+
+```bash
+logomarks find coffee
+logomarks find calm hexagon --top 5
+logomarks find --style letter --letter K --json
+```
+
+## get
+
+Get a live mark's SVG, or a PNG of any mark.
+
+```
+logomarks get <mark> [-o file] [options]
+```
+
+The SVG is 512 × 512, the mark's longest side 448, centred, filled paths in `currentColor`. Live marks are CC0. Without `-o` the SVG goes to stdout.
+
+| Option | Default | |
+|---|---|---|
+| `--color <hex>` | `currentColor` (SVG), black (PNG) | Paint it, e.g. `#ff5c3a`. |
+| `--size <px>` | 512 | A PNG this many pixels square (16–4096). |
+| `--format <svg \| png>` | from `-o`; `png` with `--size` | |
+| `-o, --out <file>` | stdout | Write `.svg` or `.png`. A PNG needs `-o`. |
+
+```bash
+logomarks get hex-gem -o logo.svg
+logomarks get "Hex Gem" --color '#ff5c3a' --size 512 -o logo.png
+```
+
+## check
+
+Check SVG marks against the house rules.
+
+```
+logomarks check <file.svg | folder>… [options]
+```
+
+Each finding has an id, a severity, a message and a box `[x0, y0, x1, y1]` on the 512 canvas. Folders are expanded to the `.svg` files in them (not recursively).
+
+| Option | Default | |
+|---|---|---|
+| `--fix` | off | Refit to the grid in place: the only automatic fix. |
+| `--strict` | off | Count warnings as failures too. |
+| `--ignore <ids>` | | Leave these finding ids out, e.g. `speck,uneven-gaps`. |
+
+| Id | Severity | |
+|---|---|---|
+| `viewbox`, `size`, `centre`, `clipped` | error | `viewBox="0 0 512 512"`, longest side 448 (±0.5), centred, nothing outside the canvas. `--fix` refits. |
+| `markup`, `empty` | error | Filled paths only: no groups, transforms, strokes, styles, masks, text or images. |
+| `speck`, `sliver`, `pinhole` | error | Pieces under 60 square units, and holes under 30, left by booleans. Touch points, hairlines and repeated dots are left out. |
+| `fill`, `precision` | warning | `currentColor`; one decimal place. `--fix` refits. |
+| `thin`, `narrow-gap` | warning | Strokes or gaps under 10 units: they vanish or close up at 32 px. |
+| `uneven-gaps` | warning | One gap width per mark (22), or a clear 1:2 ratio. |
+
+```
+✗ speck.svg  448 × 448  1 error
+    error    speck        A stray piece of 36.0 sq units.  [253, 250, 259, 256]
+! gap-10.svg  448 × 448  1 warning
+    warning  uneven-gaps  A gap 9.8 wide, against the mark's main gap of 21.8: keep one gap width (22), or a clear 1:2 ratio.  [250.6, 24.1, 261.4, 487.9]
+```
+
+Exit 1 when any mark fails.
+
+```bash
+logomarks check mark.svg
+logomarks check marks/ --fix
+logomarks check out/*.svg --strict --json
+```
+
+## similar
+
+Find the live marks nearest to yours, with scores.
+
+```
+logomarks similar <file.svg | folder>… [options]
+logomarks similar --all <data dir> [-o similar.json]
+```
+
+Compares outlines, rotations and mirrors included. A score of 0.72 or more is too close (compare the two by eye: solid shapes often share an outline); 0.9 or more is a near-copy. The same trick as an existing mark is a copy even when it scores low, so look at the matches.
+
+| Option | Default | |
+|---|---|---|
+| `--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. |
+| `--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. |
+
+Exit 1 when any mark is a near-copy.
+
+```bash
+logomarks similar mark.svg
+logomarks similar out/ --top 3 --each
+logomarks similar badge.svg --letters --json
+```
+
+## specks
+
+List every speck, sliver and pin-hole, with its box.
+
+```
+logomarks specks <file.svg | folder>… [options]
+```
+
+The set's speck review: pieces under `--piece` and holes under `--hole`, smallest first. Tiny, hairline, repeated and reviewed parts are left out unless `--all`. Render each hit large before changing anything: many small parts are meant.
+
+| Option | Default | |
+|---|---|---|
+| `--piece <area>` | 60 | Report pieces smaller than this, in square units. |
+| `--hole <area>` | 30 | Report holes smaller than this. |
+| `--allow <slugs>` | | Marks whose small parts are meant, comma-separated. |
+| `--all` | off | Report every small part, reviewed and repeated ones included. |
+| `--raster` | off | Read each mark from the scanline raster instead of its outline. |
+
+Exit 1 when anything is listed.
+
+```bash
+logomarks specks out/
+logomarks specks mark.svg --piece 80 --json
+```
+
+## sheet
+
+Draw review cards for marks, as one PNG.
+
+```
+logomarks sheet <file.svg | folder>… [-o sheet.png] [options]
+```
+
+Each card shows the mark large on dark and light with its findings boxed and numbered, at 32 and 16 px, and beside its three nearest live marks (amber: too close; red: a near-copy).
+
+| Option | Default | |
+|---|---|---|
+| `-o, --out <file.png>` | `sheet.png` | The PNG to write. |
+| `--strict` | off | Count warnings as failures too. |
+| `--ignore <ids>` | | Leave these finding ids out. |
+| `--plain` | off | A plain labelled grid instead of review cards. |
+| `--cols <n>` | 8 | Columns in the plain grid. |
+
+Exit 1 when any mark fails a check or is a near-copy.
+
+```bash
+logomarks sheet out/*.svg -o sheet.png
+logomarks sheet out/ --plain --cols 6 -o batch.png
+```
+
+## parts
+
+List a mark's parts by index, as `edit --ops` names them.
+
+```
+logomarks parts <mark> [-o parts.png]
+```
+
+Each part has its index in drawing order, its box and centre on the 512 canvas, its area (holes taken out), its holes and its tone.
+
+| Option | Default | |
+|---|---|---|
+| `-o, --out <file.png>` | | Also draw the mark with every part boxed and numbered. |
+
+```bash
+logomarks parts quad-cove
+logomarks parts mark.svg -o parts.png
+```
+
+## edit
+
+Edit a mark by part, with a list of ops.
+
+```
+logomarks edit <mark> --ops '<json>' [-o out.svg]
+logomarks edit <mark> --ops @ops.json [-o out.svg]
+```
+
+The ops run in order: `delete`, `move`, `rotate`, `scale`, `flip`, `round`, `offset`, `mirror`, `radial`, `union`, `subtract`, `color`, `tone`. Each op's settings are in [editing](editing.md). The result is fitted to the grid and checked; without `-o` the SVG goes to stdout and the checks to stderr.
+
+| Option | Default | |
+|---|---|---|
+| `--ops <json \| @file>` | required | The ops as a JSON array, or `@` and a file holding one. |
+| `-o, --out <file>` | stdout | Write `.svg`, or `.png` drawn at 512. |
+
+Exit 1 when the result fails a check.
+
+```bash
+logomarks edit quad-cove --ops '[{"op":"delete","parts":[3]},{"op":"round","radius":18}]' -o mine.svg
+logomarks edit mark.svg --ops @ops.json -o mine.png
+```
+
+## glitch
+
+Make a glitch edition of a mark: cut with the house gap and slid.
+
+```
+logomarks glitch <mark> [--preset shear] [-o out.svg] [options]
+```
+
+The result is fitted and checked, and the same seed gives the same bytes. See [editing](editing.md) for the presets.
+
+| Option | Default | |
+|---|---|---|
+| `--preset <name>` | `shear` | `shear`, `slice`, `bands`, `stepped`, `lane`. |
+| `--seed <n>` | 1 | Places the cuts; another seed is a shuffle. |
+| `--angle <deg>` | the mark's slope (`shear`), across the lanes (`lane`), else 0 | Cut direction, clockwise from across. |
+| `--place <0–1>` | seeded | Where the first cut crosses the mark. |
+| `--slide <units>` | 44 | How far the sides slide apart along the cut. |
+| `--gap <units>` | 22 | The gap at each cut. |
+| `--cuts <n>` | seeded | Cuts for `slice` (1–3), bands for `bands` (3–5). |
+| `-o, --out <file>` | stdout | Write `.svg`, or `.png` drawn at 512. |
+
+Exit 1 when the result fails a check: try another seed.
+
+```bash
+logomarks glitch quad-cove --preset shear --seed 3 -o glitched.svg
+logomarks glitch mark.svg --preset bands --cuts 4 -o preview.png
+```
+
+## combine
+
+Combine two marks into one.
+
+```
+logomarks combine <a> <b> [--op union] [-o out.svg] [options]
+```
+
+`b` is placed over `a` on the 512 canvas (both fitted first), then combined. The result is fitted and checked.
+
+| Option | Default | |
+|---|---|---|
+| `--op <op>` | `union` | `union`, `subtract` (b cut out of a), `intersect`, `exclude` (where exactly one covers), `place` (both as they are). |
+| `--scale <factor>` | 1 | Scale `b` about its own centre. |
+| `--rotate <deg>` | 0 | Turn `b` clockwise about its own centre. |
+| `--flip <axis>` | | Flip `b`: `horizontal` or `vertical`. |
+| `--x <units>`, `--y <units>` | 0 | Move `b` across and down. |
+| `-o, --out <file>` | stdout | Write `.svg`, or `.png` drawn at 512. |
+
+Exit 1 when the result fails a check.
+
+```bash
+logomarks combine quad-cove shear-a --op subtract --scale 0.5 -o combined.svg
+logomarks combine a.svg b.svg --op place --x 120 -o both.png
+```
+
+## kit
+
+Build a brand kit on a mark and write it to a folder.
+
+```
+logomarks kit <mark> --name "Brand" [-o dir/] [options]
+```
+
+The kit, from [`@logomarks/brand-kit`](https://github.com/Logomarks/brand-kit):
+
+- `mark/`: SVG on light, dark and colour, and one that follows dark mode; PNG 64–2048.
+- `favicon/`: `favicon.ico`, `favicon.svg`, `apple-touch-icon.png`, any and maskable icons, `site.webmanifest`, `head.html`.
+- `lockup/`: horizontal and stacked, on light, dark and colour, the name as outlines.
+- `colors/`: `palette.css`, a Tailwind theme and design tokens: a 50–950 OKLCH scale with WCAG pairings.
+- `social/`: the social pack, as [`social`](#social) makes it.
+- `brand-sheet.png` and `.svg`, `brand.json` (the brand, the files, a live mark credited, CC0) and `README.md`.
+
+A light brand colour gets a darker mark on light grounds (it must clear 3:1), and the text colours clear WCAG AA. Look at `brand-sheet.png` before handing the kit over.
+
+| Option | Default | |
+|---|---|---|
+| `--name <text>` | the mark's name | The brand's name. |
+| `--color <hex>` | `#d4ff3a` | The brand colour. |
+| `--font <id>` | `inter` | The typeface for the name: `inter`, `space-grotesk`, `instrument-sans`, `bricolage-grotesque`, `instrument-serif`, `plex-mono`; for restaurants `fraunces` (warm serif: bistro, wine bar), `cagliostro` (flared sans, set wide: fine dining), `limelight` (art deco: cocktail bar), `shrikhand` (retro chunky: diner, brunch, ice cream). All SIL OFL, bundled. |
+| `--tagline <text>` | | A short line under the name on social images and the brand sheet. |
+| `--url <url>` | | The brand's website, for the brand sheet and the email signature. |
+| `--handle <@name>` | `@` and the name | The social handle. |
+| `--styles <ids>` | `minimal,bold,pattern` | Social styles: `minimal`, `bold`, `pattern`, and `gradient` (a grainy gradient of the brand colour) when asked for. |
+| `--platforms <ids>` | every one | Social images by id (`x-header`) or platform (`instagram`). |
+| `--animated` | off | Also write animated SVGs for avatars, stories and banners. |
+| `--no-social` | off | Leave the social pack out. |
+| `-o, --out <dir>` | `<name>-kit` | The folder to write; files in it are replaced. |
+
+```bash
+logomarks kit hex-gem --name "Hexa Labs" --color '#ff5c3a' --font space-grotesk -o hexa/
+logomarks kit mark.svg --name Acme --no-social
+```
+
+## social
+
+Draw the brand for every social platform at its size, and write it to a folder.
+
+```
+logomarks social <mark> --name "Brand" [-o dir/] [options]
+```
+
+Every platform image (Instagram, LinkedIn, X, YouTube, Facebook, TikTok, Twitch, Discord, Threads, Bluesky) at its current size, with the logo inside its safe zone, in each style as `<style>/<id>.png` and `.svg`; an email signature, the Open Graph card, and a README of sizes and sources.
+
+Options: as [`kit`](#kit), without `--no-social`. `-o, --out <dir>` defaults to `<name>-social`.
+
+```bash
+logomarks social hex-gem --name "Hexa Labs" --platforms instagram,linkedin --styles bold
+logomarks social mark.svg --name Acme --animated -o acme-social/
+```
+
+## mockup
+
+Put a brand on an object and write the image.
+
+```
+logomarks mockup <mark> --object <object> [-o file.png] [options]
+```
+
+Objects, from [`@logomarks/mockups`](https://github.com/Logomarks/mockups), with their layouts (the first is the default): `card` (pair, flat, stack, fan), `letterhead` (set, flat, envelope), `ticket`, `lanyard`, `sticker` (laptop, bottle, sheet), `tote`, `tee`, `hoodie`, `cap`, `mug` (single, pair), `bag`, `box`, `poster`, `vinyl`, `cd`, `cassette`, `phone`, `laptop`, `billboard`, `shopfront`. Garments, mugs and bags carry the mark; prints carry the lockup on the brand colour.
+
+| Option | Default | |
+|---|---|---|
+| `--object <id>` | required | The object. |
+| `--name`, `--color`, `--font` | as [`kit`](#kit) | The brand. |
+| `--layout <id>` | the object's first | One of the object's layouts. |
+| `--surface <id>` | the object's own | What it lies on: `oak`, `concrete`, `linen`, `paper`, `light`, `dark`, or a hex colour. |
+| `--view <front \| angle>` | `front` | A screen's or a sign's view. |
+| `--base <colour>` | the object's own | The object's colour: `white`, `black`, `navy` or a hex for garments, mugs and bags; a box's board; a device's finish. |
+| `--size <px>` | 1600 | The longest side, 200–4000. |
+| `--seed <text>` | the mark's slug | Drives every random choice. |
+| `-o, --out <file>` | `<object>.png` | Write `.png`, or `.svg` for the layered SVG. |
+
+```bash
+logomarks mockup hex-gem --name "Hexa Labs" --object card -o card.png
+logomarks mockup mark.svg --object tee --base black -o tee.png
+```
+
+## cover
+
+Draw a cover (an Open Graph image, a header or a post) with the mark on it.
+
+```
+logomarks cover <mark> [--recipe mark] [--title "…"] [-o cover.png] [options]
+```
+
+Recipes, from [`@arraypress/covers`](https://github.com/arraypress/covers): `mark`, `gradient`, `tile`, `stripes`, `aurora`, `grid`, `cutout`.
+
+| Option | Default | |
+|---|---|---|
+| `--recipe <id>` | `mark` | The look. |
+| `--title <text>` | | A headline; the mark moves out of its way. |
+| `--label <text>` | | A small line over the title. |
+| `--color <hex>` | `#d4ff3a` | The brand colour. |
+| `--aspect <ratio>` | `og` | `og` (1200 × 630), `1:1`, `16:9`, `4:5`, `9:16`, any `w:h`, or a number. |
+| `--width <px>` | 1200 | The width, 200–6000. |
+| `--seed <text>` | the mark's slug | Drives every random choice. |
+| `-o, --out <file>` | `cover.png` | Write `.png`, or `.svg` (text as outlines). |
+
+```bash
+logomarks cover hex-gem --recipe aurora --title "Introducing Hexa" -o cover.png
+logomarks cover mark.svg --recipe stripes --aspect 1:1 -o post.png
+```
+
+## mcp
+
+Run the MCP server on stdio, for Claude Code, Codex, Cursor and other agents.
+
+```
+logomarks mcp
+```
+
+Every command as an MCP tool, run locally: nothing leaves the machine. See [MCP tools](mcp.md).
+
+```bash
+claude mcp add logomarks -- npx -y logomarks mcp
+codex mcp add logomarks -- npx -y logomarks mcp
+```
+
+PNGs are drawn by resvg in WebAssembly, so nothing needs `sharp` or a native build.

package/docs/editing.md

@@ -0,0 +1,61 @@
+# Editing
+
+`glitch`, `edit` and `combine` (and the `glitch_mark`, `edit_mark` and `combine_marks` tools) run [`@logomarks/editor`](https://github.com/Logomarks/editor)'s operations without a page: curves are kept, booleans are exact, and the house gap is 22. Every result is fitted to the standard (longest side 448 on the 512 canvas, centred: @logomarks/core's `fitMark`) and run through every check, so a speck, sliver, pin-hole or stray gap a change leaves is reported with its box. The same input and seed give the same bytes.
+
+## Glitch
+
+| Preset | |
+|---|---|
+| `shear` | One cut along the mark's own slope, the sides slid apart. |
+| `slice` | 1–3 parallel cuts, alternate bands slid. |
+| `bands` | 3–5 bands across, each nudged by a seeded amount. |
+| `stepped` | A stair-step cut, the sides slid apart. |
+| `lane` | One cut across a Track mark's lanes, one side slid one lane (Track marks only). |
+
+| Setting | Default | |
+|---|---|---|
+| `seed` | 1 | Places the cuts; another seed is a shuffle. |
+| `angle` | the mark's slope (shear), across the lanes (lane), else 0 | Degrees, clockwise from across. |
+| `place` | seeded | Where the first cut crosses, 0–1 across the mark. |
+| `slide` | 44 | How far the sides end up apart along the cut. |
+| `gap` | 22 | The gap at each cut. |
+| `cuts` | seeded | Cuts for `slice` (1–3), bands for `bands` (3–5). |
+
+A placement that would leave a speck or a sliver is nudged across, then reseeded. When none is clean the call fails with a message: try another seed.
+
+## Edit
+
+A list of ops, run in order. `parts` are indices from `parts` / `list_parts`, as they stand when the op runs (a delete renumbers what follows); leave it out for every part.
+
+| Op | Settings | |
+|---|---|---|
+| `delete` | `parts` | Remove parts. |
+| `move` | `dx`, `dy` | Move parts, in units. |
+| `rotate` | `angle`, `about` | Degrees clockwise, about the parts' centre (or `[x, y]`). |
+| `scale` | `by` (a factor or `[sx, sy]`), `about` | About the parts' centre. |
+| `flip` | `axis` (`horizontal`, `vertical`), `about` | |
+| `round` | `radius` | Every corner of the parts rounded; existing rounds are adjusted; 0 takes them out. |
+| `offset` | `distance`, `join` (`miter`, `round`) | Grow (positive) or shrink (negative); curves kept. |
+| `mirror` | `axis` (`vertical`, `horizontal`, `both`) | The whole mark reflected across the centre; overlaps are unioned. |
+| `radial` | `count` | The whole mark repeated about the centre. |
+| `union`, `subtract` | `parts` | Join parts into one; cut the rest out of the first. |
+| `color` | `color` | Paint the whole mark (it is `currentColor` otherwise; the checks warn). |
+| `tone` | `parts`, `color` | A second colour on the parts: `fill="var(--tone-2, #hex)"` beside `currentColor`. |
+
+```json
+[{ "op": "delete", "parts": [3] }, { "op": "round", "radius": 18 }, { "op": "tone", "parts": [0], "color": "#ff5c3a" }]
+```
+
+The live marks store their curves as short lines, so `round` has little room at a corner that is already rounded; it rounds real corners as asked.
+
+## Combine
+
+`b` is placed on `a`'s 512 canvas (both fitted first): `scale` and `rotate` about its own centre, `flip`, then moved by `x`, `y`. Then:
+
+| Op | |
+|---|---|
+| `union` | Everything either covers. |
+| `subtract` | `a` with `b` cut out. |
+| `intersect` | Where both cover. |
+| `exclude` | Where exactly one covers. |
+| `place` | Both, as they are. |

package/docs/mcp.md

@@ -0,0 +1,45 @@
+# 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.
+
+```bash
+claude mcp add logomarks -- npx -y logomarks mcp        # Claude Code
+codex mcp add logomarks -- npx -y logomarks mcp         # Codex (or ~/.codex/config.toml → [mcp_servers.logomarks])
+```
+
+Or install the Claude Code plugin, which adds the server and the two Logomarks skills:
+
+```
+/plugin marketplace add logomarks/skills
+/plugin install logomarks@logomarks
+```
+
+Any other MCP client: run `npx -y logomarks mcp` over stdio. The first run downloads the package, so allow a longer start-up timeout.
+
+## Tools
+
+| Tool | Use it to | Arguments | Returns |
+|---|---|---|---|
+| `find_marks` | Search the set for a mark to use or build on. | `query`, `style`, `tags`, `industry`, `letter`, `limit` (20) | `{ total, marks }`; with no arguments, every style, tag, mood and industry. |
+| `get_mark` | Get a mark's SVG, a PNG to look at, or a file. | `mark`, `color`, `size`, `out` | `{ slug, name, url, licence, color, svg }`; `file` instead of `svg` with `out`; an image with `size`. |
+| `check_mark` | Check marks against the house rules. | `svg` or `paths`, `svgName`, `fix`, `strict`, `ignore` | `{ ok, passed, failed, marks: [{ findings: [{ id, severity, message, box }] }] }`. |
+| `similar_marks` | Find the live marks nearest to a new one. | `svg` or `paths`, `svgName`, `top` (5), `letters` | `{ ok, thresholds, marks: [{ matches: [{ slug, score, verdict }] }] }`. |
+| `review_sheet` | Look at review cards before handing marks over. | `svg` or `paths`, `svgName`, `strict`, `ignore`, `out` | Each mark's check summary and nearest marks, and the cards as an image. |
+| `list_parts` | See a mark's parts by index, before `edit_mark`. | `mark` or `svg` | `{ count, parts: [{ index, box, centre, area, holes, tone }] }`, and the parts numbered, as an image. |
+| `edit_mark` | Edit a mark by part. | `mark` or `svg`, `ops`, `out` | `{ ok, parts, svg, checks }` (`file` instead of `svg` with `out`), and the result as an image. |
+| `glitch_mark` | Make a glitch edition. | `mark` or `svg`, `preset`, `seed` (1), `angle`, `place`, `slide` (44), `gap` (22), `cuts`, `out` | `{ ok, glitch, svg, checks }` (`file` instead of `svg` with `out`), and the result as an image. |
+| `combine_marks` | Make two marks one. | `a`, `b` (slug, path or SVG text), `op`, `transform: { scale, rotate, flip, x, y }`, `out` | `{ ok, svg, checks }` (`file` instead of `svg` with `out`), and the result as an image. |
+| `build_brand_kit` | Set a chosen mark up as a brand. | `mark`, `name`, `color`, `font`, `tagline`, `url`, `handle`, `styles`, `platforms`, `animated`, `social` (true), `out` (`<name>-kit`) | Writes the folder; its path, the file count, `brand.json`, and the brand sheet as an image. |
+| `build_social_pack` | Make every platform's profile images, banners and posts. | `mark`, `name`, `color`, `font`, `tagline`, `url`, `handle`, `platforms`, `styles`, `animated`, `out` (`<name>-social`) | Writes the folder; its path and files, and a preview of each style. |
+| `render_mockup` | Show the brand on an object. | `mark`, `object`, `name`, `color`, `font`, `layout`, `surface`, `view`, `base`, `size` (1600), `seed`, `out` | A preview image (up to 800 px); `out` writes the full size. |
+| `render_cover` | Make an Open Graph image, header or post. | `mark`, `recipe` (`mark`), `title`, `label`, `color`, `aspect` (`og`), `width` (1200), `seed`, `out` | A preview image (up to 800 px); `out` writes the full size. |
+
+Every argument is described, with its type, choices and default, in the tool's input schema. The editing tools' settings and ops are in [editing](editing.md).
+
+## 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`).
+
+## 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.

package/package.json

@@ -1,6 +1,96 @@
 {
   "name": "logomarks",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.1.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.",
+  "keywords": [
+    "logo",
+    "logomark",
+    "logomarks",
+    "brand",
+    "brand-kit",
+    "svg",
+    "favicon",
+    "icon",
+    "mockup",
+    "og-image",
+    "social-media",
+    "design",
+    "cli",
+    "mcp",
+    "mcp-server",
+    "model-context-protocol",
+    "claude-code",
+    "codex",
+    "cursor",
+    "cc0"
+  ],
+  "homepage": "https://logomarks.ai",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Logomarks/cli.git"
+  },
+  "bugs": {
+    "url": "https://github.com/Logomarks/cli/issues"
+  },
+  "license": "MIT",
+  "author": {
+    "name": "David Sherlock",
+    "url": "https://davidsherlock.com"
+  },
+  "type": "module",
+  "main": "src/index.js",
+  "types": "src/index.d.ts",
+  "bin": {
+    "logomarks": "bin/logomarks.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./src/index.d.ts",
+      "import": "./src/index.js",
+      "default": "./src/index.js"
+    },
+    "./mcp": {
+      "types": "./src/mcp/index.d.ts",
+      "import": "./src/mcp/index.js",
+      "default": "./src/mcp/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "bin",
+    "src",
+    "data",
+    "docs",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "scripts": {
+    "test": "node --test tests/*.test.js",
+    "typecheck": "tsc --noEmit",
+    "index": "node scripts/index.js"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "dependencies": {
+    "@arraypress/color-utils": "^1.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"
+  },
+  "devDependencies": {
+    "@types/node": "^26.6.6",
+    "typescript": "^6.0.3"
+  }
+}

package/src/brand/brand.d.ts

@@ -0,0 +1,23 @@
+import type { BrandInput } from '@logomarks/brand-kit';
+import type { Mark } from './mark.js';
+import type { FontId } from './fonts.js';
+
+/** What a brand is built from. */
+export interface BrandOptions {
+	mark: Mark;
+	/** The brand's name (the mark's). */
+	name?: string;
+	/** The brand colour, hex (Logomarks' yellow). */
+	color?: string;
+	/** A bundled face (inter). */
+	font?: FontId;
+	/** A line under the name on social images and the sheet. */
+	tagline?: string;
+	/** The website, for the sheet and the email signature. */
+	url?: string;
+	/** The social handle (`@` and the slug). */
+	handle?: string;
+}
+
+/** The brand as `@logomarks/brand-kit` takes it; a live mark is credited (CC0). */
+export function brandInput(o: BrandOptions): BrandInput;

package/src/brand/brand.js

@@ -0,0 +1,29 @@
+/**
+ * @module logomarks/brand/brand
+ *
+ * A brand as `@logomarks/brand-kit` takes it, from what the CLI and the MCP
+ * tools are given: a mark (live or a file), a name, a colour, a bundled
+ * face, and the words for social images. A live mark is credited, CC0.
+ */
+
+import { brandFont } from './fonts.js';
+import { MARK_URL } from './mark.js';
+
+/**
+ * The brand-kit inputs.
+ *
+ * @param {import('./brand.js').BrandOptions} o The mark, name, colour, face and words.
+ * @returns {import('@logomarks/brand-kit').BrandInput} The inputs.
+ */
+export function brandInput({ mark, name, color, font, tagline, url, handle }) {
+	return {
+		svg: mark.svg,
+		name: name?.trim() || mark.name,
+		color,
+		font: brandFont(font),
+		tagline,
+		url,
+		handle,
+		...(mark.live && { source: { name: mark.name, url: MARK_URL + mark.slug, license: 'CC0-1.0' } }),
+	};
+}