etymd 0.2.0 → 0.2.2

package/CHANGELOG.md

@@ -1,5 +1,52 @@
 # etymd
 
+## 0.2.2
+
+### Patch Changes
+
+- 80db483: Gate integrity: detect scripts regardless of how the package manager is invoked.
+
+  Script expansion guessed the script name positionally — the token straight after the
+  manager. That only holds for `npm run x`, `yarn x` and `pnpm x`. Every other live shape
+  expanded to nothing, so the tool was never detected and the gate read as absent:
+
+  | invocation                           | captured as the script name |
+  | ------------------------------------ | --------------------------- |
+  | `pnpm run typecheck`                 | `run`                       |
+  | `pnpm -s typecheck`                  | `-s`                        |
+  | `pnpm -r --if-present run typecheck` | `-r`                        |
+  | `pnpm --filter @scope/pkg test`      | `--filter`                  |
+
+  A pre-push hook running `pnpm run typecheck` therefore reported as having no typecheck at
+  all, and `audit` said "type checking is enforced only in CI — no local hook runs it" while
+  the hook ran it on every push.
+
+  Expansion no longer guesses position — it cannot, since the position depends on each
+  manager's own flag grammar. It scans the invocation's tokens for a name that is a known
+  script, which needs no grammar at all. Package-manager built-ins are excluded so `npm ci`
+  is never read as "runs the `ci` script"; that direction matters, because expanding it would
+  claim a gate is covered by a line that only installs dependencies. `test` and `start` stay
+  recognised — those genuinely are script shortcuts. `exec`/`dlx` end the scan, since what
+  follows is a binary, and `npx` is only scanned for `run-s`/`run-p`/`npm-run-all`.
+
+## 0.2.1
+
+### Patch Changes
+
+- fdf6b6e: Fleet sweep: recurring classes + `placement: "none"` honored.
+
+  - **Recurring classes** — the sweep report groups open findings by their engine-minted
+    class prefix and lists every class present in ≥2 projects (worst tier first). A class
+    open in one repo is that repo's problem; the same class in four is a fleet lesson —
+    the report now asks "repo bug or fleet bug?" structurally, instead of relying on a
+    human to ask it at triage time. `--json` gains a `recurringClasses` array
+    (schema still EXPERIMENTAL through 0.2.x).
+  - **`placement: "none"` suppresses `no-contract`** — a registry entry declaring its
+    contract files legitimately absent no longer gets the absence re-reported every sweep.
+    The repo-local lens can't see the registry's declaration, so the fleet view honors it
+    (a standalone `etymd audit` in such a repo still reports it — correctly, since no
+    declaration is in scope there). Tier counts summarize the filtered list.
+
 ## 0.2.0
 
 ### Minor Changes

package/README.md

@@ -5,50 +5,107 @@
 
 **Keep your agent instructions true.**
 
-Your `AGENTS.md` is the interface between your team and every coding agent — and it rots silently.
-Scripts get renamed, directories move, rules go stale, and the file keeps instructing agents with
-confidence. etymd continuously **verifies the agent context layer against the actual repo**:
+You wrote rules for your AI months ago. Since then a script got renamed, a folder moved, a habit
+changed — and the AI still trusts every word. The file never complains when it goes stale; it just
+keeps instructing, confidently, and you live with the results.
+
+etymd reads those instruction files and checks every claim in them against your actual project.
+
+One command, run in your project's folder (needs Node ≥ 18.17, nothing else): `npx etymd audit`.
+Here it is on a small demo project whose AGENTS.md still tells the AI to run `npm run start` and
+`npm run lint` and points at a `src/legacy/` folder — none of which exist any more:
 
 ```
-$ etymd audit
+$ npx etymd audit
+
+  RISK   AGENTS.md tells agents to run `start` — no such script exists
+         evidence  AGENTS.md: `npm run start` · package.json scripts (root + workspaces)
+         why       An agent following this instruction runs a command that fails — or silently skips the check it was meant to run.
+         action    Update the instruction to the current script name (or restore the script).
+         effort S · confidence high · instruction-truth · instruction-truth/stale-command:AGENTS.md:start
 
-  RISK   AGENTS.md tells agents to run `pnpm dev` — no such script exists
-         evidence  AGENTS.md: `pnpm dev` · package.json scripts
-         action    Update the instruction to the current script name.
+  ...
 
-  GAP    AGENTS.md references `src/legacy/` — it does not exist in the repo
-  GAP    Type checking is enforced only in CI — no local hook runs it
-  GAP    AGENTS.md loads 13,809 words (~18k tokens) into every session
+  GAP    AGENTS.md references `src/legacy` — it does not exist in the repo
+         evidence  AGENTS.md · missing: src/legacy
+         why       Agents navigate by these references; a dead path wastes a lookup and erodes trust in the rest of the file.
+         action    Fix or remove the reference.
+         effort S · confidence medium · instruction-truth · instruction-truth/stale-path:AGENTS.md:src/legacy
 
-  since last audit: 1 new · 3 still open · 1 resolved · 1 REGRESSED
+  since last audit: 3 still open
 ```
 
+Each entry names something that is no longer true, shows the evidence it found, and suggests the
+smallest fix. And it remembers between runs: a problem you fixed — or looked at and deliberately
+waved off — never nags you twice.
+
+That's the whole deal. It works with zero configuration and never rewrites your files — the
+memory it keeps between runs lives in one small folder of its own (`.etymd/`). Everything below
+the line is reference — read it when you need it.
+
 _From Greek **étymon** — a word's true, original sense (→ etymology) — clipped to **etym.** + the
 **.md** family it guards._
 
+---
+
 ## Why this exists
 
-- Instruction files are now load-bearing: 20+ agents (Claude Code, Codex, Cursor, Copilot,
-  Gemini, …) read `AGENTS.md` natively. A stale claim doesn't error — it silently misleads every
-  session.
-- Linters exist for these files, but they check **a point in time**. Truth is a property **over
-  time**: etymd measures drift against a **committed baseline**, remembers findings in a
-  **ledger** (fixed things stay fixed; a returning problem is named a _regression_, and a finding
-  you dismissed with a reason never resurfaces), and gates CI on it.
+- **Truth is a property over time, not a point in time.** Instruction files are load-bearing now —
+  coding agents (Claude Code, Codex, Cursor, Copilot, Gemini, …) read `AGENTS.md` natively, and a
+  stale claim doesn't error, it silently misleads every session. Linters for these files check a
+  moment; etymd measures _drift_ against a committed _baseline_ and remembers findings in a
+  _ledger_, so fixed things stay fixed and a returning problem is named a _regression_ (all four
+  words defined just below). It runs when you invoke it — or when a hook or CI job you wire up
+  does.
 - **Honesty is structural.** Every report declares what it could NOT see — CI jobs inherited from
-  unreadable org templates, server-side quality-gate thresholds, skipped heuristics. No guess is
-  ever dressed as a fact.
+  unreadable org templates, server-side quality-gate thresholds, heuristics it skipped. No guess
+  is ever dressed as a fact.
+- **Precision over recall.** A false "your file is lying" costs more trust than a missed lie, so
+  the checks filter aggressively — and every class of claim they skip is counted and disclosed,
+  never silently dropped.
+
+## The words etymd uses
+
+| The docs say          | It means                                                                                                                                                                                                             |
+| --------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| **finding**           | One verified problem, ranked **RISK** (an agent acting on this does the wrong thing) → **GAP** (a dead reference or missing safeguard) → **POLISH** (worth tidying). Within a tier, cheapest fix first.              |
+| **claim**             | Anything an instruction file asserts about the project that can be checked: a command it tells agents to run, a path it points at, a rule about tooling.                                                             |
+| **lens**              | One self-contained checker for one kind of truth (are the commands real? is the state doc current?). An audit is all lenses run together.                                                                            |
+| **baseline**          | A snapshot of the repo's checkable facts that you approved and committed. Drift is measured against this — not against whatever yesterday's cache happened to hold.                                                  |
+| **drift**             | The distance between the baseline and the repo today: what existed at approval and is now gone, renamed, or moved.                                                                                                   |
+| **ledger**            | The committed memory of findings — each one's status and history. A finding that was fixed and comes back is a **regression**, and the report names it as one rather than re-introducing it as new.                  |
+| **dismiss vs accept** | Two deliberate ways to close a finding. _Dismiss_ = "not a real problem, here's why" — it never resurfaces unless it regresses. _Accept_ = "true, and we're living with it" — kept in the ledger, out of the report. |
+| **gate**              | A check that can actually fail a change: a git hook, a CI job. A job marked `allow_failure` is advisory, not a gate — a check that cannot fail anything is an opinion.                                               |
+| **disclosure**        | The report's account of what it could not see or refused to guess about. Every report carries one; a clean result with no disclosures would be the exact dishonesty this tool exists to catch.                       |
+| **fleet**             | Your fleet of **repositories** — every repo you registered in one manifest, swept by one command. Not a fleet of AI agents.                                                                                          |
+| **context economy**   | The words your instruction files load into every single session, measured against a budget. Context is a cost you pay per conversation; leaner files are cheaper and better obeyed.                                  |
+
+### Things that surprise first-run users
+
+- **"It missed an obvious stale command."** Without `node_modules` installed, command claims are
+  skipped — and the skip is disclosed in the report. A command might resolve to an installed
+  binary, and etymd would rather say "couldn't check" than accuse an honest file. Install
+  dependencies and run again.
+- **`etymd audit` works without `etymd init`.** You only lose drift-over-time measurement — with
+  no committed baseline, there is nothing to measure drift against. Everything else runs.
+- **`etymd init` never overwrites an existing `AGENTS.md`.** It scaffolds a minimal one only if
+  you have none. The feared overwrite path simply does not exist.
+
+---
 
 ## Quick start
 
 ```bash
 cd your-project
-npx etymd init          # approve the baseline (+ scaffold AGENTS.md only if you have none)
 npx etymd audit         # verify every instruction claim against the repo
+npx etymd init          # opt in to drift: approve the baseline (+ scaffold AGENTS.md only if you have none)
 npx etymd audit --fail-on risk   # the CI gate
 ```
 
-Requires Node ≥ 18.17. On npm since v0.1.0 — `npx etymd` just works.
+`audit` needs no setup — without `init` you get the full findings report and lose only drift
+measured against a committed baseline. `init` is that opt-in, not a prerequisite, and it never
+overwrites an existing `AGENTS.md`. On npm since v0.1.0 — `npx etymd` just works. To wire the
+gate into a pipeline, see [In CI](#in-ci).
 
 ## What it checks
 
@@ -122,6 +179,10 @@ personal and employer repos. See [the fleet manifest](#the-fleet-manifest-experi
 The committed files are written to be publishable: the baseline records `"."` as its scan root, never
 your absolute machine path. Only the gitignored cache keeps the real one.
 
+Formatter interop: if your Prettier (or similar formatter) checks JSON, add `.etymd` to
+`.prettierignore` — etymd writes its own JSON style, and a format gate fighting the ledger is
+noise (this repo does exactly that).
+
 ### `.etymd/config.json` (optional)
 
 Every key is optional; omit the file entirely and the defaults below apply.
@@ -145,16 +206,55 @@ Every key is optional; omit the file entirely and the defaults below apply.
 Globs are repo-relative: `*` within a path segment, `**` across segments, `?` one character. A
 pattern with no wildcard is a **path prefix**, so `.claude/skills` covers everything beneath it.
 
-Narrowing an audit can hide findings, so etymd never lets it happen quietly: **every excluded file
-is counted and named in the lens disclosures**, and a config that fails to parse is reported as a
-disclosure rather than silently falling back to defaults.
+Narrowing an audit can hide findings, so etymd never lets it happen quietly. Honesty is
+structural: **every excluded file is counted and named in the lens disclosures**, and a config
+that fails to parse is reported as a disclosure rather than silently falling back to defaults.
+
+## In CI
+
+The gate is one command:
+
+```bash
+npx etymd audit --no-ledger --fail-on risk
+```
+
+Exit-code contract: without `--fail-on`, `audit` reports and exits 0 no matter what it found.
+With `--fail-on <tier>` (`risk` | `gap` | `polish`) it exits non-zero when any finding at or
+above that tier exists — so `--fail-on risk` blocks on risks only, `--fail-on polish` blocks on
+everything. `--no-ledger` keeps the CI run read-only: the throwaway checkout is never written.
+
+The ledger and baseline are not CI by-products — they are **committed, reviewable state**,
+updated locally and read in CI. A dismissal (with its reason), an accepted finding, a baseline
+refresh after an intentional restructure: each lands in `.etymd/` and shows up in the pull
+request diff like any other change. Keep `.etymd` out of your formatter's reach (see
+[the files etymd keeps](#the-files-etymd-keeps)).
+
+A check that runs only in CI is itself a finding: the failure surfaces after the agent finished.
+`etymd gates` installs the local pre-commit / pre-push mirror built from your own check scripts,
+and the `gate-integrity` lens flags whatever still runs in CI alone.
+
+Modeled on this repo's own workflow (etymd guards its own instructions with etymd — its CI runs
+the same gate against its own freshly built CLI):
+
+```yaml
+steps:
+  - uses: actions/checkout@v4
+  - uses: actions/setup-node@v4
+    with:
+      node-version: 20
+      cache: npm
+  - run: npm ci
+  - run: npx etymd audit --no-ledger --fail-on risk
+```
 
 ## The fleet manifest (EXPERIMENTAL)
 
 `etymd fleet` extends the one objective across every repository you work in — your fleet of
 **repositories**, not a fleet of agents. The manifest, `registry.json`, is itself an
-agent-context file: claims about your fleet (what exists, where, under which profile). It rots
-like any AGENTS.md does, and `etymd fleet` keeps it true. Design record:
+agent-context file: claims about your fleet (what exists, where, under which **profile** — the
+side of the wall an entry belongs to, `personal` or `corp`; the **wall** is the placement
+boundary between personal and employer content that the sweep polices). It rots like any
+AGENTS.md does, and `etymd fleet` keeps it true. Design record:
 [`docs/design/004-fleet-truth-guard.md`](docs/design/004-fleet-truth-guard.md). Both the
 registry schema and the fleet `--json` schema are **experimental through 0.2.x**.
 
@@ -194,7 +294,7 @@ Two files beside each other — the split is the privacy model:
 
 ```jsonc
 {
-  "machineProfile": "corp", // "personal" resolves corp entries disclosed-absent
+  "machineProfile": "corp", // which profile this machine resolves; "personal" resolves corp entries disclosed-absent
   "root": "~/projects", // optional per-machine root override
   "dirs": { "c-one": "~/projects/real-corp-dir" },
   "labels": { "c-one": "real-corp-dir" },
@@ -212,17 +312,24 @@ How the sweep behaves:
 - **Deltas.** Each sweep compares against `last.fleet.json` stored beside the manifest and
   renders `Δ +new −resolved` per project. Add `*.fleet.json` to the manifest repo's
   `.gitignore` — sweep output is local-only and never tracked.
+- **Recurring classes.** A finding class open in two or more projects renders as its own section
+  of class-fix candidates (worst tier first) — the sweep asking "repo bug or fleet bug?", a
+  fleet-level lesson no per-repo audit can see. The sweep only groups; the class vocabulary is
+  minted by the engine's lenses.
+- **Declared absence is honored.** An entry whose contract declares `"placement": "none"` states
+  that instruction files are legitimately absent in that project — the sweep drops its
+  missing-contract finding instead of re-reporting a decision every run. Absence disclosed on
+  purpose is a state, not a gap.
 - **Wall checks.** Corp contract files found inside a corp worktree, unregistered checkouts
   under the fleet root whose remotes match `corpHosts`, tracked `/Users/` paths in the manifest
-  repo, private needles (labels, dir names, hosts) inside `trust: "public-repo"` entries, and
-  corp-host commit emails on personal entries — each a risk finding; each check that cannot run
-  is disclosed.
+  repo, private **needles** — the identifiers the local file holds (labels, dir names, hosts) —
+  inside `trust: "public-repo"` entries, and corp-host commit emails on personal entries — each
+  a risk finding; each check that cannot run is disclosed.
 - **No global pointer.** `--manifest` is required unless the cwd holds `registry.json` — there
   is deliberately no env var and no home-directory pointer.
 
-Interop note: if a repo's Prettier (or similar formatter) checks JSON, add `.etymd` to its
-`.prettierignore` — etymd writes its own JSON style, and a format gate fighting the ledger is
-noise (this repo does exactly that).
+Formatter interop for the `.etymd` state the sweep resolves: same rule as everywhere — see
+[the files etymd keeps](#the-files-etymd-keeps).
 
 ## Programmatic use
 

package/dist/{approve-EJJDCNYV.js → approve-VC4V3OPW.js}

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
-import { scanProject, PACK_VERSION } from './chunk-WNMA2FYM.js';
-import { VERSION } from './chunk-JQHGV74L.js';
-import { readBaseline, summarizeBaselineDrift, isDriftEmpty, writeBaseline, deriveProfile } from './chunk-DJ2DDFDK.js';
-import { section, theme, print, renderBaselineDrift, glyph } from './chunk-ASKJFMSX.js';
+import { scanProject, PACK_VERSION } from './chunk-BH37LELV.js';
+import { VERSION } from './chunk-LVLZLCND.js';
+import { readBaseline, summarizeBaselineDrift, isDriftEmpty, writeBaseline, deriveProfile } from './chunk-FZSIOCOZ.js';
+import { section, theme, print, renderBaselineDrift, glyph } from './chunk-LBRNZZZF.js';
 
 // src/commands/approve.ts
 async function run(opts) {

package/dist/audit-LZJRJS5V.js

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+export { run } from './chunk-IW6K5HLV.js';
+import './chunk-KMAJIQHC.js';
+import './chunk-KBF3SW3N.js';
+import './chunk-ANCCGYSH.js';
+import './chunk-BH37LELV.js';
+import './chunk-LVLZLCND.js';
+import './chunk-FZSIOCOZ.js';
+import './chunk-LBRNZZZF.js';

package/dist/{brief-GFR3YOZT.js → brief-TZ45MNHD.js}

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
-import { scanProject } from './chunk-WNMA2FYM.js';
-import './chunk-JQHGV74L.js';
-import { ETYMD_DIR } from './chunk-DJ2DDFDK.js';
-import { print, theme } from './chunk-ASKJFMSX.js';
+import { scanProject } from './chunk-BH37LELV.js';
+import './chunk-LVLZLCND.js';
+import { ETYMD_DIR } from './chunk-FZSIOCOZ.js';
+import { print, theme } from './chunk-LBRNZZZF.js';
 import { promises } from 'node:fs';
 import path from 'node:path';
 

package/dist/{chunk-3LBIBVX3.js → chunk-ANCCGYSH.js}

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
-import { ETYMD_DIR } from './chunk-DJ2DDFDK.js';
-import { pathExists, readText, wordCount, approxTokens } from './chunk-ASKJFMSX.js';
+import { ETYMD_DIR } from './chunk-FZSIOCOZ.js';
+import { pathExists, readText, wordCount, approxTokens } from './chunk-LBRNZZZF.js';
 import path2 from 'node:path';
 import { promises } from 'node:fs';
 

package/dist/{chunk-WNMA2FYM.js → chunk-BH37LELV.js}

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
-import { VERSION } from './chunk-JQHGV74L.js';
-import { normalizeRelPath, isDirectory, readJson, git, matchesAnyGlob, pathExists, readText } from './chunk-ASKJFMSX.js';
+import { VERSION } from './chunk-LVLZLCND.js';
+import { normalizeRelPath, isDirectory, readJson, git, matchesAnyGlob, pathExists, readText } from './chunk-LBRNZZZF.js';
 import path from 'node:path';
 import { promises } from 'node:fs';
 

package/dist/{chunk-B4FYQE7S.js → chunk-EUIHYD6F.js}

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
-import { readLedger, resolveEntry, writeLedger } from './chunk-XW5XQN23.js';
-import { print, renderLedger, glyph, theme } from './chunk-ASKJFMSX.js';
+import { readLedger, resolveEntry, writeLedger } from './chunk-KBF3SW3N.js';
+import { print, renderLedger, glyph, theme } from './chunk-LBRNZZZF.js';
 
 // src/commands/ledger.ts
 async function list(opts) {

package/dist/{chunk-DJ2DDFDK.js → chunk-FZSIOCOZ.js}

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { readJson } from './chunk-ASKJFMSX.js';
+import { readJson } from './chunk-LBRNZZZF.js';
 import { promises } from 'node:fs';
 import path from 'node:path';
 

package/dist/{chunk-3WOORFOW.js → chunk-IW6K5HLV.js}

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
-import { parseFailOnTier, runAudit, meetsFailOn } from './chunk-XGH2DTW4.js';
-import { print, section, theme, renderLensCoverage, renderFindings, renderLedgerDiff } from './chunk-ASKJFMSX.js';
+import { parseFailOnTier, runAudit, meetsFailOn } from './chunk-KMAJIQHC.js';
+import { print, section, theme, renderLensCoverage, renderFindings, renderLedgerDiff } from './chunk-LBRNZZZF.js';
 
 // src/commands/audit.ts
 async function run(opts) {

package/dist/{chunk-XW5XQN23.js → chunk-KBF3SW3N.js}

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { readJson } from './chunk-ASKJFMSX.js';
+import { readJson } from './chunk-LBRNZZZF.js';
 import { promises } from 'node:fs';
 import path from 'node:path';
 

package/dist/{chunk-XGH2DTW4.js → chunk-KMAJIQHC.js}

@@ -1,9 +1,9 @@
 #!/usr/bin/env node
-import { readLedger, reconcileLedger, writeLedger, visibleFindings } from './chunk-XW5XQN23.js';
-import { DEFAULT_CONFIG, readConfig, CONFIG_FILE, measureContext } from './chunk-3LBIBVX3.js';
-import { scanProject, PACK_VERSION, expandFileGlobs } from './chunk-WNMA2FYM.js';
-import { ETYMD_DIR, writeCachedFacts, readBaseline, deriveProfile, baselineCarriesMachinePath, BASELINE_FILE } from './chunk-DJ2DDFDK.js';
-import { pathExists, readJson, git, readText, isDirectory, matchesAnyGlob, isCiEnvironment, normalizeRelPath } from './chunk-ASKJFMSX.js';
+import { readLedger, reconcileLedger, writeLedger, visibleFindings } from './chunk-KBF3SW3N.js';
+import { DEFAULT_CONFIG, readConfig, CONFIG_FILE, measureContext } from './chunk-ANCCGYSH.js';
+import { scanProject, PACK_VERSION, expandFileGlobs } from './chunk-BH37LELV.js';
+import { ETYMD_DIR, writeCachedFacts, readBaseline, deriveProfile, baselineCarriesMachinePath, BASELINE_FILE } from './chunk-FZSIOCOZ.js';
+import { pathExists, readJson, git, readText, isDirectory, matchesAnyGlob, isCiEnvironment, normalizeRelPath } from './chunk-LBRNZZZF.js';
 import path from 'node:path';
 import YAML from 'yaml';
 import { promises } from 'node:fs';
@@ -91,24 +91,78 @@ var TOOL_MATCHERS = [
   ["lint", /\beslint\b/],
   ["test", /\bjest\b|\bvitest\b|react-scripts test|\bnx\b[^&|;]*\btest\b/]
 ];
+var PM_SUBCOMMANDS = /* @__PURE__ */ new Set([
+  "run",
+  "run-script",
+  "install",
+  "i",
+  "ci",
+  "add",
+  "remove",
+  "rm",
+  "uninstall",
+  "un",
+  "update",
+  "up",
+  "upgrade",
+  "create",
+  "init",
+  "audit",
+  "publish",
+  "pack",
+  "link",
+  "unlink",
+  "why",
+  "list",
+  "ls",
+  "outdated",
+  "prune",
+  "dedupe",
+  "import",
+  "rebuild",
+  "root",
+  "config",
+  "cache",
+  "login",
+  "logout",
+  "whoami",
+  "version",
+  "workspace",
+  "workspaces",
+  "store",
+  "fund",
+  "deprecate",
+  "access",
+  "bin",
+  "env",
+  "help"
+]);
+var PM_BINARY_RUNNERS = /* @__PURE__ */ new Set(["exec", "dlx", "x"]);
+var NPX_SCRIPT_RUNNERS = /* @__PURE__ */ new Set(["run-s", "run-p", "npm-run-all"]);
 function expandScriptRefs(command, scripts, depth = 2) {
   if (depth <= 0) return command;
   let expanded = command;
-  for (const m of command.matchAll(
-    /(?:yarn|pnpm|npm run|bun run|npx run-s|npx run-p)\s+([A-Za-z0-9:._-]+)/g
-  )) {
-    const name = m[1];
+  const seen = /* @__PURE__ */ new Set();
+  const add = (name) => {
+    if (seen.has(name)) return;
+    seen.add(name);
     const body = scripts[name];
     if (body) expanded += `
 ${expandScriptRefs(body, scripts, depth - 1)}`;
+  };
+  for (const m of command.matchAll(/\b(yarn|pnpm|npm|bun|npx)\b([^&|;]*)/g)) {
+    const manager = m[1];
+    const tokens = (m[2] ?? "").split(/\s+/).map((t) => t.replace(/["']/g, "")).filter(Boolean);
+    if (manager === "npx" && !(tokens[0] && NPX_SCRIPT_RUNNERS.has(tokens[0]))) continue;
+    for (const token of tokens) {
+      if (token.startsWith("-")) continue;
+      if (PM_BINARY_RUNNERS.has(token)) break;
+      if (PM_SUBCOMMANDS.has(token) || NPX_SCRIPT_RUNNERS.has(token)) continue;
+      add(token);
+    }
   }
   if (/npm-run-all|run-s|run-p/.test(command)) {
-    for (const token of command.split(/\s+/)) {
-      const clean = token.replace(/["']/g, "");
-      const body = scripts[clean];
-      if (body) expanded += `
-${expandScriptRefs(body, scripts, depth - 1)}`;
-    }
+    for (const token of command.split(/\s+/)) add(token.replace(/["']/g, ""));
   }
   return expanded;
 }

package/dist/{chunk-ASKJFMSX.js → chunk-LBRNZZZF.js}

@@ -356,4 +356,4 @@ function renderLedger(ledger) {
   }
 }
 
-export { approxTokens, git, glyph, isCiEnvironment, isDirectory, matchesAnyGlob, normalizeRelPath, pathExists, print, readJson, readText, renderBaselineDrift, renderContext, renderFacts, renderFindings, renderFleetNotes, renderFleetRows, renderLedger, renderLedgerDiff, renderLensCoverage, renderPlan, section, theme, wordCount };
+export { TIER_BADGE, approxTokens, git, glyph, isCiEnvironment, isDirectory, matchesAnyGlob, normalizeRelPath, pathExists, print, readJson, readText, renderBaselineDrift, renderContext, renderFacts, renderFindings, renderFleetNotes, renderFleetRows, renderLedger, renderLedgerDiff, renderLensCoverage, renderPlan, section, theme, wordCount };

package/dist/{chunk-JQHGV74L.js → chunk-LVLZLCND.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 // package.json
 var package_default = {
-  version: "0.2.0"};
+  version: "0.2.2"};
 
 // src/version.ts
 var VERSION = package_default.version;

package/dist/{chunk-WQXMJUIA.js → chunk-MWIK6ML3.js}

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
-import { PACK_VERSION } from './chunk-WNMA2FYM.js';
-import { pathExists, readText } from './chunk-ASKJFMSX.js';
+import { PACK_VERSION } from './chunk-BH37LELV.js';
+import { pathExists, readText } from './chunk-LBRNZZZF.js';
 import { promises } from 'node:fs';
 import path from 'node:path';
 

package/dist/cli.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { VERSION } from './chunk-JQHGV74L.js';
+import { VERSION } from './chunk-LVLZLCND.js';
 import path from 'node:path';
 import { Command } from 'commander';
 import pc from 'picocolors';
@@ -31,7 +31,7 @@ program.command("audit").description("Verify every instruction claim against the
   "exit non-zero when findings at/above this tier exist (risk|gap|polish)"
 ).action(
   (opts, cmd) => action(async () => {
-    const { run } = await import('./audit-ATHB6FHN.js');
+    const { run } = await import('./audit-LZJRJS5V.js');
     await run({
       cwd: resolveCwd(cmd),
       json: opts.json,
@@ -44,7 +44,7 @@ program.command("audit").description("Verify every instruction claim against the
 );
 program.command("init").description("Onboard the truth guard: approve the baseline; scaffold AGENTS.md only if missing").option("-y, --yes", "accept defaults without prompting (never overwrites)").action(
   (opts, cmd) => action(async () => {
-    const { run } = await import('./init-WLYWEWRQ.js');
+    const { run } = await import('./init-4CQOLFQG.js');
     await run({ cwd: resolveCwd(cmd), yes: opts.yes });
   })
 );
@@ -52,49 +52,49 @@ program.command("approve").description(
   "Re-approve the committed baseline after intentional structural changes (non-interactive)"
 ).action(
   (_opts, cmd) => action(async () => {
-    const { run } = await import('./approve-EJJDCNYV.js');
+    const { run } = await import('./approve-VC4V3OPW.js');
     await run({ cwd: resolveCwd(cmd) });
   })
 );
 program.command("scan").description("Deterministically reckon the project into a facts index").option("--json", "print the raw facts as JSON").option("--no-save", "do not write the .etymd cache").action(
   (opts, cmd) => action(async () => {
-    const { run } = await import('./scan-62KGD2V3.js');
+    const { run } = await import('./scan-CYOOGJFG.js');
     await run({ cwd: resolveCwd(cmd), json: opts.json, save: opts.save });
   })
 );
 program.command("doctor").description('Alias for `audit --truth` \u2014 "are the recorded instructions still true?"').option("--json", "print findings as JSON").action(
   (opts, cmd) => action(async () => {
-    const { run } = await import('./doctor-WTYZSJ5X.js');
+    const { run } = await import('./doctor-6JDAHGDT.js');
     await run({ cwd: resolveCwd(cmd), json: opts.json });
   })
 );
 program.command("context").description("Measure the always-loaded context footprint and flag extraction candidates").option("--json", "print the budget as JSON").action(
   (opts, cmd) => action(async () => {
-    const { run } = await import('./context-5HAWI2RD.js');
+    const { run } = await import('./context-GYCLR3TG.js');
     await run({ cwd: resolveCwd(cmd), json: opts.json });
   })
 );
 program.command("brief").description("Emit a grounded briefing for the in-repo agent to complete the semantic layer").option("--human", "write a human onboarding brief instead of the agent briefing").action(
   (opts, cmd) => action(async () => {
-    const { run } = await import('./brief-GFR3YOZT.js');
+    const { run } = await import('./brief-TZ45MNHD.js');
     await run({ cwd: resolveCwd(cmd), human: opts.human });
   })
 );
 program.command("ledger").description("List every tracked finding grouped by status (open \xB7 accepted \xB7 dismissed \xB7 \u2026)").option("--json", "print the raw ledger as JSON").action(
   (opts, cmd) => action(async () => {
-    const { list } = await import('./ledger-ENFHLNOG.js');
+    const { list } = await import('./ledger-RHQJH5EA.js');
     await list({ cwd: resolveCwd(cmd), json: opts.json });
   })
 );
 program.command("dismiss").argument("<finding-id>", "the finding id (from `etymd audit`) to dismiss").description("Dismiss a finding as a false positive / not applicable (hidden from future audits)").requiredOption("--reason <text>", "why it is dismissed \u2014 recorded so the decision survives").action(
   (id, opts, cmd) => action(async () => {
-    const { dismiss } = await import('./ledger-ENFHLNOG.js');
+    const { dismiss } = await import('./ledger-RHQJH5EA.js');
     await dismiss({ cwd: resolveCwd(cmd), id, reason: opts.reason });
   })
 );
 program.command("accept").argument("<finding-id>", "the finding id (from `etymd audit`) to accept").description("Accept a real finding as a known trade-off (hidden from future audits)").option("--reason <text>", "optional note on why the trade-off is accepted").action(
   (id, opts, cmd) => action(async () => {
-    const { accept } = await import('./ledger-ENFHLNOG.js');
+    const { accept } = await import('./ledger-RHQJH5EA.js');
     await accept({ cwd: resolveCwd(cmd), id, reason: opts.reason });
   })
 );
@@ -111,7 +111,7 @@ var fleet = program.command("fleet").description(
   "exit non-zero when findings at/above this tier exist (risk|gap|polish)"
 ).action(
   (opts, cmd) => action(async () => {
-    const { sweep } = await import('./fleet-2GXLNLJE.js');
+    const { sweep } = await import('./fleet-N3G5ZIGR.js');
     await sweep({
       cwd: resolveCwd(cmd),
       manifest: opts.manifest,
@@ -126,7 +126,7 @@ var fleet = program.command("fleet").description(
 );
 fleet.command("check").description("Validate the manifest pair only \u2014 no lenses: dangling mappings, duplicates, leaks").option("--manifest <file>", "the fleet manifest \u2014 required unless the cwd holds registry.json").option("--json", "print the findings as JSON (EXPERIMENTAL through 0.2.x)").action(
   (_opts, cmd) => action(async () => {
-    const { check } = await import('./fleet-2GXLNLJE.js');
+    const { check } = await import('./fleet-N3G5ZIGR.js');
     const opts = cmd.optsWithGlobals();
     await check({ cwd: resolveCwd(cmd), manifest: opts.manifest, json: opts.json });
   })
@@ -135,7 +135,7 @@ fleet.command("dismiss").argument("<name>", "the registered project name").argum
   "Dismiss a project's finding from any cwd \u2014 corp ledgers persist beside the manifest"
 ).requiredOption("--reason <text>", "why it is dismissed \u2014 recorded so the decision survives").option("--manifest <file>", "the fleet manifest \u2014 required unless the cwd holds registry.json").action(
   (name, id, _opts, cmd) => action(async () => {
-    const { dismiss } = await import('./fleet-2GXLNLJE.js');
+    const { dismiss } = await import('./fleet-N3G5ZIGR.js');
     const opts = cmd.optsWithGlobals();
     await dismiss({
       cwd: resolveCwd(cmd),
@@ -150,14 +150,14 @@ fleet.command("accept").argument("<name>", "the registered project name").argume
   "Accept a project's finding as a known trade-off \u2014 corp ledgers persist beside the manifest"
 ).option("--reason <text>", "optional note on why the trade-off is accepted").option("--manifest <file>", "the fleet manifest \u2014 required unless the cwd holds registry.json").action(
   (name, id, _opts, cmd) => action(async () => {
-    const { accept } = await import('./fleet-2GXLNLJE.js');
+    const { accept } = await import('./fleet-N3G5ZIGR.js');
     const opts = cmd.optsWithGlobals();
     await accept({ cwd: resolveCwd(cmd), manifest: opts.manifest, name, id, reason: opts.reason });
   })
 );
 program.command("gates").description("Install the local git-hook gates (process \u2192 pre-commit, correctness \u2192 pre-push)").option("--ci", "note about the CI review gate (ships later; local gates install now)").option("-y, --yes", "skip prompts; never overwrites a hand-edited hook").action(
   (opts, cmd) => action(async () => {
-    const { run } = await import('./gates-LD276XN5.js');
+    const { run } = await import('./gates-G5BCMRRV.js');
     await run({ cwd: resolveCwd(cmd), ci: opts.ci, yes: opts.yes });
   })
 );

package/dist/{context-5HAWI2RD.js → context-GYCLR3TG.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
-import { readConfig, measureContext } from './chunk-3LBIBVX3.js';
-import './chunk-DJ2DDFDK.js';
-import { print, renderContext } from './chunk-ASKJFMSX.js';
+import { readConfig, measureContext } from './chunk-ANCCGYSH.js';
+import './chunk-FZSIOCOZ.js';
+import { print, renderContext } from './chunk-LBRNZZZF.js';
 
 // src/commands/context.ts
 async function run(opts) {

package/dist/doctor-6JDAHGDT.js

@@ -0,0 +1,16 @@
+#!/usr/bin/env node
+import { run } from './chunk-IW6K5HLV.js';
+import './chunk-KMAJIQHC.js';
+import './chunk-KBF3SW3N.js';
+import './chunk-ANCCGYSH.js';
+import './chunk-BH37LELV.js';
+import './chunk-LVLZLCND.js';
+import './chunk-FZSIOCOZ.js';
+import './chunk-LBRNZZZF.js';
+
+// src/commands/doctor.ts
+async function run2(opts) {
+  await run({ cwd: opts.cwd, json: opts.json, truth: true });
+}
+
+export { run2 as run };

package/dist/{fleet-2GXLNLJE.js → fleet-N3G5ZIGR.js}

@@ -1,12 +1,12 @@
 #!/usr/bin/env node
-import { dismiss, accept } from './chunk-B4FYQE7S.js';
-import { parseFailOnTier, meetsFailOn, runAudit } from './chunk-XGH2DTW4.js';
-import { readLedger } from './chunk-XW5XQN23.js';
-import { DEFAULT_CONFIG } from './chunk-3LBIBVX3.js';
-import './chunk-WNMA2FYM.js';
-import './chunk-JQHGV74L.js';
-import { ETYMD_DIR } from './chunk-DJ2DDFDK.js';
-import { print, theme, section, renderFleetRows, renderFleetNotes, renderFindings, glyph, pathExists, readText, isDirectory, git } from './chunk-ASKJFMSX.js';
+import { dismiss, accept } from './chunk-EUIHYD6F.js';
+import { parseFailOnTier, meetsFailOn, runAudit } from './chunk-KMAJIQHC.js';
+import { readLedger } from './chunk-KBF3SW3N.js';
+import { DEFAULT_CONFIG } from './chunk-ANCCGYSH.js';
+import './chunk-BH37LELV.js';
+import './chunk-LVLZLCND.js';
+import { ETYMD_DIR } from './chunk-FZSIOCOZ.js';
+import { print, theme, section, renderFleetRows, renderFleetNotes, renderFindings, TIER_BADGE, glyph, pathExists, readText, isDirectory, git } from './chunk-LBRNZZZF.js';
 import { promises } from 'node:fs';
 import path from 'node:path';
 import os from 'node:os';
@@ -246,6 +246,25 @@ var pExecFile = promisify(execFile);
 var FLEET_LENS = "fleet-manifest";
 var FLEET_JSON_SCHEMA = "fleet-experimental-0.2";
 var CORP_WALL_ARTIFACTS = ["PROJECT_CONTEXT.md", "DECISIONS.md"];
+function recurringClasses(projects) {
+  const byClass = /* @__PURE__ */ new Map();
+  for (const p of projects) {
+    for (const f of p.findings) {
+      const classId = f.id.split(":")[0] ?? f.id;
+      const entry = byClass.get(classId);
+      if (entry) {
+        entry.projects.add(p.name);
+        if (TIER_ORDER.indexOf(f.tier) < TIER_ORDER.indexOf(entry.tier)) entry.tier = f.tier;
+      } else {
+        byClass.set(classId, { tier: f.tier, projects: /* @__PURE__ */ new Set([p.name]) });
+      }
+    }
+  }
+  return [...byClass.entries()].filter(([, v]) => v.projects.size >= 2).map(([classId, v]) => ({ classId, tier: v.tier, projects: [...v.projects].sort() })).sort(
+    (a, b) => TIER_ORDER.indexOf(a.tier) - TIER_ORDER.indexOf(b.tier) || b.projects.length - a.projects.length || a.classId.localeCompare(b.classId)
+  );
+}
+var TIER_ORDER = ["risk", "gap", "polish"];
 function finding(id, tier, claim, evidence, why, action) {
   return {
     id,
@@ -695,7 +714,10 @@ async function sweepEntry(manifest, entry, opts) {
     upstreamRemote
   });
   project.findings = result.findings;
-  for (const f of result.findings) project.counts[f.tier] += 1;
+  if (entry.contract.placement === "none") {
+    project.findings = project.findings.filter((f) => !f.id.endsWith("/no-contract"));
+  }
+  for (const f of project.findings) project.counts[f.tier] += 1;
   project.stateAgeDays = stateAgeDays(result.facts);
   project.staleAfterDays = result.config.config.state.staleAfterDays;
   for (const [key, value] of Object.entries(entry.contract)) {
@@ -737,7 +759,8 @@ async function sweepFleet(manifest, opts = {}) {
     wall: wall.findings,
     wallDisclosures: wall.disclosures,
     outOfScope: projects.filter((p) => !p.resolvedRoot || p.unresolved).map((p) => p.name),
-    problems: manifest.problems.map((p) => `${p.file}: ${p.detail}`)
+    problems: manifest.problems.map((p) => `${p.file}: ${p.detail}`),
+    recurringClasses: recurringClasses(projects)
   };
 }
 async function fleetLedgerTarget(manifest, name) {
@@ -906,6 +929,14 @@ function renderSweep(result, previous, delta, wallNew) {
     section(`New or risk findings ${theme.dim(`(${detail.length})`)}`);
     renderFindings(detail);
   }
+  if (result.recurringClasses.length) {
+    section(`Recurring classes ${theme.dim("(open in \u22652 projects \u2014 class-fix candidates)")}`);
+    for (const rc of result.recurringClasses) {
+      print(
+        `  ${TIER_BADGE[rc.tier]} ${rc.classId} ${theme.dim(`\u2014 ${rc.projects.length}\xD7: ${rc.projects.join(", ")}`)}`
+      );
+    }
+  }
   section("Fleet wall");
   if (!result.wall.length) print(`  ${glyph.ok} ${theme.dim("clean")}`);
   else

package/dist/{gates-LD276XN5.js → gates-G5BCMRRV.js}

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
-import { planWorkflow, applyFiles } from './chunk-WQXMJUIA.js';
-import { scanProject } from './chunk-WNMA2FYM.js';
-import './chunk-JQHGV74L.js';
-import { section, print, glyph, theme, renderPlan, git } from './chunk-ASKJFMSX.js';
+import { planWorkflow, applyFiles } from './chunk-MWIK6ML3.js';
+import { scanProject } from './chunk-BH37LELV.js';
+import './chunk-LVLZLCND.js';
+import { section, print, glyph, theme, renderPlan, git } from './chunk-LBRNZZZF.js';
 import { confirm, isCancel, cancel } from '@clack/prompts';
 
 async function run(opts) {

package/dist/index.d.ts

@@ -499,6 +499,15 @@ interface FleetSweepResult {
     outOfScope: string[];
     /** Manifest problems, verbatim — disclosed by every renderer, never defaulted away. */
     problems: string[];
+    /** Defect classes open in ≥2 projects — the class-fix candidates (see recurringClasses()). */
+    recurringClasses: RecurringClass[];
+}
+interface RecurringClass {
+    /** The `<lens>/<class>` id prefix — minted by the engine's lenses, identical across repos. */
+    classId: string;
+    tier: FindingTier;
+    /** Project names (corp entries by alias) where the class is currently open. */
+    projects: string[];
 }
 /**
  * Where a corp entry's audit state persists: beside the manifest, never in the worktree.

package/dist/index.js

@@ -13,7 +13,7 @@ var PACK_VERSION = "2";
 // package.json
 var package_default = {
   name: "etymd",
-  version: "0.2.0"};
+  version: "0.2.2"};
 
 // src/version.ts
 var VERSION = package_default.version;
@@ -1076,24 +1076,78 @@ var TOOL_MATCHERS = [
   ["lint", /\beslint\b/],
   ["test", /\bjest\b|\bvitest\b|react-scripts test|\bnx\b[^&|;]*\btest\b/]
 ];
+var PM_SUBCOMMANDS = /* @__PURE__ */ new Set([
+  "run",
+  "run-script",
+  "install",
+  "i",
+  "ci",
+  "add",
+  "remove",
+  "rm",
+  "uninstall",
+  "un",
+  "update",
+  "up",
+  "upgrade",
+  "create",
+  "init",
+  "audit",
+  "publish",
+  "pack",
+  "link",
+  "unlink",
+  "why",
+  "list",
+  "ls",
+  "outdated",
+  "prune",
+  "dedupe",
+  "import",
+  "rebuild",
+  "root",
+  "config",
+  "cache",
+  "login",
+  "logout",
+  "whoami",
+  "version",
+  "workspace",
+  "workspaces",
+  "store",
+  "fund",
+  "deprecate",
+  "access",
+  "bin",
+  "env",
+  "help"
+]);
+var PM_BINARY_RUNNERS = /* @__PURE__ */ new Set(["exec", "dlx", "x"]);
+var NPX_SCRIPT_RUNNERS = /* @__PURE__ */ new Set(["run-s", "run-p", "npm-run-all"]);
 function expandScriptRefs(command, scripts, depth = 2) {
   if (depth <= 0) return command;
   let expanded = command;
-  for (const m of command.matchAll(
-    /(?:yarn|pnpm|npm run|bun run|npx run-s|npx run-p)\s+([A-Za-z0-9:._-]+)/g
-  )) {
-    const name = m[1];
+  const seen = /* @__PURE__ */ new Set();
+  const add = (name) => {
+    if (seen.has(name)) return;
+    seen.add(name);
     const body = scripts[name];
     if (body) expanded += `
 ${expandScriptRefs(body, scripts, depth - 1)}`;
+  };
+  for (const m of command.matchAll(/\b(yarn|pnpm|npm|bun|npx)\b([^&|;]*)/g)) {
+    const manager = m[1];
+    const tokens = (m[2] ?? "").split(/\s+/).map((t) => t.replace(/["']/g, "")).filter(Boolean);
+    if (manager === "npx" && !(tokens[0] && NPX_SCRIPT_RUNNERS.has(tokens[0]))) continue;
+    for (const token of tokens) {
+      if (token.startsWith("-")) continue;
+      if (PM_BINARY_RUNNERS.has(token)) break;
+      if (PM_SUBCOMMANDS.has(token) || NPX_SCRIPT_RUNNERS.has(token)) continue;
+      add(token);
+    }
   }
   if (/npm-run-all|run-s|run-p/.test(command)) {
-    for (const token of command.split(/\s+/)) {
-      const clean = token.replace(/["']/g, "");
-      const body = scripts[clean];
-      if (body) expanded += `
-${expandScriptRefs(body, scripts, depth - 1)}`;
-    }
+    for (const token of command.split(/\s+/)) add(token.replace(/["']/g, ""));
   }
   return expanded;
 }
@@ -2622,6 +2676,25 @@ var pExecFile2 = promisify(execFile);
 var FLEET_LENS = "fleet-manifest";
 var FLEET_JSON_SCHEMA = "fleet-experimental-0.2";
 var CORP_WALL_ARTIFACTS = ["PROJECT_CONTEXT.md", "DECISIONS.md"];
+function recurringClasses(projects) {
+  const byClass = /* @__PURE__ */ new Map();
+  for (const p of projects) {
+    for (const f of p.findings) {
+      const classId = f.id.split(":")[0] ?? f.id;
+      const entry = byClass.get(classId);
+      if (entry) {
+        entry.projects.add(p.name);
+        if (TIER_ORDER2.indexOf(f.tier) < TIER_ORDER2.indexOf(entry.tier)) entry.tier = f.tier;
+      } else {
+        byClass.set(classId, { tier: f.tier, projects: /* @__PURE__ */ new Set([p.name]) });
+      }
+    }
+  }
+  return [...byClass.entries()].filter(([, v]) => v.projects.size >= 2).map(([classId, v]) => ({ classId, tier: v.tier, projects: [...v.projects].sort() })).sort(
+    (a, b) => TIER_ORDER2.indexOf(a.tier) - TIER_ORDER2.indexOf(b.tier) || b.projects.length - a.projects.length || a.classId.localeCompare(b.classId)
+  );
+}
+var TIER_ORDER2 = ["risk", "gap", "polish"];
 function finding3(id, tier, claim, evidence, why, action) {
   return {
     id,
@@ -3071,7 +3144,10 @@ async function sweepEntry(manifest, entry, opts) {
     upstreamRemote
   });
   project.findings = result.findings;
-  for (const f of result.findings) project.counts[f.tier] += 1;
+  if (entry.contract.placement === "none") {
+    project.findings = project.findings.filter((f) => !f.id.endsWith("/no-contract"));
+  }
+  for (const f of project.findings) project.counts[f.tier] += 1;
   project.stateAgeDays = stateAgeDays(result.facts);
   project.staleAfterDays = result.config.config.state.staleAfterDays;
   for (const [key, value] of Object.entries(entry.contract)) {
@@ -3113,7 +3189,8 @@ async function sweepFleet(manifest, opts = {}) {
     wall: wall.findings,
     wallDisclosures: wall.disclosures,
     outOfScope: projects.filter((p) => !p.resolvedRoot || p.unresolved).map((p) => p.name),
-    problems: manifest.problems.map((p) => `${p.file}: ${p.detail}`)
+    problems: manifest.problems.map((p) => `${p.file}: ${p.detail}`),
+    recurringClasses: recurringClasses(projects)
   };
 }
 

package/dist/{init-WLYWEWRQ.js → init-4CQOLFQG.js}

@@ -1,9 +1,9 @@
 #!/usr/bin/env node
-import { planWorkflow, applyFiles } from './chunk-WQXMJUIA.js';
-import { scanProject, PACK_VERSION } from './chunk-WNMA2FYM.js';
-import { VERSION } from './chunk-JQHGV74L.js';
-import { writeCachedFacts, deriveProfile, writeBaseline, CACHE_DIR } from './chunk-DJ2DDFDK.js';
-import { theme, renderFacts, print, renderPlan, git, section, glyph, readText } from './chunk-ASKJFMSX.js';
+import { planWorkflow, applyFiles } from './chunk-MWIK6ML3.js';
+import { scanProject, PACK_VERSION } from './chunk-BH37LELV.js';
+import { VERSION } from './chunk-LVLZLCND.js';
+import { writeCachedFacts, deriveProfile, writeBaseline, CACHE_DIR } from './chunk-FZSIOCOZ.js';
+import { theme, renderFacts, print, renderPlan, git, section, glyph, readText } from './chunk-LBRNZZZF.js';
 import { promises } from 'node:fs';
 import path from 'node:path';
 import { intro, spinner, select, confirm, outro, isCancel, cancel } from '@clack/prompts';

package/dist/ledger-RHQJH5EA.js

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+export { accept, dismiss, list } from './chunk-EUIHYD6F.js';
+import './chunk-KBF3SW3N.js';
+import './chunk-LBRNZZZF.js';

package/dist/{scan-62KGD2V3.js → scan-CYOOGJFG.js}

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
-import { scanProject } from './chunk-WNMA2FYM.js';
-import './chunk-JQHGV74L.js';
-import { writeCachedFacts } from './chunk-DJ2DDFDK.js';
-import { print, renderFacts, theme } from './chunk-ASKJFMSX.js';
+import { scanProject } from './chunk-BH37LELV.js';
+import './chunk-LVLZLCND.js';
+import { writeCachedFacts } from './chunk-FZSIOCOZ.js';
+import { print, renderFacts, theme } from './chunk-LBRNZZZF.js';
 
 // src/commands/scan.ts
 async function run(opts) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "etymd",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "Keep your agent instructions true — verify AGENTS.md, CLAUDE.md, rules & skills against the actual repo, with drift caught over time and a regression ledger.",
   "keywords": [
     "cli",

package/dist/audit-ATHB6FHN.js

@@ -1,9 +0,0 @@
-#!/usr/bin/env node
-export { run } from './chunk-3WOORFOW.js';
-import './chunk-XGH2DTW4.js';
-import './chunk-XW5XQN23.js';
-import './chunk-3LBIBVX3.js';
-import './chunk-WNMA2FYM.js';
-import './chunk-JQHGV74L.js';
-import './chunk-DJ2DDFDK.js';
-import './chunk-ASKJFMSX.js';

package/dist/doctor-WTYZSJ5X.js

@@ -1,16 +0,0 @@
-#!/usr/bin/env node
-import { run } from './chunk-3WOORFOW.js';
-import './chunk-XGH2DTW4.js';
-import './chunk-XW5XQN23.js';
-import './chunk-3LBIBVX3.js';
-import './chunk-WNMA2FYM.js';
-import './chunk-JQHGV74L.js';
-import './chunk-DJ2DDFDK.js';
-import './chunk-ASKJFMSX.js';
-
-// src/commands/doctor.ts
-async function run2(opts) {
-  await run({ cwd: opts.cwd, json: opts.json, truth: true });
-}
-
-export { run2 as run };

package/dist/ledger-ENFHLNOG.js

@@ -1,4 +0,0 @@
-#!/usr/bin/env node
-export { accept, dismiss, list } from './chunk-B4FYQE7S.js';
-import './chunk-XW5XQN23.js';
-import './chunk-ASKJFMSX.js';