vaspera 2.5.0

package/dist/transcripts/verifier.test.js

@@ -0,0 +1,330 @@
+/**
+ * Tests for Transcript Verifier
+ */
+import { describe, it, expect, beforeEach } from "vitest";
+import { createHash } from "crypto";
+import { verifyMerkleChain, verifyTimestampOrdering, verifyModelConsistency, verifyProvenance, verifyTranscriptBundle, quickIntegrityCheck, generateVerificationReport, } from "./verifier.js";
+import { TranscriptLogger } from "./logger.js";
+import { generateTranscriptProvenance } from "./signing.js";
+describe("verifyMerkleChain", () => {
+    let logger;
+    beforeEach(() => {
+        logger = new TranscriptLogger("test-session");
+    });
+    it("returns valid for empty entries", () => {
+        const result = verifyMerkleChain([], "genesis", "genesis");
+        expect(result.valid).toBe(true);
+        expect(result.entryCount).toBe(0);
+    });
+    it("verifies valid chain", () => {
+        logger.logPrompt("First");
+        logger.logToolCall("tool", "input");
+        logger.logModelResponse("Response");
+        const entries = logger.getChain();
+        const transcript = logger.generateSignedTranscript();
+        const result = verifyMerkleChain(entries, transcript.rootHash, transcript.tipHash);
+        expect(result.valid).toBe(true);
+        expect(result.entryCount).toBe(3);
+    });
+    it("detects broken previous hash", () => {
+        logger.logPrompt("First");
+        logger.logPrompt("Second");
+        const entries = logger.getChain();
+        // Tamper with previous hash
+        entries[1].previousHash = "tampered-hash";
+        const transcript = logger.generateSignedTranscript();
+        const result = verifyMerkleChain(entries, transcript.rootHash, transcript.tipHash);
+        expect(result.valid).toBe(false);
+        expect(result.brokenAt).toBe(1);
+        expect(result.message).toContain("Chain broken");
+    });
+    it("detects tampered content", () => {
+        logger.logPrompt("Original content");
+        const entries = logger.getChain();
+        const transcript = logger.generateSignedTranscript();
+        // Tamper with content
+        entries[0].content = "Tampered content";
+        const result = verifyMerkleChain(entries, transcript.rootHash, transcript.tipHash);
+        expect(result.valid).toBe(false);
+        expect(result.message).toContain("Content hash mismatch");
+    });
+    it("detects root hash mismatch", () => {
+        logger.logPrompt("Entry");
+        const entries = logger.getChain();
+        const result = verifyMerkleChain(entries, "wrong-root-hash", entries[0].entryHash);
+        expect(result.valid).toBe(false);
+        expect(result.message).toContain("Root hash mismatch");
+    });
+    it("detects tip hash mismatch", () => {
+        logger.logPrompt("First");
+        logger.logPrompt("Last");
+        const entries = logger.getChain();
+        const result = verifyMerkleChain(entries, entries[0].entryHash, "wrong-tip-hash");
+        expect(result.valid).toBe(false);
+        expect(result.message).toContain("Tip hash mismatch");
+    });
+});
+describe("verifyTimestampOrdering", () => {
+    it("returns passed for single entry", () => {
+        const entries = [
+            createMockEntry("1", new Date().toISOString()),
+        ];
+        const result = verifyTimestampOrdering(entries);
+        expect(result.passed).toBe(true);
+    });
+    it("returns passed for correctly ordered timestamps", () => {
+        const now = Date.now();
+        const entries = [
+            createMockEntry("1", new Date(now).toISOString()),
+            createMockEntry("2", new Date(now + 1000).toISOString()),
+            createMockEntry("3", new Date(now + 2000).toISOString()),
+        ];
+        const result = verifyTimestampOrdering(entries);
+        expect(result.passed).toBe(true);
+    });
+    it("detects backwards timestamps", () => {
+        const now = Date.now();
+        const entries = [
+            createMockEntry("1", new Date(now + 1000).toISOString()),
+            createMockEntry("2", new Date(now).toISOString()), // Earlier!
+        ];
+        const result = verifyTimestampOrdering(entries);
+        expect(result.passed).toBe(false);
+        expect(result.details?.issues).toBeDefined();
+    });
+    it("detects excessive gaps when specified", () => {
+        const now = Date.now();
+        const entries = [
+            createMockEntry("1", new Date(now).toISOString()),
+            createMockEntry("2", new Date(now + 60000).toISOString()), // 60 seconds later
+        ];
+        const result = verifyTimestampOrdering(entries, 10000); // Max 10 seconds
+        expect(result.passed).toBe(false);
+        expect(result.details?.issues).toBeDefined();
+    });
+});
+describe("verifyModelConsistency", () => {
+    it("returns passed for no model IDs", () => {
+        const entries = [
+            createMockEntry("1"),
+            createMockEntry("2"),
+        ];
+        const result = verifyModelConsistency(entries);
+        expect(result.passed).toBe(true);
+        expect(result.message).toContain("No model IDs");
+    });
+    it("returns passed for consistent model ID", () => {
+        const entries = [
+            createMockEntry("1", undefined, "claude-3"),
+            createMockEntry("2", undefined, "claude-3"),
+        ];
+        const result = verifyModelConsistency(entries);
+        expect(result.passed).toBe(true);
+        expect(result.message).toContain("claude-3");
+    });
+    it("detects multiple model IDs", () => {
+        const entries = [
+            createMockEntry("1", undefined, "claude-3"),
+            createMockEntry("2", undefined, "gpt-4"),
+        ];
+        const result = verifyModelConsistency(entries);
+        expect(result.passed).toBe(false);
+        expect(result.message).toContain("Multiple model IDs");
+        expect(result.details?.modelIds).toContain("claude-3");
+        expect(result.details?.modelIds).toContain("gpt-4");
+    });
+});
+describe("verifyProvenance", () => {
+    it("validates consistent provenance", () => {
+        const logger = new TranscriptLogger("prov-test");
+        logger.logPrompt("Test");
+        const transcript = logger.generateSignedTranscript();
+        const provenance = generateTranscriptProvenance(transcript);
+        const bundle = {
+            transcript,
+            provenance,
+            createdAt: new Date().toISOString(),
+            version: "1.0.0",
+        };
+        const result = verifyProvenance(bundle);
+        expect(result.passed).toBe(true);
+    });
+    it("detects session ID mismatch", () => {
+        const logger = new TranscriptLogger("session-1");
+        logger.logPrompt("Test");
+        const transcript = logger.generateSignedTranscript();
+        const provenance = generateTranscriptProvenance(transcript);
+        // Tamper with provenance
+        provenance.predicate.sessionId = "session-2";
+        const bundle = {
+            transcript,
+            provenance,
+            createdAt: new Date().toISOString(),
+            version: "1.0.0",
+        };
+        const result = verifyProvenance(bundle);
+        expect(result.passed).toBe(false);
+        expect(result.details?.issues).toBeDefined();
+    });
+    it("detects entry count mismatch", () => {
+        const logger = new TranscriptLogger("test");
+        logger.logPrompt("Test");
+        const transcript = logger.generateSignedTranscript();
+        const provenance = generateTranscriptProvenance(transcript);
+        // Tamper with entry count
+        provenance.predicate.entryCount = 999;
+        const bundle = {
+            transcript,
+            provenance,
+            createdAt: new Date().toISOString(),
+            version: "1.0.0",
+        };
+        const result = verifyProvenance(bundle);
+        expect(result.passed).toBe(false);
+    });
+});
+describe("verifyTranscriptBundle", () => {
+    it("verifies valid bundle", async () => {
+        const logger = new TranscriptLogger("bundle-test");
+        logger.logPrompt("First");
+        logger.logToolCall("tool", "input");
+        logger.logModelResponse("Response");
+        const transcript = logger.generateSignedTranscript();
+        const provenance = generateTranscriptProvenance(transcript);
+        const bundle = {
+            transcript,
+            provenance,
+            createdAt: new Date().toISOString(),
+            version: "1.0.0",
+        };
+        const result = await verifyTranscriptBundle(bundle, logger.getChain());
+        expect(result.valid).toBe(true);
+        expect(result.summary.failed).toBe(0);
+    });
+    it("validates expected session ID", async () => {
+        const logger = new TranscriptLogger("expected-session");
+        logger.logPrompt("Test");
+        const transcript = logger.generateSignedTranscript();
+        const provenance = generateTranscriptProvenance(transcript);
+        const bundle = {
+            transcript,
+            provenance,
+            createdAt: new Date().toISOString(),
+            version: "1.0.0",
+        };
+        const result = await verifyTranscriptBundle(bundle, logger.getChain(), {
+            expectedSessionId: "different-session",
+        });
+        expect(result.valid).toBe(false);
+        const sessionCheck = result.checks.find((c) => c.name === "session-id");
+        expect(sessionCheck?.passed).toBe(false);
+    });
+    it("validates bundle version", async () => {
+        const logger = new TranscriptLogger("version-test");
+        logger.logPrompt("Test");
+        const transcript = logger.generateSignedTranscript();
+        const provenance = generateTranscriptProvenance(transcript);
+        const bundle = {
+            transcript,
+            provenance,
+            createdAt: new Date().toISOString(),
+            version: "2.0.0", // Unsupported version
+        };
+        const result = await verifyTranscriptBundle(bundle);
+        expect(result.valid).toBe(false);
+        const versionCheck = result.checks.find((c) => c.name === "bundle-version");
+        expect(versionCheck?.passed).toBe(false);
+    });
+    it("notes redactions in checks", async () => {
+        const logger = new TranscriptLogger("redaction-test");
+        logger.logPrompt("Test");
+        logger.logRedaction("hash", "email");
+        const transcript = logger.generateSignedTranscript();
+        const provenance = generateTranscriptProvenance(transcript);
+        const bundle = {
+            transcript,
+            provenance,
+            createdAt: new Date().toISOString(),
+            version: "1.0.0",
+        };
+        const result = await verifyTranscriptBundle(bundle);
+        const redactionCheck = result.checks.find((c) => c.name === "redactions-declared");
+        expect(redactionCheck).toBeDefined();
+        expect(redactionCheck?.passed).toBe(true);
+    });
+});
+describe("quickIntegrityCheck", () => {
+    it("returns true for valid chain", () => {
+        const logger = new TranscriptLogger("quick-test");
+        logger.logPrompt("First");
+        logger.logPrompt("Second");
+        const entries = logger.getChain();
+        const transcript = logger.generateSignedTranscript();
+        const result = quickIntegrityCheck(entries, transcript.rootHash, transcript.tipHash);
+        expect(result).toBe(true);
+    });
+    it("returns false for invalid chain", () => {
+        const logger = new TranscriptLogger("quick-test");
+        logger.logPrompt("First");
+        const entries = logger.getChain();
+        entries[0].contentHash = "tampered";
+        const transcript = logger.generateSignedTranscript();
+        const result = quickIntegrityCheck(entries, transcript.rootHash, transcript.tipHash);
+        expect(result).toBe(false);
+    });
+});
+describe("generateVerificationReport", () => {
+    it("generates markdown report for valid verification", async () => {
+        const logger = new TranscriptLogger("report-test");
+        logger.logPrompt("Test");
+        const transcript = logger.generateSignedTranscript();
+        const provenance = generateTranscriptProvenance(transcript);
+        const bundle = {
+            transcript,
+            provenance,
+            createdAt: new Date().toISOString(),
+            version: "1.0.0",
+        };
+        const verification = await verifyTranscriptBundle(bundle, logger.getChain());
+        const report = generateVerificationReport(verification);
+        expect(report).toContain("## Transcript Verification Report");
+        expect(report).toContain("VALID");
+        expect(report).toContain("report-test");
+    });
+    it("shows failed checks in report", async () => {
+        const logger = new TranscriptLogger("fail-report");
+        logger.logPrompt("Test");
+        const transcript = logger.generateSignedTranscript();
+        const provenance = generateTranscriptProvenance(transcript);
+        const bundle = {
+            transcript,
+            provenance,
+            createdAt: new Date().toISOString(),
+            version: "2.0.0", // Invalid version
+        };
+        const verification = await verifyTranscriptBundle(bundle);
+        const report = generateVerificationReport(verification);
+        expect(report).toContain("INVALID");
+        expect(report).toContain("bundle-version");
+    });
+});
+// Helper function to create mock entries
+function createMockEntry(id, timestamp, modelId) {
+    const content = `Content for ${id}`;
+    const ts = timestamp || new Date().toISOString();
+    const contentHash = createHash("sha256").update(content).digest("hex");
+    return {
+        id,
+        timestamp: ts,
+        type: "prompt",
+        sessionId: "test-session",
+        modelId,
+        content,
+        contentHash,
+        previousHash: "genesis",
+        entryHash: createHash("sha256")
+            .update(JSON.stringify({ id, timestamp: ts, contentHash }))
+            .digest("hex"),
+    };
+}
+//# sourceMappingURL=verifier.test.js.map

package/dist/transcripts/verifier.test.js.map

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

package/dist/util/concurrency.d.ts

@@ -0,0 +1,221 @@
+/**
+ * Concurrency Control Utilities
+ *
+ * Provides a lightweight promise queue for controlling concurrent operations.
+ * Similar to p-queue but without external dependencies.
+ *
+ * Use VASPERA_SCAN_CONCURRENCY env var to configure default concurrency.
+ *
+ * @module util/concurrency
+ */
+/**
+ * Default concurrency level for scanner operations
+ */
+export declare const DEFAULT_CONCURRENCY = 3;
+/**
+ * Get the configured concurrency level from environment
+ */
+export declare function getConcurrencyLevel(): number;
+/**
+ * Options for the promise queue
+ */
+export interface QueueOptions {
+    /** Maximum concurrent operations (default: from env or 3) */
+    concurrency?: number;
+    /** Whether to auto-start processing (default: true) */
+    autoStart?: boolean;
+    /** Timeout per task in ms (optional) */
+    timeout?: number;
+    /** Callback when queue is empty */
+    onEmpty?: () => void;
+    /** Callback when a task fails */
+    onError?: (error: Error, task: QueueTask<unknown>) => void;
+}
+/**
+ * Task in the queue
+ */
+export interface QueueTask<T> {
+    /** Unique task ID */
+    id: string;
+    /** Task function */
+    fn: () => Promise<T>;
+    /** Task priority (higher = runs first) */
+    priority: number;
+    /** When task was added */
+    addedAt: Date;
+    /** Task timeout in ms */
+    timeout?: number;
+}
+/**
+ * Task result
+ */
+export interface TaskResult<T> {
+    /** Task ID */
+    id: string;
+    /** Whether task succeeded */
+    success: boolean;
+    /** Result value if successful */
+    value?: T;
+    /** Error if failed */
+    error?: Error;
+    /** Execution time in ms */
+    durationMs: number;
+}
+/**
+ * Queue statistics
+ */
+export interface QueueStats {
+    /** Number of pending tasks */
+    pending: number;
+    /** Number of running tasks */
+    running: number;
+    /** Number of completed tasks */
+    completed: number;
+    /** Number of failed tasks */
+    failed: number;
+    /** Average execution time in ms */
+    avgDurationMs: number;
+    /** Total execution time in ms */
+    totalDurationMs: number;
+}
+/**
+ * Promise Queue for controlled concurrency
+ *
+ * Limits the number of concurrent async operations to prevent
+ * resource exhaustion and improve reliability.
+ *
+ * @example
+ * ```typescript
+ * const queue = new PromiseQueue({ concurrency: 3 });
+ *
+ * // Add tasks
+ * queue.add(() => scanFile("file1.ts"), { priority: 1 });
+ * queue.add(() => scanFile("file2.ts"), { priority: 2 }); // runs first
+ *
+ * // Wait for all tasks
+ * const results = await queue.onIdle();
+ * ```
+ */
+export declare class PromiseQueue {
+    private readonly concurrency;
+    private readonly autoStart;
+    private readonly defaultTimeout?;
+    private readonly onEmpty?;
+    private readonly onError?;
+    private queue;
+    private running;
+    private results;
+    private taskIdCounter;
+    private isPaused;
+    private idlePromise;
+    private idleResolve;
+    constructor(options?: QueueOptions);
+    /**
+     * Add a task to the queue
+     */
+    add<T>(fn: () => Promise<T>, options?: {
+        priority?: number;
+        id?: string;
+        timeout?: number;
+    }): Promise<TaskResult<T>>;
+    /**
+     * Add multiple tasks at once
+     */
+    addAll<T>(tasks: Array<{
+        fn: () => Promise<T>;
+        priority?: number;
+        id?: string;
+        timeout?: number;
+    }>): Promise<TaskResult<T>[]>;
+    /**
+     * Process tasks from the queue
+     */
+    private process;
+    /**
+     * Run a single task
+     */
+    private runTask;
+    /**
+     * Start processing (if paused)
+     */
+    start(): void;
+    /**
+     * Pause processing (current tasks continue, new tasks wait)
+     */
+    pause(): void;
+    /**
+     * Clear pending tasks (running tasks continue)
+     */
+    clear(): void;
+    /**
+     * Get queue statistics
+     */
+    getStats(): QueueStats;
+    /**
+     * Get current queue size
+     */
+    get size(): number;
+    /**
+     * Get number of running tasks
+     */
+    get pending(): number;
+    /**
+     * Check if queue is idle (no pending or running tasks)
+     */
+    get isIdle(): boolean;
+    /**
+     * Wait for queue to become idle
+     */
+    onIdle(): Promise<TaskResult<unknown>[]>;
+}
+/**
+ * Run tasks with controlled concurrency
+ *
+ * @param tasks - Array of async functions to execute
+ * @param concurrency - Maximum concurrent operations
+ * @returns Array of results in order
+ *
+ * @example
+ * ```typescript
+ * const results = await runConcurrent(
+ *   files.map(f => () => scanFile(f)),
+ *   3
+ * );
+ * ```
+ */
+export declare function runConcurrent<T>(tasks: Array<() => Promise<T>>, concurrency?: number): Promise<TaskResult<T>[]>;
+/**
+ * Run tasks with controlled concurrency, returning only successful values
+ *
+ * @param tasks - Array of async functions to execute
+ * @param concurrency - Maximum concurrent operations
+ * @returns Array of successful results in order (null for failed)
+ */
+export declare function runConcurrentValues<T>(tasks: Array<() => Promise<T>>, concurrency?: number): Promise<(T | null)[]>;
+/**
+ * Map over items with controlled concurrency
+ *
+ * @param items - Items to process
+ * @param fn - Async function to apply to each item
+ * @param concurrency - Maximum concurrent operations
+ * @returns Array of results
+ */
+export declare function mapConcurrent<T, R>(items: T[], fn: (item: T, index: number) => Promise<R>, concurrency?: number): Promise<TaskResult<R>[]>;
+/**
+ * Create a throttled version of an async function
+ *
+ * @param fn - Async function to throttle
+ * @param concurrency - Maximum concurrent calls
+ * @returns Throttled function
+ */
+export declare function throttle<T extends unknown[], R>(fn: (...args: T) => Promise<R>, concurrency?: number): (...args: T) => Promise<TaskResult<R>>;
+/**
+ * Batch items and process batches with controlled concurrency
+ *
+ * @param items - Items to process
+ * @param batchSize - Size of each batch
+ * @param fn - Async function to process a batch
+ * @param concurrency - Maximum concurrent batches
+ */
+export declare function batchConcurrent<T, R>(items: T[], batchSize: number, fn: (batch: T[], batchIndex: number) => Promise<R>, concurrency?: number): Promise<TaskResult<R>[]>;
+//# sourceMappingURL=concurrency.d.ts.map

package/dist/util/concurrency.d.ts.map

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