@kb-labs/qa-core 2.94.0 → 2.98.0

package/dist/index.d.ts

@@ -1,6 +1,72 @@
-export { L as LastRunData, c as collectSubmoduleInfo, g as getSubmoduleInfo, a as getWorkspacePackages, l as loadLastRun, r as runCustomChecks, b as runLintCheck, d as runQA, e as runTestCheck, f as runTypeCheck, s as saveLastRun } from './last-run-store-C1AkskWI.js';
-export { captureBaseline, compareWithBaseline, createBaselineFromResults, loadBaseline, saveBaseline } from './baseline/index.js';
-export { analyzeEnrichedTrends, analyzeTrends, appendEntry, appendTrendEntry, createHistoryEntry, detectRegressions, getPackageTimeline, loadHistory, loadTrendHistory, saveHistory } from './history/index.js';
-export { ReportSection, buildBaselineReport, buildDetailedJsonReport, buildDetailedRunReport, buildHistoryTable, buildJsonReport, buildRegressionsReport, buildRunReport, buildTrendsReport, groupErrors, groupResults } from './report/index.js';
-export { resolveCategories } from './categories/index.js';
-import '@kb-labs/qa-contracts';
+import { ShellAPI } from '@kb-labs/sdk';
+import { DevkitRunOutput, DevkitCheckOutput, DevkitStatsOutput, DevkitStatusOutput, DevkitGateOutput, SnapshotGit, RunSnapshot, CheckSnapshot, StatsSnapshot, GateSnapshot, BaselineData, TrendAnalysis, RegressionDetection, BaselineCheckDiff, PackageTimeline } from '@kb-labs/qa-contracts';
+export { ReportSection, buildBaselineDiffReport, buildBaselineReport, buildCheckJsonReport, buildCheckReport, buildHistoryTable, buildRegressionsReport, buildRunJsonReport, buildRunReport, buildStatsJsonReport, buildStatsReport, buildTrendsReport, formatTaskName } from './report/index.js';
+
+/**
+ * Resolve the kb-devkit binary path.
+ *
+ * Resolution order:
+ * 1. configPath (from QAPluginConfig.devkitPath) — absolute or relative to rootDir
+ * 2. tools/kb-devkit/kb-devkit relative to rootDir (workspace-local copy)
+ * 3. "kb-devkit" — resolved from PATH at spawn time
+ *
+ * The shell permission whitelist matches by basename, so passing a full path
+ * to shell.exec() works correctly when allow: ['kb-devkit'] is declared.
+ */
+declare function resolveDevkitBin(rootDir: string, configPath?: string): string;
+
+interface DevkitAdapterOptions {
+    binaryPath: string;
+    cwd: string;
+    shell: ShellAPI;
+    timeoutMs?: number;
+}
+declare class DevkitAdapter {
+    private readonly bin;
+    private readonly cwd;
+    private readonly shell;
+    private readonly timeout;
+    constructor(opts: DevkitAdapterOptions);
+    run(tasks: string[]): Promise<DevkitRunOutput>;
+    check(): Promise<DevkitCheckOutput>;
+    stats(): Promise<DevkitStatsOutput>;
+    status(): Promise<DevkitStatusOutput>;
+    gate(): Promise<DevkitGateOutput>;
+    version(): Promise<string>;
+    private invoke;
+}
+
+/**
+ * Capture current git context using ctx.api.shell.
+ * Returns undefined if the directory is not a git repo or git is unavailable.
+ */
+declare function captureGit(shell: ShellAPI, cwd: string): Promise<SnapshotGit | undefined>;
+
+declare class SnapshotStore {
+    private readonly rootDir;
+    private readonly maxEntries;
+    constructor(rootDir: string, maxEntries?: number);
+    loadRunHistory(): RunSnapshot[];
+    saveRun(raw: DevkitRunOutput, tasks: string[], durationMs: number, git?: SnapshotGit, runContext?: Record<string, unknown>): RunSnapshot;
+    latestRun(): RunSnapshot | null;
+    loadCheckHistory(): CheckSnapshot[];
+    saveCheck(raw: DevkitCheckOutput, durationMs: number, git?: SnapshotGit, runContext?: Record<string, unknown>): CheckSnapshot;
+    latestCheck(): CheckSnapshot | null;
+    loadStatsHistory(): StatsSnapshot[];
+    saveStats(raw: DevkitStatsOutput, durationMs: number, git?: SnapshotGit, runContext?: Record<string, unknown>): StatsSnapshot;
+    latestStats(): StatsSnapshot | null;
+    loadGateHistory(): GateSnapshot[];
+    saveGate(raw: DevkitGateOutput, durationMs: number, git?: SnapshotGit, runContext?: Record<string, unknown>): GateSnapshot;
+    loadBaseline(): BaselineData | null;
+    saveBaseline(check: DevkitCheckOutput, stats: DevkitStatsOutput, git?: SnapshotGit): BaselineData;
+}
+
+declare function analyzeTrends(history: RunSnapshot[], window?: number): TrendAnalysis;
+
+declare function detectRegressions(history: RunSnapshot[]): RegressionDetection;
+
+declare function compareWithBaseline(currentCheck: DevkitCheckOutput, currentStats: DevkitStatsOutput, baseline: BaselineData): BaselineCheckDiff;
+
+declare function buildPackageTimeline(history: RunSnapshot[], packageName: string): PackageTimeline;
+
+export { DevkitAdapter, type DevkitAdapterOptions, SnapshotStore, analyzeTrends, buildPackageTimeline, captureGit, compareWithBaseline, detectRegressions, resolveDevkitBin };