@domandigital/craft 0.22.0 → 0.23.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (33) hide show
  1. package/CHANGELOG.md +12 -0
  2. package/CHARACTER.md +138 -5
  3. package/COPY.md +35 -9
  4. package/PRINCIPLES.md +9 -0
  5. package/README.md +6 -0
  6. package/design-review.schema.json +156 -0
  7. package/dist/{audit-LQ2TDISV.js → audit-CRTC7JSF.js} +3 -3
  8. package/dist/audit.cjs +365 -15
  9. package/dist/audit.js +365 -15
  10. package/dist/{chunk-DE2ZAV4G.js → chunk-3LCBLDAO.js} +171 -3
  11. package/dist/{chunk-6PZG4MJS.js → chunk-3LHIKF5L.js} +5 -5
  12. package/dist/{chunk-G47ZCBD5.js → chunk-4NON4PVK.js} +2 -2
  13. package/dist/{chunk-6DRBFDWT.js → chunk-A7KUKNX6.js} +1 -1
  14. package/dist/{chunk-OVWVKMPS.js → chunk-KGEJ2TGT.js} +14 -14
  15. package/dist/{chunk-ONA73THJ.js → chunk-KIBDFRHT.js} +195 -13
  16. package/dist/{chunk-ZS7PQNJU.js → chunk-OTQQTXXK.js} +4 -4
  17. package/dist/{chunk-RBQCGDQQ.js → chunk-Y2LGYHJ5.js} +5 -5
  18. package/dist/{cli-R2HBESHI.js → cli-E2CFVIGZ.js} +5 -5
  19. package/dist/{cli-SZ4SZLUN.js → cli-HWGSNSDD.js} +4 -4
  20. package/dist/{cli-7DL4BKA7.js → cli-IYRJZWMN.js} +6 -6
  21. package/dist/{cli-YNIJOEJK.js → cli-RHU3MAZY.js} +3 -3
  22. package/dist/{cli-AM4FLXGM.js → cli-ROVZDHVR.js} +5 -5
  23. package/dist/{cli-T7A3BU5J.js → cli-TPV2EIIN.js} +9 -9
  24. package/dist/{cli-WZA5IXSR.js → cli-X3RZE4GM.js} +6 -6
  25. package/dist/{cli-7QL26YPR.js → cli-YRRBBU27.js} +1 -1
  26. package/dist/cli.js +3 -3
  27. package/dist/index.cjs +368 -15
  28. package/dist/index.d.cts +49 -3
  29. package/dist/index.d.ts +49 -3
  30. package/dist/index.js +367 -15
  31. package/dist/{viewports-cli-F7KJIVZL.js → viewports-cli-EAUVLHFJ.js} +3 -3
  32. package/package.json +1 -1
  33. package/word-lists.json +11 -2
package/dist/index.d.ts CHANGED
@@ -1252,7 +1252,7 @@ interface CheckReport {
1252
1252
  * Bumped whenever an entry is added, removed or its detection changes, so a
1253
1253
  * report can say which list it was judged against.
1254
1254
  */
1255
- declare const CATALOGUE_VERSION = "2026.10.4";
1255
+ declare const CATALOGUE_VERSION = "2026.10.7";
1256
1256
  declare const CATALOGUE: readonly Tell[];
1257
1257
  declare function tellById(id: string): Tell | undefined;
1258
1258
  /**
@@ -2658,6 +2658,14 @@ type EvidenceKind = (typeof EVIDENCE_KINDS)[number];
2658
2658
  */
2659
2659
  declare const CHANGE_CLASSES: readonly ["confirmed-correction", "design-hypothesis", "optional-refinement", "no-change"];
2660
2660
  type ChangeClass = (typeof CHANGE_CLASSES)[number];
2661
+ /**
2662
+ * What was done with a note in a reviewer's own record (`reviews/`).
2663
+ * take-reworded: the diagnosis is taken and the suggested wording rewritten,
2664
+ * because a reviewer's lines are copy-checked like anyone's. partly: the aim
2665
+ * is taken by a smaller or different change. known: already tracked.
2666
+ */
2667
+ declare const REVIEW_VERDICTS: readonly ["praise", "take", "take-reworded", "partly", "decline", "founder-decision", "known"];
2668
+ type ReviewVerdict = (typeof REVIEW_VERDICTS)[number];
2661
2669
  /**
2662
2670
  * The ladder of minimum effective change, smallest first. The last two are
2663
2671
  * structural and have to say why every smaller step was not enough.
@@ -2728,6 +2736,29 @@ interface ReviewNote {
2728
2736
  placeholder?: string;
2729
2737
  }[];
2730
2738
  };
2739
+ /** Where the note was left, so it can be found again: `{ tool: "pastel", canvas, comment, url }`. */
2740
+ source?: {
2741
+ tool: string;
2742
+ canvas?: number | string;
2743
+ comment?: number | string;
2744
+ commentId?: number | string;
2745
+ url?: string;
2746
+ at?: string;
2747
+ };
2748
+ /** What was done with it, in a reviewer corpus. */
2749
+ verdict?: ReviewVerdict;
2750
+ /** The founder's call where the note needed one: the decision, stated and dated. */
2751
+ founderRuling?: {
2752
+ date: string;
2753
+ ruling: string;
2754
+ };
2755
+ /** The principle it teaches, by its id in CHARACTER.md. */
2756
+ principle?: string;
2757
+ /** Tells it informed; with text, the words that tell must fire on. */
2758
+ tells?: {
2759
+ id: string;
2760
+ text?: string;
2761
+ }[];
2731
2762
  }
2732
2763
  interface DesignReview {
2733
2764
  /** Publication is the default. Protected previews may reserve explicitly marked assets. */
@@ -2736,6 +2767,21 @@ interface DesignReview {
2736
2767
  version: 1;
2737
2768
  /** Who or what was reviewed, and at which width. */
2738
2769
  subject: string;
2770
+ /** In a reviewer corpus: whose review this is, the day, where it was given and who ruled on it. */
2771
+ reviewer?: string;
2772
+ date?: string;
2773
+ source?: {
2774
+ tool: string;
2775
+ canvas?: number | string;
2776
+ link?: string;
2777
+ comments?: number;
2778
+ from?: string;
2779
+ to?: string;
2780
+ };
2781
+ rulings?: {
2782
+ by: string;
2783
+ date: string;
2784
+ };
2739
2785
  notes: ReviewNote[];
2740
2786
  }
2741
2787
  type ReviewOutcome = "change" | "hold" | "no-change" | "gather-evidence";
@@ -3225,7 +3271,7 @@ declare const NEGATIVE_REASSURANCE: readonly ["no risk", "never locked in", "not
3225
3271
  /** Banned only when vague. Reported for review, never blocking. */
3226
3272
  declare const VAGUE_WORDS: readonly ["innovative", "scalable", "end-to-end", "streamline", "solutions"];
3227
3273
  /** The review tier of copy-rules.md: normal English once, a tell when stacked. */
3228
- 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"];
3274
+ 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"];
3229
3275
 
3230
3276
  /**
3231
3277
  * The reason rule, one standard for every layer of an art direction.
@@ -3731,4 +3777,4 @@ declare function characterReport(input: CharacterInputs, copyTells?: Set<string>
3731
3777
 
3732
3778
  declare function retrofitPlan(report: CharacterReport, direction?: ArtDirection | null): string;
3733
3779
 
3734
- 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 };
3780
+ 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 CHANGED
@@ -1711,7 +1711,17 @@ var REVIEW_PHRASES = [
1711
1711
  "by far the most",
1712
1712
  "hands down the",
1713
1713
  "arguably the best",
1714
- "bar none"
1714
+ "bar none",
1715
+ // "plain" as a self-description, the way "clear" is: say what the reader gets.
1716
+ "plain answer",
1717
+ "plain answers",
1718
+ "plain recommendation",
1719
+ "plain explanation",
1720
+ "plain explanations",
1721
+ "plain advice",
1722
+ "plain guidance",
1723
+ "plain-speaking",
1724
+ "plain speaking"
1715
1725
  ];
1716
1726
  var SALES_TAGLINES = [
1717
1727
  /\bwhere it (?:really |truly )?(?:counts|matters)(?: most)?\b/i,
@@ -1767,6 +1777,34 @@ var CLIPPED = [
1767
1777
  // "Alright Carlo, built you a proper site": the "I" left out
1768
1778
  /(?<=^|[\n>"“]|[.!?—–-]\s*|,\s+)(?:[Bb]uilt|[Mm]ade|[Pp]ut together|[Kk]nocked up)\s+(?:you|your\s+\w+|the\s+\w+)\s+an?\b/
1769
1779
  ];
1780
+ var PLAIN_FAMILY = [
1781
+ /\b(?:plain english|explained plainly|plainly explained)\b/i,
1782
+ /\bplainly\b(?!\s+marked\b)/i,
1783
+ /\bin\s+plain\s+(?:terms|language|words|speak)\b/i
1784
+ ];
1785
+ var CONFESSION = [
1786
+ // "What this is and is not:", "what we are and aren't"
1787
+ /\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,
1788
+ // "What we are not", a label on its own; not "what we are not responsible for"
1789
+ /(?<!\band\s)\bwhat\s+we(?:\s+are|['’]re)\s+not\b(?!\s+(?:responsible|liable|able|allowed|sure)\b)/i,
1790
+ /\bwhat\s+we\s+(?:don['’]t|do\s+not)\s+do\b/i,
1791
+ // "We have not yet built and run", "we haven't yet worked with"
1792
+ /\bwe(?:\s+have|['’]ve)\s+not\s+yet\s+(?:built|run|done|worked|delivered|shipped|launched)\b/i,
1793
+ /\bwe\s+haven['’]t\s+(?:yet\s+)?(?:built|run|done|worked\s+with|delivered)\b/i,
1794
+ /\bwhat\s+we\s+have\s+and\s+(?:haven['’]t|have\s+not)\s+(?:done|built|run)\b/i,
1795
+ // "Our clinic experience so far is one practice"
1796
+ /\bour\s+(?:[\w-]+\s+){0,3}experience\s+so\s+far\s+(?:is|has\s+been|covers)\b/i,
1797
+ /\bso\s+far\s+(?:is|has\s+been)\s+(?:one|a\s+single|just\s+one)\b/i,
1798
+ /\bwhere\s+our\s+experience\s+(?:applies|ends|stops|runs\s+out)\b/i,
1799
+ /\bwhat\s+we\s+(?:would|['’]d|will|still)\s+need\s+to\s+learn\b/i,
1800
+ // "what we would and wouldn't take on", "what we won't take on"
1801
+ /\b(?:would|will)\s+and\s+(?:wouldn['’]t|would\s+not|won['’]t|will\s+not)\s+take\s+on\b/i,
1802
+ /\bwhat\s+we\s+(?:won['’]t|wouldn['’]t|would\s+not|will\s+not)\s+take\s+on\b/i,
1803
+ // "Who we don't work with", "who this is not for", "we're not for everyone"
1804
+ /\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,
1805
+ /\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,
1806
+ /\b(?:we|this)\s+(?:are|is|['’]re|['’]s)\s+not\s+(?:for\s+everyone|the\s+right\s+fit\s+for)\b/i
1807
+ ];
1770
1808
  var NEGATION = [
1771
1809
  // "It's not just a haircut, it's an experience."
1772
1810
  /\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,
@@ -1780,8 +1818,33 @@ var NEGATION = [
1780
1818
  /\b(?:is|are|was|were)(?:n’t|n't)\b[^.;]{2,60},\s*(?:it|they|that|this)(?:’s|'s|’re|'re)\b/i,
1781
1819
  /\bless\s+about\b[^.;]{2,50}\bmore\s+about\b/i,
1782
1820
  // parallel participle, no repeated subject: "dispatched from here, not shipped in from Seoul"
1783
- /\b\w{3,}ed\b[^,.;:]{0,40},\s*not\s+\w{3,}ed\b/i
1821
+ /\b\w{3,}ed\b[^,.;:]{0,40},\s*not\s+\w{3,}ed\b/i,
1822
+ // parallel gerund: "renting Microsoft's services, not running servers". The
1823
+ // -thing pronouns and the -ing prepositions are not verbs.
1824
+ /\b(?!(?:some|no|any|every)thing\b)\w{3,}ing\b[^,.;:]{0,40},\s*not\s+(?!(?:some|no|any|every)thing\b|(?:during|according|including|regarding|morning|evening)\b)\w{3,}ing\b/i
1825
+ ];
1826
+ var SOFT_CONTRAST = [
1827
+ // ", not registration." closing the sentence. Not when "not" negates what follows.
1828
+ /,\s*not\s+(?!(?:yet|least|only|just|merely|simply|to|all|always|even|ever|necessarily|really|quite|exactly|enough|sure|that|because|so|much|many|once|often|every|including|counting|unlike|until|if|when|unless|though|although|or|and|but)\b)(?:(?:a|an|the|your|our|their|its|his|her|my|any)\s+)?[\w'’-]+(?:\s+[\w'’-]+){0,3}(?=\s*(?:[.!?)"”]|$))/im,
1829
+ // "the league's own threshold, not a legal one"
1830
+ /,\s*not\s+(?:a|an|the)\s+(?:[\w'’-]+\s+)?one\b/i,
1831
+ // "renting computing over the internet instead of owning it"
1832
+ /\b(?!(?:some|no|any|every)thing\b)\w{3,}ing\b[^.;:!?]{0,60}?\binstead\s+of\s+(?!(?:some|no|any|every)thing\b)\w{3,}ing\b/i
1784
1833
  ];
1834
+ var PAIR_TOKEN = String.raw`(?:[£$€]?\d[\d,.]*%?|[\w'’£$€-]+)`;
1835
+ var PAIR_NUMBER = String.raw`(?:one|two|three|four|five|six|seven|eight|nine|ten|eleven|twelve|\d[\d,]*)`;
1836
+ var PARALLEL_PAIR = [
1837
+ // anaphora: "same site, same £8,000", "per user, per month". "No X, no Y" is no-x-no-y's.
1838
+ new RegExp(String.raw`\b(?!no\b)(\w+)[ \t]+${PAIR_TOKEN},[ \t]+\1[ \t]+${PAIR_TOKEN}(?=[ \t]*(?:[.!?]|$))`, "im"),
1839
+ // isocolon on its own line: "One form, seven workflows"
1840
+ new RegExp(String.raw`^[ \t]*(?:#{1,6}[ \t]+)?${PAIR_NUMBER}[ \t]+[\w'’-]+,[ \t]+${PAIR_NUMBER}[ \t]+[\w'’-]+[.!]?[ \t]*$`, "im"),
1841
+ // a verbless list as a tagline: "Service account, match-day reminders, analytics."
1842
+ /^[ \t]*(?:#{1,6}[ \t]+)?[A-Z][\w'’-]*(?:[ \t]+(?!(?:and|or)\b)[\w'’-]+){0,2}(?:,[ \t]+(?!(?:and|or)\b)[\w'’-]+(?:[ \t]+(?!(?:and|or)\b)[\w'’-]+){0,2}){2,3}\.[ \t]*$/m
1843
+ ];
1844
+ var alreadyBlocked = (block, match, index) => {
1845
+ const sentence = block.text.slice(Math.max(0, index - 80), index + match.length);
1846
+ return NEGATION.some((pattern2) => pattern2.test(sentence));
1847
+ };
1785
1848
  var DATA_ABSENCE = /\b(?:yet|found|available|configured|selected|assigned|scheduled|recorded|on file|to show|to display|results|match|matches|matching|data|in this period)\b/i;
1786
1849
  var SIGNED_IN = /(?:^|\/)(?:admin|portal|dashboard|embedded)\//;
1787
1850
  function lineAround(text, index) {
@@ -1896,12 +1959,25 @@ var COPY_TELLS = [
1896
1959
  generation: 2,
1897
1960
  severity: "warn",
1898
1961
  surface: "copy",
1899
- why: "Told to avoid jargon, a model announces that it is avoiding jargon. 'Explained plainly' swaps a synonym and keeps the tell.",
1900
- fix: "Use the house replacement, 'properly explained', or drop the claim and let the copy show it.",
1901
- detect: phrases([/\b(?:plain english|explained plainly|plainly explained)\b/i], quoted),
1962
+ 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.",
1963
+ 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'.",
1964
+ detect: phrases(PLAIN_FAMILY, quoted),
1902
1965
  fixtures: {
1903
- flag: [f("content/home.md", "Your options, in plain English.")],
1904
- pass: [f("content/home.md", "Your options, properly explained.")]
1966
+ flag: [
1967
+ f("content/home.md", "Your options, in plain English."),
1968
+ // Eunice Ordor's draft lines, Pastel 986559 #12 and #13 (her diagnosis taken, her wording not).
1969
+ f("content/clinics.md", "Tell us what's happening and we'll say plainly what we would take on."),
1970
+ f("content/pricing.md", "DD's payment terms, plainly stated."),
1971
+ f("content/clinics.md", "We explain our findings in plain terms."),
1972
+ f("content/clinics.md", "We share findings in plain language.")
1973
+ ],
1974
+ pass: [
1975
+ f("content/home.md", "Your options, properly explained."),
1976
+ f("content/pricing.md", "Our payment terms: 30% when you sign, the rest at launch."),
1977
+ // The Apache and zlib licence wording, copied into a repo as it is.
1978
+ f("LICENSE.txt", "Altered source versions must be plainly marked as such."),
1979
+ f("content/menu.md", "Plain or seeded bagels, and plain-language allergen notes.")
1980
+ ]
1905
1981
  }
1906
1982
  },
1907
1983
  {
@@ -1952,11 +2028,11 @@ var COPY_TELLS = [
1952
2028
  generation: 1,
1953
2029
  severity: "warn",
1954
2030
  surface: "copy",
1955
- 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.",
2031
+ 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.",
1956
2032
  fix: "Keep the one that lands hardest and cut the rest. 'What is genuinely excellent' reads better as 'what is excellent'.",
1957
2033
  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),
1958
2034
  fixtures: {
1959
- flag: [f("content/home.md", "We are truly proud of it."), f("content/home.md", "You leave with a clear next step.")],
2035
+ 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.")],
1960
2036
  pass: [f("content/home.md", "We have fitted 400 boilers since 2009."), f("content/home.md", "Keep a safe clearance around the meter.")]
1961
2037
  }
1962
2038
  },
@@ -2037,6 +2113,40 @@ var COPY_TELLS = [
2037
2113
  ]
2038
2114
  }
2039
2115
  },
2116
+ {
2117
+ id: "confession-line",
2118
+ name: "Confession line",
2119
+ generation: 2,
2120
+ severity: "warn",
2121
+ surface: "copy",
2122
+ 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.",
2123
+ 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.",
2124
+ detect: phrases(CONFESSION, quoted),
2125
+ fixtures: {
2126
+ flag: [
2127
+ // Each one from the DD site, as Eunice Ordor flagged it (Pastel 986559 #8, #12, #13).
2128
+ f("content/clinics.md", "What this is and is not: a practice portal we built and run for one practice."),
2129
+ f("content/clinics.md", "We have not yet built and run the digital systems of a practice with several clinicians."),
2130
+ f("content/home.md", "Including the client portal we run for Sensphere. Our clinic experience so far is one practice."),
2131
+ f("content/clinics.md", "Tell us what's happening and we'll say what we would and wouldn't take on."),
2132
+ f("content/clinics.md", "We will say what carries over from this work and what we would need to learn first."),
2133
+ f("content/clinics.md", "We will tell you where our experience applies directly and where it is close."),
2134
+ f("content/about.md", "What we are not"),
2135
+ f("content/about.md", "Who we don't work with: anyone who needs a site this week."),
2136
+ f("content/mobile.md", "Mobile is our newest line, so we tell you what we have and haven't done.")
2137
+ ],
2138
+ pass: [
2139
+ f("content/clinics.md", "Built and run by us for Sensphere, a growing practice whose clinicians work remotely."),
2140
+ f("content/home.md", "The client portal we run for Sensphere."),
2141
+ // Contractual facts, said as they are.
2142
+ f("content/pricing.md", "Pay monthly is open to UK residents aged 18 and over, subject to status."),
2143
+ f("content/pricing.md", "Your monthly payments do not buy the site; the buy-out price does."),
2144
+ f("content/terms.md", "What we are responsible for, and what we are not responsible for, is in clause 4."),
2145
+ f("content/insurance.md", "Ask what your policy does and does not cover."),
2146
+ f("emails/deposit.md", "We have not yet received your deposit, so the date is still open.")
2147
+ ]
2148
+ }
2149
+ },
2040
2150
  {
2041
2151
  id: "hollow-imperative",
2042
2152
  name: "Hollow imperative",
@@ -2115,7 +2225,7 @@ var COPY_TELLS = [
2115
2225
  generation: 2,
2116
2226
  severity: "warn",
2117
2227
  surface: "copy",
2118
- why: "'It's not just a haircut, it's an experience', 'dispatched from here, not shipped in': the contrast-and-reveal template is the most recognisable construction in generated copy.",
2228
+ why: "'It's not just a haircut, it's an experience', 'dispatched from here, not shipped in': the contrast-and-reveal template (correctio, antithesis: see COPY.md) is the most recognisable construction in generated copy.",
2119
2229
  fix: "Say the positive claim and drop the contrast.",
2120
2230
  detect: phrases(NEGATION, quoted, allText),
2121
2231
  fixtures: {
@@ -2126,12 +2236,54 @@ var COPY_TELLS = [
2126
2236
  f("content/home.md", "Hairdressing isn't a job, it's art."),
2127
2237
  f("content/home.md", "It is less about the tools and more about the eye."),
2128
2238
  f("content/home.md", "Order today and it's dispatched from here, not shipped in from Seoul."),
2129
- f("app/offer.tsx", `export const outcome = "The whole path, not just the ads.";`)
2239
+ f("app/offer.tsx", `export const outcome = "The whole path, not just the ads.";`),
2240
+ // From a 92EL report that passed the gate, October 2026.
2241
+ f("content/report.md", "These are reported, not assumed to pass."),
2242
+ f("content/report.md", "The deletion is proposed, not automated."),
2243
+ f("content/report.md", "For 92EL, that means renting Microsoft's services, not running servers."),
2244
+ f("content/home.md", "Your team should spend time delivering services, not managing bookings.")
2130
2245
  ],
2131
2246
  pass: [
2132
2247
  f("content/home.md", "A haircut, a hot towel and a straight-razor finish."),
2133
2248
  f("content/home.md", "They are cosmetics, not medicines."),
2134
- f("content/home.md", "The box arrived red, not led astray by a dented corner.")
2249
+ f("content/home.md", "The box arrived red, not led astray by a dented corner."),
2250
+ f("content/home.md", "We fix boilers in the morning, not in the evening."),
2251
+ f("content/report.md", "Players never open the lists."),
2252
+ f("content/report.md", "It is not tested at national scale."),
2253
+ f("content/report.md", "Do not invent anything."),
2254
+ f("content/report.md", "Nothing is copied by hand."),
2255
+ f("content/report.md", "Results are checked by a person and not yet automated.")
2256
+ ]
2257
+ }
2258
+ },
2259
+ {
2260
+ id: "trailing-contrast",
2261
+ name: "Trailing contrast",
2262
+ generation: 2,
2263
+ severity: "warn",
2264
+ surface: "copy",
2265
+ why: "'Edge matters for game servers, not registration', 'the league's own threshold, not a legal one', 'renting computing instead of owning it': the contrast template (correctio, antithesis: see COPY.md) in its softer forms. A genuine disclaimer has the same shape, so a person decides.",
2266
+ fix: "Say the positive claim on its own: 'Edge matters for game servers.' Keep the contrast only where the reader would otherwise assume the other thing, such as a legal disclaimer.",
2267
+ detect: phrases(SOFT_CONTRAST, quoted, allText, alreadyBlocked),
2268
+ fixtures: {
2269
+ flag: [
2270
+ // From a 92EL report that passed the gate, October 2026.
2271
+ f("content/report.md", "Edge matters for game servers, not registration."),
2272
+ f("content/report.md", "Age 18 is the league's own threshold, not a legal one."),
2273
+ f("content/report.md", "Cloud computing means renting computing over the internet instead of owning it."),
2274
+ f("content/home.md", "Real Square data, not a vanity metric.")
2275
+ ],
2276
+ pass: [
2277
+ f("content/home.md", "Rewire, retile and replumb a bathroom in five days."),
2278
+ f("content/report.md", "Players never open the lists."),
2279
+ f("content/report.md", "It is not tested at national scale."),
2280
+ f("content/report.md", "Do not invent anything."),
2281
+ f("content/report.md", "Nothing is copied by hand."),
2282
+ f("content/report.md", "Results are checked by a person and not yet automated."),
2283
+ f("content/home.md", "Pay by card, not to mention Apple Pay."),
2284
+ f("content/home.md", "Card instead of cash is fine."),
2285
+ // The blocking rule reports this one; it is not reported twice.
2286
+ f("content/report.md", "The deletion is proposed, not automated.")
2135
2287
  ]
2136
2288
  }
2137
2289
  },
@@ -2181,7 +2333,7 @@ var COPY_TELLS = [
2181
2333
  generation: 2,
2182
2334
  severity: "warn",
2183
2335
  surface: "copy",
2184
- why: "Three fragments in a row ('Fast. Friendly. Local.' or 'No fuss. No jargon. Just results.') is the second wave's favourite rhythm.",
2336
+ why: "Three fragments in a row ('Fast. Friendly. Local.' or 'No fuss. No jargon. Just results.') (a tricolon in asyndeton: see COPY.md) is the second wave's favourite rhythm.",
2185
2337
  fix: "Write one sentence that says which of the three is true, and how you know.",
2186
2338
  // The fragments share one paragraph: "You don't. Again.", a blank line, then "It's frustrating." is two beats, not three.
2187
2339
  detect: phrases([/(?:\b[A-Z][\w'’-]*(?:[ \t]+[\w'’-]+){0,2}[.!](?:[ \t]+|[ \t]*\n(?![ \t]*\n)[ \t]*)){2}[A-Z][\w'’-]*(?:[ \t]+[\w'’-]+){0,2}[.!](?=\s|$)/], quoted),
@@ -2193,6 +2345,36 @@ var COPY_TELLS = [
2193
2345
  ]
2194
2346
  }
2195
2347
  },
2348
+ {
2349
+ id: "parallel-pair",
2350
+ name: "Verbless parallel pair",
2351
+ generation: 2,
2352
+ severity: "warn",
2353
+ surface: "copy",
2354
+ why: "'One form, seven workflows', 'Same site, same \xA38,000': two matched fragments with no verb (isocolon, often with anaphora or asyndeton: see COPY.md), the staccato triplet's two-part cousin. It sounds decided and says less than a sentence would.",
2355
+ fix: "Write the sentence the pair stands for: 'One form and seven workflows replace the spreadsheets.' A short label on a slide can stay if a person reads it and it earns its place.",
2356
+ detect: phrases(PARALLEL_PAIR, quoted),
2357
+ fixtures: {
2358
+ flag: [
2359
+ // From 92EL deliverables, October 2026.
2360
+ f("content/deck.md", "# One form, seven workflows"),
2361
+ f("content/deck.md", "One form, seven workflows."),
2362
+ f("content/deck.md", "Same site, same \xA38,000."),
2363
+ f("content/deck.md", "Pay per user, per month"),
2364
+ f("content/deck.md", "Service account, match-day reminders, analytics.")
2365
+ ],
2366
+ pass: [
2367
+ f("content/deck.md", "Forms, SharePoint, Outlook and Teams"),
2368
+ f("content/deck.md", "One form and seven workflows replace 92EL's spreadsheets and email chains."),
2369
+ f("content/deck.md", "PulseCloud Technologies, for 92EL senior management"),
2370
+ f("content/deck.md", "41 of 50 passed, 12 after a fix."),
2371
+ f("content/deck.md", "Pay monthly for each user"),
2372
+ f("content/home.md", "We fix boilers the same day, and we tell you the price before we start."),
2373
+ // The blocking no-x-no-y reports this one.
2374
+ f("content/home.md", "We reply within a day. No obligation, no spam.")
2375
+ ]
2376
+ }
2377
+ },
2196
2378
  {
2197
2379
  id: "where-x-meets-y",
2198
2380
  name: "'Where X meets Y'",
@@ -3303,6 +3485,69 @@ function eyebrowChipHits(ctx) {
3303
3485
  }
3304
3486
  return hits;
3305
3487
  }
3488
+ var HERO_OPEN = /<(section|header|div|main|article|Section|Container)\b[^>]*?\b(?:class|className|id)\s*=\s*(?:"|'|\{\s*[`"']?)[^"'`>]*?(?<![a-z])hero(?![a-z])[^>]*>/gi;
3489
+ function closeOf(text, tag, from) {
3490
+ const re = new RegExp(`<(/?)${tag}\\b[^>]*?(/?)>`, "g");
3491
+ re.lastIndex = from;
3492
+ let depth = 0;
3493
+ for (let m = re.exec(text); m; m = re.exec(text)) {
3494
+ if (m[2] === "/") continue;
3495
+ depth += m[1] === "/" ? -1 : 1;
3496
+ if (depth === 0) return m.index + m[0].length;
3497
+ if (m.index - from > 8e3) break;
3498
+ }
3499
+ return Math.min(text.length, from + 4e3);
3500
+ }
3501
+ function heroSpans(path, text) {
3502
+ if (/(?:^|[\\/])[\w-]*hero[\w-]*\.(?:astro|tsx|jsx|vue|svelte)$/i.test(path)) return [[0, text.length]];
3503
+ const spans = [];
3504
+ for (const m of text.matchAll(HERO_OPEN)) {
3505
+ const at = m.index ?? 0;
3506
+ if (spans.some(([a, b]) => at >= a && at < b)) continue;
3507
+ spans.push([at, closeOf(text, m[1], at)]);
3508
+ }
3509
+ if (spans.length > 0) return spans;
3510
+ const h1 = text.search(/<h1\b/);
3511
+ if (h1 === -1) return [];
3512
+ const rest = text.slice(h1);
3513
+ const end = rest.search(/<\/(?:section|header)>|<section\b/);
3514
+ return [[h1, h1 + Math.min(end === -1 ? rest.length : end, 1500)]];
3515
+ }
3516
+ var CONTROL = /<(a|button|Button|ButtonLink|LinkButton|Link|Cta|CTA|CallToAction)\b([^>]*)>([\s\S]{0,300}?)<\/\1>/g;
3517
+ var BUTTON_COMPONENT = /^(?:Button|ButtonLink|LinkButton|Cta|CTA|CallToAction)$/;
3518
+ var BUTTON_CLASS = /(?<![a-z])(?:btn|button|cta)(?![a-z])/i;
3519
+ var TOGGLE = /\baria-(?:expanded|controls|haspopup)\b|\btype\s*=\s*["']submit["']/;
3520
+ var NOT_A_LANDING = /(?:^|[\\/])(?:error|global-error|not-found|404|500)\.\w+$|[\\/](?:admin|portal|dashboard|account|\(qa\)|\(app\)|qa)[\\/]/i;
3521
+ function buttonLabel(attrs, inner) {
3522
+ const text = inner.replace(/<[^>]*>/g, " ").replace(/\{[^}]*\}/g, " ").replace(/\s+/g, " ").trim();
3523
+ if (text && !/[{}()=]/.test(text)) return text.slice(0, 40);
3524
+ return attrs.match(/\bhref\s*=\s*["'{`$]*\{?([^"'}`\s]+)/)?.[1] ?? "a button";
3525
+ }
3526
+ function heroCtaPairHits(ctx) {
3527
+ const hits = [];
3528
+ for (const file of ctx.files) {
3529
+ if (file.kind !== "markup" || NOT_A_LANDING.test(file.path)) continue;
3530
+ const text = file.text.replace(/\\"/g, ' "');
3531
+ for (const [start, end] of heroSpans(file.path, text)) {
3532
+ const span = text.slice(start, end).replace(/<(nav|form)\b[\s\S]*?<\/\1>/gi, (s) => " ".repeat(s.length));
3533
+ const buttons = [];
3534
+ for (const m of span.matchAll(CONTROL)) {
3535
+ const [, tag, attrs, inner] = m;
3536
+ if (TOGGLE.test(attrs)) continue;
3537
+ const cls = attrs.match(/\b(?:class|className|variant)\s*=\s*(?:"([^"]*)"|'([^']*)'|\{([^}]*)\})/g)?.join(" ") ?? "";
3538
+ const tw = /\bpx-\d/.test(cls) && /\bpy-\d/.test(cls) && /\b(?:bg-|border\b|border-|rounded)/.test(cls);
3539
+ if (BUTTON_COMPONENT.test(tag) || BUTTON_CLASS.test(cls) || tw || /\brole\s*=\s*["']button["']/.test(attrs)) {
3540
+ buttons.push({ label: buttonLabel(attrs, inner), offset: start + (m.index ?? 0) });
3541
+ }
3542
+ }
3543
+ if (buttons.length >= 2) {
3544
+ const names = buttons.slice(0, 3).map((b) => `"${b.label}"`).join(", ");
3545
+ hits.push({ path: file.path, offset: buttons[1].offset, message: `${buttons.length} buttons side by side in the hero: ${names}` });
3546
+ }
3547
+ }
3548
+ }
3549
+ return hits;
3550
+ }
3306
3551
  function iconTiles(file) {
3307
3552
  return file.classUnits.filter((unit) => {
3308
3553
  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 +3998,75 @@ const inter = Inter({ subsets: ["latin"] });`),
3753
3998
  <span className="inline-flex rounded-full border px-3 py-1 text-xs">Tag</span>`)]
3754
3999
  }
3755
4000
  },
4001
+ {
4002
+ id: "hero-cta-pair",
4003
+ name: "Two buttons in the hero",
4004
+ generation: 1,
4005
+ severity: "warn",
4006
+ surface: "source",
4007
+ 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.",
4008
+ 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.",
4009
+ detect: heroCtaPairHits,
4010
+ fixtures: {
4011
+ flag: [
4012
+ // Eunice Ordor's #5 and #36 (Pastel 986559): the DD site's own hero and process close.
4013
+ f3(
4014
+ "src/components/Hero.astro",
4015
+ `<section class="hero">
4016
+ <h1>We run the systems behind your website</h1>
4017
+ <a href="/contact" class="btn btn-primary">Get in touch</a>
4018
+ <a href="/work" class="btn btn-ghost">See our work</a>
4019
+ </section>`
4020
+ ),
4021
+ // The null build's hero, verbatim in shape (calibration/null/rmp/pages/05.html).
4022
+ f3(
4023
+ "index.html",
4024
+ `<nav><a class="btn" href="#contact">Quote</a></nav>
4025
+ <section id="hero" class="hero">
4026
+ <h1>Electricians in Uxbridge</h1>
4027
+ <a href="#contact" class="btn btn-primary">Book a Free Quote</a>
4028
+ <a href="tel:+441895555210" class="btn btn-outline">Call 01895 555 210</a>
4029
+ </section>`
4030
+ ),
4031
+ f3(
4032
+ "app/page.tsx",
4033
+ `<section className="relative py-24">
4034
+ <h1 className="text-5xl">Nails in Brackley</h1>
4035
+ <div className="flex gap-4">
4036
+ <Button asChild><a href="/book">Book now</a></Button>
4037
+ <Button variant="outline">View treatments</Button>
4038
+ </div>
4039
+ </section>`
4040
+ )
4041
+ ],
4042
+ pass: [
4043
+ // One button, and the second route as a text link in the sentence.
4044
+ f3(
4045
+ "src/components/Hero.astro",
4046
+ `<section class="hero">
4047
+ <h1>We run the systems behind your website</h1>
4048
+ <p>Tell us what's going on, or <a href="/work">see the work first</a>.</p>
4049
+ <a href="/contact" class="btn btn-primary">Get in touch</a>
4050
+ </section>`
4051
+ ),
4052
+ // A button in the nav and a search form are not the hero's ask.
4053
+ f3(
4054
+ "index.html",
4055
+ `<header class="hero">
4056
+ <nav><a class="btn" href="/book">Book</a></nav>
4057
+ <h1>Barbers in Manchester</h1>
4058
+ <a class="btn" href="/book">Book a cut</a>
4059
+ <form><button class="btn" type="submit">Search</button></form>
4060
+ </header>`
4061
+ ),
4062
+ f3("app/page.tsx", `<section className="py-24">
4063
+ <h1 className="text-5xl">Nails in Brackley</h1>
4064
+ <a className="rounded bg-ink px-5 py-3" href="/book">Book now</a>
4065
+ </section>
4066
+ <section><a className="rounded bg-ink px-5 py-3" href="/prices">Prices</a></section>`)
4067
+ ]
4068
+ }
4069
+ },
3756
4070
  {
3757
4071
  id: "icon-tile-stack",
3758
4072
  name: "Icon in a tinted tile",
@@ -4978,7 +5292,9 @@ var HOUSE = {
4978
5292
  "no-x-badge": { tier: "block", label: 'standalone "No X" badge. Reads as a slapped-on kicker, and worse when reused across pieces' },
4979
5293
  "ai-phrase": { tier: "block", label: "AI tell" },
4980
5294
  "plainer-word": { tier: "block", label: "a plainer word exists. Name the mechanism instead" },
4981
- "plain-english": { tier: "block", label: 'use "properly explained"' },
5295
+ // Widened 2026-10-20 (founder) to bare "plainly" and "in plain terms/language/words";
5296
+ // estate hits read first (DOM-1058), nearly all the stock "stated plainly".
5297
+ "plain-english": { tier: "block", label: 'the plain-English family. Drop the adverb and say the thing, or use "properly explained"' },
4982
5298
  buzzword: { tier: "block", label: "forbidden phrase" },
4983
5299
  "negative-reassurance": { tier: "block", label: "negative reassurance, say what they get" },
4984
5300
  // Evidence of a pasted chat reply, not a matter of style. Moved from review
@@ -4992,6 +5308,13 @@ var HOUSE = {
4992
5308
  "stock-email-line": { tier: "review", label: "stock email line, start with the reason for writing and end with the next step" },
4993
5309
  // New 2026-10-19 (founder): review first, like every new tell, until estate hits are read.
4994
5310
  "matey-register": { tier: "review", label: "matey register, write plain and complete British English" },
5311
+ // New 2026-10-20 (founder, from Eunice Ordor's review): review first, like every new tell.
5312
+ "confession-line": { tier: "review", label: "confession line, scope the work by saying precisely what is true" },
5313
+ // New 2026-10-23 (a 92EL report passed the gate with three): review, because a
5314
+ // genuine disclaimer has the same shape. The gerund pair joined not-just-but.
5315
+ // New 2026-10-23 (founder, from 92EL deliverables): review, since a short slide label is often fine.
5316
+ "parallel-pair": { tier: "review", label: "verbless parallel pair, write the sentence it stands for" },
5317
+ "trailing-contrast": { tier: "review", label: "trailing contrast. Say the positive claim, unless it is a disclaimer the reader needs" },
4995
5318
  "ai-vocabulary": { tier: "review", label: "AI vocabulary" },
4996
5319
  "stock-phrase": { tier: "review", label: "stock phrase" },
4997
5320
  "hollow-imperative": { tier: "review", label: "hollow imperative" },
@@ -5228,6 +5551,33 @@ var RENDERED_PATHS = {
5228
5551
  detect: (s) => s.effects.eyebrowChip ? [hit(s, "a small bordered pill sits above the headline")] : [],
5229
5552
  fixtures: { flag: [makeSnapshot({ effects: { eyebrowChip: true } })], pass: [makeSnapshot()] }
5230
5553
  },
5554
+ "hero-cta-pair": {
5555
+ // Version 2 geometry counts buttons and button-styled links per section. A
5556
+ // header painted inside the hero's box adds its own button, which the
5557
+ // source path can tell apart and this one cannot; a ghost button with no
5558
+ // fill or border is not counted, so this path under-reports.
5559
+ detect: (s) => {
5560
+ const first = s.sections[0];
5561
+ const controls = first?.geometry?.controls ?? 0;
5562
+ return first && (first.role ?? first.kind) === "hero" && controls >= 2 ? [hit(s, `${controls} buttons in the hero`, first.label)] : [];
5563
+ },
5564
+ fixtures: {
5565
+ flag: [
5566
+ {
5567
+ ...makeSnapshot(),
5568
+ 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)
5569
+ }
5570
+ ],
5571
+ pass: [
5572
+ makeSnapshot(),
5573
+ // One button, with the second route as a text link: one control.
5574
+ {
5575
+ ...makeSnapshot(),
5576
+ 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)
5577
+ }
5578
+ ]
5579
+ }
5580
+ },
5231
5581
  "icon-tile-grid": {
5232
5582
  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)),
5233
5583
  fixtures: {
@@ -6197,7 +6547,7 @@ var IMAGERY_TELLS = [
6197
6547
  ];
6198
6548
 
6199
6549
  // src/character/check.ts
6200
- var CATALOGUE_VERSION = "2026.10.4";
6550
+ var CATALOGUE_VERSION = "2026.10.7";
6201
6551
  var CATALOGUE = [
6202
6552
  ...[...SOURCE_TELLS, ...COPY_TELLS, ...RESEARCH_TELLS, ...DENSITY_TELLS].map((t) => RENDERED_PATHS[t.id] ? { ...t, rendered: RENDERED_PATHS[t.id] } : t),
6203
6553
  ...SPECIFICITY_COPY_TELLS,
@@ -8376,6 +8726,7 @@ var INSPECTED_KINDS = ["screenshot", "rendered", "source", "measurement", "conte
8376
8726
  var REPORTED_KINDS = ["audit", "stakeholder", "customer"];
8377
8727
  var EVIDENCE_KINDS = [...INSPECTED_KINDS, ...REPORTED_KINDS];
8378
8728
  var CHANGE_CLASSES = ["confirmed-correction", "design-hypothesis", "optional-refinement", "no-change"];
8729
+ var REVIEW_VERDICTS = ["praise", "take", "take-reworded", "partly", "decline", "founder-decision", "known"];
8379
8730
  var CHANGE_STEPS = ["copy", "relocate", "group", "imagery", "trust-placement", "adjust-component", "remove-redundancy", "restructure", "new-component"];
8380
8731
  var ADDITIONS = ["carousel", "javascript", "dependency", "animation", "testimonial", "cta", "duplicate-content"];
8381
8732
 
@@ -10139,6 +10490,7 @@ export {
10139
10490
  REVEAL_LIMIT,
10140
10491
  REVIEW_BASES,
10141
10492
  REVIEW_PHRASES,
10493
+ REVIEW_VERDICTS,
10142
10494
  SAMPLES_PER_SEGMENT,
10143
10495
  SCALE,
10144
10496
  SECTION_ROLES,