kenaz 0.3.18 → 0.3.20

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

@@ -1,124 +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; // version
-  c: string; // category
-  t?: string; // timestamp (YYMMDD-HHMM)
-  r?: string; // range
-  proj?: string; // project
-  [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; // E001, E002, etc.
-  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;
-}

package/core/dev/scripts/memory-usage-report.js

@@ -1,152 +0,0 @@
-#!/usr/bin/env node
-/**
- * memory-usage-report.js — TASK_2024
- *
- * Reads .kenaz/specialist/memory_usage.jsonl (written by memory-guard.js's
- * match()/matchAreas() on real hook invocations, and by memory-guard.js main() on Read
- * for a direct Read of a memory/knowledge-dir file — see memory-guard.js
- * appendUsageLog()) and reports, per memory file:
- *   - last used timestamp
- *   - counts by kind (guard | area | read)
- * plus a separate list of memory files that were NOT used in the last N
- * days (default 90), with their mtime — candidates for pruning.
- *
- * "Used" here means logged by memory-guard's usage log, not merely present
- * on disk; a file with zero log lines has never fired a guard trigger,
- * been surfaced in an area digest, or been Read directly.
- *
- * Usage:
- *   node dev/scripts/memory-usage-report.js [--project-dir=<path>] [--days=90]
- *
- * GEN-008: no hardcoded project path — defaults to CLAUDE_PROJECT_DIR/cwd.
- */
-
-'use strict';
-
-const fs = require('fs');
-const path = require('path');
-const guard = require('../../.claude/hooks/memory-guard');
-
-// Index files, not prunable memory entries — excluded from both report sections.
-const INDEX_FILES = new Set(['KNOWLEDGE.md', 'MEMORY.md']);
-
-function parseArgs(argv) {
-  const out = { days: 90, projectDir: process.env.CLAUDE_PROJECT_DIR || process.cwd() };
-  for (const a of argv) {
-    const dMatch = a.match(/^--days=(\d+)$/);
-    if (dMatch) out.days = parseInt(dMatch[1], 10);
-    const pMatch = a.match(/^--project-dir=(.+)$/);
-    if (pMatch) out.projectDir = path.resolve(pMatch[1]);
-  }
-  return out;
-}
-
-/** Read every parseable line of the usage log; a malformed line is skipped, never fatal. */
-function readUsageLog(usageLogPath) {
-  let lines;
-  try {
-    lines = fs.readFileSync(usageLogPath, 'utf8').split(/\r?\n/).filter(Boolean);
-  } catch {
-    return [];
-  }
-  const records = [];
-  for (const line of lines) {
-    try {
-      const r = JSON.parse(line);
-      if (r && typeof r === 'object' && r.file) records.push(r);
-    } catch {
-      /* skip malformed line */
-    }
-  }
-  return records;
-}
-
-/** Every .md memory file across the project's source dirs (memory dir + active knowledge dir), excluding index files. */
-function listMemoryFiles(projectDir) {
-  const files = new Map(); // absPath -> { name, dir, mtimeMs }
-  for (const dir of guard.defaultSourceDirs(projectDir)) {
-    let entries;
-    try {
-      entries = fs.readdirSync(dir);
-    } catch {
-      continue;
-    }
-    for (const name of entries) {
-      if (!name.endsWith('.md') || INDEX_FILES.has(name)) continue;
-      const absPath = path.join(dir, name);
-      let mtimeMs = 0;
-      try {
-        mtimeMs = fs.statSync(absPath).mtimeMs;
-      } catch {
-        continue;
-      }
-      files.set(absPath, { name, dir, mtimeMs });
-    }
-  }
-  return files;
-}
-
-function formatDate(ms) {
-  if (!ms) return '(never)';
-  return new Date(ms).toISOString();
-}
-
-function main() {
-  const { days, projectDir } = parseArgs(process.argv.slice(2));
-  const usageLogPath = guard.defaultUsageLogPath(projectDir);
-  const records = readUsageLog(usageLogPath);
-  const memoryFiles = listMemoryFiles(projectDir);
-
-  console.log(`Usage log: ${usageLogPath} (${records.length} record(s))`);
-  console.log(`Memory files found: ${memoryFiles.size}`);
-
-  // Aggregate by basename — the same filename may exist under multiple
-  // source dirs (memory dir vs. a sub-project's .kenaz/knowledge dir), and
-  // the usage log only carries the basename, not the full path.
-  const usageByFile = new Map(); // name -> { lastUsedMs, counts: { guard, area, read } }
-  for (const r of records) {
-    let entry = usageByFile.get(r.file);
-    if (!entry) {
-      entry = { lastUsedMs: 0, counts: { guard: 0, area: 0, read: 0 } };
-      usageByFile.set(r.file, entry);
-    }
-    const ts = Date.parse(r.ts);
-    if (!Number.isNaN(ts) && ts > entry.lastUsedMs) entry.lastUsedMs = ts;
-    if (r.kind && Object.prototype.hasOwnProperty.call(entry.counts, r.kind)) {
-      entry.counts[r.kind]++;
-    } else if (r.kind) {
-      entry.counts[r.kind] = (entry.counts[r.kind] || 0) + 1;
-    }
-  }
-
-  console.log('\nPer-file usage (last used, counts by kind):');
-  const usedRows = Array.from(usageByFile.entries()).sort((a, b) => b[1].lastUsedMs - a[1].lastUsedMs);
-  if (!usedRows.length) console.log('  (no usage recorded yet)');
-  for (const [name, entry] of usedRows) {
-    const countsStr = Object.entries(entry.counts)
-      .filter(([, n]) => n > 0)
-      .map(([k, n]) => `${k}=${n}`)
-      .join(' ');
-    console.log(`  ${name} — last used: ${formatDate(entry.lastUsedMs)} — ${countsStr}`);
-  }
-
-  const cutoffMs = Date.now() - days * 24 * 60 * 60 * 1000;
-  const unused = [];
-  for (const [absPath, info] of memoryFiles) {
-    const usage = usageByFile.get(info.name);
-    const lastUsedMs = usage ? usage.lastUsedMs : 0;
-    if (lastUsedMs < cutoffMs) {
-      unused.push({ name: info.name, absPath, mtimeMs: info.mtimeMs, lastUsedMs });
-    }
-  }
-  unused.sort((a, b) => a.mtimeMs - b.mtimeMs);
-
-  console.log(`\nNever used in the last ${days} day(s) (${unused.length} file(s), oldest mtime first):`);
-  if (!unused.length) console.log('  (none)');
-  for (const u of unused) {
-    const lastUsedStr = u.lastUsedMs ? `last used ${formatDate(u.lastUsedMs)}` : 'never used';
-    console.log(`  ${u.name} — mtime: ${formatDate(u.mtimeMs)} — ${lastUsedStr}`);
-  }
-}
-
-main();