ralph-lisa-loop 0.3.0

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * ralph-lisa-loop - public API
+ */
+export * from "./state.js";
+export * from "./policy.js";

package/dist/index.js

@@ -0,0 +1,21 @@
+"use strict";
+/**
+ * ralph-lisa-loop - public API
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./state.js"), exports);
+__exportStar(require("./policy.js"), exports);

package/dist/policy.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Policy layer for Ralph-Lisa Loop.
+ * Checks submissions for required content (warn or block mode).
+ *
+ * Modes (RL_POLICY_MODE env):
+ *   warn  - print warnings, don't block (default)
+ *   block - print warnings AND exit(1) if violations found
+ *   off   - no checks
+ */
+export type PolicyMode = "off" | "warn" | "block";
+export interface PolicyViolation {
+    rule: string;
+    message: string;
+}
+export declare function getPolicyMode(): PolicyMode;
+/**
+ * Check Ralph's submission for policy violations.
+ */
+export declare function checkRalph(tag: string, content: string): PolicyViolation[];
+/**
+ * Check Lisa's submission for policy violations.
+ */
+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.
+ */
+export declare function runPolicyCheck(role: "ralph" | "lisa", tag: string, content: string): boolean;

package/dist/policy.js

@@ -0,0 +1,112 @@
+"use strict";
+/**
+ * Policy layer for Ralph-Lisa Loop.
+ * Checks submissions for required content (warn or block mode).
+ *
+ * Modes (RL_POLICY_MODE env):
+ *   warn  - print warnings, don't block (default)
+ *   block - print warnings AND exit(1) if violations found
+ *   off   - no checks
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getPolicyMode = getPolicyMode;
+exports.checkRalph = checkRalph;
+exports.checkLisa = checkLisa;
+exports.runPolicyCheck = runPolicyCheck;
+function getPolicyMode() {
+    const mode = process.env.RL_POLICY_MODE || "warn";
+    if (mode === "warn" || mode === "block" || mode === "off")
+        return mode;
+    return "warn";
+}
+/**
+ * Check Ralph's submission for policy violations.
+ */
+function checkRalph(tag, content) {
+    const violations = [];
+    // [CODE] or [FIX] must include Test Results and file:line references
+    if (tag === "CODE" || tag === "FIX") {
+        if (!content.includes("Test Results") &&
+            !content.includes("test results") &&
+            !content.includes("Test results")) {
+            violations.push({
+                rule: "test-results",
+                message: `[${tag}] submission missing "Test Results" section.`,
+            });
+        }
+        if (!/\w+\.\w+:\d+/.test(content)) {
+            violations.push({
+                rule: "file-line-ref",
+                message: `[${tag}] submission must include at least one file:line reference (e.g., commands.ts:42).`,
+            });
+        }
+    }
+    // [RESEARCH] must have substance
+    if (tag === "RESEARCH") {
+        const fieldGroups = [
+            ["reference", "reference implementation"],
+            ["key type", "key types"],
+            ["data format", "data structure"],
+            ["verification", "verified"],
+        ];
+        const lc = content.toLowerCase();
+        const matchedFields = fieldGroups.filter((variants) => variants.some((v) => lc.includes(v.toLowerCase()))).length;
+        const hasSubstantialContent = content.split("\n").length > 3;
+        if (matchedFields < 2 && !hasSubstantialContent) {
+            violations.push({
+                rule: "research-content",
+                message: "[RESEARCH] submission needs at least 2 fields (reference/key types/data structure/verification) or equivalent summary with evidence.",
+            });
+        }
+    }
+    return violations;
+}
+/**
+ * Check Lisa's submission for policy violations.
+ */
+function checkLisa(tag, content) {
+    const violations = [];
+    // [PASS] or [NEEDS_WORK] must include at least 1 reason and file:line references
+    if (tag === "PASS" || tag === "NEEDS_WORK") {
+        // Content after the first line (tag+summary) should have substance
+        const lines = content.split("\n");
+        const bodyLines = lines.slice(1).filter((l) => l.trim().length > 0);
+        if (bodyLines.length === 0) {
+            violations.push({
+                rule: "reason-required",
+                message: `[${tag}] submission must include at least 1 reason.`,
+            });
+        }
+        if (!/\w+\.\w+:\d+/.test(content)) {
+            violations.push({
+                rule: "file-line-ref",
+                message: `[${tag}] submission must include at least one file:line reference (e.g., commands.ts:42).`,
+            });
+        }
+    }
+    return violations;
+}
+/**
+ * Run policy checks and handle output/exit based on mode.
+ * Returns true if submission should proceed, false if blocked.
+ */
+function runPolicyCheck(role, tag, content) {
+    const mode = getPolicyMode();
+    if (mode === "off")
+        return true;
+    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("");
+    if (mode === "block") {
+        console.error("Policy mode is 'block'. Submission rejected.");
+        return false;
+    }
+    // warn mode: print but continue
+    return true;
+}

package/dist/state.d.ts

@@ -0,0 +1,24 @@
+/**
+ * State management for Ralph-Lisa Loop.
+ * Manages .dual-agent/ directory and all state files.
+ */
+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 stateDir(projectDir?: string): string;
+export declare function checkSession(projectDir?: string): void;
+export declare function readFile(filePath: string): string;
+export declare function writeFile(filePath: string, content: string): void;
+export declare function appendFile(filePath: string, content: string): void;
+export declare function getTurn(projectDir?: string): string;
+export declare function setTurn(turn: string, projectDir?: string): void;
+export declare function getRound(projectDir?: string): string;
+export declare function setRound(round: number, projectDir?: string): void;
+export declare function getStep(projectDir?: string): string;
+export declare function setStep(step: string, projectDir?: string): void;
+export declare function extractTag(content: string): string;
+export declare function extractSummary(content: string): string;
+export declare function timestamp(): string;
+export declare function timeShort(): string;
+export declare function appendHistory(role: string, content: string, projectDir?: string): void;
+export declare function updateLastAction(role: string, content: string, projectDir?: string): void;

package/dist/state.js

@@ -0,0 +1,150 @@
+"use strict";
+/**
+ * State management for Ralph-Lisa Loop.
+ * Manages .dual-agent/ directory and all state files.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VALID_TAGS = exports.ARCHIVE_DIR = exports.STATE_DIR = void 0;
+exports.stateDir = stateDir;
+exports.checkSession = checkSession;
+exports.readFile = readFile;
+exports.writeFile = writeFile;
+exports.appendFile = appendFile;
+exports.getTurn = getTurn;
+exports.setTurn = setTurn;
+exports.getRound = getRound;
+exports.setRound = setRound;
+exports.getStep = getStep;
+exports.setStep = setStep;
+exports.extractTag = extractTag;
+exports.extractSummary = extractSummary;
+exports.timestamp = timestamp;
+exports.timeShort = timeShort;
+exports.appendHistory = appendHistory;
+exports.updateLastAction = updateLastAction;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+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);
+}
+function checkSession(projectDir = process.cwd()) {
+    const dir = stateDir(projectDir);
+    if (!fs.existsSync(dir)) {
+        console.error('Error: Session not initialized. Run: ralph-lisa init "task description"');
+        process.exit(1);
+    }
+}
+function readFile(filePath) {
+    try {
+        return fs.readFileSync(filePath, "utf-8").trim();
+    }
+    catch {
+        return "";
+    }
+}
+function writeFile(filePath, content) {
+    fs.mkdirSync(path.dirname(filePath), { recursive: true });
+    fs.writeFileSync(filePath, content, "utf-8");
+}
+function appendFile(filePath, content) {
+    fs.mkdirSync(path.dirname(filePath), { recursive: true });
+    fs.appendFileSync(filePath, content, "utf-8");
+}
+function getTurn(projectDir = process.cwd()) {
+    return readFile(path.join(stateDir(projectDir), "turn.txt")) || "ralph";
+}
+function setTurn(turn, projectDir = process.cwd()) {
+    writeFile(path.join(stateDir(projectDir), "turn.txt"), turn);
+}
+function getRound(projectDir = process.cwd()) {
+    return readFile(path.join(stateDir(projectDir), "round.txt")) || "?";
+}
+function setRound(round, projectDir = process.cwd()) {
+    writeFile(path.join(stateDir(projectDir), "round.txt"), String(round));
+}
+function getStep(projectDir = process.cwd()) {
+    return readFile(path.join(stateDir(projectDir), "step.txt")) || "?";
+}
+function setStep(step, projectDir = process.cwd()) {
+    writeFile(path.join(stateDir(projectDir), "step.txt"), step);
+}
+function extractTag(content) {
+    const firstLine = content.split("\n")[0] || "";
+    const match = firstLine.match(TAG_RE);
+    return match ? match[1] : "";
+}
+function extractSummary(content) {
+    const firstLine = content.split("\n")[0] || "";
+    return firstLine.replace(TAG_RE, "").trim();
+}
+function timestamp() {
+    const d = new Date();
+    const pad = (n) => String(n).padStart(2, "0");
+    return `${d.getFullYear()}-${pad(d.getMonth() + 1)}-${pad(d.getDate())} ${pad(d.getHours())}:${pad(d.getMinutes())}:${pad(d.getSeconds())}`;
+}
+function timeShort() {
+    const d = new Date();
+    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()) {
+    const tag = extractTag(content);
+    const summary = extractSummary(content);
+    const round = getRound(projectDir);
+    const step = getStep(projectDir);
+    const ts = timestamp();
+    const entry = `
+---
+
+## [${role}] [${tag}] Round ${round} | Step: ${step}
+**Time**: ${ts}
+**Summary**: ${summary}
+
+${content}
+
+`;
+    appendFile(path.join(stateDir(projectDir), "history.md"), entry);
+}
+function updateLastAction(role, content, projectDir = process.cwd()) {
+    const tag = extractTag(content);
+    const summary = extractSummary(content);
+    const ts = timeShort();
+    writeFile(path.join(stateDir(projectDir), "last_action.txt"), `[${tag}] ${summary} (by ${role}, ${ts})`);
+}

package/dist/test/cli.test.d.ts

@@ -0,0 +1 @@
+export {};