veriskit 0.5.1 → 0.6.0

package/dist/index.d.ts

@@ -0,0 +1,190 @@
+type PackageManager = "npm" | "pnpm" | "yarn" | "bun";
+type CapabilityId = "types" | "lint" | "unit" | "browser";
+type CheckStatus = "passed" | "failed" | "skipped" | "unknown";
+type VerdictState = "verified" | "failed" | "partial";
+interface Capability {
+    id: CapabilityId;
+    available: boolean;
+    runner?: string;
+    reason?: string;
+}
+interface Project {
+    root: string;
+    name?: string;
+    packageManager: PackageManager;
+    frameworks: string[];
+    languages: string[];
+    scripts: Record<string, string>;
+    capabilities: Capability[];
+}
+interface CheckResult {
+    checkId: CapabilityId;
+    status: CheckStatus;
+    durationMs: number;
+    summary: string;
+    logRef?: string;
+    outputTail?: string;
+    counts?: {
+        passed?: number;
+        failed?: number;
+        total?: number;
+    };
+    cached?: boolean;
+}
+interface Verdict {
+    state: VerdictState;
+    verifiedCapabilities: CapabilityId[];
+    skipped: CapabilityId[];
+    reasons: string[];
+}
+interface EnvironmentInfo {
+    os: string;
+    node: string;
+    pm: string;
+    ci: boolean;
+    timestamp: string;
+}
+interface VerificationRun {
+    id: string;
+    startedAt: string;
+    project: Project;
+    results: CheckResult[];
+    verdict: Verdict;
+    reportRef?: string;
+    env: EnvironmentInfo;
+    scope?: {
+        kind: "affected" | "watch";
+        changedCount: number;
+    };
+}
+
+declare function detectProject(root: string): Promise<Project>;
+
+interface GitAnchor {
+    commit: string;
+    branch: string;
+    dirty: boolean;
+    changedFiles: number;
+}
+
+interface EvidenceCheck {
+    id: CapabilityId;
+    status: CheckStatus;
+    runner?: string;
+    durationMs: number;
+    summary: string;
+    counts?: {
+        passed?: number;
+        failed?: number;
+        total?: number;
+    };
+    logDigest?: string;
+}
+interface EvidenceRecord {
+    schema: string;
+    id: string;
+    startedAt: string;
+    tool: {
+        name: string;
+        version: string;
+    };
+    git: GitAnchor | null;
+    env: {
+        os: string;
+        node: string;
+        pm: string;
+        ci: boolean;
+        timestamp: string;
+    };
+    project: {
+        name: string;
+        packageManager: string;
+        frameworks: string[];
+        languages: string[];
+    };
+    scope: {
+        kind: "full" | "affected" | "watch";
+        changedCount: number;
+    };
+    checks: EvidenceCheck[];
+    verdict: {
+        state: VerdictState;
+        verifiedCapabilities: CapabilityId[];
+        skipped: CapabilityId[];
+        reasons: string[];
+    };
+    digest: string;
+}
+
+declare function verifyProject(root: string, opts?: {
+    partialOk?: boolean;
+    browser?: boolean;
+}): Promise<{
+    run: VerificationRun;
+    record: EvidenceRecord;
+}>;
+interface AffectedOutcome {
+    run?: VerificationRun;
+    record?: EvidenceRecord;
+    note: string;
+    changedCount: number;
+    nothingAffected: boolean;
+}
+declare function affectedProject(root: string, opts?: {
+    base?: string;
+}): Promise<AffectedOutcome>;
+
+interface EvidenceCheckResult {
+    name: string;
+    ok: boolean;
+    detail: string;
+}
+interface VerifyResult {
+    ok: boolean;
+    kind: "record" | "bundle";
+    record: EvidenceRecord;
+    checks: EvidenceCheckResult[];
+    signed: boolean;
+}
+interface VerifyOptions {
+    sigPath?: string;
+    expectedKeyId?: string;
+    expectedPubKeyPem?: string;
+}
+declare function verifyEvidenceFile(path: string, opts?: VerifyOptions): Promise<VerifyResult>;
+
+interface FlakyCheck {
+    id: CapabilityId;
+    statuses: CheckStatus[];
+}
+declare function detectFlaky(records: EvidenceRecord[]): FlakyCheck[];
+
+declare function loadRuns(root: string, limit?: number): EvidenceRecord[];
+
+type NodeKind = "source" | "test" | "config" | "other";
+interface ModuleNode {
+    file: string;
+    kind: NodeKind;
+    imports: string[];
+    importedBy: string[];
+}
+interface ProjectGraph {
+    root: string;
+    resolver: "typescript" | "scanner";
+    nodes: Record<string, ModuleNode>;
+    sourceFiles: string[];
+    testFiles: string[];
+}
+
+interface Analysis {
+    untested: string[];
+    blastRadius: Record<string, number>;
+    risky: string[];
+}
+declare function analyze(graph: ProjectGraph, changed?: string[]): Analysis;
+
+declare function buildGraph(project: Project): Promise<ProjectGraph>;
+
+declare function getEnvironmentInfo(pm: string): EnvironmentInfo;
+
+export { type AffectedOutcome, type Analysis, type CapabilityId, type EvidenceRecord, type FlakyCheck, type Project, type ProjectGraph, type Verdict, type VerificationRun, type VerifyResult, affectedProject, analyze, buildGraph, detectFlaky, detectProject, getEnvironmentInfo, loadRuns, verifyEvidenceFile, verifyProject };