@req2rank/core 0.1.0-r7

package/dist/evaluation-panel.js

@@ -0,0 +1,158 @@
+function parseJsonObject(raw) {
+    try {
+        const parsed = JSON.parse(raw);
+        if (parsed && typeof parsed === "object") {
+            return parsed;
+        }
+    }
+    catch {
+        // continue
+    }
+    const fenced = raw.match(/```json\r?\n([\s\S]*?)```/i);
+    if (!fenced) {
+        return undefined;
+    }
+    try {
+        const parsed = JSON.parse(fenced[1]);
+        if (parsed && typeof parsed === "object") {
+            return parsed;
+        }
+    }
+    catch {
+        return undefined;
+    }
+    return undefined;
+}
+function toDimensionScoreMap(raw) {
+    const parsed = parseJsonObject(raw);
+    if (!parsed) {
+        return undefined;
+    }
+    const pick = (key) => {
+        const value = parsed?.[key];
+        return typeof value === "number" ? clampScore(value) : undefined;
+    };
+    const functionalCompleteness = pick("functionalCompleteness");
+    const codeQuality = pick("codeQuality");
+    const logicAccuracy = pick("logicAccuracy");
+    const security = pick("security");
+    const engineeringPractice = pick("engineeringPractice");
+    if (functionalCompleteness === undefined ||
+        codeQuality === undefined ||
+        logicAccuracy === undefined ||
+        security === undefined ||
+        engineeringPractice === undefined) {
+        return undefined;
+    }
+    return {
+        functionalCompleteness,
+        codeQuality,
+        logicAccuracy,
+        security,
+        engineeringPractice
+    };
+}
+function clampScore(score) {
+    return Math.max(0, Math.min(100, score));
+}
+function calculateStdDev(values) {
+    if (values.length <= 1) {
+        return 0;
+    }
+    const mean = values.reduce((sum, value) => sum + value, 0) / values.length;
+    const variance = values.reduce((sum, value) => sum + (value - mean) ** 2, 0) / values.length;
+    return Math.sqrt(variance);
+}
+export function calculateIja(results) {
+    if (results.length <= 1) {
+        return 1;
+    }
+    const overallScores = results.map((result) => {
+        const values = Object.values(result.dimensions);
+        return values.reduce((sum, value) => sum + value, 0) / values.length;
+    });
+    const stdDev = calculateStdDev(overallScores);
+    const normalized = 1 - Math.min(stdDev / 25, 1);
+    return Math.round(normalized * 1000) / 1000;
+}
+export class EvaluationPanel {
+    latestDroppedJudges = [];
+    async collectEvaluations(requirement, execution, judges, providerForJudge) {
+        const settled = await Promise.allSettled(judges.map(async (judge) => {
+            const provider = providerForJudge(judge);
+            const prompt = [
+                "You are an expert software code reviewer.",
+                "Score this code against the requirement on exactly five dimensions (0-100):",
+                "functionalCompleteness, codeQuality, logicAccuracy, security, engineeringPractice.",
+                "Return strict JSON only.",
+                "",
+                `Requirement title: ${requirement.title}`,
+                `Requirement description: ${requirement.description}`,
+                "Functional requirements:",
+                ...requirement.functionalRequirements.map((item) => `- ${item.id}: ${item.description}`),
+                "Constraints:",
+                ...requirement.constraints.map((item) => `- ${item}`),
+                "Code under review:",
+                "```",
+                execution.code,
+                "```"
+            ].join("\n");
+            const response = await provider.chat({
+                model: judge.model,
+                temperature: 0,
+                maxTokens: 1_024,
+                responseFormat: "json",
+                messages: [
+                    {
+                        role: "system",
+                        content: "You are strict and objective. Output only valid JSON."
+                    },
+                    {
+                        role: "user",
+                        content: prompt
+                    }
+                ]
+            });
+            const dimensions = toDimensionScoreMap(response.content);
+            if (!dimensions) {
+                throw new Error("invalid judge response");
+            }
+            return {
+                judgeId: `${judge.provider}/${judge.model}`,
+                dimensions
+            };
+        }));
+        const results = [];
+        const droppedJudges = [];
+        for (let index = 0; index < settled.length; index += 1) {
+            const result = settled[index];
+            const judge = judges[index];
+            const judgeId = `${judge.provider}/${judge.model}`;
+            if (result.status === "fulfilled") {
+                results.push(result.value);
+            }
+            else {
+                droppedJudges.push(judgeId);
+            }
+        }
+        return { results, droppedJudges };
+    }
+    async evaluate(requirement, execution, judges, providerForJudge) {
+        const { results, droppedJudges } = await this.collectEvaluations(requirement, execution, judges, providerForJudge);
+        this.latestDroppedJudges = droppedJudges;
+        if (results.length === 0) {
+            throw new Error(`all judges failed (${droppedJudges.join(", ")})`);
+        }
+        return results;
+    }
+    async evaluateWithIja(requirement, execution, judges, providerForJudge) {
+        this.latestDroppedJudges = [];
+        const results = await this.evaluate(requirement, execution, judges, providerForJudge);
+        return {
+            results,
+            ija: calculateIja(results),
+            droppedJudges: this.latestDroppedJudges
+        };
+    }
+}
+//# sourceMappingURL=evaluation-panel.js.map

package/dist/evaluation-panel.js.map

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

package/dist/evaluation-panel.test.d.ts

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

package/dist/evaluation-panel.test.d.ts.map

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

package/dist/evaluation-panel.test.js

@@ -0,0 +1,185 @@
+import { describe, expect, it } from "vitest";
+import { calculateIja, EvaluationPanel } from "./evaluation-panel.js";
+class StubJudgeProvider {
+    id = "stub-judge";
+    name = "Stub Judge";
+    async chat() {
+        return {
+            content: JSON.stringify({
+                functionalCompleteness: 84,
+                codeQuality: 79,
+                logicAccuracy: 86,
+                security: 75,
+                engineeringPractice: 80
+            }),
+            usage: { promptTokens: 10, completionTokens: 12 },
+            latencyMs: 15
+        };
+    }
+}
+class StubFencedJudgeProvider {
+    id = "stub-judge-fenced";
+    name = "Stub Judge Fenced";
+    async chat() {
+        return {
+            content: "```json\r\n{\"functionalCompleteness\":84,\"codeQuality\":79,\"logicAccuracy\":86,\"security\":75,\"engineeringPractice\":80}\r\n```",
+            usage: { promptTokens: 10, completionTokens: 12 },
+            latencyMs: 15
+        };
+    }
+}
+class ThrowingJudgeProvider {
+    id = "throw-judge";
+    name = "Throw Judge";
+    async chat() {
+        throw new Error("judge unavailable");
+    }
+}
+function makeRequirement() {
+    return {
+        id: "req-1",
+        version: "1.0",
+        title: "Demo",
+        description: "Do demo",
+        functionalRequirements: [
+            {
+                id: "FR-1",
+                description: "Implement feature",
+                acceptanceCriteria: "Feature works",
+                priority: "must"
+            }
+        ],
+        constraints: [],
+        expectedDeliverables: ["source code"],
+        metadata: {
+            skills: ["api-design"],
+            complexity: "C2",
+            domain: "generic",
+            scenario: "demo",
+            techStack: ["typescript"],
+            mutationLog: []
+        },
+        evaluationGuidance: {
+            keyDifferentiators: ["clean structure"],
+            commonPitfalls: ["missing validation"],
+            edgeCases: ["empty input"]
+        },
+        generatedBy: "test",
+        generatedAt: new Date().toISOString(),
+        selfReviewPassed: true
+    };
+}
+describe("calculateIja", () => {
+    it("returns high agreement when judges are close", () => {
+        const ija = calculateIja([
+            {
+                judgeId: "j1",
+                dimensions: {
+                    functionalCompleteness: 80,
+                    codeQuality: 79,
+                    logicAccuracy: 81,
+                    security: 78,
+                    engineeringPractice: 80
+                }
+            },
+            {
+                judgeId: "j2",
+                dimensions: {
+                    functionalCompleteness: 81,
+                    codeQuality: 80,
+                    logicAccuracy: 82,
+                    security: 79,
+                    engineeringPractice: 81
+                }
+            }
+        ]);
+        expect(ija).toBeGreaterThan(0.9);
+    });
+    it("returns low agreement when judges diverge strongly", () => {
+        const ija = calculateIja([
+            {
+                judgeId: "j1",
+                dimensions: {
+                    functionalCompleteness: 20,
+                    codeQuality: 20,
+                    logicAccuracy: 20,
+                    security: 20,
+                    engineeringPractice: 20
+                }
+            },
+            {
+                judgeId: "j2",
+                dimensions: {
+                    functionalCompleteness: 95,
+                    codeQuality: 95,
+                    logicAccuracy: 95,
+                    security: 95,
+                    engineeringPractice: 95
+                }
+            }
+        ]);
+        expect(ija).toBe(0);
+    });
+    it("evaluates through judge providers and parses structured scores", async () => {
+        const panel = new EvaluationPanel();
+        const requirement = makeRequirement();
+        const execution = {
+            code: "export const answer = 42;",
+            language: "typescript",
+            timeoutMs: 60_000,
+            maxTokens: 8_192
+        };
+        const judges = [{ provider: "openai", model: "gpt-4o", weight: 1 }];
+        const provider = new StubJudgeProvider();
+        const results = await panel.evaluate(requirement, execution, judges, () => provider);
+        expect(results).toHaveLength(1);
+        expect(results[0].dimensions.logicAccuracy).toBe(86);
+        expect(results[0].judgeId).toBe("openai/gpt-4o");
+    });
+    it("tolerates failed judges when at least one judge succeeds", async () => {
+        const panel = new EvaluationPanel();
+        const requirement = makeRequirement();
+        const execution = {
+            code: "export const answer = 42;",
+            language: "typescript",
+            timeoutMs: 60_000,
+            maxTokens: 8_192
+        };
+        const judges = [
+            { provider: "openai", model: "gpt-4o", weight: 1 },
+            { provider: "openai", model: "gpt-4o-mini", weight: 1 }
+        ];
+        const stable = new StubJudgeProvider();
+        const flaky = new ThrowingJudgeProvider();
+        const output = await panel.evaluateWithIja(requirement, execution, judges, (judge) => judge.model === "gpt-4o" ? stable : flaky);
+        expect(output.results).toHaveLength(1);
+        expect(output.droppedJudges).toContain("openai/gpt-4o-mini");
+    });
+    it("parses fenced JSON scores with CRLF newlines", async () => {
+        const panel = new EvaluationPanel();
+        const requirement = makeRequirement();
+        const execution = {
+            code: "export const answer = 42;",
+            language: "typescript",
+            timeoutMs: 60_000,
+            maxTokens: 8_192
+        };
+        const judges = [{ provider: "openai", model: "gpt-4o", weight: 1 }];
+        const results = await panel.evaluate(requirement, execution, judges, () => new StubFencedJudgeProvider());
+        expect(results).toHaveLength(1);
+        expect(results[0].dimensions.security).toBe(75);
+    });
+    it("throws when all judges fail", async () => {
+        const panel = new EvaluationPanel();
+        const requirement = makeRequirement();
+        const execution = {
+            code: "export const answer = 42;",
+            language: "typescript",
+            timeoutMs: 60_000,
+            maxTokens: 8_192
+        };
+        const judges = [{ provider: "openai", model: "gpt-4o", weight: 1 }];
+        await expect(panel.evaluateWithIja(requirement, execution, judges, () => new ThrowingJudgeProvider())).rejects.toThrow("all judges failed");
+    });
+});
+//# sourceMappingURL=evaluation-panel.test.js.map

package/dist/evaluation-panel.test.js.map

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

package/dist/evidence-chain.d.ts

@@ -0,0 +1,11 @@
+import { EvidenceChain } from "./submitter-types.js";
+export interface CreateEvidenceChainInput {
+    requirement?: string;
+    codeSubmission?: string;
+    judgeModels?: string[];
+    timeline?: EvidenceChain["timeline"];
+    samples?: EvidenceChain["samples"];
+    now?: Date;
+}
+export declare function createEvidenceChain(input: CreateEvidenceChainInput): EvidenceChain;
+//# sourceMappingURL=evidence-chain.d.ts.map

package/dist/evidence-chain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evidence-chain.d.ts","sourceRoot":"","sources":["../src/evidence-chain.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD,MAAM,WAAW,wBAAwB;IACvC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,QAAQ,CAAC,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC;IACrC,OAAO,CAAC,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC;IACnC,GAAG,CAAC,EAAE,IAAI,CAAC;CACZ;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,wBAAwB,GAAG,aAAa,CAmClF"}

package/dist/evidence-chain.js

@@ -0,0 +1,33 @@
+import { platform } from "node:os";
+export function createEvidenceChain(input) {
+    const now = input.now ?? new Date();
+    const startedAt = new Date(now.getTime() - 1_500).toISOString();
+    const completedAt = now.toISOString();
+    const timeline = input.timeline && input.timeline.length > 0
+        ? input.timeline
+        : [
+            { phase: "generate", startedAt, completedAt, model: "system-generator" },
+            { phase: "execute", startedAt, completedAt, model: "target-model" },
+            { phase: "evaluate", startedAt, completedAt, model: (input.judgeModels ?? []).join(",") || "judge-model" },
+            { phase: "score", startedAt, completedAt, model: "scoring-engine" }
+        ];
+    const samples = input.samples && input.samples.length > 0
+        ? input.samples
+        : [
+            {
+                roundIndex: 0,
+                requirement: input.requirement ?? "requirement-unavailable",
+                codeSubmission: input.codeSubmission ?? "code-unavailable"
+            }
+        ];
+    return {
+        timeline,
+        samples,
+        environment: {
+            os: platform(),
+            nodeVersion: process.version,
+            timezone: Intl.DateTimeFormat().resolvedOptions().timeZone
+        }
+    };
+}
+//# sourceMappingURL=evidence-chain.js.map

package/dist/evidence-chain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"evidence-chain.js","sourceRoot":"","sources":["../src/evidence-chain.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAYnC,MAAM,UAAU,mBAAmB,CAAC,KAA+B;IACjE,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,IAAI,IAAI,IAAI,EAAE,CAAC;IACpC,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;IAChE,MAAM,WAAW,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC;IAEtC,MAAM,QAAQ,GACZ,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC;QACzC,CAAC,CAAC,KAAK,CAAC,QAAQ;QAChB,CAAC,CAAC;YACE,EAAE,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,WAAW,EAAE,KAAK,EAAE,kBAAkB,EAAE;YACxE,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,KAAK,EAAE,cAAc,EAAE;YACnE,EAAE,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC,KAAK,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,aAAa,EAAE;YAC1G,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,KAAK,EAAE,gBAAgB,EAAE;SACpE,CAAC;IAER,MAAM,OAAO,GACX,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC;QACvC,CAAC,CAAC,KAAK,CAAC,OAAO;QACf,CAAC,CAAC;YACE;gBACE,UAAU,EAAE,CAAC;gBACb,WAAW,EAAE,KAAK,CAAC,WAAW,IAAI,yBAAyB;gBAC3D,cAAc,EAAE,KAAK,CAAC,cAAc,IAAI,kBAAkB;aAC3D;SACF,CAAC;IAER,OAAO;QACL,QAAQ;QACR,OAAO;QACP,WAAW,EAAE;YACX,EAAE,EAAE,QAAQ,EAAE;YACd,WAAW,EAAE,OAAO,CAAC,OAAO;YAC5B,QAAQ,EAAE,IAAI,CAAC,cAAc,EAAE,CAAC,eAAe,EAAE,CAAC,QAAQ;SAC3D;KACF,CAAC;AACJ,CAAC"}

package/dist/evidence-chain.test.d.ts

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

package/dist/evidence-chain.test.d.ts.map

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

package/dist/evidence-chain.test.js

@@ -0,0 +1,16 @@
+import { describe, expect, it } from "vitest";
+import { createEvidenceChain } from "./evidence-chain.js";
+describe("createEvidenceChain", () => {
+    it("builds timeline samples and environment fields", () => {
+        const chain = createEvidenceChain({
+            requirement: "Build API",
+            codeSubmission: "export const ok = true;",
+            judgeModels: ["openai/gpt-4o"],
+            now: new Date("2026-01-01T00:00:00.000Z")
+        });
+        expect(chain.timeline).toHaveLength(4);
+        expect(chain.samples).toHaveLength(1);
+        expect(chain.environment.os.length).toBeGreaterThan(0);
+    });
+});
+//# sourceMappingURL=evidence-chain.test.js.map

package/dist/evidence-chain.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"evidence-chain.test.js","sourceRoot":"","sources":["../src/evidence-chain.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE1D,QAAQ,CAAC,qBAAqB,EAAE,GAAG,EAAE;IACnC,EAAE,CAAC,gDAAgD,EAAE,GAAG,EAAE;QACxD,MAAM,KAAK,GAAG,mBAAmB,CAAC;YAChC,WAAW,EAAE,WAAW;YACxB,cAAc,EAAE,yBAAyB;YACzC,WAAW,EAAE,CAAC,eAAe,CAAC;YAC9B,GAAG,EAAE,IAAI,IAAI,CAAC,0BAA0B,CAAC;SAC1C,CAAC,CAAC;QAEH,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QACvC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QACtC,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;IACzD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/execution-engine.d.ts

@@ -0,0 +1,29 @@
+import { ProjectRequirement } from "./types.js";
+import { LLMProvider } from "./providers/base.js";
+export interface ExecutionResult {
+    code: string;
+    language: string;
+    timeoutMs: number;
+    maxTokens: number;
+}
+export interface ExecutionTarget {
+    provider: string;
+    model: string;
+}
+export interface ExecutionBudget {
+    timeoutMs: number;
+    maxTokens: number;
+}
+export interface ExecuteOptions {
+    rawResponse?: string;
+    provider?: LLMProvider;
+}
+export declare function parseExecutionResponse(rawResponse: string): {
+    code: string;
+    language: string;
+};
+export declare function resolveExecutionBudget(complexity: ProjectRequirement["metadata"]["complexity"]): ExecutionBudget;
+export declare class ExecutionEngine {
+    execute(requirement: ProjectRequirement, target: ExecutionTarget, options?: ExecuteOptions): Promise<ExecutionResult>;
+}
+//# sourceMappingURL=execution-engine.d.ts.map

package/dist/execution-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-engine.d.ts","sourceRoot":"","sources":["../src/execution-engine.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAElD,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,WAAW,CAAC;CACxB;AAmCD,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAoB9F;AAED,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,kBAAkB,CAAC,UAAU,CAAC,CAAC,YAAY,CAAC,GAAG,eAAe,CAEhH;AAED,qBAAa,eAAe;IACpB,OAAO,CAAC,WAAW,EAAE,kBAAkB,EAAE,MAAM,EAAE,eAAe,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,eAAe,CAAC;CAuDhI"}

package/dist/execution-engine.js

@@ -0,0 +1,102 @@
+const EXECUTION_BUDGETS = {
+    C1: { timeoutMs: 30_000, maxTokens: 4_096 },
+    C2: { timeoutMs: 60_000, maxTokens: 8_192 },
+    C3: { timeoutMs: 120_000, maxTokens: 16_384 },
+    C4: { timeoutMs: 180_000, maxTokens: 32_768 }
+};
+function extractFromJson(value) {
+    if (!value || typeof value !== "object") {
+        return undefined;
+    }
+    const record = value;
+    if (typeof record.code === "string") {
+        return {
+            code: record.code,
+            language: typeof record.language === "string" ? record.language : "typescript"
+        };
+    }
+    if (Array.isArray(record.files)) {
+        const firstFile = record.files[0];
+        if (firstFile && typeof firstFile.content === "string") {
+            return {
+                code: firstFile.content,
+                language: typeof firstFile.language === "string" ? firstFile.language : "typescript"
+            };
+        }
+    }
+    return undefined;
+}
+export function parseExecutionResponse(rawResponse) {
+    try {
+        const parsed = JSON.parse(rawResponse);
+        const fromJson = extractFromJson(parsed);
+        if (fromJson) {
+            return fromJson;
+        }
+    }
+    catch {
+        // fall through to code-block extraction
+    }
+    const match = rawResponse.match(/```([a-zA-Z0-9_-]+)?\r?\n([\s\S]*?)```/);
+    if (match) {
+        return {
+            language: match[1] ?? "text",
+            code: match[2].trim()
+        };
+    }
+    throw new Error("Unable to parse execution response");
+}
+export function resolveExecutionBudget(complexity) {
+    return EXECUTION_BUDGETS[complexity];
+}
+export class ExecutionEngine {
+    async execute(requirement, target, options = {}) {
+        const budget = resolveExecutionBudget(requirement.metadata.complexity);
+        let rawResponse = options.rawResponse;
+        if (!rawResponse) {
+            if (!options.provider) {
+                throw new Error("Execution provider is required when rawResponse is not provided.");
+            }
+            const executionPrompt = [
+                "You are implementing code for a software requirement.",
+                "Return code as JSON `{\"language\":\"...\",\"code\":\"...\"}`.",
+                "If JSON is not possible, return a single fenced code block.",
+                "",
+                `Target provider: ${target.provider}`,
+                `Target model: ${target.model}`,
+                `Requirement title: ${requirement.title}`,
+                `Requirement description: ${requirement.description}`,
+                "Functional requirements:",
+                ...requirement.functionalRequirements.map((item) => `- ${item.id}: ${item.description} | acceptance: ${item.acceptanceCriteria}`),
+                "Constraints:",
+                ...requirement.constraints.map((item) => `- ${item}`),
+                "Expected deliverables:",
+                ...requirement.expectedDeliverables.map((item) => `- ${item}`)
+            ].join("\n");
+            const response = await options.provider.chat({
+                model: target.model,
+                temperature: 0.2,
+                maxTokens: budget.maxTokens,
+                messages: [
+                    {
+                        role: "system",
+                        content: "You generate production-ready code that strictly follows requirements."
+                    },
+                    {
+                        role: "user",
+                        content: executionPrompt
+                    }
+                ]
+            });
+            rawResponse = response.content;
+        }
+        const parsed = parseExecutionResponse(rawResponse);
+        return {
+            code: parsed.code,
+            language: parsed.language,
+            timeoutMs: budget.timeoutMs,
+            maxTokens: budget.maxTokens
+        };
+    }
+}
+//# sourceMappingURL=execution-engine.js.map

package/dist/execution-engine.js.map

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

package/dist/execution-engine.test.d.ts

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

package/dist/execution-engine.test.d.ts.map

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