@descent-vtt/spec-graph 0.2.0

package/dist/cli.js

@@ -0,0 +1,565 @@
+/**
+ * The command line.
+ *
+ * Four verbs, because there are four questions worth asking of a specification
+ * graph: is it consistent (`check`), what does it contain (`query`), what does
+ * it look like (`graph`), and what will you check for me (`rules`).
+ *
+ * Exit codes are the contract with CI: `0` clean, `1` findings, `2` the tool
+ * itself could not run. A usage mistake never masquerades as a passing build.
+ */
+import { applyBaseline, EMPTY_BASELINE, formatBaseline, parseBaseline } from './baseline.js';
+import { loadConfig } from './config.js';
+import { underRoot } from './glob.js';
+import { analyse, DEFAULT_PATTERNS, withDiagnostics } from './runner.js';
+import { formatGraph, formatJson, formatReport, shouldUseAscii, shouldUseColor } from './report.js';
+import { DEFAULT_SEVERITIES, resolveStrict, RULE_DESCRIPTIONS, RULE_IDS, RULE_QUERIES } from './rules.js';
+import { formatRef } from './source.js';
+import { execute, parseQuery, QueryError, renderMatch } from './select.js';
+export const EXIT_OK = 0;
+export const EXIT_FAILED = 1;
+export const EXIT_ERROR = 2;
+export class UsageError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'UsageError';
+    }
+}
+export const HELP = `spec-graph - turn Markdown specifications into a verifiable graph
+
+USAGE
+  spec-graph [check] [patterns...] [options]
+  spec-graph query <selector> [patterns...] [options]
+  spec-graph graph [patterns...] [--graph-format dot|mermaid|json]
+  spec-graph rules [--explain]
+
+COMMANDS
+  check     Validate the specification graph. The default.
+  query     Run a selector and print the matching paths.
+  graph     Export the graph for Graphviz, Mermaid, or another tool.
+  rules     List the built-in diagnostics.
+
+OPTIONS
+  --root <dir>            Directory the patterns resolve against (default: cwd)
+  --ignore <glob>         Skip paths. Repeatable.
+  --ignore-ref <glob>     Do not report these reference targets when they fail
+                          to resolve, for repositories where [[...]] tags a
+                          concept rather than naming a file. Repeatable.
+                          Suppresses findings only, never edges.
+  --family <name>         Families a bare identifier in prose may name. When
+                          given, everything else stays prose. Repeatable.
+  --ignore-family <name>  Families that are never citations - RFC when the repo
+                          cites RFC 2119 and keeps its own RFCs. Repeatable.
+  --history <glob>        Files that log what was decided rather than deciding
+                          it - journals, changelogs, minutes. Their links are
+                          still checked; their obligations are not. Repeatable.
+  --baseline <file>       Accept the findings recorded in this file and report
+                          only what is new since. Missing file = accept nothing.
+  --record-baseline <f>   Write today's findings to this file as accepted debt,
+                          and exit 0 without judging them.
+  --no-config             Ignore .spec-graph.json and the package.json key.
+  --format human|json     Report format (default: human)
+  --graph-format <fmt>    dot, mermaid or json (default: dot)
+  --documents-only        Leave items out of the exported graph
+  --rule <id>=<severity>  Override one rule: error, warn, info or off. Repeatable.
+  --max <n>               Show at most n findings (0 = no limit)
+  --max-warnings <n>      Fail when warnings exceed n (default: no limit)
+  --strict                Raise every warning to an error. An explicit --rule
+                          still wins, so --strict --rule x=warn exempts x.
+  --color / --no-color    Force colour on or off
+  --ascii                 Use ASCII glyphs only
+  --verbose               Include parse problems and per-file detail
+  -h, --help              Show this help
+  -v, --version           Show the version
+
+SELECTORS
+  A selector is a path through the graph.
+
+    item[openness=open] -delegates-to-> document[phase=retired]
+    document[phase=active] -assumes-> document[phase=retired]
+    document =supersedes=> document
+    *[path^=docs/adr] -contains-> item[state=accepted-debt]
+
+  Node types:  document, item, * (any)
+  Attributes:  id, kind, title, path, file, line, phase, status, receptivity,
+               alias, document, state (or disposition), openness, section,
+               text, body, evidence, conflicted, fm.<front-matter-key>
+  Operators:   = != ^= $= *= ~=   and [attr] for "is present"
+  Relations:   -kind->  <-kind-   =kind=>  <=kind=   (= forms are transitive)
+
+EXIT CODES
+  0  clean
+  1  findings at error severity (or over --max-warnings)
+  2  the tool could not run
+
+CONFIGURATION
+  Anything repeated on every run belongs in the repository rather than in the
+  command. spec-graph reads the first of these that exists:
+
+    .spec-graph.json, spec-graph.config.json, or a "spec-graph" key in
+    package.json
+
+    { "patterns": ["docs/**/*.md"],
+      "ignoreReferences": ["trap *"],
+      "ignoreFamilies": ["RFC"],
+      "historyPatterns": ["**/JOURNAL_*.md", "archive/**"],
+      "baseline": ".spec-graph-baseline.json",
+      "severities": { "self-reference": "off" },
+      "strict": true }
+
+  A flag always wins over the file, and list flags add to it rather than
+  replacing it.
+
+ADOPTING THIS ON AN OLD REPOSITORY
+  Record what is already wrong, then report only what happens next:
+
+    spec-graph check --record-baseline .spec-graph-baseline.json
+    git add .spec-graph-baseline.json
+
+  The file is keyed by specification and citation, not by line number, so it
+  survives edits, moves and renames. Findings that stop occurring are reported
+  so the file can be tightened; nothing new gets in.
+
+EXAMPLES
+  spec-graph "docs/**/*.md"
+  spec-graph check --rule self-reference=off --format json
+  spec-graph query 'item[openness=open] -delegates-to-> document[phase=retired]'
+  spec-graph check --ignore-ref "trap *"    # [[trap 55]] tags a concept, not a file
+  spec-graph graph --documents-only --graph-format mermaid > graph.mmd
+  spec-graph check --history "**/JOURNAL_*.md"   # a log is not a specification
+  spec-graph check --baseline .spec-graph-baseline.json
+`;
+const SEVERITIES = ['error', 'warn', 'info', 'off'];
+/** Parses argv into options. Throws {@link UsageError} on anything malformed. */
+export function parseArgs(argv, cwd) {
+    const args = [...argv];
+    let command = 'check';
+    if (args.length > 0 && !(args[0].startsWith('-'))) {
+        const first = args[0];
+        if (first === 'check' || first === 'query' || first === 'graph' || first === 'rules') {
+            command = first;
+            args.shift();
+        }
+    }
+    const patterns = [];
+    const ignore = [];
+    const ignoreReferences = [];
+    const families = [];
+    const ignoreFamilies = [];
+    const historyPatterns = [];
+    let noConfig = false;
+    const severities = {};
+    let root = cwd;
+    let format = 'human';
+    let graphFormat = 'dot';
+    let color = null;
+    let ascii = null;
+    let verbose = false;
+    let documentsOnly = false;
+    let max = 0;
+    let maxWarnings = -1;
+    let strict = false;
+    let baseline = null;
+    let recordBaseline = null;
+    let selector = null;
+    let help = false;
+    let version = false;
+    const next = (flag, index) => {
+        const value = args[index + 1];
+        if (value === undefined)
+            throw new UsageError(`${flag} needs a value`);
+        return value;
+    };
+    for (let i = 0; i < args.length; i += 1) {
+        const arg = args[i];
+        if (arg === '--') {
+            patterns.push(...args.slice(i + 1));
+            break;
+        }
+        if (!arg.startsWith('-')) {
+            if (command === 'query' && selector === null)
+                selector = arg;
+            else
+                patterns.push(arg);
+            continue;
+        }
+        switch (arg) {
+            case '-h':
+            case '--help':
+                help = true;
+                break;
+            case '-v':
+            case '--version':
+                version = true;
+                break;
+            case '--verbose':
+                verbose = true;
+                break;
+            case '--color':
+                color = true;
+                break;
+            case '--no-color':
+                color = false;
+                break;
+            case '--ascii':
+                ascii = true;
+                break;
+            case '--documents-only':
+                documentsOnly = true;
+                break;
+            case '--strict':
+                strict = true;
+                break;
+            case '--explain':
+                verbose = true;
+                break;
+            case '--root':
+                root = next(arg, i);
+                i += 1;
+                break;
+            case '--ignore':
+                ignore.push(next(arg, i));
+                i += 1;
+                break;
+            case '--ignore-ref':
+                ignoreReferences.push(next(arg, i));
+                i += 1;
+                break;
+            case '--family':
+                families.push(next(arg, i));
+                i += 1;
+                break;
+            case '--ignore-family':
+                ignoreFamilies.push(next(arg, i));
+                i += 1;
+                break;
+            case '--history':
+                historyPatterns.push(next(arg, i));
+                i += 1;
+                break;
+            case '--baseline':
+                baseline = next(arg, i);
+                i += 1;
+                break;
+            case '--record-baseline':
+                recordBaseline = next(arg, i);
+                i += 1;
+                break;
+            case '--no-config':
+                noConfig = true;
+                break;
+            case '--format': {
+                const value = next(arg, i);
+                if (value !== 'human' && value !== 'json') {
+                    throw new UsageError(`--format must be human or json, got "${value}"`);
+                }
+                format = value;
+                i += 1;
+                break;
+            }
+            case '--graph-format': {
+                const value = next(arg, i);
+                if (value !== 'dot' && value !== 'mermaid' && value !== 'json') {
+                    throw new UsageError(`--graph-format must be dot, mermaid or json, got "${value}"`);
+                }
+                graphFormat = value;
+                i += 1;
+                break;
+            }
+            case '--rule': {
+                const value = next(arg, i);
+                const equals = value.indexOf('=');
+                if (equals === -1)
+                    throw new UsageError(`--rule expects <id>=<severity>, got "${value}"`);
+                const id = value.slice(0, equals);
+                const level = value.slice(equals + 1);
+                if (!RULE_IDS.includes(id)) {
+                    throw new UsageError(`unknown rule "${id}"\n  known rules: ${RULE_IDS.join(', ')}`);
+                }
+                if (!SEVERITIES.includes(level)) {
+                    throw new UsageError(`unknown severity "${level}", expected one of: ${SEVERITIES.join(', ')}`);
+                }
+                severities[id] = level;
+                i += 1;
+                break;
+            }
+            case '--max': {
+                max = parseCount(arg, next(arg, i));
+                i += 1;
+                break;
+            }
+            case '--max-warnings': {
+                maxWarnings = parseCount(arg, next(arg, i));
+                i += 1;
+                break;
+            }
+            default:
+                throw new UsageError(`unknown option "${arg}"\n  run "spec-graph --help" to see the available options`);
+        }
+    }
+    if (command === 'query' && selector === null && !help && !version) {
+        throw new UsageError('query needs a selector, for example:\n  spec-graph query \'item[openness=open]\'');
+    }
+    return {
+        command,
+        patterns,
+        root,
+        ignore,
+        ignoreReferences,
+        families,
+        ignoreFamilies,
+        historyPatterns,
+        baseline,
+        recordBaseline,
+        noConfig,
+        format,
+        graphFormat,
+        severities,
+        color,
+        ascii,
+        verbose,
+        documentsOnly,
+        max,
+        maxWarnings,
+        strict,
+        selector,
+        help,
+        version,
+    };
+}
+function count(n, word, many) {
+    return `${n} ${n === 1 ? word : (many ?? `${word}s`)}`;
+}
+/**
+ * Reads a baseline file.
+ *
+ * A missing file is not an error: `--baseline` against a repository that has
+ * not recorded one yet should report everything, which is exactly what an empty
+ * baseline does.
+ */
+async function readBaseline(path, source) {
+    let raw;
+    try {
+        const { readFile } = await import('node:fs/promises');
+        raw = await readFile(path, 'utf8');
+    }
+    catch {
+        return { baseline: EMPTY_BASELINE, problems: [] };
+    }
+    return parseBaseline(raw, source);
+}
+function parseCount(flag, value) {
+    const parsed = Number.parseInt(value, 10);
+    if (!Number.isFinite(parsed) || parsed < 0 || String(parsed) !== value.trim()) {
+        throw new UsageError(`${flag} expects a non-negative whole number, got "${value}"`);
+    }
+    return parsed;
+}
+/* -------------------------------------------------------------------------- */
+/* Entry point                                                                */
+/* -------------------------------------------------------------------------- */
+/** Runs the CLI and returns the process exit code. Never throws. */
+export async function main(io = {}) {
+    const argv = io.argv ?? process.argv.slice(2);
+    const cwd = io.cwd ?? process.cwd();
+    const out = io.stdout ?? ((text) => process.stdout.write(text));
+    const err = io.stderr ?? ((text) => process.stderr.write(text));
+    const env = io.env ?? process.env;
+    let options;
+    try {
+        options = parseArgs(argv, cwd);
+    }
+    catch (error) {
+        if (error instanceof UsageError) {
+            err(`spec-graph: ${error.message}\n`);
+            return EXIT_ERROR;
+        }
+        throw error;
+    }
+    if (options.help) {
+        out(HELP);
+        return EXIT_OK;
+    }
+    if (options.version) {
+        out(`${await readVersion()}\n`);
+        return EXIT_OK;
+    }
+    const color = options.color ?? shouldUseColor({ isTTY: io.isTTY, env });
+    const ascii = options.ascii ?? shouldUseAscii({ env });
+    if (options.command === 'rules') {
+        out(renderRules(options.verbose));
+        return EXIT_OK;
+    }
+    // Configuration is what is true of the repository; a flag is somebody
+    // overriding it for one run. So a flag always wins, and lists add rather than
+    // replace - a `--ignore-ref` on the command line is one more exclusion, not a
+    // decision to throw away the ones the repository already declared.
+    const loaded = options.noConfig ? { config: {}, source: null, problems: [] } : loadConfig(options.root);
+    for (const problem of loaded.problems)
+        err(`spec-graph: ${problem}\n`);
+    const file = loaded.config;
+    const patterns = options.patterns.length > 0 ? options.patterns : (file.patterns ?? DEFAULT_PATTERNS);
+    const severityOverrides = { ...(file.severities ?? {}), ...options.severities };
+    const { severities, escalated } = resolveStrict(severityOverrides, options.strict || (file.strict ?? false));
+    const analyseOptions = {
+        root: options.root,
+        patterns,
+        ignore: [...(file.ignore ?? []), ...options.ignore],
+        ignoreReferences: [...(file.ignoreReferences ?? []), ...options.ignoreReferences],
+        families: [...(file.families ?? []), ...options.families],
+        ignoreFamilies: [...(file.ignoreFamilies ?? []), ...options.ignoreFamilies],
+        historyPatterns: [...(file.historyPatterns ?? []), ...options.historyPatterns],
+        severities,
+        ...(file.maxRelated !== undefined ? { maxRelated: file.maxRelated } : {}),
+    };
+    if (options.verbose && loaded.source !== null)
+        out(`configuration: ${loaded.source}\n`);
+    let result;
+    try {
+        result = await analyse(analyseOptions);
+    }
+    catch (error) {
+        err(`spec-graph: ${error.message}\n`);
+        return EXIT_ERROR;
+    }
+    if (result.files.length === 0) {
+        err(`spec-graph: no specifications matched ${options.patterns.length > 0 ? options.patterns.map((p) => `"${p}"`).join(', ') : 'the default patterns'}\n  looked under ${options.root}\n`);
+        return EXIT_ERROR;
+    }
+    switch (options.command) {
+        case 'graph':
+            out(formatGraph(result.graph, options.graphFormat, { documentsOnly: options.documentsOnly }));
+            return EXIT_OK;
+        case 'query': {
+            try {
+                const matches = execute(result.graph, parseQuery(options.selector));
+                out(renderMatches(matches, options.format, result.graph.nodes.size));
+                return matches.length > 0 ? EXIT_OK : EXIT_FAILED;
+            }
+            catch (error) {
+                if (error instanceof QueryError) {
+                    err(renderQueryError(options.selector, error));
+                    return EXIT_ERROR;
+                }
+                throw error;
+            }
+        }
+        default: {
+            // Recording is not checking. It writes down what is wrong today so that
+            // tomorrow can be compared against it, and says nothing about whether
+            // today is acceptable - so it reports what it wrote and exits clean.
+            if (options.recordBaseline !== null) {
+                const text = formatBaseline(result.graph, result.diagnostics);
+                try {
+                    const { writeFile } = await import('node:fs/promises');
+                    await writeFile(underRoot(options.root, options.recordBaseline), text, 'utf8');
+                }
+                catch (error) {
+                    err(`spec-graph: cannot write ${options.recordBaseline}: ${error.message}\n`);
+                    return EXIT_ERROR;
+                }
+                const entries = JSON.parse(text).findings.length;
+                out(`recorded ${count(result.diagnostics.length, 'finding')} as ${count(entries, 'entry', 'entries')} in ${options.recordBaseline}\n`);
+                return EXIT_OK;
+            }
+            const source = options.baseline ?? file.baseline ?? null;
+            let reported = result;
+            let note;
+            if (source !== null) {
+                const held = await readBaseline(underRoot(options.root, source), source);
+                for (const problem of held.problems)
+                    err(`spec-graph: ${problem}\n`);
+                const outcome = applyBaseline(result.graph, result.diagnostics, held.baseline);
+                reported = withDiagnostics(result, outcome.kept);
+                note = { source, suppressed: outcome.suppressed, stale: outcome.stale.length };
+                if (options.verbose) {
+                    for (const entry of outcome.stale) {
+                        out(`  paid: ${entry.rule} ${entry.document}${entry.subject === '' ? '' : ` "${entry.subject}"`}\n`);
+                    }
+                }
+            }
+            const baselineNote = note === undefined ? {} : { baseline: note };
+            out(options.format === 'json'
+                ? formatJson(reported, { escalated, ...baselineNote })
+                : `${formatReport(reported, { color, ascii, verbose: options.verbose, max: options.max, escalated, ...baselineNote })}\n`);
+            if (!reported.ok)
+                return EXIT_FAILED;
+            if (options.maxWarnings >= 0 && reported.summary.warnings > options.maxWarnings)
+                return EXIT_FAILED;
+            return EXIT_OK;
+        }
+    }
+}
+/* -------------------------------------------------------------------------- */
+/* Rendering                                                                  */
+/* -------------------------------------------------------------------------- */
+function renderRules(explain) {
+    const width = Math.max(...RULE_IDS.map((id) => id.length));
+    const lines = [];
+    for (const id of RULE_IDS) {
+        lines.push(`${id.padEnd(width)}  ${DEFAULT_SEVERITIES[id].padEnd(5)}  ${RULE_DESCRIPTIONS[id]}`);
+        const query = RULE_QUERIES[id];
+        if (explain && query)
+            lines.push(`${' '.repeat(width)}         ${query}`);
+    }
+    return `${lines.join('\n')}\n`;
+}
+function renderMatches(matches, format, total) {
+    if (format === 'json') {
+        return `${JSON.stringify({
+            version: 1,
+            count: matches.length,
+            matches: matches.map((match) => ({
+                nodes: match.nodes.map((node) => nodeSummary(node)),
+                edges: match.edges.map((edge) => ({
+                    kind: edge.kind,
+                    from: edge.from,
+                    to: edge.to,
+                    file: edge.declaredAt.file,
+                    line: edge.declaredAt.span.start.line,
+                })),
+            })),
+        }, null, 2)}\n`;
+    }
+    if (matches.length === 0)
+        return `no matches (searched ${total} nodes)\n`;
+    const lines = [];
+    for (const match of matches) {
+        const head = match.nodes[0];
+        const tail = match.nodes[match.nodes.length - 1];
+        lines.push(renderMatch(match));
+        lines.push(`  ${formatRef(head.at)}${match.nodes.length > 1 ? `  ${formatRef(tail.at)}` : ''}`);
+    }
+    lines.push(`${matches.length} ${matches.length === 1 ? 'match' : 'matches'}`);
+    return `${lines.join('\n')}\n`;
+}
+function nodeSummary(node) {
+    return {
+        id: node.id,
+        kind: node.kind,
+        title: node.title,
+        file: node.at.file,
+        line: node.at.span.start.line,
+        ...(node.kind === 'document' ? { phase: node.phase } : { state: node.disposition, openness: node.openness }),
+    };
+}
+/** Points at the exact character of a selector that failed to parse. */
+function renderQueryError(selector, error) {
+    const caret = `${' '.repeat(Math.max(0, error.offset))}^`;
+    return `spec-graph: ${error.message}\n  ${selector}\n  ${caret}\n`;
+}
+async function readVersion() {
+    try {
+        const { readFile } = await import('node:fs/promises');
+        const url = new URL('../package.json', import.meta.url);
+        const parsed = JSON.parse(await readFile(url, 'utf8'));
+        if (typeof parsed === 'object' && parsed !== null && 'version' in parsed) {
+            return String(parsed.version);
+        }
+    }
+    catch {
+        // Fall through to the placeholder rather than failing `--version`.
+    }
+    return '0.0.0';
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * The command line.\n *\n * Four verbs, because there are four questions worth asking of a specification\n * graph: is it consistent (`check`), what does it contain (`query`), what does\n * it look like (`graph`), and what will you check for me (`rules`).\n *\n * Exit codes are the contract with CI: `0` clean, `1` findings, `2` the tool\n * itself could not run. A usage mistake never masquerades as a passing build.\n */\n\nimport { applyBaseline, EMPTY_BASELINE, formatBaseline, parseBaseline, type Baseline } from './baseline.js';\nimport { loadConfig, type SpecGraphConfig } from './config.js';\nimport { underRoot } from './glob.js';\nimport { analyse, DEFAULT_PATTERNS, withDiagnostics, type AnalyseOptions } from './runner.js';\nimport { formatGraph, formatJson, formatReport, shouldUseAscii, shouldUseColor, type GraphFormat } from './report.js';\nimport { DEFAULT_SEVERITIES, resolveStrict, RULE_DESCRIPTIONS, RULE_IDS, RULE_QUERIES } from './rules.js';\nimport { formatRef } from './source.js';\nimport { execute, parseQuery, QueryError, renderMatch, type Match } from './select.js';\nimport type { RuleId, Severity, SpecNode } from './types.js';\n\nexport const EXIT_OK = 0;\nexport const EXIT_FAILED = 1;\nexport const EXIT_ERROR = 2;\n\nexport class UsageError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = 'UsageError';\n  }\n}\n\nexport type Command = 'check' | 'query' | 'graph' | 'rules';\n\nexport interface CliOptions {\n  readonly command: Command;\n  readonly patterns: readonly string[];\n  readonly root: string;\n  readonly ignore: readonly string[];\n  /** Reference targets to leave unreported when they do not resolve. */\n  readonly ignoreReferences: readonly string[];\n  /** Families a bare identifier may name. Empty means any family in the corpus. */\n  readonly families: readonly string[];\n  /** Families that are never citations. */\n  readonly ignoreFamilies: readonly string[];\n  /** Files that log what was decided rather than deciding it. */\n  readonly historyPatterns: readonly string[];\n  /** Accepted-debt file to read. `null` means none was asked for. */\n  readonly baseline: string | null;\n  /** Where to write the current findings as accepted debt. */\n  readonly recordBaseline: string | null;\n  /** Skip the repository configuration file entirely. */\n  readonly noConfig: boolean;\n  readonly format: 'human' | 'json';\n  readonly graphFormat: GraphFormat;\n  readonly severities: Partial<Record<RuleId, Severity>>;\n  readonly color: boolean | null;\n  readonly ascii: boolean | null;\n  readonly verbose: boolean;\n  readonly documentsOnly: boolean;\n  readonly max: number;\n  readonly maxWarnings: number;\n  /** Raise every warning to an error. Explicit `--rule` overrides still win. */\n  readonly strict: boolean;\n  readonly selector: string | null;\n  readonly help: boolean;\n  readonly version: boolean;\n}\n\nexport interface CliIO {\n  readonly argv?: readonly string[] | undefined;\n  readonly cwd?: string | undefined;\n  readonly stdout?: ((text: string) => void) | undefined;\n  readonly stderr?: ((text: string) => void) | undefined;\n  readonly env?: Readonly<Record<string, string | undefined>> | undefined;\n  readonly isTTY?: boolean | undefined;\n}\n\nexport const HELP = `spec-graph - turn Markdown specifications into a verifiable graph\n\nUSAGE\n  spec-graph [check] [patterns...] [options]\n  spec-graph query <selector> [patterns...] [options]\n  spec-graph graph [patterns...] [--graph-format dot|mermaid|json]\n  spec-graph rules [--explain]\n\nCOMMANDS\n  check     Validate the specification graph. The default.\n  query     Run a selector and print the matching paths.\n  graph     Export the graph for Graphviz, Mermaid, or another tool.\n  rules     List the built-in diagnostics.\n\nOPTIONS\n  --root <dir>            Directory the patterns resolve against (default: cwd)\n  --ignore <glob>         Skip paths. Repeatable.\n  --ignore-ref <glob>     Do not report these reference targets when they fail\n                          to resolve, for repositories where [[...]] tags a\n                          concept rather than naming a file. Repeatable.\n                          Suppresses findings only, never edges.\n  --family <name>         Families a bare identifier in prose may name. When\n                          given, everything else stays prose. Repeatable.\n  --ignore-family <name>  Families that are never citations - RFC when the repo\n                          cites RFC 2119 and keeps its own RFCs. Repeatable.\n  --history <glob>        Files that log what was decided rather than deciding\n                          it - journals, changelogs, minutes. Their links are\n                          still checked; their obligations are not. Repeatable.\n  --baseline <file>       Accept the findings recorded in this file and report\n                          only what is new since. Missing file = accept nothing.\n  --record-baseline <f>   Write today's findings to this file as accepted debt,\n                          and exit 0 without judging them.\n  --no-config             Ignore .spec-graph.json and the package.json key.\n  --format human|json     Report format (default: human)\n  --graph-format <fmt>    dot, mermaid or json (default: dot)\n  --documents-only        Leave items out of the exported graph\n  --rule <id>=<severity>  Override one rule: error, warn, info or off. Repeatable.\n  --max <n>               Show at most n findings (0 = no limit)\n  --max-warnings <n>      Fail when warnings exceed n (default: no limit)\n  --strict                Raise every warning to an error. An explicit --rule\n                          still wins, so --strict --rule x=warn exempts x.\n  --color / --no-color    Force colour on or off\n  --ascii                 Use ASCII glyphs only\n  --verbose               Include parse problems and per-file detail\n  -h, --help              Show this help\n  -v, --version           Show the version\n\nSELECTORS\n  A selector is a path through the graph.\n\n    item[openness=open] -delegates-to-> document[phase=retired]\n    document[phase=active] -assumes-> document[phase=retired]\n    document =supersedes=> document\n    *[path^=docs/adr] -contains-> item[state=accepted-debt]\n\n  Node types:  document, item, * (any)\n  Attributes:  id, kind, title, path, file, line, phase, status, receptivity,\n               alias, document, state (or disposition), openness, section,\n               text, body, evidence, conflicted, fm.<front-matter-key>\n  Operators:   = != ^= $= *= ~=   and [attr] for \"is present\"\n  Relations:   -kind->  <-kind-   =kind=>  <=kind=   (= forms are transitive)\n\nEXIT CODES\n  0  clean\n  1  findings at error severity (or over --max-warnings)\n  2  the tool could not run\n\nCONFIGURATION\n  Anything repeated on every run belongs in the repository rather than in the\n  command. spec-graph reads the first of these that exists:\n\n    .spec-graph.json, spec-graph.config.json, or a \"spec-graph\" key in\n    package.json\n\n    { \"patterns\": [\"docs/**/*.md\"],\n      \"ignoreReferences\": [\"trap *\"],\n      \"ignoreFamilies\": [\"RFC\"],\n      \"historyPatterns\": [\"**/JOURNAL_*.md\", \"archive/**\"],\n      \"baseline\": \".spec-graph-baseline.json\",\n      \"severities\": { \"self-reference\": \"off\" },\n      \"strict\": true }\n\n  A flag always wins over the file, and list flags add to it rather than\n  replacing it.\n\nADOPTING THIS ON AN OLD REPOSITORY\n  Record what is already wrong, then report only what happens next:\n\n    spec-graph check --record-baseline .spec-graph-baseline.json\n    git add .spec-graph-baseline.json\n\n  The file is keyed by specification and citation, not by line number, so it\n  survives edits, moves and renames. Findings that stop occurring are reported\n  so the file can be tightened; nothing new gets in.\n\nEXAMPLES\n  spec-graph \"docs/**/*.md\"\n  spec-graph check --rule self-reference=off --format json\n  spec-graph query 'item[openness=open] -delegates-to-> document[phase=retired]'\n  spec-graph check --ignore-ref \"trap *\"    # [[trap 55]] tags a concept, not a file\n  spec-graph graph --documents-only --graph-format mermaid > graph.mmd\n  spec-graph check --history \"**/JOURNAL_*.md\"   # a log is not a specification\n  spec-graph check --baseline .spec-graph-baseline.json\n`;\n\nconst SEVERITIES: readonly Severity[] = ['error', 'warn', 'info', 'off'];\n\n/** Parses argv into options. Throws {@link UsageError} on anything malformed. */\nexport function parseArgs(argv: readonly string[], cwd: string): CliOptions {\n  const args = [...argv];\n  let command: Command = 'check';\n\n  if (args.length > 0 && !((args[0] as string).startsWith('-'))) {\n    const first = args[0] as string;\n    if (first === 'check' || first === 'query' || first === 'graph' || first === 'rules') {\n      command = first;\n      args.shift();\n    }\n  }\n\n  const patterns: string[] = [];\n  const ignore: string[] = [];\n  const ignoreReferences: string[] = [];\n  const families: string[] = [];\n  const ignoreFamilies: string[] = [];\n  const historyPatterns: string[] = [];\n  let noConfig = false;\n  const severities: Partial<Record<RuleId, Severity>> = {};\n  let root = cwd;\n  let format: 'human' | 'json' = 'human';\n  let graphFormat: GraphFormat = 'dot';\n  let color: boolean | null = null;\n  let ascii: boolean | null = null;\n  let verbose = false;\n  let documentsOnly = false;\n  let max = 0;\n  let maxWarnings = -1;\n  let strict = false;\n  let baseline: string | null = null;\n  let recordBaseline: string | null = null;\n  let selector: string | null = null;\n  let help = false;\n  let version = false;\n\n  const next = (flag: string, index: number): string => {\n    const value = args[index + 1];\n    if (value === undefined) throw new UsageError(`${flag} needs a value`);\n    return value;\n  };\n\n  for (let i = 0; i < args.length; i += 1) {\n    const arg = args[i] as string;\n\n    if (arg === '--') {\n      patterns.push(...args.slice(i + 1));\n      break;\n    }\n\n    if (!arg.startsWith('-')) {\n      if (command === 'query' && selector === null) selector = arg;\n      else patterns.push(arg);\n      continue;\n    }\n\n    switch (arg) {\n      case '-h':\n      case '--help':\n        help = true;\n        break;\n      case '-v':\n      case '--version':\n        version = true;\n        break;\n      case '--verbose':\n        verbose = true;\n        break;\n      case '--color':\n        color = true;\n        break;\n      case '--no-color':\n        color = false;\n        break;\n      case '--ascii':\n        ascii = true;\n        break;\n      case '--documents-only':\n        documentsOnly = true;\n        break;\n      case '--strict':\n        strict = true;\n        break;\n      case '--explain':\n        verbose = true;\n        break;\n      case '--root':\n        root = next(arg, i);\n        i += 1;\n        break;\n      case '--ignore':\n        ignore.push(next(arg, i));\n        i += 1;\n        break;\n      case '--ignore-ref':\n        ignoreReferences.push(next(arg, i));\n        i += 1;\n        break;\n      case '--family':\n        families.push(next(arg, i));\n        i += 1;\n        break;\n      case '--ignore-family':\n        ignoreFamilies.push(next(arg, i));\n        i += 1;\n        break;\n      case '--history':\n        historyPatterns.push(next(arg, i));\n        i += 1;\n        break;\n      case '--baseline':\n        baseline = next(arg, i);\n        i += 1;\n        break;\n      case '--record-baseline':\n        recordBaseline = next(arg, i);\n        i += 1;\n        break;\n      case '--no-config':\n        noConfig = true;\n        break;\n      case '--format': {\n        const value = next(arg, i);\n        if (value !== 'human' && value !== 'json') {\n          throw new UsageError(`--format must be human or json, got \"${value}\"`);\n        }\n        format = value;\n        i += 1;\n        break;\n      }\n      case '--graph-format': {\n        const value = next(arg, i);\n        if (value !== 'dot' && value !== 'mermaid' && value !== 'json') {\n          throw new UsageError(`--graph-format must be dot, mermaid or json, got \"${value}\"`);\n        }\n        graphFormat = value;\n        i += 1;\n        break;\n      }\n      case '--rule': {\n        const value = next(arg, i);\n        const equals = value.indexOf('=');\n        if (equals === -1) throw new UsageError(`--rule expects <id>=<severity>, got \"${value}\"`);\n        const id = value.slice(0, equals) as RuleId;\n        const level = value.slice(equals + 1) as Severity;\n        if (!RULE_IDS.includes(id)) {\n          throw new UsageError(`unknown rule \"${id}\"\\n  known rules: ${RULE_IDS.join(', ')}`);\n        }\n        if (!SEVERITIES.includes(level)) {\n          throw new UsageError(`unknown severity \"${level}\", expected one of: ${SEVERITIES.join(', ')}`);\n        }\n        severities[id] = level;\n        i += 1;\n        break;\n      }\n      case '--max': {\n        max = parseCount(arg, next(arg, i));\n        i += 1;\n        break;\n      }\n      case '--max-warnings': {\n        maxWarnings = parseCount(arg, next(arg, i));\n        i += 1;\n        break;\n      }\n      default:\n        throw new UsageError(`unknown option \"${arg}\"\\n  run \"spec-graph --help\" to see the available options`);\n    }\n  }\n\n  if (command === 'query' && selector === null && !help && !version) {\n    throw new UsageError('query needs a selector, for example:\\n  spec-graph query \\'item[openness=open]\\'');\n  }\n\n  return {\n    command,\n    patterns,\n    root,\n    ignore,\n    ignoreReferences,\n    families,\n    ignoreFamilies,\n    historyPatterns,\n    baseline,\n    recordBaseline,\n    noConfig,\n    format,\n    graphFormat,\n    severities,\n    color,\n    ascii,\n    verbose,\n    documentsOnly,\n    max,\n    maxWarnings,\n    strict,\n    selector,\n    help,\n    version,\n  };\n}\n\nfunction count(n: number, word: string, many?: string): string {\n  return `${n} ${n === 1 ? word : (many ?? `${word}s`)}`;\n}\n\n/**\n * Reads a baseline file.\n *\n * A missing file is not an error: `--baseline` against a repository that has\n * not recorded one yet should report everything, which is exactly what an empty\n * baseline does.\n */\nasync function readBaseline(path: string, source: string): Promise<ReturnType<typeof parseBaseline>> {\n  let raw: string;\n  try {\n    const { readFile } = await import('node:fs/promises');\n    raw = await readFile(path, 'utf8');\n  } catch {\n    return { baseline: EMPTY_BASELINE, problems: [] };\n  }\n  return parseBaseline(raw, source);\n}\n\nfunction parseCount(flag: string, value: string): number {\n  const parsed = Number.parseInt(value, 10);\n  if (!Number.isFinite(parsed) || parsed < 0 || String(parsed) !== value.trim()) {\n    throw new UsageError(`${flag} expects a non-negative whole number, got \"${value}\"`);\n  }\n  return parsed;\n}\n\n/* -------------------------------------------------------------------------- */\n/* Entry point                                                                */\n/* -------------------------------------------------------------------------- */\n\n/** Runs the CLI and returns the process exit code. Never throws. */\nexport async function main(io: CliIO = {}): Promise<number> {\n  const argv = io.argv ?? process.argv.slice(2);\n  const cwd = io.cwd ?? process.cwd();\n  const out = io.stdout ?? ((text) => process.stdout.write(text));\n  const err = io.stderr ?? ((text) => process.stderr.write(text));\n  const env = io.env ?? process.env;\n\n  let options: CliOptions;\n  try {\n    options = parseArgs(argv, cwd);\n  } catch (error) {\n    if (error instanceof UsageError) {\n      err(`spec-graph: ${error.message}\\n`);\n      return EXIT_ERROR;\n    }\n    throw error;\n  }\n\n  if (options.help) {\n    out(HELP);\n    return EXIT_OK;\n  }\n  if (options.version) {\n    out(`${await readVersion()}\\n`);\n    return EXIT_OK;\n  }\n\n  const color = options.color ?? shouldUseColor({ isTTY: io.isTTY, env });\n  const ascii = options.ascii ?? shouldUseAscii({ env });\n\n  if (options.command === 'rules') {\n    out(renderRules(options.verbose));\n    return EXIT_OK;\n  }\n\n  // Configuration is what is true of the repository; a flag is somebody\n  // overriding it for one run. So a flag always wins, and lists add rather than\n  // replace - a `--ignore-ref` on the command line is one more exclusion, not a\n  // decision to throw away the ones the repository already declared.\n  const loaded = options.noConfig ? { config: {} as SpecGraphConfig, source: null, problems: [] } : loadConfig(options.root);\n  for (const problem of loaded.problems) err(`spec-graph: ${problem}\\n`);\n  const file = loaded.config;\n\n  const patterns =\n    options.patterns.length > 0 ? options.patterns : (file.patterns ?? DEFAULT_PATTERNS);\n  const severityOverrides = { ...(file.severities ?? {}), ...options.severities };\n  const { severities, escalated } = resolveStrict(severityOverrides, options.strict || (file.strict ?? false));\n\n  const analyseOptions: AnalyseOptions = {\n    root: options.root,\n    patterns,\n    ignore: [...(file.ignore ?? []), ...options.ignore],\n    ignoreReferences: [...(file.ignoreReferences ?? []), ...options.ignoreReferences],\n    families: [...(file.families ?? []), ...options.families],\n    ignoreFamilies: [...(file.ignoreFamilies ?? []), ...options.ignoreFamilies],\n    historyPatterns: [...(file.historyPatterns ?? []), ...options.historyPatterns],\n    severities,\n    ...(file.maxRelated !== undefined ? { maxRelated: file.maxRelated } : {}),\n  };\n\n  if (options.verbose && loaded.source !== null) out(`configuration: ${loaded.source}\\n`);\n\n  let result;\n  try {\n    result = await analyse(analyseOptions);\n  } catch (error) {\n    err(`spec-graph: ${(error as Error).message}\\n`);\n    return EXIT_ERROR;\n  }\n\n  if (result.files.length === 0) {\n    err(\n      `spec-graph: no specifications matched ${\n        options.patterns.length > 0 ? options.patterns.map((p) => `\"${p}\"`).join(', ') : 'the default patterns'\n      }\\n  looked under ${options.root}\\n`,\n    );\n    return EXIT_ERROR;\n  }\n\n  switch (options.command) {\n    case 'graph':\n      out(formatGraph(result.graph, options.graphFormat, { documentsOnly: options.documentsOnly }));\n      return EXIT_OK;\n\n    case 'query': {\n      try {\n        const matches = execute(result.graph, parseQuery(options.selector as string));\n        out(renderMatches(matches, options.format, result.graph.nodes.size));\n        return matches.length > 0 ? EXIT_OK : EXIT_FAILED;\n      } catch (error) {\n        if (error instanceof QueryError) {\n          err(renderQueryError(options.selector as string, error));\n          return EXIT_ERROR;\n        }\n        throw error;\n      }\n    }\n\n    default: {\n      // Recording is not checking. It writes down what is wrong today so that\n      // tomorrow can be compared against it, and says nothing about whether\n      // today is acceptable - so it reports what it wrote and exits clean.\n      if (options.recordBaseline !== null) {\n        const text = formatBaseline(result.graph, result.diagnostics);\n        try {\n          const { writeFile } = await import('node:fs/promises');\n          await writeFile(underRoot(options.root, options.recordBaseline), text, 'utf8');\n        } catch (error) {\n          err(`spec-graph: cannot write ${options.recordBaseline}: ${(error as Error).message}\\n`);\n          return EXIT_ERROR;\n        }\n        const entries = (JSON.parse(text) as Baseline).findings.length;\n        out(\n          `recorded ${count(result.diagnostics.length, 'finding')} as ${count(entries, 'entry', 'entries')} in ${options.recordBaseline}\\n`,\n        );\n        return EXIT_OK;\n      }\n\n      const source = options.baseline ?? file.baseline ?? null;\n      let reported = result;\n      let note: { source: string; suppressed: number; stale: number } | undefined;\n      if (source !== null) {\n        const held = await readBaseline(underRoot(options.root, source), source);\n        for (const problem of held.problems) err(`spec-graph: ${problem}\\n`);\n        const outcome = applyBaseline(result.graph, result.diagnostics, held.baseline);\n        reported = withDiagnostics(result, outcome.kept);\n        note = { source, suppressed: outcome.suppressed, stale: outcome.stale.length };\n        if (options.verbose) {\n          for (const entry of outcome.stale) {\n            out(`  paid: ${entry.rule} ${entry.document}${entry.subject === '' ? '' : ` \"${entry.subject}\"`}\\n`);\n          }\n        }\n      }\n\n      const baselineNote = note === undefined ? {} : { baseline: note };\n      out(\n        options.format === 'json'\n          ? formatJson(reported, { escalated, ...baselineNote })\n          : `${formatReport(reported, { color, ascii, verbose: options.verbose, max: options.max, escalated, ...baselineNote })}\\n`,\n      );\n      if (!reported.ok) return EXIT_FAILED;\n      if (options.maxWarnings >= 0 && reported.summary.warnings > options.maxWarnings) return EXIT_FAILED;\n      return EXIT_OK;\n    }\n  }\n}\n\n/* -------------------------------------------------------------------------- */\n/* Rendering                                                                  */\n/* -------------------------------------------------------------------------- */\n\nfunction renderRules(explain: boolean): string {\n  const width = Math.max(...RULE_IDS.map((id) => id.length));\n  const lines: string[] = [];\n  for (const id of RULE_IDS) {\n    lines.push(`${id.padEnd(width)}  ${DEFAULT_SEVERITIES[id].padEnd(5)}  ${RULE_DESCRIPTIONS[id]}`);\n    const query = RULE_QUERIES[id];\n    if (explain && query) lines.push(`${' '.repeat(width)}         ${query}`);\n  }\n  return `${lines.join('\\n')}\\n`;\n}\n\nfunction renderMatches(matches: readonly Match[], format: 'human' | 'json', total: number): string {\n  if (format === 'json') {\n    return `${JSON.stringify(\n      {\n        version: 1,\n        count: matches.length,\n        matches: matches.map((match) => ({\n          nodes: match.nodes.map((node) => nodeSummary(node)),\n          edges: match.edges.map((edge) => ({\n            kind: edge.kind,\n            from: edge.from,\n            to: edge.to,\n            file: edge.declaredAt.file,\n            line: edge.declaredAt.span.start.line,\n          })),\n        })),\n      },\n      null,\n      2,\n    )}\\n`;\n  }\n\n  if (matches.length === 0) return `no matches (searched ${total} nodes)\\n`;\n\n  const lines: string[] = [];\n  for (const match of matches) {\n    const head = match.nodes[0] as SpecNode;\n    const tail = match.nodes[match.nodes.length - 1] as SpecNode;\n    lines.push(renderMatch(match));\n    lines.push(`  ${formatRef(head.at)}${match.nodes.length > 1 ? `  ${formatRef(tail.at)}` : ''}`);\n  }\n  lines.push(`${matches.length} ${matches.length === 1 ? 'match' : 'matches'}`);\n  return `${lines.join('\\n')}\\n`;\n}\n\nfunction nodeSummary(node: SpecNode): Record<string, unknown> {\n  return {\n    id: node.id,\n    kind: node.kind,\n    title: node.title,\n    file: node.at.file,\n    line: node.at.span.start.line,\n    ...(node.kind === 'document' ? { phase: node.phase } : { state: node.disposition, openness: node.openness }),\n  };\n}\n\n/** Points at the exact character of a selector that failed to parse. */\nfunction renderQueryError(selector: string, error: QueryError): string {\n  const caret = `${' '.repeat(Math.max(0, error.offset))}^`;\n  return `spec-graph: ${error.message}\\n  ${selector}\\n  ${caret}\\n`;\n}\n\nasync function readVersion(): Promise<string> {\n  try {\n    const { readFile } = await import('node:fs/promises');\n    const url = new URL('../package.json', import.meta.url);\n    const parsed: unknown = JSON.parse(await readFile(url, 'utf8'));\n    if (typeof parsed === 'object' && parsed !== null && 'version' in parsed) {\n      return String((parsed as { version: unknown }).version);\n    }\n  } catch {\n    // Fall through to the placeholder rather than failing `--version`.\n  }\n  return '0.0.0';\n}\n"]}