@geonosis/doctor 1.1.0 → 1.2.0

package/README.md

@@ -17,6 +17,10 @@ question it could not ask is not a pass — and 2 when the run could not be made
 geonosis-doctor [--root <dir>] [--json] [--strict] [--baseline-against [<ref>]] [--oxlint <path>]
 ```
 
+## One check, asked alone
+
+`geonosis-doctor --only loaded` runs that check and no other, in well under a second: a manifest read and a resolution per config. It exists because the doctor subsumed a consumer's own declared-vs-loaded script that lived in a 2.5 s local gate, and eleven seconds for seven checks cannot live there — so the question that catches a stale nested copy earliest had fallen out of the gate that runs most often (during.day, 2026-08-30: `bun add` across eleven workspaces left `packages/workflows` loading 1.0.0 against configs written for 1.1.0, and the script about to be deleted caught it). `--only loaded,runner` takes a list; a name the doctor does not have is refused with the seven it does. A `loaded` FAIL now says the remedy: remove the nested copies and reinstall.
+
 ## The seven checks
 
 ### `loaded` — declared ≠ loaded

package/dist/{chunk-CG2LN4VW.js → chunk-ZJCUTDQW.js}

@@ -919,7 +919,7 @@ var oneConfig = async ({
   }
   return held ? said("OK", `loaded ${loaded.version} = declared ${declared.spec} (${declared.at})`) : said(
     "FAIL",
-    `loaded ${loaded.version}, declared ${declared.spec} (${declared.at}) \u2014 a nested copy at ${loaded.at}`
+    `loaded ${loaded.version}, declared ${declared.spec} (${declared.at}) \u2014 a nested copy at ${loaded.at}. Remove the nested copies (rm -rf <workspace>/node_modules/@geonosis) and reinstall; the linter is not running what the tree declares until then`
   );
 };
 var labelOf = (workspace) => workspace.relative === "" ? "root" : workspace.relative;
@@ -1276,28 +1276,37 @@ var countsOf = (findings) => findings.reduce((counts, one) => ({ ...counts, [one
 });
 var runDoctor = async ({
   baseline,
+  only,
   oxlint,
   root,
   strict = false
 }) => {
   const configs = discoverConfigs(root);
   const workspaces = discoverWorkspaces(root);
-  const binary = oxlint ?? resolveOxlint(root);
-  const repoCorpus = repoCorpusOf(root);
-  const found = ordered([
-    ...await checkLoaded({ configs, root, workspaces }),
-    ...await exercisedOf({
-      configs,
-      oxlint: binary,
-      ...repoCorpus === void 0 ? {} : { repoCorpus },
-      root
-    }),
-    ...baselineOf({ baseline, root }),
-    ...checkRunner({ ratchet: readRatchet(root), workspaces }),
-    ...await checkObservability({ now: Date.now(), root }),
-    ...checkDrift({ root, workspaces }),
-    ...checkDeployed({ root })
-  ]);
+  const asked = (check) => only === void 0 || only.includes(check);
+  const runs = [
+    ["loaded", () => checkLoaded({ configs, root, workspaces })],
+    [
+      "exercised",
+      () => {
+        const repoCorpus = repoCorpusOf(root);
+        return exercisedOf({
+          configs,
+          oxlint: oxlint ?? resolveOxlint(root),
+          ...repoCorpus === void 0 ? {} : { repoCorpus },
+          root
+        });
+      }
+    ],
+    ["baseline", () => baselineOf({ baseline, root })],
+    ["runner", () => checkRunner({ ratchet: readRatchet(root), workspaces })],
+    ["observability", () => checkObservability({ now: Date.now(), root })],
+    ["drift", () => checkDrift({ root, workspaces })],
+    ["deployed", () => checkDeployed({ root })]
+  ];
+  const collected = [];
+  for (const [check, run] of runs) if (asked(check)) collected.push(...await run());
+  const found = ordered(collected);
   const findings = strict ? found.map((one) => one.verdict === "WARN" ? { ...one, verdict: "FAIL" } : one) : found;
   return {
     counts: countsOf(findings),
@@ -1330,13 +1339,17 @@ var sectionOf = (check, findings) => {
 var formatDoctor = ({ counts, findings, ok, root }) => [
   `geonosis-doctor \u2014 ${root}`,
   "",
-  ...CHECKS.flatMap((check) => sectionOf(check, findings)),
-  `${CHECKS.length} checks, ${findings.length} lines: ${counts.OK} ok, ${counts.WARN} warned, ${counts.SKIP} skipped, ${counts.UNJUDGED} unjudged, ${counts.FAIL} failed`,
+  // A check nobody asked for (--only) said nothing; a section for it would read as a check that ran.
+  ...CHECKS.filter((check) => findings.some((one) => one.check === check)).flatMap(
+    (check) => sectionOf(check, findings)
+  ),
+  `${ranOf(findings)} ${ranOf(findings) === 1 ? "check" : "checks"}, ${findings.length} lines: ${counts.OK} ok, ${counts.WARN} warned, ${counts.SKIP} skipped, ${counts.UNJUDGED} unjudged, ${counts.FAIL} failed`,
   ok ? "doctor PASS \u2014 nothing here says the gates are measuring something other than what they claim." : "doctor FAIL \u2014 a line above is a gate reporting on something other than what it names, or a question this could not ask at all.",
   ""
 ].join("\n");
 var formatJson = (report) => `${JSON.stringify(report, null, 2)}
 `;
+var ranOf = (findings) => new Set(findings.map((one) => one.check)).size;
 
 export {
   CONFIG_FILE,

package/dist/doctor-cli.js

@@ -1,12 +1,13 @@
 import {
+  CHECKS,
   formatDoctor,
   formatJson,
   runDoctor
-} from "./chunk-CG2LN4VW.js";
+} from "./chunk-ZJCUTDQW.js";
 
 // src/doctor-cli.ts
 import { resolve } from "path";
-var USAGE = `geonosis-doctor [--root <dir>] [--json] [--strict] [--baseline-against [<ref>]] [--oxlint <path>]
+var USAGE = `geonosis-doctor [--root <dir>] [--only <check,\u2026>] [--json] [--strict] [--baseline-against [<ref>]] [--oxlint <path>]
 
 Five questions a version bump is not finished until something has asked. The first four are ways
 enforcement has reported green while measuring nothing; the fifth asks whether it is still there.
@@ -57,7 +58,7 @@ plugin-route-namespaced on its package root, while the shipped corpus says acme
 Exits 1 when any line is a FAIL or an UNJUDGED \u2014 a question this could not ask is not a pass \u2014 and
 2 when the run could not be made at all. --strict promotes every WARN to a FAIL. --json prints the
 whole report for a CI step to read.`;
-var VALUED = /* @__PURE__ */ new Set(["--oxlint", "--root"]);
+var VALUED = /* @__PURE__ */ new Set(["--only", "--oxlint", "--root"]);
 var parseDoctorArgs = (argv, cwd) => {
   const read = {};
   let baseline;
@@ -85,9 +86,15 @@ var parseDoctorArgs = (argv, cwd) => {
     read[flag] = value;
     index += 1;
   }
+  const only = read["--only"]?.split(",").map((one) => one.trim()).filter((one) => one !== "");
+  const unknown = (only ?? []).filter((one) => !CHECKS.includes(one));
+  if (unknown.length > 0) {
+    throw new Error(`no check called ${unknown.join(", ")} \u2014 the checks are ${CHECKS.join(", ")}`);
+  }
   return {
     ...baseline === void 0 ? {} : { baseline },
     json,
+    ...only === void 0 || only.length === 0 ? {} : { only },
     ...read["--oxlint"] === void 0 ? {} : { oxlint: resolve(cwd, read["--oxlint"]) },
     root: resolve(cwd, read["--root"] ?? cwd),
     strict

package/dist/index.d.ts

@@ -65,6 +65,8 @@ type DoctorOptions = {
         ref?: string;
     };
     oxlint?: string;
+    /** Run these checks and no other — one question, asked fast, belongs in a sub-second gate. */
+    only?: CheckName[];
     root: string;
     strict?: boolean;
 };
@@ -124,7 +126,7 @@ declare const discoverConfigs: (root: string) => DiscoveredConfig[];
 declare const discoverWorkspaces: (root: string) => Workspace[];
 declare const readRatchet: (root: string) => RatchetConfig | undefined;
 
-declare const runDoctor: ({ baseline, oxlint, root, strict, }: DoctorOptions) => Promise<DoctorReport>;
+declare const runDoctor: ({ baseline, only, oxlint, root, strict, }: DoctorOptions) => Promise<DoctorReport>;
 
 /** Which kit package reads which block of `geonosis.json`. */
 declare const READERS: Record<string, string>;

package/dist/index.js

@@ -34,7 +34,7 @@ import {
   resolveFrom,
   runDoctor,
   satisfies
-} from "./chunk-CG2LN4VW.js";
+} from "./chunk-ZJCUTDQW.js";
 export {
   CHECKS,
   CONFIG_FILE,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@geonosis/doctor",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "types": "./dist/index.d.ts",
   "description": "The adoption doctor — declared ≠ loaded, enabled ≠ exercised, a baseline that grew, a runner whose exit code is the only verdict.",
   "keywords": [
@@ -35,7 +35,7 @@
     "dist"
   ],
   "dependencies": {
-    "@geonosis/lint-parity": "1.1.0"
+    "@geonosis/lint-parity": "1.2.0"
   },
   "peerDependencies": {
     "oxlint": ">=1.77"