gsd-pi 2.64.0-dev.f8aad9b → 2.65.0-dev.5c8557b

package/src/resources/extensions/gsd/tests/pre-execution-checks.test.ts

@@ -0,0 +1,999 @@
+/**
+ * pre-execution-checks.test.ts — Unit tests for pre-execution validation checks.
+ *
+ * Tests all 4 check types:
+ *   1. Package existence — npm view mocking, timeout handling
+ *   2. File path consistency — files exist vs prior expected_output
+ *   3. Task ordering — detect impossible read-before-create
+ *   4. Interface contracts — contradictory function signatures
+ */
+
+import { describe, test, mock } from "node:test";
+import assert from "node:assert/strict";
+import { tmpdir } from "node:os";
+import { mkdirSync, writeFileSync, rmSync } from "node:fs";
+import { join } from "node:path";
+
+import {
+  extractPackageReferences,
+  checkFilePathConsistency,
+  checkTaskOrdering,
+  checkInterfaceContracts,
+  runPreExecutionChecks,
+  normalizeFilePath,
+  type PreExecutionResult,
+} from "../pre-execution-checks.ts";
+import type { TaskRow } from "../gsd-db.ts";
+
+// ─── Test Fixtures ───────────────────────────────────────────────────────────
+
+/**
+ * Create a minimal TaskRow for testing.
+ */
+function createTask(overrides: Partial<TaskRow> = {}): TaskRow {
+  return {
+    milestone_id: "M001",
+    slice_id: "S01",
+    id: overrides.id ?? "T01",
+    title: "Test Task",
+    status: "pending",
+    one_liner: "",
+    narrative: "",
+    verification_result: "",
+    duration: "",
+    completed_at: null,
+    blocker_discovered: false,
+    deviations: "",
+    known_issues: "",
+    key_files: [],
+    key_decisions: [],
+    full_summary_md: "",
+    description: overrides.description ?? "",
+    estimate: "",
+    files: overrides.files ?? [],
+    verify: "",
+    inputs: overrides.inputs ?? [],
+    expected_output: overrides.expected_output ?? [],
+    observability_impact: "",
+    full_plan_md: "",
+    sequence: overrides.sequence ?? 0,
+    ...overrides,
+  };
+}
+
+// ─── Package Reference Extraction Tests ──────────────────────────────────────
+
+describe("extractPackageReferences", () => {
+  test("extracts npm install patterns", () => {
+    const desc = "Run npm install lodash then npm i axios";
+    const packages = extractPackageReferences(desc);
+    assert.deepEqual(packages.sort(), ["axios", "lodash"]);
+  });
+
+  test("extracts yarn add patterns", () => {
+    const desc = "yarn add react-dom";
+    const packages = extractPackageReferences(desc);
+    assert.deepEqual(packages, ["react-dom"]);
+  });
+
+  test("extracts scoped packages", () => {
+    const desc = "npm install @types/node @babel/core";
+    const packages = extractPackageReferences(desc);
+    assert.ok(packages.includes("@types/node"));
+    assert.ok(packages.includes("@babel/core"));
+  });
+
+  test("extracts require statements from code blocks", () => {
+    const desc = `
+\`\`\`javascript
+const fs = require('fs-extra');
+const path = require('path');
+\`\`\`
+    `;
+    const packages = extractPackageReferences(desc);
+    assert.ok(packages.includes("fs-extra"));
+  });
+
+  test("extracts import statements from code blocks", () => {
+    const desc = `
+\`\`\`typescript
+import express from 'express';
+import { Router } from 'express';
+import type { Request } from 'express';
+\`\`\`
+    `;
+    const packages = extractPackageReferences(desc);
+    assert.ok(packages.includes("express"));
+  });
+
+  test("ignores relative imports", () => {
+    const desc = `import { foo } from './local-file';`;
+    const packages = extractPackageReferences(desc);
+    assert.deepEqual(packages, []);
+  });
+
+  test("ignores node builtins", () => {
+    const desc = `import fs from 'node:fs';`;
+    const packages = extractPackageReferences(desc);
+    assert.deepEqual(packages, []);
+  });
+
+  test("normalizes package subpaths", () => {
+    const desc = "npm install lodash/get";
+    const packages = extractPackageReferences(desc);
+    assert.deepEqual(packages, ["lodash"]);
+  });
+
+  test("handles empty description", () => {
+    const packages = extractPackageReferences("");
+    assert.deepEqual(packages, []);
+  });
+
+  test("ignores flags in npm install", () => {
+    const desc = "npm install -D typescript";
+    const packages = extractPackageReferences(desc);
+    assert.ok(packages.includes("typescript"));
+    assert.ok(!packages.includes("-D"));
+  });
+});
+
+// ─── File Path Consistency Tests ─────────────────────────────────────────────
+
+describe("checkFilePathConsistency", () => {
+  let tempDir: string;
+
+  test("passes when files exist on disk", () => {
+    tempDir = join(tmpdir(), `pre-exec-test-${Date.now()}`);
+    mkdirSync(tempDir, { recursive: true });
+    writeFileSync(join(tempDir, "existing.ts"), "// content");
+
+    try {
+      const tasks = [
+        createTask({
+          id: "T01",
+          files: ["existing.ts"],
+          inputs: [],
+          expected_output: [],
+        }),
+      ];
+
+      const results = checkFilePathConsistency(tasks, tempDir);
+      assert.deepEqual(results, []);
+    } finally {
+      rmSync(tempDir, { recursive: true, force: true });
+    }
+  });
+
+  test("passes when files are in prior expected_output", () => {
+    tempDir = join(tmpdir(), `pre-exec-test-${Date.now()}`);
+    mkdirSync(tempDir, { recursive: true });
+
+    try {
+      const tasks = [
+        createTask({
+          id: "T01",
+          sequence: 0,
+          files: [],
+          inputs: [],
+          expected_output: ["generated.ts"],
+        }),
+        createTask({
+          id: "T02",
+          sequence: 1,
+          files: ["generated.ts"],
+          inputs: [],
+          expected_output: [],
+        }),
+      ];
+
+      const results = checkFilePathConsistency(tasks, tempDir);
+      assert.deepEqual(results, []);
+    } finally {
+      rmSync(tempDir, { recursive: true, force: true });
+    }
+  });
+
+  test("fails when files don't exist and not in prior outputs", () => {
+    tempDir = join(tmpdir(), `pre-exec-test-${Date.now()}`);
+    mkdirSync(tempDir, { recursive: true });
+
+    try {
+      const tasks = [
+        createTask({
+          id: "T01",
+          files: ["nonexistent.ts"],
+          inputs: [],
+          expected_output: [],
+        }),
+      ];
+
+      const results = checkFilePathConsistency(tasks, tempDir);
+      assert.equal(results.length, 1);
+      assert.equal(results[0].category, "file");
+      assert.equal(results[0].passed, false);
+      assert.equal(results[0].blocking, true);
+      assert.ok(results[0].message.includes("nonexistent.ts"));
+    } finally {
+      rmSync(tempDir, { recursive: true, force: true });
+    }
+  });
+
+  test("checks both files and inputs arrays", () => {
+    tempDir = join(tmpdir(), `pre-exec-test-${Date.now()}`);
+    mkdirSync(tempDir, { recursive: true });
+
+    try {
+      const tasks = [
+        createTask({
+          id: "T01",
+          files: ["missing-file.ts"],
+          inputs: ["missing-input.ts"],
+          expected_output: [],
+        }),
+      ];
+
+      const results = checkFilePathConsistency(tasks, tempDir);
+      assert.equal(results.length, 2);
+      assert.ok(results.some((r) => r.target === "missing-file.ts"));
+      assert.ok(results.some((r) => r.target === "missing-input.ts"));
+    } finally {
+      rmSync(tempDir, { recursive: true, force: true });
+    }
+  });
+
+  test("skips empty file strings", () => {
+    tempDir = join(tmpdir(), `pre-exec-test-${Date.now()}`);
+    mkdirSync(tempDir, { recursive: true });
+
+    try {
+      const tasks = [
+        createTask({
+          id: "T01",
+          files: ["", "  "],
+          inputs: [],
+          expected_output: [],
+        }),
+      ];
+
+      const results = checkFilePathConsistency(tasks, tempDir);
+      assert.deepEqual(results, []);
+    } finally {
+      rmSync(tempDir, { recursive: true, force: true });
+    }
+  });
+});
+
+// ─── Path Normalization Tests ────────────────────────────────────────────────
+
+describe("normalizeFilePath", () => {
+  test("strips leading ./", () => {
+    assert.equal(normalizeFilePath("./src/a.ts"), "src/a.ts");
+    assert.equal(normalizeFilePath("././foo.ts"), "foo.ts");
+  });
+
+  test("normalizes backslashes to forward slashes", () => {
+    assert.equal(normalizeFilePath("src\\a.ts"), "src/a.ts");
+    assert.equal(normalizeFilePath("src\\sub\\file.ts"), "src/sub/file.ts");
+  });
+
+  test("removes duplicate slashes", () => {
+    assert.equal(normalizeFilePath("src//a.ts"), "src/a.ts");
+    assert.equal(normalizeFilePath("src///sub//file.ts"), "src/sub/file.ts");
+  });
+
+  test("handles empty string", () => {
+    assert.equal(normalizeFilePath(""), "");
+  });
+
+  test("removes trailing slash", () => {
+    assert.equal(normalizeFilePath("src/"), "src");
+    assert.equal(normalizeFilePath("src/sub/"), "src/sub");
+  });
+
+  test("handles paths without any normalization needed", () => {
+    assert.equal(normalizeFilePath("src/a.ts"), "src/a.ts");
+    assert.equal(normalizeFilePath("index.ts"), "index.ts");
+  });
+});
+
+describe("checkFilePathConsistency with path normalization", () => {
+  let tempDir: string;
+
+  test("./path matches path in prior expected_output", () => {
+    tempDir = join(tmpdir(), `pre-exec-test-${Date.now()}`);
+    mkdirSync(tempDir, { recursive: true });
+
+    try {
+      const tasks = [
+        createTask({
+          id: "T01",
+          sequence: 0,
+          files: [],
+          inputs: [],
+          expected_output: ["src/generated.ts"], // Output without ./
+        }),
+        createTask({
+          id: "T02",
+          sequence: 1,
+          files: ["./src/generated.ts"], // Input with ./
+          inputs: [],
+          expected_output: [],
+        }),
+      ];
+
+      const results = checkFilePathConsistency(tasks, tempDir);
+      assert.deepEqual(results, [], "Should pass because ./src/generated.ts matches src/generated.ts");
+    } finally {
+      rmSync(tempDir, { recursive: true, force: true });
+    }
+  });
+
+  test("path matches ./path in prior expected_output", () => {
+    tempDir = join(tmpdir(), `pre-exec-test-${Date.now()}`);
+    mkdirSync(tempDir, { recursive: true });
+
+    try {
+      const tasks = [
+        createTask({
+          id: "T01",
+          sequence: 0,
+          files: [],
+          inputs: [],
+          expected_output: ["./src/generated.ts"], // Output with ./
+        }),
+        createTask({
+          id: "T02",
+          sequence: 1,
+          files: ["src/generated.ts"], // Input without ./
+          inputs: [],
+          expected_output: [],
+        }),
+      ];
+
+      const results = checkFilePathConsistency(tasks, tempDir);
+      assert.deepEqual(results, [], "Should pass because src/generated.ts matches ./src/generated.ts");
+    } finally {
+      rmSync(tempDir, { recursive: true, force: true });
+    }
+  });
+
+  test("paths with mixed separators match", () => {
+    tempDir = join(tmpdir(), `pre-exec-test-${Date.now()}`);
+    mkdirSync(tempDir, { recursive: true });
+
+    try {
+      const tasks = [
+        createTask({
+          id: "T01",
+          sequence: 0,
+          files: [],
+          inputs: [],
+          expected_output: ["src/sub/file.ts"],
+        }),
+        createTask({
+          id: "T02",
+          sequence: 1,
+          files: ["src\\sub\\file.ts"], // Backslash separators
+          inputs: [],
+          expected_output: [],
+        }),
+      ];
+
+      const results = checkFilePathConsistency(tasks, tempDir);
+      assert.deepEqual(results, [], "Should pass because backslash paths normalize to forward slash");
+    } finally {
+      rmSync(tempDir, { recursive: true, force: true });
+    }
+  });
+});
+
+describe("checkTaskOrdering with path normalization", () => {
+  test("./path triggers ordering check for path in expected_output", () => {
+    const tasks = [
+      createTask({
+        id: "T01",
+        sequence: 0,
+        files: ["./generated.ts"], // Reads with ./
+        inputs: [],
+        expected_output: [],
+      }),
+      createTask({
+        id: "T02",
+        sequence: 1,
+        files: [],
+        inputs: [],
+        expected_output: ["generated.ts"], // Creates without ./
+      }),
+    ];
+
+    const results = checkTaskOrdering(tasks, "/tmp");
+    assert.equal(results.length, 1, "Should detect ordering violation despite ./");
+    assert.ok(results[0].message.includes("T01"));
+    assert.ok(results[0].message.includes("T02"));
+  });
+
+  test("path triggers ordering check for ./path in expected_output", () => {
+    const tasks = [
+      createTask({
+        id: "T01",
+        sequence: 0,
+        files: ["generated.ts"], // Reads without ./
+        inputs: [],
+        expected_output: [],
+      }),
+      createTask({
+        id: "T02",
+        sequence: 1,
+        files: [],
+        inputs: [],
+        expected_output: ["./generated.ts"], // Creates with ./
+      }),
+    ];
+
+    const results = checkTaskOrdering(tasks, "/tmp");
+    assert.equal(results.length, 1, "Should detect ordering violation despite ./ on creator");
+    assert.ok(results[0].message.includes("sequence violation"));
+  });
+
+  test("no false positive when correctly ordered with mixed paths", () => {
+    const tasks = [
+      createTask({
+        id: "T01",
+        sequence: 0,
+        files: [],
+        inputs: [],
+        expected_output: ["./src/api.ts"],
+      }),
+      createTask({
+        id: "T02",
+        sequence: 1,
+        files: ["src/api.ts"], // Same file, different notation
+        inputs: [],
+        expected_output: [],
+      }),
+    ];
+
+    const results = checkTaskOrdering(tasks, "/tmp");
+    assert.deepEqual(results, [], "Should pass - T02 reads file that T01 already created");
+  });
+});
+
+// ─── Task Ordering Tests ─────────────────────────────────────────────────────
+
+describe("checkTaskOrdering", () => {
+  test("passes when tasks are correctly ordered", () => {
+    const tasks = [
+      createTask({
+        id: "T01",
+        sequence: 0,
+        files: [],
+        inputs: [],
+        expected_output: ["api.ts"],
+      }),
+      createTask({
+        id: "T02",
+        sequence: 1,
+        files: ["api.ts"],
+        inputs: [],
+        expected_output: [],
+      }),
+    ];
+
+    const results = checkTaskOrdering(tasks, "/tmp");
+    assert.deepEqual(results, []);
+  });
+
+  test("fails when task reads file created by later task", () => {
+    const tasks = [
+      createTask({
+        id: "T01",
+        sequence: 0,
+        files: ["generated.ts"], // Reads file that doesn't exist yet
+        inputs: [],
+        expected_output: [],
+      }),
+      createTask({
+        id: "T02",
+        sequence: 1,
+        files: [],
+        inputs: [],
+        expected_output: ["generated.ts"], // Creates the file
+      }),
+    ];
+
+    const results = checkTaskOrdering(tasks, "/tmp");
+    assert.equal(results.length, 1);
+    assert.equal(results[0].category, "file");
+    assert.equal(results[0].passed, false);
+    assert.equal(results[0].blocking, true);
+    assert.ok(results[0].message.includes("T01"));
+    assert.ok(results[0].message.includes("T02"));
+    assert.ok(results[0].message.includes("sequence violation"));
+  });
+
+  test("detects ordering violation in inputs array", () => {
+    const tasks = [
+      createTask({
+        id: "T01",
+        sequence: 0,
+        files: [],
+        inputs: ["schema.json"],
+        expected_output: [],
+      }),
+      createTask({
+        id: "T02",
+        sequence: 1,
+        files: [],
+        inputs: [],
+        expected_output: ["schema.json"],
+      }),
+    ];
+
+    const results = checkTaskOrdering(tasks, "/tmp");
+    assert.equal(results.length, 1);
+    assert.ok(results[0].message.includes("schema.json"));
+  });
+
+  test("handles multiple ordering violations", () => {
+    const tasks = [
+      createTask({
+        id: "T01",
+        sequence: 0,
+        files: ["a.ts", "b.ts"],
+        inputs: [],
+        expected_output: [],
+      }),
+      createTask({
+        id: "T02",
+        sequence: 1,
+        files: [],
+        inputs: [],
+        expected_output: ["a.ts"],
+      }),
+      createTask({
+        id: "T03",
+        sequence: 2,
+        files: [],
+        inputs: [],
+        expected_output: ["b.ts"],
+      }),
+    ];
+
+    const results = checkTaskOrdering(tasks, "/tmp");
+    assert.equal(results.length, 2);
+  });
+
+  test("passes when no dependencies between tasks", () => {
+    const tasks = [
+      createTask({
+        id: "T01",
+        sequence: 0,
+        files: [],
+        inputs: [],
+        expected_output: ["a.ts"],
+      }),
+      createTask({
+        id: "T02",
+        sequence: 1,
+        files: [],
+        inputs: [],
+        expected_output: ["b.ts"],
+      }),
+    ];
+
+    const results = checkTaskOrdering(tasks, "/tmp");
+    assert.deepEqual(results, []);
+  });
+});
+
+// ─── Interface Contract Tests ────────────────────────────────────────────────
+
+describe("checkInterfaceContracts", () => {
+  test("passes when function signatures match", () => {
+    const tasks = [
+      createTask({
+        id: "T01",
+        description: `
+\`\`\`typescript
+function processData(input: string): boolean
+\`\`\`
+        `,
+      }),
+      createTask({
+        id: "T02",
+        description: `
+\`\`\`typescript
+function processData(input: string): boolean
+\`\`\`
+        `,
+      }),
+    ];
+
+    const results = checkInterfaceContracts(tasks, "/tmp");
+    assert.deepEqual(results, []);
+  });
+
+  test("warns on parameter mismatch (non-blocking)", () => {
+    const tasks = [
+      createTask({
+        id: "T01",
+        description: `
+\`\`\`typescript
+function saveUser(name: string): void
+\`\`\`
+        `,
+      }),
+      createTask({
+        id: "T02",
+        description: `
+\`\`\`typescript
+function saveUser(name: string, email: string): void
+\`\`\`
+        `,
+      }),
+    ];
+
+    const results = checkInterfaceContracts(tasks, "/tmp");
+    assert.equal(results.length, 1);
+    assert.equal(results[0].category, "schema");
+    assert.equal(results[0].target, "saveUser");
+    assert.equal(results[0].passed, true); // Warning, not failure
+    assert.equal(results[0].blocking, false);
+    assert.ok(results[0].message.includes("different parameters"));
+  });
+
+  test("warns on return type mismatch (non-blocking)", () => {
+    const tasks = [
+      createTask({
+        id: "T01",
+        description: `
+\`\`\`typescript
+function getData(): string
+\`\`\`
+        `,
+      }),
+      createTask({
+        id: "T02",
+        description: `
+\`\`\`typescript
+function getData(): number
+\`\`\`
+        `,
+      }),
+    ];
+
+    const results = checkInterfaceContracts(tasks, "/tmp");
+    assert.equal(results.length, 1);
+    assert.ok(results[0].message.includes("different return types"));
+  });
+
+  test("handles export function syntax", () => {
+    const tasks = [
+      createTask({
+        id: "T01",
+        description: `
+\`\`\`typescript
+export function validate(data: object): boolean
+\`\`\`
+        `,
+      }),
+      createTask({
+        id: "T02",
+        description: `
+\`\`\`typescript
+export function validate(data: string): boolean
+\`\`\`
+        `,
+      }),
+    ];
+
+    const results = checkInterfaceContracts(tasks, "/tmp");
+    assert.equal(results.length, 1);
+    assert.ok(results[0].message.includes("validate"));
+  });
+
+  test("handles async function syntax", () => {
+    const tasks = [
+      createTask({
+        id: "T01",
+        description: `
+\`\`\`typescript
+export async function fetchData(): Promise<string>
+\`\`\`
+        `,
+      }),
+      createTask({
+        id: "T02",
+        description: `
+\`\`\`typescript
+export async function fetchData(): Promise<number>
+\`\`\`
+        `,
+      }),
+    ];
+
+    const results = checkInterfaceContracts(tasks, "/tmp");
+    assert.equal(results.length, 1);
+  });
+
+  test("handles const arrow function syntax", () => {
+    const tasks = [
+      createTask({
+        id: "T01",
+        description: `
+\`\`\`typescript
+const handler = (req: Request): Response =>
+\`\`\`
+        `,
+      }),
+      createTask({
+        id: "T02",
+        description: `
+\`\`\`typescript
+const handler = (req: Request, res: Response): void =>
+\`\`\`
+        `,
+      }),
+    ];
+
+    const results = checkInterfaceContracts(tasks, "/tmp");
+    // Should have 2 results: parameter mismatch AND return type mismatch
+    assert.equal(results.length, 2);
+    assert.ok(results.some((r) => r.message.includes("handler")));
+    assert.ok(results.some((r) => r.message.includes("parameters")));
+    assert.ok(results.some((r) => r.message.includes("return types")));
+  });
+
+  test("passes when no code blocks present", () => {
+    const tasks = [
+      createTask({
+        id: "T01",
+        description: "Just some text without code blocks",
+      }),
+    ];
+
+    const results = checkInterfaceContracts(tasks, "/tmp");
+    assert.deepEqual(results, []);
+  });
+
+  test("handles multiple mismatches for same function", () => {
+    const tasks = [
+      createTask({
+        id: "T01",
+        description: `
+\`\`\`typescript
+function process(a: string): string
+\`\`\`
+        `,
+      }),
+      createTask({
+        id: "T02",
+        description: `
+\`\`\`typescript
+function process(a: number): number
+\`\`\`
+        `,
+      }),
+    ];
+
+    const results = checkInterfaceContracts(tasks, "/tmp");
+    // Should have both parameter and return type mismatches
+    assert.equal(results.length, 2);
+  });
+});
+
+// ─── runPreExecutionChecks Integration Tests ─────────────────────────────────
+
+describe("runPreExecutionChecks", () => {
+  let tempDir: string;
+
+  test("returns pass status when all checks pass", async () => {
+    tempDir = join(tmpdir(), `pre-exec-test-${Date.now()}`);
+    mkdirSync(tempDir, { recursive: true });
+    writeFileSync(join(tempDir, "existing.ts"), "// content");
+
+    try {
+      const tasks = [
+        createTask({
+          id: "T01",
+          files: ["existing.ts"],
+          inputs: [],
+          expected_output: ["output.ts"],
+        }),
+        createTask({
+          id: "T02",
+          files: ["output.ts"],
+          inputs: [],
+          expected_output: [],
+        }),
+      ];
+
+      const result = await runPreExecutionChecks(tasks, tempDir);
+      assert.equal(result.status, "pass");
+      assert.equal(result.checks.length, 0);
+      assert.ok(result.durationMs >= 0);
+    } finally {
+      rmSync(tempDir, { recursive: true, force: true });
+    }
+  });
+
+  test("returns fail status when blocking failure exists", async () => {
+    tempDir = join(tmpdir(), `pre-exec-test-${Date.now()}`);
+    mkdirSync(tempDir, { recursive: true });
+
+    try {
+      const tasks = [
+        createTask({
+          id: "T01",
+          files: ["nonexistent.ts"],
+          inputs: [],
+          expected_output: [],
+        }),
+      ];
+
+      const result = await runPreExecutionChecks(tasks, tempDir);
+      assert.equal(result.status, "fail");
+      assert.ok(result.checks.length > 0);
+      assert.ok(result.checks.some((c) => c.blocking === true));
+    } finally {
+      rmSync(tempDir, { recursive: true, force: true });
+    }
+  });
+
+  test("returns warn status for non-blocking issues", async () => {
+    tempDir = join(tmpdir(), `pre-exec-test-${Date.now()}`);
+    mkdirSync(tempDir, { recursive: true });
+
+    try {
+      // Create tasks with only interface contract warnings
+      const tasks = [
+        createTask({
+          id: "T01",
+          files: [],
+          inputs: [],
+          expected_output: [],
+          description: `
+\`\`\`typescript
+function foo(a: string): void
+\`\`\`
+          `,
+        }),
+        createTask({
+          id: "T02",
+          files: [],
+          inputs: [],
+          expected_output: [],
+          description: `
+\`\`\`typescript
+function foo(a: number): void
+\`\`\`
+          `,
+        }),
+      ];
+
+      const result = await runPreExecutionChecks(tasks, tempDir);
+      assert.equal(result.status, "warn");
+      assert.ok(result.checks.some((c) => c.blocking === false));
+    } finally {
+      rmSync(tempDir, { recursive: true, force: true });
+    }
+  });
+
+  test("combines results from all check types", async () => {
+    tempDir = join(tmpdir(), `pre-exec-test-${Date.now()}`);
+    mkdirSync(tempDir, { recursive: true });
+
+    try {
+      const tasks = [
+        createTask({
+          id: "T01",
+          sequence: 0,
+          files: ["will-be-created.ts"], // Ordering violation
+          inputs: ["missing.ts"],        // Missing file
+          expected_output: [],
+          description: `
+\`\`\`typescript
+function check(a: string): void
+\`\`\`
+          `,
+        }),
+        createTask({
+          id: "T02",
+          sequence: 1,
+          files: [],
+          inputs: [],
+          expected_output: ["will-be-created.ts"],
+          description: `
+\`\`\`typescript
+function check(a: number): void
+\`\`\`
+          `,
+        }),
+      ];
+
+      const result = await runPreExecutionChecks(tasks, tempDir);
+      assert.equal(result.status, "fail");
+
+      // Should have multiple types of issues
+      const categories = new Set(result.checks.map((c) => c.category));
+      assert.ok(categories.has("file"));  // From consistency and ordering
+      assert.ok(categories.has("schema")); // From interface check
+    } finally {
+      rmSync(tempDir, { recursive: true, force: true });
+    }
+  });
+
+  test("reports duration in milliseconds", async () => {
+    tempDir = join(tmpdir(), `pre-exec-test-${Date.now()}`);
+    mkdirSync(tempDir, { recursive: true });
+
+    try {
+      const tasks = [createTask({ id: "T01" })];
+      const result = await runPreExecutionChecks(tasks, tempDir);
+
+      assert.ok(typeof result.durationMs === "number");
+      assert.ok(result.durationMs >= 0);
+    } finally {
+      rmSync(tempDir, { recursive: true, force: true });
+    }
+  });
+
+  test("handles empty task array", async () => {
+    tempDir = join(tmpdir(), `pre-exec-test-${Date.now()}`);
+    mkdirSync(tempDir, { recursive: true });
+
+    try {
+      const result = await runPreExecutionChecks([], tempDir);
+      assert.equal(result.status, "pass");
+      assert.deepEqual(result.checks, []);
+    } finally {
+      rmSync(tempDir, { recursive: true, force: true });
+    }
+  });
+});
+
+// ─── PreExecutionResult Type Tests ───────────────────────────────────────────
+
+describe("PreExecutionResult type", () => {
+  test("status is one of pass, warn, fail", async () => {
+    const tempDir = join(tmpdir(), `pre-exec-test-${Date.now()}`);
+    mkdirSync(tempDir, { recursive: true });
+
+    try {
+      const tasks = [createTask({ id: "T01" })];
+      const result = await runPreExecutionChecks(tasks, tempDir);
+
+      assert.ok(["pass", "warn", "fail"].includes(result.status));
+    } finally {
+      rmSync(tempDir, { recursive: true, force: true });
+    }
+  });
+
+  test("checks array matches PreExecutionCheckJSON schema", async () => {
+    const tempDir = join(tmpdir(), `pre-exec-test-${Date.now()}`);
+    mkdirSync(tempDir, { recursive: true });
+
+    try {
+      const tasks = [
+        createTask({
+          id: "T01",
+          files: ["missing.ts"],
+        }),
+      ];
+
+      const result = await runPreExecutionChecks(tasks, tempDir);
+
+      for (const check of result.checks) {
+        assert.ok(["package", "file", "tool", "endpoint", "schema"].includes(check.category));
+        assert.ok(typeof check.target === "string");
+        assert.ok(typeof check.passed === "boolean");
+        assert.ok(typeof check.message === "string");
+        if (check.blocking !== undefined) {
+          assert.ok(typeof check.blocking === "boolean");
+        }
+      }
+    } finally {
+      rmSync(tempDir, { recursive: true, force: true });
+    }
+  });
+});