ralph-lisa-loop 3.0.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):
+ *   off   - no checks (default)
+ *   warn  - print warnings, don't block
+ *   block - print warnings AND exit(1) if violations found
+ */
+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,101 @@
+"use strict";
+/**
+ * Policy layer for Ralph-Lisa Loop.
+ * Checks submissions for required content (warn or block mode).
+ *
+ * Modes (RL_POLICY_MODE env):
+ *   off   - no checks (default)
+ *   warn  - print warnings, don't block
+ *   block - print warnings AND exit(1) if violations found
+ */
+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 || "off";
+    if (mode === "warn" || mode === "block" || mode === "off")
+        return mode;
+    return "off";
+}
+/**
+ * Check Ralph's submission for policy violations.
+ */
+function checkRalph(tag, content) {
+    const violations = [];
+    // [CODE] or [FIX] must include Test Results
+    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.`,
+            });
+        }
+    }
+    // [RESEARCH] must have substance
+    if (tag === "RESEARCH") {
+        // 4 distinct field groups, each with Chinese + English variants
+        const fieldGroups = [
+            ["参考实现", "reference"],
+            ["关键类型", "key type"],
+            ["数据格式", "data format", "数据结构", "data structure"],
+            ["验证方式", "verification"],
+        ];
+        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 (参考实现/关键类型/数据结构/验证方式) 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
+    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.`,
+            });
+        }
+    }
+    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 {};

package/dist/test/cli.test.js

@@ -0,0 +1,134 @@
+"use strict";
+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 });
+const node_test_1 = require("node:test");
+const assert = __importStar(require("node:assert"));
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const node_child_process_1 = require("node:child_process");
+const CLI = path.join(__dirname, "..", "cli.js");
+const TMP = path.join(__dirname, "..", "..", ".test-tmp");
+function run(...args) {
+    try {
+        const stdout = (0, node_child_process_1.execFileSync)(process.execPath, [CLI, ...args], {
+            cwd: TMP,
+            encoding: "utf-8",
+            env: { ...process.env, RL_POLICY_MODE: "off" },
+        });
+        return { stdout, exitCode: 0 };
+    }
+    catch (e) {
+        return { stdout: (e.stdout || "") + (e.stderr || ""), exitCode: e.status };
+    }
+}
+(0, node_test_1.describe)("CLI: policy check-consensus", () => {
+    (0, node_test_1.beforeEach)(() => {
+        fs.rmSync(TMP, { recursive: true, force: true });
+        fs.mkdirSync(TMP, { recursive: true });
+        run("init", "--minimal");
+    });
+    (0, node_test_1.afterEach)(() => {
+        fs.rmSync(TMP, { recursive: true, force: true });
+    });
+    (0, node_test_1.it)("passes when both agents submit CONSENSUS", () => {
+        run("submit-ralph", "[CONSENSUS] Agreed on plan");
+        run("submit-lisa", "[CONSENSUS] Agreed\n\n- All good");
+        const r = run("policy", "check-consensus");
+        assert.strictEqual(r.exitCode, 0);
+        assert.ok(r.stdout.includes("Consensus reached"));
+    });
+    (0, node_test_1.it)("fails when neither agent has CONSENSUS", () => {
+        run("submit-ralph", "[CODE] Done\n\nTest Results\n- pass");
+        run("submit-lisa", "[PASS] OK\n\n- Clean code");
+        const r = run("policy", "check-consensus");
+        assert.strictEqual(r.exitCode, 1);
+        assert.ok(r.stdout.includes("NOT reached"));
+    });
+    (0, node_test_1.it)("fails when only Ralph has CONSENSUS", () => {
+        run("submit-ralph", "[CONSENSUS] I agree");
+        run("submit-lisa", "[PASS] OK\n\n- Looks good");
+        const r = run("policy", "check-consensus");
+        assert.strictEqual(r.exitCode, 1);
+        assert.ok(r.stdout.includes("Lisa"));
+    });
+});
+(0, node_test_1.describe)("CLI: policy check-next-step", () => {
+    (0, node_test_1.beforeEach)(() => {
+        fs.rmSync(TMP, { recursive: true, force: true });
+        fs.mkdirSync(TMP, { recursive: true });
+        run("init", "--minimal");
+    });
+    (0, node_test_1.afterEach)(() => {
+        fs.rmSync(TMP, { recursive: true, force: true });
+    });
+    (0, node_test_1.it)("passes when both CONSENSUS and policy OK", () => {
+        run("submit-ralph", "[CONSENSUS] Agreed on approach");
+        run("submit-lisa", "[CONSENSUS] Confirmed\n\n- Sound plan");
+        const r = run("policy", "check-next-step");
+        assert.strictEqual(r.exitCode, 0);
+        assert.ok(r.stdout.includes("Ready to proceed"));
+    });
+    (0, node_test_1.it)("fails with comprehensive issues", () => {
+        run("submit-ralph", "[CODE] Done");
+        run("submit-lisa", "[PASS] OK");
+        const r = run("policy", "check-next-step");
+        assert.strictEqual(r.exitCode, 1);
+        // Should report: no consensus + missing test results + missing reason
+        assert.ok(r.stdout.includes("not [CONSENSUS]"));
+    });
+});
+(0, node_test_1.describe)("CLI: init --minimal", () => {
+    (0, node_test_1.beforeEach)(() => {
+        fs.rmSync(TMP, { recursive: true, force: true });
+        fs.mkdirSync(TMP, { recursive: true });
+    });
+    (0, node_test_1.afterEach)(() => {
+        fs.rmSync(TMP, { recursive: true, force: true });
+    });
+    (0, node_test_1.it)("creates only .dual-agent/, no project files", () => {
+        run("init", "--minimal");
+        assert.ok(fs.existsSync(path.join(TMP, ".dual-agent", "turn.txt")));
+        assert.ok(!fs.existsSync(path.join(TMP, "CLAUDE.md")));
+        assert.ok(!fs.existsSync(path.join(TMP, "CODEX.md")));
+        assert.ok(!fs.existsSync(path.join(TMP, ".claude")));
+        assert.ok(!fs.existsSync(path.join(TMP, ".codex")));
+    });
+    (0, node_test_1.it)("allows submit after minimal init", () => {
+        run("init", "--minimal");
+        const r = run("submit-ralph", "[PLAN] Test plan");
+        assert.strictEqual(r.exitCode, 0);
+        assert.ok(r.stdout.includes("Submitted"));
+    });
+});

package/dist/test/policy.test.d.ts

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

package/dist/test/policy.test.js

@@ -0,0 +1,107 @@
+"use strict";
+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 });
+const node_test_1 = require("node:test");
+const assert = __importStar(require("node:assert"));
+const policy_js_1 = require("../policy.js");
+(0, node_test_1.describe)("checkRalph", () => {
+    (0, node_test_1.it)("warns when CODE missing Test Results", () => {
+        const violations = (0, policy_js_1.checkRalph)("CODE", "[CODE] Done\n\nImplemented it.");
+        assert.strictEqual(violations.length, 1);
+        assert.strictEqual(violations[0].rule, "test-results");
+    });
+    (0, node_test_1.it)("passes when CODE includes Test Results", () => {
+        const violations = (0, policy_js_1.checkRalph)("CODE", "[CODE] Done\n\nTest Results\n- Passed");
+        assert.strictEqual(violations.length, 0);
+    });
+    (0, node_test_1.it)("warns when FIX missing Test Results", () => {
+        const violations = (0, policy_js_1.checkRalph)("FIX", "[FIX] Fixed\n\nChanged code.");
+        assert.strictEqual(violations.length, 1);
+    });
+    (0, node_test_1.it)("no warnings for PLAN", () => {
+        const violations = (0, policy_js_1.checkRalph)("PLAN", "[PLAN] Plan\n\nDetails");
+        assert.strictEqual(violations.length, 0);
+    });
+    (0, node_test_1.it)("warns when RESEARCH has no substance", () => {
+        const violations = (0, policy_js_1.checkRalph)("RESEARCH", "[RESEARCH] Done");
+        assert.strictEqual(violations.length, 1);
+        assert.strictEqual(violations[0].rule, "research-content");
+    });
+    (0, node_test_1.it)("passes RESEARCH with 2+ fields (Chinese)", () => {
+        const violations = (0, policy_js_1.checkRalph)("RESEARCH", "[RESEARCH] Done\n\n参考实现: file.ts\n关键类型: MyType\n验证方式: tested");
+        assert.strictEqual(violations.length, 0);
+    });
+    (0, node_test_1.it)("passes RESEARCH with exactly 2 fields", () => {
+        // Bug fix: previously ceil(2/2)=1 incorrectly warned
+        const violations = (0, policy_js_1.checkRalph)("RESEARCH", "[RESEARCH] Done\n\n参考实现: file.ts\n验证方式: curl tested");
+        assert.strictEqual(violations.length, 0);
+    });
+    (0, node_test_1.it)("passes RESEARCH with 2 English fields", () => {
+        const violations = (0, policy_js_1.checkRalph)("RESEARCH", "[RESEARCH] Done\n\nReference: file.ts\nVerification: tested");
+        assert.strictEqual(violations.length, 0);
+    });
+    (0, node_test_1.it)("passes RESEARCH with mixed Chinese-English fields", () => {
+        const violations = (0, policy_js_1.checkRalph)("RESEARCH", "[RESEARCH] Done\n\n参考实现: file.ts\nVerification: tested");
+        assert.strictEqual(violations.length, 0);
+    });
+    (0, node_test_1.it)("warns RESEARCH with only 1 field", () => {
+        const violations = (0, policy_js_1.checkRalph)("RESEARCH", "[RESEARCH] Done\n\n参考实现: file.ts");
+        // 1 field + only 2 lines = warns
+        assert.strictEqual(violations.length, 1);
+    });
+    (0, node_test_1.it)("passes RESEARCH with substantial content (>3 lines) even without fields", () => {
+        const violations = (0, policy_js_1.checkRalph)("RESEARCH", "[RESEARCH] API analysis\n\nLine 1\nLine 2\nLine 3\nLine 4");
+        assert.strictEqual(violations.length, 0);
+    });
+});
+(0, node_test_1.describe)("checkLisa", () => {
+    (0, node_test_1.it)("warns when PASS has no reason", () => {
+        const violations = (0, policy_js_1.checkLisa)("PASS", "[PASS] Looks good");
+        assert.strictEqual(violations.length, 1);
+        assert.strictEqual(violations[0].rule, "reason-required");
+    });
+    (0, node_test_1.it)("passes when PASS has reason", () => {
+        const violations = (0, policy_js_1.checkLisa)("PASS", "[PASS] Looks good\n\n- Clean code\n- Tests pass");
+        assert.strictEqual(violations.length, 0);
+    });
+    (0, node_test_1.it)("warns when NEEDS_WORK has no reason", () => {
+        const violations = (0, policy_js_1.checkLisa)("NEEDS_WORK", "[NEEDS_WORK] Fix it");
+        assert.strictEqual(violations.length, 1);
+    });
+    (0, node_test_1.it)("no warnings for DISCUSS", () => {
+        const violations = (0, policy_js_1.checkLisa)("DISCUSS", "[DISCUSS] About this");
+        assert.strictEqual(violations.length, 0);
+    });
+});

package/dist/test/state.test.d.ts

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

package/dist/test/state.test.js

@@ -0,0 +1,82 @@
+"use strict";
+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 });
+const node_test_1 = require("node:test");
+const assert = __importStar(require("node:assert"));
+const state_js_1 = require("../state.js");
+(0, node_test_1.describe)("extractTag", () => {
+    (0, node_test_1.it)("extracts known tags", () => {
+        assert.strictEqual((0, state_js_1.extractTag)("[PLAN] My plan"), "PLAN");
+        assert.strictEqual((0, state_js_1.extractTag)("[CODE] Implementation done"), "CODE");
+        assert.strictEqual((0, state_js_1.extractTag)("[RESEARCH] Results"), "RESEARCH");
+        assert.strictEqual((0, state_js_1.extractTag)("[CHALLENGE] I disagree"), "CHALLENGE");
+        assert.strictEqual((0, state_js_1.extractTag)("[PASS] Looks good"), "PASS");
+        assert.strictEqual((0, state_js_1.extractTag)("[NEEDS_WORK] Fix this"), "NEEDS_WORK");
+        assert.strictEqual((0, state_js_1.extractTag)("[DISCUSS] Let's talk"), "DISCUSS");
+        assert.strictEqual((0, state_js_1.extractTag)("[QUESTION] What about?"), "QUESTION");
+        assert.strictEqual((0, state_js_1.extractTag)("[CONSENSUS] Agreed"), "CONSENSUS");
+        assert.strictEqual((0, state_js_1.extractTag)("[FIX] Fixed the bug"), "FIX");
+    });
+    (0, node_test_1.it)("returns empty for invalid tags", () => {
+        assert.strictEqual((0, state_js_1.extractTag)("No tag here"), "");
+        assert.strictEqual((0, state_js_1.extractTag)("[INVALID] Nope"), "");
+        assert.strictEqual((0, state_js_1.extractTag)(""), "");
+    });
+});
+(0, node_test_1.describe)("extractSummary", () => {
+    (0, node_test_1.it)("extracts summary after tag", () => {
+        assert.strictEqual((0, state_js_1.extractSummary)("[PLAN] My plan"), "My plan");
+        assert.strictEqual((0, state_js_1.extractSummary)("[CODE] Implementation done"), "Implementation done");
+    });
+    (0, node_test_1.it)("returns full line if no tag", () => {
+        assert.strictEqual((0, state_js_1.extractSummary)("No tag here"), "No tag here");
+    });
+});
+(0, node_test_1.describe)("VALID_TAGS", () => {
+    (0, node_test_1.it)("contains all expected tags", () => {
+        const tags = state_js_1.VALID_TAGS.split("|");
+        assert.ok(tags.includes("PLAN"));
+        assert.ok(tags.includes("RESEARCH"));
+        assert.ok(tags.includes("CODE"));
+        assert.ok(tags.includes("FIX"));
+        assert.ok(tags.includes("PASS"));
+        assert.ok(tags.includes("NEEDS_WORK"));
+        assert.ok(tags.includes("CHALLENGE"));
+        assert.ok(tags.includes("DISCUSS"));
+        assert.ok(tags.includes("QUESTION"));
+        assert.ok(tags.includes("CONSENSUS"));
+        assert.strictEqual(tags.length, 10);
+    });
+});