spec-and-loop 2.0.0-rc.1 → 2.0.0

package/lib/mini-ralph/invoker.js

@@ -12,7 +12,6 @@
  */
 
 const { spawn, execFileSync } = require('child_process');
-const path = require('path');
 
 /**
  * Invoke OpenCode with the given prompt and return a result object.
@@ -22,7 +21,7 @@ const path = require('path');
  * @param {string} [opts.model]     - Optional model override
  * @param {boolean} [opts.noCommit] - Skip git commit if true
  * @param {boolean} [opts.verbose]  - Enable verbose output
- * @param {string}  opts.ralphDir   - .ralph/ directory (used for temp prompt file)
+ * @param {string}  [opts.ralphDir] - Reserved for caller compatibility
  * @returns {Promise<{stdout: string, exitCode: number, toolUsage: Array, filesChanged: Array}>}
  */
 async function invoke(opts) {
@@ -31,52 +30,47 @@ async function invoke(opts) {
     model,
     noCommit = false,
     verbose = false,
-    ralphDir,
   } = opts;
 
-  // Write the prompt to a temp file to avoid shell escaping issues
-  const fs = require('fs');
-  const os = require('os');
-  const tmpPromptFile = path.join(
-    os.tmpdir(),
-    `ralph-prompt-${Date.now()}-${process.pid}.md`
-  );
+  if (!prompt || !prompt.trim()) {
+    throw new Error('mini-ralph invoker: prompt is empty');
+  }
 
-  try {
-    fs.writeFileSync(tmpPromptFile, prompt, 'utf8');
+  const args = ['run'];
+  if (model) {
+    args.push('--model', model);
+  }
+  args.push(prompt);
 
-    const args = ['--print', tmpPromptFile];
-    if (model) {
-      args.push('--model', model);
-    }
+  if (verbose) {
+    process.stderr.write(
+      `[mini-ralph] invoking: opencode ${args.slice(0, -1).join(' ')} <prompt>\n`
+    );
+  }
 
-    if (verbose) {
-      process.stderr.write(`[mini-ralph] invoking: opencode ${args.join(' ')}\n`);
-    }
+  // Snapshot git-tracked files before invocation for file-change detection
+  const preSnapshot = _gitSnapshot();
 
-    // Snapshot git-tracked files before invocation for file-change detection
-    const preSnapshot = _gitSnapshot();
-
-    const result = await _spawnOpenCode(args, verbose);
-
-    // Detect which files changed during this iteration
-    const postSnapshot = _gitSnapshot();
-    const filesChanged = _diffSnapshots(preSnapshot, postSnapshot);
-
-    return {
-      stdout: result.stdout,
-      exitCode: result.exitCode,
-      toolUsage: _extractToolUsage(result.stdout),
-      filesChanged,
-    };
-  } finally {
-    // Clean up temp prompt file
-    try {
-      fs.unlinkSync(tmpPromptFile);
-    } catch {
-      // ignore cleanup errors
-    }
+  const result = await _spawnOpenCode(args, verbose);
+  const combinedOutput = [result.stdout, result.stderr].filter(Boolean).join('\n');
+
+  if (_looksLikeCliHelp(combinedOutput)) {
+    throw new Error(
+      'mini-ralph invoker: opencode printed CLI help instead of running the prompt. ' +
+      'The installed opencode CLI is likely incompatible with this version of spec-and-loop.'
+    );
   }
+
+  // Detect which files changed during this iteration
+  const postSnapshot = _gitSnapshot();
+  const filesChanged = _diffSnapshots(preSnapshot, postSnapshot);
+
+  return {
+    stdout: result.stdout,
+    exitCode: result.exitCode,
+    toolUsage: _extractToolUsage(result.stdout),
+    filesChanged,
+  };
 }
 
 /**
@@ -122,6 +116,25 @@ function _spawnOpenCode(args, verbose) {
   });
 }
 
+/**
+ * Detect whether OpenCode printed its CLI help banner instead of executing the
+ * requested prompt. This usually means the invocation contract drifted.
+ *
+ * @param {string} text
+ * @returns {boolean}
+ */
+function _looksLikeCliHelp(text) {
+  if (!text) return false;
+
+  const hasHelpSections = text.includes('Commands:') && text.includes('Options:');
+  const hasOpenCodeUsage =
+    text.includes('opencode [project]') ||
+    text.includes('opencode run [message..]') ||
+    text.includes('run opencode with a message');
+
+  return hasHelpSections && hasOpenCodeUsage;
+}
+
 /**
  * Extract a compact tool usage summary from OpenCode output.
  * Returns an array of { tool, count } objects.
@@ -202,4 +215,11 @@ function _diffSnapshots(preSnapshot, postSnapshot) {
   return changed;
 }
 
-module.exports = { invoke, _spawnOpenCode, _extractToolUsage, _gitSnapshot, _diffSnapshots };
+module.exports = {
+  invoke,
+  _spawnOpenCode,
+  _looksLikeCliHelp,
+  _extractToolUsage,
+  _gitSnapshot,
+  _diffSnapshots,
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "spec-and-loop",
-  "version": "2.0.0-rc.1",
+  "version": "2.0.0",
   "description": "OpenSpec + Ralph Loop integration for iterative development with opencode",
   "main": "index.js",
   "bin": {