plumbbob 0.5.4 → 0.6.3

package/node_modules/checkride/dist/adapters.js

@@ -0,0 +1,219 @@
+/**
+ * Adapter registry — pure data.
+ *
+ * A `Slot` is a role in the pipeline (the catalogue; order matters, cheapest
+ * first). An `Adapter` is a concrete tool that can fill a slot. The registry is
+ * data only: no logic lives here. Resolution (config vs detection) lives in
+ * `../config`, and execution lives in `../orchestrator`.
+ *
+ * Phase 1 ships the blessed defaults plus the two opt-in slots. Alternates
+ * (biome, knip, eslint, jest) land in Phase 2.
+ */
+/** The aggregate-report schema version written to `.check/summary.json`. */
+export const SCHEMA_VERSION = 1;
+/** Pipeline order. Cheapest first so `--bail` fails fast. */
+export const SLOTS = [
+    { name: 'types' },
+    { name: 'lint' },
+    { name: 'struct' },
+    { name: 'dead' },
+    { name: 'test' },
+    { name: 'docs' },
+    { name: 'links' },
+    { name: 'spell' },
+    { name: 'mutation', optIn: true },
+    { name: 'security', optIn: true },
+];
+/**
+ * Adapter registry. The FIRST adapter for a slot is its blessed default: it
+ * wins detection when several tool configs coexist, and is the only one `init`
+ * generates config for. Alternates follow so checkride can still *run* them.
+ */
+export const ADAPTERS = [
+    {
+        name: 'tsc',
+        slot: 'types',
+        description: 'TypeScript type checking (incremental, via project references)',
+        detect: ['tsconfig.json'],
+        command: 'pnpm',
+        args: ['exec', 'tsc', '--build'],
+        outputFile: null,
+        devDeps: { typescript: '6.0.3', '@types/node': '22.20.0' },
+    },
+    {
+        name: 'oxlint',
+        slot: 'lint',
+        description: 'Oxlint with tsgolint type-aware rules',
+        detect: ['.oxlintrc.json'],
+        command: 'pnpm',
+        args: ['exec', 'oxlint', '--type-aware', '--format=json'],
+        outputFile: 'lint.json',
+        fixArgs: ['exec', 'oxlint', '--type-aware', '--fix'],
+        devDeps: { oxlint: '1.61.0', 'oxlint-tsgolint': '0.21.1' },
+    },
+    {
+        name: 'biome',
+        slot: 'lint',
+        description: 'Biome lint + format check',
+        detect: ['biome.json', 'biome.jsonc'],
+        command: 'pnpm',
+        args: ['exec', 'biome', 'check', '--reporter=json'],
+        outputFile: 'lint.json',
+        fixArgs: ['exec', 'biome', 'check', '--write'],
+        devDeps: { '@biomejs/biome': '2.2.4' },
+    },
+    {
+        name: 'eslint',
+        slot: 'lint',
+        description: 'ESLint',
+        detect: [
+            'eslint.config.js',
+            'eslint.config.mjs',
+            'eslint.config.cjs',
+            'eslint.config.ts',
+            '.eslintrc.json',
+            '.eslintrc.cjs',
+            '.eslintrc.js',
+        ],
+        command: 'pnpm',
+        args: ['exec', 'eslint', '.', '--format', 'json'],
+        outputFile: 'lint.json',
+        fixArgs: ['exec', 'eslint', '.', '--fix'],
+        devDeps: { eslint: '9.36.0' },
+    },
+    {
+        name: 'ast-grep',
+        slot: 'struct',
+        description: 'Structural rules (ast-grep)',
+        detect: ['sgconfig.yml', 'sgconfig.yaml'],
+        command: 'pnpm',
+        args: ['exec', 'ast-grep', 'scan', '--json=compact'],
+        outputFile: 'struct.json',
+        devDeps: { '@ast-grep/cli': '0.42.1' },
+    },
+    {
+        name: 'fallow',
+        slot: 'dead',
+        description: 'Fallow: dead code, cycles, duplication, boundaries, complexity',
+        detect: ['fallow.toml'],
+        command: 'pnpm',
+        args: ['exec', 'fallow', '--format', 'json'],
+        outputFile: 'dead.json',
+        fixArgs: ['exec', 'fallow', 'fix'],
+        devDeps: { fallow: '2.48.0' },
+    },
+    {
+        name: 'knip',
+        slot: 'dead',
+        description: 'Knip: unused files, exports, and dependencies',
+        detect: ['knip.json', 'knip.jsonc', '.knip.json', 'knip.config.ts', 'knip.config.js'],
+        command: 'pnpm',
+        args: ['exec', 'knip', '--reporter', 'json'],
+        outputFile: 'dead.json',
+        fixArgs: ['exec', 'knip', '--fix'],
+        devDeps: { knip: '5.64.0' },
+    },
+    {
+        name: 'vitest',
+        slot: 'test',
+        description: 'Vitest tests with coverage',
+        detect: ['vitest.config.ts', 'vitest.config.js', 'vitest.config.mjs', 'vitest.config.mts'],
+        command: 'pnpm',
+        args: [
+            'exec', 'vitest', 'run',
+            '--coverage',
+            '--reporter=default',
+            '--reporter=json',
+            '--outputFile=.check/test.json',
+        ],
+        outputFile: null,
+        changedArgs: ['--changed', 'origin/main'],
+        devDeps: { vitest: '4.1.5', '@vitest/coverage-v8': '4.1.5' },
+    },
+    {
+        name: 'jest',
+        slot: 'test',
+        description: 'Jest tests',
+        detect: [
+            'jest.config.js',
+            'jest.config.ts',
+            'jest.config.mjs',
+            'jest.config.cjs',
+            'jest.config.json',
+        ],
+        command: 'pnpm',
+        args: ['exec', 'jest', '--ci', '--json', '--outputFile=.check/test.json'],
+        outputFile: null,
+        changedArgs: ['--changedSince', 'origin/main'],
+        devDeps: { jest: '30.0.5' },
+    },
+    {
+        name: 'markdownlint-cli2',
+        slot: 'docs',
+        description: 'Markdown linting',
+        detect: [
+            '.markdownlint-cli2.jsonc',
+            '.markdownlint-cli2.json',
+            '.markdownlint-cli2.yaml',
+            '.markdownlint-cli2.cjs',
+            '.markdownlint-cli2.mjs',
+        ],
+        command: 'pnpm',
+        args: ['exec', 'markdownlint-cli2'],
+        outputFile: null,
+        fixArgs: ['exec', 'markdownlint-cli2', '--fix'],
+        devDeps: { 'markdownlint-cli2': '0.22.1' },
+    },
+    {
+        name: 'links',
+        slot: 'links',
+        description: 'Relative markdown link targets exist on disk',
+        detect: [],
+        command: 'node',
+        args: [],
+        outputFile: 'links.json',
+        builtin: 'links',
+        devDeps: {},
+    },
+    {
+        name: 'cspell',
+        slot: 'spell',
+        description: 'Spell check',
+        detect: [
+            'cspell.json',
+            '.cspell.json',
+            'cspell.config.json',
+            'cspell.config.yaml',
+            'cspell.config.cjs',
+            'cspell.config.mjs',
+        ],
+        command: 'pnpm',
+        args: ['exec', 'cspell', '--no-progress', '--no-summary', '--reporter=default'],
+        outputFile: null,
+        devDeps: { cspell: '10.0.0' },
+    },
+    {
+        name: 'stryker',
+        slot: 'mutation',
+        description: 'Stryker mutation testing (incremental)',
+        detect: ['stryker.config.mjs', 'stryker.config.json', 'stryker.conf.json', 'stryker.conf.js'],
+        command: 'pnpm',
+        args: ['exec', 'stryker', 'run'],
+        outputFile: null,
+        devDeps: {
+            '@stryker-mutator/core': '9.6.1',
+            '@stryker-mutator/vitest-runner': '9.6.1',
+        },
+    },
+    {
+        name: 'pnpm-audit',
+        slot: 'security',
+        description: 'Dependency audit (pnpm audit)',
+        detect: [],
+        command: 'pnpm',
+        args: ['audit', '--audit-level=high', '--json'],
+        outputFile: 'security.json',
+        devDeps: {},
+    },
+];
+//# sourceMappingURL=adapters.js.map

package/node_modules/checkride/dist/adapters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapters.js","sourceRoot":"","sources":["../src/adapters.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,4EAA4E;AAC5E,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC;AAsChC,6DAA6D;AAC7D,MAAM,CAAC,MAAM,KAAK,GAAoB;IACpC,EAAE,IAAI,EAAE,OAAO,EAAE;IACjB,EAAE,IAAI,EAAE,MAAM,EAAE;IAChB,EAAE,IAAI,EAAE,QAAQ,EAAE;IAClB,EAAE,IAAI,EAAE,MAAM,EAAE;IAChB,EAAE,IAAI,EAAE,MAAM,EAAE;IAChB,EAAE,IAAI,EAAE,MAAM,EAAE;IAChB,EAAE,IAAI,EAAE,OAAO,EAAE;IACjB,EAAE,IAAI,EAAE,OAAO,EAAE;IACjB,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,IAAI,EAAE;IACjC,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,IAAI,EAAE;CAClC,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAuB;IAC1C;QACE,IAAI,EAAE,KAAK;QACX,IAAI,EAAE,OAAO;QACb,WAAW,EAAE,gEAAgE;QAC7E,MAAM,EAAE,CAAC,eAAe,CAAC;QACzB,OAAO,EAAE,MAAM;QACf,IAAI,EAAE,CAAC,MAAM,EAAE,KAAK,EAAE,SAAS,CAAC;QAChC,UAAU,EAAE,IAAI;QAChB,OAAO,EAAE,EAAE,UAAU,EAAE,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE;KAC3D;IACD;QACE,IAAI,EAAE,QAAQ;QACd,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,uCAAuC;QACpD,MAAM,EAAE,CAAC,gBAAgB,CAAC;QAC1B,OAAO,EAAE,MAAM;QACf,IAAI,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,cAAc,EAAE,eAAe,CAAC;QACzD,UAAU,EAAE,WAAW;QACvB,OAAO,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,cAAc,EAAE,OAAO,CAAC;QACpD,OAAO,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,iBAAiB,EAAE,QAAQ,EAAE;KAC3D;IACD;QACE,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,2BAA2B;QACxC,MAAM,EAAE,CAAC,YAAY,EAAE,aAAa,CAAC;QACrC,OAAO,EAAE,MAAM;QACf,IAAI,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,iBAAiB,CAAC;QACnD,UAAU,EAAE,WAAW;QACvB,OAAO,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,CAAC;QAC9C,OAAO,EAAE,EAAE,gBAAgB,EAAE,OAAO,EAAE;KACvC;IACD;QACE,IAAI,EAAE,QAAQ;QACd,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,QAAQ;QACrB,MAAM,EAAE;YACN,kBAAkB;YAClB,mBAAmB;YACnB,mBAAmB;YACnB,kBAAkB;YAClB,gBAAgB;YAChB,eAAe;YACf,cAAc;SACf;QACD,OAAO,EAAE,MAAM;QACf,IAAI,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,UAAU,EAAE,MAAM,CAAC;QACjD,UAAU,EAAE,WAAW;QACvB,OAAO,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,OAAO,CAAC;QACzC,OAAO,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE;KAC9B;IACD;QACE,IAAI,EAAE,UAAU;QAChB,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,6BAA6B;QAC1C,MAAM,EAAE,CAAC,cAAc,EAAE,eAAe,CAAC;QACzC,OAAO,EAAE,MAAM;QACf,IAAI,EAAE,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,gBAAgB,CAAC;QACpD,UAAU,EAAE,aAAa;QACzB,OAAO,EAAE,EAAE,eAAe,EAAE,QAAQ,EAAE;KACvC;IACD;QACE,IAAI,EAAE,QAAQ;QACd,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,gEAAgE;QAC7E,MAAM,EAAE,CAAC,aAAa,CAAC;QACvB,OAAO,EAAE,MAAM;QACf,IAAI,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,CAAC;QAC5C,UAAU,EAAE,WAAW;QACvB,OAAO,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,CAAC;QAClC,OAAO,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE;KAC9B;IACD;QACE,IAAI,EAAE,MAAM;QACZ,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,+CAA+C;QAC5D,MAAM,EAAE,CAAC,WAAW,EAAE,YAAY,EAAE,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,CAAC;QACrF,OAAO,EAAE,MAAM;QACf,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,CAAC;QAC5C,UAAU,EAAE,WAAW;QACvB,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC;QAClC,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;KAC5B;IACD;QACE,IAAI,EAAE,QAAQ;QACd,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,4BAA4B;QACzC,MAAM,EAAE,CAAC,kBAAkB,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,mBAAmB,CAAC;QAC1F,OAAO,EAAE,MAAM;QACf,IAAI,EAAE;YACJ,MAAM,EAAE,QAAQ,EAAE,KAAK;YACvB,YAAY;YACZ,oBAAoB;YACpB,iBAAiB;YACjB,+BAA+B;SAChC;QACD,UAAU,EAAE,IAAI;QAChB,WAAW,EAAE,CAAC,WAAW,EAAE,aAAa,CAAC;QACzC,OAAO,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,qBAAqB,EAAE,OAAO,EAAE;KAC7D;IACD;QACE,IAAI,EAAE,MAAM;QACZ,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,YAAY;QACzB,MAAM,EAAE;YACN,gBAAgB;YAChB,gBAAgB;YAChB,iBAAiB;YACjB,iBAAiB;YACjB,kBAAkB;SACnB;QACD,OAAO,EAAE,MAAM;QACf,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,+BAA+B,CAAC;QACzE,UAAU,EAAE,IAAI;QAChB,WAAW,EAAE,CAAC,gBAAgB,EAAE,aAAa,CAAC;QAC9C,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;KAC5B;IACD;QACE,IAAI,EAAE,mBAAmB;QACzB,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,kBAAkB;QAC/B,MAAM,EAAE;YACN,0BAA0B;YAC1B,yBAAyB;YACzB,yBAAyB;YACzB,wBAAwB;YACxB,wBAAwB;SACzB;QACD,OAAO,EAAE,MAAM;QACf,IAAI,EAAE,CAAC,MAAM,EAAE,mBAAmB,CAAC;QACnC,UAAU,EAAE,IAAI;QAChB,OAAO,EAAE,CAAC,MAAM,EAAE,mBAAmB,EAAE,OAAO,CAAC;QAC/C,OAAO,EAAE,EAAE,mBAAmB,EAAE,QAAQ,EAAE;KAC3C;IACD;QACE,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,OAAO;QACb,WAAW,EAAE,8CAA8C;QAC3D,MAAM,EAAE,EAAE;QACV,OAAO,EAAE,MAAM;QACf,IAAI,EAAE,EAAE;QACR,UAAU,EAAE,YAAY;QACxB,OAAO,EAAE,OAAO;QAChB,OAAO,EAAE,EAAE;KACZ;IACD;QACE,IAAI,EAAE,QAAQ;QACd,IAAI,EAAE,OAAO;QACb,WAAW,EAAE,aAAa;QAC1B,MAAM,EAAE;YACN,aAAa;YACb,cAAc;YACd,oBAAoB;YACpB,oBAAoB;YACpB,mBAAmB;YACnB,mBAAmB;SACpB;QACD,OAAO,EAAE,MAAM;QACf,IAAI,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,eAAe,EAAE,cAAc,EAAE,oBAAoB,CAAC;QAC/E,UAAU,EAAE,IAAI;QAChB,OAAO,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE;KAC9B;IACD;QACE,IAAI,EAAE,SAAS;QACf,IAAI,EAAE,UAAU;QAChB,WAAW,EAAE,wCAAwC;QACrD,MAAM,EAAE,CAAC,oBAAoB,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,iBAAiB,CAAC;QAC7F,OAAO,EAAE,MAAM;QACf,IAAI,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,CAAC;QAChC,UAAU,EAAE,IAAI;QAChB,OAAO,EAAE;YACP,uBAAuB,EAAE,OAAO;YAChC,gCAAgC,EAAE,OAAO;SAC1C;KACF;IACD;QACE,IAAI,EAAE,YAAY;QAClB,IAAI,EAAE,UAAU;QAChB,WAAW,EAAE,+BAA+B;QAC5C,MAAM,EAAE,EAAE;QACV,OAAO,EAAE,MAAM;QACf,IAAI,EAAE,CAAC,OAAO,EAAE,oBAAoB,EAAE,QAAQ,CAAC;QAC/C,UAAU,EAAE,eAAe;QAC3B,OAAO,EAAE,EAAE;KACZ;CACF,CAAC"}

package/node_modules/checkride/dist/cli.d.ts

@@ -0,0 +1,29 @@
+#!/usr/bin/env node
+/**
+ * CLI entry — arg parsing and command dispatch (the package `bin`).
+ *
+ * Commands: default `run`, plus `init`, `doctor`, and `fix`. The command is the
+ * first non-flag token; everything after it is parsed against that command's
+ * options. The module is import-safe: it only executes when invoked directly,
+ * so tests can import {@link runCli} without triggering a process exit.
+ *
+ * Exit codes: 0 pass, 1 check/verification failure, 2 orchestrator/usage error.
+ */
+import type { InitOptions } from './init.js';
+import type { Out, RunFlags } from './orchestrator.js';
+/** Injected process surface, so {@link runCli} is testable. */
+export type CliDeps = {
+    cwd: string;
+    stdout: Out;
+    stderr: Out;
+};
+/** Parse argv into a command name and the run flags. */
+export declare function parseCliArgs(argv: string[]): {
+    command: string;
+    flags: RunFlags;
+};
+/** Parse `init` arguments into init options. */
+export declare function parseInitArgs(argv: string[]): Partial<InitOptions>;
+/** Dispatch a CLI invocation; returns the process exit code. */
+export declare function runCli(argv: string[], deps: CliDeps): Promise<number>;
+//# sourceMappingURL=cli.d.ts.map

package/node_modules/checkride/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA;;;;;;;;;GASG;AAOH,OAAO,KAAK,EAAE,WAAW,EAAS,MAAM,WAAW,CAAC;AAEpD,OAAO,KAAK,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAGvD,+DAA+D;AAC/D,MAAM,MAAM,OAAO,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,GAAG,CAAC;IAAC,MAAM,EAAE,GAAG,CAAA;CAAE,CAAC;AA0FhE,wDAAwD;AACxD,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,QAAQ,CAAA;CAAE,CAajF;AAQD,gDAAgD;AAChD,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,WAAW,CAAC,CAclE;AAyBD,gEAAgE;AAChE,wBAAsB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAgC3E"}

package/node_modules/checkride/dist/cli.js

@@ -0,0 +1,227 @@
+#!/usr/bin/env node
+/**
+ * CLI entry — arg parsing and command dispatch (the package `bin`).
+ *
+ * Commands: default `run`, plus `init`, `doctor`, and `fix`. The command is the
+ * first non-flag token; everything after it is parsed against that command's
+ * options. The module is import-safe: it only executes when invoked directly,
+ * so tests can import {@link runCli} without triggering a process exit.
+ *
+ * Exit codes: 0 pass, 1 check/verification failure, 2 orchestrator/usage error.
+ */
+import { readFileSync, realpathSync } from 'node:fs';
+import { parseArgs } from 'node:util';
+import { fileURLToPath } from 'node:url';
+import { runDoctor } from './doctor.js';
+import { runInit } from './init.js';
+import { runChecks, runFix } from './orchestrator.js';
+const RUN_OPTIONS = {
+    bail: { type: 'boolean', default: false },
+    json: { type: 'boolean', default: false },
+    only: { type: 'string' },
+    skip: { type: 'string' },
+    include: { type: 'string' },
+    all: { type: 'boolean', default: false },
+    changed: { type: 'boolean', default: false },
+};
+const INIT_OPTIONS = {
+    shape: { type: 'string' },
+    name: { type: 'string' },
+    scope: { type: 'string' },
+    license: { type: 'string' },
+    author: { type: 'string' },
+    'dry-run': { type: 'boolean', default: false },
+    add: { type: 'string' },
+};
+const HELP_TEXT = `checkride — an agent harness for TypeScript repositories
+
+Usage: checkride [command] [options]
+
+Commands:
+  (default)        Run the checks. Exit 0 pass / 1 fail / 2 error.
+  init             Set up a project (new or existing — auto-detected).
+  doctor           Verify the environment and every slot's status (read-only).
+  fix              Run every active adapter's fix command.
+
+Run options:
+  --only <a,b>     Run only these slots
+  --skip <a,b>     Skip these slots
+  --include <a,b>  Add opt-in slots (mutation, security) to the run
+  --all            Include every opt-in slot
+  --changed        Affected-only mode (incremental)
+  --bail           Stop at the first failure
+  --json           Emit the summary as JSON on stdout
+  -h, --help       Show this help
+  -V, --version    Show the version
+
+Every run writes a report to .check/summary.json.
+Docs: https://github.com/robmclarty/checkride#readme
+`;
+function errorMessage(err) {
+    return err instanceof Error ? err.message : String(err);
+}
+/** The `code` property of an Error-like value (e.g. Node's `ERR_PARSE_ARGS_*`). */
+function errorCode(err) {
+    if (err instanceof Error && 'code' in err && typeof err.code === 'string') {
+        return err.code;
+    }
+    return undefined;
+}
+/** parseArgs appends a long "To specify a positional…" hint; keep the first sentence. */
+function firstSentence(message) {
+    const head = message.split('. ')[0] ?? message;
+    return head.endsWith('.') ? head : `${head}.`;
+}
+/** Read the package's own version from its shipped package.json (next to dist/). */
+function readVersion() {
+    try {
+        const pkgPath = fileURLToPath(new URL('../package.json', import.meta.url));
+        const pkg = JSON.parse(readFileSync(pkgPath, 'utf8'));
+        return pkg.version ?? '0.0.0';
+    }
+    catch {
+        return '0.0.0';
+    }
+}
+function parseList(value) {
+    if (!value)
+        return null;
+    return value.split(',').map((s) => s.trim()).filter(Boolean);
+}
+/** The command is the first non-flag token; the rest are its arguments. */
+function detectCommand(argv) {
+    const first = argv[0];
+    if (first !== undefined && !first.startsWith('-')) {
+        return { command: first, rest: argv.slice(1) };
+    }
+    return { command: 'run', rest: argv };
+}
+/** Parse argv into a command name and the run flags. */
+export function parseCliArgs(argv) {
+    const { command, rest } = detectCommand(argv);
+    const { values } = parseArgs({ args: rest, allowPositionals: true, options: RUN_OPTIONS });
+    const flags = {
+        bail: values.bail,
+        json: values.json,
+        all: values.all,
+        changed: values.changed,
+        only: parseList(values.only),
+        skip: parseList(values.skip),
+        include: parseList(values.include),
+    };
+    return { command, flags };
+}
+function asShape(value) {
+    if (value === undefined)
+        return undefined;
+    if (value === 'flat' || value === 'monorepo' || value === 'hybrid')
+        return value;
+    throw new Error(`invalid --shape '${value}' (expected flat | monorepo | hybrid)`);
+}
+/** Parse `init` arguments into init options. */
+export function parseInitArgs(argv) {
+    const { rest } = detectCommand(argv);
+    const { values } = parseArgs({ args: rest, allowPositionals: true, options: INIT_OPTIONS });
+    const opts = {};
+    const shape = asShape(values.shape);
+    if (shape)
+        opts.shape = shape;
+    if (values.name)
+        opts.name = values.name;
+    if (values.scope)
+        opts.scope = values.scope;
+    if (values.license)
+        opts.license = values.license;
+    if (values.author)
+        opts.author = values.author;
+    if (values['dry-run'])
+        opts.dryRun = true;
+    const add = parseList(values.add);
+    if (add)
+        opts.add = add;
+    return opts;
+}
+async function dispatchRun(argv, deps) {
+    const { flags } = parseCliArgs(argv);
+    const result = await runChecks({ ...flags, cwd: deps.cwd, stdout: deps.stdout, stderr: deps.stderr });
+    return result.exitCode;
+}
+async function dispatchInit(argv, deps) {
+    const result = await runInit({ ...parseInitArgs(argv), cwd: deps.cwd, stdout: deps.stdout });
+    return result.exitCode;
+}
+async function dispatchDoctor(argv, deps) {
+    const { flags } = parseCliArgs(argv);
+    const result = await runDoctor({ json: flags.json ?? false, cwd: deps.cwd, stdout: deps.stdout });
+    return result.exitCode;
+}
+async function dispatchFix(argv, deps) {
+    const { flags } = parseCliArgs(argv);
+    const result = await runFix({ ...flags, cwd: deps.cwd, stderr: deps.stderr });
+    return result.exitCode;
+}
+/** Dispatch a CLI invocation; returns the process exit code. */
+export async function runCli(argv, deps) {
+    if (argv.includes('--help') || argv.includes('-h')) {
+        deps.stdout.write(HELP_TEXT);
+        return 0;
+    }
+    if (argv.includes('--version') || argv.includes('-V')) {
+        deps.stdout.write(`${readVersion()}\n`);
+        return 0;
+    }
+    const { command } = detectCommand(argv);
+    const dispatch = {
+        run: dispatchRun,
+        init: dispatchInit,
+        doctor: dispatchDoctor,
+        fix: dispatchFix,
+    };
+    const handler = dispatch[command];
+    if (!handler) {
+        deps.stderr.write(`checkride: unknown command '${command}'.\nRun \`checkride --help\` for usage.\n`);
+        return 2;
+    }
+    try {
+        return await handler(argv, deps);
+    }
+    catch (err) {
+        if (errorCode(err)?.startsWith('ERR_PARSE_ARGS')) {
+            deps.stderr.write(`checkride: ${firstSentence(errorMessage(err))}\nRun \`checkride --help\` for usage.\n`);
+        }
+        else {
+            deps.stderr.write(`checkride: ${errorMessage(err)}\n`);
+        }
+        return 2;
+    }
+}
+/**
+ * True when this module is the process entry point — invoked as a command, not
+ * imported. Package managers expose the bin as a symlink
+ * (`node_modules/.bin/checkride` → `../checkride/dist/cli.js`), so
+ * `process.argv[1]` is the symlink path while `import.meta.url` resolves to the
+ * real target. The comparison must therefore be on real, symlink-resolved
+ * paths: a naive URL equality check is false through the symlink, which would
+ * silently no-op `pnpm exec checkride`, `npx checkride`, and the generated
+ * `pnpm check` alias — the way every consumer actually runs it.
+ */
+function isEntryPoint() {
+    const invokedPath = process.argv[1];
+    if (invokedPath === undefined)
+        return false;
+    try {
+        return realpathSync(invokedPath) === realpathSync(fileURLToPath(import.meta.url));
+    }
+    catch {
+        return false;
+    }
+}
+if (isEntryPoint()) {
+    const code = await runCli(process.argv.slice(2), {
+        cwd: process.cwd(),
+        stdout: process.stdout,
+        stderr: process.stderr,
+    });
+    process.exit(code);
+}
+//# sourceMappingURL=cli.js.map

package/node_modules/checkride/dist/cli.js.map

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

package/node_modules/checkride/dist/config.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Configuration: load `checkride.config.json`, detect installed tools, and
+ * resolve each slot to an adapter (or a skip reason).
+ *
+ * Resolution rule per slot (see plan §4):
+ *   1. config entry wins  — string picks an adapter; `false` disables the slot;
+ *      `{ use, ...overrides }` picks an adapter with overrides; `{ command, args }`
+ *      is a custom check needing no adapter.
+ *   2. otherwise detection — the first registry adapter for the slot whose
+ *      `detect` files exist (or whose `detect` is empty, i.e. always available).
+ *   3. otherwise the slot is skipped (skipped ≠ failed).
+ */
+import type { Adapter, Slot } from './adapters.js';
+/** A custom check: a bare command, no adapter required. */
+export type CustomCheck = {
+    command: string;
+    args?: string[];
+    description?: string;
+    outputFile?: string | null;
+    changedArgs?: string[];
+    fixArgs?: string[];
+    timeout?: number;
+    name?: string;
+    /**
+     * Where a config-only custom check runs relative to the built-in catalogue:
+     * `'first'` (ahead of every built-in check) or `'last'` (after them, the
+     * default). Ignored on entries that fill a catalogue slot — those keep their
+     * fixed catalogue position.
+     */
+    order?: 'first' | 'last';
+};
+/** Pick an adapter by name, with optional field overrides. */
+export type UseConfig = {
+    use: string;
+    command?: string;
+    args?: string[];
+    description?: string;
+    outputFile?: string | null;
+    changedArgs?: string[];
+    fixArgs?: string[];
+    timeout?: number;
+};
+/** Per-slot config: adapter name, `false` to disable, an override, or a custom check. */
+export type SlotConfig = string | false | UseConfig | CustomCheck;
+/** Shape of `checkride.config.json`. */
+export type CheckrideConfig = {
+    checks?: Record<string, SlotConfig>;
+    /** Default per-check timeout in seconds (no cap when unset). `0` on a check disables its cap. */
+    timeout?: number;
+};
+/** A slot resolved to a concrete adapter, or marked skipped with a reason. */
+export type ResolvedCheck = {
+    slot: string;
+    optIn: boolean;
+    adapter: Adapter | null;
+    skip: string | null;
+};
+/** Read and parse `checkride.config.json` from `cwd`, or `null` when absent. */
+export declare function loadConfig(cwd: string): CheckrideConfig | null;
+/**
+ * Resolve every catalogue slot (in order) to an adapter or a skip reason, and
+ * fold in any config-only custom checks (an object with a `command`, keyed by a
+ * name not in the catalogue — e.g. a project's `"licenses"` check). Each custom
+ * check runs ahead of the catalogue (`order: 'first'`) or after it (`'last'`,
+ * the default); within a group, config key order is preserved.
+ */
+export declare function resolveChecks(input: {
+    slots: readonly Slot[];
+    adapters: readonly Adapter[];
+    config: CheckrideConfig | null;
+    cwd?: string;
+    fileExists?: (file: string) => boolean;
+}): ResolvedCheck[];
+//# sourceMappingURL=config.d.ts.map

package/node_modules/checkride/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAKH,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAEnD,2DAA2D;AAC3D,MAAM,MAAM,WAAW,GAAG;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;;OAKG;IACH,KAAK,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;CAC1B,CAAC;AAEF,8DAA8D;AAC9D,MAAM,MAAM,SAAS,GAAG;IACtB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,yFAAyF;AACzF,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,KAAK,GAAG,SAAS,GAAG,WAAW,CAAC;AAElE,wCAAwC;AACxC,MAAM,MAAM,eAAe,GAAG;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACpC,iGAAiG;IACjG,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,8EAA8E;AAC9E,MAAM,MAAM,aAAa,GAAG;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IACxB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACrB,CAAC;AAIF,gFAAgF;AAChF,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAW9D;AAsFD;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE;IACnC,KAAK,EAAE,SAAS,IAAI,EAAE,CAAC;IACvB,QAAQ,EAAE,SAAS,OAAO,EAAE,CAAC;IAC7B,MAAM,EAAE,eAAe,GAAG,IAAI,CAAC;IAC/B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;CACxC,GAAG,aAAa,EAAE,CAoBlB"}