@neriros/ralphy 0.1.0 → 0.2.0

package/dist/cli/index.js

@@ -38382,8 +38382,8 @@ var require_cjs = __commonJS((exports, module) => {
 });
 
 // apps/cli/src/index.ts
-import { resolve as resolve3, join as join13 } from "path";
-import { existsSync as existsSync6 } from "fs";
+import { resolve as resolve3, join as join14 } from "path";
+import { existsSync as existsSync7 } from "fs";
 
 // node_modules/.bun/ink@5.2.1+1f88f629f0141b18/node_modules/ink/build/render.js
 import { Stream } from "stream";
@@ -43760,7 +43760,7 @@ var import_react58 = __toESM(require_react(), 1);
 
 // apps/cli/src/cli.ts
 import { readFileSync as readFileSync2 } from "fs";
-var VALID_MODES = new Set(["task", "list", "status", "advance", "set-phase"]);
+var VALID_MODES = new Set(["task", "list", "status", "advance", "set-phase", "init"]);
 var VALID_MODELS = new Set(["haiku", "sonnet", "opus"]);
 function parseArgs(argv) {
   const result2 = {
@@ -44137,13 +44137,29 @@ function scaffoldTasksDir(tasksDir) {
   }
 }
 
+// packages/core/src/init.ts
+import { mkdirSync as mkdirSync2, existsSync as existsSync4, writeFileSync as writeFileSync2 } from "fs";
+import { join as join3, dirname as dirname3 } from "path";
+var GITIGNORE_CONTENT = `tasks/
+`;
+function initRalph(ralphDir) {
+  mkdirSync2(join3(ralphDir, "tasks"), { recursive: true });
+  const gitignorePath = join3(ralphDir, ".gitignore");
+  if (!existsSync4(gitignorePath)) {
+    writeFileSync2(gitignorePath, GITIGNORE_CONTENT);
+  }
+}
+function initRalphFromTasksDir(tasksDir) {
+  initRalph(dirname3(tasksDir));
+}
+
 // apps/cli/src/components/App.tsx
 var import_react57 = __toESM(require_react(), 1);
-import { join as join12 } from "path";
-import { existsSync as existsSync5, mkdirSync as mkdirSync2 } from "fs";
+import { join as join13 } from "path";
+import { existsSync as existsSync6, mkdirSync as mkdirSync3 } from "fs";
 
 // packages/core/src/state.ts
-import { join as join3 } from "path";
+import { join as join4 } from "path";
 import { execSync } from "child_process";
 
 // node_modules/.bun/zod@3.25.76/node_modules/zod/v3/external.js
@@ -48252,14 +48268,14 @@ function formatTaskName(name) {
 // packages/core/src/state.ts
 var STATE_FILE = "state.json";
 function readState(taskDir) {
-  const filePath = join3(taskDir, STATE_FILE);
+  const filePath = join4(taskDir, STATE_FILE);
   const raw = getStorage().read(filePath);
   if (raw === null)
     throw new Error(`state.json not found in ${taskDir}`);
   return StateSchema.parse(JSON.parse(raw));
 }
 function writeState(taskDir, state) {
-  const filePath = join3(taskDir, STATE_FILE);
+  const filePath = join4(taskDir, STATE_FILE);
   getStorage().write(filePath, JSON.stringify(state, null, 2) + `
 `);
 }
@@ -48288,10 +48304,10 @@ function buildInitialState(opts) {
 }
 function inferPhaseFromFiles(taskDir) {
   const storage = getStorage();
-  if (storage.read(join3(taskDir, "RESEARCH.md")) === null)
+  if (storage.read(join4(taskDir, "RESEARCH.md")) === null)
     return getFirstPhase().name;
-  const plan = storage.read(join3(taskDir, "PLAN.md"));
-  const progress = storage.read(join3(taskDir, "PROGRESS.md"));
+  const plan = storage.read(join4(taskDir, "PLAN.md"));
+  const progress = storage.read(join4(taskDir, "PROGRESS.md"));
   if (plan === null || progress === null)
     return "plan";
   const unchecked = (progress.match(/^- \[ \]/gm) ?? []).length;
@@ -48305,12 +48321,12 @@ function migrateState(taskDir) {
   return state;
 }
 function ensureState(taskDir) {
-  const filePath = join3(taskDir, STATE_FILE);
+  const filePath = join4(taskDir, STATE_FILE);
   const storage = getStorage();
   if (storage.read(filePath) !== null) {
     return readState(taskDir);
   }
-  const hasFiles = storage.read(join3(taskDir, "RESEARCH.md")) !== null || storage.read(join3(taskDir, "PLAN.md")) !== null || storage.read(join3(taskDir, "PROGRESS.md")) !== null;
+  const hasFiles = storage.read(join4(taskDir, "RESEARCH.md")) !== null || storage.read(join4(taskDir, "PLAN.md")) !== null || storage.read(join4(taskDir, "PROGRESS.md")) !== null;
   if (hasFiles) {
     return migrateState(taskDir);
   }
@@ -48321,7 +48337,7 @@ function ensureState(taskDir) {
 }
 
 // packages/core/src/phases.ts
-import { join as join4 } from "path";
+import { join as join5 } from "path";
 
 // packages/core/src/progress.ts
 function extractCurrentSection(content) {
@@ -48392,7 +48408,7 @@ function advancePhase(state, taskDir) {
     throw new Error("Task is already done. Nothing to advance.");
   }
   if (config.loopBack) {
-    const progress = storage.read(join4(taskDir, "PROGRESS.md")) ?? "";
+    const progress = storage.read(join5(taskDir, "PROGRESS.md")) ?? "";
     const hasIssues = /\u26A0\uFE0F/.test(progress);
     if (hasIssues) {
       return recordPhaseTransition(state, current, config.loopBack, "issues found -> loop back");
@@ -48416,19 +48432,19 @@ function advancePhase(state, taskDir) {
   }
   const nextConfig = getPhase(nextName);
   for (const file of nextConfig.requires) {
-    if (storage.read(join4(taskDir, file)) === null) {
+    if (storage.read(join5(taskDir, file)) === null) {
       throw new Error(`Cannot advance to ${nextName} \u2014 ${file} does not exist yet`);
     }
   }
   if (nextName === "exec" && current === "plan") {
-    let progressContent = storage.read(join4(taskDir, "PROGRESS.md"));
+    let progressContent = storage.read(join5(taskDir, "PROGRESS.md"));
     if (progressContent !== null) {
       const { unchecked } = countProgress(progressContent);
       if (unchecked === 0) {
         throw new Error("Cannot advance to exec \u2014 PROGRESS.md has no unchecked items");
       }
       progressContent = appendChecklists(progressContent);
-      storage.write(join4(taskDir, "PROGRESS.md"), progressContent);
+      storage.write(join5(taskDir, "PROGRESS.md"), progressContent);
     }
   }
   return recordPhaseTransition(state, current, nextName);
@@ -48442,7 +48458,7 @@ function setPhase(state, taskDir, targetPhase) {
 function autoTransitionAfterIteration(state, taskDir) {
   const config = getPhase(state.phase);
   const storage = getStorage();
-  const progress = storage.read(join4(taskDir, "PROGRESS.md"));
+  const progress = storage.read(join5(taskDir, "PROGRESS.md"));
   if (progress === null)
     return state;
   if (config.loopBack) {
@@ -48493,7 +48509,7 @@ function appendChecklists(progress) {
   const sectionMatches = progress.match(/^## Section \d+/gm);
   let nextSection = (sectionMatches?.length ?? 0) + 1;
   for (const name of names) {
-    const raw = storage.read(join4(dir, `${name}.md`));
+    const raw = storage.read(join5(dir, `${name}.md`));
     if (raw === null)
       continue;
     const h1Match = raw.match(/^# (.+)\n/);
@@ -48511,7 +48527,7 @@ ${body.trimEnd()}
 
 // packages/core/src/git.ts
 import { execSync as execSync2 } from "child_process";
-import { join as join5 } from "path";
+import { join as join6 } from "path";
 function getCurrentBranch() {
   try {
     return execSync2("git branch --show-current", { encoding: "utf-8" }).trim();
@@ -48544,7 +48560,7 @@ function gitPush() {
   }
 }
 function commitState(taskDir, message) {
-  const stateFile = join5(taskDir, "state.json");
+  const stateFile = join6(taskDir, "state.json");
   try {
     gitAdd([stateFile]);
     gitCommit(`docs(ralph): ${message}`);
@@ -48559,14 +48575,14 @@ function commitTaskDir(taskDir, message) {
 
 // apps/cli/src/components/TaskList.tsx
 var import_react22 = __toESM(require_react(), 1);
-import { join as join6 } from "path";
+import { join as join7 } from "path";
 var jsx_dev_runtime = __toESM(require_jsx_dev_runtime(), 1);
 function buildRows(tasksDir) {
   const storage = getStorage();
   const entries = storage.list(tasksDir);
   const rows = [];
   for (const entry of entries) {
-    const raw = storage.read(join6(tasksDir, entry, "state.json"));
+    const raw = storage.read(join7(tasksDir, entry, "state.json"));
     if (raw === null)
       continue;
     let state;
@@ -48582,7 +48598,7 @@ function buildRows(tasksDir) {
 `).find((l) => l.trim() !== "") ?? "";
     let progress = "\u2014";
     let progressStyled = true;
-    const progressContent = storage.read(join6(tasksDir, entry, "PROGRESS.md"));
+    const progressContent = storage.read(join7(tasksDir, entry, "PROGRESS.md"));
     if (progressContent !== null) {
       const { checked, unchecked } = countProgress(progressContent);
       const total = checked + unchecked;
@@ -48709,7 +48725,7 @@ function TaskList({ tasksDir }) {
 }
 
 // apps/cli/src/components/TaskStatus.tsx
-import { join as join7 } from "path";
+import { join as join8 } from "path";
 var jsx_dev_runtime2 = __toESM(require_jsx_dev_runtime(), 1);
 var HEAVY_RULE = "============================================";
 var LIGHT_RULE = "--------------------------------------------";
@@ -48719,9 +48735,9 @@ function TaskStatus({ state, taskDir }) {
   const time = Math.round(state.usage.total_duration_ms / 1000 * 10) / 10 + "s";
   const documents = getStatusDocuments().map((doc) => ({
     name: doc.name,
-    exists: storage.read(join7(taskDir, doc.name)) !== null
+    exists: storage.read(join8(taskDir, doc.name)) !== null
   }));
-  const progressContent = storage.read(join7(taskDir, "PROGRESS.md"));
+  const progressContent = storage.read(join8(taskDir, "PROGRESS.md"));
   const progress = progressContent !== null ? countProgress(progressContent) : null;
   const recent = state.history.slice(-10);
   return /* @__PURE__ */ jsx_dev_runtime2.jsxDEV(Box_default, {
@@ -48889,7 +48905,7 @@ function TaskStatus({ state, taskDir }) {
 
 // apps/cli/src/components/TaskLoop.tsx
 var import_react56 = __toESM(require_react(), 1);
-import { join as join11 } from "path";
+import { join as join12 } from "path";
 
 // apps/cli/src/components/Banner.tsx
 var jsx_dev_runtime3 = __toESM(require_jsx_dev_runtime(), 1);
@@ -52365,15 +52381,15 @@ function StopMessage({
 
 // apps/cli/src/hooks/useLoop.ts
 var import_react55 = __toESM(require_react(), 1);
-import { join as join10 } from "path";
+import { join as join11 } from "path";
 
 // packages/engine/src/spawn.ts
 var {spawn: bunSpawn } = globalThis.Bun;
 var spawn = bunSpawn;
 
 // packages/engine/src/engine.ts
-import { writeFileSync as writeFileSync2, unlinkSync as unlinkSync2, existsSync as existsSync4, mkdtempSync } from "fs";
-import { join as join8 } from "path";
+import { writeFileSync as writeFileSync3, unlinkSync as unlinkSync2, existsSync as existsSync5, mkdtempSync } from "fs";
+import { join as join9 } from "path";
 import { tmpdir } from "os";
 
 // packages/output/src/output.ts
@@ -53129,8 +53145,8 @@ function buildCodexArgs() {
   return ["exec", "--json", "--color", "never", "--dangerously-bypass-approvals-and-sandbox", "-"];
 }
 async function runInteractive(model, prompt, taskDir) {
-  const promptFile = taskDir ? join8(taskDir, "_interactive_prompt.md") : join8(mkdtempSync(join8(tmpdir(), "ralph-")), "prompt.md");
-  writeFileSync2(promptFile, prompt);
+  const promptFile = taskDir ? join9(taskDir, "_interactive_prompt.md") : join9(mkdtempSync(join9(tmpdir(), "ralph-")), "prompt.md");
+  writeFileSync3(promptFile, prompt);
   try {
     const cmd = [
       "claude",
@@ -53155,8 +53171,8 @@ async function runInteractive(model, prompt, taskDir) {
       stderr: "inherit"
     });
     const exitCode = await proc.exited;
-    const doneFile = taskDir ? join8(taskDir, "_interactive_done") : null;
-    if (doneFile && existsSync4(doneFile)) {
+    const doneFile = taskDir ? join9(taskDir, "_interactive_done") : null;
+    if (doneFile && existsSync5(doneFile)) {
       return { exitCode: 0, usage: null };
     }
     return { exitCode, usage: null };
@@ -53255,14 +53271,14 @@ async function runEngine(opts) {
 }
 
 // apps/cli/src/loop.ts
-import { join as join9 } from "path";
+import { join as join10 } from "path";
 function buildTaskPrompt(state, taskDir) {
   const phaseConfig = getPhase(state.phase);
   let prompt = "";
   const storage = getStorage();
   for (const doc of getPromptDocuments(state.phase)) {
     const injection = doc.promptInjection;
-    const content = storage.read(join9(taskDir, doc.name));
+    const content = storage.read(join10(taskDir, doc.name));
     if (content === null)
       continue;
     if (injection.filterHeaders) {
@@ -53302,7 +53318,7 @@ function buildTaskPrompt(state, taskDir) {
   for (const entry of phaseConfig.context) {
     switch (entry.type) {
       case "file": {
-        const content = storage.read(join9(taskDir, entry.file));
+        const content = storage.read(join10(taskDir, entry.file));
         if (content !== null) {
           prompt += `
 ---
@@ -53315,7 +53331,7 @@ function buildTaskPrompt(state, taskDir) {
         break;
       }
       case "currentSection": {
-        const progressContent = storage.read(join9(taskDir, "PROGRESS.md"));
+        const progressContent = storage.read(join10(taskDir, "PROGRESS.md"));
         if (progressContent !== null) {
           const section = extractCurrentSection(progressContent);
           if (section) {
@@ -53367,7 +53383,7 @@ function buildTemplateVars(state, taskDir) {
 }
 function checkStopSignal(taskDir) {
   const storage = getStorage();
-  const stopFile = join9(taskDir, "STOP");
+  const stopFile = join10(taskDir, "STOP");
   const reason = storage.read(stopFile);
   if (reason === null)
     return null;
@@ -53478,10 +53494,10 @@ function useLoop(opts) {
       setLogLines((prev) => [...prev, { id: nextId(), kind: "feed", event }]);
     };
     runWithContext(createDefaultContext(), async () => {
-      const taskDir = join10(opts.tasksDir, opts.name);
+      const taskDir = join11(opts.tasksDir, opts.name);
       const storage = getStorage();
       let currentState;
-      const existingState = storage.read(join10(taskDir, "state.json"));
+      const existingState = storage.read(join11(taskDir, "state.json"));
       if (existingState !== null) {
         currentState = readState(taskDir);
         if (currentState.engine !== opts.engine || currentState.model !== opts.model) {
@@ -53519,7 +53535,7 @@ function useLoop(opts) {
         const time = new Date().toLocaleTimeString("en-US", { hour12: false });
         addIterationHeader(iter, time);
         addInfo(`Phase: ${currentState.phase} (iteration ${currentState.phaseIteration})`);
-        const progressContent = storage.read(join10(taskDir, "PROGRESS.md"));
+        const progressContent = storage.read(join11(taskDir, "PROGRESS.md"));
         if (progressContent !== null) {
           const section = extractCurrentSection(progressContent);
           if (section) {
@@ -53534,7 +53550,7 @@ function useLoop(opts) {
         const prompt = buildTaskPrompt(currentState, taskDir);
         const iterStart = new Date().toISOString();
         try {
-          const interactiveDone = storage.read(join10(taskDir, "_interactive_done")) !== null;
+          const interactiveDone = storage.read(join11(taskDir, "_interactive_done")) !== null;
           const isInteractivePhase = opts.interactive && currentState.phase === "research" && !interactiveDone;
           const engineResult = await runEngine({
             engine: opts.engine,
@@ -53585,8 +53601,8 @@ function useLoop(opts) {
           break;
         }
       }
-      storage.remove(join10(taskDir, "_interactive_done"));
-      const finalProgressContent = storage.read(join10(taskDir, "PROGRESS.md"));
+      storage.remove(join11(taskDir, "_interactive_done"));
+      const finalProgressContent = storage.read(join11(taskDir, "PROGRESS.md"));
       if (finalProgressContent !== null) {
         setProgress(countProgress(finalProgressContent));
       }
@@ -53677,7 +53693,7 @@ function TaskLoop({ opts }) {
   }, [loop.isRunning, exit]);
   if (!loop.state)
     return null;
-  const taskDir = join11(opts.tasksDir, opts.name);
+  const taskDir = join12(opts.tasksDir, opts.name);
   return /* @__PURE__ */ jsx_dev_runtime8.jsxDEV(Box_default, {
     flexDirection: "column",
     children: [
@@ -53777,8 +53793,8 @@ function App2({ args, tasksDir }) {
           message: "Error: --name is required for status mode"
         }, undefined, false, undefined, this);
       }
-      const taskDir = join12(tasksDir, args.name);
-      if (!existsSync5(join12(taskDir, "state.json"))) {
+      const taskDir = join13(tasksDir, args.name);
+      if (!existsSync6(join13(taskDir, "state.json"))) {
         return /* @__PURE__ */ jsx_dev_runtime9.jsxDEV(ErrorMessage, {
           message: `Error: task '${args.name}' not found`
         }, undefined, false, undefined, this);
@@ -53797,7 +53813,7 @@ function App2({ args, tasksDir }) {
           message: "Error: --name is required for advance mode"
         }, undefined, false, undefined, this);
       }
-      const taskDir = join12(tasksDir, args.name);
+      const taskDir = join13(tasksDir, args.name);
       const state = ensureState(taskDir);
       const updated = advancePhase(state, taskDir);
       writeState(taskDir, updated);
@@ -53819,7 +53835,7 @@ function App2({ args, tasksDir }) {
           message: "Error: --phase is required for set-phase mode"
         }, undefined, false, undefined, this);
       }
-      const taskDir = join12(tasksDir, args.name);
+      const taskDir = join13(tasksDir, args.name);
       const state = ensureState(taskDir);
       const updated = setPhase(state, taskDir, args.phase);
       return /* @__PURE__ */ jsx_dev_runtime9.jsxDEV(ExitAfterRender, {
@@ -53828,13 +53844,20 @@ function App2({ args, tasksDir }) {
         }, undefined, false, undefined, this)
       }, undefined, false, undefined, this);
     }
+    case "init":
+      return /* @__PURE__ */ jsx_dev_runtime9.jsxDEV(ExitAfterRender, {
+        children: /* @__PURE__ */ jsx_dev_runtime9.jsxDEV(Text, {
+          color: "green",
+          children: "Initialized .ralph directory"
+        }, undefined, false, undefined, this)
+      }, undefined, false, undefined, this);
     case "task": {
       if (!args.name) {
         return /* @__PURE__ */ jsx_dev_runtime9.jsxDEV(ErrorMessage, {
           message: "Error: --name is required for task mode"
         }, undefined, false, undefined, this);
       }
-      mkdirSync2(join12(tasksDir, args.name), { recursive: true });
+      mkdirSync3(join13(tasksDir, args.name), { recursive: true });
       return /* @__PURE__ */ jsx_dev_runtime9.jsxDEV(TaskLoop, {
         opts: {
           name: args.name,
@@ -53861,17 +53884,18 @@ function App2({ args, tasksDir }) {
 function resolveTasksDir2() {
   let dir = process.cwd();
   while (dir !== "/") {
-    const candidate = join13(dir, ".ralph", "tasks");
-    if (existsSync6(candidate))
+    const candidate = join14(dir, ".ralph", "tasks");
+    if (existsSync7(candidate))
       return candidate;
     dir = resolve3(dir, "..");
   }
-  return join13(process.cwd(), ".ralph", "tasks");
+  return join14(process.cwd(), ".ralph", "tasks");
 }
 try {
   const args = parseArgs(process.argv.slice(2));
   const tasksDir = resolveTasksDir2();
   runWithContext(createDefaultContext(), () => {
+    initRalphFromTasksDir(tasksDir);
     scaffoldTasksDir(tasksDir);
     render_default(import_react58.createElement(App2, { args, tasksDir }));
   });

package/package.json

@@ -1,32 +1,31 @@
 {
   "name": "@neriros/ralphy",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "An iterative AI task execution framework. Orchestrates multi-phase autonomous work using Claude or Codex engines.",
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/neriros/ralphy.git"
-  },
   "keywords": [
+    "agent",
     "ai",
-    "cli",
     "claude",
-    "task-runner",
+    "cli",
+    "loop",
     "mcp",
-    "agent",
     "ralph",
-    "loop"
+    "task-runner"
   ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/neriros/ralphy.git"
+  },
+  "bin": {
+    "ralphy": "./dist/cli/index.js",
+    "ralphy-mcp": "./dist/mcp/index.js"
+  },
   "workspaces": [
     "packages/*",
     "apps/*",
     "tools/generators/*"
   ],
-  "type": "module",
-  "bin": {
-    "ralphy": "./dist/cli/index.js",
-    "ralphy-mcp": "./dist/mcp/index.js"
-  },
   "files": [
     "dist/cli/index.js",
     "dist/mcp/index.js",
@@ -35,9 +34,7 @@
     "dist/scaffolds/",
     "README.md"
   ],
-  "engines": {
-    "bun": ">=1.0.0"
-  },
+  "type": "module",
   "scripts": {
     "ralph": "bun .ralph/bin/cli.js",
     "lint": "oxlint --config .oxlintrc.json .",
@@ -84,5 +81,8 @@
     "secretlint": "^11.3.1",
     "typescript": "^5.8.0",
     "zod": "^3.24.0"
+  },
+  "engines": {
+    "bun": ">=1.0.0"
   }
 }