@req2rank/core 0.1.0-r7

package/dist/requirement-generator.js

@@ -0,0 +1,358 @@
+import { DOMAIN_NAMES, DOMAIN_TAXONOMY } from "./domain-taxonomy.js";
+const DEFAULT_SEEDS = [
+    {
+        id: "seed-cli-transformer",
+        template: "Build a {artifact} tool for {scenario} with {constraint}",
+        skills: ["data-processing", "error-handling"],
+        complexity: "C1",
+        slots: {
+            artifact: ["CLI", "pipeline", "parser"],
+            scenario: ["CSV cleaning", "log normalization", "JSON validation"],
+            constraint: ["strict input validation", "retry-safe processing", "clear error summaries"]
+        }
+    },
+    {
+        id: "seed-api-workflow",
+        template: "Design a {scope} API for {domainObject} including {constraint}",
+        skills: ["api-design", "testing", "error-handling"],
+        complexity: "C2",
+        slots: {
+            scope: ["REST", "resource workflow", "state transition"],
+            domainObject: ["orders", "tickets", "subscriptions"],
+            constraint: ["idempotency", "rate-limited retries", "role-based permissions"]
+        }
+    },
+    {
+        id: "seed-service-orchestration",
+        template: "Implement a {artifact} orchestration for {domain} with {constraint}",
+        skills: ["distributed-systems", "api-design", "observability"],
+        complexity: "C3",
+        slots: {
+            artifact: ["multi-service workflow", "event-driven coordinator", "saga executor"],
+            constraint: ["exactly-once semantics", "compensating actions", "partial-failure recovery"]
+        }
+    },
+    {
+        id: "seed-platform-governance",
+        template: "Design a {artifact} platform for {domain} requiring {constraint}",
+        skills: ["security", "governance", "testing"],
+        complexity: "C4",
+        slots: {
+            artifact: ["tenant-isolated runtime", "compliance-grade audit system", "policy-driven execution mesh"],
+            constraint: ["formal rollback strategy", "cross-region consistency", "regulated data retention controls"]
+        }
+    },
+    {
+        id: "seed-ai-evaluation-suite",
+        template: "Build a {artifact} for {scenario} with {constraint}",
+        skills: ["evaluation", "data-processing", "error-handling"],
+        complexity: "C3",
+        slots: {
+            artifact: ["benchmark harness", "evaluation aggregator", "trace replay runner"],
+            scenario: ["model ranking", "regression gating", "failure clustering"],
+            constraint: ["deterministic replay", "parallel isolation", "reproducible scoring"]
+        }
+    }
+];
+class SeededRng {
+    state;
+    constructor(seed) {
+        this.state = hashSeed(seed);
+    }
+    next() {
+        this.state = (1664525 * this.state + 1013904223) % 4294967296;
+        return this.state / 4294967296;
+    }
+}
+function hashSeed(seed) {
+    let hash = 2166136261;
+    for (let i = 0; i < seed.length; i += 1) {
+        hash ^= seed.charCodeAt(i);
+        hash = Math.imul(hash, 16777619);
+    }
+    return hash >>> 0;
+}
+function pickOne(items, rng) {
+    if (items.length === 0) {
+        throw new Error("Cannot pick from empty list.");
+    }
+    const index = Math.floor(rng.next() * items.length);
+    return items[index];
+}
+function chooseSeed(input, seeds, rng) {
+    const candidates = seeds.filter((seed) => seed.complexity === input.complexity && seed.skills.some((skill) => input.skills.includes(skill)));
+    if (candidates.length > 0) {
+        return pickOne(candidates, rng);
+    }
+    return pickOne(seeds.filter((seed) => seed.complexity === input.complexity), rng);
+}
+function fillTemplate(seed, input, rng) {
+    const mutationLog = [];
+    let text = seed.template;
+    for (const [slotKey, slotValues] of Object.entries(seed.slots)) {
+        const value = pickOne(slotValues, rng);
+        text = text.replace(`{${slotKey}}`, value);
+        mutationLog.push(`slot:${slotKey}=${value}`);
+    }
+    text = text.replace("{domain}", input.domain).replace("{scenario}", input.scenario);
+    mutationLog.push(`domain:${input.domain}`);
+    mutationLog.push(`scenario:${input.scenario}`);
+    if (input.extraConstraints && input.extraConstraints.length > 0) {
+        mutationLog.push(`extra-constraints:${input.extraConstraints.join("|")}`);
+    }
+    return { text, mutationLog };
+}
+function parseJsonObject(raw) {
+    try {
+        const parsed = JSON.parse(raw);
+        if (parsed && typeof parsed === "object") {
+            return parsed;
+        }
+    }
+    catch {
+        // continue with fence fallback
+    }
+    const jsonFence = raw.match(/```json\r?\n([\s\S]*?)```/i);
+    if (jsonFence) {
+        try {
+            const parsed = JSON.parse(jsonFence[1]);
+            if (parsed && typeof parsed === "object") {
+                return parsed;
+            }
+        }
+        catch {
+            return undefined;
+        }
+    }
+    return undefined;
+}
+function normalizePriority(value) {
+    if (value === "must" || value === "should" || value === "nice-to-have") {
+        return value;
+    }
+    return "must";
+}
+function buildDefaultFunctionalRequirements(description) {
+    return [
+        {
+            id: "FR-1",
+            description: `Implement the core flow: ${description}`,
+            acceptanceCriteria: "Core flow behaves as specified for valid input.",
+            priority: "must"
+        },
+        {
+            id: "FR-2",
+            description: "Handle at least one edge case with deterministic behavior.",
+            acceptanceCriteria: "Edge-case path is explicitly handled and testable.",
+            priority: "must"
+        }
+    ];
+}
+function toProjectRequirementDraft(parsed, fallbackDescription) {
+    const functionalRequirements = Array.isArray(parsed.functionalRequirements)
+        ? parsed.functionalRequirements
+            .filter((item) => item && typeof item === "object")
+            .map((item, index) => {
+            const record = item;
+            return {
+                id: typeof record.id === "string" && record.id.length > 0 ? record.id : `FR-${index + 1}`,
+                description: typeof record.description === "string" && record.description.length > 0
+                    ? record.description
+                    : "Implement specified feature",
+                acceptanceCriteria: typeof record.acceptanceCriteria === "string" && record.acceptanceCriteria.length > 0
+                    ? record.acceptanceCriteria
+                    : "Behavior is verifiable with pass/fail criteria",
+                priority: normalizePriority(record.priority)
+            };
+        })
+        : [];
+    const normalizedFunctionalRequirements = functionalRequirements.length >= 2
+        ? functionalRequirements
+        : [...functionalRequirements, ...buildDefaultFunctionalRequirements(fallbackDescription)].slice(0, 2);
+    const evaluationGuidanceInput = parsed.evaluationGuidance && typeof parsed.evaluationGuidance === "object"
+        ? parsed.evaluationGuidance
+        : undefined;
+    return {
+        title: typeof parsed.title === "string" && parsed.title.length > 0 ? parsed.title : "Generated Requirement",
+        description: typeof parsed.description === "string" && parsed.description.length > 0 ? parsed.description : fallbackDescription,
+        functionalRequirements: normalizedFunctionalRequirements,
+        constraints: Array.isArray(parsed.constraints) ? parsed.constraints.filter((item) => typeof item === "string") : [],
+        expectedDeliverables: Array.isArray(parsed.expectedDeliverables)
+            ? parsed.expectedDeliverables.filter((item) => typeof item === "string")
+            : ["source code", "tests"],
+        exampleIO: Array.isArray(parsed.exampleIO)
+            ? parsed.exampleIO
+                .filter((item) => item && typeof item === "object")
+                .map((item) => {
+                const record = item;
+                return {
+                    input: typeof record.input === "string" ? record.input : "",
+                    expectedOutput: typeof record.expectedOutput === "string" ? record.expectedOutput : ""
+                };
+            })
+                .filter((item) => item.input.length > 0 && item.expectedOutput.length > 0)
+            : undefined,
+        evaluationGuidance: {
+            keyDifferentiators: Array.isArray(evaluationGuidanceInput?.keyDifferentiators)
+                ? evaluationGuidanceInput.keyDifferentiators.filter((item) => typeof item === "string")
+                : ["requirement coverage", "clarity", "edge-case handling"],
+            commonPitfalls: Array.isArray(evaluationGuidanceInput?.commonPitfalls)
+                ? evaluationGuidanceInput.commonPitfalls.filter((item) => typeof item === "string")
+                : ["missing validation", "incomplete acceptance criteria"],
+            edgeCases: Array.isArray(evaluationGuidanceInput?.edgeCases)
+                ? evaluationGuidanceInput.edgeCases.filter((item) => typeof item === "string")
+                : ["empty input", "invalid parameter"]
+        },
+        selfReviewPassed: Boolean(parsed.selfReviewPassed)
+    };
+}
+function buildStageOnePrompt(input, generatedSeedText) {
+    return [
+        "You are a senior software PM. Draft a project requirement document.",
+        "",
+        `Skills: ${input.skills.join(", ")}`,
+        `Complexity: ${input.complexity}`,
+        `Domain: ${input.domain}`,
+        `Scenario: ${input.scenario}`,
+        `Tech stack: ${input.techStack.join(", ")}`,
+        `Seed requirement skeleton: ${generatedSeedText}`,
+        input.extraConstraints && input.extraConstraints.length > 0
+            ? `Additional constraints: ${input.extraConstraints.join("; ")}`
+            : "Additional constraints: none",
+        "",
+        "Requirements:",
+        "1. Produce concrete, testable functional requirements.",
+        "2. Include at least one explicit edge case.",
+        "3. Keep scope aligned with the complexity.",
+        "4. Include delivery expectations (code/tests/docs)."
+    ].join("\n");
+}
+function buildStageTwoPrompt(draftRequirement, complexity) {
+    return [
+        "You are a QA reviewer. Audit and improve this requirement draft.",
+        "",
+        "Checklist:",
+        "1. Remove ambiguity.",
+        "2. Ensure each requirement has pass/fail acceptance criteria.",
+        "3. Confirm technical feasibility.",
+        `4. Keep difficulty at complexity ${complexity}.`,
+        "5. Resolve conflicting constraints.",
+        "",
+        "Draft:",
+        draftRequirement
+    ].join("\n");
+}
+function buildStageThreePrompt(reviewedRequirement) {
+    return [
+        "Convert the reviewed requirement into strict JSON.",
+        "Return only JSON object with keys:",
+        "title, description, functionalRequirements[], constraints[], expectedDeliverables[], exampleIO[{input,expectedOutput}], evaluationGuidance{keyDifferentiators[], commonPitfalls[], edgeCases[]}, selfReviewPassed",
+        "Each functional requirement must include id, description, acceptanceCriteria, priority.",
+        "",
+        "Reviewed requirement:",
+        reviewedRequirement
+    ].join("\n");
+}
+export class RequirementGenerator {
+    seeds;
+    constructor(seeds = DEFAULT_SEEDS) {
+        this.seeds = seeds;
+    }
+    async generate(input, modelConfig) {
+        const seedValue = input.seed ?? `${input.domain}:${input.scenario}:${Date.now()}`;
+        const rng = new SeededRng(seedValue);
+        const selectedSeed = chooseSeed(input, this.seeds, rng);
+        const shouldSampleTaxonomy = input.domain.trim().toLowerCase() === "generic" || input.scenario.trim().toLowerCase() === "pipeline-eval";
+        const sampledDomain = shouldSampleTaxonomy ? pickOne(DOMAIN_NAMES, rng) : input.domain;
+        const sampledScenario = shouldSampleTaxonomy && sampledDomain in DOMAIN_TAXONOMY
+            ? pickOne([...DOMAIN_TAXONOMY[sampledDomain]], rng)
+            : input.scenario;
+        const normalizedInput = {
+            ...input,
+            domain: sampledDomain,
+            scenario: sampledScenario
+        };
+        const generated = fillTemplate(selectedSeed, normalizedInput, rng);
+        const stageOne = await modelConfig.provider.chat({
+            model: modelConfig.model,
+            temperature: 0.4,
+            maxTokens: 2_048,
+            messages: [
+                {
+                    role: "system",
+                    content: "You produce high-quality, unambiguous software project requirements."
+                },
+                {
+                    role: "user",
+                    content: buildStageOnePrompt(normalizedInput, generated.text)
+                }
+            ]
+        });
+        const stageTwo = await modelConfig.provider.chat({
+            model: modelConfig.model,
+            temperature: 0.2,
+            maxTokens: 2_048,
+            messages: [
+                {
+                    role: "system",
+                    content: "You are a strict QA reviewer for software requirements."
+                },
+                {
+                    role: "user",
+                    content: buildStageTwoPrompt(stageOne.content, normalizedInput.complexity)
+                }
+            ]
+        });
+        const stageThree = await modelConfig.provider.chat({
+            model: modelConfig.model,
+            temperature: 0,
+            maxTokens: 2_048,
+            responseFormat: "json",
+            messages: [
+                {
+                    role: "system",
+                    content: "Return strictly valid JSON with no markdown."
+                },
+                {
+                    role: "user",
+                    content: buildStageThreePrompt(stageTwo.content)
+                }
+            ]
+        });
+        const parsed = parseJsonObject(stageThree.content);
+        const normalized = toProjectRequirementDraft(parsed ?? {}, stageTwo.content);
+        const requirementId = `req-${Math.floor(rng.next() * 1_000_000)}`;
+        const constraints = [
+            `Complexity constrained to ${input.complexity}`,
+            ...normalized.constraints
+        ];
+        if (input.extraConstraints) {
+            constraints.push(...input.extraConstraints);
+        }
+        return {
+            id: requirementId,
+            version: "1.0",
+            title: normalized.title,
+            description: normalized.description,
+            functionalRequirements: normalized.functionalRequirements,
+            constraints,
+            expectedDeliverables: normalized.expectedDeliverables,
+            exampleIO: normalized.exampleIO,
+            metadata: {
+                skills: input.skills,
+                complexity: input.complexity,
+                domain: normalizedInput.domain,
+                scenario: normalizedInput.scenario,
+                techStack: input.techStack,
+                seedId: selectedSeed.id,
+                mutationLog: generated.mutationLog
+            },
+            evaluationGuidance: normalized.evaluationGuidance,
+            generatedBy: "req2rank-requirement-generator",
+            generatedAt: new Date().toISOString(),
+            selfReviewPassed: normalized.selfReviewPassed
+        };
+    }
+}
+export const defaultSeeds = DEFAULT_SEEDS;
+//# sourceMappingURL=requirement-generator.js.map

package/dist/requirement-generator.js.map

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

package/dist/requirement-generator.test.d.ts

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

package/dist/requirement-generator.test.d.ts.map

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

package/dist/requirement-generator.test.js

@@ -0,0 +1,182 @@
+import { describe, expect, it } from "vitest";
+import { RequirementGenerator } from "./requirement-generator.js";
+class StubProvider {
+    id = "stub";
+    name = "Stub";
+    callCount = 0;
+    async chat() {
+        this.callCount += 1;
+        if (this.callCount === 1) {
+            return {
+                content: "Draft requirement text.",
+                usage: { promptTokens: 10, completionTokens: 20 },
+                latencyMs: 5
+            };
+        }
+        if (this.callCount === 2) {
+            return {
+                content: "Reviewed requirement text.",
+                usage: { promptTokens: 11, completionTokens: 21 },
+                latencyMs: 6
+            };
+        }
+        return {
+            content: JSON.stringify({
+                title: "Generated requirement",
+                description: "Detailed generated requirement",
+                functionalRequirements: [
+                    {
+                        id: "FR-1",
+                        description: "Implement API endpoint",
+                        acceptanceCriteria: "Request returns expected payload",
+                        priority: "must"
+                    },
+                    {
+                        id: "FR-2",
+                        description: "Handle invalid input",
+                        acceptanceCriteria: "Invalid payload returns 400",
+                        priority: "must"
+                    }
+                ],
+                constraints: ["Use TypeScript"],
+                expectedDeliverables: ["source code", "tests"],
+                exampleIO: [
+                    {
+                        input: "POST /orders with valid payload",
+                        expectedOutput: "201 Created with order id"
+                    }
+                ],
+                evaluationGuidance: {
+                    keyDifferentiators: ["robust validation"],
+                    commonPitfalls: ["missing error handling"],
+                    edgeCases: ["empty request body"]
+                },
+                selfReviewPassed: true
+            }),
+            usage: { promptTokens: 12, completionTokens: 22 },
+            latencyMs: 7
+        };
+    }
+}
+class StubFencedJsonProvider {
+    id = "stub-fenced";
+    name = "Stub Fenced";
+    callCount = 0;
+    async chat() {
+        this.callCount += 1;
+        if (this.callCount < 3) {
+            return {
+                content: this.callCount === 1 ? "Draft requirement text." : "Reviewed requirement text.",
+                usage: { promptTokens: 10, completionTokens: 20 },
+                latencyMs: 5
+            };
+        }
+        return {
+            content: "```json\r\n{\"title\":\"Generated requirement\",\"description\":\"Detailed generated requirement\",\"functionalRequirements\":[{\"id\":\"FR-1\",\"description\":\"Implement API endpoint\",\"acceptanceCriteria\":\"Request returns expected payload\",\"priority\":\"must\"},{\"id\":\"FR-2\",\"description\":\"Handle invalid input\",\"acceptanceCriteria\":\"Invalid payload returns 400\",\"priority\":\"must\"}],\"constraints\":[\"Use TypeScript\"],\"expectedDeliverables\":[\"source code\",\"tests\"],\"selfReviewPassed\":true}\r\n```",
+            usage: { promptTokens: 12, completionTokens: 22 },
+            latencyMs: 7
+        };
+    }
+}
+describe("RequirementGenerator", () => {
+    it("returns deterministic seed metadata with fixed seed", async () => {
+        const provider = new StubProvider();
+        const generator = new RequirementGenerator();
+        const input = {
+            skills: ["api-design", "error-handling"],
+            complexity: "C2",
+            domain: "ecommerce",
+            scenario: "order-state",
+            techStack: ["typescript"],
+            seed: "fixed-seed"
+        };
+        const first = await generator.generate(input, { provider, model: "gpt-4o-mini" });
+        const second = await generator.generate(input, { provider, model: "gpt-4o-mini" });
+        expect(first.metadata.seedId).toBe(second.metadata.seedId);
+        expect(first.metadata.mutationLog).toEqual(second.metadata.mutationLog);
+    });
+    it("injects additional constraints", async () => {
+        const provider = new StubProvider();
+        const generator = new RequirementGenerator();
+        const result = await generator.generate({
+            skills: ["data-processing"],
+            complexity: "C1",
+            domain: "analytics",
+            scenario: "log-parser",
+            techStack: ["typescript"],
+            seed: "constraint-seed",
+            extraConstraints: ["must finish under 100 lines"]
+        }, { provider, model: "gpt-4o-mini" });
+        expect(result.constraints).toContain("must finish under 100 lines");
+        expect(result.metadata.mutationLog.some((entry) => entry.startsWith("extra-constraints:"))).toBe(true);
+    });
+    it("runs a three-stage prompt pipeline", async () => {
+        const provider = new StubProvider();
+        const generator = new RequirementGenerator();
+        const result = await generator.generate({
+            skills: ["api-design", "error-handling"],
+            complexity: "C2",
+            domain: "ecommerce",
+            scenario: "order-state",
+            techStack: ["typescript"],
+            seed: "stage-seed"
+        }, { provider, model: "gpt-4o-mini" });
+        expect(provider.callCount).toBe(3);
+        expect(result.functionalRequirements.length).toBeGreaterThanOrEqual(2);
+        expect(result.title).toBe("Generated requirement");
+        expect(result.exampleIO?.[0]?.input).toContain("POST /orders");
+    });
+    it("supports C3/C4 generation with richer seeds", async () => {
+        const provider = new StubProvider();
+        const generator = new RequirementGenerator();
+        const c3 = await generator.generate({
+            skills: ["distributed-systems", "api-design"],
+            complexity: "C3",
+            domain: "platform",
+            scenario: "orchestration",
+            techStack: ["typescript"],
+            seed: "c3-seed"
+        }, { provider, model: "gpt-4o-mini" });
+        const c4 = await generator.generate({
+            skills: ["security", "governance"],
+            complexity: "C4",
+            domain: "banking",
+            scenario: "compliance",
+            techStack: ["typescript"],
+            seed: "c4-seed"
+        }, { provider, model: "gpt-4o-mini" });
+        expect(c3.metadata.complexity).toBe("C3");
+        expect(c4.metadata.complexity).toBe("C4");
+        expect(c3.metadata.seedId).toBeTruthy();
+        expect(c4.metadata.seedId).toBeTruthy();
+    });
+    it("parses fenced JSON payload with CRLF newlines", async () => {
+        const provider = new StubFencedJsonProvider();
+        const generator = new RequirementGenerator();
+        const result = await generator.generate({
+            skills: ["api-design", "error-handling"],
+            complexity: "C2",
+            domain: "ecommerce",
+            scenario: "order-state",
+            techStack: ["typescript"],
+            seed: "fenced-crlf-seed"
+        }, { provider, model: "gpt-4o-mini" });
+        expect(result.title).toBe("Generated requirement");
+        expect(result.functionalRequirements).toHaveLength(2);
+    });
+    it("samples domain taxonomy for generic pipeline input", async () => {
+        const provider = new StubProvider();
+        const generator = new RequirementGenerator();
+        const generated = await generator.generate({
+            skills: ["api-design", "error-handling"],
+            complexity: "C2",
+            domain: "generic",
+            scenario: "pipeline-eval",
+            techStack: ["typescript"],
+            seed: "taxonomy-seed"
+        }, { provider, model: "gpt-4o-mini" });
+        expect(generated.metadata.domain).not.toBe("generic");
+        expect(generated.metadata.scenario).not.toBe("pipeline-eval");
+    });
+});
+//# sourceMappingURL=requirement-generator.test.js.map

package/dist/requirement-generator.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"requirement-generator.test.js","sourceRoot":"","sources":["../src/requirement-generator.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAE9C,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAElE,MAAM,YAAY;IAChB,EAAE,GAAG,MAAM,CAAC;IACZ,IAAI,GAAG,MAAM,CAAC;IACd,SAAS,GAAG,CAAC,CAAC;IAEd,KAAK,CAAC,IAAI;QACR,IAAI,CAAC,SAAS,IAAI,CAAC,CAAC;QACpB,IAAI,IAAI,CAAC,SAAS,KAAK,CAAC,EAAE,CAAC;YACzB,OAAO;gBACL,OAAO,EAAE,yBAAyB;gBAClC,KAAK,EAAE,EAAE,YAAY,EAAE,EAAE,EAAE,gBAAgB,EAAE,EAAE,EAAE;gBACjD,SAAS,EAAE,CAAC;aACb,CAAC;QACJ,CAAC;QAED,IAAI,IAAI,CAAC,SAAS,KAAK,CAAC,EAAE,CAAC;YACzB,OAAO;gBACL,OAAO,EAAE,4BAA4B;gBACrC,KAAK,EAAE,EAAE,YAAY,EAAE,EAAE,EAAE,gBAAgB,EAAE,EAAE,EAAE;gBACjD,SAAS,EAAE,CAAC;aACb,CAAC;QACJ,CAAC;QAED,OAAO;YACL,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC;gBACtB,KAAK,EAAE,uBAAuB;gBAC9B,WAAW,EAAE,gCAAgC;gBAC7C,sBAAsB,EAAE;oBACtB;wBACE,EAAE,EAAE,MAAM;wBACV,WAAW,EAAE,wBAAwB;wBACrC,kBAAkB,EAAE,kCAAkC;wBACtD,QAAQ,EAAE,MAAM;qBACjB;oBACD;wBACE,EAAE,EAAE,MAAM;wBACV,WAAW,EAAE,sBAAsB;wBACnC,kBAAkB,EAAE,6BAA6B;wBACjD,QAAQ,EAAE,MAAM;qBACjB;iBACF;gBACD,WAAW,EAAE,CAAC,gBAAgB,CAAC;gBAC/B,oBAAoB,EAAE,CAAC,aAAa,EAAE,OAAO,CAAC;gBAC9C,SAAS,EAAE;oBACT;wBACE,KAAK,EAAE,iCAAiC;wBACxC,cAAc,EAAE,2BAA2B;qBAC5C;iBACF;gBACD,kBAAkB,EAAE;oBAClB,kBAAkB,EAAE,CAAC,mBAAmB,CAAC;oBACzC,cAAc,EAAE,CAAC,wBAAwB,CAAC;oBAC1C,SAAS,EAAE,CAAC,oBAAoB,CAAC;iBAClC;gBACD,gBAAgB,EAAE,IAAI;aACvB,CAAC;YACF,KAAK,EAAE,EAAE,YAAY,EAAE,EAAE,EAAE,gBAAgB,EAAE,EAAE,EAAE;YACjD,SAAS,EAAE,CAAC;SACb,CAAC;IACJ,CAAC;CACF;AAED,MAAM,sBAAsB;IAC1B,EAAE,GAAG,aAAa,CAAC;IACnB,IAAI,GAAG,aAAa,CAAC;IACrB,SAAS,GAAG,CAAC,CAAC;IAEd,KAAK,CAAC,IAAI;QACR,IAAI,CAAC,SAAS,IAAI,CAAC,CAAC;QACpB,IAAI,IAAI,CAAC,SAAS,GAAG,CAAC,EAAE,CAAC;YACvB,OAAO;gBACL,OAAO,EAAE,IAAI,CAAC,SAAS,KAAK,CAAC,CAAC,CAAC,CAAC,yBAAyB,CAAC,CAAC,CAAC,4BAA4B;gBACxF,KAAK,EAAE,EAAE,YAAY,EAAE,EAAE,EAAE,gBAAgB,EAAE,EAAE,EAAE;gBACjD,SAAS,EAAE,CAAC;aACb,CAAC;QACJ,CAAC;QAED,OAAO;YACL,OAAO,EACL,ohBAAohB;YACthB,KAAK,EAAE,EAAE,YAAY,EAAE,EAAE,EAAE,gBAAgB,EAAE,EAAE,EAAE;YACjD,SAAS,EAAE,CAAC;SACb,CAAC;IACJ,CAAC;CACF;AAED,QAAQ,CAAC,sBAAsB,EAAE,GAAG,EAAE;IACpC,EAAE,CAAC,qDAAqD,EAAE,KAAK,IAAI,EAAE;QACnE,MAAM,QAAQ,GAAG,IAAI,YAAY,EAAE,CAAC;QACpC,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;QAC7C,MAAM,KAAK,GAAG;YACZ,MAAM,EAAE,CAAC,YAAY,EAAE,gBAAgB,CAAC;YACxC,UAAU,EAAE,IAAa;YACzB,MAAM,EAAE,WAAW;YACnB,QAAQ,EAAE,aAAa;YACvB,SAAS,EAAE,CAAC,YAAY,CAAC;YACzB,IAAI,EAAE,YAAY;SACnB,CAAC;QAEF,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,QAAQ,CAAC,KAAK,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,aAAa,EAAE,CAAC,CAAC;QAClF,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,QAAQ,CAAC,KAAK,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,aAAa,EAAE,CAAC,CAAC;QAEnF,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QAC3D,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;IAC1E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gCAAgC,EAAE,KAAK,IAAI,EAAE;QAC9C,MAAM,QAAQ,GAAG,IAAI,YAAY,EAAE,CAAC;QACpC,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;QAC7C,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,QAAQ,CACrC;YACE,MAAM,EAAE,CAAC,iBAAiB,CAAC;YAC3B,UAAU,EAAE,IAAI;YAChB,MAAM,EAAE,WAAW;YACnB,QAAQ,EAAE,YAAY;YACtB,SAAS,EAAE,CAAC,YAAY,CAAC;YACzB,IAAI,EAAE,iBAAiB;YACvB,gBAAgB,EAAE,CAAC,6BAA6B,CAAC;SAClD,EACD,EAAE,QAAQ,EAAE,KAAK,EAAE,aAAa,EAAE,CACnC,CAAC;QAEF,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,SAAS,CAAC,6BAA6B,CAAC,CAAC;QACpE,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACzG,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oCAAoC,EAAE,KAAK,IAAI,EAAE;QAClD,MAAM,QAAQ,GAAG,IAAI,YAAY,EAAE,CAAC;QACpC,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;QAE7C,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,QAAQ,CACrC;YACE,MAAM,EAAE,CAAC,YAAY,EAAE,gBAAgB,CAAC;YACxC,UAAU,EAAE,IAAI;YAChB,MAAM,EAAE,WAAW;YACnB,QAAQ,EAAE,aAAa;YACvB,SAAS,EAAE,CAAC,YAAY,CAAC;YACzB,IAAI,EAAE,YAAY;SACnB,EACD,EAAE,QAAQ,EAAE,KAAK,EAAE,aAAa,EAAE,CACnC,CAAC;QAEF,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACnC,MAAM,CAAC,MAAM,CAAC,sBAAsB,CAAC,MAAM,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC;QACvE,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;QACnD,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;IACjE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6CAA6C,EAAE,KAAK,IAAI,EAAE;QAC3D,MAAM,QAAQ,GAAG,IAAI,YAAY,EAAE,CAAC;QACpC,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;QAE7C,MAAM,EAAE,GAAG,MAAM,SAAS,CAAC,QAAQ,CACjC;YACE,MAAM,EAAE,CAAC,qBAAqB,EAAE,YAAY,CAAC;YAC7C,UAAU,EAAE,IAAI;YAChB,MAAM,EAAE,UAAU;YAClB,QAAQ,EAAE,eAAe;YACzB,SAAS,EAAE,CAAC,YAAY,CAAC;YACzB,IAAI,EAAE,SAAS;SAChB,EACD,EAAE,QAAQ,EAAE,KAAK,EAAE,aAAa,EAAE,CACnC,CAAC;QAEF,MAAM,EAAE,GAAG,MAAM,SAAS,CAAC,QAAQ,CACjC;YACE,MAAM,EAAE,CAAC,UAAU,EAAE,YAAY,CAAC;YAClC,UAAU,EAAE,IAAI;YAChB,MAAM,EAAE,SAAS;YACjB,QAAQ,EAAE,YAAY;YACtB,SAAS,EAAE,CAAC,YAAY,CAAC;YACzB,IAAI,EAAE,SAAS;SAChB,EACD,EAAE,QAAQ,EAAE,KAAK,EAAE,aAAa,EAAE,CACnC,CAAC;QAEF,MAAM,CAAC,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1C,MAAM,CAAC,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1C,MAAM,CAAC,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,UAAU,EAAE,CAAC;QACxC,MAAM,CAAC,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,UAAU,EAAE,CAAC;IAC1C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+CAA+C,EAAE,KAAK,IAAI,EAAE;QAC7D,MAAM,QAAQ,GAAG,IAAI,sBAAsB,EAAE,CAAC;QAC9C,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;QAE7C,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,QAAQ,CACrC;YACE,MAAM,EAAE,CAAC,YAAY,EAAE,gBAAgB,CAAC;YACxC,UAAU,EAAE,IAAI;YAChB,MAAM,EAAE,WAAW;YACnB,QAAQ,EAAE,aAAa;YACvB,SAAS,EAAE,CAAC,YAAY,CAAC;YACzB,IAAI,EAAE,kBAAkB;SACzB,EACD,EAAE,QAAQ,EAAE,KAAK,EAAE,aAAa,EAAE,CACnC,CAAC;QAEF,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;QACnD,MAAM,CAAC,MAAM,CAAC,sBAAsB,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IACxD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oDAAoD,EAAE,KAAK,IAAI,EAAE;QAClE,MAAM,QAAQ,GAAG,IAAI,YAAY,EAAE,CAAC;QACpC,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;QAE7C,MAAM,SAAS,GAAG,MAAM,SAAS,CAAC,QAAQ,CACxC;YACE,MAAM,EAAE,CAAC,YAAY,EAAE,gBAAgB,CAAC;YACxC,UAAU,EAAE,IAAI;YAChB,MAAM,EAAE,SAAS;YACjB,QAAQ,EAAE,eAAe;YACzB,SAAS,EAAE,CAAC,YAAY,CAAC;YACzB,IAAI,EAAE,eAAe;SACtB,EACD,EAAE,QAAQ,EAAE,KAAK,EAAE,aAAa,EAAE,CACnC,CAAC;QAEF,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACtD,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IAChE,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/sandbox.d.ts

@@ -0,0 +1,32 @@
+export interface SandboxOptions {
+    image?: string;
+    workdir?: string;
+    workspacePath?: string;
+    command?: string[];
+    timeoutMs?: number;
+    cpus?: number;
+    memoryMb?: number;
+    pidsLimit?: number;
+    network?: "none" | "bridge";
+    readOnly?: boolean;
+}
+export declare function buildDockerSandboxCommand(options?: SandboxOptions): string[];
+export declare function runSandboxedCommand(options?: SandboxOptions): Promise<{
+    stdout: string;
+    stderr: string;
+}>;
+export interface SandboxedSubmissionInput {
+    code: string;
+    language: string;
+    timeoutMs?: number;
+    image?: string;
+}
+export interface SandboxedSubmissionResult {
+    passed: boolean;
+    command: string[];
+    workspacePath: string;
+    stdout: string;
+    stderr: string;
+}
+export declare function runSandboxedSubmission(input: SandboxedSubmissionInput): Promise<SandboxedSubmissionResult>;
+//# sourceMappingURL=sandbox.d.ts.map

package/dist/sandbox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sandbox.d.ts","sourceRoot":"","sources":["../src/sandbox.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC;IAC5B,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,wBAAgB,yBAAyB,CAAC,OAAO,GAAE,cAAmB,GAAG,MAAM,EAAE,CAmChF;AAED,wBAAsB,mBAAmB,CAAC,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAOnH;AAED,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,yBAAyB;IACxC,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AA0CD,wBAAsB,sBAAsB,CAAC,KAAK,EAAE,wBAAwB,GAAG,OAAO,CAAC,yBAAyB,CAAC,CAuChH"}