kenaz 0.3.18 → 0.3.19

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

@@ -1,55 +0,0 @@
-{
-  "name": "@kenaz/matrix-parser",
-  "version": "1.0.0",
-  "description": ".matrix format parser and serializer",
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
-  "bin": {
-    "matrix": "./dist/cli/index.js"
-  },
-  "scripts": {
-    "build": "tsc",
-    "test": "jest",
-    "test:coverage": "jest --coverage",
-    "test:watch": "jest --watch"
-  },
-  "keywords": [
-    "matrix",
-    "parser",
-    "serializer",
-    "kenaz",
-    "cli"
-  ],
-  "author": "Developer Team",
-  "license": "MIT",
-  "dependencies": {
-    "commander": "^11.1.0",
-    "inquirer": "^9.2.0",
-    "chalk": "^4.1.2"
-  },
-  "devDependencies": {
-    "@types/inquirer": "^9.0.0",
-    "@types/jest": "^29.5.0",
-    "@types/node": "^20.0.0",
-    "jest": "^29.5.0",
-    "ts-jest": "^29.1.0",
-    "typescript": "^5.0.0"
-  },
-  "jest": {
-    "preset": "ts-jest",
-    "testEnvironment": "node",
-    "coverageThreshold": {
-      "global": {
-        "branches": 90,
-        "functions": 90,
-        "lines": 90,
-        "statements": 90
-      }
-    },
-    "collectCoverageFrom": [
-      "src/**/*.ts",
-      "!src/**/*.d.ts",
-      "!src/**/index.ts"
-    ]
-  }
-}

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

@@ -1,295 +0,0 @@
-/**
- * .matrix 格式縮寫映射表
- * 從 dev/design/matrix_format_ABBREVIATIONS.md 自動生成
- * @version 1.0.0
- */
-
-/**
- * 欄位名縮寫映射（完整名 → 縮寫）
- */
-export const FIELD_ABBREVIATIONS: Record<string, string> = {
-  // A. 狀態與優先級
-  status: 'st',
-  priority: 'p',
-  active: 'act',
-  blocked: 'b',
-  blocked_by: 'blk',
-  completed: 'c',
-  in_progress: 'p',
-  pending: 'pd',
-  cancelled: 'x',
-
-  // B. 時間相關
-  time: 't',
-  timestamp: 'ts',
-  created_at: 'ct',
-  updated_at: 'ut',
-  completed_at: 'cmplt',
-  started_at: 'start',
-  duration: 'dur',
-  duration_minutes: 'dur',
-  estimated_hours: 'est',
-  actual_hours: 'act_h',
-  date: 'd',
-  range: 'r',
-
-  // C. 識別與類型
-  id: 'i',
-  task_id: 'tid',
-  feature_id: 'fid',
-  type: 'ty',
-  category: 'cat',
-  tag: 'tg',
-  label: 'lbl',
-  version: 'v',
-  name: 'n',
-  title: 'tt',
-
-  // D. 團隊與角色
-  agent: 'ag',
-  agent_type: 'ag',
-  assignee: 'asn',
-  assigned_to: 'asn',
-  created_by: 'cb',
-  team: 'tm',
-  owner: 'own',
-  reviewer: 'rev',
-
-  // E. 數值與統計
-  count: 'c',
-  total: 'tot',
-  entries: 'e',
-  success_rate: 'succ',
-  percentage: 'pct',
-  score: 'sc',
-  weight: 'w',
-  rank: 'rk',
-  index: 'idx',
-
-  // F. 關係與依賴
-  dependencies: 'dep',
-  depends_on: 'dep',
-  parent: 'par',
-  children: 'ch',
-  related: 'rel',
-  linked_to: 'lnk',
-  references: 'ref',
-
-  // G. 內容與描述
-  description: 'd',
-  note: 'note',
-  comment: 'cmt',
-  message: 'msg',
-  summary: 'sum',
-  reason: 'rsn',
-  details: 'dtl',
-
-  // H. 專案與配置
-  project: 'proj',
-  repository: 'repo',
-  branch: 'br',
-  commit: 'cmt',
-  environment: 'env',
-  path: 'pth',
-  file: 'f',
-  scope: 'scp',
-
-  // I. 標誌與狀態
-  enabled: 'en',
-  visible: 'vis',
-  locked: 'lck',
-  archived: 'arc',
-  deleted: 'del',
-  draft: 'drf',
-  published: 'pub',
-  verified: 'vrf',
-
-  // J. 其他常用
-  source: 'src',
-  target: 'tgt',
-  format: 'fmt',
-  size: 'sz',
-  level: 'lvl',
-  complexity: 'cplx',
-  error: 'err',
-  result: 'res',
-};
-
-/**
- * 欄位名反向映射（縮寫 → 完整名）
- */
-export const FIELD_EXPANSIONS: Record<string, string> = Object.fromEntries(
-  Object.entries(FIELD_ABBREVIATIONS).map(([key, value]) => [value, key])
-);
-
-/**
- * 值代碼映射
- */
-export const VALUE_CODES = {
-  status: {
-    completed: 'C',
-    in_progress: 'P',
-    pending: 'D',
-    blocked: 'B',
-    cancelled: 'X',
-    review: 'R',
-    testing: 'T',
-    deployed: 'Y',
-    failed: 'F',
-  },
-  priority: {
-    P0: '0',
-    P1: '1',
-    P2: '2',
-    P3: '3',
-  },
-  complexity: {
-    simple: 'S',
-    moderate: 'M',
-    complex: 'C',
-    very_complex: 'V',
-  },
-  environment: {
-    development: 'dev',
-    staging: 'stg',
-    production: 'prod',
-    local: 'loc',
-  },
-  agent_type: {
-    product_manager: 'pm',
-    developer: 'dev',
-    backend_engineer: 'be',
-    frontend_engineer: 'fe',
-    designer: 'des',
-    qa_engineer: 'qa',
-    sre_agent: 'sre',
-    dev_agent: 'deva',
-  },
-  category: {
-    feature: 'feat',
-    bug: 'bug',
-    documentation: 'doc',
-    refactor: 'ref',
-    test: 'test',
-    chore: 'cho',
-    performance: 'perf',
-    security: 'sec',
-    design: 'des',
-    architecture: 'arch',
-  },
-  boolean: {
-    true: '1',
-    false: '0',
-    yes: '1',
-    no: '0',
-  },
-  result: {
-    success: 'OK',
-    failure: 'FAIL',
-    error: 'ERR',
-    timeout: 'TO',
-    skipped: 'SKIP',
-  },
-  blocked_by: {
-    API_DOWN: 'API_DOWN',
-    REVIEW_PENDING: 'REVIEW',
-    DEPENDENCY: 'DEP',
-    WAITING_INPUT: 'INPUT',
-    RESOURCE_UNAVAILABLE: 'RES',
-    EXTERNAL: 'EXT',
-  },
-};
-
-/**
- * 值代碼反向映射
- */
-export const VALUE_EXPANSIONS: Record<string, Record<string, string>> = {};
-for (const [field, codes] of Object.entries(VALUE_CODES)) {
-  VALUE_EXPANSIONS[field] = Object.fromEntries(
-    Object.entries(codes).map(([key, value]) => [value, key])
-  );
-}
-
-/**
- * 縮寫欄位名
- * @param fieldName 完整欄位名
- * @returns 縮寫名稱（如果存在映射）
- */
-export function abbreviateField(fieldName: string): string {
-  return FIELD_ABBREVIATIONS[fieldName] || fieldName;
-}
-
-/**
- * 展開欄位名
- * @param abbr 縮寫名稱
- * @returns 完整欄位名（如果存在映射）
- */
-export function expandField(abbr: string): string {
-  return FIELD_EXPANSIONS[abbr] || abbr;
-}
-
-/**
- * 編碼值
- * @param field 欄位名
- * @param value 原始值
- * @returns 編碼後的值
- */
-export function encodeValue(field: string, value: any): string {
-  if (field in VALUE_CODES) {
-    const codes = VALUE_CODES[field as keyof typeof VALUE_CODES];
-    return codes[String(value) as keyof typeof codes] || String(value);
-  }
-  return String(value);
-}
-
-/**
- * 解碼值
- * @param field 欄位名
- * @param code 代碼
- * @returns 解碼後的值
- */
-export function decodeValue(field: string, code: string): any {
-  if (field in VALUE_EXPANSIONS) {
-    const expansions = VALUE_EXPANSIONS[field];
-    return expansions[code] || code;
-  }
-  return code;
-}
-
-/**
- * 縮短時間戳
- * @param isoTimestamp ISO 8601 時間戳
- * @returns YYMMDD-HHMM 格式
- */
-export function shortenTimestamp(isoTimestamp: string): string {
-  const dt = new Date(isoTimestamp);
-  const year = String(dt.getFullYear()).slice(-2);
-  const month = String(dt.getMonth() + 1).padStart(2, '0');
-  const day = String(dt.getDate()).padStart(2, '0');
-  const hour = String(dt.getHours()).padStart(2, '0');
-  const minute = String(dt.getMinutes()).padStart(2, '0');
-  return `${year}${month}${day}-${hour}${minute}`;
-}
-
-/**
- * 展開時間戳
- * @param shortTs YYMMDD-HHMM 格式
- * @returns ISO 8601 時間戳
- */
-export function expandTimestamp(shortTs: string): string {
-  if (shortTs.includes('-')) {
-    const [datePart, timePart] = shortTs.split('-');
-    const yy = datePart.slice(0, 2);
-    const mm = datePart.slice(2, 4);
-    const dd = datePart.slice(4, 6);
-    const hh = timePart.slice(0, 2);
-    const mn = timePart.slice(2, 4);
-    return `20${yy}-${mm}-${dd}T${hh}:${mn}:00Z`;
-  } else {
-    // 僅日期
-    const yy = shortTs.slice(0, 2);
-    const mm = shortTs.slice(2, 4);
-    const dd = shortTs.slice(4, 6);
-    return `20${yy}-${mm}-${dd}`;
-  }
-}

package/core/dev/scripts/matrix/src/cli/commands/convert.ts

@@ -1,211 +0,0 @@
-/**
- * Convert command - 轉換 .matrix 和 JSON 格式
- * 支援 JSON ↔ .matrix 雙向轉換
- */
-
-import * as fs from 'fs';
-import * as path from 'path';
-import { MatrixParser } from '../../parser';
-import { MatrixSerializer } from '../../serializer';
-import { log, error as logError } from '../utils/logger';
-import type { MatrixFile } from '../../../types';
-
-interface ConvertOptions {
-  from?: 'json' | 'matrix';
-  to?: 'json' | 'matrix';
-}
-
-/**
- * Convert command handler
- */
-export async function convertCommand(input: string, output: string, options: ConvertOptions): Promise<void> {
-  try {
-    // 自動偵測格式（如果未指定）
-    const fromFormat = options.from || detectFormat(input);
-    const toFormat = options.to || detectFormat(output);
-
-    // 驗證格式
-    if (fromFormat === toFormat) {
-      throw new Error(`Input and output formats are the same (${fromFormat}). Nothing to convert.`);
-    }
-
-    if (fromFormat !== 'json' && fromFormat !== 'matrix') {
-      throw new Error(`Unsupported input format: ${fromFormat}. Use --from json or --from matrix.`);
-    }
-
-    if (toFormat !== 'json' && toFormat !== 'matrix') {
-      throw new Error(`Unsupported output format: ${toFormat}. Use --to json or --to matrix.`);
-    }
-
-    // 檢查輸入文件是否存在
-    if (!fs.existsSync(input)) {
-      throw new Error(`Input file not found: ${input}`);
-    }
-
-    // 執行轉換
-    if (fromFormat === 'matrix' && toFormat === 'json') {
-      matrixToJSON(input, output);
-    } else if (fromFormat === 'json' && toFormat === 'matrix') {
-      jsonToMatrix(input, output);
-    }
-
-    log(`✅ Conversion complete: ${input} → ${output}`);
-    log(`   Format: ${fromFormat} → ${toFormat}`);
-
-  } catch (err) {
-    logError((err as Error).message);
-    throw err;
-  }
-}
-
-/**
- * 自動偵測文件格式
- */
-function detectFormat(filePath: string): 'json' | 'matrix' | 'unknown' {
-  const ext = path.extname(filePath).toLowerCase();
-
-  if (ext === '.json') return 'json';
-  if (ext === '.matrix') return 'matrix';
-
-  // 無擴展名時，嘗試讀取文件內容判斷
-  if (fs.existsSync(filePath)) {
-    const content = fs.readFileSync(filePath, 'utf-8').trim();
-    if (content.startsWith('{') || content.startsWith('[')) {
-      return 'json';
-    }
-    if (content.includes('@meta') || content.includes('@index')) {
-      return 'matrix';
-    }
-  }
-
-  return 'unknown';
-}
-
-/**
- * .matrix → JSON
- */
-function matrixToJSON(inputPath: string, outputPath: string): void {
-  // 讀取並解析 .matrix 文件
-  const content = fs.readFileSync(inputPath, 'utf-8');
-  const parser = new MatrixParser();
-  const parseResult = parser.parse(content);
-
-  if (!parseResult.success || !parseResult.data) {
-    throw new Error(`Failed to parse .matrix file: ${parseResult.error?.message || 'Unknown error'}`);
-  }
-
-  const matrixFile = parseResult.data;
-
-  // 轉換為 JSON 格式（保留所有元數據）
-  const jsonData = convertMatrixToJSONObject(matrixFile);
-
-  // 寫入 JSON 文件
-  const jsonStr = JSON.stringify(jsonData, null, 2);
-  fs.writeFileSync(outputPath, jsonStr, 'utf-8');
-
-  log(`📄 Converted .matrix to JSON`);
-  log(`   Records: ${matrixFile.data?.records.length || 0}`);
-}
-
-/**
- * JSON → .matrix
- */
-function jsonToMatrix(inputPath: string, outputPath: string): void {
-  // 讀取 JSON 文件
-  const content = fs.readFileSync(inputPath, 'utf-8');
-  let jsonData: any;
-
-  try {
-    jsonData = JSON.parse(content);
-  } catch (err) {
-    throw new Error(`Invalid JSON file: ${(err as Error).message}`);
-  }
-
-  // 轉換為 MatrixFile 格式
-  const matrixFile = convertJSONObjectToMatrix(jsonData);
-
-  // 序列化為 .matrix 格式
-  const serializer = new MatrixSerializer({ pretty: true, includeComment: true });
-  const matrixContent = serializer.serialize(matrixFile);
-
-  // 寫入 .matrix 文件
-  fs.writeFileSync(outputPath, matrixContent, 'utf-8');
-
-  log(`📄 Converted JSON to .matrix`);
-  log(`   Records: ${matrixFile.data?.records.length || 0}`);
-}
-
-/**
- * 將 MatrixFile 轉換為 JSON 物件
- */
-function convertMatrixToJSONObject(matrixFile: MatrixFile): any {
-  const result: any = {
-    version: matrixFile.meta.v || matrixFile.meta.version,
-    category: matrixFile.meta.c || matrixFile.meta.category,
-    metadata: {},
-    statistics: {},
-    records: [],
-  };
-
-  // 保留 meta 中的額外欄位
-  for (const [key, value] of Object.entries(matrixFile.meta)) {
-    if (key !== 'v' && key !== 'version' && key !== 'c' && key !== 'category') {
-      result.metadata[key] = value;
-    }
-  }
-
-  // 保留 index 中的統計數據
-  result.statistics = { ...matrixFile.index };
-
-  // 轉換 data records
-  if (matrixFile.data && matrixFile.data.records) {
-    result.records = matrixFile.data.records.map(record => ({
-      id: record.id,
-      ...record.fields,
-    }));
-  }
-
-  return result;
-}
-
-/**
- * 將 JSON 物件轉換為 MatrixFile
- */
-function convertJSONObjectToMatrix(jsonData: any): MatrixFile {
-  // 驗證必要欄位
-  if (!jsonData.version && !jsonData.meta?.v) {
-    throw new Error('JSON must contain "version" field');
-  }
-
-  if (!jsonData.category && !jsonData.meta?.c) {
-    throw new Error('JSON must contain "category" field');
-  }
-
-  // 建立 MatrixFile
-  const matrixFile: MatrixFile = {
-    meta: {
-      v: jsonData.version || jsonData.meta?.v,
-      c: jsonData.category || jsonData.meta?.c,
-      ...jsonData.metadata,
-    },
-    index: {
-      ...jsonData.statistics,
-      tot: jsonData.records?.length || 0,
-    },
-  };
-
-  // 轉換 records
-  if (jsonData.records && Array.isArray(jsonData.records)) {
-    matrixFile.data = {
-      records: jsonData.records.map((record: any) => {
-        const { id, ...fields } = record;
-        if (!id) {
-          throw new Error('Each record must have an "id" field');
-        }
-        return { id, fields };
-      }),
-    };
-  }
-
-  return matrixFile;
-}

package/core/dev/scripts/matrix/src/cli/commands/create.ts

@@ -1,95 +0,0 @@
-/**
- * matrix create command
- * Creates a new .matrix file with interactive prompts or CLI parameters
- */
-
-import inquirer from 'inquirer';
-import { MatrixSerializer } from '../../serializer';
-import type { MatrixFile } from '../../../types';
-import { Logger } from '../utils/logger';
-import { FileHandler } from '../utils/file-handler';
-
-interface CreateOptions {
-  version?: string;
-  category?: string;
-  interactive?: boolean;
-}
-
-export async function createCommand(filePath: string, options: CreateOptions): Promise<void> {
-  Logger.header('Create .matrix File');
-
-  // Ensure .matrix extension
-  const targetPath = FileHandler.ensureExtension(filePath);
-
-  // Check if file exists
-  if (FileHandler.exists(targetPath)) {
-    Logger.error(`File already exists: ${targetPath}`);
-    Logger.info('Use "matrix update" to modify existing files');
-    process.exit(1);
-  }
-
-  let version = options.version;
-  let category = options.category;
-
-  // Interactive mode
-  if (options.interactive || (!version || !category)) {
-    const answers = await inquirer.prompt([
-      {
-        type: 'input',
-        name: 'version',
-        message: 'Version:',
-        default: version || '1.0.0',
-        validate: (input: string) => input.trim().length > 0 || 'Version is required',
-      },
-      {
-        type: 'list',
-        name: 'category',
-        message: 'Category:',
-        choices: [
-          { name: 'Tasks (T)', value: 'T' },
-          { name: 'Memory (M)', value: 'M' },
-          { name: 'Rules (R)', value: 'R' },
-          { name: 'Project Status (P)', value: 'P' },
-          { name: 'Custom', value: 'custom' },
-        ],
-        default: category,
-      },
-      {
-        type: 'input',
-        name: 'customCategory',
-        message: 'Enter custom category:',
-        when: (answers: any) => answers.category === 'custom',
-        validate: (input: string) => input.trim().length > 0 || 'Category is required',
-      },
-    ]);
-
-    version = answers.version;
-    category = answers.category === 'custom' ? answers.customCategory : answers.category;
-  }
-
-  // Create matrix file structure
-  const matrixFile: MatrixFile = {
-    meta: {
-      v: version!,
-      c: category!,
-    },
-    index: {
-      n: 0, // rule count
-    },
-    data: {
-      records: [],
-    },
-  };
-
-  // Serialize and write
-  const serializer = new MatrixSerializer();
-  const content = serializer.serialize(matrixFile);
-
-  if (FileHandler.write(targetPath, content)) {
-    Logger.success(`Created: ${targetPath}`);
-    Logger.field('Version', version);
-    Logger.field('Category', category);
-  } else {
-    process.exit(1);
-  }
-}