qfai 2.1.2 → 2.2.0

package/dist/index.d.cts

@@ -1,3 +1,5 @@
+import { G as GraphProcess } from './process-C21nTvkT.cjs';
+
 type IssueSeverity = "info" | "warning" | "error";
 type IssueCategory = "canonical" | "change";
 type IssueLocation = {
@@ -93,6 +95,16 @@ type ValidationTimings = {
     uiuxBudgetMs: number;
     htmlMockMs: number;
     htmlMockBudgetMs: number;
+    /**
+     * What each validator of the UI/UX group took, slowest first. The validators run side by side
+     * on one event loop, so each time includes waiting for the others: the parts overlap, do not
+     * add up to `uiuxMs`, and can credit a fast validator with another's time. They say where to
+     * look, not how the time divides.
+     */
+    uiuxParts: readonly {
+        name: string;
+        ms: number;
+    }[];
 };
 type ValidationResult = {
     toolVersion: string;
@@ -605,6 +617,17 @@ type ValidationOptions = {
     flowIds?: readonly string[];
 };
 declare function validateProject(root: string, configResult?: ConfigLoadResult, options?: ValidationOptions): Promise<ValidationResult>;
+/**
+ * The parts of the UI/UX group, slowest first. The html-mock part leaves out the one-off load of
+ * its parser, as the group's own time does.
+ */
+declare function orderUiuxParts(parts: readonly {
+    name: string;
+    ms: number;
+}[], htmlMockLoadMs: number): {
+    name: string;
+    ms: number;
+}[];
 /**
  * Count findings by severity, skipping suppressed ones. `counts` is the SSOT
  * every gate reads, so anything that rebuilds a `ValidationResult` from an
@@ -716,6 +739,44 @@ declare function classifyAgainstDeclaration(declaringDir: string, packageDir: st
  * statement but still a statement.
  */
 declare function findDeclaringDir(root: string): Promise<string | null>;
+/**
+ * The range the nearest `package.json` declaring qfai gives it, or `null` when
+ * no manifest at or above `root` declares it with a text range.
+ *
+ * Read from the manifest {@link findDeclaringDir} stops at, so the range and the
+ * directory it is compared against are one declaration.
+ */
+declare function readDeclaredQfaiRange(root: string): Promise<string | null>;
+/**
+ * The lowest version a dependency range admits, as `x.y.z`, or `null` when the
+ * range does not state one this reads.
+ *
+ * Only the forms a project writes for a pinned dependency are read: an exact
+ * version, and a caret, tilde or `>=` range, each optionally followed by more
+ * comparators (`>=2.1.1 <3`). A tag (`latest`), a wildcard (`2.x`), an
+ * alternative (`||`), a protocol (`workspace:`, `file:`, `github:`) and a
+ * partial version (`^2.1`) answer `null`, so nothing is compared against them.
+ */
+declare function lowestVersionOfRange(range: string): string | null;
+/** Whether `version` is strictly older than `other`; `false` where either is unreadable. */
+declare function isOlderVersion(version: string, other: string): boolean;
+/** An installed qfai that is older than the version the project declares. */
+type InstalledOlderThanDeclared = {
+    readonly installed: string;
+    readonly declaredRange: string;
+    readonly declaredLowest: string;
+};
+/**
+ * Whether the running qfai is older than the lowest version this project's
+ * dependency declaration admits.
+ *
+ * The declaration is the only record of "the qfai this tree was written for"
+ * that a project keeps: the files `qfai init` writes carry no version. An
+ * installed copy below that floor is the state a lockfile that moved after the
+ * last install leaves, and every rule whose input is a generated file can then
+ * disagree with the tree for a reason that is not in the tree.
+ */
+declare function compareInstalledToDeclared(installed: string, declaredRange: string | null): InstalledOlderThanDeclared | null;
 /**
  * Whether `packageDir` is an installed copy resolved from outside `root`.
  *
@@ -911,7 +972,74 @@ declare const DESIGN_MD_SAMPLE_MARKER = "QFAI-SAMPLE-DESIGN-MD";
  */
 declare function isUnreplacedDesignMdSample(text: unknown): boolean;
 
+interface GraphPreparation {
+    runtime: "installed" | "not-ready";
+    tools?: {
+        codegraph: "installed" | "not-ready";
+        graphify: "installed" | "not-ready";
+    };
+    code: "code-ready" | "code-not-ready";
+    documents: "documents-not-ready";
+    failedStep?: string;
+    recovery?: string;
+    previousInstallation?: "retained" | "none";
+}
+
+type GraphHookHost = "claude" | "codex" | "copilot" | "vscode";
+
+interface GraphHostFacts {
+    host: GraphHookHost;
+    version?: string;
+    configuration: "configured" | "not-configured" | "failed";
+    denialEvent?: string;
+    failureProtocol?: "supported" | "unsupported" | "unverified";
+    trust: "required" | "granted" | "not-required" | "unknown";
+}
+interface GraphHostProtection {
+    host: GraphHookHost;
+    version?: string;
+    state: "configured" | "trust-required" | "runtime-verified" | "unsupported" | "failed";
+    events: readonly string[];
+    recovery: string;
+    configuration?: GraphHostFacts["configuration"];
+    trust?: GraphHostFacts["trust"];
+}
+
+interface GraphSettingsComposition {
+    files: string[];
+    conflicts: string[];
+}
+
+type GraphIntegrationPreparation = GraphPreparation & GraphSettingsComposition & {
+    hosts: GraphHostProtection[];
+};
+declare function prepareGraphIntegration(root: string, run?: GraphProcess): Promise<GraphIntegrationPreparation>;
+
+declare function renderGraphPreparation(preparation: GraphPreparation, hosts?: readonly GraphHostProtection[]): string;
+
+interface GraphReuseEnvironment {
+    platform: string;
+    architecture: string;
+    machine: string;
+}
+
+interface DocumentPreparation {
+    status: "prepared" | "not-ready" | "failed";
+    source?: "current" | "restored" | "generated";
+    reuse?: "published" | "unavailable";
+    recovery?: string;
+}
+interface ExternalProcessingRequest {
+    readonly destination: string;
+    readonly scope: readonly string[];
+    readonly backend: string;
+    readonly model: string;
+    readonly worktree: string;
+}
+type ApproveExternalProcessing = (request: ExternalProcessingRequest) => Promise<boolean>;
+declare function prepareDocumentAnalysis(root: string, run?: GraphProcess, approveExternal?: ApproveExternalProcessing, environment?: GraphReuseEnvironment): Promise<DocumentPreparation>;
+
 /** Run one ordered spec-to-story migration step from the current project root. */
 declare function runMigrationStep(step: number, argv: string[]): Promise<number>;
 
-export { AC_GHERKIN_SECTION, ARCHETYPES, ATDD_TEST_KIND_DIRS, type Archetype, type AtddTestKind, COLOR_KEYS, type ColorKey, type ConfigLoadResult, type ConfigPathKey, type ConfigSearchResult, DESIGN_MD_SAMPLE_MARKER, DISCUSSION_NON_UI_SURFACES, DISCUSSION_UI_BEARING_SURFACES, type DesignMd, type DesignMdColors, type DesignMdFonts, type DesignMdRadius, type DesignMdShadow, FONT_KEYS, type FailOn, type FenceMaskOptions, type FontKey, ID_PREFIXES, type IdFormatPrefix, type IdPrefix, type InvalidIdOccurrence, type Issue, type IssueCategory, type IssueLocation, type IssueSeverity, type OutputFormat, type ParseError, type ParseResult, type QfaiConfig, type QfaiForbiddenIdentifier, type QfaiOutputConfig, type QfaiPaths, type QfaiPrototypingConfig, type QfaiPrototypingExecutionConfig, type QfaiReportConfig, type QfaiReviewProfile, type QfaiRoutingEntry, type QfaiUiuxAuditConfig, type QfaiUiuxConfig, type QfaiValidationConfig, RADIUS_KEYS, type RadiusKey, type ReportData, type RunSddPreflightOptions, SHADOW_KEYS, SKIPPED_WORKFLOWS_MESSAGE, type SddPreflightResult, type SddPreflightSource, type SddPreflightStatus, type ShadowKey, type TestFileExtensions, type TestLayerRoots, VISUAL_BROWSER_SURFACES, type ValidationCounts, type ValidationIssue, type ValidationOptions, type ValidationProfile, type ValidationResult, type ValidationTimings, type ValidationWaiverAction, type ValidationWaiverDowngradeTo, type ValidationWaiverEntry, type ValidationWaiverMatch, type ValidationWaiverScope, type ValidationWaiverSeverity, type ValidationWaiverSuppressed, type ValidationWaivers, WORKFLOW_MODE_MESSAGE, type WorkflowMode, atddAcceptanceLayerFilter, atddAcceptanceTestGlobs, atddTestKindDirs, classifyAgainstDeclaration, classifyToolLocation, countIssues, createReportData, createTestLayerRoots, defaultConfig, deriveAtddFilePattern, deriveTestFileExtensions, extractAcSpecNumber, extractAllIds, extractBrSpecNumber, extractCapSpecNumber, extractCaseSpecNumber, extractIds, extractInvalidIdOccurrences, extractInvalidIds, extractScSpecNumber, extractSpecNumber, extractUsSpecNumber, findConfigRoot, findDeclaringDir, findLinkingNodeModules, findPackageJsonUpward, formatReportJson, formatReportMarkdown, getConfigPath, isDiscussionUiBearingSurfaceType, isNonUiDiscussionSurface, isUnreplacedDesignMdSample, lintSql, loadConfig, locateToolAgainstProject, maskFencedCodeBlocks, packageRootProbe, parseDesignMd, reachedThroughLinkedNodeModules, readRejectedPrimaryUiContract, readSkippedWorkflows, readTestFileExtensions, readWorkflowMode, requiresVisualBrowserEvidence, resolvePath, resolveTestKind, resolveToolPackageDir, resolveToolVersion, resolvesThroughOwnNodeModules, routingEntryName, runMigrationStep, runSddPreflight, validateContracts, validateDesignMd, validateProject, validateUiContractParse };
+export { AC_GHERKIN_SECTION, ARCHETYPES, ATDD_TEST_KIND_DIRS, type ApproveExternalProcessing, type Archetype, type AtddTestKind, COLOR_KEYS, type ColorKey, type ConfigLoadResult, type ConfigPathKey, type ConfigSearchResult, DESIGN_MD_SAMPLE_MARKER, DISCUSSION_NON_UI_SURFACES, DISCUSSION_UI_BEARING_SURFACES, type DesignMd, type DesignMdColors, type DesignMdFonts, type DesignMdRadius, type DesignMdShadow, type DocumentPreparation, type ExternalProcessingRequest, FONT_KEYS, type FailOn, type FenceMaskOptions, type FontKey, ID_PREFIXES, type IdFormatPrefix, type IdPrefix, type InstalledOlderThanDeclared, type InvalidIdOccurrence, type Issue, type IssueCategory, type IssueLocation, type IssueSeverity, type OutputFormat, type ParseError, type ParseResult, type QfaiConfig, type QfaiForbiddenIdentifier, type QfaiOutputConfig, type QfaiPaths, type QfaiPrototypingConfig, type QfaiPrototypingExecutionConfig, type QfaiReportConfig, type QfaiReviewProfile, type QfaiRoutingEntry, type QfaiUiuxAuditConfig, type QfaiUiuxConfig, type QfaiValidationConfig, RADIUS_KEYS, type RadiusKey, type ReportData, type RunSddPreflightOptions, SHADOW_KEYS, SKIPPED_WORKFLOWS_MESSAGE, type SddPreflightResult, type SddPreflightSource, type SddPreflightStatus, type ShadowKey, type TestFileExtensions, type TestLayerRoots, VISUAL_BROWSER_SURFACES, type ValidationCounts, type ValidationIssue, type ValidationOptions, type ValidationProfile, type ValidationResult, type ValidationTimings, type ValidationWaiverAction, type ValidationWaiverDowngradeTo, type ValidationWaiverEntry, type ValidationWaiverMatch, type ValidationWaiverScope, type ValidationWaiverSeverity, type ValidationWaiverSuppressed, type ValidationWaivers, WORKFLOW_MODE_MESSAGE, type WorkflowMode, atddAcceptanceLayerFilter, atddAcceptanceTestGlobs, atddTestKindDirs, classifyAgainstDeclaration, classifyToolLocation, compareInstalledToDeclared, countIssues, createReportData, createTestLayerRoots, defaultConfig, deriveAtddFilePattern, deriveTestFileExtensions, extractAcSpecNumber, extractAllIds, extractBrSpecNumber, extractCapSpecNumber, extractCaseSpecNumber, extractIds, extractInvalidIdOccurrences, extractInvalidIds, extractScSpecNumber, extractSpecNumber, extractUsSpecNumber, findConfigRoot, findDeclaringDir, findLinkingNodeModules, findPackageJsonUpward, formatReportJson, formatReportMarkdown, getConfigPath, isDiscussionUiBearingSurfaceType, isNonUiDiscussionSurface, isOlderVersion, isUnreplacedDesignMdSample, lintSql, loadConfig, locateToolAgainstProject, lowestVersionOfRange, maskFencedCodeBlocks, orderUiuxParts, packageRootProbe, parseDesignMd, prepareDocumentAnalysis, prepareGraphIntegration, reachedThroughLinkedNodeModules, readDeclaredQfaiRange, readRejectedPrimaryUiContract, readSkippedWorkflows, readTestFileExtensions, readWorkflowMode, renderGraphPreparation, requiresVisualBrowserEvidence, resolvePath, resolveTestKind, resolveToolPackageDir, resolveToolVersion, resolvesThroughOwnNodeModules, routingEntryName, runMigrationStep, runSddPreflight, validateContracts, validateDesignMd, validateProject, validateUiContractParse };

package/dist/index.d.ts

@@ -1,3 +1,5 @@
+import { G as GraphProcess } from './process-C21nTvkT.js';
+
 type IssueSeverity = "info" | "warning" | "error";
 type IssueCategory = "canonical" | "change";
 type IssueLocation = {
@@ -93,6 +95,16 @@ type ValidationTimings = {
     uiuxBudgetMs: number;
     htmlMockMs: number;
     htmlMockBudgetMs: number;
+    /**
+     * What each validator of the UI/UX group took, slowest first. The validators run side by side
+     * on one event loop, so each time includes waiting for the others: the parts overlap, do not
+     * add up to `uiuxMs`, and can credit a fast validator with another's time. They say where to
+     * look, not how the time divides.
+     */
+    uiuxParts: readonly {
+        name: string;
+        ms: number;
+    }[];
 };
 type ValidationResult = {
     toolVersion: string;
@@ -605,6 +617,17 @@ type ValidationOptions = {
     flowIds?: readonly string[];
 };
 declare function validateProject(root: string, configResult?: ConfigLoadResult, options?: ValidationOptions): Promise<ValidationResult>;
+/**
+ * The parts of the UI/UX group, slowest first. The html-mock part leaves out the one-off load of
+ * its parser, as the group's own time does.
+ */
+declare function orderUiuxParts(parts: readonly {
+    name: string;
+    ms: number;
+}[], htmlMockLoadMs: number): {
+    name: string;
+    ms: number;
+}[];
 /**
  * Count findings by severity, skipping suppressed ones. `counts` is the SSOT
  * every gate reads, so anything that rebuilds a `ValidationResult` from an
@@ -716,6 +739,44 @@ declare function classifyAgainstDeclaration(declaringDir: string, packageDir: st
  * statement but still a statement.
  */
 declare function findDeclaringDir(root: string): Promise<string | null>;
+/**
+ * The range the nearest `package.json` declaring qfai gives it, or `null` when
+ * no manifest at or above `root` declares it with a text range.
+ *
+ * Read from the manifest {@link findDeclaringDir} stops at, so the range and the
+ * directory it is compared against are one declaration.
+ */
+declare function readDeclaredQfaiRange(root: string): Promise<string | null>;
+/**
+ * The lowest version a dependency range admits, as `x.y.z`, or `null` when the
+ * range does not state one this reads.
+ *
+ * Only the forms a project writes for a pinned dependency are read: an exact
+ * version, and a caret, tilde or `>=` range, each optionally followed by more
+ * comparators (`>=2.1.1 <3`). A tag (`latest`), a wildcard (`2.x`), an
+ * alternative (`||`), a protocol (`workspace:`, `file:`, `github:`) and a
+ * partial version (`^2.1`) answer `null`, so nothing is compared against them.
+ */
+declare function lowestVersionOfRange(range: string): string | null;
+/** Whether `version` is strictly older than `other`; `false` where either is unreadable. */
+declare function isOlderVersion(version: string, other: string): boolean;
+/** An installed qfai that is older than the version the project declares. */
+type InstalledOlderThanDeclared = {
+    readonly installed: string;
+    readonly declaredRange: string;
+    readonly declaredLowest: string;
+};
+/**
+ * Whether the running qfai is older than the lowest version this project's
+ * dependency declaration admits.
+ *
+ * The declaration is the only record of "the qfai this tree was written for"
+ * that a project keeps: the files `qfai init` writes carry no version. An
+ * installed copy below that floor is the state a lockfile that moved after the
+ * last install leaves, and every rule whose input is a generated file can then
+ * disagree with the tree for a reason that is not in the tree.
+ */
+declare function compareInstalledToDeclared(installed: string, declaredRange: string | null): InstalledOlderThanDeclared | null;
 /**
  * Whether `packageDir` is an installed copy resolved from outside `root`.
  *
@@ -911,7 +972,74 @@ declare const DESIGN_MD_SAMPLE_MARKER = "QFAI-SAMPLE-DESIGN-MD";
  */
 declare function isUnreplacedDesignMdSample(text: unknown): boolean;
 
+interface GraphPreparation {
+    runtime: "installed" | "not-ready";
+    tools?: {
+        codegraph: "installed" | "not-ready";
+        graphify: "installed" | "not-ready";
+    };
+    code: "code-ready" | "code-not-ready";
+    documents: "documents-not-ready";
+    failedStep?: string;
+    recovery?: string;
+    previousInstallation?: "retained" | "none";
+}
+
+type GraphHookHost = "claude" | "codex" | "copilot" | "vscode";
+
+interface GraphHostFacts {
+    host: GraphHookHost;
+    version?: string;
+    configuration: "configured" | "not-configured" | "failed";
+    denialEvent?: string;
+    failureProtocol?: "supported" | "unsupported" | "unverified";
+    trust: "required" | "granted" | "not-required" | "unknown";
+}
+interface GraphHostProtection {
+    host: GraphHookHost;
+    version?: string;
+    state: "configured" | "trust-required" | "runtime-verified" | "unsupported" | "failed";
+    events: readonly string[];
+    recovery: string;
+    configuration?: GraphHostFacts["configuration"];
+    trust?: GraphHostFacts["trust"];
+}
+
+interface GraphSettingsComposition {
+    files: string[];
+    conflicts: string[];
+}
+
+type GraphIntegrationPreparation = GraphPreparation & GraphSettingsComposition & {
+    hosts: GraphHostProtection[];
+};
+declare function prepareGraphIntegration(root: string, run?: GraphProcess): Promise<GraphIntegrationPreparation>;
+
+declare function renderGraphPreparation(preparation: GraphPreparation, hosts?: readonly GraphHostProtection[]): string;
+
+interface GraphReuseEnvironment {
+    platform: string;
+    architecture: string;
+    machine: string;
+}
+
+interface DocumentPreparation {
+    status: "prepared" | "not-ready" | "failed";
+    source?: "current" | "restored" | "generated";
+    reuse?: "published" | "unavailable";
+    recovery?: string;
+}
+interface ExternalProcessingRequest {
+    readonly destination: string;
+    readonly scope: readonly string[];
+    readonly backend: string;
+    readonly model: string;
+    readonly worktree: string;
+}
+type ApproveExternalProcessing = (request: ExternalProcessingRequest) => Promise<boolean>;
+declare function prepareDocumentAnalysis(root: string, run?: GraphProcess, approveExternal?: ApproveExternalProcessing, environment?: GraphReuseEnvironment): Promise<DocumentPreparation>;
+
 /** Run one ordered spec-to-story migration step from the current project root. */
 declare function runMigrationStep(step: number, argv: string[]): Promise<number>;
 
-export { AC_GHERKIN_SECTION, ARCHETYPES, ATDD_TEST_KIND_DIRS, type Archetype, type AtddTestKind, COLOR_KEYS, type ColorKey, type ConfigLoadResult, type ConfigPathKey, type ConfigSearchResult, DESIGN_MD_SAMPLE_MARKER, DISCUSSION_NON_UI_SURFACES, DISCUSSION_UI_BEARING_SURFACES, type DesignMd, type DesignMdColors, type DesignMdFonts, type DesignMdRadius, type DesignMdShadow, FONT_KEYS, type FailOn, type FenceMaskOptions, type FontKey, ID_PREFIXES, type IdFormatPrefix, type IdPrefix, type InvalidIdOccurrence, type Issue, type IssueCategory, type IssueLocation, type IssueSeverity, type OutputFormat, type ParseError, type ParseResult, type QfaiConfig, type QfaiForbiddenIdentifier, type QfaiOutputConfig, type QfaiPaths, type QfaiPrototypingConfig, type QfaiPrototypingExecutionConfig, type QfaiReportConfig, type QfaiReviewProfile, type QfaiRoutingEntry, type QfaiUiuxAuditConfig, type QfaiUiuxConfig, type QfaiValidationConfig, RADIUS_KEYS, type RadiusKey, type ReportData, type RunSddPreflightOptions, SHADOW_KEYS, SKIPPED_WORKFLOWS_MESSAGE, type SddPreflightResult, type SddPreflightSource, type SddPreflightStatus, type ShadowKey, type TestFileExtensions, type TestLayerRoots, VISUAL_BROWSER_SURFACES, type ValidationCounts, type ValidationIssue, type ValidationOptions, type ValidationProfile, type ValidationResult, type ValidationTimings, type ValidationWaiverAction, type ValidationWaiverDowngradeTo, type ValidationWaiverEntry, type ValidationWaiverMatch, type ValidationWaiverScope, type ValidationWaiverSeverity, type ValidationWaiverSuppressed, type ValidationWaivers, WORKFLOW_MODE_MESSAGE, type WorkflowMode, atddAcceptanceLayerFilter, atddAcceptanceTestGlobs, atddTestKindDirs, classifyAgainstDeclaration, classifyToolLocation, countIssues, createReportData, createTestLayerRoots, defaultConfig, deriveAtddFilePattern, deriveTestFileExtensions, extractAcSpecNumber, extractAllIds, extractBrSpecNumber, extractCapSpecNumber, extractCaseSpecNumber, extractIds, extractInvalidIdOccurrences, extractInvalidIds, extractScSpecNumber, extractSpecNumber, extractUsSpecNumber, findConfigRoot, findDeclaringDir, findLinkingNodeModules, findPackageJsonUpward, formatReportJson, formatReportMarkdown, getConfigPath, isDiscussionUiBearingSurfaceType, isNonUiDiscussionSurface, isUnreplacedDesignMdSample, lintSql, loadConfig, locateToolAgainstProject, maskFencedCodeBlocks, packageRootProbe, parseDesignMd, reachedThroughLinkedNodeModules, readRejectedPrimaryUiContract, readSkippedWorkflows, readTestFileExtensions, readWorkflowMode, requiresVisualBrowserEvidence, resolvePath, resolveTestKind, resolveToolPackageDir, resolveToolVersion, resolvesThroughOwnNodeModules, routingEntryName, runMigrationStep, runSddPreflight, validateContracts, validateDesignMd, validateProject, validateUiContractParse };
+export { AC_GHERKIN_SECTION, ARCHETYPES, ATDD_TEST_KIND_DIRS, type ApproveExternalProcessing, type Archetype, type AtddTestKind, COLOR_KEYS, type ColorKey, type ConfigLoadResult, type ConfigPathKey, type ConfigSearchResult, DESIGN_MD_SAMPLE_MARKER, DISCUSSION_NON_UI_SURFACES, DISCUSSION_UI_BEARING_SURFACES, type DesignMd, type DesignMdColors, type DesignMdFonts, type DesignMdRadius, type DesignMdShadow, type DocumentPreparation, type ExternalProcessingRequest, FONT_KEYS, type FailOn, type FenceMaskOptions, type FontKey, ID_PREFIXES, type IdFormatPrefix, type IdPrefix, type InstalledOlderThanDeclared, type InvalidIdOccurrence, type Issue, type IssueCategory, type IssueLocation, type IssueSeverity, type OutputFormat, type ParseError, type ParseResult, type QfaiConfig, type QfaiForbiddenIdentifier, type QfaiOutputConfig, type QfaiPaths, type QfaiPrototypingConfig, type QfaiPrototypingExecutionConfig, type QfaiReportConfig, type QfaiReviewProfile, type QfaiRoutingEntry, type QfaiUiuxAuditConfig, type QfaiUiuxConfig, type QfaiValidationConfig, RADIUS_KEYS, type RadiusKey, type ReportData, type RunSddPreflightOptions, SHADOW_KEYS, SKIPPED_WORKFLOWS_MESSAGE, type SddPreflightResult, type SddPreflightSource, type SddPreflightStatus, type ShadowKey, type TestFileExtensions, type TestLayerRoots, VISUAL_BROWSER_SURFACES, type ValidationCounts, type ValidationIssue, type ValidationOptions, type ValidationProfile, type ValidationResult, type ValidationTimings, type ValidationWaiverAction, type ValidationWaiverDowngradeTo, type ValidationWaiverEntry, type ValidationWaiverMatch, type ValidationWaiverScope, type ValidationWaiverSeverity, type ValidationWaiverSuppressed, type ValidationWaivers, WORKFLOW_MODE_MESSAGE, type WorkflowMode, atddAcceptanceLayerFilter, atddAcceptanceTestGlobs, atddTestKindDirs, classifyAgainstDeclaration, classifyToolLocation, compareInstalledToDeclared, countIssues, createReportData, createTestLayerRoots, defaultConfig, deriveAtddFilePattern, deriveTestFileExtensions, extractAcSpecNumber, extractAllIds, extractBrSpecNumber, extractCapSpecNumber, extractCaseSpecNumber, extractIds, extractInvalidIdOccurrences, extractInvalidIds, extractScSpecNumber, extractSpecNumber, extractUsSpecNumber, findConfigRoot, findDeclaringDir, findLinkingNodeModules, findPackageJsonUpward, formatReportJson, formatReportMarkdown, getConfigPath, isDiscussionUiBearingSurfaceType, isNonUiDiscussionSurface, isOlderVersion, isUnreplacedDesignMdSample, lintSql, loadConfig, locateToolAgainstProject, lowestVersionOfRange, maskFencedCodeBlocks, orderUiuxParts, packageRootProbe, parseDesignMd, prepareDocumentAnalysis, prepareGraphIntegration, reachedThroughLinkedNodeModules, readDeclaredQfaiRange, readRejectedPrimaryUiContract, readSkippedWorkflows, readTestFileExtensions, readWorkflowMode, renderGraphPreparation, requiresVisualBrowserEvidence, resolvePath, resolveTestKind, resolveToolPackageDir, resolveToolVersion, resolvesThroughOwnNodeModules, routingEntryName, runMigrationStep, runSddPreflight, validateContracts, validateDesignMd, validateProject, validateUiContractParse };