@domandigital/craft 0.6.0 → 0.7.0

package/dist/index.d.cts

@@ -1048,6 +1048,24 @@ declare function runTell(tell: Tell, files: SourceFile[]): Hit[];
  * markers, and a test fails if the two differ.
  */
 declare function catalogueTable(): string;
+/**
+ * The copy word and phrase lists, as portable JSON.
+ *
+ * These are the only part of the copy catalogue a non-TypeScript consumer can
+ * use directly: a word list is data, a regex-shaped tell (contrastive
+ * negation, the "No X" badge, em dash, emoji) is not something worth
+ * re-deriving from a JSON export, so those stay TypeScript-only here.
+ *
+ * `claude-kit`'s `copy_check.py` is the reason this exists. It hardcoded its
+ * own copies of these same lists rather than reading this package, and the
+ * two drifted (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, same
+ * shape as `sync-craft-standard.sh` does for `STANDARD.md`. Regenerate the
+ * checked-in `word-lists.json` with `pnpm --filter @domandigital/craft run
+ * docs` after changing any list in `tells/copy.ts`.
+ */
+declare function wordListsJson(): string;
 
 /** Plain-text rendering of a report, for a terminal or a hook. */
 
@@ -1418,4 +1436,271 @@ declare function propose(input: ProposeInput): {
     direction: ArtDirection;
 };
 
-export { AI_PHRASES, AI_VIOLET, AI_WORDS, type AccentFork, type AccentForkOptions, type ArtDirection, BUZZWORDS, CATALOGUE, CATALOGUE_VERSION, CHOICE_KEYS, type CheckOptions, type CheckReport, type CheckRestraintInput, type ChoiceKey, type ContrastCheck, type ContrastReport, type CopyTell, type CraftTokensInput, type CraftTokensResult, DENSITIES, DENSITY_NAMES, DIRECTION_VERSION, DISTANCE_WEIGHTS, DURATION_MS, DURATION_S, type DensityCssOptions, type DensityName, type DirectionChoice, type DirectionProblem, type DirectionReport, type DirectionSource, type DurationName, EASE, EASE_TUPLE, EXIT_RATIO, type EaseName, type EmitCssOptions, FINGERPRINT_VERSION, type Finding, type Fingerprint, type FingerprintDistance, type FluidSpaceOptions, type FluidTypeOptions, type FluidTypeResult, type FontClass, type Gamut, type Generation, HOUSE_BUDGET, HOUSE_TYPE, type Hit, LIGHTNESS_CURVE, type MotionDecision, type MotionKind, NEGATIVE_REASSURANCE, type Oklch, type OklchToHexOptions, PILL_LIMIT, PLAINER_WORDS, PROPOSED, type PaletteColour, type Proposal, type ProposeInput, RAMP_STEPS, REFLEX_FONTS_1, REFLEX_FONTS_2, RENDERED_PATHS, REVEAL_LIMIT, REVIEW_PHRASES, type Ramp, type RampFromAnchorsOptions, type RampOptions, type RampStep, type RestraintBudget, type RestraintReport, type RestraintSeverity, type RestraintViolation, type Rgb, SCALE, SHADCN_LIMIT, SHADCN_PRIMITIVES, SNAPSHOT_VERSION, SOURCE_KINDS, SPACE_STEPS, SPRING, STOCK_PHRASES, type SectionKind, type SectionRhythmOptions, type SemanticInput, type SemanticResult, type Severity, type ShouldAnimateInput, type Snapshot, type SnapshotColour, type SnapshotControl, type SnapshotEffects, type SnapshotFont, type SnapshotGradient, type SnapshotHeading, type SnapshotMotion, type SnapshotPatch, type SnapshotSection, type SourceFile, type SourceKind, type SourceTell, type SpaceStep, type Surface, TYPE_STEPS, type TailwindPreset, type Tell, type TellException, type TypeStep, VAGUE_WORDS, type ValidateContext, accentFork, apcaContrast, auditSnapshot, catalogueTable, checkCopy, checkPair, checkRestraint, craftTokens, deltaEOk, deltaEOkHex, densityCss, densityTokens, emitCss, exitDuration, findColours, fingerprint, fingerprintDistance, fluidClamp, fluidSpace, fluidType, fontClass, formatHex, formatReport, hexToOklch, inP3Gamut, inSrgbGamut, initDirection, isAiViolet, isCream, makeSnapshot, motionTokens, nearest, normaliseFamily, oklchToHex, oklchToRgb, paletteFromPixels, parseColour, parseHex, propose, ramp, rampFromAnchors, runTell, scanSource, sectionRhythm, semantic, shouldAnimate, tailwindV3Preset, tailwindV4Theme, tellById, toGamut, typeFeatureTokens, validateDirection, wcagContrast };
+/**
+ * The counterfactual: what a model builds for this brief when nobody tells it
+ * anything else. Signal 2 of CHARACTER.md.
+ *
+ * A null model is about twenty pages generated from one brief, each reduced to
+ * a fingerprint. A site is typical when it sits as close to those pages as they
+ * sit to each other. That question keeps working when model defaults move,
+ * which a fixed list of tells cannot: ban Inter and the null model moves with
+ * the model, so the comparison moves too.
+ *
+ * `harvest` reads the same pages the other way round: which choices recur
+ * across them that the catalogue does not know yet. Those are the candidates
+ * for the next generation of tells. A person decides; nothing is added here.
+ *
+ * Pure. Generating pages and snapshotting them lives in the CLI.
+ */
+
+declare const NULL_VERSION = 1;
+/**
+ * The prompt a null run gets: the brief, and nothing about how it should look.
+ * Changing this changes every null model built after it, so it is versioned
+ * by being recorded in each one.
+ */
+declare function nullPrompt(brief: string): string;
+interface NullRun {
+    /** The page's file name without extension: "01". */
+    id: string;
+    fingerprint: Fingerprint;
+    /** Catalogue tells found on the page, source and rendered, each once. */
+    tells: string[];
+    /** Every visible string on the page, for the phrase harvest. */
+    copy: string[];
+}
+interface NullModel {
+    version: typeof NULL_VERSION;
+    brief: string;
+    prompt: string;
+    /** What was asked for with --model, or "default". */
+    model: string;
+    catalogueVersion: string;
+    builtAt: string;
+    runs: NullRun[];
+}
+/** The HTML document in a model's reply, without code fences or commentary. */
+declare function extractHtml(reply: string): string | null;
+/** Fewer runs than this and the spread of the null is noise, so nothing is judged. */
+declare const MIN_RUNS = 5;
+/** Typical when at least this share of the null's own pages sit further out. */
+declare const TYPICAL_AT = 0.1;
+interface Typicality {
+    /**
+     * 0 to 1: the share of the null's own pages that sit further from the rest
+     * than this page sits from them. 1 is more typical than anything the model
+     * built; 0 is further out than every one of them.
+     */
+    score: number;
+    typical: boolean;
+    /** Mean distance to the k nearest null pages. */
+    distance: number;
+    /** The same measure for each null page against the others, median. */
+    baseline: number;
+    nearest: {
+        id: string;
+        distance: number;
+    }[];
+    /** The choices this page shares with most of the null: why it reads as typical. */
+    shared: {
+        part: string;
+        value: string;
+        runs: number;
+        of: number;
+    }[];
+}
+/**
+ * How typical a page is against one or more null models (pooled). Every null
+ * page is scored against the others the same way, leaving itself out, so the
+ * threshold comes from the model's own spread and not from a number picked
+ * here: a page drawn from the null is flagged nine times in ten by
+ * construction, and the calibration checks whether real sites are not.
+ */
+declare function typicality(target: Fingerprint, runs: NullRun[], k?: number): Typicality;
+declare function hueName(o: Oklch | null): string;
+declare function groundName(o: Oklch): string;
+declare function shapeName(roundness: number | null): string;
+/** The discrete choices a fingerprint makes, as part → value. What a person would name. */
+declare function choicesOf(fp: Fingerprint): Record<string, string[]>;
+type CandidateKind = "face" | "accent" | "ground" | "shape" | "motion" | "opening" | "tell" | "phrase";
+interface HarvestCandidate {
+    kind: CandidateKind;
+    value: string;
+    /** Null pages that make this choice, across every model given. */
+    runs: number;
+    of: number;
+    /** Distinct briefs it turned up for. A habit shows across briefs; a brief's own words do not. */
+    briefs: number;
+    /** The catalogue tell that already catches it, or null when nothing does. */
+    known: string | null;
+    /** An example, for a phrase: the string it came from. */
+    example?: string;
+}
+interface HarvestOptions {
+    /** Report a choice made by at least this share of pages. Default 0.25. */
+    minShare?: number;
+    /** Which copy tell, if any, already catches a phrase. The CLI passes the catalogue's. */
+    copyTell?: (phrase: string) => string | null;
+}
+/**
+ * Choices that recur across null pages, with the tell that already catches
+ * each, if any. The ones with `known: null` are the next generation's
+ * candidates. Nothing here decides: a person reads them, and a candidate only
+ * becomes a tell with a flag case and a pass case like every other.
+ */
+declare function harvest(models: Pick<NullModel, "brief" | "runs">[], options?: HarvestOptions): HarvestCandidate[];
+/** A representative colour for a hue family, for a report. */
+declare function hueSwatch(runs: NullRun[], hue: string): string | null;
+
+/**
+ * The estate register: every site the agency has shipped, fingerprinted, so a
+ * new one can be checked against its siblings. Signal 3 of CHARACTER.md.
+ *
+ * An agency's biggest tell is its clients looking like each other. No single
+ * site shows it; only the set does. So the register holds one fingerprint per
+ * site, and `compareToEstate` says which sites a page sits nearest and what
+ * it shares with them.
+ *
+ * The line for "siblings" is not a number picked here. Two different
+ * businesses are siblings when they sit closer together than two pages Claude
+ * builds for the same brief usually do: if a barber and an electrician look
+ * more alike than two drafts of one barber, nobody chose either look. The
+ * median comes from null models when they are given, and from the 2026-09-23
+ * calibration when they are not.
+ *
+ * Pure. The CLI reads and writes the register file.
+ */
+
+declare const ESTATE_VERSION = 1;
+/**
+ * Median fingerprint distance between two null pages built from the same
+ * brief, across seven briefs and 1,330 pairs (calibration/null, 2026-09-23).
+ */
+declare const SIBLING_AT = 0.31;
+interface EstateSite {
+    /** Short kebab-case id: "rmp", "chair-and-blade". */
+    id: string;
+    client: string;
+    url: string;
+    /** Where the site's source lives, if known: "rmp474/RMP-Electrical". */
+    repo?: string;
+    fingerprint: Fingerprint;
+    /** Rendered tells found when it was added, for the record. */
+    tells: string[];
+    addedAt: string;
+}
+interface EstateRegister {
+    version: typeof ESTATE_VERSION;
+    sites: EstateSite[];
+}
+declare function emptyEstate(): EstateRegister;
+/** Add a site, or replace the one with the same id. Sorted by id so the file diffs cleanly. */
+declare function addSite(register: EstateRegister, site: EstateSite): EstateRegister;
+/**
+ * What two fingerprints effectively share, named the way a person would see
+ * it: "Fraunces headline", "no accent", "pill buttons". A part counts when its
+ * distance is 0.2 or less.
+ */
+declare function sharedParts(a: Fingerprint, b: Fingerprint, d?: FingerprintDistance): string[];
+interface EstateMatch {
+    id: string;
+    distance: number;
+    sibling: boolean;
+    shared: string[];
+}
+/** The sites nearest a fingerprint, closest first, leaving out `exclude` (the site itself). */
+declare function compareToEstate(target: Fingerprint, register: EstateRegister, options?: {
+    exclude?: string;
+    siblingAt?: number;
+}): EstateMatch[];
+interface EstatePair {
+    a: string;
+    b: string;
+    distance: number;
+    sibling: boolean;
+    shared: string[];
+}
+/** Every pair in the register, closest first. */
+declare function estatePairs(register: EstateRegister, siblingAt?: number): EstatePair[];
+/**
+ * The sibling line from null models: the median distance between two pages
+ * built from the same brief. Each inner array is one brief's fingerprints.
+ */
+declare function siblingLine(briefs: Fingerprint[][]): number;
+
+/**
+ * The character report: the three signals and the reason rule, read together.
+ *
+ * No one signal decides. A site can carry no catalogued tell and still be what
+ * Claude builds for its brief (signal 2); it can be nothing like the null and
+ * still wear last year's reflexes (signal 1); it can pass both and be a twin of
+ * the agency's other client (signal 3). And a site that passes all three has
+ * still only avoided defaults: "decided" needs the reasons written down.
+ *
+ * So the verdict is:
+ *   default   two or more signals raised
+ *   mixed     one raised
+ *   decided   none raised, and all measured, reasons included
+ *   unproven  none raised, but something was not measured. Unverified is
+ *             never a pass.
+ *
+ * The actions change the surface: type, colour, shape, effects, motion, copy.
+ * Never the page grammar. A layout tell says what to change about how a
+ * section looks, not that it should move.
+ *
+ * Pure. The CLI gathers the inputs.
+ */
+
+/** Three or more distinct design tells: the rule fixed for the 2026-09-23 calibration. */
+declare const TELL_HEAVY = 3;
+/** Fewer choices decided than this and the reasons are not yet a direction. */
+declare const MIN_DECIDED = 5;
+type Verdict = "default" | "mixed" | "decided" | "unproven";
+type Area = "direction" | "type" | "colour" | "shape" | "effects" | "motion" | "layout" | "copy";
+interface SignalResult {
+    id: "tells" | "typicality" | "estate" | "reasons";
+    /** null when it was not measured. */
+    raised: boolean | null;
+    detail: string;
+}
+interface Action {
+    area: Area;
+    what: string;
+    why: string;
+    /** 1 first. Deciding comes before changing, so direction actions are always 1. */
+    priority: 1 | 2 | 3;
+    /** The art-direction choice that settles it, when there is one. */
+    choice?: ChoiceKey;
+}
+interface CharacterReport {
+    site: string;
+    verdict: Verdict;
+    summary: string;
+    signals: SignalResult[];
+    actions: Action[];
+}
+interface CharacterInputs {
+    site: string;
+    /** Source and rendered findings, merged. */
+    findings?: CheckReport | null;
+    typicality?: Typicality | null;
+    estate?: EstateMatch[] | null;
+    direction?: DirectionReport | null;
+}
+declare function characterReport(input: CharacterInputs, copyTells?: Set<string>): CharacterReport;
+
+/**
+ * `craft retrofit`: a character report turned into the checklist a retrofit
+ * session works through, in the order that works: decide, then change.
+ *
+ * Every change is tied to the art-direction choice that settles it, and shows
+ * the decided value and its reason when there is one. A change with no
+ * decided value waits for the decision; otherwise the retrofit swaps one
+ * default for the next.
+ *
+ * Pure. Returns Markdown.
+ */
+
+declare function retrofitPlan(report: CharacterReport, direction?: ArtDirection | null): string;
+
+export { AI_PHRASES, AI_VIOLET, AI_WORDS, type AccentFork, type AccentForkOptions, type Action, type Area, type ArtDirection, BUZZWORDS, CATALOGUE, CATALOGUE_VERSION, CHOICE_KEYS, type CandidateKind, type CharacterInputs, type CharacterReport, type CheckOptions, type CheckReport, type CheckRestraintInput, type ChoiceKey, type ContrastCheck, type ContrastReport, type CopyTell, type CraftTokensInput, type CraftTokensResult, DENSITIES, DENSITY_NAMES, DIRECTION_VERSION, DISTANCE_WEIGHTS, DURATION_MS, DURATION_S, type DensityCssOptions, type DensityName, type DirectionChoice, type DirectionProblem, type DirectionReport, type DirectionSource, type DurationName, EASE, EASE_TUPLE, ESTATE_VERSION, EXIT_RATIO, type EaseName, type EmitCssOptions, type EstateMatch, type EstatePair, type EstateRegister, type EstateSite, FINGERPRINT_VERSION, type Finding, type Fingerprint, type FingerprintDistance, type FluidSpaceOptions, type FluidTypeOptions, type FluidTypeResult, type FontClass, type Gamut, type Generation, HOUSE_BUDGET, HOUSE_TYPE, type HarvestCandidate, type HarvestOptions, type Hit, LIGHTNESS_CURVE, MIN_DECIDED, MIN_RUNS, type MotionDecision, type MotionKind, NEGATIVE_REASSURANCE, NULL_VERSION, type NullModel, type NullRun, type Oklch, type OklchToHexOptions, PILL_LIMIT, PLAINER_WORDS, PROPOSED, type PaletteColour, type Proposal, type ProposeInput, RAMP_STEPS, REFLEX_FONTS_1, REFLEX_FONTS_2, RENDERED_PATHS, REVEAL_LIMIT, REVIEW_PHRASES, type Ramp, type RampFromAnchorsOptions, type RampOptions, type RampStep, type RestraintBudget, type RestraintReport, type RestraintSeverity, type RestraintViolation, type Rgb, SCALE, SHADCN_LIMIT, SHADCN_PRIMITIVES, SIBLING_AT, SNAPSHOT_VERSION, SOURCE_KINDS, SPACE_STEPS, SPRING, STOCK_PHRASES, type SectionKind, type SectionRhythmOptions, type SemanticInput, type SemanticResult, type Severity, type ShouldAnimateInput, type SignalResult, type Snapshot, type SnapshotColour, type SnapshotControl, type SnapshotEffects, type SnapshotFont, type SnapshotGradient, type SnapshotHeading, type SnapshotMotion, type SnapshotPatch, type SnapshotSection, type SourceFile, type SourceKind, type SourceTell, type SpaceStep, type Surface, TELL_HEAVY, TYPE_STEPS, TYPICAL_AT, type TailwindPreset, type Tell, type TellException, type TypeStep, type Typicality, VAGUE_WORDS, type ValidateContext, type Verdict, accentFork, addSite, apcaContrast, auditSnapshot, catalogueTable, characterReport, checkCopy, checkPair, checkRestraint, choicesOf, compareToEstate, craftTokens, deltaEOk, deltaEOkHex, densityCss, densityTokens, emitCss, emptyEstate, estatePairs, exitDuration, extractHtml, findColours, fingerprint, fingerprintDistance, fluidClamp, fluidSpace, fluidType, fontClass, formatHex, formatReport, groundName, harvest, hexToOklch, hueName, hueSwatch, inP3Gamut, inSrgbGamut, initDirection, isAiViolet, isCream, makeSnapshot, motionTokens, nearest, normaliseFamily, nullPrompt, oklchToHex, oklchToRgb, paletteFromPixels, parseColour, parseHex, propose, ramp, rampFromAnchors, retrofitPlan, runTell, scanSource, sectionRhythm, semantic, shapeName, sharedParts, shouldAnimate, siblingLine, tailwindV3Preset, tailwindV4Theme, tellById, toGamut, typeFeatureTokens, typicality, validateDirection, wcagContrast, wordListsJson };

package/dist/index.d.ts

@@ -1048,6 +1048,24 @@ declare function runTell(tell: Tell, files: SourceFile[]): Hit[];
  * markers, and a test fails if the two differ.
  */
 declare function catalogueTable(): string;
+/**
+ * The copy word and phrase lists, as portable JSON.
+ *
+ * These are the only part of the copy catalogue a non-TypeScript consumer can
+ * use directly: a word list is data, a regex-shaped tell (contrastive
+ * negation, the "No X" badge, em dash, emoji) is not something worth
+ * re-deriving from a JSON export, so those stay TypeScript-only here.
+ *
+ * `claude-kit`'s `copy_check.py` is the reason this exists. It hardcoded its
+ * own copies of these same lists rather than reading this package, and the
+ * two drifted (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, same
+ * shape as `sync-craft-standard.sh` does for `STANDARD.md`. Regenerate the
+ * checked-in `word-lists.json` with `pnpm --filter @domandigital/craft run
+ * docs` after changing any list in `tells/copy.ts`.
+ */
+declare function wordListsJson(): string;
 
 /** Plain-text rendering of a report, for a terminal or a hook. */
 
@@ -1418,4 +1436,271 @@ declare function propose(input: ProposeInput): {
     direction: ArtDirection;
 };
 
-export { AI_PHRASES, AI_VIOLET, AI_WORDS, type AccentFork, type AccentForkOptions, type ArtDirection, BUZZWORDS, CATALOGUE, CATALOGUE_VERSION, CHOICE_KEYS, type CheckOptions, type CheckReport, type CheckRestraintInput, type ChoiceKey, type ContrastCheck, type ContrastReport, type CopyTell, type CraftTokensInput, type CraftTokensResult, DENSITIES, DENSITY_NAMES, DIRECTION_VERSION, DISTANCE_WEIGHTS, DURATION_MS, DURATION_S, type DensityCssOptions, type DensityName, type DirectionChoice, type DirectionProblem, type DirectionReport, type DirectionSource, type DurationName, EASE, EASE_TUPLE, EXIT_RATIO, type EaseName, type EmitCssOptions, FINGERPRINT_VERSION, type Finding, type Fingerprint, type FingerprintDistance, type FluidSpaceOptions, type FluidTypeOptions, type FluidTypeResult, type FontClass, type Gamut, type Generation, HOUSE_BUDGET, HOUSE_TYPE, type Hit, LIGHTNESS_CURVE, type MotionDecision, type MotionKind, NEGATIVE_REASSURANCE, type Oklch, type OklchToHexOptions, PILL_LIMIT, PLAINER_WORDS, PROPOSED, type PaletteColour, type Proposal, type ProposeInput, RAMP_STEPS, REFLEX_FONTS_1, REFLEX_FONTS_2, RENDERED_PATHS, REVEAL_LIMIT, REVIEW_PHRASES, type Ramp, type RampFromAnchorsOptions, type RampOptions, type RampStep, type RestraintBudget, type RestraintReport, type RestraintSeverity, type RestraintViolation, type Rgb, SCALE, SHADCN_LIMIT, SHADCN_PRIMITIVES, SNAPSHOT_VERSION, SOURCE_KINDS, SPACE_STEPS, SPRING, STOCK_PHRASES, type SectionKind, type SectionRhythmOptions, type SemanticInput, type SemanticResult, type Severity, type ShouldAnimateInput, type Snapshot, type SnapshotColour, type SnapshotControl, type SnapshotEffects, type SnapshotFont, type SnapshotGradient, type SnapshotHeading, type SnapshotMotion, type SnapshotPatch, type SnapshotSection, type SourceFile, type SourceKind, type SourceTell, type SpaceStep, type Surface, TYPE_STEPS, type TailwindPreset, type Tell, type TellException, type TypeStep, VAGUE_WORDS, type ValidateContext, accentFork, apcaContrast, auditSnapshot, catalogueTable, checkCopy, checkPair, checkRestraint, craftTokens, deltaEOk, deltaEOkHex, densityCss, densityTokens, emitCss, exitDuration, findColours, fingerprint, fingerprintDistance, fluidClamp, fluidSpace, fluidType, fontClass, formatHex, formatReport, hexToOklch, inP3Gamut, inSrgbGamut, initDirection, isAiViolet, isCream, makeSnapshot, motionTokens, nearest, normaliseFamily, oklchToHex, oklchToRgb, paletteFromPixels, parseColour, parseHex, propose, ramp, rampFromAnchors, runTell, scanSource, sectionRhythm, semantic, shouldAnimate, tailwindV3Preset, tailwindV4Theme, tellById, toGamut, typeFeatureTokens, validateDirection, wcagContrast };
+/**
+ * The counterfactual: what a model builds for this brief when nobody tells it
+ * anything else. Signal 2 of CHARACTER.md.
+ *
+ * A null model is about twenty pages generated from one brief, each reduced to
+ * a fingerprint. A site is typical when it sits as close to those pages as they
+ * sit to each other. That question keeps working when model defaults move,
+ * which a fixed list of tells cannot: ban Inter and the null model moves with
+ * the model, so the comparison moves too.
+ *
+ * `harvest` reads the same pages the other way round: which choices recur
+ * across them that the catalogue does not know yet. Those are the candidates
+ * for the next generation of tells. A person decides; nothing is added here.
+ *
+ * Pure. Generating pages and snapshotting them lives in the CLI.
+ */
+
+declare const NULL_VERSION = 1;
+/**
+ * The prompt a null run gets: the brief, and nothing about how it should look.
+ * Changing this changes every null model built after it, so it is versioned
+ * by being recorded in each one.
+ */
+declare function nullPrompt(brief: string): string;
+interface NullRun {
+    /** The page's file name without extension: "01". */
+    id: string;
+    fingerprint: Fingerprint;
+    /** Catalogue tells found on the page, source and rendered, each once. */
+    tells: string[];
+    /** Every visible string on the page, for the phrase harvest. */
+    copy: string[];
+}
+interface NullModel {
+    version: typeof NULL_VERSION;
+    brief: string;
+    prompt: string;
+    /** What was asked for with --model, or "default". */
+    model: string;
+    catalogueVersion: string;
+    builtAt: string;
+    runs: NullRun[];
+}
+/** The HTML document in a model's reply, without code fences or commentary. */
+declare function extractHtml(reply: string): string | null;
+/** Fewer runs than this and the spread of the null is noise, so nothing is judged. */
+declare const MIN_RUNS = 5;
+/** Typical when at least this share of the null's own pages sit further out. */
+declare const TYPICAL_AT = 0.1;
+interface Typicality {
+    /**
+     * 0 to 1: the share of the null's own pages that sit further from the rest
+     * than this page sits from them. 1 is more typical than anything the model
+     * built; 0 is further out than every one of them.
+     */
+    score: number;
+    typical: boolean;
+    /** Mean distance to the k nearest null pages. */
+    distance: number;
+    /** The same measure for each null page against the others, median. */
+    baseline: number;
+    nearest: {
+        id: string;
+        distance: number;
+    }[];
+    /** The choices this page shares with most of the null: why it reads as typical. */
+    shared: {
+        part: string;
+        value: string;
+        runs: number;
+        of: number;
+    }[];
+}
+/**
+ * How typical a page is against one or more null models (pooled). Every null
+ * page is scored against the others the same way, leaving itself out, so the
+ * threshold comes from the model's own spread and not from a number picked
+ * here: a page drawn from the null is flagged nine times in ten by
+ * construction, and the calibration checks whether real sites are not.
+ */
+declare function typicality(target: Fingerprint, runs: NullRun[], k?: number): Typicality;
+declare function hueName(o: Oklch | null): string;
+declare function groundName(o: Oklch): string;
+declare function shapeName(roundness: number | null): string;
+/** The discrete choices a fingerprint makes, as part → value. What a person would name. */
+declare function choicesOf(fp: Fingerprint): Record<string, string[]>;
+type CandidateKind = "face" | "accent" | "ground" | "shape" | "motion" | "opening" | "tell" | "phrase";
+interface HarvestCandidate {
+    kind: CandidateKind;
+    value: string;
+    /** Null pages that make this choice, across every model given. */
+    runs: number;
+    of: number;
+    /** Distinct briefs it turned up for. A habit shows across briefs; a brief's own words do not. */
+    briefs: number;
+    /** The catalogue tell that already catches it, or null when nothing does. */
+    known: string | null;
+    /** An example, for a phrase: the string it came from. */
+    example?: string;
+}
+interface HarvestOptions {
+    /** Report a choice made by at least this share of pages. Default 0.25. */
+    minShare?: number;
+    /** Which copy tell, if any, already catches a phrase. The CLI passes the catalogue's. */
+    copyTell?: (phrase: string) => string | null;
+}
+/**
+ * Choices that recur across null pages, with the tell that already catches
+ * each, if any. The ones with `known: null` are the next generation's
+ * candidates. Nothing here decides: a person reads them, and a candidate only
+ * becomes a tell with a flag case and a pass case like every other.
+ */
+declare function harvest(models: Pick<NullModel, "brief" | "runs">[], options?: HarvestOptions): HarvestCandidate[];
+/** A representative colour for a hue family, for a report. */
+declare function hueSwatch(runs: NullRun[], hue: string): string | null;
+
+/**
+ * The estate register: every site the agency has shipped, fingerprinted, so a
+ * new one can be checked against its siblings. Signal 3 of CHARACTER.md.
+ *
+ * An agency's biggest tell is its clients looking like each other. No single
+ * site shows it; only the set does. So the register holds one fingerprint per
+ * site, and `compareToEstate` says which sites a page sits nearest and what
+ * it shares with them.
+ *
+ * The line for "siblings" is not a number picked here. Two different
+ * businesses are siblings when they sit closer together than two pages Claude
+ * builds for the same brief usually do: if a barber and an electrician look
+ * more alike than two drafts of one barber, nobody chose either look. The
+ * median comes from null models when they are given, and from the 2026-09-23
+ * calibration when they are not.
+ *
+ * Pure. The CLI reads and writes the register file.
+ */
+
+declare const ESTATE_VERSION = 1;
+/**
+ * Median fingerprint distance between two null pages built from the same
+ * brief, across seven briefs and 1,330 pairs (calibration/null, 2026-09-23).
+ */
+declare const SIBLING_AT = 0.31;
+interface EstateSite {
+    /** Short kebab-case id: "rmp", "chair-and-blade". */
+    id: string;
+    client: string;
+    url: string;
+    /** Where the site's source lives, if known: "rmp474/RMP-Electrical". */
+    repo?: string;
+    fingerprint: Fingerprint;
+    /** Rendered tells found when it was added, for the record. */
+    tells: string[];
+    addedAt: string;
+}
+interface EstateRegister {
+    version: typeof ESTATE_VERSION;
+    sites: EstateSite[];
+}
+declare function emptyEstate(): EstateRegister;
+/** Add a site, or replace the one with the same id. Sorted by id so the file diffs cleanly. */
+declare function addSite(register: EstateRegister, site: EstateSite): EstateRegister;
+/**
+ * What two fingerprints effectively share, named the way a person would see
+ * it: "Fraunces headline", "no accent", "pill buttons". A part counts when its
+ * distance is 0.2 or less.
+ */
+declare function sharedParts(a: Fingerprint, b: Fingerprint, d?: FingerprintDistance): string[];
+interface EstateMatch {
+    id: string;
+    distance: number;
+    sibling: boolean;
+    shared: string[];
+}
+/** The sites nearest a fingerprint, closest first, leaving out `exclude` (the site itself). */
+declare function compareToEstate(target: Fingerprint, register: EstateRegister, options?: {
+    exclude?: string;
+    siblingAt?: number;
+}): EstateMatch[];
+interface EstatePair {
+    a: string;
+    b: string;
+    distance: number;
+    sibling: boolean;
+    shared: string[];
+}
+/** Every pair in the register, closest first. */
+declare function estatePairs(register: EstateRegister, siblingAt?: number): EstatePair[];
+/**
+ * The sibling line from null models: the median distance between two pages
+ * built from the same brief. Each inner array is one brief's fingerprints.
+ */
+declare function siblingLine(briefs: Fingerprint[][]): number;
+
+/**
+ * The character report: the three signals and the reason rule, read together.
+ *
+ * No one signal decides. A site can carry no catalogued tell and still be what
+ * Claude builds for its brief (signal 2); it can be nothing like the null and
+ * still wear last year's reflexes (signal 1); it can pass both and be a twin of
+ * the agency's other client (signal 3). And a site that passes all three has
+ * still only avoided defaults: "decided" needs the reasons written down.
+ *
+ * So the verdict is:
+ *   default   two or more signals raised
+ *   mixed     one raised
+ *   decided   none raised, and all measured, reasons included
+ *   unproven  none raised, but something was not measured. Unverified is
+ *             never a pass.
+ *
+ * The actions change the surface: type, colour, shape, effects, motion, copy.
+ * Never the page grammar. A layout tell says what to change about how a
+ * section looks, not that it should move.
+ *
+ * Pure. The CLI gathers the inputs.
+ */
+
+/** Three or more distinct design tells: the rule fixed for the 2026-09-23 calibration. */
+declare const TELL_HEAVY = 3;
+/** Fewer choices decided than this and the reasons are not yet a direction. */
+declare const MIN_DECIDED = 5;
+type Verdict = "default" | "mixed" | "decided" | "unproven";
+type Area = "direction" | "type" | "colour" | "shape" | "effects" | "motion" | "layout" | "copy";
+interface SignalResult {
+    id: "tells" | "typicality" | "estate" | "reasons";
+    /** null when it was not measured. */
+    raised: boolean | null;
+    detail: string;
+}
+interface Action {
+    area: Area;
+    what: string;
+    why: string;
+    /** 1 first. Deciding comes before changing, so direction actions are always 1. */
+    priority: 1 | 2 | 3;
+    /** The art-direction choice that settles it, when there is one. */
+    choice?: ChoiceKey;
+}
+interface CharacterReport {
+    site: string;
+    verdict: Verdict;
+    summary: string;
+    signals: SignalResult[];
+    actions: Action[];
+}
+interface CharacterInputs {
+    site: string;
+    /** Source and rendered findings, merged. */
+    findings?: CheckReport | null;
+    typicality?: Typicality | null;
+    estate?: EstateMatch[] | null;
+    direction?: DirectionReport | null;
+}
+declare function characterReport(input: CharacterInputs, copyTells?: Set<string>): CharacterReport;
+
+/**
+ * `craft retrofit`: a character report turned into the checklist a retrofit
+ * session works through, in the order that works: decide, then change.
+ *
+ * Every change is tied to the art-direction choice that settles it, and shows
+ * the decided value and its reason when there is one. A change with no
+ * decided value waits for the decision; otherwise the retrofit swaps one
+ * default for the next.
+ *
+ * Pure. Returns Markdown.
+ */
+
+declare function retrofitPlan(report: CharacterReport, direction?: ArtDirection | null): string;
+
+export { AI_PHRASES, AI_VIOLET, AI_WORDS, type AccentFork, type AccentForkOptions, type Action, type Area, type ArtDirection, BUZZWORDS, CATALOGUE, CATALOGUE_VERSION, CHOICE_KEYS, type CandidateKind, type CharacterInputs, type CharacterReport, type CheckOptions, type CheckReport, type CheckRestraintInput, type ChoiceKey, type ContrastCheck, type ContrastReport, type CopyTell, type CraftTokensInput, type CraftTokensResult, DENSITIES, DENSITY_NAMES, DIRECTION_VERSION, DISTANCE_WEIGHTS, DURATION_MS, DURATION_S, type DensityCssOptions, type DensityName, type DirectionChoice, type DirectionProblem, type DirectionReport, type DirectionSource, type DurationName, EASE, EASE_TUPLE, ESTATE_VERSION, EXIT_RATIO, type EaseName, type EmitCssOptions, type EstateMatch, type EstatePair, type EstateRegister, type EstateSite, FINGERPRINT_VERSION, type Finding, type Fingerprint, type FingerprintDistance, type FluidSpaceOptions, type FluidTypeOptions, type FluidTypeResult, type FontClass, type Gamut, type Generation, HOUSE_BUDGET, HOUSE_TYPE, type HarvestCandidate, type HarvestOptions, type Hit, LIGHTNESS_CURVE, MIN_DECIDED, MIN_RUNS, type MotionDecision, type MotionKind, NEGATIVE_REASSURANCE, NULL_VERSION, type NullModel, type NullRun, type Oklch, type OklchToHexOptions, PILL_LIMIT, PLAINER_WORDS, PROPOSED, type PaletteColour, type Proposal, type ProposeInput, RAMP_STEPS, REFLEX_FONTS_1, REFLEX_FONTS_2, RENDERED_PATHS, REVEAL_LIMIT, REVIEW_PHRASES, type Ramp, type RampFromAnchorsOptions, type RampOptions, type RampStep, type RestraintBudget, type RestraintReport, type RestraintSeverity, type RestraintViolation, type Rgb, SCALE, SHADCN_LIMIT, SHADCN_PRIMITIVES, SIBLING_AT, SNAPSHOT_VERSION, SOURCE_KINDS, SPACE_STEPS, SPRING, STOCK_PHRASES, type SectionKind, type SectionRhythmOptions, type SemanticInput, type SemanticResult, type Severity, type ShouldAnimateInput, type SignalResult, type Snapshot, type SnapshotColour, type SnapshotControl, type SnapshotEffects, type SnapshotFont, type SnapshotGradient, type SnapshotHeading, type SnapshotMotion, type SnapshotPatch, type SnapshotSection, type SourceFile, type SourceKind, type SourceTell, type SpaceStep, type Surface, TELL_HEAVY, TYPE_STEPS, TYPICAL_AT, type TailwindPreset, type Tell, type TellException, type TypeStep, type Typicality, VAGUE_WORDS, type ValidateContext, type Verdict, accentFork, addSite, apcaContrast, auditSnapshot, catalogueTable, characterReport, checkCopy, checkPair, checkRestraint, choicesOf, compareToEstate, craftTokens, deltaEOk, deltaEOkHex, densityCss, densityTokens, emitCss, emptyEstate, estatePairs, exitDuration, extractHtml, findColours, fingerprint, fingerprintDistance, fluidClamp, fluidSpace, fluidType, fontClass, formatHex, formatReport, groundName, harvest, hexToOklch, hueName, hueSwatch, inP3Gamut, inSrgbGamut, initDirection, isAiViolet, isCream, makeSnapshot, motionTokens, nearest, normaliseFamily, nullPrompt, oklchToHex, oklchToRgb, paletteFromPixels, parseColour, parseHex, propose, ramp, rampFromAnchors, retrofitPlan, runTell, scanSource, sectionRhythm, semantic, shapeName, sharedParts, shouldAnimate, siblingLine, tailwindV3Preset, tailwindV4Theme, tellById, toGamut, typeFeatureTokens, typicality, validateDirection, wcagContrast, wordListsJson };