no-mistakes 0.33.0 → 0.33.1

package/README.md

@@ -77,6 +77,8 @@ const {
   });
   const projectCheck = await check({
     root: process.cwd(),
+    // Path to tsconfig.json for alias resolution; searched upward if omitted.
+    // In monorepos, pass the workspace-scoped tsconfig (e.g. "web/tsconfig.json").
     tsconfig: "tsconfig.json",
   });
   const localFlow = await flow({

package/analyze-project-types.d.ts

@@ -55,8 +55,11 @@ export type AnalyzeProjectReportRequest =
   | ({ type: "check"; id?: string } & BatchedCheckOptions);
 
 export interface AnalyzeProjectOptions {
+  /** Project root. Defaults to the current working directory. */
   root?: string;
+  /** Path to tsconfig.json for alias resolution. Searched upward if omitted. */
   tsconfig?: string;
+  /** Path to the no-mistakes config file (e.g. .no-mistakes.yml). Auto-discovered in root if omitted. */
   config?: string;
   filters?: string[];
   reports: AnalyzeProjectReportRequest[];

package/ci-types.d.ts

@@ -3,22 +3,29 @@
 // snake_case to match the serde-serialized output.
 
 export interface CiImpactOptions {
+  /** Project root. Defaults to the current working directory. */
   root?: string;
+  /** Path to the no-mistakes config file (e.g. .no-mistakes.yml). Auto-discovered in root if omitted. */
   config?: string;
   /** Changed file paths (relative to root or absolute). */
   files: string[];
 }
 
 export interface CiEnvOptions {
+  /** Project root. Defaults to the current working directory. */
   root?: string;
+  /** Path to the no-mistakes config file (e.g. .no-mistakes.yml). Auto-discovered in root if omitted. */
   config?: string;
   /** Environment variable name (case-sensitive). */
   var: string;
 }
 
 export interface ImpactedChecksOptions {
+  /** Project root. Defaults to the current working directory. */
   root?: string;
+  /** Path to the no-mistakes config file (e.g. .no-mistakes.yml). Auto-discovered in root if omitted. */
   config?: string;
+  /** Path to tsconfig.json for alias resolution. Searched upward if omitted. */
   tsconfig?: string;
   base?: string;
   head?: string;

package/flow-types.d.ts

@@ -2,8 +2,11 @@ import type { Relationship } from "./traversal-types";
 
 export interface FlowOptions {
   target: string;
+  /** Project root. Defaults to the current working directory. */
   root?: string;
+  /** Path to tsconfig.json for alias resolution. Searched upward if omitted. */
   tsconfig?: string;
+  /** Path to the no-mistakes config file (e.g. .no-mistakes.yml). Auto-discovered in root if omitted. */
   config?: string;
   direction?: "deps" | "dependents" | "both";
   depth?: number;
@@ -35,7 +38,9 @@ export interface FlowReport {
 }
 
 export interface FetchesOptions {
+  /** Project root. Defaults to the current working directory. */
   root?: string;
+  /** Path to the no-mistakes config file (e.g. .no-mistakes.yml). Auto-discovered in root if omitted. */
   config?: string;
   targets?: string[];
 }

package/import-usage-types.d.ts

@@ -16,6 +16,7 @@ export interface ImportUsageFile {
 
 export interface ImportUsagesOptions {
   files?: string[];
+  /** Project root. Defaults to the current working directory. */
   root?: string;
   scanRoots?: string[];
   filters?: string[];

package/named-query-types.d.ts

@@ -1,7 +1,9 @@
 // Named query modes (issue #419): data-pw, effects, rsc-callers, registry-extension.
 
 export interface DataPwOptions {
+  /** Project root. Defaults to the current working directory. */
   root?: string;
+  /** Path to the no-mistakes config file (e.g. .no-mistakes.yml). Auto-discovered in root if omitted. */
   config?: string;
   /** The selector-attribute value to find (e.g. `search-bar`). */
   value: string;
@@ -29,8 +31,11 @@ export interface DataPwReport {
 }
 
 export interface EffectsOptions {
+  /** Project root. Defaults to the current working directory. */
   root?: string;
+  /** Path to tsconfig.json for alias resolution. Searched upward if omitted. */
   tsconfig?: string;
+  /** Path to the no-mistakes config file (e.g. .no-mistakes.yml). Auto-discovered in root if omitted. */
   config?: string;
   /** Effect kind to resolve (a key under `effects:` in config). */
   kind: string;
@@ -59,8 +64,11 @@ export interface EffectsReport {
 }
 
 export interface RscCallersOptions {
+  /** Project root. Defaults to the current working directory. */
   root?: string;
+  /** Path to tsconfig.json for alias resolution. Searched upward if omitted. */
   tsconfig?: string;
+  /** Path to the no-mistakes config file (e.g. .no-mistakes.yml). Auto-discovered in root if omitted. */
   config?: string;
   /** Component file to find RSC callers of. */
   component: string;
@@ -81,6 +89,7 @@ export interface RscCallersReport {
 }
 
 export interface RegistryExtensionOptions {
+  /** Project root. Defaults to the current working directory. */
   root?: string;
   /** Registry file to summarize the entry pattern of. */
   registryFile: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "no-mistakes",
-  "version": "0.33.0",
+  "version": "0.33.1",
   "description": "Static codebase analysis tools for TS/JS dependencies, dependents, and symbols",
   "license": "MIT",
   "repository": {

package/report-types.d.ts

@@ -1,5 +1,7 @@
 export interface PlaywrightOptions {
+  /** Project root. Defaults to the current working directory. */
   root?: string;
+  /** Path to the no-mistakes config file (e.g. .no-mistakes.yml). Auto-discovered in root if omitted. */
   config?: string;
   playwrightConfig?: string[];
   project?: string;
@@ -40,7 +42,9 @@ export interface GraphEdge {
 }
 
 export interface InfraOptions {
+  /** Project root. Defaults to the current working directory. */
   root?: string;
+  /** Path to the no-mistakes config file (e.g. .no-mistakes.yml). Auto-discovered in root if omitted. */
   config?: string;
   /** `infraResourceRefs` address (`<type>.<name>`). */
   address?: string;
@@ -79,7 +83,9 @@ export interface TestForRow {
 }
 
 export interface SwiftOptions {
+  /** Project root. Defaults to the current working directory. */
   root?: string;
+  /** Path to the no-mistakes config file (e.g. .no-mistakes.yml). Auto-discovered in root if omitted. */
   config?: string;
   /** The Swift source file to query (relative to root). */
   file?: string;

package/scripts/install/retry.js

@@ -1,8 +1,14 @@
 "use strict";
 
-const DEFAULT_MAX_ATTEMPTS = 4;
-const DEFAULT_RETRY_BASE_MS = 500;
-const RETRY_MAX_DELAY_MS = 4_000;
+// A GitHub Releases asset download or its separate .sha256 checksum fetch can
+// hit a short-lived CDN 5xx, timeout, or connection reset. These defaults give
+// each network operation a bounded multi-attempt window (~15s avg / ~31s worst
+// case total sleep) to ride that out, rather than exhausting a tiny budget in a
+// few seconds. Override via NO_MISTAKES_DOWNLOAD_MAX_ATTEMPTS /
+// NO_MISTAKES_DOWNLOAD_RETRY_BASE_MS.
+const DEFAULT_MAX_ATTEMPTS = 6;
+const DEFAULT_RETRY_BASE_MS = 1_000;
+const RETRY_MAX_DELAY_MS = 30_000;
 const RETRYABLE_NETWORK_CODES = new Set([
   "ECONNRESET",
   "ECONNREFUSED",

package/test-types.d.ts

@@ -2,8 +2,11 @@ import type { SymbolEntrypoint } from "./traversal-types";
 
 export interface TestsPlanOptions {
   framework?: "vitest" | "playwright" | "dotnet" | "swift";
+  /** Project root. Defaults to the current working directory. */
   root?: string;
+  /** Path to the no-mistakes config file (e.g. .no-mistakes.yml). Auto-discovered in root if omitted. */
   config?: string;
+  /** Path to tsconfig.json for alias resolution. Searched upward if omitted. */
   tsconfig?: string;
   base?: string;
   head?: string;
@@ -24,8 +27,11 @@ export interface TestsPlanOptions {
 }
 
 export interface TestsImpactOptions {
+  /** Project root. Defaults to the current working directory. */
   root?: string;
+  /** Path to the no-mistakes config file (e.g. .no-mistakes.yml). Auto-discovered in root if omitted. */
   config?: string;
+  /** Path to tsconfig.json for alias resolution. Searched upward if omitted. */
   tsconfig?: string;
   /** Entrypoints to trace impact from: strings may use file#export, or pass { file, symbol }. */
   entrypoints: Array<string | SymbolEntrypoint>;
@@ -35,7 +41,9 @@ export interface TestsImpactOptions {
 
 export interface TestsTargetsOptions {
   framework: "vitest" | "playwright" | "dotnet" | "swift";
+  /** Project root. Defaults to the current working directory. */
   root?: string;
+  /** Path to the no-mistakes config file (e.g. .no-mistakes.yml). Auto-discovered in root if omitted. */
   config?: string;
   files: string[];
 }
@@ -100,8 +108,11 @@ export interface TestTargetWarning {
 }
 
 export interface TestsWhyOptions {
+  /** Project root. Defaults to the current working directory. */
   root?: string;
+  /** Path to the no-mistakes config file (e.g. .no-mistakes.yml). Auto-discovered in root if omitted. */
   config?: string;
+  /** Path to tsconfig.json for alias resolution. Searched upward if omitted. */
   tsconfig?: string;
   test: string;
   changed?: string;
@@ -124,6 +135,7 @@ export interface TestGraph {
 }
 
 export interface LockfileDiffOptions {
+  /** Project root. Defaults to the current working directory. */
   root?: string;
   base: string;
   head?: string;

package/traversal-types.d.ts

@@ -23,7 +23,9 @@ export type Relationship =
 
 export interface TraverseOptions {
   files: Array<string | SymbolEntrypoint>;
+  /** Project root. Defaults to the current working directory. */
   root?: string;
+  /** Path to tsconfig.json for alias resolution. Searched upward if omitted. */
   tsconfig?: string;
   depth?: number;
   filters?: string[];
@@ -68,8 +70,11 @@ export type ExportKind =
 
 export interface SymbolsOptions {
   files: string[];
+  /** Project root. Defaults to the current working directory. */
   root?: string;
+  /** Path to tsconfig.json for alias resolution. Searched upward if omitted. */
   tsconfig?: string;
+  /** Path to the no-mistakes config file (e.g. .no-mistakes.yml). Auto-discovered in root if omitted. */
   config?: string;
   mode?: "list" | "signature-impact";
   symbol?: string;
@@ -155,8 +160,11 @@ export interface SignatureImpactResult {
 }
 
 export interface ProjectOptions {
+  /** Project root. Defaults to the current working directory. */
   root?: string;
+  /** Path to tsconfig.json for alias resolution. Searched upward if omitted. */
   tsconfig?: string;
+  /** Path to the no-mistakes config file (e.g. .no-mistakes.yml). Auto-discovered in root if omitted. */
   config?: string;
   filters?: string[];
   targets?: string[];