minimal-agent 0.2.0 → 0.3.0

package/plugins/ralph-wiggum/test/goalState.test.ts

@@ -1,410 +0,0 @@
-import { describe, expect, it } from 'bun:test';
-import { mkdirSync, rmSync, existsSync } from 'node:fs';
-import { join } from 'node:path';
-import { tmpdir } from 'node:os';
-import { GoalState, Phase } from '../src/goalState.ts';
-
-function createTempDir(): string {
-  const dir = join(tmpdir(), `goalstate-test-${Date.now()}-${Math.random().toString(36).slice(2)}`);
-  mkdirSync(dir, { recursive: true });
-  return dir;
-}
-
-function cleanup(dir: string): void {
-  try {
-    rmSync(dir, { recursive: true });
-  } catch {
-  }
-}
-
-describe('goalState', () => {
-  describe('init', () => {
-    it('创建所有状态文件', async () => {
-      const tmpDir = createTempDir();
-      try {
-        const gs = new GoalState(tmpDir);
-        await gs.init('Build a REST API', []);
-
-        expect(existsSync(join(tmpDir, '.minimal-agent', 'goal.md'))).toBe(true);
-        expect(existsSync(join(tmpDir, '.minimal-agent', 'completion.md'))).toBe(true);
-        expect(existsSync(join(tmpDir, '.minimal-agent', 'phase.md'))).toBe(true);
-        expect(existsSync(join(tmpDir, '.minimal-agent', 'progress.md'))).toBe(true);
-        expect(existsSync(join(tmpDir, '.minimal-agent', 'learnings.md'))).toBe(true);
-        expect(existsSync(join(tmpDir, '.minimal-agent', 'decisions.md'))).toBe(true);
-      } finally {
-        cleanup(tmpDir);
-      }
-    });
-
-    it('goal.md 包含目标文本', async () => {
-      const tmpDir = createTempDir();
-      try {
-        const gs = new GoalState(tmpDir);
-        await gs.init('Fix auth bug in login module', []);
-        expect(gs.goal).toContain('Fix auth bug');
-      } finally {
-        cleanup(tmpDir);
-      }
-    });
-
-    it('初始阶段为 PLAN', async () => {
-      const tmpDir = createTempDir();
-      try {
-        const gs = new GoalState(tmpDir);
-        await gs.init('Test goal', []);
-        expect(gs.currentPhase).toBe(Phase.PLAN);
-      } finally {
-        cleanup(tmpDir);
-      }
-    });
-
-    it('重复 init 不覆盖已有文件', async () => {
-      const tmpDir = createTempDir();
-      try {
-        const gs = new GoalState(tmpDir);
-        await gs.init('First goal', []);
-        await gs.init('Second goal', []);
-        expect(gs.goal).toContain('First goal');
-      } finally {
-        cleanup(tmpDir);
-      }
-    });
-  });
-
-  describe('phase management', () => {
-    it('PLAN → BUILD 合法切换', async () => {
-      const tmpDir = createTempDir();
-      try {
-        const gs = new GoalState(tmpDir);
-        await gs.init('Test', []);
-        await gs.setPhase(Phase.BUILD, 'plan_complete');
-        expect(gs.currentPhase).toBe(Phase.BUILD);
-      } finally {
-        cleanup(tmpDir);
-      }
-    });
-
-    it('setPhase 的 reason 是日志文本，不参与 FSM 校验', async () => {
-      const tmpDir = createTempDir();
-      try {
-        const gs = new GoalState(tmpDir);
-        await gs.init('Test', []);
-        // 用任意中文 reason，合法目标阶段仍应成功
-        await gs.setPhase(Phase.BUILD, '随便写的日志文本，不该被当成事件名');
-        expect(gs.currentPhase).toBe(Phase.BUILD);
-      } finally {
-        cleanup(tmpDir);
-      }
-    });
-
-    it('非法阶段切换抛出错误（基于目标阶段，与 reason 无关）', async () => {
-      const tmpDir = createTempDir();
-      try {
-        const gs = new GoalState(tmpDir);
-        await gs.init('Test', []);
-        // PLAN → VERIFY 在 PHASE_TRANSITIONS[PLAN] 的 values 中不存在
-        await expect(
-          gs.setPhase(Phase.VERIFY, '哪怕写一个看似合法的英文 event 名也不行'),
-        ).rejects.toThrow();
-      } finally {
-        cleanup(tmpDir);
-      }
-    });
-
-    it('forceSetPhase 允许任意切换', async () => {
-      const tmpDir = createTempDir();
-      try {
-        const gs = new GoalState(tmpDir);
-        await gs.init('Test', []);
-        await gs.forceSetPhase(Phase.HEAL, 'manual override');
-        expect(gs.currentPhase).toBe(Phase.HEAL);
-      } finally {
-        cleanup(tmpDir);
-      }
-    });
-  });
-
-  describe('progress log', () => {
-    it('追加进度日志', async () => {
-      const tmpDir = createTempDir();
-      try {
-        const gs = new GoalState(tmpDir);
-        await gs.init('Test', []);
-        await gs.appendProgress('Iteration 1: started');
-        await gs.appendProgress('Iteration 2: done');
-
-        const tail = gs.tailProgress(10);
-        expect(tail).toContain('Iteration 1: started');
-        expect(tail).toContain('Iteration 2: done');
-      } finally {
-        cleanup(tmpDir);
-      }
-    });
-
-    it('tailProgress 只返回最近 N 行', async () => {
-      const tmpDir = createTempDir();
-      try {
-        const gs = new GoalState(tmpDir);
-        await gs.init('Test', []);
-        for (let i = 0; i < 20; i++) {
-          await gs.appendProgress(`Line ${i}`);
-        }
-
-        const tail = gs.tailProgress(3);
-        const lines = tail.split('\n').filter(Boolean);
-        expect(lines.length).toBe(3);
-        expect(lines[0]).toContain('Line 17');
-      } finally {
-        cleanup(tmpDir);
-      }
-    });
-  });
-
-  describe('learnings', () => {
-    it('追加教训', async () => {
-      const tmpDir = createTempDir();
-      try {
-        const gs = new GoalState(tmpDir);
-        await gs.init('Test', []);
-        await gs.appendLearning('Always backup before modifying settings.py');
-        await gs.appendLearning('Use relative imports in routes/');
-
-        expect(gs.learnings).toContain('backup before modifying settings.py');
-        expect(gs.learnings).toContain('relative imports in routes/');
-      } finally {
-        cleanup(tmpDir);
-      }
-    });
-
-    it('空 learnings 返回空字符串', async () => {
-      const tmpDir = createTempDir();
-      try {
-        const gs = new GoalState(tmpDir);
-        await gs.init('Test', []);
-        expect(gs.learnings).toBe('');
-      } finally {
-        cleanup(tmpDir);
-      }
-    });
-
-    it('learnings 超过 20 行时只返回尾部 20 行（防 context 膨胀）', async () => {
-      const tmpDir = createTempDir();
-      try {
-        const gs = new GoalState(tmpDir);
-        await gs.init('Test', []);
-        for (let i = 0; i < 50; i++) {
-          await gs.appendLearning(`lesson-${i}`);
-        }
-
-        const tail = gs.learnings;
-        const lines = tail.split('\n').filter(Boolean);
-        expect(lines.length).toBe(20);
-        // 最早的应该已经被裁掉
-        expect(tail).not.toContain('lesson-0\n');
-        expect(tail).not.toContain('lesson-29\n');
-        // 最新一条仍在
-        expect(tail).toContain('lesson-49');
-      } finally {
-        cleanup(tmpDir);
-      }
-    });
-  });
-
-  describe('decision log', () => {
-    it('记录决策', async () => {
-      const tmpDir = createTempDir();
-      try {
-        const gs = new GoalState(tmpDir);
-        await gs.init('Test', []);
-        await gs.recordDecision(
-          { iteration: 5, phase: Phase.PLAN, summary: 'Auth implementation approach' },
-          ['JWT', 'Session', 'OAuth'],
-          'JWT',
-          'Single service, simpler for frontend',
-        );
-
-        const similar = gs.findSimilarDecisions(
-          { iteration: 10, phase: Phase.PLAN, summary: 'Auth implementation approach' },
-        );
-        expect(similar).toHaveLength(1);
-        expect(similar[0].chosen).toBe('JWT');
-      } finally {
-        cleanup(tmpDir);
-      }
-    });
-
-    it('无相似决策时返回空数组', async () => {
-      const tmpDir = createTempDir();
-      try {
-        const gs = new GoalState(tmpDir);
-        await gs.init('Test', []);
-        const similar = gs.findSimilarDecisions({
-          iteration: 1,
-          phase: Phase.PLAN,
-          summary: 'Database choice',
-        });
-        expect(similar).toHaveLength(0);
-      } finally {
-        cleanup(tmpDir);
-      }
-    });
-
-    it('summarizeDecisions 返回格式化摘要', async () => {
-      const tmpDir = createTempDir();
-      try {
-        const gs = new GoalState(tmpDir);
-        await gs.init('Test', []);
-        await gs.recordDecision(
-          { iteration: 3, phase: Phase.PLAN, summary: 'DB' },
-          ['PostgreSQL', 'MySQL', 'SQLite'],
-          'PostgreSQL',
-          'JSON support needed',
-        );
-
-        const summary = gs.summarizeDecisions(5);
-        expect(summary).toContain('PostgreSQL');
-        expect(summary).toContain('迭代 3');
-      } finally {
-        cleanup(tmpDir);
-      }
-    });
-  });
-
-  describe('composeContext', () => {
-    it('组装包含目标 + 阶段 + 本轮任务', async () => {
-      const tmpDir = createTempDir();
-      try {
-        const gs = new GoalState(tmpDir);
-        await gs.init('Build user auth module', []);
-        const ctx = gs.composeContext(5);
-
-        expect(ctx).toContain('不可变目标');
-        expect(ctx).toContain('Build user auth module');
-        expect(ctx).toContain('当前阶段: PLAN');
-        expect(ctx).toContain('本轮任务 (迭代 5)');
-      } finally {
-        cleanup(tmpDir);
-      }
-    });
-
-    it('composeContext 包含 learnings（如果有）', async () => {
-      const tmpDir = createTempDir();
-      try {
-        const gs = new GoalState(tmpDir);
-        await gs.init('Test', []);
-        await gs.appendLearning('Lesson one');
-
-        const ctx = gs.composeContext(1);
-        expect(ctx).toContain('关键教训');
-        expect(ctx).toContain('Lesson one');
-      } finally {
-        cleanup(tmpDir);
-      }
-    });
-
-    it('composeContext 不包含空的 learnings 块', async () => {
-      const tmpDir = createTempDir();
-      try {
-        const gs = new GoalState(tmpDir);
-        await gs.init('Test', []);
-
-        const ctx = gs.composeContext(1);
-        expect(ctx).not.toContain('关键教训');
-      } finally {
-        cleanup(tmpDir);
-      }
-    });
-  });
-
-  describe('cleanup', () => {
-    it('清理后文件不存在（await）', async () => {
-      const tmpDir = createTempDir();
-      try {
-        const gs = new GoalState(tmpDir);
-        await gs.init('Test', []);
-        await gs.cleanup();
-
-        expect(existsSync(join(tmpDir, '.minimal-agent', 'goal.md'))).toBe(false);
-      } finally {
-        cleanup(tmpDir);
-      }
-    });
-
-    it('清理后空目录也被删除（await）', async () => {
-      const tmpDir = createTempDir();
-      try {
-        const gs = new GoalState(tmpDir);
-        await gs.init('Test', []);
-        await gs.cleanup();
-
-        expect(existsSync(join(tmpDir, '.minimal-agent'))).toBe(false);
-      } finally {
-        cleanup(tmpDir);
-      }
-    });
-  });
-
-  describe('reset', () => {
-    it('reset 后旧目标被清除，新 init 写入新目标', async () => {
-      const tmpDir = createTempDir();
-      try {
-        const gs = new GoalState(tmpDir);
-        await gs.init('Old goal', []);
-        expect(gs.goal).toContain('Old goal');
-
-        await gs.reset();
-        expect(gs.goal).toBe('');
-
-        await gs.init('New goal', []);
-        expect(gs.goal).toContain('New goal');
-      } finally {
-        cleanup(tmpDir);
-      }
-    });
-  });
-
-  describe('sessionTag', () => {
-    it('不传 sessionTag 使用默认目录 .minimal-agent', async () => {
-      const tmpDir = createTempDir();
-      try {
-        const gs = new GoalState(tmpDir);
-        await gs.init('Test', []);
-
-        expect(existsSync(join(tmpDir, '.minimal-agent'))).toBe(true);
-        expect(existsSync(join(tmpDir, '.minimal-agent-session-a'))).toBe(false);
-      } finally {
-        cleanup(tmpDir);
-      }
-    });
-
-    it('传入 sessionTag 使用带 tag 的目录', async () => {
-      const tmpDir = createTempDir();
-      try {
-        const gs = new GoalState(tmpDir, 'session-a');
-        await gs.init('Test', []);
-
-        expect(existsSync(join(tmpDir, '.minimal-agent-session-a'))).toBe(true);
-        expect(existsSync(join(tmpDir, '.minimal-agent-session-a', 'goal.md'))).toBe(true);
-        expect(gs.goal).toContain('Test');
-      } finally {
-        cleanup(tmpDir);
-      }
-    });
-
-    it('不同 sessionTag 隔离状态', async () => {
-      const tmpDir = createTempDir();
-      try {
-        const gsA = new GoalState(tmpDir, 'alpha');
-        const gsB = new GoalState(tmpDir, 'beta');
-
-        await gsA.init('Goal Alpha', []);
-        await gsB.init('Goal Beta', []);
-
-        expect(gsA.goal).toContain('Goal Alpha');
-        expect(gsB.goal).toContain('Goal Beta');
-      } finally {
-        cleanup(tmpDir);
-      }
-    });
-  });
-});

package/plugins/ralph-wiggum/test/verificationGate.test.ts

@@ -1,122 +0,0 @@
-import { describe, expect, it } from 'bun:test';
-import {
-  parseVerifyArgs,
-  verifyFileExists,
-  verifyFileContains,
-  runVerification,
-} from '../src/verificationGate.ts';
-import type { Check } from '../src/verificationGate.ts';
-
-describe('verificationGate', () => {
-  describe('parseVerifyArgs', () => {
-    it('解析 --verify shell:xxx', () => {
-      const checks = parseVerifyArgs('--verify "shell:npm test"');
-      expect(checks).toHaveLength(1);
-      expect(checks[0].type).toBe('shell');
-      expect(checks[0].command).toBe('npm test');
-    });
-
-    it('解析多个 --verify', () => {
-      const checks = parseVerifyArgs(
-        '--verify "shell:npm test" --verify "file_exists:src/index.ts" --verify "file_contains:README.md:minimal-agent"',
-      );
-      expect(checks).toHaveLength(3);
-      expect(checks[0].type).toBe('shell');
-      expect(checks[1].type).toBe('file_exists');
-      expect(checks[2].type).toBe('file_contains');
-    });
-
-    it('无 --verify 返回空数组', () => {
-      const checks = parseVerifyArgs('--max-iterations 50 "some task"');
-      expect(checks).toHaveLength(0);
-    });
-
-    it('空字符串返回空数组', () => {
-      const checks = parseVerifyArgs('');
-      expect(checks).toHaveLength(0);
-    });
-
-    it('忽略无效类型', () => {
-      const checks = parseVerifyArgs('--verify "invalid:value"');
-      expect(checks).toHaveLength(0);
-    });
-
-    it('解析 test_count', () => {
-      const checks = parseVerifyArgs('--verify "test_count:10"');
-      expect(checks).toHaveLength(1);
-      expect(checks[0].type).toBe('test_count');
-      expect(checks[0].minCount).toBe(10);
-    });
-  });
-
-  describe('verifyFileExists', () => {
-    it('存在的文件通过', () => {
-      const result = verifyFileExists('package.json');
-      expect(result.passed).toBe(true);
-      expect(result.output).toContain('存在');
-    });
-
-    it('不存在的文件不通过', () => {
-      const result = verifyFileExists('__nonexistent_file_xyz__');
-      expect(result.passed).toBe(false);
-      expect(result.output).toContain('不存在');
-    });
-  });
-
-  describe('verifyFileContains', () => {
-    it('文件包含模式串通过', () => {
-      const result = verifyFileContains('package.json', '"name"');
-      expect(result.passed).toBe(true);
-    });
-
-    it('文件不包含模式串不通过', () => {
-      const result = verifyFileContains('package.json', '__xyz_pattern_not_exist__');
-      expect(result.passed).toBe(false);
-    });
-
-    it('不存在的文件不通过', () => {
-      const result = verifyFileContains('__nonexistent__', 'pattern');
-      expect(result.passed).toBe(false);
-      expect(result.output).toContain('无法读取');
-    });
-  });
-
-  describe('runVerification', () => {
-    it('无验证项直接通过', async () => {
-      const result = await runVerification([]);
-      expect(result.passed).toBe(true);
-      expect(result.summary).toContain('无验证项');
-    });
-
-    it('全部通过的检查返回 passed=true', async () => {
-      const checks: Check[] = [
-        { type: 'file_exists', file: 'package.json' },
-        { type: 'file_contains', file: 'package.json', pattern: '"name"' },
-      ];
-      const result = await runVerification(checks);
-      expect(result.passed).toBe(true);
-      expect(result.details).toHaveLength(2);
-      expect(result.details.every((d) => d.passed)).toBe(true);
-    });
-
-    it('有失败的检查返回 passed=false', async () => {
-      const checks: Check[] = [
-        { type: 'file_exists', file: '__nonexistent__' },
-      ];
-      const result = await runVerification(checks);
-      expect(result.passed).toBe(false);
-      expect(result.summary).toContain('❌');
-    });
-
-    it('混合结果返回 passed=false', async () => {
-      const checks: Check[] = [
-        { type: 'file_exists', file: 'package.json' },
-        { type: 'file_exists', file: '__nonexistent__' },
-      ];
-      const result = await runVerification(checks);
-      expect(result.passed).toBe(false);
-      expect(result.details[0].passed).toBe(true);
-      expect(result.details[1].passed).toBe(false);
-    });
-  });
-});