kenaz 0.3.17 → 0.3.19

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

@@ -1,102 +0,0 @@
-/**
- * matrix delete command
- * Deletes a rule from .matrix file and auto-updates @index statistics
- */
-
-import inquirer from 'inquirer';
-import { MatrixParser } from '../../parser';
-import { MatrixSerializer } from '../../serializer';
-import { Logger } from '../utils/logger';
-import { FileHandler } from '../utils/file-handler';
-
-interface DeleteOptions {
-  force?: boolean;
-}
-
-export async function deleteCommand(
-  filePath: string,
-  ruleId: string,
-  options: DeleteOptions
-): Promise<void> {
-  Logger.header('Delete .matrix Rule');
-
-  // Ensure .matrix extension
-  const targetPath = FileHandler.ensureExtension(filePath);
-
-  // Read and parse file
-  const content = FileHandler.read(targetPath);
-  if (!content) {
-    process.exit(1);
-  }
-
-  const parser = new MatrixParser();
-  const result = parser.parse(content);
-
-  if (!result.success) {
-    Logger.error('Failed to parse file');
-    if (result.error) {
-      Logger.error(`  ${result.error.message}`);
-    }
-    process.exit(1);
-  }
-
-  const matrixFile = result.data!;
-
-  // Find rule by ID
-  if (!matrixFile.data) {
-    Logger.error('No data records found in file');
-    process.exit(1);
-  }
-
-  const recordIndex = matrixFile.data.records.findIndex(r => r.id === ruleId);
-  if (recordIndex === -1) {
-    Logger.error(`Rule not found: ${ruleId}`);
-    Logger.info('Use "matrix read" to list available rules');
-    process.exit(1);
-  }
-
-  const record = matrixFile.data.records[recordIndex];
-
-  Logger.info(`Found rule: ${ruleId}`);
-  Logger.record(ruleId, record.fields);
-
-  // Confirm deletion
-  if (!options.force) {
-    const answers = await inquirer.prompt([
-      {
-        type: 'confirm',
-        name: 'confirm',
-        message: `Are you sure you want to delete rule "${ruleId}"?`,
-        default: false,
-      },
-    ]);
-
-    if (!answers.confirm) {
-      Logger.info('Deletion cancelled');
-      return;
-    }
-  }
-
-  // Delete record
-  matrixFile.data.records.splice(recordIndex, 1);
-
-  // Auto-update @index statistics
-  if (matrixFile.index.n !== undefined) {
-    matrixFile.index.n = matrixFile.data.records.length;
-  }
-
-  if (matrixFile.index.upd !== undefined) {
-    matrixFile.index.upd = new Date().toISOString().replace(/T/, ' ').replace(/\..+/, '');
-  }
-
-  // Serialize and write
-  const serializer = new MatrixSerializer();
-  const newContent = serializer.serialize(matrixFile);
-
-  if (FileHandler.write(targetPath, newContent)) {
-    Logger.success(`Deleted rule: ${ruleId}`);
-    Logger.field('Remaining rules', matrixFile.data.records.length);
-  } else {
-    process.exit(1);
-  }
-}

package/core/dev/scripts/matrix/src/cli/commands/list-tags.ts.wip

@@ -1,140 +0,0 @@
-/**
- * list-tags command - List all tags and their usage counts
- */
-
-import chalk from 'chalk';
-import { resolveFilePath } from '../utils/file-handler';
-import { parseMatrixFile } from '../../parser';
-import { TagIndexer } from '../../indexer/tag-indexer';
-
-interface ListTagsOptions {
-  type?: string; // Filter by tag type: source, category, priority, domain, custom
-  sort?: 'name' | 'count'; // Sort by name or count
-}
-
-export async function listTagsCommand(
-  file: string,
-  options: ListTagsOptions = {}
-): Promise<void> {
-  const filePath = resolveFilePath(file);
-
-  // Parse file
-  const matrixFile = parseMatrixFile(filePath);
-
-  // Build tag index
-  const indexer = new TagIndexer();
-  indexer.buildIndex(matrixFile);
-
-  // Get tag statistics
-  let tagStats = indexer.getTagStats();
-
-  // Filter by type if specified
-  if (options.type) {
-    const typePrefix = options.type.toLowerCase();
-    tagStats = tagStats.filter((stat) => {
-      if (typePrefix === 'custom') {
-        return stat.tag.startsWith('#');
-      }
-      return stat.tag.startsWith(`${typePrefix}:`);
-    });
-  }
-
-  // Sort by name if specified
-  if (options.sort === 'name') {
-    tagStats.sort((a, b) => a.tag.localeCompare(b.tag));
-  }
-  // Default: already sorted by count descending
-
-  console.log(chalk.bold.cyan('\n🏷️  Tags\n'));
-  console.log(chalk.gray(`File: ${filePath}\n`));
-
-  if (tagStats.length === 0) {
-    console.log(chalk.yellow('No tags found.'));
-    console.log();
-    return;
-  }
-
-  // Group tags by type
-  const groupedTags = groupTagsByType(tagStats);
-
-  // Display each group
-  for (const [type, tags] of Object.entries(groupedTags)) {
-    if (!options.type || options.type.toLowerCase() === type.toLowerCase()) {
-      console.log(chalk.bold(`${getTypeEmoji(type)} ${type}:`));
-
-      for (const stat of tags) {
-        const tagDisplay = stat.tag.replace(`${type.toLowerCase()}:`, '');
-        const bar = '█'.repeat(Math.min(stat.count, 20));
-        console.log(
-          `  ${chalk.cyan(tagDisplay.padEnd(20))} ${chalk.green(bar)} ${chalk.yellow(stat.count)}`
-        );
-      }
-
-      console.log();
-    }
-  }
-
-  // Summary
-  console.log(chalk.bold('Summary:'));
-  console.log(`  Total tags:      ${chalk.cyan(tagStats.length)}`);
-  console.log(`  Total tag types: ${chalk.cyan(Object.keys(groupedTags).length)}`);
-  console.log();
-}
-
-/**
- * Group tags by type
- */
-function groupTagsByType(
-  tagStats: { tag: string; count: number; ruleIds: string[] }[]
-): Record<string, typeof tagStats> {
-  const grouped: Record<string, typeof tagStats> = {
-    Source: [],
-    Category: [],
-    Priority: [],
-    Domain: [],
-    Custom: [],
-  };
-
-  for (const stat of tagStats) {
-    if (stat.tag.startsWith('source:')) {
-      grouped.Source.push(stat);
-    } else if (stat.tag.startsWith('category:')) {
-      grouped.Category.push(stat);
-    } else if (stat.tag.startsWith('priority:')) {
-      grouped.Priority.push(stat);
-    } else if (stat.tag.startsWith('domain:')) {
-      grouped.Domain.push(stat);
-    } else {
-      grouped.Custom.push(stat);
-    }
-  }
-
-  // Remove empty groups
-  for (const key of Object.keys(grouped)) {
-    if (grouped[key].length === 0) {
-      delete grouped[key];
-    }
-  }
-
-  return grouped;
-}
-
-/**
- * Get emoji for tag type
- */
-function getTypeEmoji(type: string): string {
-  switch (type.toLowerCase()) {
-    case 'source':
-      return '📦';
-    case 'category':
-      return '📂';
-    case 'priority':
-      return '⚡';
-    case 'domain':
-      return '🌐';
-    case 'custom':
-      return '🏷️';
-    default:
-      return '•';
-  }
-}

package/core/dev/scripts/matrix/src/cli/commands/manage-tags.ts.wip

@@ -1,173 +0,0 @@
-/**
- * add-tag / remove-tag commands - Manage rule tags
- */
-
-import chalk from 'chalk';
-import * as fs from 'fs';
-import { resolveFilePath } from '../utils/file-handler';
-import { parseMatrixFile } from '../../parser';
-import { serializeMatrixFile } from '../../serializer';
-import { TagIndexer, buildTagIndex } from '../../indexer/tag-indexer';
-
-interface ManageTagsOptions {
-  force?: boolean;
-}
-
-/**
- * Add tag to a rule
- */
-export async function addTagCommand(
-  file: string,
-  ruleId: string,
-  tag: string,
-  options: ManageTagsOptions = {}
-): Promise<void> {
-  const filePath = resolveFilePath(file);
-
-  // Parse file
-  const matrixFile = parseMatrixFile(filePath);
-
-  // Find rule
-  const rule = matrixFile.rules.find((r) => r.id === ruleId);
-  if (!rule) {
-    throw new Error(`Rule not found: ${ruleId}`);
-  }
-
-  // Ensure tag starts with # (for custom tags)
-  const normalizedTag = tag.startsWith('#') ? tag : `#${tag}`;
-
-  // Initialize tags array if not exists
-  if (!rule.tags) {
-    rule.tags = [];
-  }
-
-  // Check if tag already exists
-  if (Array.isArray(rule.tags) && rule.tags.includes(normalizedTag)) {
-    console.log(chalk.yellow(`Tag already exists: ${normalizedTag}`));
-    return;
-  }
-
-  // Add tag
-  if (Array.isArray(rule.tags)) {
-    rule.tags.push(normalizedTag);
-  } else {
-    rule.tags = [normalizedTag];
-  }
-
-  // Save file
-  const serialized = serializeMatrixFile(matrixFile);
-  fs.writeFileSync(filePath, serialized, 'utf-8');
-
-  // Rebuild tag index
-  const indexPath = filePath.replace('.matrix', '.tags.json');
-  buildTagIndex(matrixFile, indexPath);
-
-  console.log(chalk.green(`✓ Tag added: ${normalizedTag} to ${ruleId}`));
-  console.log(chalk.gray(`  Index updated: ${indexPath}`));
-}
-
-/**
- * Remove tag from a rule
- */
-export async function removeTagCommand(
-  file: string,
-  ruleId: string,
-  tag: string,
-  options: ManageTagsOptions = {}
-): Promise<void> {
-  const filePath = resolveFilePath(file);
-
-  // Parse file
-  const matrixFile = parseMatrixFile(filePath);
-
-  // Find rule
-  const rule = matrixFile.rules.find((r) => r.id === ruleId);
-  if (!rule) {
-    throw new Error(`Rule not found: ${ruleId}`);
-  }
-
-  // Ensure tag starts with # (for custom tags)
-  const normalizedTag = tag.startsWith('#') ? tag : `#${tag}`;
-
-  // Check if rule has tags
-  if (!rule.tags || !Array.isArray(rule.tags)) {
-    console.log(chalk.yellow(`Rule has no tags: ${ruleId}`));
-    return;
-  }
-
-  // Find tag index
-  const tagIndex = rule.tags.indexOf(normalizedTag);
-  if (tagIndex === -1) {
-    console.log(chalk.yellow(`Tag not found: ${normalizedTag}`));
-    return;
-  }
-
-  // Remove tag
-  rule.tags.splice(tagIndex, 1);
-
-  // Save file
-  const serialized = serializeMatrixFile(matrixFile);
-  fs.writeFileSync(filePath, serialized, 'utf-8');
-
-  // Rebuild tag index
-  const indexPath = filePath.replace('.matrix', '.tags.json');
-  buildTagIndex(matrixFile, indexPath);
-
-  console.log(chalk.green(`✓ Tag removed: ${normalizedTag} from ${ruleId}`));
-  console.log(chalk.gray(`  Index updated: ${indexPath}`));
-}
-
-/**
- * List tags for a specific rule
- */
-export async function showRuleTagsCommand(
-  file: string,
-  ruleId: string
-): Promise<void> {
-  const filePath = resolveFilePath(file);
-
-  // Parse file
-  const matrixFile = parseMatrixFile(filePath);
-
-  // Find rule
-  const rule = matrixFile.rules.find((r) => r.id === ruleId);
-  if (!rule) {
-    throw new Error(`Rule not found: ${ruleId}`);
-  }
-
-  console.log(chalk.bold.cyan(`\n🏷️  Tags for ${ruleId}\n`));
-
-  // Collect all tags
-  const allTags: string[] = [];
-
-  if (rule.source) allTags.push(`source:${rule.source}`);
-  if (rule.category) allTags.push(`category:${rule.category}`);
-  if (rule.priority) allTags.push(`priority:${rule.priority}`);
-  if (rule.domain) allTags.push(`domain:${rule.domain}`);
-  if (rule.tags && Array.isArray(rule.tags)) {
-    allTags.push(...rule.tags);
-  }
-
-  if (allTags.length === 0) {
-    console.log(chalk.yellow('No tags found.'));
-  } else {
-    for (const tag of allTags) {
-      const emoji = getTagEmoji(tag);
-      console.log(`  ${emoji} ${chalk.cyan(tag)}`);
-    }
-  }
-
-  console.log();
-}
-
-/**
- * Get emoji for tag
- */
-function getTagEmoji(tag: string): string {
-  if (tag.startsWith('source:')) return '📦';
-  if (tag.startsWith('category:')) return '📂';
-  if (tag.startsWith('priority:')) return '⚡';
-  if (tag.startsWith('domain:')) return '🌐';
-  if (tag.startsWith('#')) return '🏷️';
-  return '•';
-}

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

@@ -1,261 +0,0 @@
-/**
- * Query command - 查詢 .matrix 文件
- * 支援標籤過濾、優先級過濾、狀態過濾、關鍵字搜尋
- */
-
-import * as fs from 'fs';
-import { MatrixParser } from '../../parser';
-import { log, error as logError } from '../utils/logger';
-import type { MatrixFile, DataRecord } from '../../../types';
-
-interface QueryOptions {
-  tag?: string;
-  priority?: string;
-  status?: string;
-  keyword?: string;
-  format?: 'table' | 'json' | 'compact';
-}
-
-interface QueryResult {
-  records: DataRecord[];
-  total: number;
-}
-
-/**
- * Query command handler
- */
-export async function queryCommand(file: string, options: QueryOptions): Promise<void> {
-  try {
-    // 確保文件有 .matrix 擴展名
-    const filePath = file.endsWith('.matrix') ? file : `${file}.matrix`;
-
-    // 檢查文件是否存在
-    if (!fs.existsSync(filePath)) {
-      throw new Error(`File not found: ${filePath}`);
-    }
-
-    // 讀取並解析文件
-    const content = fs.readFileSync(filePath, 'utf-8');
-    const parser = new MatrixParser();
-    const parseResult = parser.parse(content);
-
-    if (!parseResult.success || !parseResult.data) {
-      throw new Error(`Failed to parse file: ${parseResult.error?.message || 'Unknown error'}`);
-    }
-
-    const matrixFile = parseResult.data;
-
-    // 執行查詢
-    const result = executeQuery(matrixFile, options);
-
-    // 輸出結果
-    displayResults(result, options.format || 'table', matrixFile);
-
-  } catch (err) {
-    logError((err as Error).message);
-    throw err;
-  }
-}
-
-/**
- * 執行查詢邏輯（支援索引優化）
- */
-function executeQuery(matrixFile: MatrixFile, options: QueryOptions): QueryResult {
-  // 如果沒有 data section，返回空結果
-  if (!matrixFile.data || !matrixFile.data.records) {
-    return { records: [], total: 0 };
-  }
-
-  let filteredRecords = matrixFile.data.records;
-
-  // 索引優化：先檢查 @index 層是否有快速過濾機會
-  // 例如：如果查詢 status=completed，先查看 index 的 completed 計數
-  if (options.status && matrixFile.index) {
-    const statusKey = getStatusKey(options.status);
-    const countInIndex = matrixFile.index[statusKey];
-
-    // 如果 index 顯示該狀態為 0，直接返回空結果
-    if (countInIndex === 0) {
-      return { records: [], total: 0 };
-    }
-  }
-
-  // 過濾：tag
-  if (options.tag) {
-    filteredRecords = filteredRecords.filter(record => {
-      const tags = record.fields.tags || record.fields.tag;
-      if (Array.isArray(tags)) {
-        return tags.includes(options.tag);
-      }
-      if (typeof tags === 'string') {
-        return tags.split(',').map(t => t.trim()).includes(options.tag);
-      }
-      return false;
-    });
-  }
-
-  // 過濾：priority
-  if (options.priority) {
-    filteredRecords = filteredRecords.filter(record => {
-      const priority = record.fields.priority || record.fields.pri || record.fields.p;
-      return priority === options.priority || priority === options.priority.toUpperCase();
-    });
-  }
-
-  // 過濾：status
-  if (options.status) {
-    filteredRecords = filteredRecords.filter(record => {
-      const status = record.fields.status || record.fields.st;
-      return matchStatus(status, options.status!);
-    });
-  }
-
-  // 關鍵字搜尋（在所有字段中搜尋）
-  if (options.keyword) {
-    const keyword = options.keyword.toLowerCase();
-    filteredRecords = filteredRecords.filter(record => {
-      // 搜尋 ID
-      if (record.id.toLowerCase().includes(keyword)) {
-        return true;
-      }
-
-      // 搜尋所有欄位值
-      for (const value of Object.values(record.fields)) {
-        const valueStr = String(value).toLowerCase();
-        if (valueStr.includes(keyword)) {
-          return true;
-        }
-      }
-
-      return false;
-    });
-  }
-
-  return {
-    records: filteredRecords,
-    total: filteredRecords.length,
-  };
-}
-
-/**
- * 狀態匹配（支援縮寫）
- */
-function matchStatus(recordStatus: any, queryStatus: string): boolean {
-  const status = String(recordStatus).toLowerCase();
-  const query = queryStatus.toLowerCase();
-
-  // 完全匹配
-  if (status === query) return true;
-
-  // 縮寫匹配
-  const statusMap: Record<string, string[]> = {
-    'p': ['pending', 'p'],
-    'pending': ['pending', 'p'],
-    'i': ['in_progress', 'i', 'inprogress'],
-    'in_progress': ['in_progress', 'i', 'inprogress'],
-    'c': ['completed', 'c', 'done'],
-    'completed': ['completed', 'c', 'done'],
-    'b': ['blocked', 'b'],
-    'blocked': ['blocked', 'b'],
-  };
-
-  return statusMap[query]?.includes(status) || statusMap[status]?.includes(query) || false;
-}
-
-/**
- * 取得狀態在 index 中的鍵名
- */
-function getStatusKey(status: string): string {
-  const query = status.toLowerCase();
-
-  const keyMap: Record<string, string> = {
-    'p': 'pending',
-    'pending': 'pending',
-    'i': 'inprogress',
-    'in_progress': 'inprogress',
-    'inprogress': 'inprogress',
-    'c': 'completed',
-    'completed': 'completed',
-    'done': 'completed',
-    'b': 'blocked',
-    'blocked': 'blocked',
-  };
-
-  return keyMap[query] || query;
-}
-
-/**
- * 顯示查詢結果
- */
-function displayResults(result: QueryResult, format: 'table' | 'json' | 'compact', matrixFile: MatrixFile): void {
-  if (result.total === 0) {
-    log('No records found matching the query.');
-    return;
-  }
-
-  switch (format) {
-    case 'json':
-      displayJSON(result);
-      break;
-    case 'compact':
-      displayCompact(result);
-      break;
-    case 'table':
-    default:
-      displayTable(result, matrixFile);
-      break;
-  }
-}
-
-/**
- * 表格格式顯示
- */
-function displayTable(result: QueryResult, matrixFile: MatrixFile): void {
-  log(`\n📊 Query Results (${result.total} records found)\n`);
-  log('─'.repeat(80));
-
-  // 表頭
-  const headerRow = ['ID', 'Status', 'Priority', 'Title/Description'];
-  const colWidths = [15, 12, 10, 40];
-
-  const header = headerRow.map((h, i) => h.padEnd(colWidths[i])).join(' | ');
-  log(header);
-  log('─'.repeat(80));
-
-  // 數據行
-  for (const record of result.records) {
-    const id = record.id.padEnd(colWidths[0]);
-    const status = (record.fields.status || record.fields.st || '-').toString().padEnd(colWidths[1]);
-    const priority = (record.fields.priority || record.fields.pri || record.fields.p || '-').toString().padEnd(colWidths[2]);
-    const title = (record.fields.title || record.fields.desc || record.fields.description || '-').toString().substring(0, colWidths[3]).padEnd(colWidths[3]);
-
-    log(`${id} | ${status} | ${priority} | ${title}`);
-  }
-
-  log('─'.repeat(80));
-  log(`Total: ${result.total} record(s)\n`);
-}
-
-/**
- * JSON 格式顯示
- */
-function displayJSON(result: QueryResult): void {
-  console.log(JSON.stringify(result.records, null, 2));
-}
-
-/**
- * 精簡格式顯示
- */
-function displayCompact(result: QueryResult): void {
-  log(`Found ${result.total} record(s):\n`);
-
-  for (const record of result.records) {
-    const status = record.fields.status || record.fields.st || '-';
-    const priority = record.fields.priority || record.fields.pri || record.fields.p || '-';
-    const title = record.fields.title || record.fields.desc || '-';
-
-    log(`  • ${record.id} [${status}] [P${priority}] ${title}`);
-  }
-
-  log('');
-}