critical-gate 2.3.0 → 2.4.0

package/dist/cli/result.js

@@ -0,0 +1,107 @@
+import { join } from "node:path";
+import { GATE_RESULT_SCHEMA_VERSION, applyLearningPolicy, analyzeTaskIntentQuality, buildRepositoryTokenIndex, detectFrameworkPacks, detectMonorepoContext, getConfiguredExpectedSupportFiles, getConfiguredFailOn, getConfiguredPublicApiEntrypoints, getPolicyBlockingDetectors, getPolicyObservationDetectors, loadApiSurfaceSnapshot, loadCriticalGateConfig, resolvePublicApiEntrypoints, runDetectors, summarizeApiSurfaceSnapshot, summarizeFindings, summarizeIntentVerification } from "../index.js";
+import { CRITICAL_GATE_VERSION } from "../version.js";
+export function createGateResult(options, generatedAt, diffResult, io = {}) {
+    const configResult = loadCriticalGateConfig(diffResult.root, {
+        exists: io.exists,
+        readFile: io.readFile
+    });
+    const task = {
+        source: "cli",
+        text: options.task
+    };
+    const diff = {
+        baseRef: diffResult.baseRef,
+        headRef: diffResult.headRef,
+        files: diffResult.files
+    };
+    const packageJson = readOptionalPackageJson(diffResult.root, io);
+    const frameworkPacks = detectFrameworkPacks({
+        files: diff.files,
+        packageJson,
+        config: configResult.config
+    });
+    const monorepo = detectMonorepoContext(diffResult.root, diff.files, io);
+    const repositoryTokenIndex = buildRepositoryTokenIndex({
+        files: diff.files,
+        packageJson
+    });
+    const publicApiEntrypoints = resolvePublicApiEntrypoints(diffResult.root, io, getConfiguredPublicApiEntrypoints(configResult.config));
+    const publicApiEntrypointContext = publicApiEntrypoints.length > 0 ? publicApiEntrypoints : undefined;
+    const apiSnapshot = loadApiSurfaceSnapshot(diffResult.root, io);
+    const context = {
+        root: diffResult.root,
+        packageManager: "pnpm",
+        monorepo,
+        apiSnapshot: summarizeApiSurfaceSnapshot(apiSnapshot),
+        publicEntrypoints: publicApiEntrypointContext?.map((entrypoint) => entrypoint.path),
+        publicApiEntrypoints: publicApiEntrypointContext,
+        frameworkPacks: frameworkPacks.map((pack) => pack.id),
+        repositoryProfile: diffResult.repositoryProfile,
+        utilityIndex: diffResult.utilityIndex,
+        repositoryTokenIndex,
+        git: {
+            baseRef: diffResult.baseRef,
+            headRef: diffResult.headRef
+        }
+    };
+    const detectorContext = {
+        ...context,
+        apiSurfaceSnapshot: apiSnapshot,
+        publicApiEntrypoints: publicApiEntrypointContext,
+        knowledge: diffResult.knowledge
+    };
+    const detectorFindings = runDetectors(task, diff, detectorContext);
+    const learningResult = applyLearningPolicy(detectorFindings, diff.files, {
+        ...configResult.config.learning,
+        expectedSupportFiles: getConfiguredExpectedSupportFiles(configResult.config)
+    });
+    const findings = learningResult.findings;
+    const loadedHistoryIndex = diffResult.knowledge?.getLoadedHistoryIndex?.();
+    const loadedSolutionIndex = diffResult.knowledge?.getLoadedSolutionIndex?.();
+    context.repositoryProfile ??= loadedHistoryIndex?.profile;
+    context.utilityIndex ??= loadedSolutionIndex?.utilityIndex;
+    return {
+        schemaVersion: GATE_RESULT_SCHEMA_VERSION,
+        generatedAt: generatedAt.toISOString(),
+        task,
+        diff,
+        context,
+        findings,
+        summary: summarizeFindings(findings, task, diff, {
+            observationDetectors: getPolicyObservationDetectors(configResult.config),
+            blockingDetectors: getPolicyBlockingDetectors(configResult.config),
+            failOn: options.failOn ?? getConfiguredFailOn(configResult.config),
+            acceptedFindingIds: learningResult.appliedAcceptedFindings
+        }),
+        intentVerification: summarizeIntentVerification(task, diff.files),
+        intentQuality: analyzeTaskIntentQuality(task),
+        metadata: {
+            cliVersion: CRITICAL_GATE_VERSION,
+            strict: options.strict,
+            staged: options.staged,
+            failOn: options.failOn ?? getConfiguredFailOn(configResult.config) ?? "high",
+            rolloutPolicy: configResult.config.rollout,
+            policy: configResult.config.policy,
+            frameworkPacks: frameworkPacks.map((pack) => pack.id),
+            learning: {
+                acceptedFindingsApplied: learningResult.appliedAcceptedFindings,
+                expectedSupportRulesApplied: learningResult.appliedExpectedSupportRules
+            },
+            configWarnings: configResult.warnings
+        }
+    };
+}
+function readOptionalPackageJson(root, io) {
+    const path = join(root, "package.json");
+    if (io.exists?.(path) !== true) {
+        return undefined;
+    }
+    try {
+        return JSON.parse(io.readFile?.(path) ?? "");
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=result.js.map

package/dist/cli/result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.js","sourceRoot":"","sources":["../../src/cli/result.ts"],"names":[],"mappings":"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"}

package/dist/cli/types.d.ts

@@ -0,0 +1,30 @@
+import type { GitDiffResult, ReportFormat } from "../index.js";
+export declare const ExitCode: {
+    readonly Pass: 0;
+    readonly FindingsFailed: 1;
+    readonly UsageError: 2;
+    readonly InternalError: 3;
+};
+export type ExitCode = (typeof ExitCode)[keyof typeof ExitCode];
+export interface CheckOptions {
+    task: string;
+    base?: string;
+    format: ReportFormat;
+    strict: boolean;
+    staged: boolean;
+    failOn?: "blocker" | "high" | "medium";
+    output?: string;
+}
+export interface CliIo {
+    stdout: (message: string) => void;
+    stderr: (message: string) => void;
+    writeFile: (path: string, content: string) => void;
+    chmodFile?: (path: string, mode: number) => void;
+    now: () => Date;
+    readDiff: (baseRef?: string, options?: {
+        staged?: boolean;
+    }) => GitDiffResult;
+    exists?: (path: string) => boolean;
+    readFile?: (path: string) => string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/cli/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/cli/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE/D,eAAO,MAAM,QAAQ;;;;;CAKX,CAAC;AAEX,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,QAAQ,CAAC,CAAC,MAAM,OAAO,QAAQ,CAAC,CAAC;AAEhE,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,SAAS,GAAG,MAAM,GAAG,QAAQ,CAAC;IACvC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,KAAK;IACpB,MAAM,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,MAAM,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACnD,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACjD,GAAG,EAAE,MAAM,IAAI,CAAC;IAChB,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,KAAK,aAAa,CAAC;IAC9E,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;IACnC,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;CACrC"}

package/dist/cli/types.js

@@ -0,0 +1,7 @@
+export const ExitCode = {
+    Pass: 0,
+    FindingsFailed: 1,
+    UsageError: 2,
+    InternalError: 3
+};
+//# sourceMappingURL=types.js.map

package/dist/cli/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/cli/types.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,IAAI,EAAE,CAAC;IACP,cAAc,EAAE,CAAC;IACjB,UAAU,EAAE,CAAC;IACb,aAAa,EAAE,CAAC;CACR,CAAC"}

package/dist/cli.d.ts

@@ -1,26 +1,13 @@
 #!/usr/bin/env node
-import { type GitDiffResult } from "./index.js";
-export declare const CLI_VERSION = "2.1.1";
+import type { CheckOptions, CliIo, ExitCode as ExitCodeTypeInternal } from "./cli/types.js";
+export { isCliEntrypoint } from "./cli/entrypoint.js";
+export { CLI_VERSION, main } from "./cli/main.js";
 export declare const ExitCode: {
     readonly Pass: 0;
     readonly FindingsFailed: 1;
     readonly UsageError: 2;
     readonly InternalError: 3;
 };
-export type ExitCode = (typeof ExitCode)[keyof typeof ExitCode];
-interface CliIo {
-    stdout: (message: string) => void;
-    stderr: (message: string) => void;
-    writeFile: (path: string, content: string) => void;
-    chmodFile?: (path: string, mode: number) => void;
-    now: () => Date;
-    readDiff: (baseRef?: string, options?: {
-        staged?: boolean;
-    }) => GitDiffResult;
-    exists?: (path: string) => boolean;
-    readFile?: (path: string) => string;
-}
-export declare function main(argv?: string[], io?: CliIo): ExitCode;
-export declare function isCliEntrypoint(importMetaUrl: string, argvPath?: string): boolean;
-export {};
+export type { CheckOptions, CliIo };
+export type ExitCode = ExitCodeTypeInternal;
 //# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAaA,OAAO,EAyBL,KAAK,aAAa,EAEnB,MAAM,YAAY,CAAC;AAEpB,eAAO,MAAM,WAAW,UAAU,CAAC;AAEnC,eAAO,MAAM,QAAQ;;;;;CAKX,CAAC;AAEX,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,QAAQ,CAAC,CAAC,MAAM,OAAO,QAAQ,CAAC,CAAC;AAYhE,UAAU,KAAK;IACb,MAAM,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,MAAM,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACnD,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACjD,GAAG,EAAE,MAAM,IAAI,CAAC;IAChB,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,KAAK,aAAa,CAAC;IAC9E,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;IACnC,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;CACrC;AAyBD,wBAAgB,IAAI,CAAC,IAAI,WAAwB,EAAE,EAAE,QAAY,GAAG,QAAQ,CAQ3E;AAs0BD,wBAAgB,eAAe,CAAC,aAAa,EAAE,MAAM,EAAE,QAAQ,SAAkB,GAAG,OAAO,CAK1F"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,QAAQ,IAAI,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAE5F,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAClD,eAAO,MAAM,QAAQ;;;;;CAAgB,CAAC;AACtC,YAAY,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC;AACpC,MAAM,MAAM,QAAQ,GAAG,oBAAoB,CAAC"}