@domandigital/craft 0.21.0 → 0.22.1

package/dist/index.d.cts

@@ -1252,7 +1252,7 @@ interface CheckReport {
  * Bumped whenever an entry is added, removed or its detection changes, so a
  * report can say which list it was judged against.
  */
-declare const CATALOGUE_VERSION = "2026.10.4";
+declare const CATALOGUE_VERSION = "2026.10.5";
 declare const CATALOGUE: readonly Tell[];
 declare function tellById(id: string): Tell | undefined;
 /**
@@ -2658,6 +2658,14 @@ type EvidenceKind = (typeof EVIDENCE_KINDS)[number];
  */
 declare const CHANGE_CLASSES: readonly ["confirmed-correction", "design-hypothesis", "optional-refinement", "no-change"];
 type ChangeClass = (typeof CHANGE_CLASSES)[number];
+/**
+ * What was done with a note in a reviewer's own record (`reviews/`).
+ * take-reworded: the diagnosis is taken and the suggested wording rewritten,
+ * because a reviewer's lines are copy-checked like anyone's. partly: the aim
+ * is taken by a smaller or different change. known: already tracked.
+ */
+declare const REVIEW_VERDICTS: readonly ["praise", "take", "take-reworded", "partly", "decline", "founder-decision", "known"];
+type ReviewVerdict = (typeof REVIEW_VERDICTS)[number];
 /**
  * The ladder of minimum effective change, smallest first. The last two are
  * structural and have to say why every smaller step was not enough.
@@ -2728,6 +2736,29 @@ interface ReviewNote {
             placeholder?: string;
         }[];
     };
+    /** Where the note was left, so it can be found again: `{ tool: "pastel", canvas, comment, url }`. */
+    source?: {
+        tool: string;
+        canvas?: number | string;
+        comment?: number | string;
+        commentId?: number | string;
+        url?: string;
+        at?: string;
+    };
+    /** What was done with it, in a reviewer corpus. */
+    verdict?: ReviewVerdict;
+    /** The founder's call where the note needed one: the decision, stated and dated. */
+    founderRuling?: {
+        date: string;
+        ruling: string;
+    };
+    /** The principle it teaches, by its id in CHARACTER.md. */
+    principle?: string;
+    /** Tells it informed; with text, the words that tell must fire on. */
+    tells?: {
+        id: string;
+        text?: string;
+    }[];
 }
 interface DesignReview {
     /** Publication is the default. Protected previews may reserve explicitly marked assets. */
@@ -2736,6 +2767,21 @@ interface DesignReview {
     version: 1;
     /** Who or what was reviewed, and at which width. */
     subject: string;
+    /** In a reviewer corpus: whose review this is, the day, where it was given and who ruled on it. */
+    reviewer?: string;
+    date?: string;
+    source?: {
+        tool: string;
+        canvas?: number | string;
+        link?: string;
+        comments?: number;
+        from?: string;
+        to?: string;
+    };
+    rulings?: {
+        by: string;
+        date: string;
+    };
     notes: ReviewNote[];
 }
 type ReviewOutcome = "change" | "hold" | "no-change" | "gather-evidence";
@@ -3225,7 +3271,7 @@ declare const NEGATIVE_REASSURANCE: readonly ["no risk", "never locked in", "not
 /** Banned only when vague. Reported for review, never blocking. */
 declare const VAGUE_WORDS: readonly ["innovative", "scalable", "end-to-end", "streamline", "solutions"];
 /** The review tier of copy-rules.md: normal English once, a tell when stacked. */
-declare const REVIEW_PHRASES: readonly ["great question", "of course!", "absolutely!", "absolutely,", "truly", "genuinely", "deeply", "clear", "clearly", "ultimately", "one-size-fits-all", "one size fits all", "let me know if you'd", "the single most", "by far the most", "hands down the", "arguably the best", "bar none"];
+declare const REVIEW_PHRASES: readonly ["great question", "of course!", "absolutely!", "absolutely,", "truly", "genuinely", "deeply", "clear", "clearly", "ultimately", "one-size-fits-all", "one size fits all", "let me know if you'd", "the single most", "by far the most", "hands down the", "arguably the best", "bar none", "plain answer", "plain answers", "plain recommendation", "plain explanation", "plain explanations", "plain advice", "plain guidance", "plain-speaking", "plain speaking"];
 
 /**
  * The reason rule, one standard for every layer of an art direction.
@@ -3731,4 +3777,4 @@ declare function characterReport(input: CharacterInputs, copyTells?: Set<string>
 
 declare function retrofitPlan(report: CharacterReport, direction?: ArtDirection | null): string;
 
-export { ACCENT_SCALE, ACCENT_SHARED, ADDITIONS, AI_PHRASES, AI_SOURCE_TYPES, AI_VIOLET, AI_WORDS, type AccentFork, type AccentForkOptions, type Action, type ActionPosition, type Addition, type Area, type ArtDirection, BASELINE_VERSION, BUZZWORDS, type Band, type Baseline, type BaselineEntry, CATALOGUE, CATALOGUE_VERSION, CHANGE_CLASSES, CHANGE_STEPS, CHOICE_KEYS, COMPONENT_ROLES, CONFIDENCE_LENSES, CONSIDERATION, CONTENT_FEATURES, CONVENTION, CUSTOMER_KINDS, type Calibration, type CandidateKind, type ChangeClass, type ChangeStep, type CharacterInputs, type CharacterReport, type CheckOptions, type CheckReport, type CheckRestraintInput, type ChoiceKey, type Claim, type ClaimsReport, type CompetitorComparison, type ComponentPair, type ComponentTypicality, type ConfidenceBasis, type ConfidenceContext, type ConfidenceFinding, type ConfidenceLens, 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 DesignReview, type DirectionChoice, type DirectionComparison, type DirectionMatch, type DirectionProblem, type DirectionReport, type DirectionSource, type DirectionSummary, type DurationName, EASE, EASE_TUPLE, EDGE_STEP, ESTATE_VERSION, EVIDENCE_KINDS, EXIT_RATIO, type EaseName, type EmitCssOptions, type EstateMatch, type EstatePair, type EstateRegister, type EstateSite, type EvidenceKind, FINGERPRINT_VERSION, FLAGGED_TARGET, FUNCTION_WORDS, type Fact, type FactComparison, type FactKind, type Finding, type Fingerprint, type FingerprintDistance, type FingerprintHero, type FingerprintSection, type FluidSpaceOptions, type FluidTypeOptions, type FluidTypeResult, type FontClass, GROUND_SCALE, GROUND_SHARED, type Gamut, type Generation, type GradientContrast, HIERARCHY_FIELDS, HOME_FILE, HOME_URL, HOUSE, HOUSE_BUDGET, HOUSE_LOCKED, HOUSE_TYPE, HUMAN_TYPICAL_TARGET, type HarvestCandidate, type HarvestOptions, type HeroImage, type Hit, type HouseRule, type HouseTier, IMAGERY_TELLS, INSPECTED_KINDS, 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, type LightnessBand, MIN_DECIDED, MIN_PARAGRAPHS, MIN_RUNS, MOOD, type MeasuredPage, type MotionDecision, type MotionKind, type MultiClient, NEGATIVE_REASSURANCE, NULL_VERSION, type NullModel, type NullRun, OPENING_BANDS, type Oklch, type OklchToHexOptions, PAGE_TYPES, PILL_LIMIT, PLAINER_WORDS, PREFERENCE, PROFILE, PROFILE_MEASURED, PROFILE_PARAGRAPHS, PROMO_BADGE, PROOF_DEPTHS, PROOF_KINDS, PROOF_NAMES, PROPOSED, PROVENANCE_SCAN_BYTES, type PageConfidence, type PageCopy, type PageHierarchy, type PageResult, type PageType, type PaletteColour, type PhotoReviewOptions, type PhotoReviewResult, type ProofDepth, type ProofItem, type ProofKind, type Proposal, type ProposeInput, RAMP_STEPS, READABLE_SNAPSHOT_VERSIONS, REFLEX_FONTS_1, REFLEX_FONTS_2, REGISTERS, REGISTER_BASELINE, REGISTER_FEATURES, REGISTER_IDS, RENDERED_PATHS, RENDERED_TELLS, REPORTED_KINDS, REVEAL_LIMIT, REVIEW_BASES, REVIEW_PHRASES, type Ramp, type RampFromAnchorsOptions, type RampOptions, type RampStep, type ReasonInput, type Register, type RegisterCheck, type RegisterFeatures, type RegisterId, type RegisterProfile, type RenderedTell, type ResearchInput, type RestraintBudget, type RestraintReport, type RestraintSeverity, type RestraintViolation, type ReviewBasis, type ReviewEvidence, type ReviewNote, type ReviewOutcome, type ReviewProposal, type ReviewReport, type ReviewResult, type Rgb, type RgbaImage, SAMPLES_PER_SEGMENT, 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 SuggestionStanding, type Surface, TELL_HEAVY, TEMPERATURE_FULL, TEMPERATURE_NAMED, TEMPERATURE_WEIGHT, TRADE_NOUNS, TYPE_STEPS, TYPICAL_AT, type TailwindPreset, type TargetCheck, type Tell, type TellException, type TellRate, type Temperature, type Tricolon, type TypeStep, type Typicality, type UnmeasuredPage, VAGUE_WORDS, VIEWPORTS, type ValidateContext, type Verdict, type Viewport, accentFork, addSite, apcaContrast, applyBaseline, applyHouseGate, applySeverity, assessConfidence, assessReview, auditSnapshot, bandOf, briefTerms, calibrate, catalogueTable, characterReport, checkCopy, checkOrder, checkPair, checkPhotoReview, checkReason, checkRegister, checkRestraint, choicesOf, clauseDepth, closestComponents, compareCompetitor, compareDirections, compareFacts, compareToDeclared, compareToEstate, componentDistance, componentShared, componentTypicalities, componentTypicality, componentsOf, contentWords, countWords, craftTokens, createBaseline, cv, deltaEOk, deltaEOkHex, densityCss, densityTokens, designTells, documentParagraphs, emitCss, emptyEstate, estateComponentPairs, estatePairs, exitDuration, extractHtml, faceLicence, featureLabel, findClaims, findColours, findingKey, fingerprint, fingerprintDistance, fluidClamp, fluidSpace, fluidType, fontClass, formatCalibration, formatClaims, formatComparison, formatCompetitor, formatDirectionMatches, formatHex, formatReport, getRegister, globToRegExp, gradientContrast, gradientStops, groundDistance, groundLabel, groundName, groundTemperature, harvest, hedgeCount, hedgedClose, heroDistance, hexToOklch, holdHouseBlocks, houseRule, hueName, hueSwatch, ignoreMatcher, inP3Gamut, inSrgbGamut, initDirection, isAiViolet, isBlurb, isCategoryLabel, isCream, isFlagged, isStructural, 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, registerBrief, registerOf, registersDoc, renderedOrder, researchPrompt, retrofitPlan, rhythmDistance, rhythmOf, 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, temperatureName, toGamut, toJson, toSarif, tradeOf, tricolons, typeFeatureTokens, typicality, unprovenClaims, validateConfidence, validateDirection, validateHierarchy, validateJob, viewportOf, visibleText, visualMeasures, vocabulary, vocabularyCounts, wcagContrast, wordListsJson };
+export { ACCENT_SCALE, ACCENT_SHARED, ADDITIONS, AI_PHRASES, AI_SOURCE_TYPES, AI_VIOLET, AI_WORDS, type AccentFork, type AccentForkOptions, type Action, type ActionPosition, type Addition, type Area, type ArtDirection, BASELINE_VERSION, BUZZWORDS, type Band, type Baseline, type BaselineEntry, CATALOGUE, CATALOGUE_VERSION, CHANGE_CLASSES, CHANGE_STEPS, CHOICE_KEYS, COMPONENT_ROLES, CONFIDENCE_LENSES, CONSIDERATION, CONTENT_FEATURES, CONVENTION, CUSTOMER_KINDS, type Calibration, type CandidateKind, type ChangeClass, type ChangeStep, type CharacterInputs, type CharacterReport, type CheckOptions, type CheckReport, type CheckRestraintInput, type ChoiceKey, type Claim, type ClaimsReport, type CompetitorComparison, type ComponentPair, type ComponentTypicality, type ConfidenceBasis, type ConfidenceContext, type ConfidenceFinding, type ConfidenceLens, 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 DesignReview, type DirectionChoice, type DirectionComparison, type DirectionMatch, type DirectionProblem, type DirectionReport, type DirectionSource, type DirectionSummary, type DurationName, EASE, EASE_TUPLE, EDGE_STEP, ESTATE_VERSION, EVIDENCE_KINDS, EXIT_RATIO, type EaseName, type EmitCssOptions, type EstateMatch, type EstatePair, type EstateRegister, type EstateSite, type EvidenceKind, FINGERPRINT_VERSION, FLAGGED_TARGET, FUNCTION_WORDS, type Fact, type FactComparison, type FactKind, type Finding, type Fingerprint, type FingerprintDistance, type FingerprintHero, type FingerprintSection, type FluidSpaceOptions, type FluidTypeOptions, type FluidTypeResult, type FontClass, GROUND_SCALE, GROUND_SHARED, type Gamut, type Generation, type GradientContrast, HIERARCHY_FIELDS, HOME_FILE, HOME_URL, HOUSE, HOUSE_BUDGET, HOUSE_LOCKED, HOUSE_TYPE, HUMAN_TYPICAL_TARGET, type HarvestCandidate, type HarvestOptions, type HeroImage, type Hit, type HouseRule, type HouseTier, IMAGERY_TELLS, INSPECTED_KINDS, 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, type LightnessBand, MIN_DECIDED, MIN_PARAGRAPHS, MIN_RUNS, MOOD, type MeasuredPage, type MotionDecision, type MotionKind, type MultiClient, NEGATIVE_REASSURANCE, NULL_VERSION, type NullModel, type NullRun, OPENING_BANDS, type Oklch, type OklchToHexOptions, PAGE_TYPES, PILL_LIMIT, PLAINER_WORDS, PREFERENCE, PROFILE, PROFILE_MEASURED, PROFILE_PARAGRAPHS, PROMO_BADGE, PROOF_DEPTHS, PROOF_KINDS, PROOF_NAMES, PROPOSED, PROVENANCE_SCAN_BYTES, type PageConfidence, type PageCopy, type PageHierarchy, type PageResult, type PageType, type PaletteColour, type PhotoReviewOptions, type PhotoReviewResult, type ProofDepth, type ProofItem, type ProofKind, type Proposal, type ProposeInput, RAMP_STEPS, READABLE_SNAPSHOT_VERSIONS, REFLEX_FONTS_1, REFLEX_FONTS_2, REGISTERS, REGISTER_BASELINE, REGISTER_FEATURES, REGISTER_IDS, RENDERED_PATHS, RENDERED_TELLS, REPORTED_KINDS, REVEAL_LIMIT, REVIEW_BASES, REVIEW_PHRASES, REVIEW_VERDICTS, type Ramp, type RampFromAnchorsOptions, type RampOptions, type RampStep, type ReasonInput, type Register, type RegisterCheck, type RegisterFeatures, type RegisterId, type RegisterProfile, type RenderedTell, type ResearchInput, type RestraintBudget, type RestraintReport, type RestraintSeverity, type RestraintViolation, type ReviewBasis, type ReviewEvidence, type ReviewNote, type ReviewOutcome, type ReviewProposal, type ReviewReport, type ReviewResult, type ReviewVerdict, type Rgb, type RgbaImage, SAMPLES_PER_SEGMENT, 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 SuggestionStanding, type Surface, TELL_HEAVY, TEMPERATURE_FULL, TEMPERATURE_NAMED, TEMPERATURE_WEIGHT, TRADE_NOUNS, TYPE_STEPS, TYPICAL_AT, type TailwindPreset, type TargetCheck, type Tell, type TellException, type TellRate, type Temperature, type Tricolon, type TypeStep, type Typicality, type UnmeasuredPage, VAGUE_WORDS, VIEWPORTS, type ValidateContext, type Verdict, type Viewport, accentFork, addSite, apcaContrast, applyBaseline, applyHouseGate, applySeverity, assessConfidence, assessReview, auditSnapshot, bandOf, briefTerms, calibrate, catalogueTable, characterReport, checkCopy, checkOrder, checkPair, checkPhotoReview, checkReason, checkRegister, checkRestraint, choicesOf, clauseDepth, closestComponents, compareCompetitor, compareDirections, compareFacts, compareToDeclared, compareToEstate, componentDistance, componentShared, componentTypicalities, componentTypicality, componentsOf, contentWords, countWords, craftTokens, createBaseline, cv, deltaEOk, deltaEOkHex, densityCss, densityTokens, designTells, documentParagraphs, emitCss, emptyEstate, estateComponentPairs, estatePairs, exitDuration, extractHtml, faceLicence, featureLabel, findClaims, findColours, findingKey, fingerprint, fingerprintDistance, fluidClamp, fluidSpace, fluidType, fontClass, formatCalibration, formatClaims, formatComparison, formatCompetitor, formatDirectionMatches, formatHex, formatReport, getRegister, globToRegExp, gradientContrast, gradientStops, groundDistance, groundLabel, groundName, groundTemperature, harvest, hedgeCount, hedgedClose, heroDistance, hexToOklch, holdHouseBlocks, houseRule, hueName, hueSwatch, ignoreMatcher, inP3Gamut, inSrgbGamut, initDirection, isAiViolet, isBlurb, isCategoryLabel, isCream, isFlagged, isStructural, 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, registerBrief, registerOf, registersDoc, renderedOrder, researchPrompt, retrofitPlan, rhythmDistance, rhythmOf, 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, temperatureName, toGamut, toJson, toSarif, tradeOf, tricolons, typeFeatureTokens, typicality, unprovenClaims, validateConfidence, validateDirection, validateHierarchy, validateJob, viewportOf, visibleText, visualMeasures, vocabulary, vocabularyCounts, wcagContrast, wordListsJson };

package/dist/index.d.ts

@@ -1252,7 +1252,7 @@ interface CheckReport {
  * Bumped whenever an entry is added, removed or its detection changes, so a
  * report can say which list it was judged against.
  */
-declare const CATALOGUE_VERSION = "2026.10.4";
+declare const CATALOGUE_VERSION = "2026.10.5";
 declare const CATALOGUE: readonly Tell[];
 declare function tellById(id: string): Tell | undefined;
 /**
@@ -2658,6 +2658,14 @@ type EvidenceKind = (typeof EVIDENCE_KINDS)[number];
  */
 declare const CHANGE_CLASSES: readonly ["confirmed-correction", "design-hypothesis", "optional-refinement", "no-change"];
 type ChangeClass = (typeof CHANGE_CLASSES)[number];
+/**
+ * What was done with a note in a reviewer's own record (`reviews/`).
+ * take-reworded: the diagnosis is taken and the suggested wording rewritten,
+ * because a reviewer's lines are copy-checked like anyone's. partly: the aim
+ * is taken by a smaller or different change. known: already tracked.
+ */
+declare const REVIEW_VERDICTS: readonly ["praise", "take", "take-reworded", "partly", "decline", "founder-decision", "known"];
+type ReviewVerdict = (typeof REVIEW_VERDICTS)[number];
 /**
  * The ladder of minimum effective change, smallest first. The last two are
  * structural and have to say why every smaller step was not enough.
@@ -2728,6 +2736,29 @@ interface ReviewNote {
             placeholder?: string;
         }[];
     };
+    /** Where the note was left, so it can be found again: `{ tool: "pastel", canvas, comment, url }`. */
+    source?: {
+        tool: string;
+        canvas?: number | string;
+        comment?: number | string;
+        commentId?: number | string;
+        url?: string;
+        at?: string;
+    };
+    /** What was done with it, in a reviewer corpus. */
+    verdict?: ReviewVerdict;
+    /** The founder's call where the note needed one: the decision, stated and dated. */
+    founderRuling?: {
+        date: string;
+        ruling: string;
+    };
+    /** The principle it teaches, by its id in CHARACTER.md. */
+    principle?: string;
+    /** Tells it informed; with text, the words that tell must fire on. */
+    tells?: {
+        id: string;
+        text?: string;
+    }[];
 }
 interface DesignReview {
     /** Publication is the default. Protected previews may reserve explicitly marked assets. */
@@ -2736,6 +2767,21 @@ interface DesignReview {
     version: 1;
     /** Who or what was reviewed, and at which width. */
     subject: string;
+    /** In a reviewer corpus: whose review this is, the day, where it was given and who ruled on it. */
+    reviewer?: string;
+    date?: string;
+    source?: {
+        tool: string;
+        canvas?: number | string;
+        link?: string;
+        comments?: number;
+        from?: string;
+        to?: string;
+    };
+    rulings?: {
+        by: string;
+        date: string;
+    };
     notes: ReviewNote[];
 }
 type ReviewOutcome = "change" | "hold" | "no-change" | "gather-evidence";
@@ -3225,7 +3271,7 @@ declare const NEGATIVE_REASSURANCE: readonly ["no risk", "never locked in", "not
 /** Banned only when vague. Reported for review, never blocking. */
 declare const VAGUE_WORDS: readonly ["innovative", "scalable", "end-to-end", "streamline", "solutions"];
 /** The review tier of copy-rules.md: normal English once, a tell when stacked. */
-declare const REVIEW_PHRASES: readonly ["great question", "of course!", "absolutely!", "absolutely,", "truly", "genuinely", "deeply", "clear", "clearly", "ultimately", "one-size-fits-all", "one size fits all", "let me know if you'd", "the single most", "by far the most", "hands down the", "arguably the best", "bar none"];
+declare const REVIEW_PHRASES: readonly ["great question", "of course!", "absolutely!", "absolutely,", "truly", "genuinely", "deeply", "clear", "clearly", "ultimately", "one-size-fits-all", "one size fits all", "let me know if you'd", "the single most", "by far the most", "hands down the", "arguably the best", "bar none", "plain answer", "plain answers", "plain recommendation", "plain explanation", "plain explanations", "plain advice", "plain guidance", "plain-speaking", "plain speaking"];
 
 /**
  * The reason rule, one standard for every layer of an art direction.
@@ -3731,4 +3777,4 @@ declare function characterReport(input: CharacterInputs, copyTells?: Set<string>
 
 declare function retrofitPlan(report: CharacterReport, direction?: ArtDirection | null): string;
 
-export { ACCENT_SCALE, ACCENT_SHARED, ADDITIONS, AI_PHRASES, AI_SOURCE_TYPES, AI_VIOLET, AI_WORDS, type AccentFork, type AccentForkOptions, type Action, type ActionPosition, type Addition, type Area, type ArtDirection, BASELINE_VERSION, BUZZWORDS, type Band, type Baseline, type BaselineEntry, CATALOGUE, CATALOGUE_VERSION, CHANGE_CLASSES, CHANGE_STEPS, CHOICE_KEYS, COMPONENT_ROLES, CONFIDENCE_LENSES, CONSIDERATION, CONTENT_FEATURES, CONVENTION, CUSTOMER_KINDS, type Calibration, type CandidateKind, type ChangeClass, type ChangeStep, type CharacterInputs, type CharacterReport, type CheckOptions, type CheckReport, type CheckRestraintInput, type ChoiceKey, type Claim, type ClaimsReport, type CompetitorComparison, type ComponentPair, type ComponentTypicality, type ConfidenceBasis, type ConfidenceContext, type ConfidenceFinding, type ConfidenceLens, 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 DesignReview, type DirectionChoice, type DirectionComparison, type DirectionMatch, type DirectionProblem, type DirectionReport, type DirectionSource, type DirectionSummary, type DurationName, EASE, EASE_TUPLE, EDGE_STEP, ESTATE_VERSION, EVIDENCE_KINDS, EXIT_RATIO, type EaseName, type EmitCssOptions, type EstateMatch, type EstatePair, type EstateRegister, type EstateSite, type EvidenceKind, FINGERPRINT_VERSION, FLAGGED_TARGET, FUNCTION_WORDS, type Fact, type FactComparison, type FactKind, type Finding, type Fingerprint, type FingerprintDistance, type FingerprintHero, type FingerprintSection, type FluidSpaceOptions, type FluidTypeOptions, type FluidTypeResult, type FontClass, GROUND_SCALE, GROUND_SHARED, type Gamut, type Generation, type GradientContrast, HIERARCHY_FIELDS, HOME_FILE, HOME_URL, HOUSE, HOUSE_BUDGET, HOUSE_LOCKED, HOUSE_TYPE, HUMAN_TYPICAL_TARGET, type HarvestCandidate, type HarvestOptions, type HeroImage, type Hit, type HouseRule, type HouseTier, IMAGERY_TELLS, INSPECTED_KINDS, 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, type LightnessBand, MIN_DECIDED, MIN_PARAGRAPHS, MIN_RUNS, MOOD, type MeasuredPage, type MotionDecision, type MotionKind, type MultiClient, NEGATIVE_REASSURANCE, NULL_VERSION, type NullModel, type NullRun, OPENING_BANDS, type Oklch, type OklchToHexOptions, PAGE_TYPES, PILL_LIMIT, PLAINER_WORDS, PREFERENCE, PROFILE, PROFILE_MEASURED, PROFILE_PARAGRAPHS, PROMO_BADGE, PROOF_DEPTHS, PROOF_KINDS, PROOF_NAMES, PROPOSED, PROVENANCE_SCAN_BYTES, type PageConfidence, type PageCopy, type PageHierarchy, type PageResult, type PageType, type PaletteColour, type PhotoReviewOptions, type PhotoReviewResult, type ProofDepth, type ProofItem, type ProofKind, type Proposal, type ProposeInput, RAMP_STEPS, READABLE_SNAPSHOT_VERSIONS, REFLEX_FONTS_1, REFLEX_FONTS_2, REGISTERS, REGISTER_BASELINE, REGISTER_FEATURES, REGISTER_IDS, RENDERED_PATHS, RENDERED_TELLS, REPORTED_KINDS, REVEAL_LIMIT, REVIEW_BASES, REVIEW_PHRASES, type Ramp, type RampFromAnchorsOptions, type RampOptions, type RampStep, type ReasonInput, type Register, type RegisterCheck, type RegisterFeatures, type RegisterId, type RegisterProfile, type RenderedTell, type ResearchInput, type RestraintBudget, type RestraintReport, type RestraintSeverity, type RestraintViolation, type ReviewBasis, type ReviewEvidence, type ReviewNote, type ReviewOutcome, type ReviewProposal, type ReviewReport, type ReviewResult, type Rgb, type RgbaImage, SAMPLES_PER_SEGMENT, 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 SuggestionStanding, type Surface, TELL_HEAVY, TEMPERATURE_FULL, TEMPERATURE_NAMED, TEMPERATURE_WEIGHT, TRADE_NOUNS, TYPE_STEPS, TYPICAL_AT, type TailwindPreset, type TargetCheck, type Tell, type TellException, type TellRate, type Temperature, type Tricolon, type TypeStep, type Typicality, type UnmeasuredPage, VAGUE_WORDS, VIEWPORTS, type ValidateContext, type Verdict, type Viewport, accentFork, addSite, apcaContrast, applyBaseline, applyHouseGate, applySeverity, assessConfidence, assessReview, auditSnapshot, bandOf, briefTerms, calibrate, catalogueTable, characterReport, checkCopy, checkOrder, checkPair, checkPhotoReview, checkReason, checkRegister, checkRestraint, choicesOf, clauseDepth, closestComponents, compareCompetitor, compareDirections, compareFacts, compareToDeclared, compareToEstate, componentDistance, componentShared, componentTypicalities, componentTypicality, componentsOf, contentWords, countWords, craftTokens, createBaseline, cv, deltaEOk, deltaEOkHex, densityCss, densityTokens, designTells, documentParagraphs, emitCss, emptyEstate, estateComponentPairs, estatePairs, exitDuration, extractHtml, faceLicence, featureLabel, findClaims, findColours, findingKey, fingerprint, fingerprintDistance, fluidClamp, fluidSpace, fluidType, fontClass, formatCalibration, formatClaims, formatComparison, formatCompetitor, formatDirectionMatches, formatHex, formatReport, getRegister, globToRegExp, gradientContrast, gradientStops, groundDistance, groundLabel, groundName, groundTemperature, harvest, hedgeCount, hedgedClose, heroDistance, hexToOklch, holdHouseBlocks, houseRule, hueName, hueSwatch, ignoreMatcher, inP3Gamut, inSrgbGamut, initDirection, isAiViolet, isBlurb, isCategoryLabel, isCream, isFlagged, isStructural, 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, registerBrief, registerOf, registersDoc, renderedOrder, researchPrompt, retrofitPlan, rhythmDistance, rhythmOf, 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, temperatureName, toGamut, toJson, toSarif, tradeOf, tricolons, typeFeatureTokens, typicality, unprovenClaims, validateConfidence, validateDirection, validateHierarchy, validateJob, viewportOf, visibleText, visualMeasures, vocabulary, vocabularyCounts, wcagContrast, wordListsJson };
+export { ACCENT_SCALE, ACCENT_SHARED, ADDITIONS, AI_PHRASES, AI_SOURCE_TYPES, AI_VIOLET, AI_WORDS, type AccentFork, type AccentForkOptions, type Action, type ActionPosition, type Addition, type Area, type ArtDirection, BASELINE_VERSION, BUZZWORDS, type Band, type Baseline, type BaselineEntry, CATALOGUE, CATALOGUE_VERSION, CHANGE_CLASSES, CHANGE_STEPS, CHOICE_KEYS, COMPONENT_ROLES, CONFIDENCE_LENSES, CONSIDERATION, CONTENT_FEATURES, CONVENTION, CUSTOMER_KINDS, type Calibration, type CandidateKind, type ChangeClass, type ChangeStep, type CharacterInputs, type CharacterReport, type CheckOptions, type CheckReport, type CheckRestraintInput, type ChoiceKey, type Claim, type ClaimsReport, type CompetitorComparison, type ComponentPair, type ComponentTypicality, type ConfidenceBasis, type ConfidenceContext, type ConfidenceFinding, type ConfidenceLens, 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 DesignReview, type DirectionChoice, type DirectionComparison, type DirectionMatch, type DirectionProblem, type DirectionReport, type DirectionSource, type DirectionSummary, type DurationName, EASE, EASE_TUPLE, EDGE_STEP, ESTATE_VERSION, EVIDENCE_KINDS, EXIT_RATIO, type EaseName, type EmitCssOptions, type EstateMatch, type EstatePair, type EstateRegister, type EstateSite, type EvidenceKind, FINGERPRINT_VERSION, FLAGGED_TARGET, FUNCTION_WORDS, type Fact, type FactComparison, type FactKind, type Finding, type Fingerprint, type FingerprintDistance, type FingerprintHero, type FingerprintSection, type FluidSpaceOptions, type FluidTypeOptions, type FluidTypeResult, type FontClass, GROUND_SCALE, GROUND_SHARED, type Gamut, type Generation, type GradientContrast, HIERARCHY_FIELDS, HOME_FILE, HOME_URL, HOUSE, HOUSE_BUDGET, HOUSE_LOCKED, HOUSE_TYPE, HUMAN_TYPICAL_TARGET, type HarvestCandidate, type HarvestOptions, type HeroImage, type Hit, type HouseRule, type HouseTier, IMAGERY_TELLS, INSPECTED_KINDS, 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, type LightnessBand, MIN_DECIDED, MIN_PARAGRAPHS, MIN_RUNS, MOOD, type MeasuredPage, type MotionDecision, type MotionKind, type MultiClient, NEGATIVE_REASSURANCE, NULL_VERSION, type NullModel, type NullRun, OPENING_BANDS, type Oklch, type OklchToHexOptions, PAGE_TYPES, PILL_LIMIT, PLAINER_WORDS, PREFERENCE, PROFILE, PROFILE_MEASURED, PROFILE_PARAGRAPHS, PROMO_BADGE, PROOF_DEPTHS, PROOF_KINDS, PROOF_NAMES, PROPOSED, PROVENANCE_SCAN_BYTES, type PageConfidence, type PageCopy, type PageHierarchy, type PageResult, type PageType, type PaletteColour, type PhotoReviewOptions, type PhotoReviewResult, type ProofDepth, type ProofItem, type ProofKind, type Proposal, type ProposeInput, RAMP_STEPS, READABLE_SNAPSHOT_VERSIONS, REFLEX_FONTS_1, REFLEX_FONTS_2, REGISTERS, REGISTER_BASELINE, REGISTER_FEATURES, REGISTER_IDS, RENDERED_PATHS, RENDERED_TELLS, REPORTED_KINDS, REVEAL_LIMIT, REVIEW_BASES, REVIEW_PHRASES, REVIEW_VERDICTS, type Ramp, type RampFromAnchorsOptions, type RampOptions, type RampStep, type ReasonInput, type Register, type RegisterCheck, type RegisterFeatures, type RegisterId, type RegisterProfile, type RenderedTell, type ResearchInput, type RestraintBudget, type RestraintReport, type RestraintSeverity, type RestraintViolation, type ReviewBasis, type ReviewEvidence, type ReviewNote, type ReviewOutcome, type ReviewProposal, type ReviewReport, type ReviewResult, type ReviewVerdict, type Rgb, type RgbaImage, SAMPLES_PER_SEGMENT, 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 SuggestionStanding, type Surface, TELL_HEAVY, TEMPERATURE_FULL, TEMPERATURE_NAMED, TEMPERATURE_WEIGHT, TRADE_NOUNS, TYPE_STEPS, TYPICAL_AT, type TailwindPreset, type TargetCheck, type Tell, type TellException, type TellRate, type Temperature, type Tricolon, type TypeStep, type Typicality, type UnmeasuredPage, VAGUE_WORDS, VIEWPORTS, type ValidateContext, type Verdict, type Viewport, accentFork, addSite, apcaContrast, applyBaseline, applyHouseGate, applySeverity, assessConfidence, assessReview, auditSnapshot, bandOf, briefTerms, calibrate, catalogueTable, characterReport, checkCopy, checkOrder, checkPair, checkPhotoReview, checkReason, checkRegister, checkRestraint, choicesOf, clauseDepth, closestComponents, compareCompetitor, compareDirections, compareFacts, compareToDeclared, compareToEstate, componentDistance, componentShared, componentTypicalities, componentTypicality, componentsOf, contentWords, countWords, craftTokens, createBaseline, cv, deltaEOk, deltaEOkHex, densityCss, densityTokens, designTells, documentParagraphs, emitCss, emptyEstate, estateComponentPairs, estatePairs, exitDuration, extractHtml, faceLicence, featureLabel, findClaims, findColours, findingKey, fingerprint, fingerprintDistance, fluidClamp, fluidSpace, fluidType, fontClass, formatCalibration, formatClaims, formatComparison, formatCompetitor, formatDirectionMatches, formatHex, formatReport, getRegister, globToRegExp, gradientContrast, gradientStops, groundDistance, groundLabel, groundName, groundTemperature, harvest, hedgeCount, hedgedClose, heroDistance, hexToOklch, holdHouseBlocks, houseRule, hueName, hueSwatch, ignoreMatcher, inP3Gamut, inSrgbGamut, initDirection, isAiViolet, isBlurb, isCategoryLabel, isCream, isFlagged, isStructural, 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, registerBrief, registerOf, registersDoc, renderedOrder, researchPrompt, retrofitPlan, rhythmDistance, rhythmOf, 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, temperatureName, toGamut, toJson, toSarif, tradeOf, tricolons, typeFeatureTokens, typicality, unprovenClaims, validateConfidence, validateDirection, validateHierarchy, validateJob, viewportOf, visibleText, visualMeasures, vocabulary, vocabularyCounts, wcagContrast, wordListsJson };

package/dist/index.js

@@ -1711,7 +1711,17 @@ var REVIEW_PHRASES = [
   "by far the most",
   "hands down the",
   "arguably the best",
-  "bar none"
+  "bar none",
+  // "plain" as a self-description, the way "clear" is: say what the reader gets.
+  "plain answer",
+  "plain answers",
+  "plain recommendation",
+  "plain explanation",
+  "plain explanations",
+  "plain advice",
+  "plain guidance",
+  "plain-speaking",
+  "plain speaking"
 ];
 var SALES_TAGLINES = [
   /\bwhere it (?:really |truly )?(?:counts|matters)(?: most)?\b/i,
@@ -1767,6 +1777,34 @@ var CLIPPED = [
   // "Alright Carlo, built you a proper site": the "I" left out
   /(?<=^|[\n>"“]|[.!?—–-]\s*|,\s+)(?:[Bb]uilt|[Mm]ade|[Pp]ut together|[Kk]nocked up)\s+(?:you|your\s+\w+|the\s+\w+)\s+an?\b/
 ];
+var PLAIN_FAMILY = [
+  /\b(?:plain english|explained plainly|plainly explained)\b/i,
+  /\bplainly\b(?!\s+marked\b)/i,
+  /\bin\s+plain\s+(?:terms|language|words|speak)\b/i
+];
+var CONFESSION = [
+  // "What this is and is not:", "what we are and aren't"
+  /\bwhat\s+(?:this|it|we|our\s+\w+)\s+(?:is|are)\s+and\s+(?:is\s+not|isn['’]t|are\s+not|aren['’]t)\b/i,
+  // "What we are not", a label on its own; not "what we are not responsible for"
+  /(?<!\band\s)\bwhat\s+we(?:\s+are|['’]re)\s+not\b(?!\s+(?:responsible|liable|able|allowed|sure)\b)/i,
+  /\bwhat\s+we\s+(?:don['’]t|do\s+not)\s+do\b/i,
+  // "We have not yet built and run", "we haven't yet worked with"
+  /\bwe(?:\s+have|['’]ve)\s+not\s+yet\s+(?:built|run|done|worked|delivered|shipped|launched)\b/i,
+  /\bwe\s+haven['’]t\s+(?:yet\s+)?(?:built|run|done|worked\s+with|delivered)\b/i,
+  /\bwhat\s+we\s+have\s+and\s+(?:haven['’]t|have\s+not)\s+(?:done|built|run)\b/i,
+  // "Our clinic experience so far is one practice"
+  /\bour\s+(?:[\w-]+\s+){0,3}experience\s+so\s+far\s+(?:is|has\s+been|covers)\b/i,
+  /\bso\s+far\s+(?:is|has\s+been)\s+(?:one|a\s+single|just\s+one)\b/i,
+  /\bwhere\s+our\s+experience\s+(?:applies|ends|stops|runs\s+out)\b/i,
+  /\bwhat\s+we\s+(?:would|['’]d|will|still)\s+need\s+to\s+learn\b/i,
+  // "what we would and wouldn't take on", "what we won't take on"
+  /\b(?:would|will)\s+and\s+(?:wouldn['’]t|would\s+not|won['’]t|will\s+not)\s+take\s+on\b/i,
+  /\bwhat\s+we\s+(?:won['’]t|wouldn['’]t|would\s+not|will\s+not)\s+take\s+on\b/i,
+  // "Who we don't work with", "who this is not for", "we're not for everyone"
+  /\bwho\s+we\s+(?:don['’]t|do\s+not|won['’]t|will\s+not)\s+(?:work\s+with|serve|help|take\s+on)\b/i,
+  /\bwho\s+(?:this|it|we)\s+(?:is|are|['’]re)\s+not\s+for\b|\bwho\s+(?:this|it)\s+isn['’]t\s+for\b/i,
+  /\b(?:we|this)\s+(?:are|is|['’]re|['’]s)\s+not\s+(?:for\s+everyone|the\s+right\s+fit\s+for)\b/i
+];
 var NEGATION = [
   // "It's not just a haircut, it's an experience."
   /\b(?:it['’]?s|it is|this is|this isn['’]t|we['’]re|we are|they['’]re)\s+(?:not|more than)\s+(?:just|only|merely|simply)?\s*[^.!?\n]{1,60}?[,;.—-]\s*(?:it['’]?s|it is|this is|we['’]re|we are|they['’]re)\b/i,
@@ -1896,12 +1934,25 @@ var COPY_TELLS = [
     generation: 2,
     severity: "warn",
     surface: "copy",
-    why: "Told to avoid jargon, a model announces that it is avoiding jargon. 'Explained plainly' swaps a synonym and keeps the tell.",
-    fix: "Use the house replacement, 'properly explained', or drop the claim and let the copy show it.",
-    detect: phrases([/\b(?:plain english|explained plainly|plainly explained)\b/i], quoted),
+    why: "Told to avoid jargon, a model announces that it is avoiding jargon: 'in plain English', 'stated plainly', 'we'll tell you plainly', 'in plain terms'. The founder bans the whole family (20 October 2026); a reader takes it as filler.",
+    fix: "Drop the adverb and say the thing: 'Our prices, stated plainly' becomes 'Our prices'. Where the claim matters, the house replacement for 'plain English' is 'properly explained'.",
+    detect: phrases(PLAIN_FAMILY, quoted),
     fixtures: {
-      flag: [f("content/home.md", "Your options, in plain English.")],
-      pass: [f("content/home.md", "Your options, properly explained.")]
+      flag: [
+        f("content/home.md", "Your options, in plain English."),
+        // Eunice Ordor's draft lines, Pastel 986559 #12 and #13 (her diagnosis taken, her wording not).
+        f("content/clinics.md", "Tell us what's happening and we'll say plainly what we would take on."),
+        f("content/pricing.md", "DD's payment terms, plainly stated."),
+        f("content/clinics.md", "We explain our findings in plain terms."),
+        f("content/clinics.md", "We share findings in plain language.")
+      ],
+      pass: [
+        f("content/home.md", "Your options, properly explained."),
+        f("content/pricing.md", "Our payment terms: 30% when you sign, the rest at launch."),
+        // The Apache and zlib licence wording, copied into a repo as it is.
+        f("LICENSE.txt", "Altered source versions must be plainly marked as such."),
+        f("content/menu.md", "Plain or seeded bagels, and plain-language allergen notes.")
+      ]
     }
   },
   {
@@ -1952,11 +2003,11 @@ var COPY_TELLS = [
     generation: 1,
     severity: "warn",
     surface: "copy",
-    why: "Truly, genuinely, clear, ultimately, 'the single most', 'bar none': normal English once, and a tell when they stack. The house rules keep them for review, never blocking.",
+    why: "Truly, genuinely, clear, ultimately, 'a plain recommendation', 'the single most', 'bar none': normal English once, and a tell when they stack. The house rules keep them for review, never blocking.",
     fix: "Keep the one that lands hardest and cut the rest. 'What is genuinely excellent' reads better as 'what is excellent'.",
     detect: phrases([new RegExp(`(?:^|\\b)(?:${[...REVIEW_PHRASES].sort((a, b) => b.length - a.length).map((p) => escape(p).replace(/^(\w)/, "\\b$1").replace(/(\w)$/, "$1\\b")).join("|")})`, "i")], quoted),
     fixtures: {
-      flag: [f("content/home.md", "We are truly proud of it."), f("content/home.md", "You leave with a clear next step.")],
+      flag: [f("content/home.md", "We are truly proud of it."), f("content/home.md", "You leave with a clear next step."), f("content/process.md", "You get a plain recommendation and someone who knows your systems.")],
       pass: [f("content/home.md", "We have fitted 400 boilers since 2009."), f("content/home.md", "Keep a safe clearance around the meter.")]
     }
   },
@@ -2037,6 +2088,40 @@ var COPY_TELLS = [
       ]
     }
   },
+  {
+    id: "confession-line",
+    name: "Confession line",
+    generation: 2,
+    severity: "warn",
+    surface: "copy",
+    why: "'What this is and is not', 'we have not yet built', 'our experience so far is one practice', 'what we would and wouldn't take on': a model scopes a business by confessing its limits. It reads as small print, and it turns a buyer away before they make contact.",
+    fix: "Scope by being precise about what is true, and leave the door open: 'Built and run by us for Sensphere, a practice whose clinicians work across several sites.' Keep contractual facts (eligibility, who runs what) and say them as what the buyer gets.",
+    detect: phrases(CONFESSION, quoted),
+    fixtures: {
+      flag: [
+        // Each one from the DD site, as Eunice Ordor flagged it (Pastel 986559 #8, #12, #13).
+        f("content/clinics.md", "What this is and is not: a practice portal we built and run for one practice."),
+        f("content/clinics.md", "We have not yet built and run the digital systems of a practice with several clinicians."),
+        f("content/home.md", "Including the client portal we run for Sensphere. Our clinic experience so far is one practice."),
+        f("content/clinics.md", "Tell us what's happening and we'll say what we would and wouldn't take on."),
+        f("content/clinics.md", "We will say what carries over from this work and what we would need to learn first."),
+        f("content/clinics.md", "We will tell you where our experience applies directly and where it is close."),
+        f("content/about.md", "What we are not"),
+        f("content/about.md", "Who we don't work with: anyone who needs a site this week."),
+        f("content/mobile.md", "Mobile is our newest line, so we tell you what we have and haven't done.")
+      ],
+      pass: [
+        f("content/clinics.md", "Built and run by us for Sensphere, a growing practice whose clinicians work remotely."),
+        f("content/home.md", "The client portal we run for Sensphere."),
+        // Contractual facts, said as they are.
+        f("content/pricing.md", "Pay monthly is open to UK residents aged 18 and over, subject to status."),
+        f("content/pricing.md", "Your monthly payments do not buy the site; the buy-out price does."),
+        f("content/terms.md", "What we are responsible for, and what we are not responsible for, is in clause 4."),
+        f("content/insurance.md", "Ask what your policy does and does not cover."),
+        f("emails/deposit.md", "We have not yet received your deposit, so the date is still open.")
+      ]
+    }
+  },
   {
     id: "hollow-imperative",
     name: "Hollow imperative",
@@ -3303,6 +3388,69 @@ function eyebrowChipHits(ctx) {
   }
   return hits;
 }
+var HERO_OPEN = /<(section|header|div|main|article|Section|Container)\b[^>]*?\b(?:class|className|id)\s*=\s*(?:"|'|\{\s*[`"']?)[^"'`>]*?(?<![a-z])hero(?![a-z])[^>]*>/gi;
+function closeOf(text, tag, from) {
+  const re = new RegExp(`<(/?)${tag}\\b[^>]*?(/?)>`, "g");
+  re.lastIndex = from;
+  let depth = 0;
+  for (let m = re.exec(text); m; m = re.exec(text)) {
+    if (m[2] === "/") continue;
+    depth += m[1] === "/" ? -1 : 1;
+    if (depth === 0) return m.index + m[0].length;
+    if (m.index - from > 8e3) break;
+  }
+  return Math.min(text.length, from + 4e3);
+}
+function heroSpans(path, text) {
+  if (/(?:^|[\\/])[\w-]*hero[\w-]*\.(?:astro|tsx|jsx|vue|svelte)$/i.test(path)) return [[0, text.length]];
+  const spans = [];
+  for (const m of text.matchAll(HERO_OPEN)) {
+    const at = m.index ?? 0;
+    if (spans.some(([a, b]) => at >= a && at < b)) continue;
+    spans.push([at, closeOf(text, m[1], at)]);
+  }
+  if (spans.length > 0) return spans;
+  const h1 = text.search(/<h1\b/);
+  if (h1 === -1) return [];
+  const rest = text.slice(h1);
+  const end = rest.search(/<\/(?:section|header)>|<section\b/);
+  return [[h1, h1 + Math.min(end === -1 ? rest.length : end, 1500)]];
+}
+var CONTROL = /<(a|button|Button|ButtonLink|LinkButton|Link|Cta|CTA|CallToAction)\b([^>]*)>([\s\S]{0,300}?)<\/\1>/g;
+var BUTTON_COMPONENT = /^(?:Button|ButtonLink|LinkButton|Cta|CTA|CallToAction)$/;
+var BUTTON_CLASS = /(?<![a-z])(?:btn|button|cta)(?![a-z])/i;
+var TOGGLE = /\baria-(?:expanded|controls|haspopup)\b|\btype\s*=\s*["']submit["']/;
+var NOT_A_LANDING = /(?:^|[\\/])(?:error|global-error|not-found|404|500)\.\w+$|[\\/](?:admin|portal|dashboard|account|\(qa\)|\(app\)|qa)[\\/]/i;
+function buttonLabel(attrs, inner) {
+  const text = inner.replace(/<[^>]*>/g, " ").replace(/\{[^}]*\}/g, " ").replace(/\s+/g, " ").trim();
+  if (text && !/[{}()=]/.test(text)) return text.slice(0, 40);
+  return attrs.match(/\bhref\s*=\s*["'{`$]*\{?([^"'}`\s]+)/)?.[1] ?? "a button";
+}
+function heroCtaPairHits(ctx) {
+  const hits = [];
+  for (const file of ctx.files) {
+    if (file.kind !== "markup" || NOT_A_LANDING.test(file.path)) continue;
+    const text = file.text.replace(/\\"/g, ' "');
+    for (const [start, end] of heroSpans(file.path, text)) {
+      const span = text.slice(start, end).replace(/<(nav|form)\b[\s\S]*?<\/\1>/gi, (s) => " ".repeat(s.length));
+      const buttons = [];
+      for (const m of span.matchAll(CONTROL)) {
+        const [, tag, attrs, inner] = m;
+        if (TOGGLE.test(attrs)) continue;
+        const cls = attrs.match(/\b(?:class|className|variant)\s*=\s*(?:"([^"]*)"|'([^']*)'|\{([^}]*)\})/g)?.join(" ") ?? "";
+        const tw = /\bpx-\d/.test(cls) && /\bpy-\d/.test(cls) && /\b(?:bg-|border\b|border-|rounded)/.test(cls);
+        if (BUTTON_COMPONENT.test(tag) || BUTTON_CLASS.test(cls) || tw || /\brole\s*=\s*["']button["']/.test(attrs)) {
+          buttons.push({ label: buttonLabel(attrs, inner), offset: start + (m.index ?? 0) });
+        }
+      }
+      if (buttons.length >= 2) {
+        const names = buttons.slice(0, 3).map((b) => `"${b.label}"`).join(", ");
+        hits.push({ path: file.path, offset: buttons[1].offset, message: `${buttons.length} buttons side by side in the hero: ${names}` });
+      }
+    }
+  }
+  return hits;
+}
 function iconTiles(file) {
   return file.classUnits.filter((unit) => {
     const sized = has(unit, /^size-(?:8|9|10|11|12|14)$/) || (find(unit, /^h-(?:8|9|10|11|12|14)$/) ?? "x").slice(2) === (find(unit, /^w-(?:8|9|10|11|12|14)$/) ?? "y").slice(2);
@@ -3753,6 +3901,75 @@ const inter = Inter({ subsets: ["latin"] });`),
 <span className="inline-flex rounded-full border px-3 py-1 text-xs">Tag</span>`)]
     }
   },
+  {
+    id: "hero-cta-pair",
+    name: "Two buttons in the hero",
+    generation: 1,
+    severity: "warn",
+    surface: "source",
+    why: "A filled button beside an outline or ghost one ('Get a free quote' / 'See our plans') is in 140 of 140 heroes Claude builds for a brief. Two equal asks make the visitor choose before they know anything, and say nobody decided what the page is for.",
+    fix: "Keep one button, the ask the page exists for. Put the second route in the copy as a text link ('or see the work first'), or lower down where it answers a question.",
+    detect: heroCtaPairHits,
+    fixtures: {
+      flag: [
+        // Eunice Ordor's #5 and #36 (Pastel 986559): the DD site's own hero and process close.
+        f3(
+          "src/components/Hero.astro",
+          `<section class="hero">
+  <h1>We run the systems behind your website</h1>
+  <a href="/contact" class="btn btn-primary">Get in touch</a>
+  <a href="/work" class="btn btn-ghost">See our work</a>
+</section>`
+        ),
+        // The null build's hero, verbatim in shape (calibration/null/rmp/pages/05.html).
+        f3(
+          "index.html",
+          `<nav><a class="btn" href="#contact">Quote</a></nav>
+<section id="hero" class="hero">
+  <h1>Electricians in Uxbridge</h1>
+  <a href="#contact" class="btn btn-primary">Book a Free Quote</a>
+  <a href="tel:+441895555210" class="btn btn-outline">Call 01895 555 210</a>
+</section>`
+        ),
+        f3(
+          "app/page.tsx",
+          `<section className="relative py-24">
+  <h1 className="text-5xl">Nails in Brackley</h1>
+  <div className="flex gap-4">
+    <Button asChild><a href="/book">Book now</a></Button>
+    <Button variant="outline">View treatments</Button>
+  </div>
+</section>`
+        )
+      ],
+      pass: [
+        // One button, and the second route as a text link in the sentence.
+        f3(
+          "src/components/Hero.astro",
+          `<section class="hero">
+  <h1>We run the systems behind your website</h1>
+  <p>Tell us what's going on, or <a href="/work">see the work first</a>.</p>
+  <a href="/contact" class="btn btn-primary">Get in touch</a>
+</section>`
+        ),
+        // A button in the nav and a search form are not the hero's ask.
+        f3(
+          "index.html",
+          `<header class="hero">
+  <nav><a class="btn" href="/book">Book</a></nav>
+  <h1>Barbers in Manchester</h1>
+  <a class="btn" href="/book">Book a cut</a>
+  <form><button class="btn" type="submit">Search</button></form>
+</header>`
+        ),
+        f3("app/page.tsx", `<section className="py-24">
+  <h1 className="text-5xl">Nails in Brackley</h1>
+  <a className="rounded bg-ink px-5 py-3" href="/book">Book now</a>
+</section>
+<section><a className="rounded bg-ink px-5 py-3" href="/prices">Prices</a></section>`)
+      ]
+    }
+  },
   {
     id: "icon-tile-stack",
     name: "Icon in a tinted tile",
@@ -4978,7 +5195,9 @@ var HOUSE = {
   "no-x-badge": { tier: "block", label: 'standalone "No X" badge. Reads as a slapped-on kicker, and worse when reused across pieces' },
   "ai-phrase": { tier: "block", label: "AI tell" },
   "plainer-word": { tier: "block", label: "a plainer word exists. Name the mechanism instead" },
-  "plain-english": { tier: "block", label: 'use "properly explained"' },
+  // Widened 2026-10-20 (founder) to bare "plainly" and "in plain terms/language/words";
+  // estate hits read first (DOM-1058), nearly all the stock "stated plainly".
+  "plain-english": { tier: "block", label: 'the plain-English family. Drop the adverb and say the thing, or use "properly explained"' },
   buzzword: { tier: "block", label: "forbidden phrase" },
   "negative-reassurance": { tier: "block", label: "negative reassurance, say what they get" },
   // Evidence of a pasted chat reply, not a matter of style. Moved from review
@@ -4992,6 +5211,8 @@ var HOUSE = {
   "stock-email-line": { tier: "review", label: "stock email line, start with the reason for writing and end with the next step" },
   // New 2026-10-19 (founder): review first, like every new tell, until estate hits are read.
   "matey-register": { tier: "review", label: "matey register, write plain and complete British English" },
+  // New 2026-10-20 (founder, from Eunice Ordor's review): review first, like every new tell.
+  "confession-line": { tier: "review", label: "confession line, scope the work by saying precisely what is true" },
   "ai-vocabulary": { tier: "review", label: "AI vocabulary" },
   "stock-phrase": { tier: "review", label: "stock phrase" },
   "hollow-imperative": { tier: "review", label: "hollow imperative" },
@@ -5228,6 +5449,33 @@ var RENDERED_PATHS = {
     detect: (s) => s.effects.eyebrowChip ? [hit(s, "a small bordered pill sits above the headline")] : [],
     fixtures: { flag: [makeSnapshot({ effects: { eyebrowChip: true } })], pass: [makeSnapshot()] }
   },
+  "hero-cta-pair": {
+    // Version 2 geometry counts buttons and button-styled links per section. A
+    // header painted inside the hero's box adds its own button, which the
+    // source path can tell apart and this one cannot; a ghost button with no
+    // fill or border is not counted, so this path under-reports.
+    detect: (s) => {
+      const first = s.sections[0];
+      const controls = first?.geometry?.controls ?? 0;
+      return first && (first.role ?? first.kind) === "hero" && controls >= 2 ? [hit(s, `${controls} buttons in the hero`, first.label)] : [];
+    },
+    fixtures: {
+      flag: [
+        {
+          ...makeSnapshot(),
+          sections: makeSnapshot().sections.map((x, i) => i === 0 ? { ...x, role: "hero", geometry: { centredShare: 0.2, mirrorSymmetry: 0.6, whitespaceRatio: 0.6, contentWidthRatio: 0.8, background: "rgb(255, 255, 255)", controls: 2 } } : x)
+        }
+      ],
+      pass: [
+        makeSnapshot(),
+        // One button, with the second route as a text link: one control.
+        {
+          ...makeSnapshot(),
+          sections: makeSnapshot().sections.map((x, i) => i === 0 ? { ...x, role: "hero", geometry: { centredShare: 0.2, mirrorSymmetry: 0.6, whitespaceRatio: 0.6, contentWidthRatio: 0.8, background: "rgb(255, 255, 255)", controls: 1 } } : x)
+        }
+      ]
+    }
+  },
   "icon-tile-grid": {
     detect: (s) => s.sections.filter((x) => x.cards >= 3 && x.iconCards >= 3).map((x) => hit(s, `${x.iconCards} icon cards in a row`, x.label)),
     fixtures: {
@@ -6197,7 +6445,7 @@ var IMAGERY_TELLS = [
 ];
 
 // src/character/check.ts
-var CATALOGUE_VERSION = "2026.10.4";
+var CATALOGUE_VERSION = "2026.10.5";
 var CATALOGUE = [
   ...[...SOURCE_TELLS, ...COPY_TELLS, ...RESEARCH_TELLS, ...DENSITY_TELLS].map((t) => RENDERED_PATHS[t.id] ? { ...t, rendered: RENDERED_PATHS[t.id] } : t),
   ...SPECIFICITY_COPY_TELLS,
@@ -8376,6 +8624,7 @@ var INSPECTED_KINDS = ["screenshot", "rendered", "source", "measurement", "conte
 var REPORTED_KINDS = ["audit", "stakeholder", "customer"];
 var EVIDENCE_KINDS = [...INSPECTED_KINDS, ...REPORTED_KINDS];
 var CHANGE_CLASSES = ["confirmed-correction", "design-hypothesis", "optional-refinement", "no-change"];
+var REVIEW_VERDICTS = ["praise", "take", "take-reworded", "partly", "decline", "founder-decision", "known"];
 var CHANGE_STEPS = ["copy", "relocate", "group", "imagery", "trust-placement", "adjust-component", "remove-redundancy", "restructure", "new-component"];
 var ADDITIONS = ["carousel", "javascript", "dependency", "animation", "testimonial", "cta", "duplicate-content"];
 
@@ -10139,6 +10388,7 @@ export {
   REVEAL_LIMIT,
   REVIEW_BASES,
   REVIEW_PHRASES,
+  REVIEW_VERDICTS,
   SAMPLES_PER_SEGMENT,
   SCALE,
   SECTION_ROLES,