no-mistakes 0.15.0 → 0.16.0

package/README.md

@@ -87,5 +87,6 @@ npx no-mistakes rust-no-inline-tests crates/*/src
 npx no-mistakes rust-max-lines-per-file crates/*/src crates/*/tests
 ```
 
-See the full documentation in [docs/](../../docs/README.md) and the
-[CLI reference](../../docs/cli-reference.md).
+See the full documentation in [docs/](../../docs/README.md), the
+[CLI command index](../../docs/cli/README.md), and the
+[Node/N-API guide](../../docs/node-api.md).

package/index.d.ts

@@ -1,5 +1,7 @@
 import type {
   CheckReport,
+  AnalyzeProjectOptions,
+  AnalyzeProjectResult,
   DependencyResult,
   FetchesOptions,
   GraphEdge,
@@ -27,6 +29,7 @@ export * from "./types";
 export function dependencies(options: TraverseOptions): Promise<DependencyResult>;
 export function dependents(options: TraverseOptions): Promise<DependencyResult>;
 export function related(options: TraverseOptions): Promise<DependencyResult>;
+export function analyzeProject(options: AnalyzeProjectOptions): Promise<AnalyzeProjectResult>;
 export function symbols(options: SymbolsOptions): Promise<SymbolsResult>;
 export function fetches(options?: FetchesOptions): Promise<unknown>;
 export function check(options?: ProjectOptions): Promise<CheckReport>;

package/index.js

@@ -18,6 +18,10 @@ async function related(options) {
   return callJson(native.relatedJson, options);
 }
 
+async function analyzeProject(options) {
+  return callJson(native.analyzeProjectJson, options);
+}
+
 async function symbols(options) {
   return callJson(native.symbolsJson, options);
 }
@@ -115,6 +119,7 @@ async function version() {
 }
 
 module.exports = {
+  analyzeProject,
   check,
   dependencies,
   dependents,

package/package.json

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

package/report-types.d.ts

@@ -8,7 +8,6 @@ export interface PlaywrightOptions {
   allowSkippedTests?: boolean;
   assertUniqueTestIds?: boolean;
   assertUniqueHtmlIds?: boolean;
-  assertUniqueSelectors?: boolean;
 }
 
 export interface PlaywrightRelatedOptions extends PlaywrightOptions {

package/test-types.d.ts

@@ -1,3 +1,5 @@
+import type { SymbolEntrypoint } from "./traversal-types";
+
 export interface TestsPlanOptions {
   framework?: "vitest" | "playwright";
   root?: string;
@@ -9,8 +11,10 @@ export interface TestsPlanOptions {
   changedFilesFile?: string;
   /** Inline unified diff content to extract changed files from. */
   diff?: string;
-  /** file#export entrypoints to trace impact from (union of all). */
-  entrypoints?: string[];
+  /** Entrypoints to trace impact from: strings may use file#export, or pass { file, symbol }. */
+  entrypoints?: Array<string | SymbolEntrypoint>;
+  /** Enables symbol fields in entrypoints and symbol-node traversal. */
+  includeSymbols?: boolean;
   environment?: string;
   limitPercent?: number;
   limitFiles?: number;
@@ -21,8 +25,10 @@ export interface TestsImpactOptions {
   root?: string;
   config?: string;
   tsconfig?: string;
-  /** file#export entrypoints to trace impact from. */
-  entrypoints: string[];
+  /** Entrypoints to trace impact from: strings may use file#export, or pass { file, symbol }. */
+  entrypoints: Array<string | SymbolEntrypoint>;
+  /** Enables symbol fields in entrypoints and symbol-node traversal. */
+  includeSymbols?: boolean;
 }
 
 export interface TestPlan {
@@ -37,6 +43,15 @@ export interface SelectedTest {
   test_file: string;
   confidence: "low" | "medium" | "high";
   reasons: ImpactReason[];
+  targets?: TestExecutionTarget[];
+}
+
+export interface TestExecutionTarget {
+  runner: "vitest" | "playwright";
+  config?: string | null;
+  project?: string | null;
+  base_command: string[];
+  runner_args: string[];
 }
 
 export interface ImpactReason {

package/traversal-types.d.ts

@@ -1,3 +1,5 @@
+import type { PlaywrightOptions, PlaywrightRelatedOptions } from "./report-types";
+
 export type Relationship =
   | "import"
   | "import-static"
@@ -18,7 +20,7 @@ export type Relationship =
   | "all";
 
 export interface TraverseOptions {
-  files: string[];
+  files: Array<string | SymbolEntrypoint>;
   root?: string;
   tsconfig?: string;
   depth?: number;
@@ -26,10 +28,13 @@ export interface TraverseOptions {
   targetModules?: string[];
   tests?: string[];
   relationships?: Relationship[];
+  includeSymbols?: boolean;
 }
 
 export interface DependencyFile {
   path?: string;
+  file?: string;
+  symbol?: string;
   queueFile?: string;
   job?: string;
   module?: string;
@@ -37,6 +42,11 @@ export interface DependencyFile {
   via?: string[];
 }
 
+export interface SymbolEntrypoint {
+  file: string;
+  symbol?: string;
+}
+
 export interface DependencyResult {
   roots: string[];
   files: DependencyFile[];
@@ -106,8 +116,53 @@ export interface ProjectOptions {
   direction?: "deps" | "dependents" | "both";
 }
 
+type BatchedProjectOptions = Omit<ProjectOptions, "root" | "tsconfig" | "config">;
+type BatchedQueueRelatedOptions = BatchedProjectOptions & { files: string[] };
+type BatchedServerRouteRelatedOptions = BatchedProjectOptions &
+  ({ files: string[] } | { roots: string[] });
+
 export interface FetchesOptions {
   root?: string;
   config?: string;
   targets?: string[];
 }
+
+export type AnalyzeProjectReportRequest =
+  | ({ type: "dependencies" | "dependents" | "related"; id?: string } & Omit<
+      TraverseOptions,
+      "root" | "tsconfig"
+    >)
+  | ({ type: "symbols"; id?: string } & SymbolsOptions)
+  | ({ type: "queues" | "queueEdges" | "queueCheck"; id?: string } & BatchedProjectOptions)
+  | ({ type: "queueRelated"; id?: string } & BatchedQueueRelatedOptions)
+  | ({
+      type: "serverRoutes" | "serverRouteList" | "serverRouteEdges";
+      id?: string;
+    } & BatchedProjectOptions)
+  | ({ type: "serverRouteRelated"; id?: string } & BatchedServerRouteRelatedOptions)
+  | ({ type: "reactAnalyze" | "reactCheck"; id?: string } & Pick<
+      ProjectOptions,
+      "targets" | "depth" | "assertNoFetch"
+    >)
+  | ({
+      type: "playwrightCheck" | "playwrightEdges" | "playwrightTests";
+      id?: string;
+    } & Omit<PlaywrightOptions, "root" | "config">)
+  | ({ type: "playwrightRelated"; id?: string } & Omit<PlaywrightRelatedOptions, "root" | "config">)
+  | { type: "check"; id?: string };
+
+export interface AnalyzeProjectOptions {
+  root?: string;
+  tsconfig?: string;
+  config?: string;
+  filters?: string[];
+  reports: AnalyzeProjectReportRequest[];
+}
+
+export interface AnalyzeProjectResult {
+  reports: Array<{
+    id?: string;
+    type: AnalyzeProjectReportRequest["type"];
+    result: unknown;
+  }>;
+}