@domandigital/craft 0.5.0 → 0.7.0

package/CHANGELOG.md

@@ -1,5 +1,115 @@
 # @domandigital/craft
 
+## 0.7.0
+
+### Minor Changes
+
+- dbdef56: Signal 2, the counterfactual. `craft null build --brief "..." --out <dir>` asks `claude -p` for about 20 home pages from the brief alone, renders and fingerprints each, and writes `null.json`. `craft audit <url> --null <dir>` scores how typical a page is against them: the share of the model's own pages that sit further out than this one, typical at 0.10 or above, with the choices it shares with most of them. `craft tells harvest <dir>` lists what recurs across null pages and which tell already catches it, so the next generation of tells comes from what the model builds now. `snapshotUrls` in `@domandigital/craft/audit` snapshots several pages through one browser. The rendered reveal check now also reads the text blocks inside a section, so reveals on cards two levels down are no longer read as a still page.
+- f765c69: Signal 3, the estate. `craft estate add <url | snapshot.json> --id <id>` fingerprints a shipped site into `estate.json`; `craft estate compare` lists every pair, or one site against the rest, closest first, and marks siblings: two sites closer together than two pages Claude builds for one brief (0.31, or measured again from `--null`). What a pair shares is named in plain words ("Fraunces headline", "no accent"). `--strict` exits 1 on a sibling. `craft direction propose --estate estate.json` reads the register. The fingerprint no longer takes a small painted patch, such as a floating chat button, for the accent: a painted colour needs a panel's worth of area.
+- f3c3dc0: The character report. `craft report <url | snapshot.json>` reads a site against all three signals and the reason rule (`--repo`, `--null`, `--estate`, `--direction`) and gives a verdict: default, mixed, decided, or unproven when something was not measured. The actions come in retrofit order, one per choice, with every reason that points at it. `craft retrofit` writes them as a Markdown checklist that names the art-direction choice settling each change, shows the decided value, and ends with what to leave alone. `characterReport` and `retrofitPlan` are exported. System font keywords such as `ui-monospace` no longer read as CSS variable names.
+
+### Patch Changes
+
+- 235b558: Export the copy catalogue's word and phrase lists as portable JSON
+  (`wordListsJson()`, checked in at `word-lists.json`), so a non-TypeScript
+  consumer can source from them instead of duplicating them by hand.
+
+  `claude-kit`'s `copy_check.py` hardcoded its own copies of these same lists
+  and had drifted from this package (documented in claude-kit's
+  `house-style/copy-rules.md`, "Note the enforcement gap"). `word-lists.json` is
+  the file that ends the drift: `install/sync-copy-wordlists.sh` on that side
+  copies it in verbatim, the same shape `sync-craft-standard.sh` already uses
+  for `STANDARD.md`.
+
+  No tell's detection or severity changed. Regenerate the checked-in file with
+  `pnpm --filter @domandigital/craft run docs` after editing any list in
+  `tells/copy.ts`.
+
+## 0.6.0
+
+### Minor Changes
+
+- 8c6304b: Character, phase A: a tell catalogue, a source scanner, a copy engine, and the `craft` command.
+
+  The standard asks whether a surface is well made. The new CHARACTER.md asks
+  whether anyone decided how it looks. A site can pass every craft number and
+  still be the indigo-and-Inter answer a model gives any brief.
+
+  - `scanSource(files)` finds 21 design tells in markup, component code and CSS,
+    tagged by generation: the first wave (indigo, blue-to-purple gradients, Inter,
+    glass panels, hero straight into a trust strip, icon-card grids, reveal on
+    every section, pills everywhere, a stock shadcn dump) and the second (cream
+    grounds, italic serif display, eyebrow chips, icon tiles, bento grids, radial
+    glows, graph-paper backgrounds, marquees, hairline-border cards, intro
+    cinematics).
+  - It reads classes the way Tailwind does, through `cn()`, `clsx()` and `cva()`,
+    and colour in hex, `rgb()`, `hsl()` and `oklch()` in raw CSS, `@theme` blocks
+    and arbitrary values. Hue is judged in OKLCh, so a violet set as `#5a35d1` is
+    caught.
+  - `checkCopy(files)` finds 8 copy tells, including em dashes, "not just X, it's
+    Y", staccato triplets and "where X meets Y". The word and phrase lists are
+    exported data with a test per entry.
+  - `craft scan [--staged]`, `craft copy`, `craft tells list`. Exceptions are
+    declared in `art-direction.json` with a `because`; one without a reason is
+    not applied and is reported.
+  - Every tell ships as `warn`. Nothing blocks until its estate hits have been
+    read. Every entry has a flag case per detection path and a pass case, and
+    the test proves each one fires on its own.
+
+  STANDARD.md section 10 now hands layout defaults to CHARACTER.md. Still eleven sections.
+
+- 161a771: The house copy rules move into craft, so `copy-check` can become a thin wrapper over `craft copy --json`.
+
+  - Ten tells carry the lists that claude-kit's `copy-check` hardcoded: `ai-phrase`,
+    `plainer-word`, `plain-english`, `buzzword`, `negative-reassurance`, `emoji`,
+    `no-x-no-y`, `no-x-badge`, `review-phrase` and `vague-word`. `not-just-but` now
+    covers every form of contrastive negation the house rules name, including the
+    parallel participle ("dispatched from here, not shipped in from Seoul").
+    Each word and phrase belongs to exactly one tell, with a test per entry.
+    Every tell still ships as `warn`. Catalogue `2026.09.2`, 39 tells.
+  - `copy-ok` or `craft-ok` on a finding's line, or the line above, suppresses it.
+    Suppressed findings are listed in `report.suppressed`, never hidden.
+  - `craft copy` never reads a comment as copy, reads JSX text that runs into an
+    expression, reads the text inside HTML held in a string, sees short strings
+    for the dash, emoji and badge tells, leaves a lone dash placeholder alone,
+    and reads `.jsonl` (a Sanity export) a document per line.
+  - Class lists written with arbitrary values (`bg-[var(--bg-elevated)]`) are no
+    longer read as prose.
+
+- 8093ad7: Phase B: the rendered page. `craft snapshot`, `craft audit`, rendered detection paths and a fingerprint.
+
+  - `@domandigital/craft/audit` captures a snapshot of a live page in Chromium: faces by
+    text and headline, colours by painted area, button shape, sections in running order
+    and which wait for a scroll, glass, gradients, glows, grid backgrounds, marquees,
+    hairline-shadow cards, the eyebrow chip, and an intro that covers the page at load.
+    Playwright is an optional peer dependency; the core import never loads a browser.
+    `collectInPage` is exported for any caller already driving a page.
+  - 18 tells gain a rendered detection path, with their own flag and pass snapshots,
+    proved like every other path. `auditSnapshot(snapshot)` judges a saved snapshot
+    without a browser. Catalogue `2026.09.3`.
+  - `fingerprint(snapshot)` and `fingerprintDistance(a, b)`: accent and ground in
+    OKLCh, display and body faces, roundness, reveal density, effects and running order,
+    compared 0 to 1. `nearest()` ranks a set.
+  - `craft audit <url | snapshot.json> [--repo dir]` reports the page and its source
+    together, with the fingerprint. `HTTPS_PROXY` is honoured.
+  - Colour parsing reads `oklab()` and `color(srgb ...)`, which browsers return.
+  - First estate baseline recorded in CHARACTER.md and `calibration/estate/2026-09-23/`.
+
+- ee6d6cd: Phase C: `art-direction.json`, the reason rule, and `craft direction init | validate | propose`.
+
+  - A schema for the seven expressive choices (accent, ground, display, body, shape, motif,
+    signature), the sources in the client's world they come from, and the tell exceptions
+    from phase A. Ships as `art-direction.schema.json` for editors.
+  - `validateDirection` applies the reason rule: a reason is a sentence, cites a declared
+    source and mentions what that source shows; preferences, mood boards and unconfirmed
+    proposals are rejected; a value on the tell catalogue needs an exception. Given a
+    fingerprint it warns where the page does not show what the file declares.
+  - `initDirection` writes today's choices with empty reasons. `propose` reads dominant
+    colours off PNG photos (`paletteFromPixels`, k-means in OKLab) and drafts choices ranked
+    away from the reflex band and the estate, every one marked `PROPOSED:` until a person
+    rewrites it.
+  - An exceptions-only file stays valid.
+
 ## 0.5.0
 
 ### Minor Changes