kenaz 0.3.18 → 0.3.19

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

@@ -1,197 +0,0 @@
-/**
- * MatrixSerializer 單元測試
- */
-
-import { MatrixSerializer } from '../src/serializer';
-import type { MatrixFile } from '../types';
-
-describe('MatrixSerializer', () => {
-  let serializer: MatrixSerializer;
-
-  beforeEach(() => {
-    serializer = new MatrixSerializer();
-  });
-
-  describe('基本序列化', () => {
-    it('應該序列化最小有效文件', () => {
-      const data: MatrixFile = {
-        meta: { v: '1.0', c: 'test' },
-        index: { tot: 0 },
-      };
-
-      const result = serializer.serialize(data);
-
-      expect(result).toContain('# .matrix v1.0');
-      expect(result).toContain('@meta |v=1.0|c=test|');
-      expect(result).toContain('@index |tot=0|');
-    });
-
-    it('應該序列化包含所有層級的文件', () => {
-      const data: MatrixFile = {
-        meta: { v: '1.0', c: 'test', t: '260208' },
-        index: { tot: 1, c: 1 },
-        data: {
-          records: [
-            {
-              id: 'T1',
-              fields: { status: 'completed', priority: 'P0' },
-            },
-          ],
-        },
-      };
-
-      const result = serializer.serialize(data);
-
-      expect(result).toContain('@meta |v=1.0|c=test|t=260208|');
-      expect(result).toContain('@index |tot=1|c=1|');
-      expect(result).toContain('@data');
-      expect(result).toContain('T1|st=C|p=0|');
-    });
-
-    it('應該正確序列化複雜任務記錄', () => {
-      const data: MatrixFile = {
-        meta: { v: '1.0', c: 'tasks' },
-        index: { tot: 1 },
-        data: {
-          records: [
-            {
-              id: 'T121',
-              fields: {
-                status: 'completed',
-                priority: 'P0',
-                duration: '135m',
-                created_at: '2026-02-06T14:30:00Z',
-                description: 'API integration',
-                dependencies: ['T120', 'T121'],
-              },
-            },
-          ],
-        },
-      };
-
-      const result = serializer.serialize(data);
-
-      expect(result).toContain('T121|');
-      expect(result).toContain('st=C');
-      expect(result).toContain('p=0');
-      expect(result).toContain('dur=135m');
-      expect(result).toContain('ct=260206-1430');
-      expect(result).toContain('desc=API integration');
-      expect(result).toContain('dep=T120,T121');
-    });
-  });
-
-  describe('值類型序列化', () => {
-    it('應該正確序列化布林值', () => {
-      const data: MatrixFile = {
-        meta: { v: '1.0', c: 'test' },
-        index: { active: true, enabled: false },
-      };
-
-      const result = serializer.serialize(data);
-
-      expect(result).toContain('act=1');
-      expect(result).toContain('en=0');
-    });
-
-    it('應該正確序列化數字', () => {
-      const data: MatrixFile = {
-        meta: { v: '1.0', c: 'test' },
-        index: { total: 123, success_rate: 81.3 },
-      };
-
-      const result = serializer.serialize(data);
-
-      expect(result).toContain('tot=123');
-      expect(result).toContain('succ=81.3');
-    });
-
-    it('應該正確序列化列表', () => {
-      const data: MatrixFile = {
-        meta: { v: '1.0', c: 'test' },
-        index: { tot: 1 },
-        data: {
-          records: [
-            {
-              id: 'T1',
-              fields: { dependencies: ['T120', 'T121', 'T122'] },
-            },
-          ],
-        },
-      };
-
-      const result = serializer.serialize(data);
-
-      expect(result).toContain('dep=T120,T121,T122');
-    });
-
-    it('應該正確序列化時間戳', () => {
-      const data: MatrixFile = {
-        meta: { v: '1.0', c: 'test' },
-        index: { tot: 1 },
-        data: {
-          records: [
-            {
-              id: 'T1',
-              fields: { created_at: '2026-02-07T05:30:00Z' },
-            },
-          ],
-        },
-      };
-
-      const result = serializer.serialize(data);
-
-      expect(result).toContain('ct=260207-0530');
-    });
-  });
-
-  describe('往返無損', () => {
-    it('Parser + Serializer 應該往返無損', () => {
-      const { MatrixParser } = require('../src/parser');
-      const parser = new MatrixParser();
-
-      const original = `# .matrix v1.0
-@meta |v=1.0|c=project-status|t=260207-0530|proj=KenazAI|
-@index |tot=123|c=100|p=15|b=8|act=1|
-@data
-gen|tot=123|c=100|p=15|b=8|succ=81.3|
-rec|dep=T121,T122,T123|`;
-
-      const parsed = parser.parse(original);
-      expect(parsed.success).toBe(true);
-
-      const serialized = serializer.serialize(parsed.data!);
-      const reparsed = parser.parse(serialized);
-
-      expect(reparsed.success).toBe(true);
-      expect(reparsed.data).toEqual(parsed.data);
-    });
-  });
-
-  describe('序列化選項', () => {
-    it('includeComment: false 不應包含註釋', () => {
-      const serializer = new MatrixSerializer({ includeComment: false });
-      const data: MatrixFile = {
-        meta: { v: '1.0', c: 'test' },
-        index: { tot: 0 },
-      };
-
-      const result = serializer.serialize(data);
-
-      expect(result).not.toContain('#');
-      expect(result).toContain('@meta');
-    });
-
-    it('應該支援自訂註釋', () => {
-      const serializer = new MatrixSerializer({ comment: 'Custom Comment' });
-      const data: MatrixFile = {
-        meta: { v: '1.0', c: 'test' },
-        index: { tot: 0 },
-      };
-
-      const result = serializer.serialize(data);
-
-      expect(result).toContain('# Custom Comment');
-    });
-  });
-});

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

@@ -1,141 +0,0 @@
-/**
- * Validate command tests
- */
-
-import { describe, it, expect, beforeEach, afterEach } from '@jest/globals';
-import * as fs from 'fs';
-import * as path from 'path';
-import { validateCommand } from '../src/cli/commands/validate';
-
-describe('Validate 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 });
-    }
-  });
-
-  afterEach(() => {
-    // Clean up
-    if (fs.existsSync(testFile)) {
-      fs.unlinkSync(testFile);
-    }
-    const backupFile = `${testFile}.backup`;
-    if (fs.existsSync(backupFile)) {
-      fs.unlinkSync(backupFile);
-    }
-    if (fs.existsSync(testDir)) {
-      fs.rmdirSync(testDir);
-    }
-  });
-
-  it('should validate a valid .matrix file', async () => {
-    const validContent = `# Valid file
-@meta |v=1.0|c=T|
-@index |tot=1|
-@data
-TASK_001|st=P|p=P0|
-`;
-    fs.writeFileSync(testFile, validContent, 'utf-8');
-
-    await expect(validateCommand(testFile, {})).resolves.not.toThrow();
-  });
-
-  it('should detect missing @meta', async () => {
-    const invalidContent = `@index |tot=0|
-@data
-`;
-    fs.writeFileSync(testFile, invalidContent, 'utf-8');
-
-    // Should not throw, but will report errors
-    await expect(validateCommand(testFile, {})).resolves.not.toThrow();
-  });
-
-  it('should detect missing @index', async () => {
-    const invalidContent = `@meta |v=1.0|c=T|
-@data
-`;
-    fs.writeFileSync(testFile, invalidContent, 'utf-8');
-
-    await expect(validateCommand(testFile, {})).resolves.not.toThrow();
-  });
-
-  it('should detect invalid delimiter format', async () => {
-    const invalidContent = `@meta v=1.0|c=T
-@index |tot=0|
-`;
-    fs.writeFileSync(testFile, invalidContent, 'utf-8');
-
-    await expect(validateCommand(testFile, {})).resolves.not.toThrow();
-  });
-
-  it('should detect missing required fields in @meta', async () => {
-    const invalidContent = `@meta |v=1.0|
-@index |tot=0|
-`;
-    fs.writeFileSync(testFile, invalidContent, 'utf-8');
-
-    await expect(validateCommand(testFile, {})).resolves.not.toThrow();
-  });
-
-  it('should detect empty file', async () => {
-    fs.writeFileSync(testFile, '', 'utf-8');
-
-    await expect(validateCommand(testFile, {})).resolves.not.toThrow();
-  });
-
-  it('should detect duplicate sections', async () => {
-    const invalidContent = `@meta |v=1.0|c=T|
-@meta |v=2.0|c=M|
-@index |tot=0|
-`;
-    fs.writeFileSync(testFile, invalidContent, 'utf-8');
-
-    await expect(validateCommand(testFile, {})).resolves.not.toThrow();
-  });
-
-  it('should auto-fix empty file with --fix', async () => {
-    fs.writeFileSync(testFile, '', 'utf-8');
-
-    await validateCommand(testFile, { fix: true });
-
-    // Verify file was fixed
-    const fixedContent = fs.readFileSync(testFile, 'utf-8');
-    expect(fixedContent).toContain('@meta');
-    expect(fixedContent).toContain('@index');
-
-    // Verify backup was created
-    const backupFile = `${testFile}.backup`;
-    expect(fs.existsSync(backupFile)).toBe(true);
-  });
-
-  it('should auto-fix missing @meta with --fix', async () => {
-    const invalidContent = `@index |tot=0|
-`;
-    fs.writeFileSync(testFile, invalidContent, 'utf-8');
-
-    await validateCommand(testFile, { fix: true });
-
-    // Verify @meta was added
-    const fixedContent = fs.readFileSync(testFile, 'utf-8');
-    expect(fixedContent).toContain('@meta');
-  });
-
-  it('should throw error for non-existent file', async () => {
-    await expect(validateCommand('nonexistent.matrix', {})).rejects.toThrow();
-  });
-
-  it('should handle files with warnings (valid but with warnings)', async () => {
-    const contentWithWarnings = `# File with potential warnings
-@meta |v=1.0|c=T|deprecated_field=value|
-@index |tot=0|
-`;
-    fs.writeFileSync(testFile, contentWithWarnings, 'utf-8');
-
-    // Should complete without throwing
-    await expect(validateCommand(testFile, {})).resolves.not.toThrow();
-  });
-});

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

@@ -1,167 +0,0 @@
-/**
- * MatrixValidator 單元測試
- */
-
-import { MatrixValidator } from '../src/validator';
-
-describe('MatrixValidator', () => {
-  let validator: MatrixValidator;
-
-  beforeEach(() => {
-    validator = new MatrixValidator();
-  });
-
-  describe('基本驗證', () => {
-    it('應該驗證有效文件', () => {
-      const content = `# .matrix v1.0
-@meta |v=1.0|c=test|
-@index |tot=0|`;
-
-      const result = validator.validate(content);
-
-      expect(result.valid).toBe(true);
-      expect(result.errors.length).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 = validator.validate(content);
-
-      expect(result.valid).toBe(true);
-      expect(result.errors.length).toBe(0);
-    });
-  });
-
-  describe('錯誤檢測', () => {
-    it('E000: 應該檢測空文件', () => {
-      const content = '';
-
-      const result = validator.validate(content);
-
-      expect(result.valid).toBe(false);
-      expect(result.errors[0].code).toBe('E000');
-      expect(result.errors[0].message).toContain('Empty');
-    });
-
-    it('E001: 應該檢測缺少 @meta', () => {
-      const content = `@index |tot=1|
-@data
-T1|st=C|`;
-
-      const result = validator.validate(content);
-
-      expect(result.valid).toBe(false);
-      const error = result.errors.find(e => e.code === 'E001' && e.message.includes('@meta'));
-      expect(error).toBeDefined();
-    });
-
-    it('E001: 應該檢測缺少 @index', () => {
-      const content = `@meta |v=1.0|c=test|`;
-
-      const result = validator.validate(content);
-
-      expect(result.valid).toBe(false);
-      const error = result.errors.find(e => e.code === 'E001' && e.message.includes('@index'));
-      expect(error).toBeDefined();
-    });
-
-    it('E002: 應該檢測重複 @meta', () => {
-      const content = `@meta |v=1.0|c=test|
-@meta |v=2.0|c=test2|
-@index |tot=1|`;
-
-      const result = validator.validate(content);
-
-      expect(result.valid).toBe(false);
-      const error = result.errors.find(e => e.code === 'E002' && e.message.includes('Duplicate @meta'));
-      expect(error).toBeDefined();
-    });
-
-    it('E002: 應該檢測順序錯誤', () => {
-      const content = `@index |tot=1|
-@meta |v=1.0|c=test|`;
-
-      const result = validator.validate(content);
-
-      expect(result.valid).toBe(false);
-      const error = result.errors.find(e => e.code === 'E002');
-      expect(error).toBeDefined();
-    });
-
-    it('E003: 應該檢測缺少分隔符', () => {
-      const content = `@meta |v=1.0|c=test
-@index |tot=1|`;
-
-      const result = validator.validate(content);
-
-      expect(result.valid).toBe(false);
-      const error = result.errors.find(e => e.code === 'E003');
-      expect(error).toBeDefined();
-    });
-
-    it('E004: 應該檢測欄位格式錯誤', () => {
-      const content = `@meta |v=1.0|c=test|
-@index |tot=1|
-@data
-T1|st:C|`;
-
-      const result = validator.validate(content);
-
-      expect(result.valid).toBe(false);
-      const error = result.errors.find(e => e.code === 'E004');
-      expect(error).toBeDefined();
-    });
-
-    it('E005: 應該檢測缺少必要欄位', () => {
-      const content = `@meta |v=1.0|
-@index |tot=1|`;
-
-      const result = validator.validate(content);
-
-      expect(result.valid).toBe(false);
-      const error = result.errors.find(e => e.code === 'E005');
-      expect(error).toBeDefined();
-      expect(error?.message).toContain('"c"');
-    });
-
-    it('應該檢測至少 10 種語法錯誤', () => {
-      const errorTypes = validator.getErrorTypes();
-
-      expect(errorTypes.length).toBeGreaterThanOrEqual(10);
-      expect(errorTypes).toContain('E000 - Empty file');
-      expect(errorTypes).toContain('E001 - Missing required section (@meta or @index)');
-      expect(errorTypes).toContain('E002 - Invalid section order or duplicate sections');
-      expect(errorTypes).toContain('E003 - Missing delimiters (|)');
-      expect(errorTypes).toContain('E004 - Invalid field format (should be key=value)');
-    });
-  });
-
-  describe('友善錯誤訊息', () => {
-    it('錯誤訊息應包含行號', () => {
-      const content = `@index |tot=1|`;
-
-      const result = validator.validate(content);
-
-      expect(result.valid).toBe(false);
-      expect(result.errors[0].line).toBeDefined();
-      expect(result.errors[0].line).toBeGreaterThan(0);
-    });
-
-    it('錯誤訊息應包含預期與實際', () => {
-      const content = `@meta |v=1.0|c=test
-@index |tot=1|`;
-
-      const result = validator.validate(content);
-
-      expect(result.valid).toBe(false);
-      const error = result.errors.find(e => e.code === 'E003');
-      expect(error?.expected).toBeDefined();
-      expect(error?.got).toBeDefined();
-    });
-  });
-});

package/core/dev/scripts/matrix/tsconfig.json

@@ -1,20 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ES2020",
-    "module": "commonjs",
-    "lib": ["ES2020"],
-    "declaration": true,
-    "declarationMap": true,
-    "sourceMap": true,
-    "outDir": "./dist",
-    "rootDir": "./src",
-    "strict": true,
-    "esModuleInterop": true,
-    "skipLibCheck": true,
-    "forceConsistentCasingInFileNames": true,
-    "resolveJsonModule": true,
-    "moduleResolution": "node"
-  },
-  "include": ["src/**/*"],
-  "exclude": ["node_modules", "dist", "tests"]
-}

package/core/dev/scripts/matrix/types/index.d.ts

@@ -1,111 +0,0 @@
-/**
- * .matrix 格式類型定義
- * @version 1.0.0
- * @see dev/design/matrix_format_SYNTAX_BNF.md
- */
-/**
- * .matrix 文件完整結構
- */
-export interface MatrixFile {
-    meta: MetaSection;
-    index: IndexSection;
-    data?: DataSection;
-}
-/**
- * @meta 層：文件元數據
- */
-export interface MetaSection {
-    v: string;
-    c: string;
-    t?: string;
-    r?: string;
-    proj?: string;
-    [key: string]: string | undefined;
-}
-/**
- * @index 層：快速查詢索引
- */
-export interface IndexSection {
-    [key: string]: string | number | boolean;
-}
-/**
- * @data 層：實際數據內容
- */
-export interface DataSection {
-    records: DataRecord[];
-}
-/**
- * 單筆數據記錄
- */
-export interface DataRecord {
-    id: string;
-    fields: Record<string, any>;
-}
-/**
- * 解析結果
- */
-export interface ParseResult {
-    success: boolean;
-    data?: MatrixFile;
-    error?: ParseError;
-}
-/**
- * 解析錯誤
- */
-export interface ParseError {
-    code: string;
-    message: string;
-    line?: number;
-    column?: number;
-    expected?: string;
-    got?: string;
-}
-/**
- * 驗證結果
- */
-export interface ValidationResult {
-    valid: boolean;
-    errors: ParseError[];
-    warnings: ParseError[];
-}
-/**
- * 序列化選項
- */
-export interface SerializeOptions {
-    /**
-     * 是否美化輸出（添加換行）
-     * @default false
-     */
-    pretty?: boolean;
-    /**
-     * 是否包含註釋行
-     * @default true
-     */
-    includeComment?: boolean;
-    /**
-     * 註釋內容
-     * @default ".matrix v1.0"
-     */
-    comment?: string;
-}
-/**
- * 解析選項
- */
-export interface ParseOptions {
-    /**
-     * 是否嚴格模式（遇到錯誤立即拋出）
-     * @default true
-     */
-    strict?: boolean;
-    /**
-     * 是否自動修正錯誤
-     * @default false
-     */
-    autoFix?: boolean;
-    /**
-     * 是否驗證欄位名稱
-     * @default true
-     */
-    validateFields?: boolean;
-}
-//# sourceMappingURL=index.d.ts.map

package/core/dev/scripts/matrix/types/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,WAAW,CAAC;IAClB,KAAK,EAAE,YAAY,CAAC;IACpB,IAAI,CAAC,EAAE,WAAW,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;CAC1C;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,UAAU,EAAE,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,KAAK,CAAC,EAAE,UAAU,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,QAAQ,EAAE,UAAU,EAAE,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IAEzB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B"}

package/core/dev/scripts/matrix/types/index.js

@@ -1,8 +0,0 @@
-"use strict";
-/**
- * .matrix 格式類型定義
- * @version 1.0.0
- * @see dev/design/matrix_format_SYNTAX_BNF.md
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=index.js.map

package/core/dev/scripts/matrix/types/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":";AAAA;;;;GAIG"}