legend-doctor 0.1.0

package/dist/src/cli/analyzer-identity.js

@@ -0,0 +1,45 @@
+import { URL, fileURLToPath } from "node:url";
+import { readFile, readdir } from "node:fs/promises";
+import { createHash } from "node:crypto";
+import path from "node:path";
+const BUILD_DIGEST_LENGTH = 16;
+export async function analyzerIdentity() {
+    const [version, build] = await Promise.all([packageVersion(), buildDigest()]);
+    return { build, version };
+}
+async function packageVersion() {
+    const manifest = JSON.parse(await readFile(new URL("../../../package.json", import.meta.url), "utf8"));
+    const declared = manifest instanceof Object ? new Map(Object.entries(manifest)).get("version") : undefined;
+    if (String(declared) !== declared) {
+        throw new Error("package.json does not declare a string version");
+    }
+    return declared;
+}
+/** Digests every compiled module in dependency-free order so equal builds compare equal. */
+async function buildDigest() {
+    const root = fileURLToPath(new URL("../", import.meta.url));
+    const files = await compiledModules(root);
+    const contents = await Promise.all(files.map((file) => readFile(file)));
+    const hash = createHash("sha256");
+    for (const [index, file] of files.entries()) {
+        hash.update(path.relative(root, file));
+        hash.update("\0");
+        hash.update(contents[index]);
+        hash.update("\0");
+    }
+    return hash.digest("hex").slice(0, BUILD_DIGEST_LENGTH);
+}
+function entryModules(directory, entry) {
+    const full = path.join(directory, entry.name);
+    if (entry.isDirectory()) {
+        return compiledModules(full);
+    }
+    return Promise.resolve(entry.name.endsWith(".js") ? [full] : []);
+}
+async function compiledModules(directory) {
+    const entries = await readdir(directory, { withFileTypes: true });
+    const sorted = entries.toSorted((left, right) => left.name.localeCompare(right.name));
+    const nested = await Promise.all(sorted.map((entry) => entryModules(directory, entry)));
+    return nested.flat();
+}
+//# sourceMappingURL=analyzer-identity.js.map

package/dist/src/cli/analyzer-identity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyzer-identity.js","sourceRoot":"","sources":["../../../src/cli/analyzer-identity.ts"],"names":[],"mappings":"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"}

package/dist/src/cli/config.d.ts

@@ -0,0 +1,14 @@
+import type { Action } from "./options.js";
+import type { MaterialityTier } from "../analysis/constants.js";
+export declare const CONFIG_FILE_NAME = "legend-doctor.config.json";
+/** Project defaults read from the nearest `legend-doctor.config.json` at or above the scan root. */
+export interface ScanConfig {
+    readonly ignoreActions: readonly Action[];
+    readonly materiality: MaterialityTier | null;
+    /** Absolute path of the file the values came from, or null when no file was found. */
+    readonly source: string | null;
+}
+/** The nearest config at or above `root`, or empty defaults when the tree carries none. */
+export declare function discoverConfig(root: string): Promise<ScanConfig>;
+export declare function parseConfig(text: string, source: string): ScanConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/src/cli/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/cli/config.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAIhE,eAAO,MAAM,gBAAgB,8BAA8B,CAAC;AAE5D,oGAAoG;AACpG,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1C,QAAQ,CAAC,WAAW,EAAE,eAAe,GAAG,IAAI,CAAC;IAC7C,sFAAsF;IACtF,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAYD,2FAA2F;AAC3F,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAStE;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,UAAU,CAiBpE"}

package/dist/src/cli/config.js

@@ -0,0 +1,86 @@
+import { isAction, isMaterialityTier } from "./options.js";
+import { readFile, stat } from "node:fs/promises";
+import { UsageError } from "./usage-error.js";
+import path from "node:path";
+export const CONFIG_FILE_NAME = "legend-doctor.config.json";
+const EMPTY_CONFIG = { ignoreActions: [], materiality: null, source: null };
+const KNOWN_KEYS = new Set(["ignoreActions", "materiality"]);
+/** The nearest config at or above `root`, or empty defaults when the tree carries none. */
+export async function discoverConfig(root) {
+    const candidates = ancestors(path.resolve(root)).map((directory) => path.join(directory, CONFIG_FILE_NAME));
+    const present = await Promise.all(candidates.map((candidate) => isFile(candidate)));
+    const nearest = candidates.find((_candidate, index) => present[index]);
+    return nearest === undefined
+        ? EMPTY_CONFIG
+        : parseConfig(await readFile(nearest, "utf8"), nearest);
+}
+export function parseConfig(text, source) {
+    const label = path.basename(source);
+    const parsed = parseJson(text, label);
+    if (!isJsonObject(parsed)) {
+        throw new UsageError(`${label}: expected a JSON object at the top level`);
+    }
+    const unknownKey = Object.keys(parsed).find((key) => !KNOWN_KEYS.has(key));
+    if (unknownKey !== undefined) {
+        throw new UsageError(`${label}: unknown key '${unknownKey}'; supported keys are ${[...KNOWN_KEYS].join(", ")}`);
+    }
+    return {
+        ignoreActions: parseIgnoreActions(parsed.ignoreActions, label),
+        materiality: parseMateriality(parsed.materiality, label),
+        source,
+    };
+}
+function parseJson(text, label) {
+    try {
+        const parsed = JSON.parse(text);
+        return parsed;
+    }
+    catch (error) {
+        const detail = error instanceof Error ? error.message : "invalid JSON";
+        throw new UsageError(`${label}: ${detail}`);
+    }
+}
+function parseIgnoreActions(value, label) {
+    if (value === undefined) {
+        return [];
+    }
+    if (!Array.isArray(value)) {
+        throw new UsageError(`${label}: ignoreActions must be an array of action names`);
+    }
+    const names = value.map((entry) => (isJsonString(entry) ? entry : ""));
+    const invalid = names.find((name) => !isAction(name));
+    if (invalid !== undefined) {
+        throw new UsageError(`${label}: ignoreActions contains an unknown action '${invalid}'; see ACTIONS.md`);
+    }
+    return [...new Set(names.filter((name) => isAction(name)))];
+}
+function parseMateriality(value, label) {
+    if (value === undefined) {
+        return null;
+    }
+    if (!isJsonString(value) || !isMaterialityTier(value)) {
+        throw new UsageError(`${label}: materiality must be "broad" or "compact"`);
+    }
+    return value;
+}
+function isJsonObject(value) {
+    return value instanceof Object && !Array.isArray(value);
+}
+function isJsonString(value) {
+    return value?.constructor === String;
+}
+function ancestors(start) {
+    const directories = [start];
+    let current = start;
+    let parent = path.dirname(current);
+    while (parent !== current) {
+        directories.push(parent);
+        current = parent;
+        parent = path.dirname(current);
+    }
+    return directories;
+}
+function isFile(candidate) {
+    return stat(candidate).then((entry) => entry.isFile(), () => false);
+}
+//# sourceMappingURL=config.js.map

package/dist/src/cli/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../src/cli/config.ts"],"names":[],"mappings":"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"}

package/dist/src/cli/failures.d.ts

@@ -0,0 +1,26 @@
+import type { SCHEMA_VERSION } from "../core/types.js";
+export type FailureReason = "invalid_usage" | "scan_failed" | "scope_unavailable" | "target_not_found" | "unsupported_target";
+export declare const EXIT_INVALID_USAGE = 2;
+export declare const EXIT_SCAN_FAILED = 1;
+export declare const EXIT_GATE_FAILED = 3;
+export declare const HELP_COMMAND = "legend-doctor --help";
+export interface CliFailure {
+    message: string;
+    next?: readonly string[];
+    reason: FailureReason;
+    schemaVersion: typeof SCHEMA_VERSION;
+    status: "error";
+}
+export interface CliErrorOptions {
+    readonly exitCode: number;
+    /** Commands the user can run next, printed after the message. */
+    readonly next?: readonly string[];
+    readonly reason: FailureReason;
+}
+export declare class CliError extends Error {
+    readonly exitCode: number;
+    readonly next: readonly string[];
+    readonly reason: FailureReason;
+    constructor(message: string, { exitCode, next, reason }: CliErrorOptions);
+}
+//# sourceMappingURL=failures.d.ts.map

package/dist/src/cli/failures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"failures.d.ts","sourceRoot":"","sources":["../../../src/cli/failures.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEvD,MAAM,MAAM,aAAa,GACrB,eAAe,GACf,aAAa,GACb,mBAAmB,GACnB,kBAAkB,GAClB,oBAAoB,CAAC;AAEzB,eAAO,MAAM,kBAAkB,IAAI,CAAC;AAEpC,eAAO,MAAM,gBAAgB,IAAI,CAAC;AAElC,eAAO,MAAM,gBAAgB,IAAI,CAAC;AAElC,eAAO,MAAM,YAAY,yBAAyB,CAAC;AAEnD,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACzB,MAAM,EAAE,aAAa,CAAC;IACtB,aAAa,EAAE,OAAO,cAAc,CAAC;IACrC,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,iEAAiE;IACjE,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;CAChC;AAED,qBAAa,QAAS,SAAQ,KAAK;IACjC,SAAgB,QAAQ,EAAE,MAAM,CAAC;IACjC,SAAgB,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,SAAgB,MAAM,EAAE,aAAa,CAAC;gBAEnB,OAAO,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,IAAS,EAAE,MAAM,EAAE,EAAE,eAAe;CAOrF"}

package/dist/src/cli/failures.js

@@ -0,0 +1,17 @@
+export const EXIT_INVALID_USAGE = 2;
+export const EXIT_SCAN_FAILED = 1;
+export const EXIT_GATE_FAILED = 3;
+export const HELP_COMMAND = "legend-doctor --help";
+export class CliError extends Error {
+    exitCode;
+    next;
+    reason;
+    constructor(message, { exitCode, next = [], reason }) {
+        super(message);
+        this.name = "CliError";
+        this.reason = reason;
+        this.exitCode = exitCode;
+        this.next = next;
+    }
+}
+//# sourceMappingURL=failures.js.map

package/dist/src/cli/failures.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"failures.js","sourceRoot":"","sources":["../../../src/cli/failures.ts"],"names":[],"mappings":"AASA,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC;AAEpC,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC;AAElC,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC;AAElC,MAAM,CAAC,MAAM,YAAY,GAAG,sBAAsB,CAAC;AAiBnD,MAAM,OAAO,QAAS,SAAQ,KAAK;IACjB,QAAQ,CAAS;IACjB,IAAI,CAAoB;IACxB,MAAM,CAAgB;IAEtC,YAAmB,OAAe,EAAE,EAAE,QAAQ,EAAE,IAAI,GAAG,EAAE,EAAE,MAAM,EAAmB;QAClF,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;QACvB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF"}

package/dist/src/cli/help.d.ts

@@ -0,0 +1,2 @@
+export declare const HELP = "legend-doctor \u2014 read-only React hook and Legend State triage for coding agents\n\nUsage\n  legend-doctor [<target>] [flags]\n\nExamples\n  legend-doctor src --actionable\n      Scan before editing: one JSON entry per edit, keep findings hidden\n  legend-doctor src --disposition change\n      Proven edits only, ready to apply mechanically\n  legend-doctor src --disposition candidate\n      Opportunities that need the agent to read the named source first\n  legend-doctor src --fail-on change\n      CI gate: exit 3 when any shown finding still has a proven edit\n  legend-doctor src --coverage\n      Add parsed files, functions, diagnostics, and skipped stages\n  legend-doctor src --actionable --changed\n      Report only files with uncommitted work; proofs still see the whole root\n  legend-doctor src --since origin/main\n      Report only files touched on this branch, including uncommitted work\n\nTarget\n  <target>  File or directory to scan (default: current directory)\n            Scan the smallest complete root that contains the relevant\n            components, hooks, imports, re-exports, and observables; a\n            single-file scan can hide the proof a safe finding needs.\n            Files must be .ts, .tsx, .js, .jsx, .mts, .cts, .mjs, or .cjs.\n            Directories named .git, .next, .turbo, build, coverage, dist,\n            node_modules, and vendor are skipped. Stdin is not read.\n\nFlags\n  --actionable              Hide keep findings and secondary members of\n                            finding groups, leaving one entry per edit\n  --disposition <value>     Show only findings with this disposition\n                            (candidate | change | keep | style)\n  --fail-on <value,...>     Exit 3 when any shown finding or practice has one\n                            of these dispositions; applied after filters\n  --ignore-action <a,...>   Hide findings and practices with these action names\n                            (for example use-ref,toggle-observable); hidden\n                            counts include them; repeatable. Project defaults\n                            live in the nearest legend-doctor.config.json at or\n                            above the target: { \"ignoreActions\": [...],\n                            \"materiality\": \"broad\" | \"compact\" }; flags win\n  --materiality <tier>      broad (default) proves cuts only in owners with\n                            12+ JSX elements; compact lowers the bar to 8 and\n                            tags those findings with materiality: compact\n  --changed                 Analyze only files with uncommitted changes (staged,\n                            unstaged, or untracked) relative to HEAD\n  --staged                  Analyze only files in the git index, at their\n                            working-tree content\n  --since <ref>             Analyze only files changed since the merge base\n                            with <ref>, plus uncommitted work\n                            Scope flags need a directory target inside a git\n                            work tree, and at most one may be set. Every file\n                            under the target still loads, so cross-file proofs\n                            for the selected files stay complete.\n  --answer <id>=<yes|no>    Record an answer to an open review question with\n                            its current fingerprint, then report the scan that\n                            honours it; repeatable\n  --note <text>             Justification stored with every --answer this run\n  --confirm <file>          Honour answered review questions from a JSON file;\n                            without it, <root>/.legend-doctor/confirmations.json\n                            is used when present\n  --coverage                Add coverage and diagnostics to the JSON report\n  -h, --help                Show this help\n  -v, --version             Print the version\n\nOutput\n  Stdout is one JSON document, on success and on failure alike, and nothing\n  is written to stderr.\n\nJSON contract (schemaVersion 3)\n  A completed scan is the report object with:\n    status          \"ok\"\n    root            directory every location.file is relative to\n    analyzer        { version, build }; build digests the compiled analyzer,\n                    so two reports compare only when it matches\n    files, hooks    scan size; under a scope flag, files counts the analyzed\n                    subset and scope { mode, ref?, contextFiles } names the\n                    flag and how many files loaded for cross-file proofs\n    capabilities    { legendState, reactCompiler, disabledRules }: the\n                    installed @legendapp/state (version, useValue export, and\n                    sync export) or null, whether the root enables the React\n                    Compiler, and the rules those facts switched off, each\n                    with a stable reason and the number of files that skipped\n                    it\n    findings        useState and useEffect findings; every review-state and\n                    review-effect finding carries one stable, kebab-case\n                    abstentionReason naming its primary blocker or constraint.\n                    A review-state finding whose blocker is one confirmable\n                    fact (or two, listed in facts) also carries assumption\n                    { id, facts, fingerprint, question, ifConfirmed, research,\n                    renderCost, updateSites, status }:\n                    read every research step (file, line, check), answer the\n                    yes/no question, and a confirmed id turns the finding into\n                    ifConfirmed\n                    A review-effect finding whose verdict waits on a state\n                    lists that state's question ids in waitsOn instead\n                    A finding a confirmation converted carries verification\n                    { harness, steps, expect }: the jsdom recipe that checks it\n    questions       open review questions ranked by expected render saving\n                    (renderCost \u00D7 update sites), each with id, file, line\n    confirmations   { applied, rejected, stale, unmatched, source } when\n                    answers were read\n    practices       Legend State practice findings\n    hidden          { findings, practices } removed by --actionable or\n                    --disposition, so an empty list is not a clean scan\n    gate            { failOn, matched } when --fail-on is set\n    coverage,       present only with --coverage\n    diagnostics\n  A failure is { status: \"error\", reason, message, next? } where reason is:\n    invalid_usage       bad flag or value; nothing was scanned      exit 2\n    unsupported_target  file target is not a scannable source file  exit 2\n    target_not_found    the target path does not exist              exit 1\n    scope_unavailable   a scope flag ran outside a git work tree,\n                        without git, or with an unknown --since ref  exit 1\n    scan_failed         analysis could not complete                 exit 1\n\nDispositions\n  change     Apply the instruction; structural proof is complete\n  candidate  Inspect the named source; resolve the missing timing,\n             ownership, or type fact before editing\n  keep       Preserve the current React or lifecycle boundary\n  style      Apply only when the installed Legend State API supports the form\n\nAgent loop\n  1. Scan before editing:  legend-doctor <root> --actionable\n  2. Apply one group of change findings; inspect candidates against source\n  3. Run the application's formatter, typecheck, and relevant tests\n  4. Scan the same root again and report the finding delta, including zero\n\nConfirmations\n  Write answers as { \"confirmations\": [{ \"id\", \"answer\": \"yes\" | \"no\",\n  \"fingerprint\", \"note\"? }] } to <root>/.legend-doctor/confirmations.json, or\n  pass any file with --confirm. Ids are stable across line shifts (file,\n  owner, state name, blocker). Copy the fingerprint from the question: when\n  the owner changes, the answer is reported stale and the question is asked\n  again instead of silently applied. \"yes\" converts the finding with the\n  assumption recorded in its evidence; \"no\" keeps it under review and stops\n  the question. Work through report.questions in rank order.\n\nSuppression\n  Precede a deliberate React effect with `// legend-doctor keep-react-effect`\n  to suppress its review-effect finding.\n\nExit codes\n  0  scan completed; the report may contain zero or more findings\n  1  the scan failed (missing target, analysis error)\n  2  invalid usage; nothing was scanned\n  3  scan completed and a shown finding matched --fail-on\n";
+//# sourceMappingURL=help.d.ts.map

package/dist/src/cli/help.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../../../src/cli/help.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,IAAI,mnRAsJhB,CAAC"}

package/dist/src/cli/help.js

@@ -0,0 +1,152 @@
+export const HELP = `legend-doctor — read-only React hook and Legend State triage for coding agents
+
+Usage
+  legend-doctor [<target>] [flags]
+
+Examples
+  legend-doctor src --actionable
+      Scan before editing: one JSON entry per edit, keep findings hidden
+  legend-doctor src --disposition change
+      Proven edits only, ready to apply mechanically
+  legend-doctor src --disposition candidate
+      Opportunities that need the agent to read the named source first
+  legend-doctor src --fail-on change
+      CI gate: exit 3 when any shown finding still has a proven edit
+  legend-doctor src --coverage
+      Add parsed files, functions, diagnostics, and skipped stages
+  legend-doctor src --actionable --changed
+      Report only files with uncommitted work; proofs still see the whole root
+  legend-doctor src --since origin/main
+      Report only files touched on this branch, including uncommitted work
+
+Target
+  <target>  File or directory to scan (default: current directory)
+            Scan the smallest complete root that contains the relevant
+            components, hooks, imports, re-exports, and observables; a
+            single-file scan can hide the proof a safe finding needs.
+            Files must be .ts, .tsx, .js, .jsx, .mts, .cts, .mjs, or .cjs.
+            Directories named .git, .next, .turbo, build, coverage, dist,
+            node_modules, and vendor are skipped. Stdin is not read.
+
+Flags
+  --actionable              Hide keep findings and secondary members of
+                            finding groups, leaving one entry per edit
+  --disposition <value>     Show only findings with this disposition
+                            (candidate | change | keep | style)
+  --fail-on <value,...>     Exit 3 when any shown finding or practice has one
+                            of these dispositions; applied after filters
+  --ignore-action <a,...>   Hide findings and practices with these action names
+                            (for example use-ref,toggle-observable); hidden
+                            counts include them; repeatable. Project defaults
+                            live in the nearest legend-doctor.config.json at or
+                            above the target: { "ignoreActions": [...],
+                            "materiality": "broad" | "compact" }; flags win
+  --materiality <tier>      broad (default) proves cuts only in owners with
+                            12+ JSX elements; compact lowers the bar to 8 and
+                            tags those findings with materiality: compact
+  --changed                 Analyze only files with uncommitted changes (staged,
+                            unstaged, or untracked) relative to HEAD
+  --staged                  Analyze only files in the git index, at their
+                            working-tree content
+  --since <ref>             Analyze only files changed since the merge base
+                            with <ref>, plus uncommitted work
+                            Scope flags need a directory target inside a git
+                            work tree, and at most one may be set. Every file
+                            under the target still loads, so cross-file proofs
+                            for the selected files stay complete.
+  --answer <id>=<yes|no>    Record an answer to an open review question with
+                            its current fingerprint, then report the scan that
+                            honours it; repeatable
+  --note <text>             Justification stored with every --answer this run
+  --confirm <file>          Honour answered review questions from a JSON file;
+                            without it, <root>/.legend-doctor/confirmations.json
+                            is used when present
+  --coverage                Add coverage and diagnostics to the JSON report
+  -h, --help                Show this help
+  -v, --version             Print the version
+
+Output
+  Stdout is one JSON document, on success and on failure alike, and nothing
+  is written to stderr.
+
+JSON contract (schemaVersion 3)
+  A completed scan is the report object with:
+    status          "ok"
+    root            directory every location.file is relative to
+    analyzer        { version, build }; build digests the compiled analyzer,
+                    so two reports compare only when it matches
+    files, hooks    scan size; under a scope flag, files counts the analyzed
+                    subset and scope { mode, ref?, contextFiles } names the
+                    flag and how many files loaded for cross-file proofs
+    capabilities    { legendState, reactCompiler, disabledRules }: the
+                    installed @legendapp/state (version, useValue export, and
+                    sync export) or null, whether the root enables the React
+                    Compiler, and the rules those facts switched off, each
+                    with a stable reason and the number of files that skipped
+                    it
+    findings        useState and useEffect findings; every review-state and
+                    review-effect finding carries one stable, kebab-case
+                    abstentionReason naming its primary blocker or constraint.
+                    A review-state finding whose blocker is one confirmable
+                    fact (or two, listed in facts) also carries assumption
+                    { id, facts, fingerprint, question, ifConfirmed, research,
+                    renderCost, updateSites, status }:
+                    read every research step (file, line, check), answer the
+                    yes/no question, and a confirmed id turns the finding into
+                    ifConfirmed
+                    A review-effect finding whose verdict waits on a state
+                    lists that state's question ids in waitsOn instead
+                    A finding a confirmation converted carries verification
+                    { harness, steps, expect }: the jsdom recipe that checks it
+    questions       open review questions ranked by expected render saving
+                    (renderCost × update sites), each with id, file, line
+    confirmations   { applied, rejected, stale, unmatched, source } when
+                    answers were read
+    practices       Legend State practice findings
+    hidden          { findings, practices } removed by --actionable or
+                    --disposition, so an empty list is not a clean scan
+    gate            { failOn, matched } when --fail-on is set
+    coverage,       present only with --coverage
+    diagnostics
+  A failure is { status: "error", reason, message, next? } where reason is:
+    invalid_usage       bad flag or value; nothing was scanned      exit 2
+    unsupported_target  file target is not a scannable source file  exit 2
+    target_not_found    the target path does not exist              exit 1
+    scope_unavailable   a scope flag ran outside a git work tree,
+                        without git, or with an unknown --since ref  exit 1
+    scan_failed         analysis could not complete                 exit 1
+
+Dispositions
+  change     Apply the instruction; structural proof is complete
+  candidate  Inspect the named source; resolve the missing timing,
+             ownership, or type fact before editing
+  keep       Preserve the current React or lifecycle boundary
+  style      Apply only when the installed Legend State API supports the form
+
+Agent loop
+  1. Scan before editing:  legend-doctor <root> --actionable
+  2. Apply one group of change findings; inspect candidates against source
+  3. Run the application's formatter, typecheck, and relevant tests
+  4. Scan the same root again and report the finding delta, including zero
+
+Confirmations
+  Write answers as { "confirmations": [{ "id", "answer": "yes" | "no",
+  "fingerprint", "note"? }] } to <root>/.legend-doctor/confirmations.json, or
+  pass any file with --confirm. Ids are stable across line shifts (file,
+  owner, state name, blocker). Copy the fingerprint from the question: when
+  the owner changes, the answer is reported stale and the question is asked
+  again instead of silently applied. "yes" converts the finding with the
+  assumption recorded in its evidence; "no" keeps it under review and stops
+  the question. Work through report.questions in rank order.
+
+Suppression
+  Precede a deliberate React effect with \`// legend-doctor keep-react-effect\`
+  to suppress its review-effect finding.
+
+Exit codes
+  0  scan completed; the report may contain zero or more findings
+  1  the scan failed (missing target, analysis error)
+  2  invalid usage; nothing was scanned
+  3  scan completed and a shown finding matched --fail-on
+`;
+//# sourceMappingURL=help.js.map

package/dist/src/cli/help.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.js","sourceRoot":"","sources":["../../../src/cli/help.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,IAAI,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsJnB,CAAC"}

package/dist/src/cli/options.d.ts

@@ -0,0 +1,35 @@
+import type { HookAction, HookFinding, LegendPracticeAction, LegendPracticeFinding } from "../core/types.js";
+import type { MaterialityTier } from "../analysis/constants.js";
+import type { RecordedAnswer } from "./record-answers.js";
+import type { ScanScope } from "../project/git-scope.js";
+export type Disposition = HookFinding["disposition"] | LegendPracticeFinding["disposition"];
+export type Action = HookAction | LegendPracticeAction;
+export interface CliOptions {
+    actionable: boolean;
+    /** Answers to record before the reported scan, each `<id>=<yes|no>`; repeatable. */
+    answers: RecordedAnswer[];
+    changed: boolean;
+    /** Path of a confirmations file whose answered review questions the scan honours. */
+    confirm: string | null;
+    coverage: boolean;
+    disposition: Disposition | null;
+    failOn: readonly Disposition[];
+    help: boolean;
+    /** Actions removed from the report; counted under `hidden`. */
+    ignoreActions: readonly Action[];
+    /** The tier the flag selected, or null to fall back to the config file and then `broad`. */
+    materiality: MaterialityTier | null;
+    /** Free-text justification stored with every answer recorded in this run. */
+    note: string | null;
+    since: string | null;
+    staged: boolean;
+    target: string | null;
+    version: boolean;
+}
+/** The git scope the flags select, or null for a full scan of the target. */
+export declare function scanScope(options: CliOptions): ScanScope | null;
+export declare function scanScopeFlag(scope: ScanScope): string;
+export declare function parseArguments(args: readonly string[]): CliOptions;
+export declare function isAction(value: string): value is Action;
+export declare function isMaterialityTier(value: string): value is MaterialityTier;
+//# sourceMappingURL=options.d.ts.map

package/dist/src/cli/options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../../../src/cli/options.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EACV,WAAW,EACX,oBAAoB,EACpB,qBAAqB,EACtB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAGzD,MAAM,MAAM,WAAW,GAAG,WAAW,CAAC,aAAa,CAAC,GAAG,qBAAqB,CAAC,aAAa,CAAC,CAAC;AAE5F,MAAM,MAAM,MAAM,GAAG,UAAU,GAAG,oBAAoB,CAAC;AAyFvD,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,OAAO,CAAC;IACpB,oFAAoF;IACpF,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,qFAAqF;IACrF,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,EAAE,WAAW,GAAG,IAAI,CAAC;IAChC,MAAM,EAAE,SAAS,WAAW,EAAE,CAAC;IAC/B,IAAI,EAAE,OAAO,CAAC;IACd,+DAA+D;IAC/D,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,4FAA4F;IAC5F,WAAW,EAAE,eAAe,GAAG,IAAI,CAAC;IACpC,6EAA6E;IAC7E,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,OAAO,EAAE,OAAO,CAAC;CAClB;AAsBD,6EAA6E;AAC7E,wBAAgB,SAAS,CAAC,OAAO,EAAE,UAAU,GAAG,SAAS,GAAG,IAAI,CAQ/D;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CAEtD;AA+GD,wBAAgB,cAAc,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,UAAU,CAgBlE;AAmDD,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,MAAM,CAEvD;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,eAAe,CAEzE"}