taste-lint 0.2.0 → 0.3.0

package/dist/index.d.ts

@@ -431,6 +431,8 @@ interface Config {
   };
   smartQuotesAtBuild: boolean;
   exclude: string[];
+  /** Extra rule directories from the config, absolute. */
+  rules?: string[];
 }
 //#endregion
 //#region src/scan/profiles.d.ts
@@ -507,6 +509,8 @@ interface LoadOptions {
   allowDraft?: boolean;
   /** Restrict to these rule ids. */
   only?: string[];
+  /** More rule directories with the same domain-folder layout, such as a voice pack. */
+  extraDirs?: string[];
 }
 declare const loadRules: (rulesDir: string, options?: LoadOptions) => Rule[];
 //#endregion

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../src/analysis/repository.ts","../src/types.ts","../src/scan/profiles.ts","../src/lib/config.ts","../src/lint.ts","../src/rules/load.ts","../src/rules/taxonomy.ts","../src/extract/index.ts","../src/extract/tsx.ts","../src/map/jev.ts","../src/report/json.ts","../src/report/sarif.ts","../src/report/tty.ts","../src/lib/stats.ts","../src/eval/coverage.ts","../src/eval/metrics.ts","../src/eval/corpus.ts","../src/eval/promotion.ts","../src/eval/tune.ts"],"mappings":"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"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/analysis/repository.ts","../src/types.ts","../src/scan/profiles.ts","../src/lib/config.ts","../src/lint.ts","../src/rules/load.ts","../src/rules/taxonomy.ts","../src/extract/index.ts","../src/extract/tsx.ts","../src/map/jev.ts","../src/report/json.ts","../src/report/sarif.ts","../src/report/tty.ts","../src/lib/stats.ts","../src/eval/coverage.ts","../src/eval/metrics.ts","../src/eval/corpus.ts","../src/eval/promotion.ts","../src/eval/tune.ts"],"mappings":"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"}

package/dist/index.js

@@ -4,6 +4,7 @@ import { fromMarkdown } from "mdast-util-from-markdown";
 import { gfmFromMarkdown } from "mdast-util-gfm";
 import { gfm } from "micromark-extension-gfm";
 import { parseSync } from "oxc-parser";
+import os from "node:os";
 import { execFileSync, spawnSync } from "node:child_process";
 import { mdxFromMarkdown } from "mdast-util-mdx";
 import { mdxjs } from "micromark-extension-mdxjs";
@@ -204,7 +205,10 @@ const DEFAULT_EXCLUDE = [
 	"**/.next/**",
 	"**/.git/**",
 	"**/results/**",
-	"**/coverage/**"
+	"**/coverage/**",
+	"**/LICENSE",
+	"**/LICENSE.*",
+	"**/CHANGELOG.md"
 ];
 const globToRegExp = (glob) => {
 	let out = "^";
@@ -413,10 +417,12 @@ function validateConfig(raw) {
 		"smartQuotesAtBuild",
 		"docTypes",
 		"components",
-		"tailwind"
+		"tailwind",
+		"rules"
 	], "");
 	if (value.$schema !== void 0 && typeof value.$schema !== "string") invalid("$schema", "a string");
 	if (value.exclude !== void 0) strings(value.exclude, "exclude");
+	if (value.rules !== void 0) strings(value.rules, "rules");
 	if (value.smartQuotesAtBuild !== void 0 && typeof value.smartQuotesAtBuild !== "boolean") invalid("smartQuotesAtBuild", "a boolean");
 	if (value.docTypes !== void 0) {
 		if (!Array.isArray(value.docTypes)) invalid("docTypes", "an array");
@@ -441,6 +447,22 @@ function validateConfig(raw) {
 		}
 	}
 }
+const ruleDir = (root, raw) => {
+	const expanded = raw.replace(/^~(?=$|\/)/u, os.homedir()).replaceAll(/\$\{?(\w+)\}?/gu, (_, name) => {
+		const value = process.env[name];
+		if (!value) throw new InputError("INVALID_CONFIG", `taste-lint.config.json: rules entry ${raw} names ${name}, which is not set.`, {
+			field: "rules",
+			variable: name
+		});
+		return value;
+	});
+	const dir = path.resolve(root, expanded);
+	if (!fs.existsSync(dir) || !fs.statSync(dir).isDirectory()) throw new InputError("INVALID_CONFIG", `taste-lint.config.json: rules entry ${raw} is not a directory (${dir}).`, {
+		field: "rules",
+		path: dir
+	});
+	return dir;
+};
 const loadConfig = (root, defaults = []) => {
 	const absRoot = path.resolve(root);
 	try {
@@ -475,6 +497,7 @@ const loadConfig = (root, defaults = []) => {
 		],
 		exclude: user.exclude ?? [],
 		root: absRoot,
+		rules: (user.rules ?? []).map((raw) => ruleDir(absRoot, raw)),
 		smartQuotesAtBuild: typeof user.smartQuotesAtBuild === "boolean" ? user.smartQuotesAtBuild : detectSmartQuotesAtBuild(absRoot),
 		tailwind: { theme: user.tailwind?.theme ?? {} }
 	};
@@ -2351,11 +2374,54 @@ const smartQuotes = (prose) => prose.replaceAll(OPENING_DOUBLE, "$1“").replace
 const ellipsis = (prose) => prose.replaceAll("...", "…");
 const multiplicationSign = (prose) => prose.replaceAll(/(?<![\w.])([1-9]\d*)\s?x\s?(\d+)(?![\w.%])/gu, "$1×$2");
 const nbspValueUnit = (prose) => prose.replaceAll(/(\d) (?=(?:px|pt|em|rem|ms|min|KB|MB|GB|TB|kg|km|cm|mm|fps|%)(?![\p{L}\d]))/gu, "$1\xA0");
+const stripUtm = (prose) => prose.replaceAll(/\?utm_source=chatgpt\.com(?![\w&=-])/gu, "").replaceAll(/([?&])utm_source=chatgpt\.com&/gu, "$1").replaceAll("&utm_source=chatgpt.com", "");
+const AU_SPELLING = {
+	analyze: "analyse",
+	analyzed: "analysed",
+	apologize: "apologise",
+	behavior: "behaviour",
+	behaviors: "behaviours",
+	canceled: "cancelled",
+	canceling: "cancelling",
+	catalog: "catalogue",
+	color: "colour",
+	colored: "coloured",
+	colors: "colours",
+	customize: "customise",
+	customized: "customised",
+	favorite: "favourite",
+	favorites: "favourites",
+	gray: "grey",
+	honor: "honour",
+	labeled: "labelled",
+	labeling: "labelling",
+	modeling: "modelling",
+	neighbor: "neighbour",
+	optimize: "optimise",
+	optimized: "optimised",
+	organization: "organisation",
+	organizations: "organisations",
+	organize: "organise",
+	organized: "organised",
+	prioritize: "prioritise",
+	realize: "realise",
+	realized: "realised",
+	recognize: "recognise",
+	traveling: "travelling"
+};
+const AU_SPELLING_PATTERN = String.raw`(?<!\S*/\S*)\b(?:${Object.keys(AU_SPELLING).join("|")})\b(?!\S*/)`;
+const auSpelling = (prose) => prose.replaceAll(new RegExp(AU_SPELLING_PATTERN, "giu"), (word) => {
+	const au = AU_SPELLING[word.toLowerCase()];
+	if (!au || word !== word.toLowerCase() && word !== `${word[0]}${word.slice(1).toLowerCase()}`) return word;
+	return word[0] === word[0].toUpperCase() ? `${au[0].toUpperCase()}${au.slice(1)}` : au;
+});
 const FIXES = {
+	auSpelling,
 	ellipsis,
 	multiplicationSign,
 	nbspValueUnit,
-	smartQuotes
+	smartQuotes,
+	stripUtm
 };
 //#endregion
 //#region src/rules/validate-sections.ts
@@ -3316,7 +3382,7 @@ const codeRule = (spec, module) => {
 //#endregion
 //#region src/rules/code/classes.ts
 const MODULE$1 = "src/rules/code/classes.ts";
-const ANIMATION = "skills/ui-animation/references";
+const ANIMATION$1 = "skills/ui-animation/references";
 const bases = (unit) => (unit.classes ?? []).map(baseClass);
 const animates = (list) => list.some((c) => c.startsWith("transition") && c !== "transition-none" || c.startsWith("duration-") || c.startsWith("animate-") && c !== "animate-none");
 const durationMs = (cls) => {
@@ -3381,7 +3447,7 @@ const CLASS_RULES = [
 		id: "motion-ease-in-on-transition",
 		source: {
 			line: 27,
-			path: `${ANIMATION}/debugging-symptoms.md`
+			path: `${ANIMATION$1}/debugging-symptoms.md`
 		},
 		title: "Transition eases in, so it starts slow while the user is watching"
 	}),
@@ -3396,7 +3462,7 @@ const CLASS_RULES = [
 		id: "motion-linear-easing-on-transition",
 		source: {
 			line: 37,
-			path: `${ANIMATION}/debugging-symptoms.md`
+			path: `${ANIMATION$1}/debugging-symptoms.md`
 		},
 		title: "Linear easing on motion that is not a spinner or marquee"
 	}),
@@ -3412,7 +3478,7 @@ const CLASS_RULES = [
 		id: "motion-duration-over-300ms",
 		source: {
 			line: 29,
-			path: `${ANIMATION}/debugging-symptoms.md`
+			path: `${ANIMATION$1}/debugging-symptoms.md`
 		},
 		title: "Transition longer than 300ms on product UI"
 	}),
@@ -3423,7 +3489,7 @@ const CLASS_RULES = [
 		id: "motion-transition-all",
 		source: {
 			line: 58,
-			path: `${ANIMATION}/review-format.md`
+			path: `${ANIMATION$1}/review-format.md`
 		},
 		title: "transition-all animates every property, layout included"
 	}),
@@ -3438,7 +3504,7 @@ const CLASS_RULES = [
 		id: "motion-scale-from-zero",
 		source: {
 			line: 46,
-			path: `${ANIMATION}/debugging-symptoms.md`
+			path: `${ANIMATION$1}/debugging-symptoms.md`
 		},
 		title: "Entrance from scale zero"
 	}),
@@ -3454,7 +3520,7 @@ const CLASS_RULES = [
 		id: "motion-animate-without-reduced-motion",
 		source: {
 			line: 57,
-			path: `${ANIMATION}/live-tuning.md`
+			path: `${ANIMATION$1}/live-tuning.md`
 		},
 		status: "review-only",
 		title: "Animation has no local reduced-motion guard"
@@ -3523,7 +3589,7 @@ const document = (unit) => {
 	return unit.facts.document;
 };
 const nodes = (unit) => descendants(document(unit));
-const make$1 = (name, title, source, include, check, hint, authoring = false) => codeRule({
+const make$1 = (name, title, source, include, check, hint, authoring = false, status = "review-only") => codeRule({
 	categoryId: authoring ? "instruction-quality" : "reference-reading",
 	check,
 	hint,
@@ -3534,7 +3600,7 @@ const make$1 = (name, title, source, include, check, hint, authoring = false) =>
 		path: `skills/${source}`,
 		repo: "mblode/agent-skills"
 	},
-	status: "review-only",
+	status,
 	title,
 	unit: ["source"]
 }, "src/rules/code/documents.ts");
@@ -3545,7 +3611,7 @@ const INSTRUCTIONS = [
 	"**/SKILL.md"
 ];
 const DOCS = ["**/*.md"];
-const README_SOURCE = "readme-creator/references/quality-checklist.md";
+const README_SOURCE = "ghostwriter/references/readme.md";
 const DOCUMENT_RULES = [
 	make$1("readme-scaffold", "README still contains scaffold instructions", README_SOURCE, README, (u) => {
 		const n = nodes(u).find((candidate) => candidate.type === "paragraph" && /This is a \[?Next\.js.*bootstrapped with|This template provides a minimal setup to get React working in Vite/i.test(nodeText(candidate)));
@@ -3568,7 +3634,7 @@ const DOCUMENT_RULES = [
 		}
 		return none;
 	}, "Provide a complete first-run example; move intentionally partial examples to a tutorial."),
-	make$1("document-empty-heading", "A section has no content", "docs-writing/rules/structure-no-filler-sections.md", DOCS, (u) => {
+	make$1("document-empty-heading", "A section has no content", "ghostwriter/references/docs.md", DOCS, (u) => {
 		const children = document(u).children ?? [];
 		for (const [i, n] of children.entries()) {
 			if (n.type !== "heading") continue;
@@ -3577,7 +3643,7 @@ const DOCUMENT_RULES = [
 		}
 		return none;
 	}, "Add the section's content or remove its heading."),
-	make$1("document-heading-order", "Heading skips a structural level", "docs-writing/rules/format-semantic-html.md", DOCS, (u) => {
+	make$1("document-heading-order", "Heading skips a structural level", "ghostwriter/references/docs.md", DOCS, (u) => {
 		let previous = 0;
 		for (const n of nodes(u).filter((candidate) => candidate.type === "heading")) {
 			const depth = n.depth ?? 1;
@@ -3586,7 +3652,11 @@ const DOCUMENT_RULES = [
 		}
 		return none;
 	}, "Nest heading levels in order so the document outline reflects its structure."),
-	make$1("document-broken-local-link", "Document links to a missing local file", "docs-writing/rules/review-verify-links.md", DOCS, (u) => {
+	make$1("document-code-fence-language", "Code fence has no language tag", "ghostwriter/references/docs.md", DOCS, (u) => {
+		const n = nodes(u).find((candidate) => candidate.type === "code" && !candidate.lang);
+		return n ? at(n, "Fence without a language tag") : none;
+	}, "Tag the fence: ```bash, ```ts, or ```text for output. The tag drives highlighting and tells the reader what to paste where."),
+	make$1("document-broken-local-link", "Document links to a missing local file", "ghostwriter/references/docs.md", DOCS, (u) => {
 		const repo = u.facts.repository;
 		for (const n of nodes(u).filter((candidate) => [
 			"link",
@@ -3607,7 +3677,7 @@ const DOCUMENT_RULES = [
 			if (!repo.exists(resolved)) return at(n, `Missing local target: ${target}`);
 		}
 		return none;
-	}, "Correct the link or provide the referenced file. Generated site routes need a route-aware check."),
+	}, "Correct the link or provide the referenced file. Generated site routes need a route-aware check.", false, "active"),
 	make$1("instruction-missing-script", "Instruction invokes an undefined package script", "agents-md/references/quick-checklist.md", INSTRUCTIONS, (u) => {
 		const manifest = u.facts.repository.manifest(u.file);
 		if (!manifest) throw new UnresolvedError("No readable package manifest for this instruction file");
@@ -3676,6 +3746,7 @@ const IMAGE_RULES = [{
 	id: "interaction-a11y-image-alt-text",
 	required: ["alt"],
 	source: "a11y-image-alt-text",
+	status: "active",
 	title: "Image is missing an alt attribute"
 }, {
 	categoryId: "resilience",
@@ -3683,6 +3754,7 @@ const IMAGE_RULES = [{
 	id: "craft-image-dimensions-and-priority",
 	required: ["width", "height"],
 	source: "perf-image-dimensions-and-priority",
+	status: "review-only",
 	title: "Image has no declared dimensions or style"
 }].map((spec) => codeRule({
 	categoryId: spec.categoryId,
@@ -3708,11 +3780,62 @@ const IMAGE_RULES = [{
 		repo: "mblode/agent-skills",
 		ruleId: spec.source
 	},
-	status: "review-only",
+	status: spec.status,
 	title: spec.title,
 	unit: ["source"]
 }, "src/rules/code/images.ts"));
 //#endregion
+//#region src/rules/code/motion-source.ts
+const ANIMATION = "skills/ui-animation/SKILL.md";
+const stripComments = (text) => text.replaceAll(/\/\*[\s\S]*?\*\/|(?<![:"'\w])\/\/[^\n]*/gu, (m) => m.replaceAll(/[^\n]/gu, " "));
+const first = (unit, re, evidence) => {
+	const m = re.exec(stripComments(unit.text));
+	return m ? {
+		evidence,
+		fired: true,
+		offset: m.index
+	} : none;
+};
+const MOTION_SOURCE_RULES = [codeRule({
+	categoryId: "motion-restraint",
+	check: (unit) => first(unit, /(?:^|[{;\s])transition(?:-property)?\s*:\s*["'`]?all\b/mu, "transition: all"),
+	hint: "List the properties: transition: transform 200ms, opacity 200ms. `all` animates layout and silently adopts properties added later.",
+	id: "motion-css-transition-all",
+	scope: { include: [
+		"**/*.css",
+		"**/*.scss",
+		"**/*.tsx",
+		"**/*.jsx"
+	] },
+	source: {
+		line: 67,
+		path: ANIMATION,
+		repo: "mblode/agent-skills"
+	},
+	title: "transition: all animates every property, layout included",
+	unit: ["source"]
+}, "src/rules/code/motion-source.ts"), codeRule({
+	categoryId: "motion-restraint",
+	check: (unit) => first(unit, /\bfrom\s*["']framer-motion(?:\/[^"']*)?["']|\b(?:import|require)\s*\(\s*["']framer-motion["']/u, "imports framer-motion"),
+	hint: "Install `motion` and import from \"motion/react\". A mixed codebase compiles but ships two copies of the library.",
+	id: "motion-framer-motion-import",
+	scope: { include: [
+		"**/*.tsx",
+		"**/*.jsx",
+		"**/*.ts",
+		"**/*.js",
+		"**/*.mjs",
+		"**/*.mts"
+	] },
+	source: {
+		line: 153,
+		path: ANIMATION,
+		repo: "mblode/agent-skills"
+	},
+	title: "Imports framer-motion instead of motion/react",
+	unit: ["source"]
+}, "src/rules/code/motion-source.ts")];
+//#endregion
 //#region src/rules/code/skill-classes.ts
 const make = (id, title, categoryId, source, check, hint) => codeRule({
 	categoryId,
@@ -3972,7 +4095,7 @@ const CODE_RULES = [
 		rule({
 			categoryId: "machine-prose",
 			check: (unit) => {
-				const long = unit.text.split(/(?<=[.!?])\s+/u).map((s) => [s, countWords(s)]).filter(([, n]) => n > 25);
+				const long = unit.text.split(/(?<=[.!?])\s+/u).map((s) => [s, countWords(s)]).filter(([s, n]) => n > 25 && (s.match(/\b(?:and|but)\b/giu)?.length ?? 0) >= 2);
 				if (long.length === 0) return none;
 				const [sentence, n] = long[0];
 				return hit(`${n} words: "${sentence.slice(0, 80)}${sentence.length > 80 ? "..." : ""}"`);
@@ -3994,18 +4117,19 @@ const CODE_RULES = [
 				notInCode: true
 			},
 			source: {
-				line: 7,
-				path: "skills/docs-writing/rules/clarity-one-idea-per-sentence.md",
+				line: 17,
+				path: "skills/ghostwriter/references/docs.md",
 				repo: "mblode/agent-skills"
 			},
-			title: "Sentence over 25 words",
+			title: "Sentence over 25 words joins several clauses",
 			unit: ["paragraph", "jsx-text"]
 		})
 	],
 	...CLASS_RULES,
 	...DOCUMENT_RULES,
 	...IMAGE_RULES,
-	...SKILL_CLASS_RULES
+	...SKILL_CLASS_RULES,
+	...MOTION_SOURCE_RULES
 ];
 //#endregion
 //#region src/rules/load.ts
@@ -4068,10 +4192,8 @@ const readTuning = (rulesDir) => {
 	}
 	return out;
 };
-const loadRules = (rulesDir, options = {}) => {
-	const tuning = readTuning(rulesDir);
+const readYamlRules = (rulesDir) => {
 	const rules = [];
-	const seen = /* @__PURE__ */ new Set();
 	const domains = fs.readdirSync(rulesDir, { withFileTypes: true }).filter((d) => d.isDirectory() && d.name !== "schema").map((d) => d.name).toSorted();
 	for (const domain of domains) {
 		const dir = path.join(rulesDir, domain);
@@ -4079,24 +4201,49 @@ const loadRules = (rulesDir, options = {}) => {
 			if (!name.endsWith(".yaml")) continue;
 			const file = path.join(dir, name);
 			const expectedId = name.slice(0, -5);
-			let raw;
 			try {
-				raw = parse(fs.readFileSync(file, "utf-8"));
+				let raw;
+				try {
+					raw = parse(fs.readFileSync(file, "utf-8"));
+				} catch (error) {
+					throw new Error(`Invalid rule ${file}: YAML did not parse (${error.message})`, { cause: error });
+				}
+				const rule = validateRule(raw, file, expectedId);
+				if (rule.domain !== domain) throw new Error(`Invalid rule ${file}: domain ${rule.domain} does not match folder ${domain}`);
+				rules.push(rule);
 			} catch (error) {
-				throw new Error(`Invalid rule ${file}: YAML did not parse (${error.message})`, { cause: error });
+				const invalid = new InputError("INVALID_RULE", error.message, { file });
+				invalid.cause = error;
+				throw invalid;
 			}
-			const rule = validateRule(raw, file, expectedId);
-			if (rule.domain !== domain) throw new Error(`Invalid rule ${file}: domain ${rule.domain} does not match folder ${domain}`);
-			rules.push(rule);
 		}
 	}
+	return rules;
+};
+const loadRules = (rulesDir, options = {}) => {
+	const tuning = readTuning(rulesDir);
+	const rules = [];
+	const seen = /* @__PURE__ */ new Map();
+	rules.push(...readYamlRules(rulesDir));
+	for (const dir of options.extraDirs ?? []) {
+		const extra = readYamlRules(dir);
+		if (extra.length === 0) throw new InputError("INVALID_CONFIG", `rules entry ${dir} holds no rules; put YAML rule files in a domain folder such as ${path.join(dir, "copywriting")}/`, {
+			field: "rules",
+			path: dir
+		});
+		rules.push(...extra);
+	}
 	for (const code of CODE_RULES) rules.push({
 		...code,
 		thresholds: { ...code.thresholds }
 	});
 	for (const rule of rules) {
-		if (seen.has(rule.id)) throw new Error(`Duplicate rule id ${rule.id}`);
-		seen.add(rule.id);
+		const first = seen.get(rule.id);
+		if (first !== void 0) throw new InputError("DUPLICATE_RULE", `Rule id ${rule.id} is defined in ${first} and ${rule.file}; rename one.`, {
+			files: [first, rule.file],
+			id: rule.id
+		});
+		seen.set(rule.id, rule.file);
 		const overlay = tuning[rule.id];
 		if (isCandidateRule(rule) && (rule.status === "active" || overlay?.status === "active")) throw new Error(`Candidate-only rule ${rule.id} cannot be active; add an evidence-based check before promotion.`);
 		if (overlay) {
@@ -4272,7 +4419,10 @@ const runLint = async (options = {}, ctx = {}) => {
 	const config = loadConfig(options.root ?? process.cwd());
 	const rulesDir = resolveRulesDir(options.rulesDir);
 	const profile = options.profile ? profileFor(options.profile) : void 0;
-	const loaded = loadRules(rulesDir, { only: options.only });
+	const loaded = loadRules(rulesDir, {
+		extraDirs: config.rules,
+		only: options.only
+	});
 	const rules = profile && !options.only?.length ? profileRules(profile, loaded) : loaded;
 	if (rules.length === 0) throw new InputError("EMPTY_RULE_SELECTION", "No rules match the selected profile and ids.");
 	const model = options.model ?? "jev-latest";