@domandigital/craft 0.15.0 → 0.16.0

package/dist/index.d.cts

@@ -1546,6 +1546,60 @@ declare function paragraphUniformity(paragraphs: string[]): number | null;
 /** A block the size of a blurb: 2 to 8 sentences, 20 to 160 words. */
 declare function isBlurb(f: Pick<ShapeFeatures, "sentences" | "words">): boolean;
 
+/**
+ * Lexical and specificity features for a short block of copy.
+ *
+ * The sentence-shape features (shape.ts) did not separate model copy from
+ * people's at blurb length. These measure what a block says and which words it
+ * reaches for: how many of the tell words and phrases craft already lists, how
+ * many words with published excess-use evidence, and how particular the block
+ * is (names, places, figures, the nouns of the trade).
+ *
+ * Pure and zero-dependency, and used both by the calibration scripts and by
+ * any tell that ships on the result.
+ *
+ * Every word in STUDY_WORDS carries its source. Models change what they
+ * over-use between generations (Juzek and Ward found "boasts" gone and
+ * "underscore" up sharply from GPT-3.5 to GPT-4o-mini), so a listed word is a
+ * measurement with a date, not a fact about models.
+ */
+interface StudyWord {
+    word: string;
+    source: string;
+}
+/**
+ * Words with published excess-use evidence. Academic register, so a word here
+ * is a candidate to measure in marketing copy, not a tell.
+ */
+declare const STUDY_WORDS: readonly StudyWord[];
+/** Every word or phrase the features look for, with where it came from. */
+declare function vocabulary(): {
+    word: string;
+    source: string;
+}[];
+/** Occurrences per vocabulary word in the text. */
+declare function vocabularyCounts(text: string): Map<string, number>;
+interface LexicalFeatures {
+    /** Hits from craft's own tell lists, per 100 words. */
+    listRate: number;
+    /** Hits from the published excess-use words, per 100 words. */
+    studyRate: number;
+    /** Distinct specifics (names, places, figures, dates, contact details, brief terms) per 100 words. */
+    hardPer100: number;
+    /** Distinct trade nouns per 100 words. */
+    tradePer100: number;
+    /** All specifics per 100 words. */
+    specificsPer100: number;
+    /** 1 when there is no hard specific and fewer than two trade nouns. */
+    generic: number;
+    /** Distinct money, date, time and number specifics. */
+    figures: number;
+    /** Distinct names and brief terms. */
+    names: number;
+}
+declare const LEXICAL_FEATURES: readonly (keyof LexicalFeatures)[];
+declare function lexicalOf(text: string, brief?: string): LexicalFeatures;
+
 /**
  * Specificity tells: a page that could belong to anyone.
  *
@@ -2349,9 +2403,18 @@ interface NullRun {
 interface NullModel {
     version: typeof NULL_VERSION;
     brief: string;
+    /**
+     * The prompt each page was built from. For imported pages, the prompt the
+     * person was asked to give the builder: `craft null prompt` prints it.
+     */
     prompt: string;
-    /** What was asked for with --model, or "default". */
+    /** What was asked for with --model, or "default"; "unknown" for imported pages unless given. */
     model: string;
+    /**
+     * The tool that built the pages, when they were imported rather than
+     * generated here: "v0", "lovable". Absent for `craft null build`.
+     */
+    builder?: string;
     catalogueVersion: string;
     builtAt: string;
     runs: NullRun[];
@@ -2876,6 +2939,90 @@ declare function propose(input: ProposeInput): {
     direction: ArtDirection;
 };
 
+/**
+ * Calibration: how well the catalogue separates pages a person has labelled.
+ *
+ * A labelled set holds three kinds of page. `ai` pages were generated. `human`
+ * pages were made by people. `ai-looking` pages were made by people and still
+ * read as generated to someone who looks at many sites: they are what the
+ * tells are for, since a tell detects a look, not a maker. So a tell's hit on
+ * an `ai` or an `ai-looking` page counts for it, and a hit on a `human` page
+ * counts against it.
+ *
+ * The verdict is the one CHARACTER.md fixed before any result was read: a page
+ * is flagged when it is typical against the null models, or tell-heavy (three
+ * or more distinct design tells). With no null models, tell-heavy decides.
+ *
+ * The targets are CHARACTER.md's first three. Target 4 (no siblings in the
+ * estate) is `craft estate compare`; target 5 (people cannot tell) is the blind
+ * test in docs/blind-test.md, which no tool here can run.
+ *
+ * Pure. Taking snapshots and reading files lives in the CLI.
+ */
+declare const LABELS: readonly ["ai", "ai-looking", "human"];
+type Label = (typeof LABELS)[number];
+/** Targets 1 and 3: this share of the set flagged, or more. */
+declare const FLAGGED_TARGET = 0.9;
+/** Target 2: this share of the human set typical, or less. */
+declare const HUMAN_TYPICAL_TARGET = 0.1;
+interface MeasuredPage {
+    id: string;
+    label: Label;
+    /** Every catalogue tell found on the page, each once. */
+    tells: string[];
+    /** Findings in the blocking tier. */
+    blocking: number;
+    /** Against the pooled null models; absent when none were given. */
+    typicality?: {
+        score: number;
+        typical: boolean;
+    };
+}
+interface UnmeasuredPage {
+    id: string;
+    label: Label;
+    reason: string;
+}
+interface LabelSummary {
+    label: Label;
+    pages: number;
+    flagged: number;
+    typical: number | null;
+    tellHeavy: number;
+    blocking: number;
+}
+interface TellRate {
+    tell: string;
+    hits: Record<Label, number>;
+    /** Hits on `ai` and `ai-looking` pages over all hits. */
+    precision: number;
+    /** `ai` and `ai-looking` pages hit, over all of them measured. Null when there are none. */
+    recall: number | null;
+}
+interface TargetCheck {
+    target: string;
+    /** Null when no page with that label was measured. */
+    met: boolean | null;
+    detail: string;
+}
+interface Calibration {
+    pages: number;
+    /** Whether typicality was measured, or tell-heavy alone decided. */
+    typicality: boolean;
+    labels: LabelSummary[];
+    tells: TellRate[];
+    /** Catalogue tells that fired on no page. */
+    silent: string[];
+    targets: TargetCheck[];
+    unmeasured: UnmeasuredPage[];
+}
+/** Tells about the look, not the words: what "tell-heavy" counts. */
+declare function designTells(tells: string[]): string[];
+declare function isFlagged(page: MeasuredPage): boolean;
+declare function calibrate(pages: MeasuredPage[], unmeasured?: UnmeasuredPage[]): Calibration;
+/** `notes` are lines the caller knows and the numbers do not show, printed under the heading. */
+declare function formatCalibration(c: Calibration, notes?: string[]): string;
+
 /**
  * The character report: the three signals and the reason rule, read together.
  *
@@ -2951,4 +3098,4 @@ declare function characterReport(input: CharacterInputs, copyTells?: Set<string>
 
 declare function retrofitPlan(report: CharacterReport, direction?: ArtDirection | null): string;
 
-export { ACCENT_SCALE, ACCENT_SHARED, AI_PHRASES, AI_SOURCE_TYPES, AI_VIOLET, AI_WORDS, type AccentFork, type AccentForkOptions, type Action, type ActionPosition, type Area, type ArtDirection, BASELINE_VERSION, BUZZWORDS, type Baseline, type BaselineEntry, CATALOGUE, CATALOGUE_VERSION, CHOICE_KEYS, COMPONENT_ROLES, CONSIDERATION, CONVENTION, CUSTOMER_KINDS, type CandidateKind, type CharacterInputs, type CharacterReport, type CheckOptions, type CheckReport, type CheckRestraintInput, type ChoiceKey, type Claim, type ClaimsReport, type CompetitorComparison, type ComponentPair, type ComponentTypicality, type Consideration, type ContrastCheck, type ContrastReport, type CopySide, type CopyTell, type CraftConfig, type CraftTokensInput, type CraftTokensResult, type CustomerKind, DEFAULT_IGNORE, DENSITIES, DENSITY_NAMES, DIRECTION_VERSION, DIRECTION_VERSIONS, DISTANCE_WEIGHTS, DURATION_MS, DURATION_S, type DensityCssOptions, type DensityName, type DirectionChoice, type DirectionComparison, type DirectionMatch, type DirectionProblem, type DirectionReport, type DirectionSource, type DirectionSummary, type DurationName, EASE, EASE_TUPLE, EDGE_STEP, ESTATE_VERSION, EXIT_RATIO, type EaseName, type EmitCssOptions, type EstateMatch, type EstatePair, type EstateRegister, type EstateSite, FINGERPRINT_VERSION, FUNCTION_WORDS, type Fact, type FactComparison, type FactKind, type Finding, type Fingerprint, type FingerprintDistance, type FingerprintSection, type FluidSpaceOptions, type FluidTypeOptions, type FluidTypeResult, type FontClass, GROUND_SCALE, GROUND_SHARED, type Gamut, type Generation, HIERARCHY_FIELDS, HOME_FILE, HOME_URL, HOUSE, HOUSE_BUDGET, HOUSE_LOCKED, HOUSE_TYPE, type HarvestCandidate, type HarvestOptions, type Hit, type HouseRule, type HouseTier, IMAGERY_TELLS, type ImageProvenance, type ImageRole, JSON_SCHEMA_VERSION, type JobContext, type JobMap, type JobPart, LICENCES, LIGHTNESS_CURVE, type LicenceEntry, type LicenceSubject, MIN_DECIDED, MIN_RUNS, MOOD, type MotionDecision, type MotionKind, type MultiClient, NEGATIVE_REASSURANCE, NULL_VERSION, type NullModel, type NullRun, type Oklch, type OklchToHexOptions, PAGE_TYPES, PILL_LIMIT, PLAINER_WORDS, PREFERENCE, PROMO_BADGE, PROOF_NAMES, PROPOSED, PROVENANCE_SCAN_BYTES, type PageCopy, type PageHierarchy, type PageResult, type PageType, type PaletteColour, type Proposal, type ProposeInput, RAMP_STEPS, READABLE_SNAPSHOT_VERSIONS, REFLEX_FONTS_1, REFLEX_FONTS_2, RENDERED_PATHS, RENDERED_TELLS, REVEAL_LIMIT, REVIEW_PHRASES, type Ramp, type RampFromAnchorsOptions, type RampOptions, type RampStep, type ReasonInput, type RenderedTell, type ResearchInput, type RestraintBudget, type RestraintReport, type RestraintSeverity, type RestraintViolation, type Rgb, type RgbaImage, SCALE, SECTION_ROLES, SHADCN_LIMIT, SHADCN_PRIMITIVES, SHARED_PART, SIBLING_AT, SNAPSHOT_VERSION, SOURCE_KINDS, SPACE_STEPS, SPECIFICITY_COPY_TELLS, SPECIFICITY_RENDERED_TELLS, SPRING, STANDING_CLAIM, STOCK_AVATAR_HOSTS, STOCK_FIGURES, STOCK_PHOTO_HOSTS, STOCK_PHRASES, type SarifOptions, type SarifTell, type SectionGeometry, type SectionKind, type SectionRhythmOptions, type SectionRole, type SemanticInput, type SemanticResult, type Severity, type SeverityLevel, type SeverityOverride, type ShapeFeatures, type ShouldAnimateInput, type SignalResult, type Snapshot, type SnapshotColour, type SnapshotControl, type SnapshotEffects, type SnapshotFont, type SnapshotGradient, type SnapshotHeading, type SnapshotImage, type SnapshotMotion, type SnapshotPatch, type SnapshotSection, type SnapshotVisual, type SourceFile, type SourceKind, type SourceTell, type SpaceStep, type Specific, type SpecificKind, type Specificity, type Surface, TELL_HEAVY, TRADE_NOUNS, TYPE_STEPS, TYPICAL_AT, type TailwindPreset, type Tell, type TellException, type Tricolon, type TypeStep, type Typicality, VAGUE_WORDS, type ValidateContext, type Verdict, accentFork, addSite, apcaContrast, applyBaseline, applyHouseGate, applySeverity, auditSnapshot, briefTerms, catalogueTable, characterReport, checkCopy, checkOrder, checkPair, checkReason, checkRestraint, choicesOf, clauseDepth, closestComponents, compareCompetitor, compareDirections, compareFacts, compareToDeclared, compareToEstate, componentDistance, componentShared, componentTypicalities, componentTypicality, componentsOf, contentWords, countWords, craftTokens, createBaseline, cv, deltaEOk, deltaEOkHex, densityCss, densityTokens, emitCss, emptyEstate, estateComponentPairs, estatePairs, exitDuration, extractHtml, faceLicence, findClaims, findColours, findingKey, fingerprint, fingerprintDistance, fluidClamp, fluidSpace, fluidType, fontClass, formatClaims, formatComparison, formatCompetitor, formatDirectionMatches, formatHex, formatReport, globToRegExp, groundName, harvest, hedgeCount, hedgedClose, hexToOklch, holdHouseBlocks, houseRule, hueName, hueSwatch, ignoreMatcher, inP3Gamut, inSrgbGamut, initDirection, isAiViolet, isBlurb, isCategoryLabel, isCream, jobWords, layoutDistance, licencesJson, makeSnapshot, motionTokens, namedSources, nearest, nominalisations, normaliseFamily, nullPrompt, oklchToHex, oklchToRgb, pageCopy, paletteFromPixels, paragraphUniformity, parseBaseline, parseColour, parseCraftConfig, parseHex, participialClauses, phrasalCoordinations, propose, protectedFacts, ramp, rampFromAnchors, readSnapshot, renderedOrder, researchPrompt, retrofitPlan, runTell, scanProvenance, scanSource, sectionRhythm, semantic, sentencesOf, severityExceptions, shapeMoves, shapeName, shapeOf, words as shapeWords, sharedParts, shouldAnimate, siblingLine, skeleton, skeletonRepeat, specificity, specifics, splitSentences, stackedConditional, stockAvatarSource, stockSource, summariseDirection, tailwindV3Preset, tailwindV4Theme, tellById, toGamut, toJson, toSarif, tradeOf, tricolons, typeFeatureTokens, typicality, unprovenClaims, validateDirection, validateHierarchy, validateJob, visibleText, visualMeasures, wcagContrast, wordListsJson };
+export { ACCENT_SCALE, ACCENT_SHARED, AI_PHRASES, AI_SOURCE_TYPES, AI_VIOLET, AI_WORDS, type AccentFork, type AccentForkOptions, type Action, type ActionPosition, type Area, type ArtDirection, BASELINE_VERSION, BUZZWORDS, type Baseline, type BaselineEntry, CATALOGUE, CATALOGUE_VERSION, CHOICE_KEYS, COMPONENT_ROLES, CONSIDERATION, CONVENTION, CUSTOMER_KINDS, type Calibration, type CandidateKind, type CharacterInputs, type CharacterReport, type CheckOptions, type CheckReport, type CheckRestraintInput, type ChoiceKey, type Claim, type ClaimsReport, type CompetitorComparison, type ComponentPair, type ComponentTypicality, type Consideration, type ContrastCheck, type ContrastReport, type CopySide, type CopyTell, type CraftConfig, type CraftTokensInput, type CraftTokensResult, type CustomerKind, DEFAULT_IGNORE, DENSITIES, DENSITY_NAMES, DIRECTION_VERSION, DIRECTION_VERSIONS, DISTANCE_WEIGHTS, DURATION_MS, DURATION_S, type DensityCssOptions, type DensityName, type DirectionChoice, type DirectionComparison, type DirectionMatch, type DirectionProblem, type DirectionReport, type DirectionSource, type DirectionSummary, type DurationName, EASE, EASE_TUPLE, EDGE_STEP, ESTATE_VERSION, EXIT_RATIO, type EaseName, type EmitCssOptions, type EstateMatch, type EstatePair, type EstateRegister, type EstateSite, FINGERPRINT_VERSION, FLAGGED_TARGET, FUNCTION_WORDS, type Fact, type FactComparison, type FactKind, type Finding, type Fingerprint, type FingerprintDistance, type FingerprintSection, type FluidSpaceOptions, type FluidTypeOptions, type FluidTypeResult, type FontClass, GROUND_SCALE, GROUND_SHARED, type Gamut, type Generation, HIERARCHY_FIELDS, HOME_FILE, HOME_URL, HOUSE, HOUSE_BUDGET, HOUSE_LOCKED, HOUSE_TYPE, HUMAN_TYPICAL_TARGET, type HarvestCandidate, type HarvestOptions, type Hit, type HouseRule, type HouseTier, IMAGERY_TELLS, type ImageProvenance, type ImageRole, JSON_SCHEMA_VERSION, type JobContext, type JobMap, type JobPart, LABELS, LEXICAL_FEATURES, LICENCES, LIGHTNESS_CURVE, type Label, type LabelSummary, type LexicalFeatures, type LicenceEntry, type LicenceSubject, MIN_DECIDED, MIN_RUNS, MOOD, type MeasuredPage, type MotionDecision, type MotionKind, type MultiClient, NEGATIVE_REASSURANCE, NULL_VERSION, type NullModel, type NullRun, type Oklch, type OklchToHexOptions, PAGE_TYPES, PILL_LIMIT, PLAINER_WORDS, PREFERENCE, PROMO_BADGE, PROOF_NAMES, PROPOSED, PROVENANCE_SCAN_BYTES, type PageCopy, type PageHierarchy, type PageResult, type PageType, type PaletteColour, type Proposal, type ProposeInput, RAMP_STEPS, READABLE_SNAPSHOT_VERSIONS, REFLEX_FONTS_1, REFLEX_FONTS_2, RENDERED_PATHS, RENDERED_TELLS, REVEAL_LIMIT, REVIEW_PHRASES, type Ramp, type RampFromAnchorsOptions, type RampOptions, type RampStep, type ReasonInput, type RenderedTell, type ResearchInput, type RestraintBudget, type RestraintReport, type RestraintSeverity, type RestraintViolation, type Rgb, type RgbaImage, SCALE, SECTION_ROLES, SHADCN_LIMIT, SHADCN_PRIMITIVES, SHARED_PART, SIBLING_AT, SNAPSHOT_VERSION, SOURCE_KINDS, SPACE_STEPS, SPECIFICITY_COPY_TELLS, SPECIFICITY_RENDERED_TELLS, SPRING, STANDING_CLAIM, STOCK_AVATAR_HOSTS, STOCK_FIGURES, STOCK_PHOTO_HOSTS, STOCK_PHRASES, STUDY_WORDS, type SarifOptions, type SarifTell, type SectionGeometry, type SectionKind, type SectionRhythmOptions, type SectionRole, type SemanticInput, type SemanticResult, type Severity, type SeverityLevel, type SeverityOverride, type ShapeFeatures, type ShouldAnimateInput, type SignalResult, type Snapshot, type SnapshotColour, type SnapshotControl, type SnapshotEffects, type SnapshotFont, type SnapshotGradient, type SnapshotHeading, type SnapshotImage, type SnapshotMotion, type SnapshotPatch, type SnapshotSection, type SnapshotVisual, type SourceFile, type SourceKind, type SourceTell, type SpaceStep, type Specific, type SpecificKind, type Specificity, type StudyWord, type Surface, TELL_HEAVY, TRADE_NOUNS, TYPE_STEPS, TYPICAL_AT, type TailwindPreset, type TargetCheck, type Tell, type TellException, type TellRate, type Tricolon, type TypeStep, type Typicality, type UnmeasuredPage, VAGUE_WORDS, type ValidateContext, type Verdict, accentFork, addSite, apcaContrast, applyBaseline, applyHouseGate, applySeverity, auditSnapshot, briefTerms, calibrate, catalogueTable, characterReport, checkCopy, checkOrder, checkPair, checkReason, checkRestraint, choicesOf, clauseDepth, closestComponents, compareCompetitor, compareDirections, compareFacts, compareToDeclared, compareToEstate, componentDistance, componentShared, componentTypicalities, componentTypicality, componentsOf, contentWords, countWords, craftTokens, createBaseline, cv, deltaEOk, deltaEOkHex, densityCss, densityTokens, designTells, emitCss, emptyEstate, estateComponentPairs, estatePairs, exitDuration, extractHtml, faceLicence, findClaims, findColours, findingKey, fingerprint, fingerprintDistance, fluidClamp, fluidSpace, fluidType, fontClass, formatCalibration, formatClaims, formatComparison, formatCompetitor, formatDirectionMatches, formatHex, formatReport, globToRegExp, groundName, harvest, hedgeCount, hedgedClose, hexToOklch, holdHouseBlocks, houseRule, hueName, hueSwatch, ignoreMatcher, inP3Gamut, inSrgbGamut, initDirection, isAiViolet, isBlurb, isCategoryLabel, isCream, isFlagged, jobWords, layoutDistance, lexicalOf, licencesJson, makeSnapshot, motionTokens, namedSources, nearest, nominalisations, normaliseFamily, nullPrompt, oklchToHex, oklchToRgb, pageCopy, paletteFromPixels, paragraphUniformity, parseBaseline, parseColour, parseCraftConfig, parseHex, participialClauses, phrasalCoordinations, propose, protectedFacts, ramp, rampFromAnchors, readSnapshot, renderedOrder, researchPrompt, retrofitPlan, runTell, scanProvenance, scanSource, sectionRhythm, semantic, sentencesOf, severityExceptions, shapeMoves, shapeName, shapeOf, words as shapeWords, sharedParts, shouldAnimate, siblingLine, skeleton, skeletonRepeat, specificity, specifics, splitSentences, stackedConditional, stockAvatarSource, stockSource, summariseDirection, tailwindV3Preset, tailwindV4Theme, tellById, toGamut, toJson, toSarif, tradeOf, tricolons, typeFeatureTokens, typicality, unprovenClaims, validateDirection, validateHierarchy, validateJob, visibleText, visualMeasures, vocabulary, vocabularyCounts, wcagContrast, wordListsJson };

package/dist/index.d.ts

@@ -1546,6 +1546,60 @@ declare function paragraphUniformity(paragraphs: string[]): number | null;
 /** A block the size of a blurb: 2 to 8 sentences, 20 to 160 words. */
 declare function isBlurb(f: Pick<ShapeFeatures, "sentences" | "words">): boolean;
 
+/**
+ * Lexical and specificity features for a short block of copy.
+ *
+ * The sentence-shape features (shape.ts) did not separate model copy from
+ * people's at blurb length. These measure what a block says and which words it
+ * reaches for: how many of the tell words and phrases craft already lists, how
+ * many words with published excess-use evidence, and how particular the block
+ * is (names, places, figures, the nouns of the trade).
+ *
+ * Pure and zero-dependency, and used both by the calibration scripts and by
+ * any tell that ships on the result.
+ *
+ * Every word in STUDY_WORDS carries its source. Models change what they
+ * over-use between generations (Juzek and Ward found "boasts" gone and
+ * "underscore" up sharply from GPT-3.5 to GPT-4o-mini), so a listed word is a
+ * measurement with a date, not a fact about models.
+ */
+interface StudyWord {
+    word: string;
+    source: string;
+}
+/**
+ * Words with published excess-use evidence. Academic register, so a word here
+ * is a candidate to measure in marketing copy, not a tell.
+ */
+declare const STUDY_WORDS: readonly StudyWord[];
+/** Every word or phrase the features look for, with where it came from. */
+declare function vocabulary(): {
+    word: string;
+    source: string;
+}[];
+/** Occurrences per vocabulary word in the text. */
+declare function vocabularyCounts(text: string): Map<string, number>;
+interface LexicalFeatures {
+    /** Hits from craft's own tell lists, per 100 words. */
+    listRate: number;
+    /** Hits from the published excess-use words, per 100 words. */
+    studyRate: number;
+    /** Distinct specifics (names, places, figures, dates, contact details, brief terms) per 100 words. */
+    hardPer100: number;
+    /** Distinct trade nouns per 100 words. */
+    tradePer100: number;
+    /** All specifics per 100 words. */
+    specificsPer100: number;
+    /** 1 when there is no hard specific and fewer than two trade nouns. */
+    generic: number;
+    /** Distinct money, date, time and number specifics. */
+    figures: number;
+    /** Distinct names and brief terms. */
+    names: number;
+}
+declare const LEXICAL_FEATURES: readonly (keyof LexicalFeatures)[];
+declare function lexicalOf(text: string, brief?: string): LexicalFeatures;
+
 /**
  * Specificity tells: a page that could belong to anyone.
  *
@@ -2349,9 +2403,18 @@ interface NullRun {
 interface NullModel {
     version: typeof NULL_VERSION;
     brief: string;
+    /**
+     * The prompt each page was built from. For imported pages, the prompt the
+     * person was asked to give the builder: `craft null prompt` prints it.
+     */
     prompt: string;
-    /** What was asked for with --model, or "default". */
+    /** What was asked for with --model, or "default"; "unknown" for imported pages unless given. */
     model: string;
+    /**
+     * The tool that built the pages, when they were imported rather than
+     * generated here: "v0", "lovable". Absent for `craft null build`.
+     */
+    builder?: string;
     catalogueVersion: string;
     builtAt: string;
     runs: NullRun[];
@@ -2876,6 +2939,90 @@ declare function propose(input: ProposeInput): {
     direction: ArtDirection;
 };
 
+/**
+ * Calibration: how well the catalogue separates pages a person has labelled.
+ *
+ * A labelled set holds three kinds of page. `ai` pages were generated. `human`
+ * pages were made by people. `ai-looking` pages were made by people and still
+ * read as generated to someone who looks at many sites: they are what the
+ * tells are for, since a tell detects a look, not a maker. So a tell's hit on
+ * an `ai` or an `ai-looking` page counts for it, and a hit on a `human` page
+ * counts against it.
+ *
+ * The verdict is the one CHARACTER.md fixed before any result was read: a page
+ * is flagged when it is typical against the null models, or tell-heavy (three
+ * or more distinct design tells). With no null models, tell-heavy decides.
+ *
+ * The targets are CHARACTER.md's first three. Target 4 (no siblings in the
+ * estate) is `craft estate compare`; target 5 (people cannot tell) is the blind
+ * test in docs/blind-test.md, which no tool here can run.
+ *
+ * Pure. Taking snapshots and reading files lives in the CLI.
+ */
+declare const LABELS: readonly ["ai", "ai-looking", "human"];
+type Label = (typeof LABELS)[number];
+/** Targets 1 and 3: this share of the set flagged, or more. */
+declare const FLAGGED_TARGET = 0.9;
+/** Target 2: this share of the human set typical, or less. */
+declare const HUMAN_TYPICAL_TARGET = 0.1;
+interface MeasuredPage {
+    id: string;
+    label: Label;
+    /** Every catalogue tell found on the page, each once. */
+    tells: string[];
+    /** Findings in the blocking tier. */
+    blocking: number;
+    /** Against the pooled null models; absent when none were given. */
+    typicality?: {
+        score: number;
+        typical: boolean;
+    };
+}
+interface UnmeasuredPage {
+    id: string;
+    label: Label;
+    reason: string;
+}
+interface LabelSummary {
+    label: Label;
+    pages: number;
+    flagged: number;
+    typical: number | null;
+    tellHeavy: number;
+    blocking: number;
+}
+interface TellRate {
+    tell: string;
+    hits: Record<Label, number>;
+    /** Hits on `ai` and `ai-looking` pages over all hits. */
+    precision: number;
+    /** `ai` and `ai-looking` pages hit, over all of them measured. Null when there are none. */
+    recall: number | null;
+}
+interface TargetCheck {
+    target: string;
+    /** Null when no page with that label was measured. */
+    met: boolean | null;
+    detail: string;
+}
+interface Calibration {
+    pages: number;
+    /** Whether typicality was measured, or tell-heavy alone decided. */
+    typicality: boolean;
+    labels: LabelSummary[];
+    tells: TellRate[];
+    /** Catalogue tells that fired on no page. */
+    silent: string[];
+    targets: TargetCheck[];
+    unmeasured: UnmeasuredPage[];
+}
+/** Tells about the look, not the words: what "tell-heavy" counts. */
+declare function designTells(tells: string[]): string[];
+declare function isFlagged(page: MeasuredPage): boolean;
+declare function calibrate(pages: MeasuredPage[], unmeasured?: UnmeasuredPage[]): Calibration;
+/** `notes` are lines the caller knows and the numbers do not show, printed under the heading. */
+declare function formatCalibration(c: Calibration, notes?: string[]): string;
+
 /**
  * The character report: the three signals and the reason rule, read together.
  *
@@ -2951,4 +3098,4 @@ declare function characterReport(input: CharacterInputs, copyTells?: Set<string>
 
 declare function retrofitPlan(report: CharacterReport, direction?: ArtDirection | null): string;
 
-export { ACCENT_SCALE, ACCENT_SHARED, AI_PHRASES, AI_SOURCE_TYPES, AI_VIOLET, AI_WORDS, type AccentFork, type AccentForkOptions, type Action, type ActionPosition, type Area, type ArtDirection, BASELINE_VERSION, BUZZWORDS, type Baseline, type BaselineEntry, CATALOGUE, CATALOGUE_VERSION, CHOICE_KEYS, COMPONENT_ROLES, CONSIDERATION, CONVENTION, CUSTOMER_KINDS, type CandidateKind, type CharacterInputs, type CharacterReport, type CheckOptions, type CheckReport, type CheckRestraintInput, type ChoiceKey, type Claim, type ClaimsReport, type CompetitorComparison, type ComponentPair, type ComponentTypicality, type Consideration, type ContrastCheck, type ContrastReport, type CopySide, type CopyTell, type CraftConfig, type CraftTokensInput, type CraftTokensResult, type CustomerKind, DEFAULT_IGNORE, DENSITIES, DENSITY_NAMES, DIRECTION_VERSION, DIRECTION_VERSIONS, DISTANCE_WEIGHTS, DURATION_MS, DURATION_S, type DensityCssOptions, type DensityName, type DirectionChoice, type DirectionComparison, type DirectionMatch, type DirectionProblem, type DirectionReport, type DirectionSource, type DirectionSummary, type DurationName, EASE, EASE_TUPLE, EDGE_STEP, ESTATE_VERSION, EXIT_RATIO, type EaseName, type EmitCssOptions, type EstateMatch, type EstatePair, type EstateRegister, type EstateSite, FINGERPRINT_VERSION, FUNCTION_WORDS, type Fact, type FactComparison, type FactKind, type Finding, type Fingerprint, type FingerprintDistance, type FingerprintSection, type FluidSpaceOptions, type FluidTypeOptions, type FluidTypeResult, type FontClass, GROUND_SCALE, GROUND_SHARED, type Gamut, type Generation, HIERARCHY_FIELDS, HOME_FILE, HOME_URL, HOUSE, HOUSE_BUDGET, HOUSE_LOCKED, HOUSE_TYPE, type HarvestCandidate, type HarvestOptions, type Hit, type HouseRule, type HouseTier, IMAGERY_TELLS, type ImageProvenance, type ImageRole, JSON_SCHEMA_VERSION, type JobContext, type JobMap, type JobPart, LICENCES, LIGHTNESS_CURVE, type LicenceEntry, type LicenceSubject, MIN_DECIDED, MIN_RUNS, MOOD, type MotionDecision, type MotionKind, type MultiClient, NEGATIVE_REASSURANCE, NULL_VERSION, type NullModel, type NullRun, type Oklch, type OklchToHexOptions, PAGE_TYPES, PILL_LIMIT, PLAINER_WORDS, PREFERENCE, PROMO_BADGE, PROOF_NAMES, PROPOSED, PROVENANCE_SCAN_BYTES, type PageCopy, type PageHierarchy, type PageResult, type PageType, type PaletteColour, type Proposal, type ProposeInput, RAMP_STEPS, READABLE_SNAPSHOT_VERSIONS, REFLEX_FONTS_1, REFLEX_FONTS_2, RENDERED_PATHS, RENDERED_TELLS, REVEAL_LIMIT, REVIEW_PHRASES, type Ramp, type RampFromAnchorsOptions, type RampOptions, type RampStep, type ReasonInput, type RenderedTell, type ResearchInput, type RestraintBudget, type RestraintReport, type RestraintSeverity, type RestraintViolation, type Rgb, type RgbaImage, SCALE, SECTION_ROLES, SHADCN_LIMIT, SHADCN_PRIMITIVES, SHARED_PART, SIBLING_AT, SNAPSHOT_VERSION, SOURCE_KINDS, SPACE_STEPS, SPECIFICITY_COPY_TELLS, SPECIFICITY_RENDERED_TELLS, SPRING, STANDING_CLAIM, STOCK_AVATAR_HOSTS, STOCK_FIGURES, STOCK_PHOTO_HOSTS, STOCK_PHRASES, type SarifOptions, type SarifTell, type SectionGeometry, type SectionKind, type SectionRhythmOptions, type SectionRole, type SemanticInput, type SemanticResult, type Severity, type SeverityLevel, type SeverityOverride, type ShapeFeatures, type ShouldAnimateInput, type SignalResult, type Snapshot, type SnapshotColour, type SnapshotControl, type SnapshotEffects, type SnapshotFont, type SnapshotGradient, type SnapshotHeading, type SnapshotImage, type SnapshotMotion, type SnapshotPatch, type SnapshotSection, type SnapshotVisual, type SourceFile, type SourceKind, type SourceTell, type SpaceStep, type Specific, type SpecificKind, type Specificity, type Surface, TELL_HEAVY, TRADE_NOUNS, TYPE_STEPS, TYPICAL_AT, type TailwindPreset, type Tell, type TellException, type Tricolon, type TypeStep, type Typicality, VAGUE_WORDS, type ValidateContext, type Verdict, accentFork, addSite, apcaContrast, applyBaseline, applyHouseGate, applySeverity, auditSnapshot, briefTerms, catalogueTable, characterReport, checkCopy, checkOrder, checkPair, checkReason, checkRestraint, choicesOf, clauseDepth, closestComponents, compareCompetitor, compareDirections, compareFacts, compareToDeclared, compareToEstate, componentDistance, componentShared, componentTypicalities, componentTypicality, componentsOf, contentWords, countWords, craftTokens, createBaseline, cv, deltaEOk, deltaEOkHex, densityCss, densityTokens, emitCss, emptyEstate, estateComponentPairs, estatePairs, exitDuration, extractHtml, faceLicence, findClaims, findColours, findingKey, fingerprint, fingerprintDistance, fluidClamp, fluidSpace, fluidType, fontClass, formatClaims, formatComparison, formatCompetitor, formatDirectionMatches, formatHex, formatReport, globToRegExp, groundName, harvest, hedgeCount, hedgedClose, hexToOklch, holdHouseBlocks, houseRule, hueName, hueSwatch, ignoreMatcher, inP3Gamut, inSrgbGamut, initDirection, isAiViolet, isBlurb, isCategoryLabel, isCream, jobWords, layoutDistance, licencesJson, makeSnapshot, motionTokens, namedSources, nearest, nominalisations, normaliseFamily, nullPrompt, oklchToHex, oklchToRgb, pageCopy, paletteFromPixels, paragraphUniformity, parseBaseline, parseColour, parseCraftConfig, parseHex, participialClauses, phrasalCoordinations, propose, protectedFacts, ramp, rampFromAnchors, readSnapshot, renderedOrder, researchPrompt, retrofitPlan, runTell, scanProvenance, scanSource, sectionRhythm, semantic, sentencesOf, severityExceptions, shapeMoves, shapeName, shapeOf, words as shapeWords, sharedParts, shouldAnimate, siblingLine, skeleton, skeletonRepeat, specificity, specifics, splitSentences, stackedConditional, stockAvatarSource, stockSource, summariseDirection, tailwindV3Preset, tailwindV4Theme, tellById, toGamut, toJson, toSarif, tradeOf, tricolons, typeFeatureTokens, typicality, unprovenClaims, validateDirection, validateHierarchy, validateJob, visibleText, visualMeasures, wcagContrast, wordListsJson };
+export { ACCENT_SCALE, ACCENT_SHARED, AI_PHRASES, AI_SOURCE_TYPES, AI_VIOLET, AI_WORDS, type AccentFork, type AccentForkOptions, type Action, type ActionPosition, type Area, type ArtDirection, BASELINE_VERSION, BUZZWORDS, type Baseline, type BaselineEntry, CATALOGUE, CATALOGUE_VERSION, CHOICE_KEYS, COMPONENT_ROLES, CONSIDERATION, CONVENTION, CUSTOMER_KINDS, type Calibration, type CandidateKind, type CharacterInputs, type CharacterReport, type CheckOptions, type CheckReport, type CheckRestraintInput, type ChoiceKey, type Claim, type ClaimsReport, type CompetitorComparison, type ComponentPair, type ComponentTypicality, type Consideration, type ContrastCheck, type ContrastReport, type CopySide, type CopyTell, type CraftConfig, type CraftTokensInput, type CraftTokensResult, type CustomerKind, DEFAULT_IGNORE, DENSITIES, DENSITY_NAMES, DIRECTION_VERSION, DIRECTION_VERSIONS, DISTANCE_WEIGHTS, DURATION_MS, DURATION_S, type DensityCssOptions, type DensityName, type DirectionChoice, type DirectionComparison, type DirectionMatch, type DirectionProblem, type DirectionReport, type DirectionSource, type DirectionSummary, type DurationName, EASE, EASE_TUPLE, EDGE_STEP, ESTATE_VERSION, EXIT_RATIO, type EaseName, type EmitCssOptions, type EstateMatch, type EstatePair, type EstateRegister, type EstateSite, FINGERPRINT_VERSION, FLAGGED_TARGET, FUNCTION_WORDS, type Fact, type FactComparison, type FactKind, type Finding, type Fingerprint, type FingerprintDistance, type FingerprintSection, type FluidSpaceOptions, type FluidTypeOptions, type FluidTypeResult, type FontClass, GROUND_SCALE, GROUND_SHARED, type Gamut, type Generation, HIERARCHY_FIELDS, HOME_FILE, HOME_URL, HOUSE, HOUSE_BUDGET, HOUSE_LOCKED, HOUSE_TYPE, HUMAN_TYPICAL_TARGET, type HarvestCandidate, type HarvestOptions, type Hit, type HouseRule, type HouseTier, IMAGERY_TELLS, type ImageProvenance, type ImageRole, JSON_SCHEMA_VERSION, type JobContext, type JobMap, type JobPart, LABELS, LEXICAL_FEATURES, LICENCES, LIGHTNESS_CURVE, type Label, type LabelSummary, type LexicalFeatures, type LicenceEntry, type LicenceSubject, MIN_DECIDED, MIN_RUNS, MOOD, type MeasuredPage, type MotionDecision, type MotionKind, type MultiClient, NEGATIVE_REASSURANCE, NULL_VERSION, type NullModel, type NullRun, type Oklch, type OklchToHexOptions, PAGE_TYPES, PILL_LIMIT, PLAINER_WORDS, PREFERENCE, PROMO_BADGE, PROOF_NAMES, PROPOSED, PROVENANCE_SCAN_BYTES, type PageCopy, type PageHierarchy, type PageResult, type PageType, type PaletteColour, type Proposal, type ProposeInput, RAMP_STEPS, READABLE_SNAPSHOT_VERSIONS, REFLEX_FONTS_1, REFLEX_FONTS_2, RENDERED_PATHS, RENDERED_TELLS, REVEAL_LIMIT, REVIEW_PHRASES, type Ramp, type RampFromAnchorsOptions, type RampOptions, type RampStep, type ReasonInput, type RenderedTell, type ResearchInput, type RestraintBudget, type RestraintReport, type RestraintSeverity, type RestraintViolation, type Rgb, type RgbaImage, SCALE, SECTION_ROLES, SHADCN_LIMIT, SHADCN_PRIMITIVES, SHARED_PART, SIBLING_AT, SNAPSHOT_VERSION, SOURCE_KINDS, SPACE_STEPS, SPECIFICITY_COPY_TELLS, SPECIFICITY_RENDERED_TELLS, SPRING, STANDING_CLAIM, STOCK_AVATAR_HOSTS, STOCK_FIGURES, STOCK_PHOTO_HOSTS, STOCK_PHRASES, STUDY_WORDS, type SarifOptions, type SarifTell, type SectionGeometry, type SectionKind, type SectionRhythmOptions, type SectionRole, type SemanticInput, type SemanticResult, type Severity, type SeverityLevel, type SeverityOverride, type ShapeFeatures, type ShouldAnimateInput, type SignalResult, type Snapshot, type SnapshotColour, type SnapshotControl, type SnapshotEffects, type SnapshotFont, type SnapshotGradient, type SnapshotHeading, type SnapshotImage, type SnapshotMotion, type SnapshotPatch, type SnapshotSection, type SnapshotVisual, type SourceFile, type SourceKind, type SourceTell, type SpaceStep, type Specific, type SpecificKind, type Specificity, type StudyWord, type Surface, TELL_HEAVY, TRADE_NOUNS, TYPE_STEPS, TYPICAL_AT, type TailwindPreset, type TargetCheck, type Tell, type TellException, type TellRate, type Tricolon, type TypeStep, type Typicality, type UnmeasuredPage, VAGUE_WORDS, type ValidateContext, type Verdict, accentFork, addSite, apcaContrast, applyBaseline, applyHouseGate, applySeverity, auditSnapshot, briefTerms, calibrate, catalogueTable, characterReport, checkCopy, checkOrder, checkPair, checkReason, checkRestraint, choicesOf, clauseDepth, closestComponents, compareCompetitor, compareDirections, compareFacts, compareToDeclared, compareToEstate, componentDistance, componentShared, componentTypicalities, componentTypicality, componentsOf, contentWords, countWords, craftTokens, createBaseline, cv, deltaEOk, deltaEOkHex, densityCss, densityTokens, designTells, emitCss, emptyEstate, estateComponentPairs, estatePairs, exitDuration, extractHtml, faceLicence, findClaims, findColours, findingKey, fingerprint, fingerprintDistance, fluidClamp, fluidSpace, fluidType, fontClass, formatCalibration, formatClaims, formatComparison, formatCompetitor, formatDirectionMatches, formatHex, formatReport, globToRegExp, groundName, harvest, hedgeCount, hedgedClose, hexToOklch, holdHouseBlocks, houseRule, hueName, hueSwatch, ignoreMatcher, inP3Gamut, inSrgbGamut, initDirection, isAiViolet, isBlurb, isCategoryLabel, isCream, isFlagged, jobWords, layoutDistance, lexicalOf, licencesJson, makeSnapshot, motionTokens, namedSources, nearest, nominalisations, normaliseFamily, nullPrompt, oklchToHex, oklchToRgb, pageCopy, paletteFromPixels, paragraphUniformity, parseBaseline, parseColour, parseCraftConfig, parseHex, participialClauses, phrasalCoordinations, propose, protectedFacts, ramp, rampFromAnchors, readSnapshot, renderedOrder, researchPrompt, retrofitPlan, runTell, scanProvenance, scanSource, sectionRhythm, semantic, sentencesOf, severityExceptions, shapeMoves, shapeName, shapeOf, words as shapeWords, sharedParts, shouldAnimate, siblingLine, skeleton, skeletonRepeat, specificity, specifics, splitSentences, stackedConditional, stockAvatarSource, stockSource, summariseDirection, tailwindV3Preset, tailwindV4Theme, tellById, toGamut, toJson, toSarif, tradeOf, tricolons, typeFeatureTokens, typicality, unprovenClaims, validateDirection, validateHierarchy, validateJob, visibleText, visualMeasures, vocabulary, vocabularyCounts, wcagContrast, wordListsJson };