@shivaedev/quality 0.2.0 → 0.3.1

package/CHANGELOG.md

@@ -1,5 +1,119 @@
 # Changelog
 
+## 0.3.1 - 2026-10-03
+
+### Changed
+
+- `quality baseline check` fetches the full history with `git fetch --unshallow`
+  when a shallow clone does not reach the merge base, and looks for it again
+  before it exits 2. The fetch never stops to ask for a
+  password.
+
+## 0.3.0 - 2026-10-03
+
+### Added
+
+- Add comment rules, each an error by default: `comments/no-jsdoc` (with an
+  `allow` list of tool pragmas such as `@vitest-environment`),
+  `comments/no-line-reference`, `comments/no-pr-reference`, `comments/no-banner`,
+  `comments/no-todo` and `comments/max-per-file` (2 comments per file by
+  default; a block comment or a run of adjacent line comments counts once, and
+  pragmas and directives are not counted). They find comments with the
+  TypeScript parser, so strings, template literals, regular expressions and JSX
+  text never count.
+
+- Add suppression rules, each an error by default:
+  `suppressions/no-inline` reports every comment directive that silences a
+  linter, the compiler or a formatter (`biome-ignore…`, `@ts-ignore`,
+  `@ts-expect-error`, `@ts-nocheck`, `eslint-disable…`, `prettier-ignore` and
+  their equivalents for Oxlint, Stylelint, Deno, TSLint and Flow), in
+  TypeScript and JavaScript modules and in CSS, SCSS and Less files, except
+  `@ts-expect-error` in type-test files the config declares with a reason;
+  `suppressions/no-double-cast` reports casts through `unknown`, `any` or
+  `never`; `suppressions/biome-overrides` reports a Biome setting that turns a
+  lint rule, group, domain, assist action, the linter, the assist or the
+  formatter off or down, per language too, or keeps files out of a check
+  through an `includes` list, unless the quality config declares it with its
+  rule, its `includes` and a reason. Both rules report a declaration that
+  matches nothing. Coverage hints stay allowed.
+
+- Add `quality baseline check [--against <ref>]`, which compares the baseline
+  with its version at the merge base of `HEAD` and the target branch
+  (`origin/HEAD`, `origin/main` or `origin/master` by default) and fails when it
+  gained an entry, a higher `count`, or a rule baselined for the first time. Comparing with the merge base means a branch that is behind never
+  fails. An entry whose file git sees as moved is compared with its old path. It
+  exits 2 without a git work tree, a target or a merge base, and says to fetch
+  more history in a shallow clone.
+
+- Add the `adopt` config key: a rule enters the baseline for the first time only
+  while `adopt` names it, so the adoption shows in the config's diff. The check
+  fails when `adopt` names a rule with nothing baselined.
+
+- Add `quality baseline tighten [--staged]`, which lowers and removes the
+  entries of the files changed since `HEAD`, or staged for the next commit, and
+  leaves every other line as it is. Run it in a pre-commit hook and stage the
+  baseline again.
+
+- Add `quality baseline migrate [--from <file>]`, which moves a baseline from
+  the earlier JSON format to the configured file. An old entry that stored a
+  size becomes that size less the rule's current limit, and an entry whose file
+  is now within the limit is dropped.
+
+- `quality baseline prune` and `tighten` carry the entry of a file that git
+  sees as moved to its new path, at the lower of its old count and what the
+  file has now.
+
+- Add `registrable: false` to `defineRule`, for a rule the registry must never
+  excuse. The suppression rules set it, so a registry entry that names one fails
+  the gate as stale; existing suppressions are adopted through the baseline.
+
+### Changed
+
+- **Breaking:** The baseline is a JSON Lines file, `quality/baseline.jsonl` by
+  default, with one entry per line (`{"path":…,"rule":…,"count":…}`) sorted by
+  path and then rule. `count` is the number of violations; for a rule with a
+  limit, such as `structure/max-lines` or `comments/max-per-file`, it is the
+  amount over the limit, so changing a limit shifts every count of the rule. A
+  repository with a `quality/baseline.json` fails to run until it runs
+  `quality baseline migrate`.
+
+- **Breaking:** A finding reports `count` (the violations it stands for, 1 by
+  default) and `threshold` (the limit it applied) instead of `measure`. A local
+  rule that set `measure` reports the amount over its limit as `count`.
+
+- `quality baseline write --rule <id>` records a rule that the baseline already
+  covers again, replacing its entries, for example after a limit change.
+  `quality baseline check` fails on any entry this raises.
+
+- `quality lint` passes a baseline entry that allows more than is left,
+  including a file with no violations left, and lists it as a note. An entry for
+  a rule that is off or unknown still fails.
+
+- `quality baseline write --rule` and `prune` rewrite only the lines they add,
+  lower or remove, and never re-sort or reformat the rest.
+
+- **Breaking:** The comment rules are on by default, so upgrading fails a
+  repository with existing comment violations until it fixes them or adopts the
+  rules with `quality baseline write --rule <id>`.
+
+- **Breaking:** The suppression rules are on by default, so upgrading fails a
+  repository with inline suppressions, double casts or undeclared Biome
+  overrides until it fixes them, declares its Biome overrides, or adopts the
+  rules with `quality baseline write --rule <id>`.
+
+- Comment rules also skip the Oxlint, Stylelint, Deno, TSLint and Flow
+  directives, like the other compiler and linter directives.
+
+- Depend on `typescript`, resolved to the TypeScript 6 compiler API, to find
+  comments.
+
+- Remove the JSDoc from the package's own source; the README documents the
+  config, rule and finding fields.
+
+- Consolidate duplicate test cases around observable package behavior.
+
+- Validate packed consumers and executable bins through the shared workspace gate.
+
 ## 0.2.0 - 2026-09-28
 
 ### Changed

package/README.md

@@ -2,7 +2,7 @@
 
 One quality gate for a repository: typed rules, one report, a baseline that only shrinks and a registry of permanent exceptions, each with its reason.
 
-Every rule is an error by default. A repository adopts the gate at once: it records its existing violations in the baseline, and from then on a baselined file may not get worse, and fixed debt must leave the baseline.
+Every rule is an error by default. A repository adopts the gate at once: it records its existing violations in the baseline, and from then on a baselined file may not get worse, the baseline may not gain an entry or a higher number, and fixed debt leaves it as files change.
 
 ## Setup
 
@@ -22,15 +22,16 @@ Node 24 or later loads `quality.config.ts` directly (type stripping), so no buil
 ```ts
 // quality.config.ts
 import { defineConfig } from "@shivaedev/quality";
-import { noTodo } from "./quality/no-todo.ts";
+import { noConsoleLog } from "./quality/no-console-log.ts";
 
 export default defineConfig({
 	sources: ["src", "scripts"],
 	exclude: ["src/components/ui/", "*.gen.ts"],
-	local: [noTodo],
+	local: [noConsoleLog],
 	rules: {
 		"structure/max-lines": { options: { source: 200, testFiles: ["e2e/"] } },
-		"local/no-todo": "warn",
+		"comments/max-per-file": { options: { max: 3 } },
+		"local/no-console-log": "warn",
 	},
 });
 ```
@@ -41,7 +42,8 @@ export default defineConfig({
 | `exclude` | `[]` | Paths never checked, in `.gitignore` syntax. Files ignored by git, `.git` and `node_modules` are always skipped. |
 | `extensions` | TypeScript and JavaScript modules | Which files rules read as sources. |
 | `registry` | `quality/registry.json` | Permanent exceptions. |
-| `baseline` | `quality/baseline.json` | Existing violations that may only shrink. |
+| `baseline` | `quality/baseline.jsonl` | Existing violations that may only shrink. |
+| `adopt` | `[]` | Rules the baseline takes in for the first time; see [Adopting a rule](#adopting-a-rule). |
 | `local` | `[]` | The repository's own rules, made with `defineRule`. |
 | `rules` | every rule at `error` | A level per rule id, or `{ level, options }`. |
 
@@ -55,51 +57,218 @@ The config is typed: an unknown rule id, a misspelled option or an option of the
 
 ## Rules
 
-`structure/max-lines` keeps each module to one job: a source file may have 150 lines and a test file 300, counted the way an editor numbers them. Declaration files are exempt. Its options are `source` and `test` (the limits) and `testFiles`, `.gitignore` patterns that mark test files (`*.test.*`, `*.spec.*`, `test/`, `tests/` and `__tests__/` by default). A violation's measure is the file's line count, so a baselined file may shrink but never grow.
+`structure/max-lines` keeps each module to one job: a source file may have 150 lines and a test file 300, counted the way an editor numbers them. Declaration files are exempt. Its options are `source` and `test` (the limits) and `testFiles`, `.gitignore` patterns that mark test files (`*.test.*`, `*.spec.*`, `test/`, `tests/` and `__tests__/` by default). A file over its limit counts one violation for each line above it: 168 lines under a limit of 150 count 18.
+
+### Comments
+
+A comment says why, never what the code already says or what it used to be. Six rules hold every comment to that:
+
+| Rule | Reports | Options |
+| --- | --- | --- |
+| `comments/no-jsdoc` | Every `/** */` block, except a tool pragma | `allow` |
+| `comments/no-line-reference` | A line number: `file.ts:42`, `file.ts#L42`, `line 42` | none |
+| `comments/no-pr-reference` | A pull request or issue: `#123`, `PR 123`, `MR 123`, `pull request 123`, `merge request 123`, `issue 123`, `ticket 123`, `/pull/123`, `/pulls/123`, `/issues/123`, `/merge_requests/123`, `GH-123` | none |
+| `comments/no-banner` | A banner, divider or region: a line that starts or ends with three or more of `- = * # ~ _ + / \ ─ ━ ═ ┄ ┈`, `#region`, `#endregion` | none |
+| `comments/no-todo` | `TODO`, `FIXME`, `XXX` and `@todo` | none |
+| `comments/max-per-file` | A file with more than `max` comments, 2 by default | `max`, `allow` |
+
+The rules find comments with the TypeScript parser, so text inside strings, template literals, regular expressions and JSX never counts as a comment. They read the TypeScript and JavaScript modules among the sources and skip declaration files and the directives listed below. Each finding names the line its comment starts on.
+
+`comments/max-per-file` counts comments this way:
+
+- A block comment counts once, however many lines it spans.
+- Line comments that each stand alone on adjacent lines form one run and count once. A blank line, code, a directive, or a comment after code on the same line starts a new one.
+- Tool pragmas and directives are not counted: compiler and linter directives (`@ts-…`, triple-slash directives such as `/// <reference …>`, `biome-ignore…`, `eslint-disable…`, `eslint-enable…`, `oxlint-…`, `stylelint-…`, `deno-lint-ignore…`, `tslint:disable…`, `prettier-ignore`, Flow's `$FlowFixMe`, `$FlowIgnore`, `$FlowExpectedError`, `$FlowIssue` and `@noflow`), bundler annotations (`#__PURE__`, `@__PURE__`, `#__NO_SIDE_EFFECTS__`, `@__NO_SIDE_EFFECTS__`) and coverage hints (`c8 ignore`, `v8 ignore`, `istanbul ignore`). The suppression rules below report the directives that silence a check.
+
+A file over the limit counts one violation for each comment above it: 5 comments against a limit of 2 count 3. A finding names the first comment over the limit.
+
+A tool pragma is a comment whose every line starts with an allowed tag, such as `/** @vitest-environment happy-dom */`. `allow` lists the tags and defaults to `@vitest-environment`, `@vitest-environment-options`, `@jest-environment`, `@jsx`, `@jsxFrag`, `@jsxImportSource` and `@jsxRuntime`. A list given replaces the default, and `comments/no-jsdoc` and `comments/max-per-file` each take their own, so give both the same list:
+
+```ts
+const pragmas = ["@vitest-environment", "@license"];
+
+export default defineConfig({
+	rules: {
+		"comments/no-jsdoc": { options: { allow: pragmas } },
+		"comments/max-per-file": { options: { allow: pragmas } },
+	},
+});
+```
+
+A repository with existing comments adopts the rules through the baseline, for example `quality baseline write --rule comments/no-jsdoc --rule comments/max-per-file`.
+
+### Suppressions
+
+A check that is silenced at one site hides the problem instead of fixing it. Three rules close the escape hatches, and none of them takes registry exceptions: a registry entry that names one fails the gate as stale. A repository with existing suppressions adopts the rules through the baseline, which only shrinks.
+
+| Rule | Reports | Options |
+| --- | --- | --- |
+| `suppressions/no-inline` | Every comment directive that silences a linter, the compiler or a formatter, except a declared `@ts-expect-error` | `declared` |
+| `suppressions/no-double-cast` | A cast through `unknown`, `any` or `never`: `x as unknown as T`, `x as any as T`, `x as never as T`, `<T><unknown>x` | none |
+| `suppressions/biome-overrides` | A Biome setting that turns a check off or down, or keeps files out of it, without a declaration, and a declaration that matches no setting | `declared` |
+
+`suppressions/no-inline` reports these directives, wherever a line of a comment starts with one:
+
+- Biome: `biome-ignore`, `biome-ignore-all` and `biome-ignore-start`, for lint, assist and format alike. The `biome-ignore-end` that closes a range is not reported again.
+- TypeScript: `@ts-ignore`, `@ts-expect-error` and `@ts-nocheck`. `@ts-check` turns checking on and is allowed.
+- Other linters: `eslint-disable`, `eslint-disable-line`, `eslint-disable-next-line` and inline rule settings such as `/* eslint no-console: "off" */`; the same `-disable` forms of `oxlint` and `stylelint`; `deno-lint-ignore` and `deno-lint-ignore-file`; `tslint:disable…`.
+- Formatters: `prettier-ignore`, since `prettier --check` fails on the code it skips.
+- Flow: `$FlowFixMe`, `$FlowIgnore`, `$FlowExpectedError`, `$FlowIssue` and `@noflow`.
+
+Coverage hints (`c8 ignore`, `v8 ignore`, `istanbul ignore`) are allowed: they leave code out of a coverage measure and silence no linter or compiler. The rule reads the TypeScript and JavaScript modules among the sources, declaration files included, and every `.css`, `.scss` and `.less` file among the checked files, whatever `extensions` says. Each finding names the line its comment starts on and has the directive as its subject.
+
+#### Declared type tests
+
+A type test proves that an API rejects what its types forbid, and TypeScript asserts a compile error only through `@ts-expect-error`, which fails as soon as the error it expects goes away. So `@ts-expect-error`, and no other directive, may be declared for a set of files:
+
+```ts
+export default defineConfig({
+	rules: {
+		"suppressions/no-inline": {
+			options: {
+				declared: [
+					{
+						directive: "@ts-expect-error",
+						includes: ["*.typecheck.ts"],
+						reason: "Type tests assert the compile errors the public types must raise.",
+					},
+				],
+			},
+		},
+	},
+});
+```
+
+`includes` takes `.gitignore` patterns, like `exclude`. `@ts-ignore`, `@ts-nocheck` and every linter and formatter directive stay reported in those files. A declaration that matches no `@ts-expect-error` is reported against `quality.config.ts` until it is removed. A test that must pass a rejected value at run time, to prove the runtime refuses it too, calls the API through `Reflect.apply` instead of a directive.
+
+`suppressions/no-double-cast` finds casts with the TypeScript parser, through parentheses and in either assertion syntax. A single cast is left to the linter, and `as const` is not a cast.
+
+#### Declared Biome overrides
+
+A scope that truly cannot follow a lint rule keeps its exception in the Biome config, and the quality config declares it with a reason. `suppressions/biome-overrides` reads `biome.json` or `biome.jsonc` at the root, every nested `biome.json` and `biome.jsonc` among the checked files, and the local files a config `extends` (an entry that starts with `.`). These settings count as overrides, at the top level and in every `overrides` entry:
+
+| Setting | Declared as |
+| --- | --- |
+| A lint rule at `off`, `warn` or `info`, as a string or a `level` | `lint/<group>/<rule>` |
+| A lint group at `off`, `warn` or `info`, or with `recommended: false` or `preset: "none"` | `lint/<group>` |
+| `linter.rules` with `recommended: false` or `preset: "none"` | `lint/recommended` |
+| A domain at `none` | `lint/domains/<domain>` |
+| `linter.enabled: false` | `lint` |
+| An assist action at `off`, such as `useSortedKeys` or `organizeImports` | `assist/<group>/<action>` |
+| `assist.actions` with `recommended: false` or `preset: "none"` | `assist/recommended` |
+| `assist.enabled: false` | `assist` |
+| `formatter.enabled: false` | `format` |
+| `enabled: false` in a language's `linter`, `assist` or `formatter`, such as `css.linter` | `<language>/lint`, `<language>/assist`, `<language>/format` |
+| An `includes` list in `files`, `linter`, `assist` or `formatter` that excludes a pattern with `!` or lacks `**` | `files/includes`, `lint/includes`, `assist/includes`, `format/includes` |
+
+Biome runs assist actions, key sorting among them, as part of `biome check` and reports what they would change, so turning one off is an override. Formatter options such as `indentStyle` or `lineWidth` choose a style, not an exception, and are not overrides. Settings that raise a rule or enable it are not overrides either. Rule options are not read, so an option that loosens a rule, such as a higher complexity limit, is left to review.
+
+```ts
+export default defineConfig({
+	rules: {
+		"suppressions/biome-overrides": {
+			options: {
+				declared: [
+					{
+						rule: "lint/style/noDefaultExport",
+						includes: ["*.config.ts"],
+						reason: "Tools load their config files through the default export.",
+					},
+					{
+						rule: "lint/suspicious/noConsole",
+						includes: ["scripts/**"],
+						reason: "Scripts report to the terminal they run in.",
+					},
+				],
+			},
+		},
+	},
+});
+```
+
+A declaration covers a setting when its `rule` and its `includes` match the setting's exactly, in any order. An `includes` list that keeps files out is declared as the whole list, so every pattern added to it needs the declaration to change too. A setting at the top level of the root config has the scope `["**"]`, and an `overrides` entry has its own `includes` (`["**"]` when it has none). Patterns in a nested config are relative to its folder, so they are declared with the folder in front: `"src/**"` in `packages/web/biome.json` is declared as `"packages/web/src/**"`, and its top level as `"packages/web/**"`. A setting without a declaration is reported at its line in the Biome config; a declaration that no setting matches is reported against the root config, so the list cannot outlive the overrides it explains.
 
 ### Local rules
 
 ```ts
 import { defineRule } from "@shivaedev/quality";
 
-export const noTodo = defineRule({
-	id: "local/no-todo",
-	description: "Resolve TODOs before merging.",
+export const noConsoleLog = defineRule({
+	id: "local/no-console-log",
+	description: "Log through the application logger.",
 	check: ({ sources }) =>
 		sources.flatMap((file) =>
-			file.lines.flatMap((text, index) => (text.includes("TODO") ? [{ file: file.path, line: index + 1, message: "Resolve this TODO." }] : [])),
+			file.lines.flatMap((text, index) =>
+				text.includes("console.log(") ? [{ file: file.path, line: index + 1, message: "Logs to the console." }] : [],
+			),
 		),
 });
 ```
 
-`check` receives the repository `root`, every checked path in `files`, the `sources` with their `text` and `lines`, `readText(path)` for any other file (undefined when absent) and the validated `options`. It returns findings, or a promise of them. A finding names its `file`, relative to the root (an absolute path under it is made relative), and its `message`, and optionally a `line`, a `subject` that tells apart exceptions of one rule in one file, and a `measure` where larger is worse.
+A rule that must never be excused, like the suppression rules, sets `registrable: false`; the registry then refuses entries for it.
+
+`check` receives the repository `root`, every checked path in `files`, the `sources` with their `text` and `lines`, `readText(path)` for any other file (undefined when absent) and the validated `options`. It returns findings, or a promise of them. A finding names its `file`, relative to the root (an absolute path under it is made relative), and its `message`, and optionally a `line`, a `subject` that tells apart exceptions of one rule in one file, a `count` of the violations it stands for (1 by default) and the `threshold` it applied. A rule with a limit reports one finding per file, with the amount over the limit as its `count` and the limit as its `threshold`.
 
 A rule with options declares them with any [Standard Schema](https://standardschema.dev), such as `Schema.toStandardSchemaV1(...)` from Effect. Options are an object: when the config gives none, the schema validates `{}`, so give each option a default or make it optional. A rule without an options schema refuses options.
 
 ## Baseline
 
-```json
-{
-	"structure/max-lines": {
-		"src/server/db.ts": {
-			"count": 1,
-			"measure": 412
-		}
-	},
-	"local/no-todo": {
-		"src/legacy/sync.ts": {
-			"count": 3
-		}
-	}
-}
+```jsonl
+{"path":"src/legacy/sync.ts","rule":"comments/no-jsdoc","count":3}
+{"path":"src/server/db.ts","rule":"structure/max-lines","count":262}
+```
+
+The baseline is a JSON Lines file with one entry per line: the violations of one rule in one file. `count` is how many violations the file may have. For a rule that counts occurrences, such as `comments/no-jsdoc`, that is the number of occurrences. For a rule with a limit, it is the amount over the limit: the entry above lets `src/server/db.ts` have 412 lines under a limit of 150. Entries are sorted by path and then rule, and each tool that changes the file rewrites only the lines it changes, so a diff names exactly the entries that moved and two branches conflict only when they touch the same or neighbouring entries.
+
+`quality lint` fails when a baselined file has more violations than its `count`; the report then lists all of that file's violations for the rule. A file at or below its entry passes. An entry that allows more than is left, including a file with no violations left, is listed as a note and does not fail, so fixing debt never breaks the build; `tighten` and `prune` lower it. An entry for a rule that is off or unknown fails until it is pruned. The baseline covers violations at any level.
+
+- `quality baseline write` records every error-level violation when there is no baseline yet. Once a baseline exists it refuses, unless `--rule <id>` names the rules to record: it then replaces the entries of those rules with what the files have now, and leaves every other entry as it is.
+- `quality baseline tighten` lowers and removes the entries of files changed since `HEAD`, and with `--staged`, of the files staged for the next commit. It carries the entry of a file that git sees as moved to the new path. Every other line stays byte for byte.
+- `quality baseline prune` does the same for every entry. It carries the entries of files moved since the merge base (see `--against` under [Command line](#command-line)), and prunes without following moves outside a git work tree.
+- `quality baseline migrate` moves a baseline from the earlier JSON format, `quality/baseline.json` or the file `--from` names, to the configured file, and removes the old one. An old entry that stored a size, such as a line count, becomes that size less the rule's current limit; an entry whose file is now within the limit is dropped.
+
+Neither `tighten` nor `prune` ever adds or raises an entry. They lower an entry to what its file has now, and remove it when that is 0. A moved file's entry keeps the lower of its old count and what the file has now. A move is seen when both of its sides are tracked, as after `git mv`; git's rename detection decides what counts as a move.
+
+### Pre-commit
+
+Lowering entries in the commit that fixes them keeps the baseline current without a separate cleanup:
+
+```sh
+quality baseline tighten --staged && git add quality/baseline.jsonl
+quality lint
+quality baseline check
+```
+
+`tighten` counts the files as they are on disk. When a commit stages only part of a file, stash the rest first (as lint-staged does), or the entry may be lowered below what the commit holds.
+
+### Baseline check
+
+`quality lint` reads only the working tree, so on its own it cannot tell a raised entry from a recorded one: a hand edit, or deleting the baseline and writing it again, would hide new debt. `quality baseline check` compares the baseline with its version at the merge base of `HEAD` and the target branch, and fails when:
+
+- an entry is new, for a rule the base baseline already covers;
+- an entry's `count` is higher than at the base;
+- a rule is baselined for the first time without `adopt` naming it;
+- `adopt` names a rule with nothing baselined.
+
+It compares with the merge base, never the tip of the target branch, so a branch that is behind never fails for debt the target branch paid off since. An entry whose file git sees as moved since the merge base is compared with the entry at the old path. When the base holds the earlier JSON format at `quality/baseline.json`, the check converts it the way `migrate` does, so the change that migrates the baseline passes.
+
+The check reads git, not the sources, so it is cheap enough for every commit; only a base in the earlier format makes it run the rules. The target is `--against <ref>`, or else `origin/HEAD`, `origin/main` and then `origin/master`, whichever exists first. In a shallow clone that does not reach the merge base, it runs `git fetch --unshallow`, which never stops to ask for a password, and looks again. It exits 2 when there is no git work tree, no target or no merge base, including when that fetch fails; then check out with `fetch-depth: 0` in GitHub Actions, or fetch enough history for `git merge-base HEAD <target>` to succeed.
+
+### Adopting a rule
+
+A rule enters the baseline for the first time only while the config names it under `adopt`, so the adoption shows in the config's diff, not only in the baseline's:
+
+```ts
+export default defineConfig({
+	adopt: ["comments/no-jsdoc"],
+});
 ```
 
-Each entry covers the violations of one rule in one file. The gate fails when a baselined file has more violations than its `count`, or a larger measure than its `measure`; the report then lists all of that file's violations for the rule. It also fails when an entry allows more than is left, including a file with no violations left and a rule that is off or unknown. The baseline covers violations at any level.
+Run `quality baseline write --rule comments/no-jsdoc` with the rule at `error`, and commit both. `adopt` lets in only rules that the base baseline does not cover: once the adoption is merged, the rule's entries only shrink like any other. Leave the rule in `adopt` while it has debt; when its last entry is gone, the check fails until it is removed, so `adopt` cannot let the rule back in later. The first baseline of a repository adopts each of its rules the same way.
 
-- `quality baseline write` records every error-level violation when there is no baseline yet. Once a baseline exists it refuses, unless `--rule <id>` names rules the baseline does not cover yet: that is how a rule is adopted later. It never raises an entry.
-- `quality baseline prune` drops fixed debt and lowers entries to what is left. It never adds or raises an entry.
+### Changing a limit
 
-The file keeps the indentation it has, and its rules and files are sorted, so its diffs stay small.
+A count depends on the configured limit, so changing a limit shifts every count of the rule. A looser limit leaves entries that allow more than is left: they pass, and `tighten` and `prune` lower them. A stricter limit makes the rule's files fail `quality lint`, since each is now further over the limit. Run `quality baseline write --rule <id>` to record the rule again under the new limit, and commit it with the config change. `quality baseline check` then fails on the raised entries, as it does for any growth; the change merges only when an owner of the repository merges it over the failed check on purpose.
 
 ## Registry
 
@@ -113,24 +282,27 @@ The file keeps the indentation it has, and its rules and files are sorted, so it
 ]
 ```
 
-An entry covers a rule's violations in one file, for good, and must say why. With a `subject`, it covers only the violations with that subject. The registry applies before the baseline. An entry that covers nothing, or names a rule that is off or unknown, fails the gate until it is removed.
+An entry covers a rule's violations in one file, for good, and must say why. With a `subject`, it covers only the violations with that subject. The registry applies before the baseline. An entry that covers nothing, or names a rule that is off, unknown or takes no exceptions, fails the gate until it is removed.
 
 ## Command line
 
 ```text
 quality lint [--config <file>] [--warnings summary|all]
 quality baseline write [--config <file>] [--rule <id>]...
-quality baseline prune [--config <file>]
+quality baseline prune [--config <file>] [--against <ref>]
+quality baseline tighten [--config <file>] [--staged]
+quality baseline check [--config <file>] [--against <ref>]
+quality baseline migrate [--config <file>] [--from <file>]
 ```
 
-`quality` alone runs `lint`. The report groups violations by rule and states each rule's description once; warnings are summarized per rule with the files that have the most, and `--warnings all` lists each one.
+`quality` alone runs `lint`. `--against <ref>` names the branch the work merges into. The report groups violations by rule and states each rule's description once; warnings are summarized per rule with the files that have the most, and `--warnings all` lists each one.
 
 | Exit code | Meaning |
 | --- | --- |
 | 0 | Passed. Warnings may remain. |
-| 1 | Failed: an uncovered error-level violation, a baselined file that got worse, or a stale baseline or registry entry. |
-| 2 | Could not run: no or invalid config, an invalid baseline or registry, a missing source, a rule that threw, or a usage error. |
+| 1 | Failed: an uncovered error-level violation, a baselined file that got worse, a stale registry entry, a baseline entry for a rule that is off or unknown, or a baseline that grew against the merge base. |
+| 2 | Could not run: no or invalid config, an invalid baseline or registry, a baseline left in the earlier format, a missing source, a rule that threw, git history the check cannot read, or a usage error. |
 
 ## Validation
 
-`pnpm ready` checks formatting, both TypeScript compilers, the rule, config, discovery, registry, baseline and report behavior, the command line against seeded repositories, and an installed tarball consumer that type-checks a config and runs the `quality` bin through a baseline cycle.
+`pnpm ready` checks formatting, both TypeScript compilers, the rules, config, discovery, registry, baseline and report behavior, the command line against seeded repositories and git histories, and an installed tarball consumer that type-checks a config and runs the `quality` bin through a baseline cycle.

package/dist/baseline/compare.d.ts

@@ -1,13 +1,9 @@
 import type { Level } from "../config.ts";
 import { type Violation } from "../engine/violation.ts";
 import type { BaselineEntry } from "./format.ts";
-export interface Tally {
-    readonly count: number;
-    readonly measure: number | undefined;
-}
 export interface Regression {
     readonly entry: BaselineEntry;
-    readonly tally: Tally;
+    readonly count: number;
 }
 export interface StaleBaselineEntry {
     readonly entry: BaselineEntry;
@@ -17,10 +13,9 @@ export interface BaselineCheck {
     readonly kept: ReadonlyArray<Violation>;
     readonly regressions: ReadonlyArray<Regression>;
     readonly stale: ReadonlyArray<StaleBaselineEntry>;
+    readonly loose: ReadonlyArray<StaleBaselineEntry>;
     readonly baselined: number;
 }
-export declare const tallyOf: (violations: ReadonlyArray<Violation>) => Tally;
-export declare const describeTally: (tally: Tally) => string;
-export declare const describeEntry: (entry: BaselineEntry) => string;
+export declare const countOf: (violations: ReadonlyArray<Violation>) => number;
 export declare const applyBaseline: (violations: ReadonlyArray<Violation>, entries: ReadonlyArray<BaselineEntry>, levels: ReadonlyMap<string, Level>) => BaselineCheck;
 //# sourceMappingURL=compare.d.ts.map

package/dist/baseline/compare.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"compare.d.ts","sourceRoot":"","sources":["../../src/baseline/compare.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAsC,KAAK,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAC5F,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,MAAM,WAAW,KAAK;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;CACrC;AAED,MAAM,WAAW,UAAU;IAC1B,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;CACtB;AAED,MAAM,WAAW,kBAAkB;IAClC,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,aAAa;IAC7B,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC;IACxC,QAAQ,CAAC,WAAW,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC;IAChD,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,kBAAkB,CAAC,CAAC;IAClD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC3B;AAOD,eAAO,MAAM,OAAO,GAAI,YAAY,aAAa,CAAC,SAAS,CAAC,KAAG,KAG9D,CAAC;AAaF,eAAO,MAAM,aAAa,GAAI,OAAO,KAAK,KAAG,MACgF,CAAC;AAE9H,eAAO,MAAM,aAAa,GAAI,OAAO,aAAa,KAAG,MAAuE,CAAC;AAE7H,eAAO,MAAM,aAAa,GACzB,YAAY,aAAa,CAAC,SAAS,CAAC,EACpC,SAAS,aAAa,CAAC,aAAa,CAAC,EACrC,QAAQ,WAAW,CAAC,MAAM,EAAE,KAAK,CAAC,KAChC,aAwBF,CAAC"}
+{"version":3,"file":"compare.d.ts","sourceRoot":"","sources":["../../src/baseline/compare.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAsC,KAAK,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAC5F,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,MAAM,WAAW,UAAU;IAC1B,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,kBAAkB;IAClC,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,aAAa;IAC7B,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC;IACxC,QAAQ,CAAC,WAAW,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC;IAChD,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,kBAAkB,CAAC,CAAC;IAClD,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,kBAAkB,CAAC,CAAC;IAClD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC3B;AAED,eAAO,MAAM,OAAO,GAAI,YAAY,aAAa,CAAC,SAAS,CAAC,KAAG,MAAoF,CAAC;AAEpJ,eAAO,MAAM,aAAa,GACzB,YAAY,aAAa,CAAC,SAAS,CAAC,EACpC,SAAS,aAAa,CAAC,aAAa,CAAC,EACrC,QAAQ,WAAW,CAAC,MAAM,EAAE,KAAK,CAAC,KAChC,aA4BF,CAAC"}

package/dist/baseline/compare.js

@@ -1,42 +1,32 @@
 import { groupBy, keyOf, unusedEntryProblem } from "../engine/violation.js";
-const measures = (violations) => violations.flatMap((violation) => (violation.measure === undefined ? [] : [violation.measure]));
-export const tallyOf = (violations) => {
-    const found = measures(violations);
-    return { count: violations.length, measure: found.length === 0 ? undefined : Math.max(...found) };
-};
-const measureTrend = (entry, tally) => entry.measure === undefined || tally.measure === undefined ? 0 : Math.sign(tally.measure - entry.measure);
-const verdictOf = (entry, tally) => {
-    const trend = measureTrend(entry, tally);
-    if (tally.count > entry.count || trend > 0) {
-        return { _tag: "Regressed" };
-    }
-    return { _tag: "Covered", loose: tally.count < entry.count || trend < 0 };
-};
-export const describeTally = (tally) => `${tally.count} violation${tally.count === 1 ? "" : "s"}${tally.measure === undefined ? "" : ` measuring ${tally.measure}`}`;
-export const describeEntry = (entry) => describeTally({ count: entry.count, measure: entry.measure });
+export const countOf = (violations) => violations.reduce((total, violation) => total + (violation.count ?? 1), 0);
 export const applyBaseline = (violations, entries, levels) => {
     const groups = groupBy(violations, (violation) => keyOf(violation.rule, violation.file));
     const covered = new Set();
     const regressions = [];
     const stale = [];
+    const loose = [];
     for (const entry of entries) {
         const group = groups.get(keyOf(entry.rule, entry.file)) ?? [];
         if (group.length === 0) {
-            stale.push({ entry, problem: unusedEntryProblem(levels, entry.rule, "has no violations left") });
+            const level = levels.get(entry.rule);
+            (level === undefined || level === "off" ? stale : loose).push({
+                entry,
+                problem: unusedEntryProblem(levels, entry.rule, "has no violations left"),
+            });
             continue;
         }
-        const tally = tallyOf(group);
-        const verdict = verdictOf(entry, tally);
-        if (verdict._tag === "Regressed") {
-            regressions.push({ entry, tally });
+        const count = countOf(group);
+        if (count > entry.count) {
+            regressions.push({ count, entry });
             continue;
         }
         covered.add(keyOf(entry.rule, entry.file));
-        if (verdict.loose) {
-            stale.push({ entry, problem: `allows more than is left: ${describeTally(tally)} against ${describeEntry(entry)} baselined` });
+        if (count < entry.count) {
+            loose.push({ entry, problem: `allows more than is left: ${count} against ${entry.count} baselined` });
         }
     }
     const kept = violations.filter((violation) => !covered.has(keyOf(violation.rule, violation.file)));
-    return { baselined: violations.length - kept.length, kept, regressions, stale };
+    return { baselined: violations.length - kept.length, kept, loose, regressions, stale };
 };
 //# sourceMappingURL=compare.js.map

package/dist/baseline/compare.js.map

@@ -1 +1 @@
-{"version":3,"file":"compare.js","sourceRoot":"","sources":["../../src/baseline/compare.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"compare.js","sourceRoot":"","sources":["../../src/baseline/compare.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,kBAAkB,EAAkB,MAAM,wBAAwB,CAAC;AAqB5F,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,UAAoC,EAAU,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE,CAAC,KAAK,GAAG,CAAC,SAAS,CAAC,KAAK,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAEpJ,MAAM,CAAC,MAAM,aAAa,GAAG,CAC5B,UAAoC,EACpC,OAAqC,EACrC,MAAkC,EAClB,EAAE;IAClB,MAAM,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,SAAS,EAAE,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;IACzF,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAClC,MAAM,WAAW,GAAiB,EAAE,CAAC;IACrC,MAAM,KAAK,GAAyB,EAAE,CAAC;IACvC,MAAM,KAAK,GAAyB,EAAE,CAAC;IACvC,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;QAC9D,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxB,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YACrC,CAAC,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC;gBAC7D,KAAK;gBACL,OAAO,EAAE,kBAAkB,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,EAAE,wBAAwB,CAAC;aACzE,CAAC,CAAC;YACH,SAAS;QACV,CAAC;QACD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;QAC7B,IAAI,KAAK,GAAG,KAAK,CAAC,KAAK,EAAE,CAAC;YACzB,WAAW,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;YACnC,SAAS;QACV,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;QAC3C,IAAI,KAAK,GAAG,KAAK,CAAC,KAAK,EAAE,CAAC;YACzB,KAAK,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,6BAA6B,KAAK,YAAY,KAAK,CAAC,KAAK,YAAY,EAAE,CAAC,CAAC;QACvG,CAAC;IACF,CAAC;IACD,MAAM,IAAI,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACnG,OAAO,EAAE,SAAS,EAAE,UAAU,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC;AACxF,CAAC,CAAC"}

package/dist/baseline/format.d.ts

@@ -3,11 +3,13 @@ export interface BaselineEntry {
     readonly rule: string;
     readonly file: string;
     readonly count: number;
-    readonly measure?: number | undefined;
 }
-export declare const byRuleAndFile: (left: BaselineEntry, right: BaselineEntry) => number;
+export declare const byPathAndRule: (left: BaselineEntry, right: BaselineEntry) => number;
+export declare const linesOf: (raw: string | undefined) => ReadonlyArray<{
+    readonly line: number;
+    readonly text: string;
+}>;
 export declare const decodeBaseline: (raw: string | undefined) => Promise<Decoded<ReadonlyArray<BaselineEntry>>>;
-export declare const encodeBaseline: (entries: ReadonlyArray<BaselineEntry>, indent: string) => string;
-/** Keeps the indentation of the file being rewritten, so the repository formatter leaves it alone. */
-export declare const indentOf: (raw: string | undefined) => string;
+export declare const encodeEntry: (entry: BaselineEntry) => string;
+export declare const encodeBaseline: (entries: ReadonlyArray<BaselineEntry>) => string;
 //# sourceMappingURL=format.d.ts.map

package/dist/baseline/format.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../src/baseline/format.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,OAAO,EAAc,MAAM,eAAe,CAAC;AAWzD,MAAM,WAAW,aAAa;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACtC;AAMD,eAAO,MAAM,aAAa,GAAI,MAAM,aAAa,EAAE,OAAO,aAAa,KAAG,MACH,CAAC;AAExE,eAAO,MAAM,cAAc,GAAU,KAAK,MAAM,GAAG,SAAS,KAAG,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC,aAAa,CAAC,CAAC,CAY3G,CAAC;AAKF,eAAO,MAAM,cAAc,GAAI,SAAS,aAAa,CAAC,aAAa,CAAC,EAAE,QAAQ,MAAM,KAAG,MAMtF,CAAC;AAEF,sGAAsG;AACtG,eAAO,MAAM,QAAQ,GAAI,KAAK,MAAM,GAAG,SAAS,KAAG,MAAqD,CAAC"}
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../src/baseline/format.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,OAAO,EAAc,MAAM,eAAe,CAAC;AAWzD,MAAM,WAAW,aAAa;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACvB;AAID,eAAO,MAAM,aAAa,GAAI,MAAM,aAAa,EAAE,OAAO,aAAa,KAAG,MACH,CAAC;AAExE,eAAO,MAAM,OAAO,GAAI,KAAK,MAAM,GAAG,SAAS,KAAG,aAAa,CAAC;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAItE,CAAC;AAE3C,eAAO,MAAM,cAAc,GAAU,KAAK,MAAM,GAAG,SAAS,KAAG,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC,aAAa,CAAC,CAAC,CAkB3G,CAAC;AAEF,eAAO,MAAM,WAAW,GAAI,OAAO,aAAa,KAAG,MAAoF,CAAC;AAExI,eAAO,MAAM,cAAc,GAAI,SAAS,aAAa,CAAC,aAAa,CAAC,KAAG,MAI5D,CAAC"}