ralphy-spec 0.1.1 → 0.3.0

package/dist/core/budgets/tiers.js.map

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

package/dist/core/engine/constraints.d.ts

@@ -0,0 +1,16 @@
+import type { TaskSpec } from "../spec/types";
+export type ConstraintViolation = {
+    kind: "scope_violation";
+    level: "error";
+    message: string;
+    file?: string;
+    raw?: unknown;
+};
+export declare function enforceSprintConstraints(args: {
+    task: TaskSpec;
+    changedFiles: Array<{
+        file: string;
+        isNew: boolean;
+    }>;
+}): ConstraintViolation[];
+//# sourceMappingURL=constraints.d.ts.map

package/dist/core/engine/constraints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constraints.d.ts","sourceRoot":"","sources":["../../../src/core/engine/constraints.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE9C,MAAM,MAAM,mBAAmB,GAAG;IAChC,IAAI,EAAE,iBAAiB,CAAC;IACxB,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,OAAO,CAAC;CACf,CAAC;AAEF,wBAAgB,wBAAwB,CAAC,IAAI,EAAE;IAC7C,IAAI,EAAE,QAAQ,CAAC;IACf,YAAY,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;CACvD,GAAG,mBAAmB,EAAE,CAoBxB"}

package/dist/core/engine/constraints.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.enforceSprintConstraints = enforceSprintConstraints;
+function enforceSprintConstraints(args) {
+    const size = args.task.sprint?.size;
+    if (!size)
+        return [];
+    const newFiles = args.changedFiles.filter((f) => f.isNew);
+    const violations = [];
+    const maxNew = size === "XS" ? 0 : size === "S" ? 0 : size === "M" ? 2 : size === "L" ? 10 : Infinity;
+    if (newFiles.length > maxNew) {
+        violations.push({
+            kind: "scope_violation",
+            level: "error",
+            message: `Sprint size ${size} allows at most ${maxNew} new files, but found ${newFiles.length}.`,
+            raw: { size, maxNew, newFiles },
+        });
+    }
+    return violations;
+}
+//# sourceMappingURL=constraints.js.map

package/dist/core/engine/constraints.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constraints.js","sourceRoot":"","sources":["../../../src/core/engine/constraints.ts"],"names":[],"mappings":";;AAUA,4DAuBC;AAvBD,SAAgB,wBAAwB,CAAC,IAGxC;IACC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC;IACpC,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,CAAC;IAErB,MAAM,QAAQ,GAAG,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IAC1D,MAAM,UAAU,GAA0B,EAAE,CAAC;IAE7C,MAAM,MAAM,GACV,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC;IAEzF,IAAI,QAAQ,CAAC,MAAM,GAAG,MAAM,EAAE,CAAC;QAC7B,UAAU,CAAC,IAAI,CAAC;YACd,IAAI,EAAE,iBAAiB;YACvB,KAAK,EAAE,OAAO;YACd,OAAO,EAAE,eAAe,IAAI,mBAAmB,MAAM,yBAAyB,QAAQ,CAAC,MAAM,GAAG;YAChG,GAAG,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE;SAChC,CAAC,CAAC;IACL,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/dist/core/engine/constraints.policy.test.d.ts

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

package/dist/core/engine/constraints.policy.test.d.ts.map

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

package/dist/core/engine/constraints.policy.test.js

@@ -0,0 +1,85 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const promises_1 = __importDefault(require("node:fs/promises"));
+const node_os_1 = __importDefault(require("node:os"));
+const node_path_1 = __importDefault(require("node:path"));
+const loop_1 = require("./loop");
+const noop_1 = require("../backends/noop");
+class ScopeWorkspace {
+    cwd;
+    mode = "patch";
+    constructor(cwd) {
+        this.cwd = cwd;
+    }
+    async prepare(taskId) {
+        return { taskId, workingDir: this.cwd };
+    }
+    getWorkingDir() {
+        return this.cwd;
+    }
+    async getChangedFiles() {
+        // Pretend the backend changed an unrelated file.
+        return [{ file: "unrelated.txt", isNew: true }];
+    }
+    async enforceContract() {
+        return [];
+    }
+    async checkpoint() {
+        return { ref: "noop" };
+    }
+    async merge() { }
+    async revert() { }
+    async cleanup() { }
+}
+(0, vitest_1.describe)("scope guard policy", () => {
+    (0, vitest_1.it)("does not block when scopeGuard=warn", async () => {
+        const tmp = await promises_1.default.mkdtemp(node_path_1.default.join(node_os_1.default.tmpdir(), "ralphy-scope-"));
+        const spec = {
+            version: "1.1",
+            project: { name: "tmp", repoRoot: "." },
+            defaults: { backend: "noop", workspaceMode: "patch", checkpointMode: "commit", validators: [] },
+            policies: { scopeGuard: "warn" },
+            budgets: { limits: { commandTimeoutSeconds: 5 } },
+            validators: [],
+            tasks: [{ id: "t1", sprint: { size: "XS", intent: "fix" } }],
+            artifacts: { enabled: false },
+        };
+        const outcome = await new loop_1.EngineLoop().run({
+            repoRoot: tmp,
+            spec,
+            backend: new noop_1.NoopBackend("noop"),
+            workspace: new ScopeWorkspace(tmp),
+            dryRun: false,
+            json: true,
+        });
+        // With warn, the scope violation is a warning and should not fail the run by itself.
+        (0, vitest_1.expect)(outcome.ok).toBe(true);
+    });
+    (0, vitest_1.it)("blocks when scopeGuard=block", async () => {
+        const tmp = await promises_1.default.mkdtemp(node_path_1.default.join(node_os_1.default.tmpdir(), "ralphy-scope-"));
+        const spec = {
+            version: "1.1",
+            project: { name: "tmp", repoRoot: "." },
+            defaults: { backend: "noop", workspaceMode: "patch", checkpointMode: "commit", validators: [] },
+            policies: { scopeGuard: "block" },
+            budgets: { limits: { commandTimeoutSeconds: 5 } },
+            validators: [],
+            tasks: [{ id: "t1", sprint: { size: "XS", intent: "fix" } }],
+            artifacts: { enabled: false },
+        };
+        const outcome = await new loop_1.EngineLoop().run({
+            repoRoot: tmp,
+            spec,
+            backend: new noop_1.NoopBackend("noop"),
+            workspace: new ScopeWorkspace(tmp),
+            dryRun: false,
+            json: true,
+        });
+        (0, vitest_1.expect)(outcome.ok).toBe(false);
+    });
+});
+//# sourceMappingURL=constraints.policy.test.js.map

package/dist/core/engine/constraints.policy.test.js.map

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

package/dist/core/engine/context-pack.d.ts

@@ -0,0 +1,12 @@
+import type { Issue, ValidateResult } from "../validators/types";
+export type ContextPack = {
+    text: string;
+    size: "full" | "warning_shrunk";
+};
+export declare function buildContextPack(args: {
+    tier: "optimal" | "warning" | "hard";
+    taskId: string;
+    validatorResults: Record<string, ValidateResult>;
+    issues: Issue[];
+}): ContextPack;
+//# sourceMappingURL=context-pack.d.ts.map

package/dist/core/engine/context-pack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-pack.d.ts","sourceRoot":"","sources":["../../../src/core/engine/context-pack.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAEjE,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,GAAG,gBAAgB,CAAC;CACjC,CAAC;AAEF,wBAAgB,gBAAgB,CAAC,IAAI,EAAE;IACrC,IAAI,EAAE,SAAS,GAAG,SAAS,GAAG,MAAM,CAAC;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IACjD,MAAM,EAAE,KAAK,EAAE,CAAC;CACjB,GAAG,WAAW,CA6Cd"}

package/dist/core/engine/context-pack.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildContextPack = buildContextPack;
+function buildContextPack(args) {
+    const failing = Object.entries(args.validatorResults).filter(([, r]) => !r.ok);
+    const issueFiles = [...new Set(args.issues.map((i) => i.file).filter(Boolean))];
+    if (args.tier !== "warning") {
+        return {
+            size: "full",
+            text: [
+                `# Context`,
+                ``,
+                `Task: ${args.taskId}`,
+                ``,
+                `## Validator summary`,
+                ...Object.entries(args.validatorResults).map(([id, r]) => `- ${id}: ${r.ok ? "OK" : "FAIL"} (exit=${r.exitCode ?? "?"})`),
+                ``,
+            ].join("\n"),
+        };
+    }
+    // Warning tier: include only failing validator output + referenced files list.
+    const shrunk = [
+        `# Context (WARNING: shrunk)`,
+        ``,
+        `Task: ${args.taskId}`,
+        ``,
+        `## Failing validators`,
+        ...(failing.length
+            ? failing.map(([id, r]) => {
+                const combined = [r.stdout, r.stderr].filter(Boolean).join("\n").trim();
+                return [
+                    `### ${id}`,
+                    combined ? "```" : "(no output)",
+                    ...(combined ? [combined.slice(0, 8000), "```"] : []),
+                    ``,
+                ].join("\n");
+            })
+            : ["(none)", ""]),
+        `## Issue files (hints)`,
+        ...(issueFiles.length ? issueFiles.map((f) => `- ${f}`) : ["(none)"]),
+        ``,
+    ].join("\n");
+    return { size: "warning_shrunk", text: shrunk };
+}
+//# sourceMappingURL=context-pack.js.map

package/dist/core/engine/context-pack.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-pack.js","sourceRoot":"","sources":["../../../src/core/engine/context-pack.ts"],"names":[],"mappings":";;AAOA,4CAkDC;AAlDD,SAAgB,gBAAgB,CAAC,IAKhC;IACC,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAC/E,MAAM,UAAU,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAa,CAAC;IAE5F,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC5B,OAAO;YACL,IAAI,EAAE,MAAM;YACZ,IAAI,EAAE;gBACJ,WAAW;gBACX,EAAE;gBACF,SAAS,IAAI,CAAC,MAAM,EAAE;gBACtB,EAAE;gBACF,sBAAsB;gBACtB,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,GAAG,CAC1C,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,UAAU,CAAC,CAAC,QAAQ,IAAI,GAAG,GAAG,CAC5E;gBACD,EAAE;aACH,CAAC,IAAI,CAAC,IAAI,CAAC;SACb,CAAC;IACJ,CAAC;IAED,+EAA+E;IAC/E,MAAM,MAAM,GAAG;QACb,6BAA6B;QAC7B,EAAE;QACF,SAAS,IAAI,CAAC,MAAM,EAAE;QACtB,EAAE;QACF,uBAAuB;QACvB,GAAG,CAAC,OAAO,CAAC,MAAM;YAChB,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE;gBACtB,MAAM,QAAQ,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;gBACxE,OAAO;oBACL,OAAO,EAAE,EAAE;oBACX,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,aAAa;oBAChC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;oBACrD,EAAE;iBACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACf,CAAC,CAAC;YACJ,CAAC,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QACnB,wBAAwB;QACxB,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;QACrE,EAAE;KACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEb,OAAO,EAAE,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;AAClD,CAAC"}

package/dist/core/engine/loop.d.ts

@@ -0,0 +1,28 @@
+import type { ProjectSpec } from "../spec/types";
+import type { CodingBackend } from "../backends/types";
+import type { WorkspaceManager } from "../workspace/manager";
+export type EngineOptions = {
+    repoRoot: string;
+    spec: ProjectSpec;
+    backend: CodingBackend;
+    workspace: WorkspaceManager;
+    taskId?: string;
+    dryRun: boolean;
+    json: boolean;
+};
+export type RunOutcome = {
+    ok: true;
+    runId: string;
+} | {
+    ok: false;
+    runId: string;
+    exitCode: number;
+    reason: string;
+};
+export declare class EngineLoop {
+    run(opts: EngineOptions): Promise<RunOutcome>;
+    private runOneTask;
+    private toTaskBudgetConfig;
+    private resolveValidators;
+}
+//# sourceMappingURL=loop.d.ts.map

package/dist/core/engine/loop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loop.d.ts","sourceRoot":"","sources":["../../../src/core/engine/loop.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAY,MAAM,eAAe,CAAC;AAI3D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAsB7D,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,EAAE,aAAa,CAAC;IACvB,SAAS,EAAE,gBAAgB,CAAC;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,EAAE,OAAO,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,UAAU,GAClB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC3B;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAQnE,qBAAa,UAAU;IACf,GAAG,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,UAAU,CAAC;YA0KrC,UAAU;IA4qBxB,OAAO,CAAC,kBAAkB;IAwB1B,OAAO,CAAC,iBAAiB;CAiB1B"}

package/dist/core/engine/loop.hardcap.test.d.ts

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

package/dist/core/engine/loop.hardcap.test.d.ts.map

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

package/dist/core/engine/loop.hardcap.test.js

@@ -0,0 +1,77 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const promises_1 = __importDefault(require("node:fs/promises"));
+const node_os_1 = __importDefault(require("node:os"));
+const node_path_1 = __importDefault(require("node:path"));
+const loop_1 = require("./loop");
+const noop_1 = require("../backends/noop");
+class MemoryWorkspace {
+    cwd;
+    mode = "patch";
+    constructor(cwd) {
+        this.cwd = cwd;
+    }
+    async prepare(taskId) {
+        return { taskId, workingDir: this.cwd };
+    }
+    getWorkingDir() {
+        return this.cwd;
+    }
+    async getChangedFiles() {
+        return [];
+    }
+    async enforceContract() {
+        return [];
+    }
+    async checkpoint() {
+        return { ref: "noop" };
+    }
+    async merge() { }
+    async revert() { }
+    async cleanup() { }
+}
+(0, vitest_1.describe)("EngineLoop hard cap blocking", () => {
+    (0, vitest_1.it)("blocks a task at hard cap without silent retries", async () => {
+        const tmp = await promises_1.default.mkdtemp(node_path_1.default.join(node_os_1.default.tmpdir(), "ralphy-loop-"));
+        await promises_1.default.mkdir(node_path_1.default.join(tmp, "openspec"), { recursive: true });
+        // Minimal openspec/project.yml is not required because we pass spec directly,
+        // but the persistence layer expects a repoRoot folder to exist.
+        const spec = {
+            version: "1.1",
+            project: { name: "tmp", repoRoot: "." },
+            defaults: { backend: "noop", workspaceMode: "patch", checkpointMode: "commit", validators: [] },
+            budgets: { limits: { commandTimeoutSeconds: 5 } },
+            validators: [
+                { id: "failfast", run: 'node -e "process.exit(1)"', timeoutSeconds: 5, parser: "jest" },
+            ],
+            tasks: [
+                {
+                    id: "t1",
+                    title: "Hard cap test",
+                    validators: ["failfast"],
+                    budget: { hard: { maxIterations: 1 } },
+                },
+            ],
+            artifacts: { enabled: false },
+        };
+        const engine = new loop_1.EngineLoop();
+        const outcome = await engine.run({
+            repoRoot: tmp,
+            spec,
+            backend: new noop_1.NoopBackend("noop"),
+            workspace: new MemoryWorkspace(tmp),
+            dryRun: false,
+            json: true,
+        });
+        (0, vitest_1.expect)(outcome.ok).toBe(false);
+        if (!outcome.ok) {
+            (0, vitest_1.expect)(outcome.exitCode).toBe(2);
+            (0, vitest_1.expect)(outcome.reason).toContain("Hard cap");
+        }
+    });
+});
+//# sourceMappingURL=loop.hardcap.test.js.map

package/dist/core/engine/loop.hardcap.test.js.map

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