ralphy-spec 0.2.0 → 0.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (118) hide show
  1. package/CHANGELOG.md +32 -0
  2. package/README.ja.md +38 -15
  3. package/README.ko.md +38 -15
  4. package/README.md +38 -15
  5. package/README.zh.md +38 -15
  6. package/dist/cli/budget.d.ts +3 -0
  7. package/dist/cli/budget.d.ts.map +1 -0
  8. package/dist/cli/budget.js +77 -0
  9. package/dist/cli/budget.js.map +1 -0
  10. package/dist/cli/init.d.ts.map +1 -1
  11. package/dist/cli/init.js +6 -0
  12. package/dist/cli/init.js.map +1 -1
  13. package/dist/cli/run.d.ts.map +1 -1
  14. package/dist/cli/run.js +42 -9
  15. package/dist/cli/run.js.map +1 -1
  16. package/dist/cli/status.d.ts.map +1 -1
  17. package/dist/cli/status.js +31 -0
  18. package/dist/cli/status.js.map +1 -1
  19. package/dist/core/artifacts/budget-writer.d.ts +11 -0
  20. package/dist/core/artifacts/budget-writer.d.ts.map +1 -0
  21. package/dist/core/artifacts/budget-writer.js +28 -0
  22. package/dist/core/artifacts/budget-writer.js.map +1 -0
  23. package/dist/core/artifacts/run-log-writer.d.ts +20 -0
  24. package/dist/core/artifacts/run-log-writer.d.ts.map +1 -0
  25. package/dist/core/artifacts/run-log-writer.js +40 -0
  26. package/dist/core/artifacts/run-log-writer.js.map +1 -0
  27. package/dist/core/artifacts/run-log-writer.test.d.ts +2 -0
  28. package/dist/core/artifacts/run-log-writer.test.d.ts.map +1 -0
  29. package/dist/core/artifacts/run-log-writer.test.js +37 -0
  30. package/dist/core/artifacts/run-log-writer.test.js.map +1 -0
  31. package/dist/core/artifacts/status-writer.d.ts +16 -0
  32. package/dist/core/artifacts/status-writer.d.ts.map +1 -0
  33. package/dist/core/artifacts/status-writer.js +52 -0
  34. package/dist/core/artifacts/status-writer.js.map +1 -0
  35. package/dist/core/artifacts/status-writer.test.d.ts +2 -0
  36. package/dist/core/artifacts/status-writer.test.d.ts.map +1 -0
  37. package/dist/core/artifacts/status-writer.test.js +47 -0
  38. package/dist/core/artifacts/status-writer.test.js.map +1 -0
  39. package/dist/core/artifacts/task-artifacts.d.ts +19 -0
  40. package/dist/core/artifacts/task-artifacts.d.ts.map +1 -0
  41. package/dist/core/artifacts/task-artifacts.js +35 -0
  42. package/dist/core/artifacts/task-artifacts.js.map +1 -0
  43. package/dist/core/artifacts/tasks-writer.d.ts +19 -0
  44. package/dist/core/artifacts/tasks-writer.d.ts.map +1 -0
  45. package/dist/core/artifacts/tasks-writer.js +67 -0
  46. package/dist/core/artifacts/tasks-writer.js.map +1 -0
  47. package/dist/core/artifacts/tasks-writer.test.d.ts +2 -0
  48. package/dist/core/artifacts/tasks-writer.test.d.ts.map +1 -0
  49. package/dist/core/artifacts/tasks-writer.test.js +28 -0
  50. package/dist/core/artifacts/tasks-writer.test.js.map +1 -0
  51. package/dist/core/budgets/errors.d.ts +5 -0
  52. package/dist/core/budgets/errors.d.ts.map +1 -0
  53. package/dist/core/budgets/errors.js +11 -0
  54. package/dist/core/budgets/errors.js.map +1 -0
  55. package/dist/core/engine/constraints.d.ts +16 -0
  56. package/dist/core/engine/constraints.d.ts.map +1 -0
  57. package/dist/core/engine/constraints.js +21 -0
  58. package/dist/core/engine/constraints.js.map +1 -0
  59. package/dist/core/engine/constraints.policy.test.d.ts +2 -0
  60. package/dist/core/engine/constraints.policy.test.d.ts.map +1 -0
  61. package/dist/core/engine/constraints.policy.test.js +85 -0
  62. package/dist/core/engine/constraints.policy.test.js.map +1 -0
  63. package/dist/core/engine/loop.d.ts.map +1 -1
  64. package/dist/core/engine/loop.hardcap.test.d.ts +2 -0
  65. package/dist/core/engine/loop.hardcap.test.d.ts.map +1 -0
  66. package/dist/core/engine/loop.hardcap.test.js +77 -0
  67. package/dist/core/engine/loop.hardcap.test.js.map +1 -0
  68. package/dist/core/engine/loop.js +511 -13
  69. package/dist/core/engine/loop.js.map +1 -1
  70. package/dist/core/memory/persistence.d.ts +9 -0
  71. package/dist/core/memory/persistence.d.ts.map +1 -1
  72. package/dist/core/memory/persistence.js +19 -1
  73. package/dist/core/memory/persistence.js.map +1 -1
  74. package/dist/core/reporting/failure-summary.d.ts +23 -0
  75. package/dist/core/reporting/failure-summary.d.ts.map +1 -0
  76. package/dist/core/reporting/failure-summary.js +63 -0
  77. package/dist/core/reporting/failure-summary.js.map +1 -0
  78. package/dist/core/reporting/failure-summary.test.d.ts +2 -0
  79. package/dist/core/reporting/failure-summary.test.d.ts.map +1 -0
  80. package/dist/core/reporting/failure-summary.test.js +22 -0
  81. package/dist/core/reporting/failure-summary.test.js.map +1 -0
  82. package/dist/core/spec/loader.d.ts.map +1 -1
  83. package/dist/core/spec/loader.js +12 -1
  84. package/dist/core/spec/loader.js.map +1 -1
  85. package/dist/core/spec/schemas.d.ts +857 -0
  86. package/dist/core/spec/schemas.d.ts.map +1 -1
  87. package/dist/core/spec/schemas.js +28 -0
  88. package/dist/core/spec/schemas.js.map +1 -1
  89. package/dist/core/spec/sprint-defaults.d.ts +16 -0
  90. package/dist/core/spec/sprint-defaults.d.ts.map +1 -0
  91. package/dist/core/spec/sprint-defaults.js +55 -0
  92. package/dist/core/spec/sprint-defaults.js.map +1 -0
  93. package/dist/core/spec/sprint-defaults.test.d.ts +2 -0
  94. package/dist/core/spec/sprint-defaults.test.d.ts.map +1 -0
  95. package/dist/core/spec/sprint-defaults.test.js +51 -0
  96. package/dist/core/spec/sprint-defaults.test.js.map +1 -0
  97. package/dist/core/spec/types.d.ts +11 -0
  98. package/dist/core/spec/types.d.ts.map +1 -1
  99. package/dist/core/validators/types.d.ts +1 -1
  100. package/dist/core/validators/types.d.ts.map +1 -1
  101. package/dist/core/workspace/scope-detector.d.ts +13 -0
  102. package/dist/core/workspace/scope-detector.d.ts.map +1 -0
  103. package/dist/core/workspace/scope-detector.js +34 -0
  104. package/dist/core/workspace/scope-detector.js.map +1 -0
  105. package/dist/core/workspace/worktree-mode.d.ts.map +1 -1
  106. package/dist/core/workspace/worktree-mode.js +2 -1
  107. package/dist/core/workspace/worktree-mode.js.map +1 -1
  108. package/dist/index.js +3 -1
  109. package/dist/index.js.map +1 -1
  110. package/dist/templates/claude-code/ralphy-archive.md +1 -1
  111. package/dist/templates/claude-code/ralphy-implement.md +1 -1
  112. package/dist/templates/claude-code/ralphy-plan.md +1 -1
  113. package/dist/templates/claude-code/ralphy-validate.md +1 -1
  114. package/dist/templates/cursor/ralphy-archive.md +1 -1
  115. package/dist/templates/cursor/ralphy-implement.md +1 -1
  116. package/dist/templates/cursor/ralphy-plan.md +1 -1
  117. package/dist/templates/cursor/ralphy-validate.md +1 -1
  118. package/package.json +7 -4
@@ -0,0 +1,11 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.BudgetExhaustedError = void 0;
4
+ class BudgetExhaustedError extends Error {
5
+ name = "BudgetExhaustedError";
6
+ constructor(message) {
7
+ super(message);
8
+ }
9
+ }
10
+ exports.BudgetExhaustedError = BudgetExhaustedError;
11
+ //# sourceMappingURL=errors.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/core/budgets/errors.ts"],"names":[],"mappings":";;;AAAA,MAAa,oBAAqB,SAAQ,KAAK;IACpC,IAAI,GAAG,sBAAsB,CAAC;IACvC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;IACjB,CAAC;CACF;AALD,oDAKC"}
@@ -0,0 +1,16 @@
1
+ import type { TaskSpec } from "../spec/types";
2
+ export type ConstraintViolation = {
3
+ kind: "scope_violation";
4
+ level: "error";
5
+ message: string;
6
+ file?: string;
7
+ raw?: unknown;
8
+ };
9
+ export declare function enforceSprintConstraints(args: {
10
+ task: TaskSpec;
11
+ changedFiles: Array<{
12
+ file: string;
13
+ isNew: boolean;
14
+ }>;
15
+ }): ConstraintViolation[];
16
+ //# sourceMappingURL=constraints.d.ts.map
@@ -0,0 +1 @@
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"}
@@ -0,0 +1,21 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.enforceSprintConstraints = enforceSprintConstraints;
4
+ function enforceSprintConstraints(args) {
5
+ const size = args.task.sprint?.size;
6
+ if (!size)
7
+ return [];
8
+ const newFiles = args.changedFiles.filter((f) => f.isNew);
9
+ const violations = [];
10
+ const maxNew = size === "XS" ? 0 : size === "S" ? 0 : size === "M" ? 2 : size === "L" ? 10 : Infinity;
11
+ if (newFiles.length > maxNew) {
12
+ violations.push({
13
+ kind: "scope_violation",
14
+ level: "error",
15
+ message: `Sprint size ${size} allows at most ${maxNew} new files, but found ${newFiles.length}.`,
16
+ raw: { size, maxNew, newFiles },
17
+ });
18
+ }
19
+ return violations;
20
+ }
21
+ //# sourceMappingURL=constraints.js.map
@@ -0,0 +1 @@
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"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=constraints.policy.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"constraints.policy.test.d.ts","sourceRoot":"","sources":["../../../src/core/engine/constraints.policy.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,85 @@
1
+ "use strict";
2
+ var __importDefault = (this && this.__importDefault) || function (mod) {
3
+ return (mod && mod.__esModule) ? mod : { "default": mod };
4
+ };
5
+ Object.defineProperty(exports, "__esModule", { value: true });
6
+ const vitest_1 = require("vitest");
7
+ const promises_1 = __importDefault(require("node:fs/promises"));
8
+ const node_os_1 = __importDefault(require("node:os"));
9
+ const node_path_1 = __importDefault(require("node:path"));
10
+ const loop_1 = require("./loop");
11
+ const noop_1 = require("../backends/noop");
12
+ class ScopeWorkspace {
13
+ cwd;
14
+ mode = "patch";
15
+ constructor(cwd) {
16
+ this.cwd = cwd;
17
+ }
18
+ async prepare(taskId) {
19
+ return { taskId, workingDir: this.cwd };
20
+ }
21
+ getWorkingDir() {
22
+ return this.cwd;
23
+ }
24
+ async getChangedFiles() {
25
+ // Pretend the backend changed an unrelated file.
26
+ return [{ file: "unrelated.txt", isNew: true }];
27
+ }
28
+ async enforceContract() {
29
+ return [];
30
+ }
31
+ async checkpoint() {
32
+ return { ref: "noop" };
33
+ }
34
+ async merge() { }
35
+ async revert() { }
36
+ async cleanup() { }
37
+ }
38
+ (0, vitest_1.describe)("scope guard policy", () => {
39
+ (0, vitest_1.it)("does not block when scopeGuard=warn", async () => {
40
+ const tmp = await promises_1.default.mkdtemp(node_path_1.default.join(node_os_1.default.tmpdir(), "ralphy-scope-"));
41
+ const spec = {
42
+ version: "1.1",
43
+ project: { name: "tmp", repoRoot: "." },
44
+ defaults: { backend: "noop", workspaceMode: "patch", checkpointMode: "commit", validators: [] },
45
+ policies: { scopeGuard: "warn" },
46
+ budgets: { limits: { commandTimeoutSeconds: 5 } },
47
+ validators: [],
48
+ tasks: [{ id: "t1", sprint: { size: "XS", intent: "fix" } }],
49
+ artifacts: { enabled: false },
50
+ };
51
+ const outcome = await new loop_1.EngineLoop().run({
52
+ repoRoot: tmp,
53
+ spec,
54
+ backend: new noop_1.NoopBackend("noop"),
55
+ workspace: new ScopeWorkspace(tmp),
56
+ dryRun: false,
57
+ json: true,
58
+ });
59
+ // With warn, the scope violation is a warning and should not fail the run by itself.
60
+ (0, vitest_1.expect)(outcome.ok).toBe(true);
61
+ });
62
+ (0, vitest_1.it)("blocks when scopeGuard=block", async () => {
63
+ const tmp = await promises_1.default.mkdtemp(node_path_1.default.join(node_os_1.default.tmpdir(), "ralphy-scope-"));
64
+ const spec = {
65
+ version: "1.1",
66
+ project: { name: "tmp", repoRoot: "." },
67
+ defaults: { backend: "noop", workspaceMode: "patch", checkpointMode: "commit", validators: [] },
68
+ policies: { scopeGuard: "block" },
69
+ budgets: { limits: { commandTimeoutSeconds: 5 } },
70
+ validators: [],
71
+ tasks: [{ id: "t1", sprint: { size: "XS", intent: "fix" } }],
72
+ artifacts: { enabled: false },
73
+ };
74
+ const outcome = await new loop_1.EngineLoop().run({
75
+ repoRoot: tmp,
76
+ spec,
77
+ backend: new noop_1.NoopBackend("noop"),
78
+ workspace: new ScopeWorkspace(tmp),
79
+ dryRun: false,
80
+ json: true,
81
+ });
82
+ (0, vitest_1.expect)(outcome.ok).toBe(false);
83
+ });
84
+ });
85
+ //# sourceMappingURL=constraints.policy.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"constraints.policy.test.js","sourceRoot":"","sources":["../../../src/core/engine/constraints.policy.test.ts"],"names":[],"mappings":"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"}
@@ -1 +1 @@
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;AAW7D,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;YA8FrC,UAAU;IAsQxB,OAAO,CAAC,kBAAkB;IAwB1B,OAAO,CAAC,iBAAiB;CAiB1B"}
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"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=loop.hardcap.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"loop.hardcap.test.d.ts","sourceRoot":"","sources":["../../../src/core/engine/loop.hardcap.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,77 @@
1
+ "use strict";
2
+ var __importDefault = (this && this.__importDefault) || function (mod) {
3
+ return (mod && mod.__esModule) ? mod : { "default": mod };
4
+ };
5
+ Object.defineProperty(exports, "__esModule", { value: true });
6
+ const vitest_1 = require("vitest");
7
+ const promises_1 = __importDefault(require("node:fs/promises"));
8
+ const node_os_1 = __importDefault(require("node:os"));
9
+ const node_path_1 = __importDefault(require("node:path"));
10
+ const loop_1 = require("./loop");
11
+ const noop_1 = require("../backends/noop");
12
+ class MemoryWorkspace {
13
+ cwd;
14
+ mode = "patch";
15
+ constructor(cwd) {
16
+ this.cwd = cwd;
17
+ }
18
+ async prepare(taskId) {
19
+ return { taskId, workingDir: this.cwd };
20
+ }
21
+ getWorkingDir() {
22
+ return this.cwd;
23
+ }
24
+ async getChangedFiles() {
25
+ return [];
26
+ }
27
+ async enforceContract() {
28
+ return [];
29
+ }
30
+ async checkpoint() {
31
+ return { ref: "noop" };
32
+ }
33
+ async merge() { }
34
+ async revert() { }
35
+ async cleanup() { }
36
+ }
37
+ (0, vitest_1.describe)("EngineLoop hard cap blocking", () => {
38
+ (0, vitest_1.it)("blocks a task at hard cap without silent retries", async () => {
39
+ const tmp = await promises_1.default.mkdtemp(node_path_1.default.join(node_os_1.default.tmpdir(), "ralphy-loop-"));
40
+ await promises_1.default.mkdir(node_path_1.default.join(tmp, "openspec"), { recursive: true });
41
+ // Minimal openspec/project.yml is not required because we pass spec directly,
42
+ // but the persistence layer expects a repoRoot folder to exist.
43
+ const spec = {
44
+ version: "1.1",
45
+ project: { name: "tmp", repoRoot: "." },
46
+ defaults: { backend: "noop", workspaceMode: "patch", checkpointMode: "commit", validators: [] },
47
+ budgets: { limits: { commandTimeoutSeconds: 5 } },
48
+ validators: [
49
+ { id: "failfast", run: 'node -e "process.exit(1)"', timeoutSeconds: 5, parser: "jest" },
50
+ ],
51
+ tasks: [
52
+ {
53
+ id: "t1",
54
+ title: "Hard cap test",
55
+ validators: ["failfast"],
56
+ budget: { hard: { maxIterations: 1 } },
57
+ },
58
+ ],
59
+ artifacts: { enabled: false },
60
+ };
61
+ const engine = new loop_1.EngineLoop();
62
+ const outcome = await engine.run({
63
+ repoRoot: tmp,
64
+ spec,
65
+ backend: new noop_1.NoopBackend("noop"),
66
+ workspace: new MemoryWorkspace(tmp),
67
+ dryRun: false,
68
+ json: true,
69
+ });
70
+ (0, vitest_1.expect)(outcome.ok).toBe(false);
71
+ if (!outcome.ok) {
72
+ (0, vitest_1.expect)(outcome.exitCode).toBe(2);
73
+ (0, vitest_1.expect)(outcome.reason).toContain("Hard cap");
74
+ }
75
+ });
76
+ });
77
+ //# sourceMappingURL=loop.hardcap.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"loop.hardcap.test.js","sourceRoot":"","sources":["../../../src/core/engine/loop.hardcap.test.ts"],"names":[],"mappings":"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"}