@felixthemangy/ralph-loop 0.1.0

package/README.md

@@ -0,0 +1,70 @@
+# ralph
+
+> The runtime that replaces you as the person who prompts the agent.
+
+`ralph` reads your `RALPH.md` task file and gives agents their next brief — so you don't have to copy-paste it yourself.
+
+## Install
+
+```sh
+npm install -g ralph-loop
+```
+
+## Quick start
+
+```sh
+ralph init          # scaffold a RALPH.md in the current repo
+ralph status        # show ACTIVE / NEXT / DONE
+ralph next          # print the first unblocked task brief
+ralph done <id>     # move a task to DONE and print the next brief
+ralph brief <id>    # print a specific task's brief without marking it done
+```
+
+## RALPH.md format
+
+```markdown
+## ACTIVE
+
+*(none)*
+
+---
+
+## NEXT
+
+#### task-id — Task title
+**Brief:** What the agent should do.
+**Blocked by:** nothing
+
+#### another-task — Another task
+**Brief:** What the agent should do.
+**Blocked by:** task-id
+
+---
+
+## DONE
+
+| Task ID | Title | Completed |
+|---------|-------|-----------|
+```
+
+- Tasks under `## NEXT` are `####` headings with a `**Brief:**` and `**Blocked by:**` line.
+- A task is blocked if `**Blocked by:**` is anything other than `nothing` (case-insensitive).
+- `ralph next` returns the first unblocked task.
+- `ralph done <id>` removes the task from NEXT and appends a row to the DONE table.
+- `ralph` walks up from the current directory to find `RALPH.md`, so you can run it from any subdirectory of the repo.
+
+## Multi-agent loop
+
+```sh
+# Agent calls this at the start of each session
+ralph next
+
+# Agent calls this when work is complete
+ralph done <task-id>
+```
+
+No human needed in the loop — `ralph done` automatically prints the next brief so the agent can immediately continue.
+
+## License
+
+MIT

package/dist/commands/brief.d.ts

@@ -0,0 +1,2 @@
+export declare function cmdBrief(taskId: string): void;
+//# sourceMappingURL=brief.d.ts.map

package/dist/commands/brief.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brief.d.ts","sourceRoot":"","sources":["../../src/commands/brief.ts"],"names":[],"mappings":"AAIA,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAiB7C"}

package/dist/commands/brief.js

@@ -0,0 +1,19 @@
+import chalk from 'chalk';
+import { findRalphFile, readRalph, findTaskById } from '../parser.js';
+import { printTaskBrief } from './next.js';
+export function cmdBrief(taskId) {
+    const filePath = findRalphFile();
+    if (!filePath) {
+        console.error(chalk.red('No RALPH.md found. Run ralph init to create one.'));
+        process.exit(1);
+    }
+    const doc = readRalph(filePath);
+    const task = findTaskById(doc.tasks, taskId);
+    if (!task) {
+        console.error(chalk.red(`No task matching "${taskId}" found in NEXT.`));
+        console.error(chalk.dim('  Available: ' + doc.tasks.map(t => t.id).join(', ')));
+        process.exit(1);
+    }
+    printTaskBrief(task);
+}
+//# sourceMappingURL=brief.js.map

package/dist/commands/brief.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"brief.js","sourceRoot":"","sources":["../../src/commands/brief.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACtE,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAE3C,MAAM,UAAU,QAAQ,CAAC,MAAc;IACrC,MAAM,QAAQ,GAAG,aAAa,EAAE,CAAC;IACjC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,kDAAkD,CAAC,CAAC,CAAC;QAC7E,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,GAAG,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;IAChC,MAAM,IAAI,GAAG,YAAY,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAE7C,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,qBAAqB,MAAM,kBAAkB,CAAC,CAAC,CAAC;QACxE,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,eAAe,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAChF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,cAAc,CAAC,IAAI,CAAC,CAAC;AACvB,CAAC"}

package/dist/commands/done.d.ts

@@ -0,0 +1,2 @@
+export declare function cmdDone(taskId: string): void;
+//# sourceMappingURL=done.d.ts.map

package/dist/commands/done.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"done.d.ts","sourceRoot":"","sources":["../../src/commands/done.ts"],"names":[],"mappings":"AAKA,wBAAgB,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAkC5C"}

package/dist/commands/done.js

@@ -0,0 +1,36 @@
+import chalk from 'chalk';
+import { findRalphFile, readRalph, findTaskById, getFirstUnblockedTask } from '../parser.js';
+import { moveTaskToDone, writeRalph } from '../writer.js';
+import { printTaskBrief } from './next.js';
+export function cmdDone(taskId) {
+    const filePath = findRalphFile();
+    if (!filePath) {
+        console.error(chalk.red('No RALPH.md found. Run ralph init to create one.'));
+        process.exit(1);
+    }
+    const doc = readRalph(filePath);
+    const task = findTaskById(doc.tasks, taskId);
+    if (!task) {
+        console.error(chalk.red(`No task matching "${taskId}" found in NEXT.`));
+        console.error(chalk.dim('  Available: ' + doc.tasks.map(t => t.id).join(', ')));
+        process.exit(1);
+    }
+    // Move to DONE and write back
+    const updated = moveTaskToDone(doc, task);
+    writeRalph(filePath, updated);
+    console.log(chalk.green('✓') + ` Marked done: ${chalk.bold(task.title)}`);
+    // Print the next unblocked task automatically
+    const updatedDoc = readRalph(filePath);
+    const nextTask = getFirstUnblockedTask(updatedDoc.tasks);
+    if (nextTask) {
+        console.log(chalk.dim('\n  Next up:'));
+        printTaskBrief(nextTask);
+    }
+    else if (updatedDoc.tasks.length === 0) {
+        console.log(chalk.green('\n  🎉 NEXT is empty — all tasks complete!\n'));
+    }
+    else {
+        console.log(chalk.yellow('\n  All remaining tasks are blocked. Update dependencies in RALPH.md.\n'));
+    }
+}
+//# sourceMappingURL=done.js.map

package/dist/commands/done.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"done.js","sourceRoot":"","sources":["../../src/commands/done.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,YAAY,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAC7F,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAE3C,MAAM,UAAU,OAAO,CAAC,MAAc;IACpC,MAAM,QAAQ,GAAG,aAAa,EAAE,CAAC;IACjC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,kDAAkD,CAAC,CAAC,CAAC;QAC7E,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,GAAG,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;IAChC,MAAM,IAAI,GAAG,YAAY,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAE7C,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,qBAAqB,MAAM,kBAAkB,CAAC,CAAC,CAAC;QACxE,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,eAAe,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAChF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,8BAA8B;IAC9B,MAAM,OAAO,GAAG,cAAc,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IAC1C,UAAU,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAE9B,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,iBAAiB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAE1E,8CAA8C;IAC9C,MAAM,UAAU,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;IACvC,MAAM,QAAQ,GAAG,qBAAqB,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;IAEzD,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC;QACvC,cAAc,CAAC,QAAQ,CAAC,CAAC;IAC3B,CAAC;SAAM,IAAI,UAAU,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,8CAA8C,CAAC,CAAC,CAAC;IAC3E,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,yEAAyE,CAAC,CAAC,CAAC;IACvG,CAAC;AACH,CAAC"}

package/dist/commands/init.d.ts

@@ -0,0 +1,2 @@
+export declare function cmdInit(): void;
+//# sourceMappingURL=init.d.ts.map

package/dist/commands/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAOA,wBAAgB,OAAO,IAAI,IAAI,CAc9B"}

package/dist/commands/init.js

@@ -0,0 +1,18 @@
+import * as fs from 'fs';
+import * as path from 'path';
+import { fileURLToPath } from 'url';
+import chalk from 'chalk';
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+export function cmdInit() {
+    const dest = path.join(process.cwd(), 'RALPH.md');
+    if (fs.existsSync(dest)) {
+        console.log(chalk.yellow('RALPH.md already exists. Remove it first if you want to re-scaffold.'));
+        process.exit(1);
+    }
+    const templatePath = path.join(__dirname, '..', 'templates', 'ralph-template.md');
+    const template = fs.readFileSync(templatePath, 'utf-8');
+    fs.writeFileSync(dest, template, 'utf-8');
+    console.log(chalk.green('✓') + ' Created RALPH.md');
+    console.log(chalk.dim('  Edit it, then run: ralph next'));
+}
+//# sourceMappingURL=init.js.map

package/dist/commands/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AACpC,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAE/D,MAAM,UAAU,OAAO;IACrB,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,UAAU,CAAC,CAAC;IAElD,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACxB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,sEAAsE,CAAC,CAAC,CAAC;QAClG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,WAAW,EAAE,mBAAmB,CAAC,CAAC;IAClF,MAAM,QAAQ,GAAG,EAAE,CAAC,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;IACxD,EAAE,CAAC,aAAa,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;IAE1C,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,mBAAmB,CAAC,CAAC;IACpD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,iCAAiC,CAAC,CAAC,CAAC;AAC5D,CAAC"}

package/dist/commands/next.d.ts

@@ -0,0 +1,8 @@
+export declare function printTaskBrief(task: {
+    id: string;
+    title: string;
+    brief: string;
+    blockedBy: string;
+}): void;
+export declare function cmdNext(): void;
+//# sourceMappingURL=next.d.ts.map

package/dist/commands/next.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"next.d.ts","sourceRoot":"","sources":["../../src/commands/next.ts"],"names":[],"mappings":"AAGA,wBAAgB,cAAc,CAAC,IAAI,EAAE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAU1G;AAED,wBAAgB,OAAO,IAAI,IAAI,CAwB9B"}

package/dist/commands/next.js

@@ -0,0 +1,37 @@
+import chalk from 'chalk';
+import { findRalphFile, readRalph, getFirstUnblockedTask } from '../parser.js';
+export function printTaskBrief(task) {
+    console.log(chalk.bold.cyan('\n┌─ BRIEF ──────────────────────────────────────────'));
+    console.log(chalk.bold(`│  ${task.title}`));
+    console.log(chalk.cyan('├──────────────────────────────────────────────────'));
+    const briefLines = task.brief.split('\n');
+    for (const line of briefLines) {
+        console.log('│  ' + line);
+    }
+    console.log(chalk.cyan('└──────────────────────────────────────────────────'));
+    console.log(chalk.dim(`\n  When done: ralph done ${task.id}\n`));
+}
+export function cmdNext() {
+    const filePath = findRalphFile();
+    if (!filePath) {
+        console.error(chalk.red('No RALPH.md found. Run ralph init to create one.'));
+        process.exit(1);
+    }
+    const doc = readRalph(filePath);
+    const task = getFirstUnblockedTask(doc.tasks);
+    if (!task) {
+        if (doc.tasks.length === 0) {
+            console.log(chalk.yellow('\nNo tasks in NEXT. Add some to RALPH.md and try again.\n'));
+        }
+        else {
+            console.log(chalk.yellow('\nAll tasks in NEXT are blocked. Resolve dependencies first.\n'));
+            for (const t of doc.tasks) {
+                console.log(chalk.dim(`  ${t.id}  →  blocked by: ${t.blockedBy}`));
+            }
+            console.log();
+        }
+        process.exit(1);
+    }
+    printTaskBrief(task);
+}
+//# sourceMappingURL=next.js.map

package/dist/commands/next.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"next.js","sourceRoot":"","sources":["../../src/commands/next.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAE/E,MAAM,UAAU,cAAc,CAAC,IAAqE;IAClG,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,uDAAuD,CAAC,CAAC,CAAC;IACtF,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IAC5C,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,qDAAqD,CAAC,CAAC,CAAC;IAC/E,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC1C,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;QAC9B,OAAO,CAAC,GAAG,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC;IAC5B,CAAC;IACD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,qDAAqD,CAAC,CAAC,CAAC;IAC/E,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,6BAA6B,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC;AACnE,CAAC;AAED,MAAM,UAAU,OAAO;IACrB,MAAM,QAAQ,GAAG,aAAa,EAAE,CAAC;IACjC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,kDAAkD,CAAC,CAAC,CAAC;QAC7E,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,GAAG,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;IAChC,MAAM,IAAI,GAAG,qBAAqB,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAE9C,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,IAAI,GAAG,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC3B,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,2DAA2D,CAAC,CAAC,CAAC;QACzF,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,gEAAgE,CAAC,CAAC,CAAC;YAC5F,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,KAAK,EAAE,CAAC;gBAC1B,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,oBAAoB,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;YACrE,CAAC;YACD,OAAO,CAAC,GAAG,EAAE,CAAC;QAChB,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,cAAc,CAAC,IAAI,CAAC,CAAC;AACvB,CAAC"}

package/dist/commands/status.d.ts

@@ -0,0 +1,2 @@
+export declare function cmdStatus(): void;
+//# sourceMappingURL=status.d.ts.map

package/dist/commands/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/commands/status.ts"],"names":[],"mappings":"AAGA,wBAAgB,SAAS,IAAI,IAAI,CAyChC"}

package/dist/commands/status.js

@@ -0,0 +1,43 @@
+import chalk from 'chalk';
+import { findRalphFile, readRalph, isBlocked, isActiveEmpty } from '../parser.js';
+export function cmdStatus() {
+    const filePath = findRalphFile();
+    if (!filePath) {
+        console.error(chalk.red('No RALPH.md found. Run ralph init to create one.'));
+        process.exit(1);
+    }
+    const doc = readRalph(filePath);
+    // ACTIVE
+    console.log(chalk.bold('\n── ACTIVE ──'));
+    if (isActiveEmpty(doc.activeContent)) {
+        console.log(chalk.dim('  (none)'));
+    }
+    else {
+        console.log('  ' + doc.activeContent.split('\n').join('\n  '));
+    }
+    // NEXT
+    console.log(chalk.bold('\n── NEXT ──'));
+    if (doc.tasks.length === 0) {
+        console.log(chalk.dim('  (no tasks)'));
+    }
+    else {
+        for (const task of doc.tasks) {
+            const blocked = isBlocked(task);
+            const icon = blocked ? chalk.red('✗') : chalk.green('✓');
+            const label = blocked
+                ? chalk.dim(task.title) + chalk.red(` [blocked: ${task.blockedBy}]`)
+                : chalk.white(task.title);
+            console.log(`  ${icon}  ${label}`);
+        }
+    }
+    // DONE — count data rows (all pipe rows except the header and separator)
+    const doneLines = doc.doneContent
+        .split('\n')
+        .filter(l => /^\|/.test(l) && !/^\|[-: |]+$/.test(l));
+    // First pipe-row is the header; remainder are data rows
+    const doneCount = Math.max(0, doneLines.length - 1);
+    console.log(chalk.bold('\n── DONE ──'));
+    console.log(chalk.dim(`  ${doneCount} task${doneCount !== 1 ? 's' : ''} completed`));
+    console.log();
+}
+//# sourceMappingURL=status.js.map

package/dist/commands/status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../src/commands/status.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAElF,MAAM,UAAU,SAAS;IACvB,MAAM,QAAQ,GAAG,aAAa,EAAE,CAAC;IACjC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,kDAAkD,CAAC,CAAC,CAAC;QAC7E,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,GAAG,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;IAEhC,SAAS;IACT,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC;IAC1C,IAAI,aAAa,CAAC,GAAG,CAAC,aAAa,CAAC,EAAE,CAAC;QACrC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC;IACrC,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;IACjE,CAAC;IAED,OAAO;IACP,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC;IACxC,IAAI,GAAG,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3B,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC;IACzC,CAAC;SAAM,CAAC;QACN,KAAK,MAAM,IAAI,IAAI,GAAG,CAAC,KAAK,EAAE,CAAC;YAC7B,MAAM,OAAO,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;YAChC,MAAM,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YACzD,MAAM,KAAK,GAAG,OAAO;gBACnB,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,cAAc,IAAI,CAAC,SAAS,GAAG,CAAC;gBACpE,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC5B,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,KAAK,KAAK,EAAE,CAAC,CAAC;QACrC,CAAC;IACH,CAAC;IAED,yEAAyE;IACzE,MAAM,SAAS,GAAG,GAAG,CAAC,WAAW;SAC9B,KAAK,CAAC,IAAI,CAAC;SACX,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IACxD,wDAAwD;IACxD,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACpD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC;IACxC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,SAAS,QAAQ,SAAS,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC;IACrF,OAAO,CAAC,GAAG,EAAE,CAAC;AAChB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,34 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import { cmdInit } from './commands/init.js';
+import { cmdStatus } from './commands/status.js';
+import { cmdNext } from './commands/next.js';
+import { cmdDone } from './commands/done.js';
+import { cmdBrief } from './commands/brief.js';
+const program = new Command();
+program
+    .name('ralph')
+    .description('The runtime that replaces you as the person who prompts the agent.')
+    .version('0.1.0');
+program
+    .command('init')
+    .description('Scaffold a RALPH.md template in the current repo')
+    .action(cmdInit);
+program
+    .command('status')
+    .description('Print ACTIVE / NEXT / DONE summary from RALPH.md')
+    .action(cmdStatus);
+program
+    .command('next')
+    .description('Print the brief for the first unblocked task in NEXT')
+    .action(cmdNext);
+program
+    .command('done <task-id>')
+    .description('Move a task from NEXT to DONE and print the next brief')
+    .action(cmdDone);
+program
+    .command('brief <task-id>')
+    .description('Print the brief for a specific task without marking it done')
+    .action(cmdBrief);
+program.parse(process.argv);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAE/C,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,OAAO,CAAC;KACb,WAAW,CAAC,oEAAoE,CAAC;KACjF,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpB,OAAO;KACJ,OAAO,CAAC,MAAM,CAAC;KACf,WAAW,CAAC,kDAAkD,CAAC;KAC/D,MAAM,CAAC,OAAO,CAAC,CAAC;AAEnB,OAAO;KACJ,OAAO,CAAC,QAAQ,CAAC;KACjB,WAAW,CAAC,kDAAkD,CAAC;KAC/D,MAAM,CAAC,SAAS,CAAC,CAAC;AAErB,OAAO;KACJ,OAAO,CAAC,MAAM,CAAC;KACf,WAAW,CAAC,sDAAsD,CAAC;KACnE,MAAM,CAAC,OAAO,CAAC,CAAC;AAEnB,OAAO;KACJ,OAAO,CAAC,gBAAgB,CAAC;KACzB,WAAW,CAAC,wDAAwD,CAAC;KACrE,MAAM,CAAC,OAAO,CAAC,CAAC;AAEnB,OAAO;KACJ,OAAO,CAAC,iBAAiB,CAAC;KAC1B,WAAW,CAAC,6DAA6D,CAAC;KAC1E,MAAM,CAAC,QAAQ,CAAC,CAAC;AAEpB,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC"}

package/dist/parser.d.ts

@@ -0,0 +1,25 @@
+export interface Task {
+    id: string;
+    title: string;
+    brief: string;
+    blockedBy: string;
+    raw: string;
+}
+export interface ParsedRalph {
+    activeContent: string;
+    tasks: Task[];
+    doneContent: string;
+    raw: string;
+}
+/** Walk up from startDir looking for RALPH.md */
+export declare function findRalphFile(startDir?: string): string | null;
+export declare function readRalph(filePath: string): ParsedRalph;
+export declare function parseRalph(content: string): ParsedRalph;
+/** A task is blocked if Blocked by is anything other than "nothing" (case-insensitive) */
+export declare function isBlocked(task: Task): boolean;
+/** ACTIVE is empty when the section body is blank or contains only *(none)* / horizontal rules */
+export declare function isActiveEmpty(activeContent: string): boolean;
+/** Case-insensitive substring match on task ID or title */
+export declare function findTaskById(tasks: Task[], query: string): Task | undefined;
+export declare function getFirstUnblockedTask(tasks: Task[]): Task | undefined;
+//# sourceMappingURL=parser.d.ts.map

package/dist/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../src/parser.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,IAAI;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,WAAW;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;CACb;AAED,iDAAiD;AACjD,wBAAgB,aAAa,CAAC,QAAQ,GAAE,MAAsB,GAAG,MAAM,GAAG,IAAI,CAS7E;AAED,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,CAGvD;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,CAkBvD;AAgCD,0FAA0F;AAC1F,wBAAgB,SAAS,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAG7C;AAED,kGAAkG;AAClG,wBAAgB,aAAa,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAO5D;AAED,2DAA2D;AAC3D,wBAAgB,YAAY,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAK3E;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,IAAI,GAAG,SAAS,CAErE"}

package/dist/parser.js

@@ -0,0 +1,81 @@
+import * as fs from 'fs';
+import * as path from 'path';
+/** Walk up from startDir looking for RALPH.md */
+export function findRalphFile(startDir = process.cwd()) {
+    let dir = startDir;
+    while (true) {
+        const candidate = path.join(dir, 'RALPH.md');
+        if (fs.existsSync(candidate))
+            return candidate;
+        const parent = path.dirname(dir);
+        if (parent === dir)
+            return null;
+        dir = parent;
+    }
+}
+export function readRalph(filePath) {
+    const content = fs.readFileSync(filePath, 'utf-8');
+    return parseRalph(content);
+}
+export function parseRalph(content) {
+    const activeMatch = content.match(/^## ACTIVE\s*\n([\s\S]*?)(?=^## )/im);
+    const nextMatch = content.match(/^## NEXT\s*\n([\s\S]*?)(?=^## )/im);
+    const doneMatch = content.match(/^## DONE\s*\n([\s\S]*)/im);
+    const activeRaw = activeMatch ? activeMatch[1].trim() : '';
+    const nextContent = nextMatch ? nextMatch[1] : '';
+    const doneContent = doneMatch ? doneMatch[1].trim() : '';
+    // Strip cosmetic --- separators from the active section before storing
+    const activeContent = activeRaw.replace(/^---\s*$/gm, '').trim();
+    return {
+        activeContent,
+        tasks: parseNextSection(nextContent),
+        doneContent,
+        raw: content,
+    };
+}
+function parseNextSection(content) {
+    const tasks = [];
+    // Split on #### headings; each block includes the heading line
+    const blocks = content.split(/(?=^####\s)/m).filter(b => b.trim().length > 0);
+    for (const block of blocks) {
+        const headingMatch = block.match(/^####\s+(.+)/m);
+        if (!headingMatch)
+            continue;
+        const heading = headingMatch[1].trim();
+        // ID is the first slug-like token before an em-dash, en-dash, or whitespace
+        const idMatch = heading.match(/^([\w-]+)/);
+        const id = idMatch ? idMatch[1] : heading.slice(0, 32).replace(/\s+/g, '-');
+        // Brief may be multiline. Use ^ with m flag so we anchor to line start,
+        // not to an inline "**Blocked by:**" that might appear inside the brief text.
+        const briefMatch = block.match(/^\*\*Brief:\*\*\s*([\s\S]+?)(?=\n\*\*[A-Z]|\n####|$)/m);
+        const brief = briefMatch ? briefMatch[1].trim() : '';
+        // Blocked by: must be at the start of a line so inline occurrences are ignored
+        const blockedByMatch = block.match(/^\*\*Blocked by:\*\*\s*(.+?)(?:\n|$)/im);
+        const blockedBy = blockedByMatch ? blockedByMatch[1].trim() : 'nothing';
+        tasks.push({ id, title: heading, brief, blockedBy, raw: block });
+    }
+    return tasks;
+}
+/** A task is blocked if Blocked by is anything other than "nothing" (case-insensitive) */
+export function isBlocked(task) {
+    const val = task.blockedBy.toLowerCase().trim();
+    return val !== 'nothing' && val !== '';
+}
+/** ACTIVE is empty when the section body is blank or contains only *(none)* / horizontal rules */
+export function isActiveEmpty(activeContent) {
+    const stripped = activeContent
+        .replace(/<!--[\s\S]*?-->/g, '') // strip HTML comments
+        .replace(/\*\(none\)\*/gi, '') // strip *(none)*
+        .replace(/^---\s*$/gm, '') // strip horizontal rules
+        .trim();
+    return stripped === '';
+}
+/** Case-insensitive substring match on task ID or title */
+export function findTaskById(tasks, query) {
+    const q = query.toLowerCase();
+    return tasks.find(t => t.id.toLowerCase().includes(q) || t.title.toLowerCase().includes(q));
+}
+export function getFirstUnblockedTask(tasks) {
+    return tasks.find(t => !isBlocked(t));
+}
+//# sourceMappingURL=parser.js.map

package/dist/parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.js","sourceRoot":"","sources":["../src/parser.ts"],"names":[],"mappings":"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"}

package/dist/writer.d.ts

@@ -0,0 +1,5 @@
+import { ParsedRalph, Task } from './parser.js';
+/** Remove a task block from NEXT and append a row to the DONE table. Returns new file content. */
+export declare function moveTaskToDone(doc: ParsedRalph, task: Task): string;
+export declare function writeRalph(filePath: string, content: string): void;
+//# sourceMappingURL=writer.d.ts.map

package/dist/writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"writer.d.ts","sourceRoot":"","sources":["../src/writer.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAEhD,kGAAkG;AAClG,wBAAgB,cAAc,CAAC,GAAG,EAAE,WAAW,EAAE,IAAI,EAAE,IAAI,GAAG,MAAM,CA+BnE;AAED,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAElE"}

package/dist/writer.js

@@ -0,0 +1,27 @@
+import * as fs from 'fs';
+/** Remove a task block from NEXT and append a row to the DONE table. Returns new file content. */
+export function moveTaskToDone(doc, task) {
+    let content = doc.raw;
+    // Remove the raw task block from the file
+    content = content.replace(task.raw, '');
+    // Collapse triple+ blank lines left by removal
+    content = content.replace(/\n{3,}/g, '\n\n');
+    // Build DONE table row
+    const date = new Date().toISOString().split('T')[0];
+    const row = `| ${task.id} | ${task.title} | ${date} |`;
+    // Does a DONE table already have a header row?
+    const hasTable = /\|\s*Task(?:\s+ID)?\s*\|/i.test(content);
+    if (hasTable) {
+        // Append after the last row of the table (find separator line, insert after last data row)
+        content = content.replace(/(## DONE[\s\S]*?(?:\|[-| :]+\|\n)((?:\|.+\|\n)*))/i, `$1${row}\n`);
+    }
+    else {
+        // No table yet — create one inside the DONE section
+        content = content.replace(/^(## DONE\s*\n)/im, `$1\n| Task ID | Title | Completed |\n|---------|-------|----------|\n${row}\n`);
+    }
+    return content;
+}
+export function writeRalph(filePath, content) {
+    fs.writeFileSync(filePath, content, 'utf-8');
+}
+//# sourceMappingURL=writer.js.map

package/dist/writer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"writer.js","sourceRoot":"","sources":["../src/writer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AAGzB,kGAAkG;AAClG,MAAM,UAAU,cAAc,CAAC,GAAgB,EAAE,IAAU;IACzD,IAAI,OAAO,GAAG,GAAG,CAAC,GAAG,CAAC;IAEtB,0CAA0C;IAC1C,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IAExC,+CAA+C;IAC/C,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IAE7C,uBAAuB;IACvB,MAAM,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACpD,MAAM,GAAG,GAAG,KAAK,IAAI,CAAC,EAAE,MAAM,IAAI,CAAC,KAAK,MAAM,IAAI,IAAI,CAAC;IAEvD,+CAA+C;IAC/C,MAAM,QAAQ,GAAG,2BAA2B,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAE3D,IAAI,QAAQ,EAAE,CAAC;QACb,2FAA2F;QAC3F,OAAO,GAAG,OAAO,CAAC,OAAO,CACvB,oDAAoD,EACpD,KAAK,GAAG,IAAI,CACb,CAAC;IACJ,CAAC;SAAM,CAAC;QACN,oDAAoD;QACpD,OAAO,GAAG,OAAO,CAAC,OAAO,CACvB,mBAAmB,EACnB,wEAAwE,GAAG,IAAI,CAChF,CAAC;IACJ,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,QAAgB,EAAE,OAAe;IAC1D,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;AAC/C,CAAC"}

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "@felixthemangy/ralph-loop",
+  "version": "0.1.0",
+  "description": "The runtime that replaces you as the person who prompts the agent.",
+  "type": "module",
+  "bin": {
+    "ralph": "./dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/index.ts",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
+  },
+  "keywords": ["cli", "agent", "loop-engineering", "ralph", "multi-agent"],
+  "author": "StartupHuman",
+  "license": "MIT",
+  "files": ["dist", "README.md"],
+  "engines": { "node": ">=20" },
+  "dependencies": {
+    "chalk": "^5.3.0",
+    "commander": "^12.1.0",
+    "gray-matter": "^4.0.3"
+  },
+  "devDependencies": {
+    "@types/node": "^20.14.0",
+    "tsx": "^4.15.0",
+    "typescript": "^5.4.0",
+    "vitest": "^1.6.0"
+  }
+}