@req2rank/core 0.1.0-r7

package/dist/execution-engine.test.js

@@ -0,0 +1,86 @@
+import { describe, expect, it } from "vitest";
+import { ExecutionEngine, parseExecutionResponse, resolveExecutionBudget } from "./execution-engine.js";
+class StubProvider {
+    id = "stub";
+    name = "Stub";
+    callCount = 0;
+    async chat() {
+        this.callCount += 1;
+        return {
+            content: "```ts\nexport const run = () => 'ok';\n```",
+            usage: { promptTokens: 10, completionTokens: 20 },
+            latencyMs: 12
+        };
+    }
+}
+function makeRequirement(complexity) {
+    return {
+        id: "req-1",
+        version: "1.0",
+        title: "Demo requirement",
+        description: "demo",
+        functionalRequirements: [
+            {
+                id: "FR-1",
+                description: "Do work",
+                acceptanceCriteria: "Works",
+                priority: "must"
+            }
+        ],
+        constraints: [],
+        expectedDeliverables: ["source code"],
+        metadata: {
+            skills: ["api-design"],
+            complexity,
+            domain: "generic",
+            scenario: "demo",
+            techStack: ["typescript"],
+            mutationLog: []
+        },
+        evaluationGuidance: {
+            keyDifferentiators: [],
+            commonPitfalls: [],
+            edgeCases: []
+        },
+        generatedBy: "test",
+        generatedAt: new Date().toISOString(),
+        selfReviewPassed: true
+    };
+}
+describe("ExecutionEngine", () => {
+    it("maps C1-C4 complexity to timeout and token budgets", () => {
+        expect(resolveExecutionBudget("C1")).toEqual({ timeoutMs: 30_000, maxTokens: 4_096 });
+        expect(resolveExecutionBudget("C2")).toEqual({ timeoutMs: 60_000, maxTokens: 8_192 });
+        expect(resolveExecutionBudget("C3")).toEqual({ timeoutMs: 120_000, maxTokens: 16_384 });
+        expect(resolveExecutionBudget("C4")).toEqual({ timeoutMs: 180_000, maxTokens: 32_768 });
+    });
+    it("falls back to fenced-code parsing when JSON parsing fails", () => {
+        const parsed = parseExecutionResponse("```ts\nexport const answer = 42;\n```");
+        expect(parsed.language).toBe("ts");
+        expect(parsed.code).toContain("answer = 42");
+    });
+    it("parses fenced-code blocks with CRLF newlines", () => {
+        const parsed = parseExecutionResponse("```ts\r\nexport const answer = 42;\r\n```");
+        expect(parsed.language).toBe("ts");
+        expect(parsed.code).toContain("answer = 42");
+    });
+    it("uses requirement complexity budget during execute", async () => {
+        const provider = new StubProvider();
+        const engine = new ExecutionEngine();
+        const requirement = makeRequirement("C4");
+        const result = await engine.execute(requirement, { provider: "openai", model: "gpt-4o-mini" }, { provider });
+        expect(result.timeoutMs).toBe(180_000);
+        expect(result.maxTokens).toBe(32_768);
+        expect(result.code).toContain("run = () => 'ok'");
+        expect(provider.callCount).toBe(1);
+    });
+    it("still allows deterministic raw response override", async () => {
+        const provider = new StubProvider();
+        const engine = new ExecutionEngine();
+        const requirement = makeRequirement("C2");
+        const result = await engine.execute(requirement, { provider: "openai", model: "gpt-4o-mini" }, { provider, rawResponse: "```ts\nexport const answer = 42;\n```" });
+        expect(result.code).toContain("answer = 42");
+        expect(provider.callCount).toBe(0);
+    });
+});
+//# sourceMappingURL=execution-engine.test.js.map

package/dist/execution-engine.test.js.map

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

package/dist/hub-client.d.ts

@@ -0,0 +1,21 @@
+import { LeaderboardEntry, LeaderboardQuery, NonceResponse, SubmissionRequest, SubmissionResponse } from "./submitter-types.js";
+export interface HubClient {
+    requestNonce(): Promise<NonceResponse>;
+    submit(payload: SubmissionRequest): Promise<SubmissionResponse>;
+    getLeaderboard(query: LeaderboardQuery): Promise<LeaderboardEntry[]>;
+    submitCalibration(payload: {
+        recommendedComplexity: "C1" | "C2" | "C3" | "C4";
+        reason: string;
+        averageScore: number;
+        sampleSize: number;
+        source?: string;
+    }): Promise<{
+        ok: boolean;
+    }>;
+}
+export interface HubClientOptions {
+    serverUrl?: string;
+    token?: string;
+}
+export declare function createHubClient(options?: HubClientOptions): HubClient;
+//# sourceMappingURL=hub-client.d.ts.map

package/dist/hub-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hub-client.d.ts","sourceRoot":"","sources":["../src/hub-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,aAAa,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAGhI,MAAM,WAAW,SAAS;IACxB,YAAY,IAAI,OAAO,CAAC,aAAa,CAAC,CAAC;IACvC,MAAM,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAChE,cAAc,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAC;IACrE,iBAAiB,CAAC,OAAO,EAAE;QACzB,qBAAqB,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;QACjD,MAAM,EAAE,MAAM,CAAC;QACf,YAAY,EAAE,MAAM,CAAC;QACrB,UAAU,EAAE,MAAM,CAAC;QACnB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;CAC9B;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAkHD,wBAAgB,eAAe,CAAC,OAAO,GAAE,gBAAqB,GAAG,SAAS,CASzE"}

package/dist/hub-client.js

@@ -0,0 +1,99 @@
+import { parseLeaderboardQuery } from "./leaderboard-query.js";
+class PlaceholderHubClient {
+    async requestNonce() {
+        return {
+            nonce: "placeholder-nonce",
+            expiresAt: new Date(Date.now() + 2 * 60 * 60 * 1000).toISOString()
+        };
+    }
+    async submit(payload) {
+        return {
+            status: "pending",
+            message: `Submit pending for ${payload.runId}`
+        };
+    }
+    async getLeaderboard(query) {
+        const normalizedQuery = parseLeaderboardQuery(query);
+        const { limit, offset, sort } = normalizedQuery;
+        const base = Array.from({ length: 5 }).map((_, index) => ({
+            rank: index + 1,
+            model: `placeholder/model-${index + 1}`,
+            score: 95 - index
+        }));
+        const ordered = sort === "asc" ? base.slice().reverse() : base;
+        return ordered.slice(offset, offset + limit).map((entry, index) => ({
+            ...entry,
+            rank: offset + index + 1
+        }));
+    }
+    async submitCalibration() {
+        return { ok: false };
+    }
+}
+class HttpHubClient {
+    baseUrl;
+    token;
+    constructor(serverUrl, token) {
+        this.baseUrl = serverUrl.replace(/\/+$/, "");
+        this.token = token;
+    }
+    headers() {
+        return {
+            "content-type": "application/json",
+            Authorization: `Bearer ${this.token}`
+        };
+    }
+    async requestJson(path, init) {
+        const response = await fetch(`${this.baseUrl}${path}`, {
+            ...init,
+            headers: {
+                ...this.headers(),
+                ...init?.headers
+            }
+        });
+        if (!response.ok) {
+            throw new Error(`Hub request failed: ${response.status}`);
+        }
+        return (await response.json());
+    }
+    async requestNonce() {
+        return this.requestJson("/api/nonces", {
+            method: "POST",
+            body: JSON.stringify({})
+        });
+    }
+    async submit(payload) {
+        return this.requestJson("/api/submissions", {
+            method: "POST",
+            body: JSON.stringify(payload)
+        });
+    }
+    async getLeaderboard(query) {
+        const normalizedQuery = parseLeaderboardQuery(query);
+        const complexitySegment = encodeURIComponent(normalizedQuery.complexity ?? "all");
+        const dimensionSegment = normalizedQuery.dimension ? `/${encodeURIComponent(normalizedQuery.dimension)}` : "";
+        const params = new URLSearchParams({
+            limit: String(normalizedQuery.limit),
+            offset: String(normalizedQuery.offset),
+            sort: normalizedQuery.sort
+        });
+        return this.requestJson(`/api/leaderboard/${complexitySegment}${dimensionSegment}?${params.toString()}`, {
+            method: "GET"
+        });
+    }
+    async submitCalibration(payload) {
+        return this.requestJson("/api/calibration", {
+            method: "POST",
+            body: JSON.stringify(payload)
+        });
+    }
+}
+export function createHubClient(options = {}) {
+    const serverUrl = options.serverUrl ?? process.env.R2R_HUB_SERVER_URL;
+    const token = options.token ?? process.env.R2R_HUB_TOKEN;
+    if (serverUrl && token) {
+        return new HttpHubClient(serverUrl, token);
+    }
+    return new PlaceholderHubClient();
+}
+//# sourceMappingURL=hub-client.js.map

package/dist/hub-client.js.map

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

package/dist/hub-client.test.d.ts

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

package/dist/hub-client.test.d.ts.map

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

package/dist/hub-client.test.js

@@ -0,0 +1,129 @@
+import { afterEach, describe, expect, it, vi } from "vitest";
+import { createHubClient } from "./hub-client.js";
+describe("HubClient placeholder", () => {
+    afterEach(() => {
+        vi.unstubAllGlobals();
+    });
+    it("returns nonce response", async () => {
+        const client = createHubClient();
+        const nonce = await client.requestNonce();
+        expect(nonce.nonce.length).toBeGreaterThan(0);
+        expect(nonce.expiresAt).toContain("T");
+    });
+    it("returns pending submit response", async () => {
+        const client = createHubClient();
+        const response = await client.submit({
+            runId: "run-1",
+            nonce: "nonce-1",
+            targetProvider: "openai",
+            targetModel: "gpt-4o-mini",
+            overallScore: 80,
+            submittedAt: new Date("2026-01-01T00:00:00.000Z").toISOString(),
+            evidenceChain: {
+                timeline: [
+                    {
+                        phase: "generate",
+                        startedAt: "2026-01-01T00:00:00.000Z",
+                        completedAt: "2026-01-01T00:00:01.000Z",
+                        model: "system"
+                    }
+                ],
+                samples: [
+                    {
+                        roundIndex: 0,
+                        requirement: "demo",
+                        codeSubmission: "export const ok = true;"
+                    }
+                ],
+                environment: {
+                    os: "win32",
+                    nodeVersion: "v22",
+                    timezone: "UTC"
+                }
+            }
+        });
+        expect(response.status).toBe("pending");
+        expect(response.message).toContain("run-1");
+    });
+    it("returns leaderboard placeholder entries", async () => {
+        const client = createHubClient();
+        const entries = await client.getLeaderboard({
+            limit: 2,
+            offset: 1,
+            sort: "asc"
+        });
+        expect(entries).toHaveLength(2);
+        expect(entries[0].score).toBeLessThanOrEqual(entries[1].score);
+    });
+    it("uses HTTP hub API when serverUrl and token are provided", async () => {
+        const fetchMock = vi.fn(async (input, init) => {
+            if (input.endsWith("/api/nonces")) {
+                expect(init?.headers).toMatchObject({
+                    Authorization: "Bearer token-1"
+                });
+                return new Response(JSON.stringify({ nonce: "nonce-http", expiresAt: "2026-01-01T00:00:00.000Z" }), {
+                    status: 200,
+                    headers: { "content-type": "application/json" }
+                });
+            }
+            if (input.endsWith("/api/submissions")) {
+                return new Response(JSON.stringify({ status: "accepted", message: "submitted" }), {
+                    status: 200,
+                    headers: { "content-type": "application/json" }
+                });
+            }
+            if (input.includes("/api/leaderboard/")) {
+                return new Response(JSON.stringify([{ rank: 1, model: "openai/gpt-4o-mini", score: 92 }]), {
+                    status: 200,
+                    headers: { "content-type": "application/json" }
+                });
+            }
+            if (input.endsWith("/api/calibration")) {
+                return new Response(JSON.stringify({ ok: true }), {
+                    status: 200,
+                    headers: { "content-type": "application/json" }
+                });
+            }
+            return new Response("not found", { status: 404 });
+        });
+        vi.stubGlobal("fetch", fetchMock);
+        const client = createHubClient({
+            serverUrl: "https://hub.example.com",
+            token: "token-1"
+        });
+        const nonce = await client.requestNonce();
+        expect(nonce.nonce).toBe("nonce-http");
+        const submit = await client.submit({
+            runId: "run-2",
+            nonce: "nonce-http",
+            targetProvider: "openai",
+            targetModel: "gpt-4o-mini",
+            overallScore: 90,
+            submittedAt: new Date("2026-01-01T00:00:00.000Z").toISOString(),
+            evidenceChain: {
+                timeline: [
+                    {
+                        phase: "generate",
+                        startedAt: "2026-01-01T00:00:00.000Z",
+                        completedAt: "2026-01-01T00:00:01.000Z",
+                        model: "system"
+                    }
+                ],
+                samples: [{ roundIndex: 0, requirement: "demo", codeSubmission: "ok" }],
+                environment: { os: "win32", nodeVersion: "v22", timezone: "UTC" }
+            }
+        });
+        expect(submit.status).toBe("accepted");
+        const leaderboard = await client.getLeaderboard({ limit: 10, offset: 0, sort: "desc" });
+        expect(leaderboard[0]?.model).toBe("openai/gpt-4o-mini");
+        const calibration = await client.submitCalibration({
+            recommendedComplexity: "C2",
+            reason: "stable",
+            averageScore: 80,
+            sampleSize: 5,
+            source: "cli"
+        });
+        expect(calibration.ok).toBe(true);
+    });
+});
+//# sourceMappingURL=hub-client.test.js.map

package/dist/hub-client.test.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,19 @@
+export * from "./types.js";
+export * from "./providers/index.js";
+export * from "./requirement-generator.js";
+export * from "./config.js";
+export * from "./local-store.js";
+export * from "./pipeline.js";
+export * from "./execution-engine.js";
+export * from "./evaluation-panel.js";
+export * from "./scoring-engine.js";
+export * from "./submitter-types.js";
+export * from "./hub-client.js";
+export * from "./evidence-chain.js";
+export * from "./submit-payload-builder.js";
+export * from "./leaderboard-query.js";
+export * from "./adaptive-calibration.js";
+export * from "./sandbox.js";
+export * from "./checkpoint-key.js";
+export * from "./domain-taxonomy.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,sBAAsB,CAAC;AACrC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AACpC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,wBAAwB,CAAC;AACvC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,cAAc,CAAC;AAC7B,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC"}

package/dist/index.js

@@ -0,0 +1,19 @@
+export * from "./types.js";
+export * from "./providers/index.js";
+export * from "./requirement-generator.js";
+export * from "./config.js";
+export * from "./local-store.js";
+export * from "./pipeline.js";
+export * from "./execution-engine.js";
+export * from "./evaluation-panel.js";
+export * from "./scoring-engine.js";
+export * from "./submitter-types.js";
+export * from "./hub-client.js";
+export * from "./evidence-chain.js";
+export * from "./submit-payload-builder.js";
+export * from "./leaderboard-query.js";
+export * from "./adaptive-calibration.js";
+export * from "./sandbox.js";
+export * from "./checkpoint-key.js";
+export * from "./domain-taxonomy.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,sBAAsB,CAAC;AACrC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AACpC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,wBAAwB,CAAC;AACvC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,cAAc,CAAC;AAC7B,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC"}

package/dist/leaderboard-query.d.ts

@@ -0,0 +1,29 @@
+import { z } from "zod";
+import { LeaderboardQuery } from "./submitter-types.js";
+export declare const leaderboardQuerySchema: z.ZodObject<{
+    limit: z.ZodNumber;
+    offset: z.ZodNumber;
+    sort: z.ZodEnum<["asc", "desc"]>;
+    complexity: z.ZodOptional<z.ZodEnum<["C1", "C2", "C3", "C4", "mixed"]>>;
+    dimension: z.ZodOptional<z.ZodEnum<["functionalCompleteness", "codeQuality", "logicAccuracy", "security", "engineeringPractice"]>>;
+}, "strip", z.ZodTypeAny, {
+    sort: "asc" | "desc";
+    limit: number;
+    offset: number;
+    complexity?: "C1" | "C2" | "C3" | "C4" | "mixed" | undefined;
+    dimension?: "functionalCompleteness" | "codeQuality" | "logicAccuracy" | "security" | "engineeringPractice" | undefined;
+}, {
+    sort: "asc" | "desc";
+    limit: number;
+    offset: number;
+    complexity?: "C1" | "C2" | "C3" | "C4" | "mixed" | undefined;
+    dimension?: "functionalCompleteness" | "codeQuality" | "logicAccuracy" | "security" | "engineeringPractice" | undefined;
+}>;
+export type LeaderboardQueryNormalized = z.infer<typeof leaderboardQuerySchema>;
+export interface LeaderboardQueryFieldLabels {
+    limit: string;
+    offset: string;
+    sort: string;
+}
+export declare function parseLeaderboardQuery(input: LeaderboardQuery, labels?: LeaderboardQueryFieldLabels): LeaderboardQueryNormalized;
+//# sourceMappingURL=leaderboard-query.d.ts.map

package/dist/leaderboard-query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"leaderboard-query.d.ts","sourceRoot":"","sources":["../src/leaderboard-query.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAExD,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;EAQjC,CAAC;AAEH,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEhF,MAAM,WAAW,2BAA2B;IAC1C,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AA+BD,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,gBAAgB,EACvB,MAAM,GAAE,2BAA4C,GACnD,0BAA0B,CAkC5B"}

package/dist/leaderboard-query.js

@@ -0,0 +1,59 @@
+import { z } from "zod";
+export const leaderboardQuerySchema = z.object({
+    limit: z.number().int().positive(),
+    offset: z.number().int().nonnegative(),
+    sort: z.enum(["asc", "desc"]),
+    complexity: z.enum(["C1", "C2", "C3", "C4", "mixed"]).optional(),
+    dimension: z
+        .enum(["functionalCompleteness", "codeQuality", "logicAccuracy", "security", "engineeringPractice"])
+        .optional()
+});
+const DEFAULT_LABELS = {
+    limit: "limit",
+    offset: "offset",
+    sort: "sort"
+};
+function parseIntegerField(value, defaultValue, label) {
+    if (value === undefined) {
+        return defaultValue;
+    }
+    if (typeof value === "number") {
+        if (!Number.isInteger(value)) {
+            throw new Error(`Invalid ${label} value: ${value}`);
+        }
+        return value;
+    }
+    if (!/^-?\d+$/.test(value)) {
+        throw new Error(`Invalid ${label} value: ${value}`);
+    }
+    return Number.parseInt(value, 10);
+}
+export function parseLeaderboardQuery(input, labels = DEFAULT_LABELS) {
+    const limit = parseIntegerField(input.limit, 10, labels.limit);
+    const offset = parseIntegerField(input.offset, 0, labels.offset);
+    const sort = input.sort ?? "desc";
+    const complexity = input.complexity;
+    const dimension = input.dimension;
+    if (limit <= 0) {
+        throw new Error(`${labels.limit} must be a positive integer`);
+    }
+    if (offset < 0) {
+        throw new Error(`${labels.offset} must be a non-negative integer`);
+    }
+    if (sort !== "asc" && sort !== "desc") {
+        throw new Error(`Invalid ${labels.sort} value: ${sort}`);
+    }
+    if (complexity !== undefined && complexity !== "C1" && complexity !== "C2" && complexity !== "C3" && complexity !== "C4" && complexity !== "mixed") {
+        throw new Error(`Invalid complexity value: ${complexity}`);
+    }
+    if (dimension !== undefined &&
+        dimension !== "functionalCompleteness" &&
+        dimension !== "codeQuality" &&
+        dimension !== "logicAccuracy" &&
+        dimension !== "security" &&
+        dimension !== "engineeringPractice") {
+        throw new Error(`Invalid dimension value: ${dimension}`);
+    }
+    return leaderboardQuerySchema.parse({ limit, offset, sort, complexity, dimension });
+}
+//# sourceMappingURL=leaderboard-query.js.map

package/dist/leaderboard-query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"leaderboard-query.js","sourceRoot":"","sources":["../src/leaderboard-query.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IAClC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IACtC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAC7B,UAAU,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,QAAQ,EAAE;IAChE,SAAS,EAAE,CAAC;SACT,IAAI,CAAC,CAAC,wBAAwB,EAAE,aAAa,EAAE,eAAe,EAAE,UAAU,EAAE,qBAAqB,CAAC,CAAC;SACnG,QAAQ,EAAE;CACd,CAAC,CAAC;AAUH,MAAM,cAAc,GAAgC;IAClD,KAAK,EAAE,OAAO;IACd,MAAM,EAAE,QAAQ;IAChB,IAAI,EAAE,MAAM;CACb,CAAC;AAEF,SAAS,iBAAiB,CACxB,KAAkC,EAClC,YAAoB,EACpB,KAAa;IAEb,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,OAAO,YAAY,CAAC;IACtB,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CAAC,WAAW,KAAK,WAAW,KAAK,EAAE,CAAC,CAAC;QACtD,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CAAC,WAAW,KAAK,WAAW,KAAK,EAAE,CAAC,CAAC;IACtD,CAAC;IAED,OAAO,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,KAAuB,EACvB,SAAsC,cAAc;IAEpD,MAAM,KAAK,GAAG,iBAAiB,CAAC,KAAK,CAAC,KAAK,EAAE,EAAE,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;IAC/D,MAAM,MAAM,GAAG,iBAAiB,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;IACjE,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,IAAI,MAAM,CAAC;IAClC,MAAM,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC;IACpC,MAAM,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC;IAElC,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,GAAG,MAAM,CAAC,KAAK,6BAA6B,CAAC,CAAC;IAChE,CAAC;IACD,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,GAAG,MAAM,CAAC,MAAM,iCAAiC,CAAC,CAAC;IACrE,CAAC;IAED,IAAI,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;QACtC,MAAM,IAAI,KAAK,CAAC,WAAW,MAAM,CAAC,IAAI,WAAW,IAAI,EAAE,CAAC,CAAC;IAC3D,CAAC;IAED,IAAI,UAAU,KAAK,SAAS,IAAI,UAAU,KAAK,IAAI,IAAI,UAAU,KAAK,IAAI,IAAI,UAAU,KAAK,IAAI,IAAI,UAAU,KAAK,IAAI,IAAI,UAAU,KAAK,OAAO,EAAE,CAAC;QACnJ,MAAM,IAAI,KAAK,CAAC,6BAA6B,UAAU,EAAE,CAAC,CAAC;IAC7D,CAAC;IAED,IACE,SAAS,KAAK,SAAS;QACvB,SAAS,KAAK,wBAAwB;QACtC,SAAS,KAAK,aAAa;QAC3B,SAAS,KAAK,eAAe;QAC7B,SAAS,KAAK,UAAU;QACxB,SAAS,KAAK,qBAAqB,EACnC,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,4BAA4B,SAAS,EAAE,CAAC,CAAC;IAC3D,CAAC;IAED,OAAO,sBAAsB,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC,CAAC;AACtF,CAAC"}

package/dist/leaderboard-query.test.d.ts

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

package/dist/leaderboard-query.test.d.ts.map

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

package/dist/leaderboard-query.test.js

@@ -0,0 +1,34 @@
+import { describe, expect, it } from "vitest";
+import { parseLeaderboardQuery } from "./leaderboard-query.js";
+describe("parseLeaderboardQuery", () => {
+    it("applies defaults for empty input", () => {
+        const query = parseLeaderboardQuery({});
+        expect(query).toEqual({ limit: 10, offset: 0, sort: "desc" });
+    });
+    it("normalizes numeric strings", () => {
+        const query = parseLeaderboardQuery({
+            limit: "2",
+            offset: "1",
+            sort: "asc",
+            complexity: "C3",
+            dimension: "security"
+        });
+        expect(query).toEqual({ limit: 2, offset: 1, sort: "asc", complexity: "C3", dimension: "security" });
+    });
+    it("throws labeled errors for invalid values", () => {
+        expect(() => parseLeaderboardQuery({ limit: "2x" }, {
+            limit: "--limit",
+            offset: "--offset",
+            sort: "--sort"
+        })).toThrow("Invalid --limit value: 2x");
+    });
+    it("enforces limit and offset boundaries", () => {
+        expect(() => parseLeaderboardQuery({ limit: 0 })).toThrow("limit must be a positive integer");
+        expect(() => parseLeaderboardQuery({ offset: -1 })).toThrow("offset must be a non-negative integer");
+    });
+    it("rejects invalid complexity and dimension", () => {
+        expect(() => parseLeaderboardQuery({ complexity: "C9" })).toThrow("Invalid complexity value: C9");
+        expect(() => parseLeaderboardQuery({ dimension: "unknown" })).toThrow("Invalid dimension value: unknown");
+    });
+});
+//# sourceMappingURL=leaderboard-query.test.js.map

package/dist/leaderboard-query.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"leaderboard-query.test.js","sourceRoot":"","sources":["../src/leaderboard-query.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAE/D,QAAQ,CAAC,uBAAuB,EAAE,GAAG,EAAE;IACrC,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;QAC1C,MAAM,KAAK,GAAG,qBAAqB,CAAC,EAAE,CAAC,CAAC;QACxC,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;IAChE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4BAA4B,EAAE,GAAG,EAAE;QACpC,MAAM,KAAK,GAAG,qBAAqB,CAAC;YAClC,KAAK,EAAE,GAAG;YACV,MAAM,EAAE,GAAG;YACX,IAAI,EAAE,KAAK;YACX,UAAU,EAAE,IAAI;YAChB,SAAS,EAAE,UAAU;SACtB,CAAC,CAAC;QACH,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,SAAS,EAAE,UAAU,EAAE,CAAC,CAAC;IACvG,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;QAClD,MAAM,CAAC,GAAG,EAAE,CACV,qBAAqB,CACnB,EAAE,KAAK,EAAE,IAAI,EAAE,EACf;YACE,KAAK,EAAE,SAAS;YAChB,MAAM,EAAE,UAAU;YAClB,IAAI,EAAE,QAAQ;SACf,CACF,CACF,CAAC,OAAO,CAAC,2BAA2B,CAAC,CAAC;IACzC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;QAC9C,MAAM,CAAC,GAAG,EAAE,CAAC,qBAAqB,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,kCAAkC,CAAC,CAAC;QAC9F,MAAM,CAAC,GAAG,EAAE,CAAC,qBAAqB,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,uCAAuC,CAAC,CAAC;IACvG,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;QAClD,MAAM,CAAC,GAAG,EAAE,CAAC,qBAAqB,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,8BAA8B,CAAC,CAAC;QAClG,MAAM,CAAC,GAAG,EAAE,CAAC,qBAAqB,CAAC,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,kCAAkC,CAAC,CAAC;IAC5G,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/local-store.d.ts

@@ -0,0 +1,18 @@
+import { CalibrationSnapshot, LocalStoreShape, RunRecord } from "./config.js";
+export declare class LocalStore {
+    private readonly filePath;
+    private db?;
+    constructor(filePath: string);
+    private getDb;
+    private ensureColumns;
+    private mapRun;
+    private parseJson;
+    close(): void;
+    read(): Promise<LocalStoreShape>;
+    appendRun(run: RunRecord): Promise<void>;
+    listRuns(): Promise<RunRecord[]>;
+    findRunById(runId: string): Promise<RunRecord | undefined>;
+    appendCalibration(snapshot: CalibrationSnapshot): Promise<void>;
+    listCalibrations(): Promise<CalibrationSnapshot[]>;
+}
+//# sourceMappingURL=local-store.d.ts.map

package/dist/local-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-store.d.ts","sourceRoot":"","sources":["../src/local-store.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE9E,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,EAAE,CAAC,CAAoB;gBAEnB,QAAQ,EAAE,MAAM;YAId,KAAK;IAqCnB,OAAO,CAAC,aAAa;IAarB,OAAO,CAAC,MAAM;IAgCd,OAAO,CAAC,SAAS;IAQjB,KAAK,IAAI,IAAI;IAOP,IAAI,IAAI,OAAO,CAAC,eAAe,CAAC;IAMhC,SAAS,CAAC,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAoCxC,QAAQ,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;IAiBhC,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC;IAiB1D,iBAAiB,CAAC,QAAQ,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAsB/D,gBAAgB,IAAI,OAAO,CAAC,mBAAmB,EAAE,CAAC;CAezD"}