ralph-lisa-loop 0.3.8 → 0.3.9

package/README.md

@@ -36,7 +36,7 @@ Ralph writes → Lisa reviews → Consensus → Next step
 ### 1. Install
 
 ```bash
-npm i -g ralph-lisa
+npm i -g ralph-lisa-loop
 ```
 
 ### 2. Initialize Project
@@ -61,22 +61,16 @@ ralph-lisa auto "implement login feature"
 **Terminal 1 - Ralph (Claude Code)**:
 ```bash
 ralph-lisa whose-turn                    # Check turn
-# ... do work ...
-ralph-lisa submit-ralph "[PLAN] Login feature design
-
-1. Create login form component
-2. Add validation
-3. Connect to API"
+# ... do work, write submission to .dual-agent/submit.md ...
+ralph-lisa submit-ralph --file .dual-agent/submit.md
 ```
 
 **Terminal 2 - Lisa (Codex)**:
 ```bash
 ralph-lisa whose-turn                    # Check turn
 ralph-lisa read work.md                  # Read Ralph's work
-ralph-lisa submit-lisa "[PASS] Plan looks good
-
-- Clear structure
-- Good separation of concerns"
+# ... write review to .dual-agent/submit.md ...
+ralph-lisa submit-lisa --file .dual-agent/submit.md
 ```
 
 ## Features
@@ -126,7 +120,7 @@ export RL_POLICY_MODE=warn
 # Enable block mode (rejects non-compliant submissions)
 export RL_POLICY_MODE=block
 
-# Disable (default)
+# Disable
 export RL_POLICY_MODE=off
 ```
 
@@ -182,17 +176,27 @@ ralph-lisa auto --full-auto "task"       # Auto mode without permission prompts
 
 # Turn control
 ralph-lisa whose-turn                    # Check whose turn
-ralph-lisa submit-ralph "[TAG] ..."      # Ralph submits
-ralph-lisa submit-lisa "[TAG] ..."       # Lisa submits
+ralph-lisa check-turn                    # Alias for whose-turn
+ralph-lisa submit-ralph --file f.md      # Ralph submits (recommended)
+ralph-lisa submit-lisa --file f.md       # Lisa submits (recommended)
+ralph-lisa submit-ralph --stdin          # Submit via stdin pipe
+ralph-lisa submit-lisa --stdin           # Lisa submit via stdin pipe
+ralph-lisa submit-ralph "[TAG] ..."      # Inline (deprecated)
 
 # Information
 ralph-lisa status                        # Current status
 ralph-lisa read work.md                  # Ralph's latest
 ralph-lisa read review.md                # Lisa's latest
+ralph-lisa read-review                   # Alias for read review.md
+ralph-lisa read review --round N         # Read review from round N
 ralph-lisa history                       # Full history
+ralph-lisa recap                         # Context recovery summary
+ralph-lisa logs                          # List transcript logs
+ralph-lisa logs cat [name]               # View a specific log
 
 # Flow control
-ralph-lisa step "phase-name"             # Enter new phase
+ralph-lisa step "phase-name"             # Enter new phase (requires consensus)
+ralph-lisa step --force "phase-name"     # Enter new phase (skip consensus check)
 ralph-lisa update-task "new direction"   # Update task direction mid-session
 ralph-lisa archive [name]                # Archive session
 ralph-lisa clean                         # Clean session
@@ -247,7 +251,7 @@ For auto mode:
 
 | Variable | Default | Description |
 |----------|---------|-------------|
-| `RL_POLICY_MODE` | `off` | Policy check mode: `off`, `warn`, `block` |
+| `RL_POLICY_MODE` | `warn` | Policy check mode: `off`, `warn`, `block` |
 | `RL_CHECKPOINT_ROUNDS` | `0` (disabled) | Pause for human review every N rounds |
 | `RL_LOG_MAX_MB` | `5` | Pane log truncation threshold in MB (min 1) |
 
@@ -257,8 +261,7 @@ Part of the [TigerHill](https://github.com/Click-Intelligence-LLC/TigerHill) pro
 
 ## See Also
 
-- [CONCEPT.md](CONCEPT.md) - Why dual-agent collaboration works
-- [UPGRADE_PLAN_V3.md](UPGRADE_PLAN_V3.md) - V3 design document
+- [CONCEPT.md](../CONCEPT.md) - Why dual-agent collaboration works
 
 ## License
 

package/dist/cli.js

@@ -21,6 +21,7 @@ switch (cmd) {
         (0, commands_js_1.cmdUninit)();
         break;
     case "whose-turn":
+    case "check-turn":
         (0, commands_js_1.cmdWhoseTurn)();
         break;
     case "submit-ralph":
@@ -35,10 +36,14 @@ switch (cmd) {
     case "read":
         (0, commands_js_1.cmdRead)(rest);
         break;
+    case "read-review":
+        (0, commands_js_1.cmdRead)(["review.md", ...rest]);
+        break;
     case "recap":
         (0, commands_js_1.cmdRecap)();
         break;
     case "step":
+    case "next-step":
         (0, commands_js_1.cmdStep)(rest);
         break;
     case "history":
@@ -96,11 +101,13 @@ function showHelp() {
     console.log('  ralph-lisa auto --full-auto "task"  Auto mode without permission prompts');
     console.log("");
     console.log("Turn Control:");
-    console.log("  ralph-lisa whose-turn               Check whose turn");
-    console.log('  ralph-lisa submit-ralph "[TAG]..."   Ralph submits');
-    console.log("  ralph-lisa submit-ralph --file <f>   Ralph submits from file");
-    console.log('  ralph-lisa submit-lisa "[TAG]..."    Lisa submits');
-    console.log("  ralph-lisa submit-lisa --file <f>    Lisa submits from file");
+    console.log("  ralph-lisa check-turn                Check whose turn (alias: whose-turn)");
+    console.log("  ralph-lisa submit-ralph --file <f>   Ralph submits from file (recommended)");
+    console.log("  ralph-lisa submit-lisa --file <f>    Lisa submits from file (recommended)");
+    console.log("  ralph-lisa submit-ralph --stdin      Ralph submits from stdin");
+    console.log("  ralph-lisa submit-lisa --stdin       Lisa submits from stdin");
+    console.log('  ralph-lisa submit-ralph "[TAG]..."   Ralph submits inline (deprecated)');
+    console.log('  ralph-lisa submit-lisa "[TAG]..."    Lisa submits inline (deprecated)');
     console.log("");
     console.log("Tags:");
     console.log("  Ralph: [PLAN] [RESEARCH] [CODE] [FIX] [CHALLENGE] [DISCUSS] [QUESTION] [CONSENSUS]");
@@ -108,12 +115,13 @@ function showHelp() {
     console.log("");
     console.log("Information:");
     console.log("  ralph-lisa status                   Show current status");
-    console.log("  ralph-lisa read <file>              Read work.md/review.md");
+    console.log("  ralph-lisa read-review              Read Lisa's review (alias: read review.md)");
+    console.log("  ralph-lisa read <file>              Read work.md/review.md/etc");
     console.log("  ralph-lisa recap                    Context recovery summary");
     console.log("  ralph-lisa history                  Show full history");
     console.log("");
     console.log("Flow Control:");
-    console.log('  ralph-lisa step "name"              Enter new step');
+    console.log('  ralph-lisa next-step "name"         Enter new step (alias: step)');
     console.log('  ralph-lisa update-task "desc"        Update task direction');
     console.log("  ralph-lisa archive [name]           Archive session");
     console.log("  ralph-lisa clean                    Clean session");
@@ -141,6 +149,6 @@ function showVersion() {
         console.log(`ralph-lisa-loop v${pkg.version}`);
     }
     catch {
-        console.log("ralph-lisa-loop v0.3.0");
+        console.log("ralph-lisa-loop v0.3.9");
     }
 }

package/dist/commands.d.ts

@@ -2,6 +2,13 @@
  * CLI commands for Ralph-Lisa Loop.
  * Direct port of io.sh logic to Node/TS.
  */
+/**
+ * Generate a project-specific tmux session name to avoid conflicts
+ * when running multiple projects simultaneously.
+ * Format: rll-{sanitized-dirname}-{short-hash}
+ * tmux session names cannot contain '.' or ':'.
+ */
+export declare function generateSessionName(projectDir: string): string;
 export declare function cmdInit(args: string[]): void;
 export declare function cmdWhoseTurn(): void;
 export declare function cmdSubmitRalph(args: string[]): void;

package/dist/commands.js

@@ -37,6 +37,7 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateSessionName = generateSessionName;
 exports.cmdInit = cmdInit;
 exports.cmdWhoseTurn = cmdWhoseTurn;
 exports.cmdSubmitRalph = cmdSubmitRalph;
@@ -58,12 +59,26 @@ exports.cmdLogs = cmdLogs;
 exports.cmdDoctor = cmdDoctor;
 const fs = __importStar(require("node:fs"));
 const path = __importStar(require("node:path"));
+const crypto = __importStar(require("node:crypto"));
 const node_child_process_1 = require("node:child_process");
 const state_js_1 = require("./state.js");
 const policy_js_1 = require("./policy.js");
 function line(ch = "=", len = 40) {
     return ch.repeat(len);
 }
+/**
+ * Generate a project-specific tmux session name to avoid conflicts
+ * when running multiple projects simultaneously.
+ * Format: rll-{sanitized-dirname}-{short-hash}
+ * tmux session names cannot contain '.' or ':'.
+ */
+function generateSessionName(projectDir) {
+    const dirName = path.basename(projectDir);
+    const hash = crypto.createHash("md5").update(projectDir).digest("hex").slice(0, 6);
+    // Sanitize: keep alphanumeric and hyphens only, truncate to 20 chars
+    const sanitized = dirName.replace(/[^a-zA-Z0-9-]/g, "-").replace(/-+/g, "-").replace(/^-|-$/g, "").slice(0, 20);
+    return `rll-${sanitized || "project"}-${hash}`;
+}
 /**
  * Resolve submission content from args, --file, or --stdin.
  * Returns content and whether it came from an external source (file/stdin).
@@ -92,7 +107,8 @@ function resolveContent(args) {
             process.exit(1);
         }
     }
-    return { content: args.join(" "), external: false };
+    // Replace literal \n sequences with real newlines (IMP-3: inline format fix)
+    return { content: args.join(" ").replace(/\\n/g, "\n"), external: false };
 }
 /**
  * Get list of changed files via git diff.
@@ -119,7 +135,8 @@ function cmdInit(args) {
         console.error('Usage: ralph-lisa init "task description"');
         process.exit(1);
     }
-    const dir = (0, state_js_1.stateDir)();
+    // Always create in CWD — init is a creation command, not a discovery command
+    const dir = (0, state_js_1.stateDir)(process.cwd());
     if (fs.existsSync(dir)) {
         console.log("Warning: Existing session will be overwritten");
     }
@@ -141,7 +158,7 @@ function cmdInit(args) {
     console.log(`Task: ${task}`);
     console.log("Turn: ralph");
     console.log("");
-    console.log('Ralph should start with: ralph-lisa submit-ralph "[PLAN] summary..."');
+    console.log("Ralph should start with: ralph-lisa submit-ralph --file .dual-agent/submit.md");
     console.log(line());
 }
 // ─── whose-turn ──────────────────────────────────
@@ -154,9 +171,9 @@ function cmdSubmitRalph(args) {
     (0, state_js_1.checkSession)();
     const { content, external } = resolveContent(args);
     if (!content) {
-        console.error('Usage: ralph-lisa submit-ralph "[TAG] summary\\n\\ndetails..."');
-        console.error('       ralph-lisa submit-ralph --file <path>');
+        console.error("Usage: ralph-lisa submit-ralph --file <path>  (recommended)");
         console.error("       echo content | ralph-lisa submit-ralph --stdin");
+        console.error('       ralph-lisa submit-ralph "[TAG] ..."     (deprecated, shell escaping issues)');
         console.error("");
         console.error("Valid tags: PLAN, RESEARCH, CODE, FIX, CHALLENGE, DISCUSS, QUESTION, CONSENSUS");
         process.exit(1);
@@ -175,8 +192,15 @@ function cmdSubmitRalph(args) {
         console.error("Valid tags: PLAN, RESEARCH, CODE, FIX, CHALLENGE, DISCUSS, QUESTION, CONSENSUS");
         process.exit(1);
     }
-    // Policy check
-    if (!(0, policy_js_1.runPolicyCheck)("ralph", tag, content)) {
+    // Policy check (IMP-4: clear status/warning separation)
+    const { proceed, violations } = (0, policy_js_1.runPolicyCheck)("ralph", tag, content);
+    if (!proceed) {
+        console.error(line());
+        console.error("Submission BLOCKED by policy:");
+        for (const v of violations) {
+            console.error(`  - ${v.message}`);
+        }
+        console.error(line());
         process.exit(1);
     }
     const round = (0, state_js_1.getRound)();
@@ -207,7 +231,18 @@ function cmdSubmitRalph(args) {
     (0, state_js_1.updateLastAction)("Ralph", content);
     (0, state_js_1.setTurn)("lisa");
     console.log(line());
-    console.log(`Submitted: [${tag}] ${summary}`);
+    if (violations.length > 0) {
+        console.log(`Submitted OK (with warnings): [${tag}] ${summary}`);
+        console.log("");
+        console.log("Policy warnings:");
+        for (const v of violations) {
+            console.log(`  - ${v.message}`);
+        }
+        console.log("");
+    }
+    else {
+        console.log(`Submitted: [${tag}] ${summary}`);
+    }
     console.log("Turn passed to: Lisa");
     console.log(line());
     console.log("");
@@ -218,9 +253,9 @@ function cmdSubmitLisa(args) {
     (0, state_js_1.checkSession)();
     const { content, external } = resolveContent(args);
     if (!content) {
-        console.error('Usage: ralph-lisa submit-lisa "[TAG] summary\\n\\ndetails..."');
-        console.error('       ralph-lisa submit-lisa --file <path>');
+        console.error("Usage: ralph-lisa submit-lisa --file <path>  (recommended)");
         console.error("       echo content | ralph-lisa submit-lisa --stdin");
+        console.error('       ralph-lisa submit-lisa "[TAG] ..."     (deprecated, shell escaping issues)');
         console.error("");
         console.error("Valid tags: PASS, NEEDS_WORK, CHALLENGE, DISCUSS, QUESTION, CONSENSUS");
         process.exit(1);
@@ -239,8 +274,15 @@ function cmdSubmitLisa(args) {
         console.error("Valid tags: PASS, NEEDS_WORK, CHALLENGE, DISCUSS, QUESTION, CONSENSUS");
         process.exit(1);
     }
-    // Policy check
-    if (!(0, policy_js_1.runPolicyCheck)("lisa", tag, content)) {
+    // Policy check (IMP-4: clear status/warning separation)
+    const { proceed, violations } = (0, policy_js_1.runPolicyCheck)("lisa", tag, content);
+    if (!proceed) {
+        console.error(line());
+        console.error("Submission BLOCKED by policy:");
+        for (const v of violations) {
+            console.error(`  - ${v.message}`);
+        }
+        console.error(line());
         process.exit(1);
     }
     const round = (0, state_js_1.getRound)();
@@ -277,7 +319,18 @@ function cmdSubmitLisa(args) {
     const nextRound = (parseInt(round, 10) || 0) + 1;
     (0, state_js_1.setRound)(nextRound);
     console.log(line());
-    console.log(`Submitted: [${tag}] ${summary}`);
+    if (violations.length > 0) {
+        console.log(`Submitted OK (with warnings): [${tag}] ${summary}`);
+        console.log("");
+        console.log("Policy warnings:");
+        for (const v of violations) {
+            console.log(`  - ${v.message}`);
+        }
+        console.log("");
+    }
+    else {
+        console.log(`Submitted: [${tag}] ${summary}`);
+    }
     console.log("Turn passed to: Ralph");
     console.log(`Round: ${round} -> ${nextRound}`);
     console.log(line());
@@ -507,7 +560,9 @@ function cmdHistory() {
 function cmdArchive(args) {
     (0, state_js_1.checkSession)();
     const name = args[0] || new Date().toISOString().replace(/[:.]/g, "-").slice(0, 19);
-    const archiveDir = path.join(process.cwd(), state_js_1.ARCHIVE_DIR);
+    // Place archive next to .dual-agent/ (in project root, not CWD)
+    const root = (0, state_js_1.findProjectRoot)() || process.cwd();
+    const archiveDir = path.join(root, state_js_1.ARCHIVE_DIR);
     const dest = path.join(archiveDir, name);
     fs.mkdirSync(dest, { recursive: true });
     fs.cpSync((0, state_js_1.stateDir)(), dest, { recursive: true });
@@ -938,7 +993,7 @@ end tell'`, { stdio: "pipe" });
         try {
             execSync("which tmux", { stdio: "pipe" });
             console.log("Launching with tmux...");
-            const sessionName = "ralph-lisa";
+            const sessionName = generateSessionName(projectDir);
             execSync(`tmux kill-session -t "${sessionName}" 2>/dev/null || true`);
             execSync(`tmux new-session -d -s "${sessionName}" -n "Ralph" "bash -c '${ralphCmd}; exec bash'"`);
             execSync(`tmux split-window -h -t "${sessionName}" "bash -c '${lisaCmd}; exec bash'"`);
@@ -1040,7 +1095,7 @@ function cmdAuto(args) {
         cmdInit(task.split(" "));
         console.log("");
     }
-    const sessionName = "ralph-lisa-auto";
+    const sessionName = generateSessionName(projectDir);
     const dir = (0, state_js_1.stateDir)(projectDir);
     fs.mkdirSync(dir, { recursive: true });
     // Archive pane logs from previous runs (for transcript preservation)

package/dist/policy.d.ts

@@ -22,7 +22,10 @@ export declare function checkRalph(tag: string, content: string): PolicyViolatio
  */
 export declare function checkLisa(tag: string, content: string): PolicyViolation[];
 /**
- * Run policy checks and handle output/exit based on mode.
- * Returns true if submission should proceed, false if blocked.
+ * Run policy checks based on mode.
+ * Returns { proceed, violations } so callers can format output clearly (IMP-4).
  */
-export declare function runPolicyCheck(role: "ralph" | "lisa", tag: string, content: string): boolean;
+export declare function runPolicyCheck(role: "ralph" | "lisa", tag: string, content: string): {
+    proceed: boolean;
+    violations: PolicyViolation[];
+};

package/dist/policy.js

@@ -87,26 +87,19 @@ function checkLisa(tag, content) {
     return violations;
 }
 /**
- * Run policy checks and handle output/exit based on mode.
- * Returns true if submission should proceed, false if blocked.
+ * Run policy checks based on mode.
+ * Returns { proceed, violations } so callers can format output clearly (IMP-4).
  */
 function runPolicyCheck(role, tag, content) {
     const mode = getPolicyMode();
     if (mode === "off")
-        return true;
+        return { proceed: true, violations: [] };
     const violations = role === "ralph" ? checkRalph(tag, content) : checkLisa(tag, content);
     if (violations.length === 0)
-        return true;
-    console.error("");
-    console.error("⚠️  Policy warnings:");
-    for (const v of violations) {
-        console.error(`  - ${v.message}`);
-    }
-    console.error("");
+        return { proceed: true, violations: [] };
     if (mode === "block") {
-        console.error("Policy mode is 'block'. Submission rejected.");
-        return false;
+        return { proceed: false, violations };
     }
-    // warn mode: print but continue
-    return true;
+    // warn mode: proceed but pass violations to caller
+    return { proceed: true, violations };
 }

package/dist/state.d.ts

@@ -5,7 +5,20 @@
 export declare const STATE_DIR = ".dual-agent";
 export declare const ARCHIVE_DIR = ".dual-agent-archive";
 export declare const VALID_TAGS = "PLAN|RESEARCH|CODE|FIX|PASS|NEEDS_WORK|CHALLENGE|DISCUSS|QUESTION|CONSENSUS";
+export declare function findProjectRoot(startDir?: string): string | null;
+/**
+ * Reset the cached project root. Used in tests.
+ */
+export declare function resetProjectRootCache(): void;
+/**
+ * Get the .dual-agent/ state directory path.
+ * When projectDir is explicitly given, uses that path directly.
+ * When omitted, searches upward from CWD to find .dual-agent/ (like git).
+ */
 export declare function stateDir(projectDir?: string): string;
+/**
+ * Check that a session exists. Searches upward from CWD when no explicit dir given.
+ */
 export declare function checkSession(projectDir?: string): void;
 export declare function readFile(filePath: string): string;
 export declare function writeFile(filePath: string, content: string): void;

package/dist/state.js

@@ -38,6 +38,8 @@ var __importStar = (this && this.__importStar) || (function () {
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VALID_TAGS = exports.ARCHIVE_DIR = exports.STATE_DIR = void 0;
+exports.findProjectRoot = findProjectRoot;
+exports.resetProjectRootCache = resetProjectRootCache;
 exports.stateDir = stateDir;
 exports.checkSession = checkSession;
 exports.readFile = readFile;
@@ -61,11 +63,71 @@ exports.STATE_DIR = ".dual-agent";
 exports.ARCHIVE_DIR = ".dual-agent-archive";
 exports.VALID_TAGS = "PLAN|RESEARCH|CODE|FIX|PASS|NEEDS_WORK|CHALLENGE|DISCUSS|QUESTION|CONSENSUS";
 const TAG_RE = new RegExp(`^\\[(${exports.VALID_TAGS})\\]`);
-function stateDir(projectDir = process.cwd()) {
-    return path.join(projectDir, exports.STATE_DIR);
+/**
+ * Walk up from startDir to find the nearest directory containing .dual-agent/.
+ * Similar to how git finds .git/ from any subdirectory.
+ * Result is cached per process invocation for efficiency.
+ */
+/**
+ * Cache keyed by resolved startDir to avoid returning wrong root
+ * when called with different directories in the same process.
+ */
+let _cachedStartDir;
+let _cachedProjectRoot;
+function findProjectRoot(startDir = process.cwd()) {
+    const resolved = path.resolve(startDir);
+    // Cache hit: same startDir as last call
+    if (_cachedStartDir === resolved && _cachedProjectRoot !== undefined) {
+        if (_cachedProjectRoot === null)
+            return null;
+        // Validate cached root still exists
+        if (fs.existsSync(path.join(_cachedProjectRoot, exports.STATE_DIR))) {
+            return _cachedProjectRoot;
+        }
+        // Invalidate stale cache
+        _cachedStartDir = undefined;
+        _cachedProjectRoot = undefined;
+    }
+    let dir = resolved;
+    while (true) {
+        if (fs.existsSync(path.join(dir, exports.STATE_DIR))) {
+            _cachedStartDir = resolved;
+            _cachedProjectRoot = dir;
+            return dir;
+        }
+        const parent = path.dirname(dir);
+        if (parent === dir)
+            break; // reached filesystem root
+        dir = parent;
+    }
+    _cachedStartDir = resolved;
+    _cachedProjectRoot = null;
+    return null;
 }
-function checkSession(projectDir = process.cwd()) {
-    const dir = stateDir(projectDir);
+/**
+ * Reset the cached project root. Used in tests.
+ */
+function resetProjectRootCache() {
+    _cachedStartDir = undefined;
+    _cachedProjectRoot = undefined;
+}
+/**
+ * Get the .dual-agent/ state directory path.
+ * When projectDir is explicitly given, uses that path directly.
+ * When omitted, searches upward from CWD to find .dual-agent/ (like git).
+ */
+function stateDir(projectDir) {
+    if (projectDir !== undefined) {
+        return path.join(projectDir, exports.STATE_DIR);
+    }
+    const root = findProjectRoot();
+    return path.join(root || process.cwd(), exports.STATE_DIR);
+}
+/**
+ * Check that a session exists. Searches upward from CWD when no explicit dir given.
+ */
+function checkSession(projectDir) {
+    const dir = projectDir !== undefined ? stateDir(projectDir) : stateDir();
     if (!fs.existsSync(dir)) {
         console.error('Error: Session not initialized. Run: ralph-lisa init "task description"');
         process.exit(1);
@@ -87,22 +149,22 @@ function appendFile(filePath, content) {
     fs.mkdirSync(path.dirname(filePath), { recursive: true });
     fs.appendFileSync(filePath, content, "utf-8");
 }
-function getTurn(projectDir = process.cwd()) {
+function getTurn(projectDir) {
     return readFile(path.join(stateDir(projectDir), "turn.txt")) || "ralph";
 }
-function setTurn(turn, projectDir = process.cwd()) {
+function setTurn(turn, projectDir) {
     writeFile(path.join(stateDir(projectDir), "turn.txt"), turn);
 }
-function getRound(projectDir = process.cwd()) {
+function getRound(projectDir) {
     return readFile(path.join(stateDir(projectDir), "round.txt")) || "?";
 }
-function setRound(round, projectDir = process.cwd()) {
+function setRound(round, projectDir) {
     writeFile(path.join(stateDir(projectDir), "round.txt"), String(round));
 }
-function getStep(projectDir = process.cwd()) {
+function getStep(projectDir) {
     return readFile(path.join(stateDir(projectDir), "step.txt")) || "?";
 }
-function setStep(step, projectDir = process.cwd()) {
+function setStep(step, projectDir) {
     writeFile(path.join(stateDir(projectDir), "step.txt"), step);
 }
 function extractTag(content) {
@@ -124,7 +186,7 @@ function timeShort() {
     const pad = (n) => String(n).padStart(2, "0");
     return `${pad(d.getHours())}:${pad(d.getMinutes())}:${pad(d.getSeconds())}`;
 }
-function appendHistory(role, content, projectDir = process.cwd()) {
+function appendHistory(role, content, projectDir) {
     const tag = extractTag(content);
     const summary = extractSummary(content);
     const round = getRound(projectDir);
@@ -142,7 +204,7 @@ ${content}
 `;
     appendFile(path.join(stateDir(projectDir), "history.md"), entry);
 }
-function updateLastAction(role, content, projectDir = process.cwd()) {
+function updateLastAction(role, content, projectDir) {
     const tag = extractTag(content);
     const summary = extractSummary(content);
     const ts = timeShort();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ralph-lisa-loop",
-  "version": "0.3.8",
+  "version": "0.3.9",
   "description": "Turn-based dual-agent collaboration: Ralph codes, Lisa reviews, consensus required.",
   "bin": {
     "ralph-lisa": "dist/cli.js"
@@ -13,6 +13,7 @@
   },
   "files": [
     "dist/",
+    "!dist/test/",
     "templates/"
   ],
   "keywords": [