openralph 1.0.12 → 1.0.13

package/README.md

@@ -97,15 +97,23 @@ ralph init --from plan.md          # convert unstructured plan to PRD JSON
 ### Init Subcommand
 
 ```bash
-ralph init                    # create template PRD and prompt
+ralph init                    # create template PRD, prompt, plugin, and AGENTS.md
 ralph init --from plan.md     # convert markdown plan to PRD JSON
 ralph init --force            # overwrite existing files
 ```
 
+The `init` command creates:
+- `prd.json` - PRD plan file (wrapped format with metadata)
+- `progress.txt` - Progress log
+- `.ralph-prompt.md` - Prompt template
+- `.opencode/plugin/ralph-write-guardrail.ts` - Write guardrail plugin
+- `AGENTS.md` - Project configuration for AI agents (never overwritten)
+- `.gitignore` entries - Adds Ralph runtime files to .gitignore
+
 | Option | Description |
 |--------|-------------|
 | `--from` | Source plan or notes to convert into PRD JSON |
-| `--force` | Overwrite existing files |
+| `--force` | Overwrite existing files (except AGENTS.md) |
 
 **Default prompt:**
 ```
@@ -150,6 +158,8 @@ Ralph supports multiple adapters for running the AI agent:
 | `.ralph-lock` | Prevents multiple instances |
 | `.ralph-done` | Agent creates this when all tasks complete |
 | `.ralph-pause` | Created by `p` key to pause loop |
+| `.opencode/plugin/ralph-write-guardrail.ts` | Protects files from AI modification |
+| `AGENTS.md` | Project configuration for AI agents |
 
 **Generated file markers:** Files created by `ralph init` include markers so `ralph --reset` can identify and remove them safely without touching user-created files:
 - `prd.json`: Wrapped with `{ metadata: { generated: true, ... }, items: [...] }`
@@ -243,6 +253,7 @@ Ralph writes operational learnings here. Future iterations read it.
 | `:` | Steering mode (send message to agent) |
 | `t` | Launch terminal with attach command |
 | `Shift+T` | Toggle tasks panel |
+| `Shift+C` | Toggle completed tasks / Copy attach command |
 | `o` | Toggle Details/Output view |
 | `d` | Toggle progress dashboard |
 | `?` | Show help overlay |

package/bin/ralph

@@ -8,6 +8,7 @@ import { fileURLToPath } from "node:url";
 
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 const require = createRequire(import.meta.url);
+const projectRoot = path.resolve(__dirname, "..");
 
 const platformMap = {
   darwin: "darwin",
@@ -26,18 +27,35 @@ const packageName = `openralph-${platform}-${arch}`;
 const binaryName = platform === "windows" ? "ralph.exe" : "ralph";
 
 let binaryPath;
-try {
-  const packageJsonPath = require.resolve(`${packageName}/package.json`);
-  const packageDir = path.dirname(packageJsonPath);
-  binaryPath = path.join(packageDir, "bin", binaryName);
-} catch (error) {
-  const message = error instanceof Error ? error.message : String(error);
-  console.error(`Failed to resolve ${packageName}: ${message}`);
-  process.exit(1);
+
+// First, check for locally built binary in dist/ directory
+const localBinaryPath = path.join(projectRoot, "dist", packageName, "bin", binaryName);
+if (fs.existsSync(localBinaryPath)) {
+  binaryPath = localBinaryPath;
+} else {
+  // Fall back to npm package resolution for installed packages
+  try {
+    const packageJsonPath = require.resolve(`${packageName}/package.json`);
+    const packageDir = path.dirname(packageJsonPath);
+    binaryPath = path.join(packageDir, "bin", binaryName);
+  } catch (error) {
+    // No local build and no npm package found
+    console.error(`Error: No ralph binary found for ${platform}-${arch}.`);
+    console.error("");
+    console.error("To fix this, run:");
+    console.error("  bun run build:single   # Build for current platform");
+    console.error("");
+    console.error("Or install globally:");
+    console.error("  bun install -g openralph");
+    process.exit(1);
+  }
 }
 
 if (!fs.existsSync(binaryPath)) {
-  console.error(`Binary not found at ${binaryPath}`);
+  console.error(`Error: Binary not found at ${binaryPath}`);
+  console.error("");
+  console.error("To fix this, run:");
+  console.error("  bun run build:single   # Rebuild for current platform");
   process.exit(1);
 }
 

package/package.json

@@ -1,16 +1,16 @@
 {
   "name": "openralph",
-  "version": "1.0.12",
+  "version": "1.0.13",
   "description": "Ralph Driven Development using OpenCode SDK and OpenTUI",
   "bin": {
     "ralph": "./bin/ralph"
   },
   "optionalDependencies": {
-    "openralph-darwin-arm64": "1.0.12",
-    "openralph-darwin-x64": "1.0.12",
-    "openralph-linux-arm64": "1.0.12",
-    "openralph-linux-x64": "1.0.12",
-    "openralph-windows-x64": "1.0.12"
+    "openralph-darwin-arm64": "1.0.13",
+    "openralph-darwin-x64": "1.0.13",
+    "openralph-linux-arm64": "1.0.13",
+    "openralph-linux-x64": "1.0.13",
+    "openralph-windows-x64": "1.0.13"
   },
   "repository": {
     "type": "git",