spec-and-loop 3.0.3 → 3.3.0

package/lib/mini-ralph/history.js

@@ -52,6 +52,10 @@ function read(ralphDir) {
  * @param {Array}  entry.toolUsage         - Tool usage summary array
  * @param {Array}  entry.filesChanged      - Files changed in this iteration
  * @param {number} entry.exitCode          - OpenCode exit code
+ * @param {boolean} [entry.blockedHandoffDetected] - Whether the iteration emitted
+ *   the configured blocked-handoff promise and stopped for operator action.
+ * @param {string}  [entry.blockedHandoffNote] - Compact, single-line preview of
+ *   the extracted blocker note. The full note is persisted in HANDOFF.md.
  * @param {number} [entry.promptBytes]     - UTF-8 byte length of the assembled prompt
  * @param {number} [entry.promptChars]     - Character length of the assembled prompt
  * @param {number} [entry.promptTokens]    - Estimated token count for the prompt (chars/4, rounded)

package/lib/mini-ralph/index.js

@@ -35,6 +35,7 @@ const prompt = require('./prompt');
  * @param {number} [options.maxIterations]   - Maximum iterations (default: 50)
  * @param {string} [options.completionPromise] - Promise string signaling loop completion (default: "COMPLETE")
  * @param {string} [options.taskPromise]     - Promise string signaling task completion (default: "READY_FOR_NEXT_TASK")
+ * @param {string} [options.blockedHandoffPromise] - Promise string signaling the agent is blocked and requesting human handoff (default: "BLOCKED_HANDOFF")
  * @param {boolean} [options.tasksMode]      - Enable tasks mode (default: false)
  * @param {string} [options.tasksFile]       - Path to tasks file when tasksMode is true
  * @param {boolean} [options.noCommit]       - Suppress auto-commit (default: false)

package/lib/mini-ralph/prompt.js

@@ -20,7 +20,6 @@
  *                            errors ("no prompt source configured", "prompt file
  *                            not found", "prompt file is empty") do not fire.
  *   {{tasks}}              - Raw tasks file content
- *   {{task_context}}       - Fresh current-task and completed-task summary
  *   {{task_promise}}       - Configured task promise string
  *   {{completion_promise}} - Configured completion promise string
  *   {{commit_contract}}    - Commit instructions derived from options.noCommit
@@ -37,7 +36,6 @@
 
 const fs = require('fs');
 const path = require('path');
-const tasks = require('./tasks');
 
 // One-time fallback notice flag for invalid RALPH_BASE_PROMPT_WARN_BYTES
 let _warnBytesInvalidNoticed = false;
@@ -159,15 +157,12 @@ function render(options, iteration) {
     tasksContent = fs.readFileSync(options.tasksFile, 'utf8');
   }
 
-  const taskContext = options.tasksFile ? tasks.taskContext(options.tasksFile) : '';
-
   const vars = {
     iteration: String(iteration),
     max_iterations: String(options.maxIterations || 50),
     change_dir: options.changeDir || '',
     base_prompt: base,
     tasks: tasksContent,
-    task_context: taskContext,
     task_promise: options.taskPromise || 'READY_FOR_NEXT_TASK',
     completion_promise: options.completionPromise || 'COMPLETE',
     commit_contract: options.noCommit