openralph 0.0.4 → 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,19 +1,16 @@
 {
   "name": "openralph",
-  "version": "0.0.4",
+  "version": "1.0.13",
   "description": "Ralph Driven Development using OpenCode SDK and OpenTUI",
   "bin": {
     "ralph": "./bin/ralph"
   },
-  "scripts": {
-    "postinstall": "node ./postinstall.mjs"
-  },
   "optionalDependencies": {
-    "openralph-darwin-arm64": "0.0.4",
-    "openralph-darwin-x64": "0.0.4",
-    "openralph-linux-arm64": "0.0.4",
-    "openralph-linux-x64": "0.0.4",
-    "openralph-windows-x64": "0.0.4"
+    "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",

package/postinstall.mjs

@@ -1,145 +0,0 @@
-#!/usr/bin/env node
-/**
- * Postinstall script for openralph
- *
- * This script runs after `bun install -g openralph` and symlinks the
- * platform-specific binary to the bin directory.
- *
- * On Windows, npm handles the .exe directly so we skip symlinking.
- */
-
-import fs from "fs";
-import path from "path";
-import os from "os";
-import { fileURLToPath } from "url";
-import { createRequire } from "module";
-
-const __dirname = path.dirname(fileURLToPath(import.meta.url));
-const require = createRequire(import.meta.url);
-
-/**
- * Detect the current platform and architecture
- */
-function detectPlatformAndArch() {
-  let platform;
-  switch (os.platform()) {
-    case "darwin":
-      platform = "darwin";
-      break;
-    case "linux":
-      platform = "linux";
-      break;
-    case "win32":
-      platform = "windows";
-      break;
-    default:
-      platform = os.platform();
-      break;
-  }
-
-  let arch;
-  switch (os.arch()) {
-    case "x64":
-      arch = "x64";
-      break;
-    case "arm64":
-      arch = "arm64";
-      break;
-    default:
-      arch = os.arch();
-      break;
-  }
-
-  return { platform, arch };
-}
-
-/**
- * Find the platform-specific binary package
- */
-function findBinary() {
-  const { platform, arch } = detectPlatformAndArch();
-  const packageName = `openralph-${platform}-${arch}`;
-  const binaryName = platform === "windows" ? "ralph.exe" : "ralph";
-
-  try {
-    // Use require.resolve to find the package
-    const packageJsonPath = require.resolve(`${packageName}/package.json`);
-    const packageDir = path.dirname(packageJsonPath);
-    const binaryPath = path.join(packageDir, "bin", binaryName);
-
-    if (!fs.existsSync(binaryPath)) {
-      throw new Error(`Binary not found at ${binaryPath}`);
-    }
-
-    return { binaryPath, binaryName, packageName };
-  } catch (error) {
-    throw new Error(`Could not find package ${packageName}: ${error.message}`);
-  }
-}
-
-/**
- * Prepare the bin directory and return paths
- */
-function prepareBinDirectory(binaryName) {
-  const binDir = path.join(__dirname, "bin");
-  const targetPath = path.join(binDir, binaryName);
-
-  // Ensure bin directory exists
-  if (!fs.existsSync(binDir)) {
-    fs.mkdirSync(binDir, { recursive: true });
-  }
-
-  // Remove existing binary/symlink if it exists
-  if (fs.existsSync(targetPath)) {
-    fs.unlinkSync(targetPath);
-  }
-
-  return { binDir, targetPath };
-}
-
-/**
- * Create symlink to the platform binary
- */
-function symlinkBinary(sourcePath, binaryName) {
-  const { targetPath } = prepareBinDirectory(binaryName);
-
-  fs.symlinkSync(sourcePath, targetPath);
-  console.log(`ralph binary symlinked: ${targetPath} -> ${sourcePath}`);
-
-  // Verify the file exists after operation
-  if (!fs.existsSync(targetPath)) {
-    throw new Error(`Failed to symlink binary to ${targetPath}`);
-  }
-}
-
-/**
- * Main function
- */
-async function main() {
-  try {
-    // On Windows, npm handles the .exe directly via the bin field
-    // No postinstall symlinking needed
-    if (os.platform() === "win32") {
-      console.log(
-        "Windows detected: binary setup not needed (using packaged .exe)"
-      );
-      return;
-    }
-
-    const { binaryPath, binaryName, packageName } = findBinary();
-    console.log(`Found ${packageName} at ${binaryPath}`);
-    symlinkBinary(binaryPath, binaryName);
-  } catch (error) {
-    console.error("Failed to setup ralph binary:", error.message);
-    // Don't fail the install - the JS launcher will handle finding the binary
-    process.exit(0);
-  }
-}
-
-try {
-  main();
-} catch (error) {
-  console.error("Postinstall script error:", error.message);
-  // Exit gracefully - don't break npm install
-  process.exit(0);
-}