kenaz 0.3.18 → 0.3.19

package/core/dev/scripts/matrix/src/cli/utils/logger.ts

@@ -1,65 +0,0 @@
-/**
- * CLI Logger Utility
- * Provides colored console output with success/error indicators
- */
-
-import chalk from 'chalk';
-
-export class Logger {
-  /**
-   * Display success message with green checkmark
-   */
-  static success(message: string): void {
-    console.log(chalk.green('✓'), message);
-  }
-
-  /**
-   * Display error message with red cross
-   */
-  static error(message: string): void {
-    console.log(chalk.red('✗'), message);
-  }
-
-  /**
-   * Display info message
-   */
-  static info(message: string): void {
-    console.log(chalk.blue('ℹ'), message);
-  }
-
-  /**
-   * Display warning message
-   */
-  static warn(message: string): void {
-    console.log(chalk.yellow('⚠'), message);
-  }
-
-  /**
-   * Display section header
-   */
-  static header(message: string): void {
-    console.log('\n' + chalk.bold.cyan(message));
-  }
-
-  /**
-   * Display key-value pair
-   */
-  static field(key: string, value: any): void {
-    console.log(chalk.gray(`  ${key}:`), chalk.white(value));
-  }
-
-  /**
-   * Display data record in formatted way
-   */
-  static record(id: string, fields: Record<string, any>): void {
-    console.log(chalk.cyan(`\n  ${id}`));
-    Object.entries(fields).forEach(([key, value]) => {
-      const displayValue = Array.isArray(value)
-        ? value.join(', ')
-        : typeof value === 'object'
-          ? JSON.stringify(value)
-          : String(value);
-      console.log(chalk.gray(`    ${key}:`), chalk.white(displayValue));
-    });
-  }
-}

package/core/dev/scripts/matrix/src/index.ts

@@ -1,62 +0,0 @@
-/**
- * .matrix Parser & Serializer
- * @version 1.0.0
- * @description Core library for parsing and serializing .matrix format files
- */
-
-export { MatrixParser } from './parser';
-export { MatrixSerializer } from './serializer';
-export { MatrixValidator } from './validator';
-
-export * from './abbreviations';
-
-export type {
-  MatrixFile,
-  MetaSection,
-  IndexSection,
-  DataSection,
-  DataRecord,
-  ParseResult,
-  ParseError,
-  ValidationResult,
-  SerializeOptions,
-  ParseOptions,
-} from '../types';
-
-// Convenience functions
-import { MatrixParser } from './parser';
-import { MatrixSerializer } from './serializer';
-import { MatrixValidator } from './validator';
-import type { MatrixFile, ParseOptions, SerializeOptions } from '../types';
-
-/**
- * Parse .matrix file content
- * @param content .matrix file content
- * @param options Parse options
- * @returns Parse result
- */
-export function parse(content: string, options?: ParseOptions) {
-  const parser = new MatrixParser(options);
-  return parser.parse(content);
-}
-
-/**
- * Serialize MatrixFile to .matrix format
- * @param data MatrixFile object
- * @param options Serialize options
- * @returns .matrix file content
- */
-export function serialize(data: MatrixFile, options?: SerializeOptions): string {
-  const serializer = new MatrixSerializer(options);
-  return serializer.serialize(data);
-}
-
-/**
- * Validate .matrix file syntax
- * @param content .matrix file content
- * @returns Validation result
- */
-export function validate(content: string) {
-  const validator = new MatrixValidator();
-  return validator.validate(content);
-}

package/core/dev/scripts/matrix/src/indexer/tag-indexer.ts

@@ -1,165 +0,0 @@
-/**
- * Tag Indexer - Build inverted index for tags
- * Maps tags to rule IDs for efficient tag-based queries
- */
-
-import type { MatrixFile, DataRecord } from '../../types';
-import * as fs from 'fs';
-import * as path from 'path';
-
-export interface TagIndex {
-  [tag: string]: string[]; // tag -> rule_ids
-}
-
-export interface TagStats {
-  tag: string;
-  count: number;
-  ruleIds: string[];
-}
-
-export class TagIndexer {
-  private index: TagIndex = {};
-
-  /**
-   * Build index from MatrixFile
-   */
-  public buildIndex(matrixFile: MatrixFile): void {
-    this.index = {};
-
-    if (!matrixFile.data) return;
-
-    for (const record of matrixFile.data.records) {
-      const tags = this.extractTags(record);
-
-      for (const tag of tags) {
-        if (!this.index[tag]) {
-          this.index[tag] = [];
-        }
-        this.index[tag].push(record.id);
-      }
-    }
-  }
-
-  /**
-   * Extract all tags from a record
-   * Supports: source, category, priority, domain, and custom tags
-   */
-  private extractTags(record: DataRecord): string[] {
-    const tags: string[] = [];
-    const fields = record.fields;
-
-    // Source tags (e.g., "source:TASK_001")
-    if (fields.src || fields.source) {
-      tags.push(`source:${fields.src || fields.source}`);
-    }
-
-    // Category tags (e.g., "category:feature")
-    if (fields.cat || fields.category) {
-      tags.push(`category:${fields.cat || fields.category}`);
-    }
-
-    // Priority tags (e.g., "priority:P0")
-    if (fields.p || fields.priority) {
-      tags.push(`priority:${fields.p || fields.priority}`);
-    }
-
-    // Domain tags (e.g., "domain:auth")
-    if (fields.dom || fields.domain) {
-      tags.push(`domain:${fields.dom || fields.domain}`);
-    }
-
-    // Status tags (e.g., "status:completed")
-    if (fields.st || fields.status) {
-      tags.push(`status:${fields.st || fields.status}`);
-    }
-
-    // Custom tags (e.g., "#feature", "#bug")
-    if (fields.tags && Array.isArray(fields.tags)) {
-      for (const tag of fields.tags) {
-        tags.push(tag.startsWith('#') ? tag : `#${tag}`);
-      }
-    }
-
-    return tags;
-  }
-
-  /**
-   * Get rule IDs by tag
-   */
-  public getRulesByTag(tag: string): string[] {
-    return this.index[tag] || [];
-  }
-
-  /**
-   * Get all tags
-   */
-  public getAllTags(): string[] {
-    return Object.keys(this.index);
-  }
-
-  /**
-   * Get tag statistics (sorted by count descending)
-   */
-  public getTagStats(): TagStats[] {
-    return Object.entries(this.index)
-      .map(([tag, ruleIds]) => ({
-        tag,
-        count: ruleIds.length,
-        ruleIds,
-      }))
-      .sort((a, b) => b.count - a.count);
-  }
-
-  /**
-   * Get the index
-   */
-  public getIndex(): TagIndex {
-    return this.index;
-  }
-
-  /**
-   * Save index to file
-   */
-  public saveToFile(filePath: string): void {
-    const dir = path.dirname(filePath);
-    if (!fs.existsSync(dir)) {
-      fs.mkdirSync(dir, { recursive: true });
-    }
-
-    fs.writeFileSync(
-      filePath,
-      JSON.stringify(this.index, null, 2),
-      'utf-8'
-    );
-  }
-
-  /**
-   * Load index from file
-   */
-  public loadFromFile(filePath: string): void {
-    if (!fs.existsSync(filePath)) {
-      throw new Error(`Index file not found: ${filePath}`);
-    }
-
-    const content = fs.readFileSync(filePath, 'utf-8');
-    this.index = JSON.parse(content);
-  }
-}
-
-/**
- * Build and save tag index for a .matrix file
- */
-export function buildTagIndex(
-  matrixFile: MatrixFile,
-  indexPath?: string
-): TagIndexer {
-  const indexer = new TagIndexer();
-  indexer.buildIndex(matrixFile);
-
-  // Save to file if path provided
-  if (indexPath) {
-    indexer.saveToFile(indexPath);
-  }
-
-  return indexer;
-}

package/core/dev/scripts/matrix/src/parser.ts

@@ -1,281 +0,0 @@
-/**
- * .matrix 格式解析器
- * @version 1.0.0
- */
-
-import type {
-  MatrixFile,
-  MetaSection,
-  IndexSection,
-  DataSection,
-  DataRecord,
-  ParseResult,
-  ParseError,
-  ParseOptions,
-} from '../types';
-import { expandField, decodeValue, expandTimestamp } from './abbreviations';
-
-export class MatrixParser {
-  private options: Required<ParseOptions>;
-
-  constructor(options: ParseOptions = {}) {
-    this.options = {
-      strict: options.strict ?? true,
-      autoFix: options.autoFix ?? false,
-      validateFields: options.validateFields ?? true,
-    };
-  }
-
-  /**
-   * 解析 .matrix 文件
-   * @param content .matrix 文件內容
-   * @returns 解析結果
-   */
-  parse(content: string): ParseResult {
-    try {
-      const lines = content.split(/\r?\n/).filter(line => line.trim());
-
-      let currentLine = 0;
-      let meta: MetaSection | null = null;
-      let index: IndexSection | null = null;
-      let data: DataSection | null = null;
-
-      // 跳過註釋行
-      while (currentLine < lines.length && lines[currentLine].trim().startsWith('#')) {
-        currentLine++;
-      }
-
-      // 解析 @meta
-      if (currentLine >= lines.length || !lines[currentLine].startsWith('@meta')) {
-        return this.error('E001', 'Missing required section @meta', currentLine + 1, 1);
-      }
-      meta = this.parseMeta(lines[currentLine], currentLine + 1);
-      currentLine++;
-
-      // 解析 @index
-      if (currentLine >= lines.length || !lines[currentLine].startsWith('@index')) {
-        return this.error('E001', 'Missing required section @index', currentLine + 1, 1);
-      }
-      index = this.parseIndex(lines[currentLine], currentLine + 1);
-      currentLine++;
-
-      // 解析 @data (可選)
-      if (currentLine < lines.length && lines[currentLine].startsWith('@data')) {
-        currentLine++;
-        data = this.parseData(lines.slice(currentLine), currentLine + 1);
-      }
-
-      const result: MatrixFile = {
-        meta: meta!,
-        index: index!,
-      };
-
-      if (data) {
-        result.data = data;
-      }
-
-      return {
-        success: true,
-        data: result,
-      };
-    } catch (error) {
-      if (this.options.strict) {
-        throw error;
-      }
-      return {
-        success: false,
-        error: error as ParseError,
-      };
-    }
-  }
-
-  /**
-   * 解析 @meta 行
-   */
-  private parseMeta(line: string, lineNumber: number): MetaSection {
-    const match = line.match(/^@meta\s+\|(.+)\|$/);
-    if (!match) {
-      throw this.errorObj('E003', 'Invalid @meta format', lineNumber, 1, '@meta |...fields...|', line);
-    }
-
-    const fieldsStr = match[1];
-    const fields: MetaSection = { v: '', c: '' };
-
-    const fieldPairs = fieldsStr.split('|').filter(f => f.trim());
-    for (const pair of fieldPairs) {
-      const [key, value] = pair.split('=').map(s => s.trim());
-      if (!key || value === undefined) {
-        throw this.errorObj('E004', `Invalid field format: ${pair}`, lineNumber, 1);
-      }
-      fields[key] = value;
-    }
-
-    // 驗證必要欄位
-    if (!fields.v || !fields.c) {
-      throw this.errorObj('E005', '@meta must contain v (version) and c (category)', lineNumber, 1);
-    }
-
-    return fields;
-  }
-
-  /**
-   * 解析 @index 行
-   */
-  private parseIndex(line: string, lineNumber: number): IndexSection {
-    const match = line.match(/^@index\s+\|(.+)\|$/);
-    if (!match) {
-      throw this.errorObj('E003', 'Invalid @index format', lineNumber, 1, '@index |...fields...|', line);
-    }
-
-    const fieldsStr = match[1];
-    const fields: IndexSection = {};
-
-    const fieldPairs = fieldsStr.split('|').filter(f => f.trim());
-    for (const pair of fieldPairs) {
-      const [key, value] = pair.split('=').map(s => s.trim());
-      if (!key || value === undefined) {
-        throw this.errorObj('E004', `Invalid field format: ${pair}`, lineNumber, 1);
-      }
-      fields[key] = this.parseValue(value);
-    }
-
-    return fields;
-  }
-
-  /**
-   * 解析 @data 層
-   */
-  private parseData(lines: string[], startLine: number): DataSection {
-    const records: DataRecord[] = [];
-
-    for (let i = 0; i < lines.length; i++) {
-      const line = lines[i].trim();
-      if (!line) continue;
-
-      const match = line.match(/^([^|]+)\|(.+)\|$/);
-      if (!match) {
-        if (this.options.strict) {
-          throw this.errorObj('E003', `Invalid data line format`, startLine + i, 1, 'id|field=value|...', line);
-        }
-        continue;
-      }
-
-      const id = match[1].trim();
-      const fieldsStr = match[2];
-
-      const fields: Record<string, any> = {};
-      const fieldPairs = fieldsStr.split('|').filter(f => f.trim());
-
-      for (const pair of fieldPairs) {
-        const [key, value] = pair.split('=').map(s => s.trim());
-        if (!key || value === undefined) {
-          if (this.options.strict) {
-            throw this.errorObj('E004', `Invalid field format: ${pair}`, startLine + i, 1);
-          }
-          continue;
-        }
-
-        // 展開欄位名
-        const expandedKey = this.options.validateFields ? expandField(key) : key;
-        // 解碼值
-        fields[expandedKey] = this.parseValue(value, key);
-      }
-
-      records.push({ id, fields });
-    }
-
-    return { records };
-  }
-
-  /**
-   * 解析值（自動判斷類型）
-   */
-  private parseValue(value: string, fieldKey?: string): any {
-    // 布林值
-    if (value === '1' || value === 'true') return true;
-    if (value === '0' || value === 'false') return false;
-
-    // 數字
-    if (/^-?\d+(\.\d+)?$/.test(value)) {
-      return value.includes('.') ? parseFloat(value) : parseInt(value, 10);
-    }
-
-    // 百分比
-    if (value.endsWith('%')) {
-      return parseFloat(value.slice(0, -1));
-    }
-
-    // 時長 (45m, 2h, 3d)
-    if (/^\d+[smhdw]$/.test(value)) {
-      return value;
-    }
-
-    // 時間戳 (260207-0530)
-    if (/^\d{6}-\d{4}$/.test(value)) {
-      return this.options.autoFix ? expandTimestamp(value) : value;
-    }
-
-    // 列表 (T120,T121)
-    if (value.includes(',') && !value.includes(';')) {
-      return value.split(',').map(s => s.trim());
-    }
-
-    // 任務組 (T123,st=P;T124,st=C)
-    if (value.includes(';')) {
-      return value.split(';').map(item => {
-        const parts = item.split(',').map(s => s.trim());
-        const taskId = parts[0];
-        const subFields: Record<string, any> = {};
-        for (let i = 1; i < parts.length; i++) {
-          const [k, v] = parts[i].split('=');
-          if (k && v) {
-            subFields[k.trim()] = this.parseValue(v.trim(), k.trim());
-          }
-        }
-        return { id: taskId, ...subFields };
-      });
-    }
-
-    // 值代碼解碼
-    if (fieldKey) {
-      const decodedValue = decodeValue(fieldKey, value);
-      if (decodedValue !== value) {
-        return decodedValue;
-      }
-    }
-
-    // 純文本
-    return value;
-  }
-
-  /**
-   * 建立錯誤物件
-   */
-  private errorObj(
-    code: string,
-    message: string,
-    line?: number,
-    column?: number,
-    expected?: string,
-    got?: string
-  ): ParseError {
-    return { code, message, line, column, expected, got };
-  }
-
-  /**
-   * 建立錯誤結果
-   */
-  private error(
-    code: string,
-    message: string,
-    line?: number,
-    column?: number,
-    expected?: string,
-    got?: string
-  ): ParseResult {
-    return {
-      success: false,
-      error: this.errorObj(code, message, line, column, expected, got),
-    };
-  }
-}