kenaz 0.3.18 → 0.3.20

package/core/dev/scripts/matrix/tests/cli.test.ts

@@ -1,177 +0,0 @@
-/**
- * CLI Integration Tests
- * Tests the matrix CLI commands
- */
-
-import * as fs from 'fs';
-import * as path from 'path';
-import { MatrixParser } from '../src/parser';
-import { MatrixSerializer } from '../src/serializer';
-import type { MatrixFile } from '../types';
-
-const TEST_DIR = path.join(__dirname, '__temp__');
-const TEST_FILE = path.join(TEST_DIR, 'test.matrix');
-
-describe('Matrix CLI Integration', () => {
-  beforeEach(() => {
-    // Create test directory
-    if (!fs.existsSync(TEST_DIR)) {
-      fs.mkdirSync(TEST_DIR, { recursive: true });
-    }
-  });
-
-  afterEach(() => {
-    // Clean up test directory
-    if (fs.existsSync(TEST_DIR)) {
-      fs.rmSync(TEST_DIR, { recursive: true, force: true });
-    }
-  });
-
-  describe('Create Command', () => {
-    it('should create a new .matrix file with basic structure', () => {
-      const matrixFile: MatrixFile = {
-        meta: { v: '1.0.0', c: 'T' },
-        index: { n: 0 },
-        data: { records: [] },
-      };
-
-      const serializer = new MatrixSerializer();
-      const content = serializer.serialize(matrixFile);
-      fs.writeFileSync(TEST_FILE, content, 'utf-8');
-
-      expect(fs.existsSync(TEST_FILE)).toBe(true);
-
-      const parser = new MatrixParser();
-      const result = parser.parse(content);
-
-      expect(result.success).toBe(true);
-      expect(result.data?.meta.v).toBe('1.0.0');
-      expect(result.data?.meta.c).toBe('T');
-      expect(result.data?.index.n).toBe(0);
-    });
-  });
-
-  describe('Read Command', () => {
-    it('should parse and read .matrix file correctly', () => {
-      const matrixFile: MatrixFile = {
-        meta: { v: '1.0.0', c: 'T' },
-        index: { n: 2 },
-        data: {
-          records: [
-            { id: 'TASK_001', fields: { status: 'pending', priority: 'P0' } },
-            { id: 'TASK_002', fields: { status: 'completed', priority: 'P1' } },
-          ],
-        },
-      };
-
-      const serializer = new MatrixSerializer();
-      const content = serializer.serialize(matrixFile);
-      fs.writeFileSync(TEST_FILE, content, 'utf-8');
-
-      const parser = new MatrixParser();
-      const result = parser.parse(fs.readFileSync(TEST_FILE, 'utf-8'));
-
-      expect(result.success).toBe(true);
-      expect(result.data?.data?.records.length).toBe(2);
-      expect(result.data?.data?.records[0].id).toBe('TASK_001');
-    });
-  });
-
-  describe('Update Command', () => {
-    it('should update a rule field and auto-update index', () => {
-      const matrixFile: MatrixFile = {
-        meta: { v: '1.0.0', c: 'T' },
-        index: { n: 1, upd: '2026-02-09 15:00:00' },
-        data: {
-          records: [{ id: 'TASK_001', fields: { status: 'pending', priority: 'P0' } }],
-        },
-      };
-
-      const serializer = new MatrixSerializer();
-      let content = serializer.serialize(matrixFile);
-      fs.writeFileSync(TEST_FILE, content, 'utf-8');
-
-      // Update the rule
-      const parser = new MatrixParser();
-      const result = parser.parse(fs.readFileSync(TEST_FILE, 'utf-8'));
-      const data = result.data!;
-
-      data.data!.records[0].fields.status = 'completed';
-      data.index.upd = '2026-02-09 15:30:00';
-
-      content = serializer.serialize(data);
-      fs.writeFileSync(TEST_FILE, content, 'utf-8');
-
-      // Verify update
-      const updatedResult = parser.parse(fs.readFileSync(TEST_FILE, 'utf-8'));
-      expect(updatedResult.data?.data?.records[0].fields.status).toBe('completed');
-      expect(updatedResult.data?.index.upd).toBe('2026-02-09 15:30:00');
-    });
-  });
-
-  describe('Delete Command', () => {
-    it('should delete a rule and update index statistics', () => {
-      const matrixFile: MatrixFile = {
-        meta: { v: '1.0.0', c: 'T' },
-        index: { n: 2 },
-        data: {
-          records: [
-            { id: 'TASK_001', fields: { status: 'pending' } },
-            { id: 'TASK_002', fields: { status: 'completed' } },
-          ],
-        },
-      };
-
-      const serializer = new MatrixSerializer();
-      let content = serializer.serialize(matrixFile);
-      fs.writeFileSync(TEST_FILE, content, 'utf-8');
-
-      // Delete rule
-      const parser = new MatrixParser();
-      const result = parser.parse(fs.readFileSync(TEST_FILE, 'utf-8'));
-      const data = result.data!;
-
-      // Remove TASK_001
-      const index = data.data!.records.findIndex(r => r.id === 'TASK_001');
-      data.data!.records.splice(index, 1);
-      data.index.n = data.data!.records.length;
-
-      content = serializer.serialize(data);
-      fs.writeFileSync(TEST_FILE, content, 'utf-8');
-
-      // Verify deletion
-      const updatedResult = parser.parse(fs.readFileSync(TEST_FILE, 'utf-8'));
-      expect(updatedResult.data?.data?.records.length).toBe(1);
-      expect(updatedResult.data?.data?.records[0].id).toBe('TASK_002');
-      expect(updatedResult.data?.index.n).toBe(1);
-    });
-  });
-
-  describe('Error Handling', () => {
-    it('should handle non-existent files gracefully', () => {
-      const nonExistentFile = path.join(TEST_DIR, 'nonexistent.matrix');
-      expect(fs.existsSync(nonExistentFile)).toBe(false);
-    });
-
-    it('should handle invalid rule IDs', () => {
-      const matrixFile: MatrixFile = {
-        meta: { v: '1.0.0', c: 'T' },
-        index: { n: 1 },
-        data: {
-          records: [{ id: 'TASK_001', fields: { status: 'pending' } }],
-        },
-      };
-
-      const serializer = new MatrixSerializer();
-      const content = serializer.serialize(matrixFile);
-      fs.writeFileSync(TEST_FILE, content, 'utf-8');
-
-      const parser = new MatrixParser();
-      const result = parser.parse(fs.readFileSync(TEST_FILE, 'utf-8'));
-      const data = result.data!;
-
-      const invalidIndex = data.data!.records.findIndex(r => r.id === 'INVALID_ID');
-      expect(invalidIndex).toBe(-1);
-    });
-  });
-});

package/core/dev/scripts/matrix/tests/convert.test.ts

@@ -1,143 +0,0 @@
-/**
- * Convert command tests
- */
-
-import { describe, it, expect, beforeEach, afterEach } from '@jest/globals';
-import * as fs from 'fs';
-import * as path from 'path';
-import { convertCommand } from '../src/cli/commands/convert';
-
-describe('Convert Command', () => {
-  const testDir = path.join(__dirname, 'temp');
-  const matrixFile = path.join(testDir, 'test.matrix');
-  const jsonFile = path.join(testDir, 'test.json');
-
-  beforeEach(() => {
-    // Create temp directory
-    if (!fs.existsSync(testDir)) {
-      fs.mkdirSync(testDir, { recursive: true });
-    }
-  });
-
-  afterEach(() => {
-    // Clean up
-    [matrixFile, jsonFile].forEach(file => {
-      if (fs.existsSync(file)) {
-        fs.unlinkSync(file);
-      }
-    });
-    if (fs.existsSync(testDir)) {
-      fs.rmdirSync(testDir);
-    }
-  });
-
-  it('should convert .matrix to JSON', async () => {
-    // Create test .matrix file
-    const matrixContent = `# Test
-@meta |v=1.0|c=T|
-@index |tot=2|
-@data
-TASK_001|st=P|p=P0|title=Task One|
-TASK_002|st=C|p=P1|title=Task Two|
-`;
-    fs.writeFileSync(matrixFile, matrixContent, 'utf-8');
-
-    // Convert
-    await convertCommand(matrixFile, jsonFile, {});
-
-    // Verify JSON file was created
-    expect(fs.existsSync(jsonFile)).toBe(true);
-
-    // Verify JSON content
-    const jsonData = JSON.parse(fs.readFileSync(jsonFile, 'utf-8'));
-    expect(jsonData.version).toBe('1.0');
-    expect(jsonData.category).toBe('T');
-    expect(jsonData.records).toHaveLength(2);
-    expect(jsonData.records[0].id).toBe('TASK_001');
-  });
-
-  it('should convert JSON to .matrix', async () => {
-    // Create test JSON file
-    const jsonData = {
-      version: '1.0',
-      category: 'T',
-      statistics: { tot: 2 },
-      records: [
-        { id: 'TASK_001', status: 'pending', priority: 'P0', title: 'Task One' },
-        { id: 'TASK_002', status: 'completed', priority: 'P1', title: 'Task Two' },
-      ],
-    };
-    fs.writeFileSync(jsonFile, JSON.stringify(jsonData, null, 2), 'utf-8');
-
-    // Convert
-    await convertCommand(jsonFile, matrixFile, {});
-
-    // Verify .matrix file was created
-    expect(fs.existsSync(matrixFile)).toBe(true);
-
-    // Verify .matrix content
-    const matrixContent = fs.readFileSync(matrixFile, 'utf-8');
-    expect(matrixContent).toContain('@meta');
-    expect(matrixContent).toContain('@index');
-    expect(matrixContent).toContain('@data');
-    expect(matrixContent).toContain('TASK_001');
-    expect(matrixContent).toContain('TASK_002');
-  });
-
-  it('should preserve all metadata in round-trip conversion', async () => {
-    // Create original .matrix
-    const originalMatrix = `# Test with metadata
-@meta |v=2.1|c=M|author=test|created=260207-1430|
-@index |tot=1|completed=1|
-@data
-MEM_001|st=C|p=P0|title=Memory Item|desc=Description here|
-`;
-    fs.writeFileSync(matrixFile, originalMatrix, 'utf-8');
-
-    // Convert to JSON
-    await convertCommand(matrixFile, jsonFile, {});
-
-    // Convert back to .matrix
-    const matrixFile2 = path.join(testDir, 'test2.matrix');
-    await convertCommand(jsonFile, matrixFile2, {});
-
-    // Verify metadata preserved
-    const finalMatrix = fs.readFileSync(matrixFile2, 'utf-8');
-    expect(finalMatrix).toContain('v=2.1');
-    expect(finalMatrix).toContain('c=M');
-    expect(finalMatrix).toContain('MEM_001');
-
-    // Clean up extra file
-    if (fs.existsSync(matrixFile2)) {
-      fs.unlinkSync(matrixFile2);
-    }
-  });
-
-  it('should auto-detect formats', async () => {
-    // Create .matrix file
-    const matrixContent = `# Auto-detect test
-@meta |v=1.0|c=T|
-@index |tot=1|
-@data
-TASK_001|st=P|p=P0|
-`;
-    fs.writeFileSync(matrixFile, matrixContent, 'utf-8');
-
-    // Convert without specifying formats
-    await convertCommand(matrixFile, jsonFile, {});
-
-    expect(fs.existsSync(jsonFile)).toBe(true);
-  });
-
-  it('should throw error for same input/output format', async () => {
-    fs.writeFileSync(matrixFile, '@meta |v=1.0|c=T|\n@index |tot=0|', 'utf-8');
-
-    await expect(
-      convertCommand(matrixFile, 'output.matrix', { from: 'matrix', to: 'matrix' })
-    ).rejects.toThrow();
-  });
-
-  it('should throw error for non-existent input file', async () => {
-    await expect(convertCommand('nonexistent.matrix', jsonFile, {})).rejects.toThrow();
-  });
-});

package/core/dev/scripts/matrix/tests/parser.test.ts

@@ -1,203 +0,0 @@
-/**
- * MatrixParser 單元測試
- */
-
-import { MatrixParser } from '../src/parser';
-
-describe('MatrixParser', () => {
-  let parser: MatrixParser;
-
-  beforeEach(() => {
-    parser = new MatrixParser();
-  });
-
-  describe('基本解析', () => {
-    it('應該解析最小有效文件', () => {
-      const content = `# .matrix v1.0
-@meta |v=1.0|c=test|
-@index |tot=0|`;
-
-      const result = parser.parse(content);
-
-      expect(result.success).toBe(true);
-      expect(result.data).toBeDefined();
-      expect(result.data?.meta.v).toBe('1.0');
-      expect(result.data?.meta.c).toBe('test');
-      expect(result.data?.index.tot).toBe(0);
-    });
-
-    it('應該解析包含所有層級的文件', () => {
-      const content = `# .matrix v1.0
-@meta |v=1.0|c=test|t=260208|
-@index |tot=1|c=1|
-@data
-T1|st=C|p=0|`;
-
-      const result = parser.parse(content);
-
-      expect(result.success).toBe(true);
-      expect(result.data?.data).toBeDefined();
-      expect(result.data?.data?.records.length).toBe(1);
-      expect(result.data?.data?.records[0].id).toBe('T1');
-      expect(result.data?.data?.records[0].fields.status).toBe('completed');
-      expect(result.data?.data?.records[0].fields.priority).toBe('P0');
-    });
-
-    it('應該正確解析複雜任務記錄', () => {
-      const content = `@meta |v=1.0|c=tasks|
-@index |tot=1|
-@data
-T121|st=C|p=0|dur=135m|ct=260206-1430|desc=API integration|dep=T120,T121|`;
-
-      const result = parser.parse(content);
-
-      expect(result.success).toBe(true);
-      const record = result.data?.data?.records[0];
-      expect(record?.id).toBe('T121');
-      expect(record?.fields.status).toBe('completed');
-      expect(record?.fields.priority).toBe('P0');
-      expect(record?.fields.duration).toBe('135m');
-      expect(record?.fields.created_at).toBe('260206-1430');
-      expect(record?.fields.description).toBe('API integration');
-      expect(record?.fields.dependencies).toEqual(['T120', 'T121']);
-    });
-
-    it('應該解析任務組格式', () => {
-      const content = `@meta |v=1.0|c=memory|
-@index |tot=1|
-@data
-260207|dev|T123,st=P,dur=45m;T124,st=P,dur=60m|note=DB migration|`;
-
-      const result = parser.parse(content);
-
-      expect(result.success).toBe(true);
-      const record = result.data?.data?.records[0];
-      expect(record?.id).toBe('260207');
-      expect(record?.fields.type).toBe('dev');
-
-      const tasks = record?.fields.tasks;
-      expect(Array.isArray(tasks)).toBe(true);
-      expect(tasks.length).toBe(2);
-      expect(tasks[0].id).toBe('T123');
-      expect(tasks[0].status).toBe('in_progress');
-      expect(tasks[0].duration).toBe('45m');
-    });
-  });
-
-  describe('值類型解析', () => {
-    it('應該正確解析布林值', () => {
-      const content = `@meta |v=1.0|c=test|
-@index |act=1|en=0|`;
-
-      const result = parser.parse(content);
-
-      expect(result.data?.index.act).toBe(true);
-      expect(result.data?.index.en).toBe(false);
-    });
-
-    it('應該正確解析數字', () => {
-      const content = `@meta |v=1.0|c=test|
-@index |tot=123|succ=81.3|`;
-
-      const result = parser.parse(content);
-
-      expect(result.data?.index.tot).toBe(123);
-      expect(result.data?.index.succ).toBe(81.3);
-    });
-
-    it('應該正確解析列表', () => {
-      const content = `@meta |v=1.0|c=test|
-@index |tot=1|
-@data
-T1|dep=T120,T121,T122|`;
-
-      const result = parser.parse(content);
-
-      const record = result.data?.data?.records[0];
-      expect(Array.isArray(record?.fields.dependencies)).toBe(true);
-      expect(record?.fields.dependencies).toEqual(['T120', 'T121', 'T122']);
-    });
-
-    it('應該正確解析百分比', () => {
-      const content = `@meta |v=1.0|c=test|
-@index |succ=81.3%|`;
-
-      const result = parser.parse(content);
-
-      expect(result.data?.index.succ).toBe(81.3);
-    });
-  });
-
-  describe('錯誤處理', () => {
-    it('應該檢測缺少 @meta', () => {
-      const content = `@index |tot=1|`;
-
-      const result = parser.parse(content);
-
-      expect(result.success).toBe(false);
-      expect(result.error?.code).toBe('E001');
-      expect(result.error?.message).toContain('@meta');
-    });
-
-    it('應該檢測缺少 @index', () => {
-      const content = `@meta |v=1.0|c=test|`;
-
-      const result = parser.parse(content);
-
-      expect(result.success).toBe(false);
-      expect(result.error?.code).toBe('E001');
-      expect(result.error?.message).toContain('@index');
-    });
-
-    it('應該檢測 @meta 格式錯誤', () => {
-      const content = `@meta |v=1.0|c=test
-@index |tot=1|`;
-
-      const result = parser.parse(content);
-
-      expect(result.success).toBe(false);
-      expect(result.error?.code).toBe('E003');
-    });
-
-    it('應該檢測欄位格式錯誤', () => {
-      const content = `@meta |v=1.0|c=test|
-@index |tot=1|
-@data
-T1|st:C|`;
-
-      const result = parser.parse(content);
-
-      expect(result.success).toBe(false);
-      expect(result.error?.code).toBe('E004');
-    });
-  });
-
-  describe('解析選項', () => {
-    it('非嚴格模式應該容許錯誤', () => {
-      const parser = new MatrixParser({ strict: false });
-      const content = `@meta |v=1.0|c=test|
-@index |tot=1|
-@data
-T1|invalid_format|`;
-
-      const result = parser.parse(content);
-
-      expect(result.success).toBe(false);
-      expect(result.error).toBeDefined();
-    });
-
-    it('autoFix 應該自動展開時間戳', () => {
-      const parser = new MatrixParser({ autoFix: true });
-      const content = `@meta |v=1.0|c=test|
-@index |tot=1|
-@data
-T1|ct=260207-0530|`;
-
-      const result = parser.parse(content);
-
-      expect(result.success).toBe(true);
-      const record = result.data?.data?.records[0];
-      expect(record?.fields.created_at).toBe('2026-02-07T05:30:00Z');
-    });
-  });
-});

package/core/dev/scripts/matrix/tests/query.test.ts

@@ -1,85 +0,0 @@
-/**
- * Query command tests
- */
-
-import { describe, it, expect, beforeEach, afterEach } from '@jest/globals';
-import * as fs from 'fs';
-import * as path from 'path';
-import { queryCommand } from '../src/cli/commands/query';
-
-describe('Query Command', () => {
-  const testDir = path.join(__dirname, 'temp');
-  const testFile = path.join(testDir, 'test.matrix');
-
-  beforeEach(() => {
-    // Create temp directory
-    if (!fs.existsSync(testDir)) {
-      fs.mkdirSync(testDir, { recursive: true });
-    }
-
-    // Create test .matrix file
-    const content = `# Test tasks
-@meta |v=1.0|c=T|
-@index |tot=5|pending=2|inprogress=1|completed=2|
-@data
-TASK_001|st=P|p=P0|title=Feature A|tags=feature,backend|
-TASK_002|st=I|p=P1|title=Bug Fix B|tags=bug,frontend|
-TASK_003|st=C|p=P0|title=Feature C|tags=feature,auth|
-TASK_004|st=C|p=P2|title=Refactor D|tags=refactor|
-TASK_005|st=P|p=P1|title=Feature E|tags=feature,backend|
-`;
-    fs.writeFileSync(testFile, content, 'utf-8');
-  });
-
-  afterEach(() => {
-    // Clean up
-    if (fs.existsSync(testFile)) {
-      fs.unlinkSync(testFile);
-    }
-    if (fs.existsSync(testDir)) {
-      fs.rmdirSync(testDir);
-    }
-  });
-
-  it('should query all records (no filter)', async () => {
-    // This will output to console, we just test it doesn't throw
-    await expect(queryCommand(testFile, {})).resolves.not.toThrow();
-  });
-
-  it('should filter by status', async () => {
-    await expect(queryCommand(testFile, { status: 'pending' })).resolves.not.toThrow();
-  });
-
-  it('should filter by priority', async () => {
-    await expect(queryCommand(testFile, { priority: 'P0' })).resolves.not.toThrow();
-  });
-
-  it('should filter by tag', async () => {
-    await expect(queryCommand(testFile, { tag: 'feature' })).resolves.not.toThrow();
-  });
-
-  it('should filter by keyword', async () => {
-    await expect(queryCommand(testFile, { keyword: 'auth' })).resolves.not.toThrow();
-  });
-
-  it('should support multiple filters', async () => {
-    await expect(
-      queryCommand(testFile, {
-        status: 'completed',
-        priority: 'P0',
-      })
-    ).resolves.not.toThrow();
-  });
-
-  it('should support json format', async () => {
-    await expect(queryCommand(testFile, { format: 'json' })).resolves.not.toThrow();
-  });
-
-  it('should support compact format', async () => {
-    await expect(queryCommand(testFile, { format: 'compact' })).resolves.not.toThrow();
-  });
-
-  it('should throw error for non-existent file', async () => {
-    await expect(queryCommand('nonexistent.matrix', {})).rejects.toThrow();
-  });
-});