ralphy-spec 0.2.0 → 0.3.1

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 (121) hide show
  1. package/CHANGELOG.md +37 -0
  2. package/README.ja.md +38 -15
  3. package/README.ko.md +38 -15
  4. package/README.md +47 -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/backends/cursor.d.ts.map +1 -1
  52. package/dist/core/backends/cursor.js +31 -8
  53. package/dist/core/backends/cursor.js.map +1 -1
  54. package/dist/core/budgets/errors.d.ts +5 -0
  55. package/dist/core/budgets/errors.d.ts.map +1 -0
  56. package/dist/core/budgets/errors.js +11 -0
  57. package/dist/core/budgets/errors.js.map +1 -0
  58. package/dist/core/engine/constraints.d.ts +16 -0
  59. package/dist/core/engine/constraints.d.ts.map +1 -0
  60. package/dist/core/engine/constraints.js +21 -0
  61. package/dist/core/engine/constraints.js.map +1 -0
  62. package/dist/core/engine/constraints.policy.test.d.ts +2 -0
  63. package/dist/core/engine/constraints.policy.test.d.ts.map +1 -0
  64. package/dist/core/engine/constraints.policy.test.js +85 -0
  65. package/dist/core/engine/constraints.policy.test.js.map +1 -0
  66. package/dist/core/engine/loop.d.ts.map +1 -1
  67. package/dist/core/engine/loop.hardcap.test.d.ts +2 -0
  68. package/dist/core/engine/loop.hardcap.test.d.ts.map +1 -0
  69. package/dist/core/engine/loop.hardcap.test.js +77 -0
  70. package/dist/core/engine/loop.hardcap.test.js.map +1 -0
  71. package/dist/core/engine/loop.js +511 -13
  72. package/dist/core/engine/loop.js.map +1 -1
  73. package/dist/core/memory/persistence.d.ts +9 -0
  74. package/dist/core/memory/persistence.d.ts.map +1 -1
  75. package/dist/core/memory/persistence.js +19 -1
  76. package/dist/core/memory/persistence.js.map +1 -1
  77. package/dist/core/reporting/failure-summary.d.ts +23 -0
  78. package/dist/core/reporting/failure-summary.d.ts.map +1 -0
  79. package/dist/core/reporting/failure-summary.js +63 -0
  80. package/dist/core/reporting/failure-summary.js.map +1 -0
  81. package/dist/core/reporting/failure-summary.test.d.ts +2 -0
  82. package/dist/core/reporting/failure-summary.test.d.ts.map +1 -0
  83. package/dist/core/reporting/failure-summary.test.js +22 -0
  84. package/dist/core/reporting/failure-summary.test.js.map +1 -0
  85. package/dist/core/spec/loader.d.ts.map +1 -1
  86. package/dist/core/spec/loader.js +12 -1
  87. package/dist/core/spec/loader.js.map +1 -1
  88. package/dist/core/spec/schemas.d.ts +857 -0
  89. package/dist/core/spec/schemas.d.ts.map +1 -1
  90. package/dist/core/spec/schemas.js +28 -0
  91. package/dist/core/spec/schemas.js.map +1 -1
  92. package/dist/core/spec/sprint-defaults.d.ts +16 -0
  93. package/dist/core/spec/sprint-defaults.d.ts.map +1 -0
  94. package/dist/core/spec/sprint-defaults.js +55 -0
  95. package/dist/core/spec/sprint-defaults.js.map +1 -0
  96. package/dist/core/spec/sprint-defaults.test.d.ts +2 -0
  97. package/dist/core/spec/sprint-defaults.test.d.ts.map +1 -0
  98. package/dist/core/spec/sprint-defaults.test.js +51 -0
  99. package/dist/core/spec/sprint-defaults.test.js.map +1 -0
  100. package/dist/core/spec/types.d.ts +11 -0
  101. package/dist/core/spec/types.d.ts.map +1 -1
  102. package/dist/core/validators/types.d.ts +1 -1
  103. package/dist/core/validators/types.d.ts.map +1 -1
  104. package/dist/core/workspace/scope-detector.d.ts +13 -0
  105. package/dist/core/workspace/scope-detector.d.ts.map +1 -0
  106. package/dist/core/workspace/scope-detector.js +34 -0
  107. package/dist/core/workspace/scope-detector.js.map +1 -0
  108. package/dist/core/workspace/worktree-mode.d.ts.map +1 -1
  109. package/dist/core/workspace/worktree-mode.js +2 -1
  110. package/dist/core/workspace/worktree-mode.js.map +1 -1
  111. package/dist/index.js +3 -1
  112. package/dist/index.js.map +1 -1
  113. package/dist/templates/claude-code/ralphy-archive.md +1 -1
  114. package/dist/templates/claude-code/ralphy-implement.md +1 -1
  115. package/dist/templates/claude-code/ralphy-plan.md +1 -1
  116. package/dist/templates/claude-code/ralphy-validate.md +1 -1
  117. package/dist/templates/cursor/ralphy-archive.md +1 -1
  118. package/dist/templates/cursor/ralphy-implement.md +1 -1
  119. package/dist/templates/cursor/ralphy-plan.md +1 -1
  120. package/dist/templates/cursor/ralphy-validate.md +1 -1
  121. package/package.json +7 -4
package/dist/cli/run.js CHANGED
@@ -7,18 +7,42 @@ exports.registerRunCommand = registerRunCommand;
7
7
  const node_path_1 = __importDefault(require("node:path"));
8
8
  const loader_1 = require("../core/spec/loader");
9
9
  const dag_1 = require("../core/spec/dag");
10
+ const claude_code_1 = require("../core/backends/claude-code");
11
+ const cursor_1 = require("../core/backends/cursor");
10
12
  const noop_1 = require("../core/backends/noop");
13
+ const opencode_1 = require("../core/backends/opencode");
11
14
  const patch_mode_1 = require("../core/workspace/patch-mode");
15
+ const worktree_mode_1 = require("../core/workspace/worktree-mode");
12
16
  const loop_1 = require("../core/engine/loop");
17
+ function createBackend(id) {
18
+ switch (id) {
19
+ case "cursor":
20
+ return new cursor_1.CursorBackend();
21
+ case "opencode":
22
+ return new opencode_1.OpenCodeBackend();
23
+ case "claude-code":
24
+ return new claude_code_1.ClaudeCodeBackend();
25
+ case "noop":
26
+ return new noop_1.NoopBackend("noop");
27
+ default:
28
+ // Fallback: treat as noop for unknown ids (but retain id for diagnostics).
29
+ return new noop_1.NoopBackend(id);
30
+ }
31
+ }
13
32
  function registerRunCommand(program) {
14
33
  program
15
34
  .command("run")
16
35
  .description("Execute the ralphy-spec engine loop")
17
- .option("--backend <id>", "Backend id: cursor|opencode|claude-code", "cursor")
18
- .option("--workspace <mode>", "Workspace mode: worktree|patch", "patch")
36
+ .option("--backend <id>", "Backend id: cursor|opencode|claude-code|noop")
37
+ .option("--workspace <mode>", "Workspace mode: worktree|patch")
38
+ .option("--artifact-dir <dir>", "Override artifact root directory (enables artifacts)")
19
39
  .option("--task <taskId>", "Run a single task (skips dependency checks)")
20
40
  .option("--dry-run", "Validate spec and print plan only", false)
21
41
  .option("--json", "Machine-readable output", false)
42
+ .addHelpText("after", `\nConcepts:\n` +
43
+ `- Budget tiers: optimal -> warning -> hard. WARNING enables degrade behaviors; HARD blocks the task.\n` +
44
+ `- Sprint sizing: XS/S/M/L/XL (optional per task via sprint.size).\n` +
45
+ `- Sprint intent: fix|feature|refactor|infra (optional per task via sprint.intent).\n`)
22
46
  .action(async (opts) => {
23
47
  const repoRoot = process.cwd();
24
48
  const loader = new loader_1.SpecLoader(repoRoot);
@@ -32,6 +56,16 @@ function registerRunCommand(program) {
32
56
  process.exitCode = 4;
33
57
  return;
34
58
  }
59
+ if (opts.artifactDir) {
60
+ spec = {
61
+ ...spec,
62
+ artifacts: {
63
+ ...(spec.artifacts ?? {}),
64
+ enabled: true,
65
+ rootDir: opts.artifactDir,
66
+ },
67
+ };
68
+ }
35
69
  // Always build DAG in run/dry-run to validate deps/cycles unless --task is used.
36
70
  try {
37
71
  if (!opts.task)
@@ -50,13 +84,12 @@ function registerRunCommand(program) {
50
84
  process.stdout.write(opts.json ? JSON.stringify(out, null, 2) + "\n" : `${plan.join("\n")}\n`);
51
85
  return;
52
86
  }
53
- if (opts.workspace === "worktree") {
54
- process.stderr.write(`Workspace mode "worktree" is not implemented in this MVP. Use --workspace patch.\n`);
55
- process.exitCode = 6;
56
- return;
57
- }
58
- const backend = new noop_1.NoopBackend(opts.backend);
59
- const workspace = new patch_mode_1.PatchModeWorkspace(node_path_1.default.resolve(repoRoot));
87
+ const backendId = opts.backend ?? spec.defaults.backend ?? "cursor";
88
+ const workspaceMode = opts.workspace ?? spec.defaults.workspaceMode ?? "patch";
89
+ const backend = createBackend(backendId);
90
+ const workspace = workspaceMode === "worktree"
91
+ ? new worktree_mode_1.WorktreeModeWorkspace(node_path_1.default.resolve(repoRoot))
92
+ : new patch_mode_1.PatchModeWorkspace(node_path_1.default.resolve(repoRoot));
60
93
  const engine = new loop_1.EngineLoop();
61
94
  const outcome = await engine.run({
62
95
  repoRoot,
@@ -1 +1 @@
1
- {"version":3,"file":"run.js","sourceRoot":"","sources":["../../src/cli/run.ts"],"names":[],"mappings":";;;;;AAQA,gDA+EC;AAtFD,0DAA6B;AAC7B,gDAAiD;AACjD,0CAAgD;AAChD,gDAAoD;AACpD,6DAAkE;AAClE,8CAAiD;AAEjD,SAAgB,kBAAkB,CAAC,OAAgB;IACjD,OAAO;SACJ,OAAO,CAAC,KAAK,CAAC;SACd,WAAW,CAAC,qCAAqC,CAAC;SAClD,MAAM,CAAC,gBAAgB,EAAE,yCAAyC,EAAE,QAAQ,CAAC;SAC7E,MAAM,CAAC,oBAAoB,EAAE,gCAAgC,EAAE,OAAO,CAAC;SACvE,MAAM,CAAC,iBAAiB,EAAE,6CAA6C,CAAC;SACxE,MAAM,CAAC,WAAW,EAAE,mCAAmC,EAAE,KAAK,CAAC;SAC/D,MAAM,CAAC,QAAQ,EAAE,yBAAyB,EAAE,KAAK,CAAC;SAClD,MAAM,CACL,KAAK,EAAE,IAMN,EAAE,EAAE;QACH,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;QAC/B,MAAM,MAAM,GAAG,IAAI,mBAAU,CAAC,QAAQ,CAAC,CAAC;QAExC,IAAI,IAAI,CAAC;QACT,IAAI,CAAC;YACH,IAAI,GAAG,MAAM,MAAM,CAAC,eAAe,EAAE,CAAC;QACxC,CAAC;QAAC,OAAO,CAAM,EAAE,CAAC;YAChB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;YACjE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAC3B,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;YACrB,OAAO;QACT,CAAC;QAED,iFAAiF;QACjF,IAAI,CAAC;YACH,IAAI,CAAC,IAAI,CAAC,IAAI;gBAAE,IAAA,kBAAY,EAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;QACjD,CAAC;QAAC,OAAO,CAAM,EAAE,CAAC;YAChB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;YACjE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAC3B,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;YACrB,OAAO;QACT,CAAC;QAED,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,MAAM,GAAG,GAAG,IAAA,kBAAY,EAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;YAC3C,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC;YACjD,MAAM,GAAG,GAAG,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;YAC7C,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC/F,OAAO;QACT,CAAC;QAED,IAAI,IAAI,CAAC,SAAS,KAAK,UAAU,EAAE,CAAC;YAClC,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,oFAAoF,CACrF,CAAC;YACF,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;YACrB,OAAO;QACT,CAAC;QAED,MAAM,OAAO,GAAG,IAAI,kBAAW,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC9C,MAAM,SAAS,GAAG,IAAI,+BAAkB,CAAC,mBAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;QAEjE,MAAM,MAAM,GAAG,IAAI,iBAAU,EAAE,CAAC;QAChC,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC;YAC/B,QAAQ;YACR,IAAI;YACJ,OAAO;YACP,SAAS;YACT,MAAM,EAAE,IAAI,CAAC,IAAI;YACjB,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,IAAI,CAAC,IAAI;SAChB,CAAC,CAAC;QAEH,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;QAChE,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,OAAO,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,SAAS,OAAO,CAAC,KAAK,KAAK,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,MAAM,IAAI,CAAC,CAAC;QACnI,CAAC;QAED,OAAO,CAAC,QAAQ,GAAG,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC;IACvD,CAAC,CACF,CAAC;AACN,CAAC"}
1
+ {"version":3,"file":"run.js","sourceRoot":"","sources":["../../src/cli/run.ts"],"names":[],"mappings":"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"}
@@ -1 +1 @@
1
- {"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/cli/status.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIzC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA2C5D"}
1
+ {"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/cli/status.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAQzC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA2E5D"}
@@ -4,8 +4,12 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
4
4
  };
5
5
  Object.defineProperty(exports, "__esModule", { value: true });
6
6
  exports.registerStatusCommand = registerStatusCommand;
7
+ const promises_1 = __importDefault(require("node:fs/promises"));
8
+ const node_path_1 = __importDefault(require("node:path"));
7
9
  const cli_table3_1 = __importDefault(require("cli-table3"));
8
10
  const persistence_1 = require("../core/memory/persistence");
11
+ const folders_1 = require("../core/folders");
12
+ const loader_1 = require("../core/spec/loader");
9
13
  function registerStatusCommand(program) {
10
14
  program
11
15
  .command("status")
@@ -13,6 +17,33 @@ function registerStatusCommand(program) {
13
17
  .option("--json", "Machine-readable output", false)
14
18
  .action(async (opts) => {
15
19
  const repoRoot = process.cwd();
20
+ // Artifact-first: if STATUS.md exists, display it as primary source of truth.
21
+ const candidateRoots = [];
22
+ try {
23
+ const spec = await new loader_1.SpecLoader(repoRoot).loadProjectSpec();
24
+ if (spec.artifacts?.rootDir)
25
+ candidateRoots.push(spec.artifacts.rootDir);
26
+ }
27
+ catch {
28
+ // ignore spec load failures
29
+ }
30
+ candidateRoots.push(undefined); // default
31
+ for (const rootDir of candidateRoots) {
32
+ const statusPath = node_path_1.default.join((0, folders_1.getRalphyRoot)(repoRoot, rootDir), folders_1.FILES.status);
33
+ try {
34
+ const statusMd = await promises_1.default.readFile(statusPath, "utf8");
35
+ if (opts.json) {
36
+ process.stdout.write(JSON.stringify({ ok: true, source: "artifact", statusPath, statusMarkdown: statusMd }, null, 2) + "\n");
37
+ }
38
+ else {
39
+ process.stdout.write(statusMd.trimEnd() + "\n");
40
+ }
41
+ return;
42
+ }
43
+ catch {
44
+ // try next candidate
45
+ }
46
+ }
16
47
  const persistence = await persistence_1.PersistenceLayer.openForRepo(repoRoot);
17
48
  try {
18
49
  const run = persistence.getLatestRun();
@@ -1 +1 @@
1
- {"version":3,"file":"status.js","sourceRoot":"","sources":["../../src/cli/status.ts"],"names":[],"mappings":";;;;;AAIA,sDA2CC;AA9CD,4DAA+B;AAC/B,4DAA8D;AAE9D,SAAgB,qBAAqB,CAAC,OAAgB;IACpD,OAAO;SACJ,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,qCAAqC,CAAC;SAClD,MAAM,CAAC,QAAQ,EAAE,yBAAyB,EAAE,KAAK,CAAC;SAClD,MAAM,CAAC,KAAK,EAAE,IAAuB,EAAE,EAAE;QACxC,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;QAC/B,MAAM,WAAW,GAAG,MAAM,8BAAgB,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;QACjE,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,WAAW,CAAC,YAAY,EAAE,CAAC;YACvC,IAAI,CAAC,GAAG,EAAE,CAAC;gBACT,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC;gBACtG,OAAO;YACT,CAAC;YAED,MAAM,MAAM,GAAG,WAAW,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;YAEvE,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;gBACd,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,IAAI,CAAC,SAAS,CACZ;oBACE,EAAE,EAAE,IAAI;oBACR,UAAU,EAAE,GAAG;oBACf,YAAY,EAAE,MAAM;iBACrB,EACD,IAAI,EACJ,CAAC,CACF,GAAG,IAAI,CACT,CAAC;gBACF,OAAO;YACT,CAAC;YAED,MAAM,KAAK,GAAG,IAAI,oBAAK,CAAC,EAAE,IAAI,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC;YACtD,KAAK,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,WAAW,EAAE,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC;YACvF,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,EAAE,GAAG,MAAM,CAAC,CAAC;YAChD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC;YACzC,KAAK,MAAM,EAAE,IAAI,MAAM,EAAE,CAAC;gBACxB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,IAAI,GAAG,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,OAAO,IAAI,CAAC,CAAC;YACtG,CAAC;QACH,CAAC;gBAAS,CAAC;YACT,WAAW,CAAC,KAAK,EAAE,CAAC;QACtB,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}
1
+ {"version":3,"file":"status.js","sourceRoot":"","sources":["../../src/cli/status.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,11 @@
1
+ export declare function writeBudgetReport(args: {
2
+ repoRoot: string;
3
+ rootDir?: string;
4
+ runId: string;
5
+ ledgerEvents: Array<{
6
+ taskId?: string;
7
+ kind: string;
8
+ data?: unknown;
9
+ }>;
10
+ }): Promise<void>;
11
+ //# sourceMappingURL=budget-writer.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"budget-writer.d.ts","sourceRoot":"","sources":["../../../src/core/artifacts/budget-writer.ts"],"names":[],"mappings":"AAKA,wBAAsB,iBAAiB,CAAC,IAAI,EAAE;IAC5C,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,KAAK,CAAC;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;CACxE,GAAG,OAAO,CAAC,IAAI,CAAC,CAkBhB"}
@@ -0,0 +1,28 @@
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
+ exports.writeBudgetReport = writeBudgetReport;
7
+ const promises_1 = __importDefault(require("node:fs/promises"));
8
+ const node_path_1 = __importDefault(require("node:path"));
9
+ const folders_1 = require("../folders");
10
+ const spend_1 = require("../reporting/spend");
11
+ async function writeBudgetReport(args) {
12
+ const root = await (0, folders_1.ensureRalphyFolders)(args.repoRoot, args.rootDir);
13
+ const filePath = node_path_1.default.join(root, folders_1.FILES.budget);
14
+ const breakdown = (0, spend_1.aggregateSpend)((0, spend_1.extractSpendFromLedger)(args.ledgerEvents));
15
+ const md = [
16
+ `# BUDGET`,
17
+ ``,
18
+ `- **runId**: \`${args.runId}\``,
19
+ `- **updatedAt**: ${new Date().toISOString()}`,
20
+ ``,
21
+ (0, spend_1.formatSpendReport)(breakdown),
22
+ ``,
23
+ `> Note: spend is best-effort and depends on backend emitting usage. Today, wallTime/iterations are tracked; USD/tokens may be 0 for some backends.`,
24
+ ``,
25
+ ].join("\n");
26
+ await promises_1.default.writeFile(filePath, md, "utf8");
27
+ }
28
+ //# sourceMappingURL=budget-writer.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"budget-writer.js","sourceRoot":"","sources":["../../../src/core/artifacts/budget-writer.ts"],"names":[],"mappings":";;;;;AAKA,8CAuBC;AA5BD,gEAAkC;AAClC,0DAA6B;AAC7B,wCAAwD;AACxD,8CAA+F;AAExF,KAAK,UAAU,iBAAiB,CAAC,IAKvC;IACC,MAAM,IAAI,GAAG,MAAM,IAAA,6BAAmB,EAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IACpE,MAAM,QAAQ,GAAG,mBAAI,CAAC,IAAI,CAAC,IAAI,EAAE,eAAK,CAAC,MAAM,CAAC,CAAC;IAE/C,MAAM,SAAS,GAAG,IAAA,sBAAc,EAAC,IAAA,8BAAsB,EAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC;IAC5E,MAAM,EAAE,GAAG;QACT,UAAU;QACV,EAAE;QACF,kBAAkB,IAAI,CAAC,KAAK,IAAI;QAChC,oBAAoB,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE;QAC9C,EAAE;QACF,IAAA,yBAAiB,EAAC,SAAS,CAAC;QAC5B,EAAE;QACF,oJAAoJ;QACpJ,EAAE;KACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEb,MAAM,kBAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,EAAE,EAAE,MAAM,CAAC,CAAC;AAC3C,CAAC"}
@@ -0,0 +1,20 @@
1
+ export declare function writeRunLogOnce(args: {
2
+ repoRoot: string;
3
+ rootDir?: string;
4
+ runId: string;
5
+ outcome: {
6
+ ok: boolean;
7
+ exitCode?: number;
8
+ reason?: string;
9
+ };
10
+ ledgerEvents: Array<{
11
+ ts: string;
12
+ kind: string;
13
+ message: string;
14
+ taskId?: string;
15
+ }>;
16
+ }): Promise<{
17
+ path: string;
18
+ created: boolean;
19
+ }>;
20
+ //# sourceMappingURL=run-log-writer.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"run-log-writer.d.ts","sourceRoot":"","sources":["../../../src/core/artifacts/run-log-writer.ts"],"names":[],"mappings":"AAIA,wBAAsB,eAAe,CAAC,IAAI,EAAE;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7D,YAAY,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACrF,GAAG,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC,CA+B9C"}
@@ -0,0 +1,40 @@
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
+ exports.writeRunLogOnce = writeRunLogOnce;
7
+ const promises_1 = __importDefault(require("node:fs/promises"));
8
+ const node_path_1 = __importDefault(require("node:path"));
9
+ const folders_1 = require("../folders");
10
+ async function writeRunLogOnce(args) {
11
+ const root = await (0, folders_1.ensureRalphyFolders)(args.repoRoot, args.rootDir);
12
+ const filePath = node_path_1.default.join(root, folders_1.FOLDERS.runs, `${args.runId}.md`);
13
+ const lines = [];
14
+ lines.push(`# Run log`);
15
+ lines.push(``);
16
+ lines.push(`- **runId**: \`${args.runId}\``);
17
+ lines.push(`- **status**: ${args.outcome.ok ? "success" : "stopped"}`);
18
+ if (!args.outcome.ok) {
19
+ lines.push(`- **exitCode**: ${args.outcome.exitCode ?? "?"}`);
20
+ lines.push(`- **reason**: ${args.outcome.reason ?? "unknown"}`);
21
+ }
22
+ lines.push(`- **createdAt**: ${new Date().toISOString()}`);
23
+ lines.push(``);
24
+ lines.push(`## Ledger (chronological)`);
25
+ lines.push(``);
26
+ for (const ev of args.ledgerEvents) {
27
+ lines.push(`- ${ev.ts} ${ev.kind}${ev.taskId ? ` [${ev.taskId}]` : ""}: ${ev.message}`);
28
+ }
29
+ lines.push(``);
30
+ try {
31
+ await promises_1.default.writeFile(filePath, lines.join("\n"), { encoding: "utf8", flag: "wx" });
32
+ return { path: filePath, created: true };
33
+ }
34
+ catch (e) {
35
+ if (e?.code === "EEXIST")
36
+ return { path: filePath, created: false };
37
+ throw e;
38
+ }
39
+ }
40
+ //# sourceMappingURL=run-log-writer.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"run-log-writer.js","sourceRoot":"","sources":["../../../src/core/artifacts/run-log-writer.ts"],"names":[],"mappings":";;;;;AAIA,0CAqCC;AAzCD,gEAAkC;AAClC,0DAA6B;AAC7B,wCAA0D;AAEnD,KAAK,UAAU,eAAe,CAAC,IAMrC;IACC,MAAM,IAAI,GAAG,MAAM,IAAA,6BAAmB,EAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IACpE,MAAM,QAAQ,GAAG,mBAAI,CAAC,IAAI,CAAC,IAAI,EAAE,iBAAO,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,KAAK,KAAK,CAAC,CAAC;IAEnE,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACxB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,kBAAkB,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC;IAC7C,KAAK,CAAC,IAAI,CAAC,iBAAiB,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC;IACvE,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,EAAE,CAAC;QACrB,KAAK,CAAC,IAAI,CAAC,mBAAmB,IAAI,CAAC,OAAO,CAAC,QAAQ,IAAI,GAAG,EAAE,CAAC,CAAC;QAC9D,KAAK,CAAC,IAAI,CAAC,iBAAiB,IAAI,CAAC,OAAO,CAAC,MAAM,IAAI,SAAS,EAAE,CAAC,CAAC;IAClE,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,oBAAoB,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;IAC3D,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;IACxC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;QACnC,KAAK,CAAC,IAAI,CACR,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,IAAI,GAAG,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,OAAO,EAAE,CAC5E,CAAC;IACJ,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,IAAI,CAAC;QACH,MAAM,kBAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QACjF,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC3C,CAAC;IAAC,OAAO,CAAM,EAAE,CAAC;QAChB,IAAI,CAAC,EAAE,IAAI,KAAK,QAAQ;YAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;QACpE,MAAM,CAAC,CAAC;IACV,CAAC;AACH,CAAC"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=run-log-writer.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"run-log-writer.test.d.ts","sourceRoot":"","sources":["../../../src/core/artifacts/run-log-writer.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,37 @@
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 run_log_writer_1 = require("./run-log-writer");
11
+ const folders_1 = require("../folders");
12
+ (0, vitest_1.describe)("writeRunLogOnce", () => {
13
+ (0, vitest_1.it)("creates the run log once and does not overwrite", async () => {
14
+ const repoRoot = await promises_1.default.mkdtemp(node_path_1.default.join(node_os_1.default.tmpdir(), "ralphy-runlog-"));
15
+ const runId = "run_test";
16
+ const first = await (0, run_log_writer_1.writeRunLogOnce)({
17
+ repoRoot,
18
+ runId,
19
+ outcome: { ok: true },
20
+ ledgerEvents: [{ ts: "t", kind: "run_started", message: "Run started" }],
21
+ });
22
+ const second = await (0, run_log_writer_1.writeRunLogOnce)({
23
+ repoRoot,
24
+ runId,
25
+ outcome: { ok: false, exitCode: 4, reason: "nope" },
26
+ ledgerEvents: [{ ts: "t2", kind: "run_error", message: "error" }],
27
+ });
28
+ (0, vitest_1.expect)(first.created).toBe(true);
29
+ (0, vitest_1.expect)(second.created).toBe(false);
30
+ const p = node_path_1.default.join((0, folders_1.getRalphyRoot)(repoRoot), folders_1.FOLDERS.runs, `${runId}.md`);
31
+ const md = await promises_1.default.readFile(p, "utf8");
32
+ (0, vitest_1.expect)(md).toContain("# Run log");
33
+ (0, vitest_1.expect)(md).toContain("run_started");
34
+ (0, vitest_1.expect)(md).not.toContain("run_error");
35
+ });
36
+ });
37
+ //# sourceMappingURL=run-log-writer.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"run-log-writer.test.js","sourceRoot":"","sources":["../../../src/core/artifacts/run-log-writer.test.ts"],"names":[],"mappings":";;;;;AAAA,mCAA8C;AAC9C,gEAAkC;AAClC,sDAAyB;AACzB,0DAA6B;AAC7B,qDAAmD;AACnD,wCAAoD;AAEpD,IAAA,iBAAQ,EAAC,iBAAiB,EAAE,GAAG,EAAE;IAC/B,IAAA,WAAE,EAAC,iDAAiD,EAAE,KAAK,IAAI,EAAE;QAC/D,MAAM,QAAQ,GAAG,MAAM,kBAAE,CAAC,OAAO,CAAC,mBAAI,CAAC,IAAI,CAAC,iBAAE,CAAC,MAAM,EAAE,EAAE,gBAAgB,CAAC,CAAC,CAAC;QAC5E,MAAM,KAAK,GAAG,UAAU,CAAC;QAEzB,MAAM,KAAK,GAAG,MAAM,IAAA,gCAAe,EAAC;YAClC,QAAQ;YACR,KAAK;YACL,OAAO,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE;YACrB,YAAY,EAAE,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,aAAa,EAAE,CAAC;SACzE,CAAC,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,IAAA,gCAAe,EAAC;YACnC,QAAQ;YACR,KAAK;YACL,OAAO,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE;YACnD,YAAY,EAAE,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;SAClE,CAAC,CAAC;QAEH,IAAA,eAAM,EAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjC,IAAA,eAAM,EAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAEnC,MAAM,CAAC,GAAG,mBAAI,CAAC,IAAI,CAAC,IAAA,uBAAa,EAAC,QAAQ,CAAC,EAAE,iBAAO,CAAC,IAAI,EAAE,GAAG,KAAK,KAAK,CAAC,CAAC;QAC1E,MAAM,EAAE,GAAG,MAAM,kBAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;QACxC,IAAA,eAAM,EAAC,EAAE,CAAC,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;QAClC,IAAA,eAAM,EAAC,EAAE,CAAC,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC;QACpC,IAAA,eAAM,EAAC,EAAE,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}
@@ -0,0 +1,16 @@
1
+ import type { BudgetStatus } from "../budgets/tiers";
2
+ export type StatusWriterInput = {
3
+ repoRoot: string;
4
+ rootDir?: string;
5
+ runId: string;
6
+ backendId?: string;
7
+ workspaceMode?: string;
8
+ phase: string;
9
+ taskId?: string;
10
+ iteration?: number;
11
+ message?: string;
12
+ tier?: "optimal" | "warning" | "hard";
13
+ budgetStatus?: BudgetStatus | null;
14
+ };
15
+ export declare function writeStatus(input: StatusWriterInput): Promise<void>;
16
+ //# sourceMappingURL=status-writer.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"status-writer.d.ts","sourceRoot":"","sources":["../../../src/core/artifacts/status-writer.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAErD,MAAM,MAAM,iBAAiB,GAAG;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,MAAM,CAAC;IACtC,YAAY,CAAC,EAAE,YAAY,GAAG,IAAI,CAAC;CACpC,CAAC;AAEF,wBAAsB,WAAW,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAwCzE"}
@@ -0,0 +1,52 @@
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
+ exports.writeStatus = writeStatus;
7
+ const promises_1 = __importDefault(require("node:fs/promises"));
8
+ const node_path_1 = __importDefault(require("node:path"));
9
+ const folders_1 = require("../folders");
10
+ async function writeStatus(input) {
11
+ const root = await (0, folders_1.ensureRalphyFolders)(input.repoRoot, input.rootDir);
12
+ const filePath = node_path_1.default.join(root, folders_1.FILES.status);
13
+ const lines = [];
14
+ lines.push(`# STATUS`);
15
+ lines.push(``);
16
+ lines.push(`- **runId**: \`${input.runId}\``);
17
+ if (input.backendId)
18
+ lines.push(`- **backend**: ${input.backendId}`);
19
+ if (input.workspaceMode)
20
+ lines.push(`- **workspace**: ${input.workspaceMode}`);
21
+ if (input.taskId)
22
+ lines.push(`- **taskId**: \`${input.taskId}\``);
23
+ lines.push(`- **phase**: ${input.phase}`);
24
+ if (typeof input.iteration === "number")
25
+ lines.push(`- **iteration**: ${input.iteration}`);
26
+ if (input.tier)
27
+ lines.push(`- **tier**: ${input.tier}`);
28
+ lines.push(`- **updatedAt**: ${new Date().toISOString()}`);
29
+ lines.push(``);
30
+ if (input.message) {
31
+ lines.push(`## Message`);
32
+ lines.push(``);
33
+ lines.push(input.message);
34
+ lines.push(``);
35
+ }
36
+ if (input.budgetStatus) {
37
+ const s = input.budgetStatus;
38
+ lines.push(`## Budget`);
39
+ lines.push(``);
40
+ lines.push(`- used: $${s.usedUsd.toFixed(4)}, ${s.usedTokens.toLocaleString()} tokens, ${s.usedIterations} iterations`);
41
+ lines.push(`- tier: ${s.tier}${s.isAtHardCap ? " (HARD CAP)" : ""}`);
42
+ lines.push(``);
43
+ }
44
+ lines.push(`## Files`);
45
+ lines.push(``);
46
+ lines.push(`- root: \`${(0, folders_1.getRalphyRoot)(input.repoRoot, input.rootDir)}\``);
47
+ lines.push(`- runs: \`runs/<runId>.md\` (immutable on completion)`);
48
+ lines.push(`- tasks: \`tasks/<taskId>/\` (CONTEXT.md / REPAIR.md / NOTES.md)`);
49
+ lines.push(``);
50
+ await promises_1.default.writeFile(filePath, lines.join("\n"), "utf8");
51
+ }
52
+ //# sourceMappingURL=status-writer.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"status-writer.js","sourceRoot":"","sources":["../../../src/core/artifacts/status-writer.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=status-writer.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"status-writer.test.d.ts","sourceRoot":"","sources":["../../../src/core/artifacts/status-writer.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,47 @@
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 status_writer_1 = require("./status-writer");
11
+ const folders_1 = require("../folders");
12
+ (0, vitest_1.describe)("writeStatus", () => {
13
+ (0, vitest_1.it)("includes backend/workspace and budget when provided", async () => {
14
+ const repoRoot = await promises_1.default.mkdtemp(node_path_1.default.join(node_os_1.default.tmpdir(), "ralphy-status-"));
15
+ await (0, status_writer_1.writeStatus)({
16
+ repoRoot,
17
+ runId: "run_1",
18
+ backendId: "noop",
19
+ workspaceMode: "patch",
20
+ phase: "EXEC",
21
+ taskId: "t1",
22
+ iteration: 2,
23
+ tier: "warning",
24
+ budgetStatus: {
25
+ tier: "warning",
26
+ usedUsd: 1.23,
27
+ usedTokens: 100,
28
+ usedTimeMs: 1000,
29
+ usedIterations: 2,
30
+ usdPctOfOptimal: null,
31
+ usdPctOfHard: null,
32
+ tokensPctOfOptimal: null,
33
+ tokensPctOfHard: null,
34
+ timePctOfOptimal: null,
35
+ timePctOfHard: null,
36
+ isInWarning: true,
37
+ isAtHardCap: false,
38
+ },
39
+ });
40
+ const p = node_path_1.default.join((0, folders_1.getRalphyRoot)(repoRoot), folders_1.FILES.status);
41
+ const md = await promises_1.default.readFile(p, "utf8");
42
+ (0, vitest_1.expect)(md).toContain("**backend**");
43
+ (0, vitest_1.expect)(md).toContain("**workspace**");
44
+ (0, vitest_1.expect)(md).toContain("## Budget");
45
+ });
46
+ });
47
+ //# sourceMappingURL=status-writer.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"status-writer.test.js","sourceRoot":"","sources":["../../../src/core/artifacts/status-writer.test.ts"],"names":[],"mappings":";;;;;AAAA,mCAA8C;AAC9C,gEAAkC;AAClC,sDAAyB;AACzB,0DAA6B;AAC7B,mDAA8C;AAC9C,wCAAkD;AAElD,IAAA,iBAAQ,EAAC,aAAa,EAAE,GAAG,EAAE;IAC3B,IAAA,WAAE,EAAC,qDAAqD,EAAE,KAAK,IAAI,EAAE;QACnE,MAAM,QAAQ,GAAG,MAAM,kBAAE,CAAC,OAAO,CAAC,mBAAI,CAAC,IAAI,CAAC,iBAAE,CAAC,MAAM,EAAE,EAAE,gBAAgB,CAAC,CAAC,CAAC;QAC5E,MAAM,IAAA,2BAAW,EAAC;YAChB,QAAQ;YACR,KAAK,EAAE,OAAO;YACd,SAAS,EAAE,MAAM;YACjB,aAAa,EAAE,OAAO;YACtB,KAAK,EAAE,MAAM;YACb,MAAM,EAAE,IAAI;YACZ,SAAS,EAAE,CAAC;YACZ,IAAI,EAAE,SAAS;YACf,YAAY,EAAE;gBACZ,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,IAAI;gBACb,UAAU,EAAE,GAAG;gBACf,UAAU,EAAE,IAAI;gBAChB,cAAc,EAAE,CAAC;gBACjB,eAAe,EAAE,IAAI;gBACrB,YAAY,EAAE,IAAI;gBAClB,kBAAkB,EAAE,IAAI;gBACxB,eAAe,EAAE,IAAI;gBACrB,gBAAgB,EAAE,IAAI;gBACtB,aAAa,EAAE,IAAI;gBACnB,WAAW,EAAE,IAAI;gBACjB,WAAW,EAAE,KAAK;aACnB;SACF,CAAC,CAAC;QAEH,MAAM,CAAC,GAAG,mBAAI,CAAC,IAAI,CAAC,IAAA,uBAAa,EAAC,QAAQ,CAAC,EAAE,eAAK,CAAC,MAAM,CAAC,CAAC;QAC3D,MAAM,EAAE,GAAG,MAAM,kBAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;QACxC,IAAA,eAAM,EAAC,EAAE,CAAC,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC;QACpC,IAAA,eAAM,EAAC,EAAE,CAAC,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC;QACtC,IAAA,eAAM,EAAC,EAAE,CAAC,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}
@@ -0,0 +1,19 @@
1
+ export declare function writeTaskContext(args: {
2
+ repoRoot: string;
3
+ rootDir?: string;
4
+ taskId: string;
5
+ markdown: string;
6
+ }): Promise<void>;
7
+ export declare function writeTaskRepair(args: {
8
+ repoRoot: string;
9
+ rootDir?: string;
10
+ taskId: string;
11
+ markdown: string;
12
+ }): Promise<void>;
13
+ export declare function appendTaskNotes(args: {
14
+ repoRoot: string;
15
+ rootDir?: string;
16
+ taskId: string;
17
+ note: string;
18
+ }): Promise<void>;
19
+ //# sourceMappingURL=task-artifacts.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"task-artifacts.d.ts","sourceRoot":"","sources":["../../../src/core/artifacts/task-artifacts.ts"],"names":[],"mappings":"AAeA,wBAAsB,gBAAgB,CAAC,IAAI,EAAE;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB,GAAG,OAAO,CAAC,IAAI,CAAC,CAGhB;AAED,wBAAsB,eAAe,CAAC,IAAI,EAAE;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB,GAAG,OAAO,CAAC,IAAI,CAAC,CAGhB;AAED,wBAAsB,eAAe,CAAC,IAAI,EAAE;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd,GAAG,OAAO,CAAC,IAAI,CAAC,CAKhB"}
@@ -0,0 +1,35 @@
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
+ exports.writeTaskContext = writeTaskContext;
7
+ exports.writeTaskRepair = writeTaskRepair;
8
+ exports.appendTaskNotes = appendTaskNotes;
9
+ const promises_1 = __importDefault(require("node:fs/promises"));
10
+ const node_path_1 = __importDefault(require("node:path"));
11
+ const folders_1 = require("../folders");
12
+ function safeTaskDirName(taskId) {
13
+ return taskId.replace(/[^a-zA-Z0-9-_]/g, "_");
14
+ }
15
+ async function ensureTaskDir(repoRoot, rootDir, taskId) {
16
+ const root = await (0, folders_1.ensureRalphyFolders)(repoRoot, rootDir);
17
+ const dir = node_path_1.default.join(root, folders_1.FOLDERS.tasks, safeTaskDirName(taskId));
18
+ await promises_1.default.mkdir(dir, { recursive: true });
19
+ return dir;
20
+ }
21
+ async function writeTaskContext(args) {
22
+ const dir = await ensureTaskDir(args.repoRoot, args.rootDir, args.taskId);
23
+ await promises_1.default.writeFile(node_path_1.default.join(dir, "CONTEXT.md"), args.markdown, "utf8");
24
+ }
25
+ async function writeTaskRepair(args) {
26
+ const dir = await ensureTaskDir(args.repoRoot, args.rootDir, args.taskId);
27
+ await promises_1.default.writeFile(node_path_1.default.join(dir, "REPAIR.md"), args.markdown, "utf8");
28
+ }
29
+ async function appendTaskNotes(args) {
30
+ const dir = await ensureTaskDir(args.repoRoot, args.rootDir, args.taskId);
31
+ const p = node_path_1.default.join(dir, "NOTES.md");
32
+ const line = `- ${new Date().toISOString()} ${args.note}\n`;
33
+ await promises_1.default.appendFile(p, line, "utf8").catch(async () => promises_1.default.writeFile(p, line, "utf8"));
34
+ }
35
+ //# sourceMappingURL=task-artifacts.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"task-artifacts.js","sourceRoot":"","sources":["../../../src/core/artifacts/task-artifacts.ts"],"names":[],"mappings":";;;;;AAeA,4CAQC;AAED,0CAQC;AAED,0CAUC;AA7CD,gEAAkC;AAClC,0DAA6B;AAC7B,wCAA0D;AAE1D,SAAS,eAAe,CAAC,MAAc;IACrC,OAAO,MAAM,CAAC,OAAO,CAAC,iBAAiB,EAAE,GAAG,CAAC,CAAC;AAChD,CAAC;AAED,KAAK,UAAU,aAAa,CAAC,QAAgB,EAAE,OAA2B,EAAE,MAAc;IACxF,MAAM,IAAI,GAAG,MAAM,IAAA,6BAAmB,EAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC1D,MAAM,GAAG,GAAG,mBAAI,CAAC,IAAI,CAAC,IAAI,EAAE,iBAAO,CAAC,KAAK,EAAE,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC;IACpE,MAAM,kBAAE,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACzC,OAAO,GAAG,CAAC;AACb,CAAC;AAEM,KAAK,UAAU,gBAAgB,CAAC,IAKtC;IACC,MAAM,GAAG,GAAG,MAAM,aAAa,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IAC1E,MAAM,kBAAE,CAAC,SAAS,CAAC,mBAAI,CAAC,IAAI,CAAC,GAAG,EAAE,YAAY,CAAC,EAAE,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;AAC1E,CAAC;AAEM,KAAK,UAAU,eAAe,CAAC,IAKrC;IACC,MAAM,GAAG,GAAG,MAAM,aAAa,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IAC1E,MAAM,kBAAE,CAAC,SAAS,CAAC,mBAAI,CAAC,IAAI,CAAC,GAAG,EAAE,WAAW,CAAC,EAAE,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;AACzE,CAAC;AAEM,KAAK,UAAU,eAAe,CAAC,IAKrC;IACC,MAAM,GAAG,GAAG,MAAM,aAAa,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IAC1E,MAAM,CAAC,GAAG,mBAAI,CAAC,IAAI,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;IACrC,MAAM,IAAI,GAAG,KAAK,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,IAAI,IAAI,CAAC,IAAI,IAAI,CAAC;IAC5D,MAAM,kBAAE,CAAC,UAAU,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC,kBAAE,CAAC,SAAS,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;AACxF,CAAC"}
@@ -0,0 +1,19 @@
1
+ import type { TaskSpec } from "../spec/types";
2
+ import type { TaskStatus } from "../memory/persistence";
3
+ export type StatusIconMode = "emoji" | "ascii" | "none";
4
+ export type TaskRow = {
5
+ taskId: string;
6
+ status: TaskStatus;
7
+ phase?: string;
8
+ iteration: number;
9
+ lastError?: string;
10
+ };
11
+ export declare function writeTasksBoard(args: {
12
+ repoRoot: string;
13
+ rootDir?: string;
14
+ runId: string;
15
+ statusIcons?: StatusIconMode;
16
+ specTasks: TaskSpec[];
17
+ rows: TaskRow[];
18
+ }): Promise<void>;
19
+ //# sourceMappingURL=tasks-writer.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tasks-writer.d.ts","sourceRoot":"","sources":["../../../src/core/artifacts/tasks-writer.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAGxD,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,CAAC;AAkBxD,MAAM,MAAM,OAAO,GAAG;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,UAAU,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,wBAAsB,eAAe,CAAC,IAAI,EAAE;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,cAAc,CAAC;IAC7B,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,IAAI,EAAE,OAAO,EAAE,CAAC;CACjB,GAAG,OAAO,CAAC,IAAI,CAAC,CA4ChB"}