@c4a/extract-rush 0.7.9 → 0.7.10-alpha.2

package/index.d.ts

@@ -0,0 +1,603 @@
+import { z } from 'zod';
+
+export interface RushSubspaceIndex {
+	name: string;
+	registered: boolean;
+	projectNames: string[];
+}
+export interface RushBuildPhaseImplementation {
+	packageName: string;
+	scriptDefined: boolean;
+	scriptDigest: string | null;
+}
+export interface RushBuildPhaseIndex {
+	name: string;
+	selfDependencies: string[];
+	upstreamDependencies: string[];
+	ignoreMissingScript: boolean;
+	allowWarningsOnSuccess: boolean;
+	projectImplementations: RushBuildPhaseImplementation[];
+}
+export interface RushBuildCommandIndex {
+	name: string;
+	commandKind: "bulk" | "global" | "phased";
+	phases: string[];
+	usesShellCommand: boolean;
+	shellCommandDigest: string | null;
+	ignoreDependencyOrder: boolean;
+	ignoreMissingScript: boolean;
+	enableParallelism: boolean;
+	incremental: boolean;
+}
+export interface RushReleaseUnitIndex {
+	unitRef: string;
+	mode: "lock-step" | "individual" | "standalone";
+	policyName: string | null;
+	definitionName: "lockStepVersion" | "individualVersion" | null;
+	mainProject: string | null;
+	projectNames: string[];
+}
+export interface RushWorkspaceFactDiagnostic {
+	code: "rush-subspace-unregistered" | "rush-version-policy-unresolved";
+	projectName: string;
+	value: string;
+}
+declare const indexerEvidenceAdapterResultSchema: z.ZodEffects<z.ZodObject<{
+	protocol: z.ZodLiteral<"context.indexer.evidence-adapter-result/v1">;
+	adapter: z.ZodObject<{
+		id: z.ZodEffects<z.ZodString, string, string>;
+		package: z.ZodString;
+		export: z.ZodString;
+		version: z.ZodString;
+		digest: z.ZodString;
+	}, "strict", z.ZodTypeAny, {
+		package: string;
+		id: string;
+		version: string;
+		digest: string;
+		export: string;
+	}, {
+		package: string;
+		id: string;
+		version: string;
+		digest: string;
+		export: string;
+	}>;
+	authorized_scope: z.ZodObject<{
+		source_ref: z.ZodString;
+		module_refs: z.ZodArray<z.ZodString, "many">;
+		scope_digest: z.ZodString;
+	}, "strict", z.ZodTypeAny, {
+		source_ref: string;
+		module_refs: string[];
+		scope_digest: string;
+	}, {
+		source_ref: string;
+		module_refs: string[];
+		scope_digest: string;
+	}>;
+	input_digest: z.ZodString;
+	precedence: z.ZodNumber;
+	files: z.ZodArray<z.ZodEffects<z.ZodObject<{
+		file_ref: z.ZodString;
+		source_ref: z.ZodString;
+		module_ref: z.ZodNullable<z.ZodString>;
+		normalized_path: z.ZodEffects<z.ZodString, string, string>;
+		role: z.ZodEnum<[
+			"primary-owner",
+			"enricher"
+		]>;
+		coverage_tier: z.ZodEnum<[
+			"ast-catalog",
+			"lightweight-evidence"
+		]>;
+		disposition: z.ZodEnum<[
+			"analyzed",
+			"unsupported",
+			"excluded"
+		]>;
+		facts: z.ZodArray<z.ZodObject<{
+			fact_ref: z.ZodString;
+			kind: z.ZodEffects<z.ZodString, string, string>;
+			locator: z.ZodObject<{
+				source_ref: z.ZodString;
+				module_ref: z.ZodNullable<z.ZodString>;
+				normalized_path: z.ZodEffects<z.ZodString, string, string>;
+				qualified_item_path: z.ZodString;
+				signature_digest: z.ZodString;
+			}, "strict", z.ZodTypeAny, {
+				source_ref: string;
+				module_ref: string | null;
+				normalized_path: string;
+				qualified_item_path: string;
+				signature_digest: string;
+			}, {
+				source_ref: string;
+				module_ref: string | null;
+				normalized_path: string;
+				qualified_item_path: string;
+				signature_digest: string;
+			}>;
+			payload_digest: z.ZodString;
+			denominator: z.ZodEnum<[
+				"none",
+				"eligible-file",
+				"loc",
+				"symbol",
+				"protocol-item"
+			]>;
+		}, "strict", z.ZodTypeAny, {
+			kind: string;
+			fact_ref: string;
+			locator: {
+				source_ref: string;
+				module_ref: string | null;
+				normalized_path: string;
+				qualified_item_path: string;
+				signature_digest: string;
+			};
+			payload_digest: string;
+			denominator: "symbol" | "none" | "eligible-file" | "loc" | "protocol-item";
+		}, {
+			kind: string;
+			fact_ref: string;
+			locator: {
+				source_ref: string;
+				module_ref: string | null;
+				normalized_path: string;
+				qualified_item_path: string;
+				signature_digest: string;
+			};
+			payload_digest: string;
+			denominator: "symbol" | "none" | "eligible-file" | "loc" | "protocol-item";
+		}>, "many">;
+	}, "strict", z.ZodTypeAny, {
+		source_ref: string;
+		module_ref: string | null;
+		normalized_path: string;
+		file_ref: string;
+		role: "primary-owner" | "enricher";
+		coverage_tier: "ast-catalog" | "lightweight-evidence";
+		disposition: "analyzed" | "unsupported" | "excluded";
+		facts: {
+			kind: string;
+			fact_ref: string;
+			locator: {
+				source_ref: string;
+				module_ref: string | null;
+				normalized_path: string;
+				qualified_item_path: string;
+				signature_digest: string;
+			};
+			payload_digest: string;
+			denominator: "symbol" | "none" | "eligible-file" | "loc" | "protocol-item";
+		}[];
+	}, {
+		source_ref: string;
+		module_ref: string | null;
+		normalized_path: string;
+		file_ref: string;
+		role: "primary-owner" | "enricher";
+		coverage_tier: "ast-catalog" | "lightweight-evidence";
+		disposition: "analyzed" | "unsupported" | "excluded";
+		facts: {
+			kind: string;
+			fact_ref: string;
+			locator: {
+				source_ref: string;
+				module_ref: string | null;
+				normalized_path: string;
+				qualified_item_path: string;
+				signature_digest: string;
+			};
+			payload_digest: string;
+			denominator: "symbol" | "none" | "eligible-file" | "loc" | "protocol-item";
+		}[];
+	}>, {
+		source_ref: string;
+		module_ref: string | null;
+		normalized_path: string;
+		file_ref: string;
+		role: "primary-owner" | "enricher";
+		coverage_tier: "ast-catalog" | "lightweight-evidence";
+		disposition: "analyzed" | "unsupported" | "excluded";
+		facts: {
+			kind: string;
+			fact_ref: string;
+			locator: {
+				source_ref: string;
+				module_ref: string | null;
+				normalized_path: string;
+				qualified_item_path: string;
+				signature_digest: string;
+			};
+			payload_digest: string;
+			denominator: "symbol" | "none" | "eligible-file" | "loc" | "protocol-item";
+		}[];
+	}, {
+		source_ref: string;
+		module_ref: string | null;
+		normalized_path: string;
+		file_ref: string;
+		role: "primary-owner" | "enricher";
+		coverage_tier: "ast-catalog" | "lightweight-evidence";
+		disposition: "analyzed" | "unsupported" | "excluded";
+		facts: {
+			kind: string;
+			fact_ref: string;
+			locator: {
+				source_ref: string;
+				module_ref: string | null;
+				normalized_path: string;
+				qualified_item_path: string;
+				signature_digest: string;
+			};
+			payload_digest: string;
+			denominator: "symbol" | "none" | "eligible-file" | "loc" | "protocol-item";
+		}[];
+	}>, "many">;
+	diagnostics: z.ZodArray<z.ZodObject<{
+		code: z.ZodEffects<z.ZodString, string, string>;
+		fact_ref: z.ZodOptional<z.ZodString>;
+		severity: z.ZodEnum<[
+			"info",
+			"warning",
+			"error"
+		]>;
+		detail_digest: z.ZodString;
+	}, "strict", z.ZodTypeAny, {
+		code: string;
+		severity: "warning" | "info" | "error";
+		detail_digest: string;
+		fact_ref?: string | undefined;
+	}, {
+		code: string;
+		severity: "warning" | "info" | "error";
+		detail_digest: string;
+		fact_ref?: string | undefined;
+	}>, "many">;
+	toolchain: z.ZodArray<z.ZodEffects<z.ZodObject<{
+		step: z.ZodEffects<z.ZodString, string, string>;
+		package: z.ZodString;
+		export: z.ZodString;
+		version: z.ZodString;
+		digest: z.ZodString;
+		capabilities: z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">;
+		input_digest: z.ZodString;
+		output_digest: z.ZodString;
+	}, "strict", z.ZodTypeAny, {
+		package: string;
+		version: string;
+		digest: string;
+		export: string;
+		step: string;
+		capabilities: string[];
+		input_digest: string;
+		output_digest: string;
+	}, {
+		package: string;
+		version: string;
+		digest: string;
+		export: string;
+		step: string;
+		capabilities: string[];
+		input_digest: string;
+		output_digest: string;
+	}>, {
+		package: string;
+		version: string;
+		digest: string;
+		export: string;
+		step: string;
+		capabilities: string[];
+		input_digest: string;
+		output_digest: string;
+	}, {
+		package: string;
+		version: string;
+		digest: string;
+		export: string;
+		step: string;
+		capabilities: string[];
+		input_digest: string;
+		output_digest: string;
+	}>, "many">;
+	output_digest: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+	diagnostics: {
+		code: string;
+		severity: "warning" | "info" | "error";
+		detail_digest: string;
+		fact_ref?: string | undefined;
+	}[];
+	input_digest: string;
+	output_digest: string;
+	protocol: "context.indexer.evidence-adapter-result/v1";
+	adapter: {
+		package: string;
+		id: string;
+		version: string;
+		digest: string;
+		export: string;
+	};
+	authorized_scope: {
+		source_ref: string;
+		module_refs: string[];
+		scope_digest: string;
+	};
+	precedence: number;
+	files: {
+		source_ref: string;
+		module_ref: string | null;
+		normalized_path: string;
+		file_ref: string;
+		role: "primary-owner" | "enricher";
+		coverage_tier: "ast-catalog" | "lightweight-evidence";
+		disposition: "analyzed" | "unsupported" | "excluded";
+		facts: {
+			kind: string;
+			fact_ref: string;
+			locator: {
+				source_ref: string;
+				module_ref: string | null;
+				normalized_path: string;
+				qualified_item_path: string;
+				signature_digest: string;
+			};
+			payload_digest: string;
+			denominator: "symbol" | "none" | "eligible-file" | "loc" | "protocol-item";
+		}[];
+	}[];
+	toolchain: {
+		package: string;
+		version: string;
+		digest: string;
+		export: string;
+		step: string;
+		capabilities: string[];
+		input_digest: string;
+		output_digest: string;
+	}[];
+}, {
+	diagnostics: {
+		code: string;
+		severity: "warning" | "info" | "error";
+		detail_digest: string;
+		fact_ref?: string | undefined;
+	}[];
+	input_digest: string;
+	output_digest: string;
+	protocol: "context.indexer.evidence-adapter-result/v1";
+	adapter: {
+		package: string;
+		id: string;
+		version: string;
+		digest: string;
+		export: string;
+	};
+	authorized_scope: {
+		source_ref: string;
+		module_refs: string[];
+		scope_digest: string;
+	};
+	precedence: number;
+	files: {
+		source_ref: string;
+		module_ref: string | null;
+		normalized_path: string;
+		file_ref: string;
+		role: "primary-owner" | "enricher";
+		coverage_tier: "ast-catalog" | "lightweight-evidence";
+		disposition: "analyzed" | "unsupported" | "excluded";
+		facts: {
+			kind: string;
+			fact_ref: string;
+			locator: {
+				source_ref: string;
+				module_ref: string | null;
+				normalized_path: string;
+				qualified_item_path: string;
+				signature_digest: string;
+			};
+			payload_digest: string;
+			denominator: "symbol" | "none" | "eligible-file" | "loc" | "protocol-item";
+		}[];
+	}[];
+	toolchain: {
+		package: string;
+		version: string;
+		digest: string;
+		export: string;
+		step: string;
+		capabilities: string[];
+		input_digest: string;
+		output_digest: string;
+	}[];
+}>, {
+	diagnostics: {
+		code: string;
+		severity: "warning" | "info" | "error";
+		detail_digest: string;
+		fact_ref?: string | undefined;
+	}[];
+	input_digest: string;
+	output_digest: string;
+	protocol: "context.indexer.evidence-adapter-result/v1";
+	adapter: {
+		package: string;
+		id: string;
+		version: string;
+		digest: string;
+		export: string;
+	};
+	authorized_scope: {
+		source_ref: string;
+		module_refs: string[];
+		scope_digest: string;
+	};
+	precedence: number;
+	files: {
+		source_ref: string;
+		module_ref: string | null;
+		normalized_path: string;
+		file_ref: string;
+		role: "primary-owner" | "enricher";
+		coverage_tier: "ast-catalog" | "lightweight-evidence";
+		disposition: "analyzed" | "unsupported" | "excluded";
+		facts: {
+			kind: string;
+			fact_ref: string;
+			locator: {
+				source_ref: string;
+				module_ref: string | null;
+				normalized_path: string;
+				qualified_item_path: string;
+				signature_digest: string;
+			};
+			payload_digest: string;
+			denominator: "symbol" | "none" | "eligible-file" | "loc" | "protocol-item";
+		}[];
+	}[];
+	toolchain: {
+		package: string;
+		version: string;
+		digest: string;
+		export: string;
+		step: string;
+		capabilities: string[];
+		input_digest: string;
+		output_digest: string;
+	}[];
+}, {
+	diagnostics: {
+		code: string;
+		severity: "warning" | "info" | "error";
+		detail_digest: string;
+		fact_ref?: string | undefined;
+	}[];
+	input_digest: string;
+	output_digest: string;
+	protocol: "context.indexer.evidence-adapter-result/v1";
+	adapter: {
+		package: string;
+		id: string;
+		version: string;
+		digest: string;
+		export: string;
+	};
+	authorized_scope: {
+		source_ref: string;
+		module_refs: string[];
+		scope_digest: string;
+	};
+	precedence: number;
+	files: {
+		source_ref: string;
+		module_ref: string | null;
+		normalized_path: string;
+		file_ref: string;
+		role: "primary-owner" | "enricher";
+		coverage_tier: "ast-catalog" | "lightweight-evidence";
+		disposition: "analyzed" | "unsupported" | "excluded";
+		facts: {
+			kind: string;
+			fact_ref: string;
+			locator: {
+				source_ref: string;
+				module_ref: string | null;
+				normalized_path: string;
+				qualified_item_path: string;
+				signature_digest: string;
+			};
+			payload_digest: string;
+			denominator: "symbol" | "none" | "eligible-file" | "loc" | "protocol-item";
+		}[];
+	}[];
+	toolchain: {
+		package: string;
+		version: string;
+		digest: string;
+		export: string;
+		step: string;
+		capabilities: string[];
+		input_digest: string;
+		output_digest: string;
+	}[];
+}>;
+type IndexerEvidenceAdapterResult = z.infer<typeof indexerEvidenceAdapterResultSchema>;
+type IndexerEvidenceAdapterFactPayloadValue = null | boolean | number | string | IndexerEvidenceAdapterFactPayloadValue[] | {
+	[key: string]: IndexerEvidenceAdapterFactPayloadValue;
+};
+interface IndexerEvidenceAdapterFactPayload {
+	fact_ref: string;
+	payload: IndexerEvidenceAdapterFactPayloadValue;
+}
+interface IndexerEvidenceAdapterMaterialization {
+	result: IndexerEvidenceAdapterResult;
+	fact_payloads: IndexerEvidenceAdapterFactPayload[];
+}
+export interface RushEvidenceAdapterInvocation {
+	adapter: IndexerEvidenceAdapterResult["adapter"];
+	authorized_scope: IndexerEvidenceAdapterResult["authorized_scope"];
+	input_digest: string;
+	precedence: number;
+	workspace_module_ref: string | null;
+	project_module_refs: Readonly<Record<string, string>>;
+	role?: "primary-owner" | "enricher";
+}
+/** Converts the Rush structural catalog into the same ABI used by language parsers. */
+export declare function rushWorkspaceIndexToEvidenceAdapterResult(index: RushWorkspaceIndex, invocation: RushEvidenceAdapterInvocation): IndexerEvidenceAdapterResult;
+/** Builds the Rush wire result and its process-local structured fact sidecar. */
+export declare function rushWorkspaceIndexToEvidenceAdapterMaterialization(index: RushWorkspaceIndex, invocation: RushEvidenceAdapterInvocation): IndexerEvidenceAdapterMaterialization;
+export interface RushWorkspaceDependency {
+	packageName: string;
+	kinds: string[];
+	specifiers: string[];
+	decoupled: boolean;
+}
+export interface RushOwnerBoundary {
+	file: string;
+	reviewers: string[];
+}
+export interface RushProjectIndex {
+	packageName: string;
+	packageNameMatches: boolean;
+	projectFolder: string;
+	subspaceName: string;
+	tags: string[];
+	shouldPublish: boolean;
+	entrySignals: string[];
+	workspaceDependencies: RushWorkspaceDependency[];
+	workspaceDependents: string[];
+	owner: RushOwnerBoundary | null;
+	packageJsonFile: string | null;
+	versionPolicyName: string | null;
+	publishFolder: string | null;
+	releaseUnitRef: string | null;
+}
+export interface RushWorkspaceIndex {
+	rushFile: string;
+	rushVersion: string;
+	pnpmVersion: string | null;
+	nodeSupportedVersionRange: string | null;
+	selectedTags: string[];
+	projects: RushProjectIndex[];
+	ownerBoundaries: RushOwnerBoundary[];
+	subspacesFile: string | null;
+	subspacesEnabled: boolean;
+	preventSelectingAllSubspaces: boolean;
+	subspaces: RushSubspaceIndex[];
+	commandLineFile: string | null;
+	buildPhases: RushBuildPhaseIndex[];
+	buildCommands: RushBuildCommandIndex[];
+	versionPoliciesFile: string | null;
+	releaseUnits: RushReleaseUnitIndex[];
+	diagnostics: RushWorkspaceFactDiagnostic[];
+}
+export interface RushIndexOptions {
+	tags?: readonly string[];
+	includeAll?: boolean;
+}
+export declare function indexRushWorkspace(repositoryRoot: string, options?: RushIndexOptions): Promise<RushWorkspaceIndex>;
+
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@c4a/extract-rush",
-  "version": "0.7.9",
+  "version": "0.7.10-alpha.2",
   "type": "module",
   "description": "Rush workspace structural index for Context",
   "license": "MIT",
@@ -21,7 +21,9 @@
   },
   "dependencies": {
     "typescript": "^5.5.4",
-    "yaml": "^2.5.1"
+    "yaml": "^2.5.1",
+    "zod": "^3.23.8"
   },
-  "main": "./index.js"
+  "main": "./index.js",
+  "types": "./index.d.ts"
 }