va-agent-protocol 0.1.0

package/dist/orchestrator/scheduler.js

@@ -0,0 +1,155 @@
+/**
+ * Scheduler — match tasks to capable agents, respecting constraints.
+ *
+ * Responsibilities:
+ * - Match task requirements to agent capabilities
+ * - Respect concurrency limits
+ * - Handle dependency ordering
+ * - Select the best agent when multiple can handle a task
+ */
+export class Scheduler {
+    registry;
+    /** Track how many tasks each agent is currently running. */
+    activeCounts = new Map();
+    constructor(registry) {
+        this.registry = registry;
+    }
+    /**
+     * Schedule a single task: find the best available agent.
+     *
+     * Selection criteria (in order):
+     * 1. Must have required capabilities (inferred from task)
+     * 2. Must have available concurrency slots
+     * 3. Prefer agents with fewer extra capabilities (more specialized)
+     */
+    schedule(task) {
+        const requiredCapabilities = this.inferCapabilities(task);
+        const candidates = this.registry.findByCapabilities(requiredCapabilities);
+        if (candidates.length === 0) {
+            return {
+                type: "rejected",
+                rejection: {
+                    taskId: task.id,
+                    reason: `No agent found with capabilities: ${requiredCapabilities.join(", ")}`,
+                },
+            };
+        }
+        // Filter by concurrency availability
+        const available = candidates.filter((c) => this.hasCapacity(c));
+        if (available.length === 0) {
+            return {
+                type: "rejected",
+                rejection: {
+                    taskId: task.id,
+                    reason: `All capable agents are at max concurrency.`,
+                },
+            };
+        }
+        // Pick the best available agent
+        const selected = available[0];
+        return {
+            type: "scheduled",
+            decision: {
+                taskId: task.id,
+                agentId: selected.capability.agentId,
+                adapter: selected.adapter,
+                reason: `Matched capabilities: ${requiredCapabilities.join(", ")}`,
+            },
+        };
+    }
+    /**
+     * Schedule multiple tasks, respecting dependencies.
+     * Returns tasks in executable order (dependencies first).
+     */
+    scheduleBatch(tasks) {
+        const scheduled = [];
+        const rejected = [];
+        const deferred = [];
+        // Separate tasks with unsatisfied dependencies
+        const completedIds = new Set();
+        const pending = [...tasks];
+        // Simple topological pass: keep scheduling until no progress
+        let madeProgress = true;
+        while (madeProgress && pending.length > 0) {
+            madeProgress = false;
+            const remaining = [];
+            for (const task of pending) {
+                const deps = task.dependsOn ?? [];
+                const satisfied = deps.every((dep) => completedIds.has(dep));
+                if (!satisfied) {
+                    remaining.push(task);
+                    continue;
+                }
+                const result = this.schedule(task);
+                if (result.type === "scheduled") {
+                    scheduled.push(result.decision);
+                    completedIds.add(task.id);
+                    this.acquire(result.decision.agentId);
+                    madeProgress = true;
+                }
+                else {
+                    rejected.push(result.rejection);
+                    madeProgress = true;
+                }
+            }
+            pending.length = 0;
+            pending.push(...remaining);
+        }
+        // Anything left has unsatisfied dependencies
+        deferred.push(...pending);
+        return { scheduled, rejected, deferred };
+    }
+    /** Mark an agent slot as acquired. */
+    acquire(agentId) {
+        this.activeCounts.set(agentId, (this.activeCounts.get(agentId) ?? 0) + 1);
+    }
+    /** Release an agent slot. */
+    release(agentId) {
+        const current = this.activeCounts.get(agentId) ?? 0;
+        if (current > 0) {
+            this.activeCounts.set(agentId, current - 1);
+        }
+    }
+    /** Reset all concurrency tracking. */
+    reset() {
+        this.activeCounts.clear();
+    }
+    // ─── Private ─────────────────────────────────────────────────────────────
+    hasCapacity(agent) {
+        const max = agent.capability.constraints?.maxConcurrent ?? 1;
+        const current = this.activeCounts.get(agent.capability.agentId) ?? 0;
+        return current < max;
+    }
+    /**
+     * Infer required capabilities from task content.
+     * This is a simple heuristic — adapters can override with explicit capability tags.
+     */
+    inferCapabilities(task) {
+        const caps = [];
+        const text = `${task.objective} ${(task.constraints ?? []).join(" ")}`.toLowerCase();
+        if (text.includes("implement") ||
+            text.includes("build") ||
+            text.includes("create") ||
+            text.includes("add")) {
+            caps.push("code-generation");
+        }
+        if (text.includes("review") || text.includes("audit")) {
+            caps.push("code-review");
+        }
+        if (text.includes("test")) {
+            caps.push("testing");
+        }
+        if (text.includes("refactor") || text.includes("optimize")) {
+            caps.push("refactoring");
+        }
+        if (text.includes("deploy") || text.includes("release")) {
+            caps.push("deployment");
+        }
+        // Default: if nothing inferred, require code-generation as baseline
+        if (caps.length === 0) {
+            caps.push("code-generation");
+        }
+        return caps;
+    }
+}
+//# sourceMappingURL=scheduler.js.map

package/dist/orchestrator/scheduler.js.map

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

package/dist/test/orchestrator-enqueue.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=orchestrator-enqueue.test.d.ts.map

package/dist/test/orchestrator-enqueue.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator-enqueue.test.d.ts","sourceRoot":"","sources":["../../src/test/orchestrator-enqueue.test.ts"],"names":[],"mappings":""}

package/dist/test/orchestrator-enqueue.test.js

@@ -0,0 +1,64 @@
+import assert from "node:assert";
+import { describe, it } from "node:test";
+import { AgentRegistry, Orchestrator, } from "../index.js";
+const mockAdapter = {
+    id: "mock-agent",
+    capabilities() {
+        return {
+            agentId: "mock-agent",
+            name: "Mock Agent",
+            version: "1.0.0",
+            capabilities: ["test"],
+            interface: {
+                type: "cli",
+                command: "mock-agent",
+            },
+        };
+    },
+    async dispatch(task) {
+        return {
+            correlationId: `corr-${task.id}`,
+            accepted: true,
+        };
+    },
+    async poll(correlationId) {
+        return {
+            correlationId,
+            state: "running",
+        };
+    },
+    async cancel(_correlationId) {
+        return;
+    },
+};
+function makeTask(id, dependsOn) {
+    return {
+        id,
+        objective: `Task ${id}`,
+        acceptanceCriteria: ["should complete"],
+        dependsOn,
+    };
+}
+describe("Orchestrator.enqueue", () => {
+    it("adds tasks to the queue", () => {
+        const registry = new AgentRegistry();
+        registry.register(mockAdapter);
+        const orchestrator = new Orchestrator(registry);
+        orchestrator.enqueue(makeTask("task-1"), makeTask("task-2", ["task-1"]));
+        assert.equal(orchestrator.pendingCount, 2);
+    });
+    it("rejects tasks that participate in dependency cycles", () => {
+        const failedTaskIds = [];
+        const registry = new AgentRegistry();
+        registry.register(mockAdapter);
+        const orchestrator = new Orchestrator(registry, {
+            onFailed(taskId) {
+                failedTaskIds.push(taskId);
+            },
+        });
+        orchestrator.enqueue(makeTask("task-a", ["task-b"]), makeTask("task-b", ["task-a"]));
+        assert.equal(orchestrator.pendingCount, 0);
+        assert.deepEqual(new Set(failedTaskIds), new Set(["task-a", "task-b"]));
+    });
+});
+//# sourceMappingURL=orchestrator-enqueue.test.js.map

package/dist/test/orchestrator-enqueue.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator-enqueue.test.js","sourceRoot":"","sources":["../../src/test/orchestrator-enqueue.test.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,aAAa,CAAC;AACjC,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,EACL,aAAa,EACb,YAAY,GAKb,MAAM,aAAa,CAAC;AAErB,MAAM,WAAW,GAAiB;IAChC,EAAE,EAAE,YAAY;IAChB,YAAY;QACV,OAAO;YACL,OAAO,EAAE,YAAY;YACrB,IAAI,EAAE,YAAY;YAClB,OAAO,EAAE,OAAO;YAChB,YAAY,EAAE,CAAC,MAAM,CAAC;YACtB,SAAS,EAAE;gBACT,IAAI,EAAE,KAAK;gBACX,OAAO,EAAE,YAAY;aACtB;SACF,CAAC;IACJ,CAAC;IACD,KAAK,CAAC,QAAQ,CAAC,IAAc;QAC3B,OAAO;YACL,aAAa,EAAE,QAAQ,IAAI,CAAC,EAAE,EAAE;YAChC,QAAQ,EAAE,IAAI;SACf,CAAC;IACJ,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,aAAqB;QAC9B,OAAO;YACL,aAAa;YACb,KAAK,EAAE,SAAS;SACjB,CAAC;IACJ,CAAC;IACD,KAAK,CAAC,MAAM,CAAC,cAAsB;QACjC,OAAO;IACT,CAAC;CACF,CAAC;AAEF,SAAS,QAAQ,CAAC,EAAU,EAAE,SAAoB;IAChD,OAAO;QACL,EAAE;QACF,SAAS,EAAE,QAAQ,EAAE,EAAE;QACvB,kBAAkB,EAAE,CAAC,iBAAiB,CAAC;QACvC,SAAS;KACV,CAAC;AACJ,CAAC;AAED,QAAQ,CAAC,sBAAsB,EAAE,GAAG,EAAE;IACpC,EAAE,CAAC,yBAAyB,EAAE,GAAG,EAAE;QACjC,MAAM,QAAQ,GAAG,IAAI,aAAa,EAAE,CAAC;QACrC,QAAQ,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;QAE/B,MAAM,YAAY,GAAG,IAAI,YAAY,CAAC,QAAQ,CAAC,CAAC;QAEhD,YAAY,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;QAEzE,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qDAAqD,EAAE,GAAG,EAAE;QAC7D,MAAM,aAAa,GAAa,EAAE,CAAC;QAEnC,MAAM,QAAQ,GAAG,IAAI,aAAa,EAAE,CAAC;QACrC,QAAQ,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;QAE/B,MAAM,YAAY,GAAG,IAAI,YAAY,CAAC,QAAQ,EAAE;YAC9C,QAAQ,CAAC,MAAM;gBACb,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAC7B,CAAC;SACF,CAAC,CAAC;QAEH,YAAY,CAAC,OAAO,CAClB,QAAQ,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,CAAC,EAC9B,QAAQ,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,CAAC,CAC/B,CAAC;QAEF,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC;QAC3C,MAAM,CAAC,SAAS,CAAC,IAAI,GAAG,CAAC,aAAa,CAAC,EAAE,IAAI,GAAG,CAAC,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;IAC1E,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/test/orchestrator-lifecycle.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=orchestrator-lifecycle.test.d.ts.map

package/dist/test/orchestrator-lifecycle.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator-lifecycle.test.d.ts","sourceRoot":"","sources":["../../src/test/orchestrator-lifecycle.test.ts"],"names":[],"mappings":""}

package/dist/test/orchestrator-lifecycle.test.js

@@ -0,0 +1,227 @@
+import assert from "node:assert";
+import { describe, it, beforeEach } from "node:test";
+import { AgentRegistry, Orchestrator, noopLogger, } from "../index.js";
+/**
+ * Configurable mock adapter that lets tests control poll responses.
+ */
+class MockAdapter {
+    caps;
+    maxConcurrent;
+    id;
+    correlationCounter = 0;
+    /** Map of correlationId → sequence of PollResults to return. */
+    pollResponses = new Map();
+    pollIndex = new Map();
+    dispatched = [];
+    cancelled = [];
+    constructor(id, caps = ["code-generation"], maxConcurrent = 2) {
+        this.caps = caps;
+        this.maxConcurrent = maxConcurrent;
+        this.id = id;
+    }
+    capabilities() {
+        return {
+            agentId: this.id,
+            name: `Mock ${this.id}`,
+            version: "1.0.0",
+            capabilities: this.caps,
+            interface: { type: "cli", command: this.id },
+            constraints: { maxConcurrent: this.maxConcurrent },
+        };
+    }
+    /** Pre-configure the poll responses for the next dispatched task. */
+    setPollSequence(correlationId, responses) {
+        this.pollResponses.set(correlationId, responses);
+        this.pollIndex.set(correlationId, 0);
+    }
+    async dispatch(task) {
+        this.dispatched.push(task);
+        const correlationId = `corr-${this.id}-${++this.correlationCounter}`;
+        return { correlationId, accepted: true };
+    }
+    async poll(correlationId) {
+        const responses = this.pollResponses.get(correlationId);
+        if (!responses) {
+            return { correlationId, state: "running" };
+        }
+        const idx = this.pollIndex.get(correlationId) ?? 0;
+        const response = responses[Math.min(idx, responses.length - 1)];
+        this.pollIndex.set(correlationId, idx + 1);
+        return response;
+    }
+    async cancel(correlationId) {
+        this.cancelled.push(correlationId);
+    }
+}
+function makeTask(id, opts = {}) {
+    return {
+        id,
+        objective: opts.objective ?? `Task ${id}`,
+        acceptanceCriteria: opts.acceptanceCriteria ?? ["should pass"],
+        ...opts,
+    };
+}
+describe("Orchestrator lifecycle", () => {
+    let registry;
+    let adapter;
+    beforeEach(() => {
+        registry = new AgentRegistry();
+        adapter = new MockAdapter("test-agent");
+        registry.register(adapter);
+    });
+    describe("state transitions", () => {
+        it("transitions to completed and fires onCompleted callback", async () => {
+            const completed = [];
+            const orchestrator = new Orchestrator(registry, {
+                logger: noopLogger,
+                onCompleted: (taskId) => completed.push(taskId),
+            });
+            const task = makeTask("T1", { objective: "Build something" });
+            const correlationId = await orchestrator.dispatchNow(task);
+            assert.ok(correlationId);
+            // Configure adapter to return completed on next poll
+            adapter.setPollSequence(correlationId, [
+                {
+                    correlationId,
+                    state: "completed",
+                    evidence: {
+                        taskId: "T1",
+                        status: "completed",
+                        verification: "All gates passed",
+                    },
+                },
+            ]);
+            // Manually trigger a poll cycle by starting/stopping quickly
+            // Use dispatchNow + direct status check
+            const status = orchestrator.status();
+            assert.equal(status.length, 1);
+            assert.equal(status[0].state, "running");
+            await orchestrator.shutdown();
+        });
+        it("transitions to failed and retries with pitfall context", async () => {
+            const failedPermanently = [];
+            const orchestrator = new Orchestrator(registry, {
+                logger: noopLogger,
+                maxRetries: 0, // No retries — fail immediately
+                onFailed: (taskId) => failedPermanently.push(taskId),
+            });
+            const task = makeTask("T1", { objective: "Create a new feature" });
+            const correlationId = await orchestrator.dispatchNow(task);
+            assert.ok(correlationId);
+            // Configure adapter to return failed
+            adapter.setPollSequence(correlationId, [
+                {
+                    correlationId,
+                    state: "failed",
+                    evidence: {
+                        taskId: "T1",
+                        status: "failed",
+                        failureDetail: {
+                            failureType: "gate",
+                            attempted: "typecheck",
+                            hypothesis: "Missing import statement",
+                        },
+                    },
+                },
+            ]);
+            await orchestrator.shutdown();
+        });
+        it("handles blocked state and onBlocked callback", async () => {
+            const blocked = [];
+            const orchestrator = new Orchestrator(registry, {
+                logger: noopLogger,
+                onBlocked: (taskId, reason) => blocked.push({ taskId, reason }),
+            });
+            const task = makeTask("T1", { objective: "Implement auth" });
+            const correlationId = await orchestrator.dispatchNow(task);
+            assert.ok(correlationId);
+            // Configure adapter to return blocked
+            adapter.setPollSequence(correlationId, [
+                {
+                    correlationId,
+                    state: "blocked",
+                    evidence: {
+                        taskId: "T1",
+                        status: "blocked",
+                        blockReason: {
+                            type: "human-decision",
+                            description: "Needs architecture review",
+                        },
+                    },
+                },
+            ]);
+            await orchestrator.shutdown();
+        });
+    });
+    describe("input resolution", () => {
+        it("dispatches tasks with static inputs unchanged", async () => {
+            const orchestrator = new Orchestrator(registry, {
+                logger: noopLogger,
+            });
+            const task = makeTask("T1", {
+                objective: "Build a component",
+                inputs: { framework: "react", version: 18 },
+            });
+            const correlationId = await orchestrator.dispatchNow(task);
+            assert.ok(correlationId);
+            // The adapter should receive the task with inputs intact
+            assert.equal(adapter.dispatched.length, 1);
+            assert.deepEqual(adapter.dispatched[0].inputs, {
+                framework: "react",
+                version: 18,
+            });
+            await orchestrator.shutdown();
+        });
+    });
+    describe("timeout", () => {
+        it("respects task timeout during dispatch", async () => {
+            const failedTasks = [];
+            const orchestrator = new Orchestrator(registry, {
+                logger: noopLogger,
+                onFailed: (taskId) => failedTasks.push(taskId),
+            });
+            // Create a task with an already-expired timeout (0ms)
+            const task = makeTask("T1", {
+                objective: "Build something",
+                timeout: 1, // 1ms — will timeout immediately on next poll
+            });
+            const correlationId = await orchestrator.dispatchNow(task);
+            assert.ok(correlationId);
+            // Verify the task is active before timeout check
+            const status = orchestrator.status();
+            assert.equal(status.length, 1);
+            await orchestrator.shutdown();
+        });
+    });
+    describe("cancellation", () => {
+        it("cancels an active task", async () => {
+            const orchestrator = new Orchestrator(registry, {
+                logger: noopLogger,
+            });
+            const task = makeTask("T1", { objective: "Build a module" });
+            const correlationId = await orchestrator.dispatchNow(task);
+            assert.ok(correlationId);
+            await orchestrator.cancelTask(correlationId);
+            // Task should be removed from active
+            assert.equal(orchestrator.status().length, 0);
+            // Adapter should have received cancel
+            assert.ok(adapter.cancelled.includes(correlationId));
+            await orchestrator.shutdown();
+        });
+    });
+    describe("dependency ordering", () => {
+        it("enqueues tasks and respects pendingCount", () => {
+            const orchestrator = new Orchestrator(registry, {
+                logger: noopLogger,
+            });
+            const t1 = makeTask("T1", { objective: "Build core" });
+            const t2 = makeTask("T2", {
+                objective: "Add tests",
+                dependsOn: ["T1"],
+            });
+            orchestrator.enqueue(t1, t2);
+            assert.equal(orchestrator.pendingCount, 2);
+        });
+    });
+});
+//# sourceMappingURL=orchestrator-lifecycle.test.js.map

package/dist/test/orchestrator-lifecycle.test.js.map

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

package/dist/test/scheduler.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=scheduler.test.d.ts.map

package/dist/test/scheduler.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduler.test.d.ts","sourceRoot":"","sources":["../../src/test/scheduler.test.ts"],"names":[],"mappings":""}

package/dist/test/scheduler.test.js

@@ -0,0 +1,140 @@
+import assert from "node:assert";
+import { describe, it, beforeEach } from "node:test";
+import { AgentRegistry, Scheduler, } from "../index.js";
+function makeAdapter(id, capabilities, maxConcurrent = 1) {
+    return {
+        id,
+        capabilities() {
+            return {
+                agentId: id,
+                name: `Agent ${id}`,
+                version: "1.0.0",
+                capabilities,
+                interface: { type: "cli", command: id },
+                constraints: { maxConcurrent },
+            };
+        },
+        async dispatch(_task) {
+            return { correlationId: `corr-${_task.id}`, accepted: true };
+        },
+        async poll(correlationId) {
+            return { correlationId, state: "running" };
+        },
+        async cancel() { },
+    };
+}
+function makeTask(id, objective, dependsOn) {
+    return {
+        id,
+        objective,
+        acceptanceCriteria: ["should pass"],
+        dependsOn,
+    };
+}
+describe("Scheduler", () => {
+    let registry;
+    let scheduler;
+    beforeEach(() => {
+        registry = new AgentRegistry();
+        scheduler = new Scheduler(registry);
+    });
+    describe("capability matching", () => {
+        it("matches a task to an agent with the required capability", () => {
+            registry.register(makeAdapter("coder", ["code-generation"]));
+            const result = scheduler.schedule(makeTask("T1", "Implement a login form"));
+            assert.equal(result.type, "scheduled");
+            if (result.type === "scheduled") {
+                assert.equal(result.decision.agentId, "coder");
+            }
+        });
+        it("rejects a task when no agent has the required capability", () => {
+            registry.register(makeAdapter("reviewer", ["code-review"]));
+            // "Implement" infers "code-generation" which the reviewer doesn't have
+            const result = scheduler.schedule(makeTask("T1", "Implement feature X"));
+            assert.equal(result.type, "rejected");
+            if (result.type === "rejected") {
+                assert.ok(result.rejection.reason.includes("No agent found"));
+            }
+        });
+        it("prefers specialized agents over generalists", () => {
+            // Generalist has more capabilities
+            registry.register(makeAdapter("generalist", [
+                "code-generation",
+                "code-review",
+                "testing",
+                "refactoring",
+            ]));
+            // Specialist has only what's needed
+            registry.register(makeAdapter("specialist", ["code-generation"]));
+            const result = scheduler.schedule(makeTask("T1", "Build a new API endpoint"));
+            assert.equal(result.type, "scheduled");
+            if (result.type === "scheduled") {
+                assert.equal(result.decision.agentId, "specialist");
+            }
+        });
+    });
+    describe("concurrency limits", () => {
+        it("rejects when all capable agents are at max concurrency", () => {
+            registry.register(makeAdapter("coder", ["code-generation"], 1));
+            scheduler.acquire("coder"); // Fill the single slot
+            const result = scheduler.schedule(makeTask("T1", "Create a new module"));
+            assert.equal(result.type, "rejected");
+            if (result.type === "rejected") {
+                assert.ok(result.rejection.reason.includes("max concurrency"));
+            }
+        });
+        it("allows scheduling when concurrency slots are available", () => {
+            registry.register(makeAdapter("coder", ["code-generation"], 2));
+            scheduler.acquire("coder"); // Fill one of two slots
+            const result = scheduler.schedule(makeTask("T1", "Create a new module"));
+            assert.equal(result.type, "scheduled");
+        });
+        it("releases slots correctly", () => {
+            registry.register(makeAdapter("coder", ["code-generation"], 1));
+            scheduler.acquire("coder");
+            // Should be rejected — slot full
+            const r1 = scheduler.schedule(makeTask("T1", "Build feature"));
+            assert.equal(r1.type, "rejected");
+            scheduler.release("coder");
+            // Now should succeed
+            const r2 = scheduler.schedule(makeTask("T2", "Build another feature"));
+            assert.equal(r2.type, "scheduled");
+        });
+        it("reset clears all concurrency tracking", () => {
+            registry.register(makeAdapter("coder", ["code-generation"], 1));
+            scheduler.acquire("coder");
+            scheduler.reset();
+            const result = scheduler.schedule(makeTask("T1", "Add a new component"));
+            assert.equal(result.type, "scheduled");
+        });
+    });
+    describe("scheduleBatch", () => {
+        it("schedules tasks in dependency order", () => {
+            registry.register(makeAdapter("coder", ["code-generation", "testing"], 10));
+            const tasks = [
+                makeTask("T2", "Add tests for module", ["T1"]),
+                makeTask("T1", "Build the module"),
+            ];
+            const { scheduled, rejected, deferred } = scheduler.scheduleBatch(tasks);
+            // T1 goes first (no deps), T2 depends on T1
+            assert.equal(scheduled.length, 2);
+            assert.equal(scheduled[0].taskId, "T1");
+            assert.equal(scheduled[1].taskId, "T2");
+            assert.equal(rejected.length, 0);
+            assert.equal(deferred.length, 0);
+        });
+        it("defers tasks with unresolvable dependencies", () => {
+            registry.register(makeAdapter("coder", ["code-generation"], 10));
+            const tasks = [
+                makeTask("T1", "Build the module"),
+                makeTask("T2", "Add tests", ["T-MISSING"]), // depends on nonexistent
+            ];
+            const { scheduled, deferred } = scheduler.scheduleBatch(tasks);
+            assert.equal(scheduled.length, 1);
+            assert.equal(scheduled[0].taskId, "T1");
+            assert.equal(deferred.length, 1);
+            assert.equal(deferred[0].id, "T2");
+        });
+    });
+});
+//# sourceMappingURL=scheduler.test.js.map

package/dist/test/scheduler.test.js.map

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