no-mistakes 0.48.3 → 0.49.0

package/index-ci-infra.d.ts

@@ -7,6 +7,8 @@ import type {
   CiImpactOptions,
   CiImpactReport,
   CiTopologyOptions,
+  CiTopologyImpactOptions,
+  CiTopologyImpactReport,
   DataPwOptions,
   DataPwReport,
   EffectsOptions,
@@ -39,6 +41,9 @@ export function ciEnv(options: WithInvocationOptions<CiEnvOptions>): Promise<CiE
 export function ciTopology(
   options?: WithInvocationOptions<CiTopologyOptions>,
 ): Promise<WorkflowTopology>;
+export function ciTopologyImpact(
+  options: WithInvocationOptions<CiTopologyImpactOptions>,
+): Promise<CiTopologyImpactReport>;
 /** Builds a query index over a `ciTopology()` result. Pure JS — never crosses the N-API boundary. */
 export function createWorkflowTopologyIndex(topology: WorkflowTopology): WorkflowTopologyIndex;
 export function impactedChecks(

package/index.js

@@ -30,6 +30,7 @@ const jsonApis = createJsonApis({
   ciEnv: "ciEnvJson",
   ciImpact: "ciImpactJson",
   ciTopology: "ciTopologyJson",
+  ciTopologyImpact: "ciTopologyImpactJson",
   dataPw: "dataPwJson",
   deadExports: "deadExportsJson",
   dependencies: "dependenciesJson",
@@ -145,6 +146,7 @@ module.exports.resolveConfig = jsonApis.resolveConfig;
 module.exports.ciEnv = jsonApis.ciEnv;
 module.exports.ciImpact = jsonApis.ciImpact;
 module.exports.ciTopology = ciTopology;
+module.exports.ciTopologyImpact = jsonApis.ciTopologyImpact;
 module.exports.dataPw = jsonApis.dataPw;
 module.exports.deadExports = jsonApis.deadExports;
 module.exports.dependencies = jsonApis.dependencies;

package/index.mjs

@@ -10,6 +10,7 @@ export const {
   ciEnv,
   ciImpact,
   ciTopology,
+  ciTopologyImpact,
   createWorkflowTopologyIndex,
   dataPw,
   deadExports,

package/package.json

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

package/workflow-topology-impact-types.d.ts

@@ -0,0 +1,32 @@
+/** Revision-aware impact routing over an entry GitHub Actions workflow. */
+export interface CiTopologyImpactOptions {
+  /** Project root. Defaults to the current working directory. */
+  root?: string;
+  /** Exact Git revision, e.g. a pull request base SHA. */
+  base: string;
+  /** Exact Git revision, e.g. GitHub's tested merge SHA. */
+  head: string;
+  /** Workflow path or basename, restricted to `.github/workflows`. */
+  entryWorkflow: string;
+}
+
+export interface CiTopologyImpactDiagnostic {
+  code: string;
+  message: string;
+  workflowPath?: string;
+  /** Whether the diagnostic maps completely to entry-workflow jobs. */
+  scope: "localized" | "global";
+  /** Sorted entry job IDs when and only when `scope` is `localized`. */
+  rootJobIds?: string[];
+}
+
+export interface CiTopologyImpactReport {
+  schemaVersion: 1;
+  baseRevision: string;
+  headRevision: string;
+  changedPaths: string[];
+  affectedWorkflows: string[];
+  affectedRootJobIds: string[];
+  diagnostics: CiTopologyImpactDiagnostic[];
+  globalFallback: boolean;
+}

package/workflow-topology-types.d.ts

@@ -7,6 +7,7 @@
 
 import type { ArtifactDeclaration, ArtifactEdge } from "./workflow-topology-artifact-types";
 import type { ResolvedPermissions } from "./ci-types";
+export * from "./workflow-topology-impact-types";
 
 export * from "./workflow-topology-artifact-types";
 export * from "./workflow-topology-index-types";