@mindbase/mindbase 1.0.0

package/src/clear/config.ts

@@ -0,0 +1,108 @@
+import { existsSync, writeFileSync } from 'fs';
+import { join } from 'path';
+import { homedir } from 'os';
+import { spawn } from 'child_process';
+import edit from 'editor';
+import { ConfigManager } from '../shared/index.js';
+
+/**
+ * 获取配置文件路径
+ */
+function getConfigPath(): string {
+  const appData = process.env.APPDATA || join(homedir(), '.config');
+  return join(appData, 'node-tools', 'config.json');
+}
+
+/**
+ * 默认配置
+ */
+export const DEFAULT_CONFIG: CleanConfig = {
+  targets: {
+    directories: ['node_modules', 'pnpm'],
+    files: ['package-lock.json', 'pnpm-lock.yaml', 'yarn.lock']
+  }
+};
+
+/**
+ * 配置类型
+ */
+export interface CleanConfig {
+  targets: {
+    directories: string[];
+    files: string[];
+  };
+}
+
+/**
+ * 配置管理器实例
+ */
+const manager = new ConfigManager<CleanConfig>(getConfigPath(), DEFAULT_CONFIG);
+
+/**
+ * 读取配置
+ */
+export function getConfig(): CleanConfig {
+  return manager.getConfig();
+}
+
+/**
+ * 写入配置
+ */
+export function setConfig(config: CleanConfig): void {
+  manager.setConfig(config);
+}
+
+/**
+ * 重置为默认配置
+ */
+export function resetConfig(): CleanConfig {
+  return manager.resetConfig();
+}
+
+/**
+ * 获取配置（用于显示）
+ */
+export function getConfigForDisplay(): string {
+  const config = getConfig();
+  return JSON.stringify(config, null, 2);
+}
+
+/**
+ * 编辑配置
+ */
+export function editConfig(callback?: (success: boolean) => void): void {
+  const configPath = getConfigPath();
+
+  // 确保配置文件存在
+  if (!existsSync(configPath)) {
+    setConfig(DEFAULT_CONFIG);
+  }
+
+  // 优先使用 code（VS Code）
+  const editorCmd = process.env.EDITOR || (process.platform === 'win32' ? 'code' : 'vim');
+
+  if (editorCmd === 'code') {
+    // Windows/macOS/Linux 使用 VS Code
+    const spawnOptions = process.platform === 'win32'
+      ? { shell: true, stdio: 'inherit' as const }
+      : { stdio: 'inherit' as const };
+
+    spawn('code', [configPath, '--wait'], spawnOptions)
+      .on('exit', (code) => {
+        callback?.(code === 0);
+      })
+      .on('error', () => {
+        // code 命令不可用，回退到 editor 包
+        edit(configPath, function (code, sig) {
+          callback?.(code === 0);
+        });
+      });
+  } else {
+    // 使用环境变量指定的编辑器
+    edit(configPath, function (code, sig) {
+      callback?.(code === 0);
+    });
+  }
+}
+
+export { getConfigPath };

package/src/clear/file-cleaner.ts

@@ -0,0 +1,137 @@
+import fsExtra from "fs-extra";
+const { remove } = fsExtra;
+import { unlink } from "fs/promises";
+
+/**
+ * 扫描结果项
+ */
+export interface ScanItem {
+  /** 完整路径 */
+  path: string;
+  /** 相对路径 */
+  relativePath: string;
+  /** 名称 */
+  name: string;
+  /** 类型 */
+  type: "dir" | "file";
+}
+
+/**
+ * 删除结果详情
+ */
+export interface CleanDetail extends ScanItem {
+  status: "success" | "failed";
+  error?: Error;
+}
+
+/**
+ * 清理统计
+ */
+export interface CleanStats {
+  success: number;
+  failed: number;
+  details: CleanDetail[];
+}
+
+/**
+ * 清理进度回调
+ */
+export interface CleanProgressCallback {
+  (progress: { current: number; total: number; success: number; failed: number }): void;
+}
+
+/**
+ * 删除目录
+ */
+export async function removeDir(path: string): Promise<void> {
+  await remove(path);
+}
+
+/**
+ * 删除文件
+ */
+export async function removeFile(path: string): Promise<void> {
+  await unlink(path);
+}
+
+/**
+ * 批量删除选中的项目（异步）
+ */
+export async function cleanAsync(items: ScanItem[]): Promise<CleanStats> {
+  const stats: CleanStats = {
+    success: 0,
+    failed: 0,
+    details: [],
+  };
+
+  const promises = items.map(async (item, index) => {
+    try {
+      if (item.type === "dir") {
+        await removeDir(item.path);
+      } else {
+        await removeFile(item.path);
+      }
+      return { ...item, status: "success" as const };
+    } catch (error) {
+      return { ...item, status: "failed" as const, error: error as Error };
+    }
+  });
+
+  const results = await Promise.allSettled(promises);
+
+  results.forEach((result, index) => {
+    if (result.status === "fulfilled") {
+      const detail = result.value;
+      if (detail.status === "success") {
+        stats.success++;
+      } else {
+        stats.failed++;
+      }
+      stats.details.push(detail);
+    } else {
+      stats.failed++;
+      stats.details.push({
+        ...items[index],
+        status: "failed",
+        error: new Error(String(result.reason)),
+      });
+    }
+  });
+
+  return stats;
+}
+
+/**
+ * 批量删除选中的项目（同步，兼容旧代码）
+ */
+export function clean(items: ScanItem[]): CleanStats {
+  const stats: CleanStats = {
+    success: 0,
+    failed: 0,
+    details: [],
+  };
+
+  for (const item of items) {
+    let success = false;
+    try {
+      if (item.type === "dir") {
+        removeDir(item.path);
+      } else {
+        removeFile(item.path);
+      }
+      success = true;
+    } catch {
+      success = false;
+    }
+
+    if (success) {
+      stats.success++;
+      stats.details.push({ ...item, status: "success" });
+    } else {
+      stats.failed++;
+      stats.details.push({ ...item, status: "failed" });
+    }
+  }
+
+  return stats;
+}

package/src/clear/index.ts

@@ -0,0 +1,28 @@
+// clear 领域导出
+export {
+  scan,
+  formatSize,
+  type ScanItem,
+  type CleanConfig,
+  type ScanProgressCallback
+} from './scanner.js';
+
+export {
+  getConfig,
+  setConfig,
+  resetConfig,
+  getConfigForDisplay,
+  editConfig,
+  getConfigPath,
+  DEFAULT_CONFIG
+} from './config.js';
+
+export {
+  cleanAsync,
+  clean,
+  removeDir,
+  removeFile,
+  type CleanStats,
+  type CleanDetail,
+  type CleanProgressCallback
+} from './file-cleaner.js';

package/src/clear/scanner.ts

@@ -0,0 +1,154 @@
+import { readdirSync, statSync } from "fs";
+import { join, relative } from "path";
+
+/**
+ * 扫描结果项
+ */
+export interface ScanItem {
+  /** 完整路径 */
+  path: string;
+  /** 相对路径 */
+  relativePath: string;
+  /** 名称 */
+  name: string;
+  /** 类型 */
+  type: "dir" | "file";
+  /** 大小（字节） */
+  size?: number;
+}
+
+/**
+ * 清理配置
+ */
+export interface CleanConfig {
+  targets: {
+    directories: string[];
+    files: string[];
+  };
+}
+
+/**
+ * 扫描进度回调
+ */
+export interface ScanProgressCallback {
+  (current: string, total: number): void;
+}
+
+/**
+ * 递归扫描目录，查找匹配的目标
+ */
+function scanDirectory(
+  basePath: string,
+  currentPath: string,
+  config: CleanConfig,
+  results: ScanItem[],
+  count = 0
+): number {
+  const { targets } = config;
+  const targetDirs = targets.directories || [];
+  const targetFiles = targets.files || [];
+
+  let entries;
+  try {
+    entries = readdirSync(currentPath);
+  } catch {
+    // 无权限访问或目录不存在，跳过
+    return count;
+  }
+
+  // 显示当前扫描的目录
+  for (const entry of entries) {
+    const fullPath = join(currentPath, entry);
+    let stat;
+
+    try {
+      stat = statSync(fullPath);
+    } catch {
+      continue;
+    }
+
+    if (stat.isDirectory()) {
+      // 检查是否是目标目录
+      if (targetDirs.includes(entry)) {
+        const relativePath = relative(basePath, fullPath);
+        results.push({
+          path: fullPath,
+          relativePath,
+          name: entry,
+          type: "dir",
+        });
+        count++;
+      } else {
+        // 递归扫描子目录
+        count = scanDirectory(basePath, fullPath, config, results, count);
+      }
+    } else if (stat.isFile()) {
+      // 检查是否是目标文件
+      if (targetFiles.includes(entry)) {
+        const relativePath = relative(basePath, fullPath);
+        results.push({
+          path: fullPath,
+          relativePath,
+          name: entry,
+          type: "file",
+        });
+        count++;
+      }
+    }
+  }
+
+  return count;
+}
+
+/**
+ * 获取目录大小（估算）
+ */
+function getDirectorySize(dirPath: string): number {
+  try {
+    let totalSize = 0;
+    const entries = readdirSync(dirPath);
+
+    for (const entry of entries) {
+      const fullPath = join(dirPath, entry);
+      try {
+        const stat = statSync(fullPath);
+        if (stat.isDirectory()) {
+          totalSize += getDirectorySize(fullPath);
+        } else if (stat.isFile()) {
+          totalSize += stat.size;
+        }
+      } catch {
+        // 跳过无法访问的文件
+      }
+    }
+
+    return totalSize;
+  } catch {
+    return 0;
+  }
+}
+
+/**
+ * 扫描指定目录
+ */
+export function scan(scanPath: string, config: CleanConfig): ScanItem[] {
+  const results: ScanItem[] = [];
+  scanDirectory(scanPath, scanPath, config, results, 0);
+  return results;
+}
+
+/**
+ * 格式化文件大小
+ */
+export function formatSize(bytes: number): string {
+  const units = ["B", "KB", "MB", "GB"];
+  let size = bytes;
+  let unitIndex = 0;
+
+  while (size >= 1024 && unitIndex < units.length - 1) {
+    size /= 1024;
+    unitIndex++;
+  }
+
+  return `${size.toFixed(1)} ${units[unitIndex]}`;
+}

package/src/gitlog/app.ts

@@ -0,0 +1,272 @@
+import * as clack from "@clack/prompts";
+import { noteBox } from "@mindbase/cli-ui";
+import { scanRepos, type GitRepo } from "./scanner.js";
+import { fetchLogsFromRepos, type GitLogEntry, type LogOptions } from "./log-fetcher.js";
+import { saveFilters, getSavedFilters, type LogFilters } from "./config.js";
+import { formatLogEntries, formatRepoOverview, formatFilters, LINES_PER_ENTRY } from "./display.js";
+import { runPager, type PagerAction } from "./pager.js";
+
+/** 应用上下文 */
+interface AppContext {
+  scanPath: string;
+  repos: GitRepo[];
+  filters: LogFilters;
+}
+
+/** 统一取消处理 */
+function handleCancel<T>(result: T | symbol): T {
+  if (clack.isCancel(result)) {
+    clack.cancel("操作已取消");
+    process.exit(0);
+  }
+  return result;
+}
+
+/** 将 LogFilters 转换为 LogOptions（跳过空值） */
+function toLogOptions(filters: LogFilters): LogOptions {
+  return {
+    author: filters.author || undefined,
+    since: filters.since || undefined,
+    until: filters.until || undefined,
+  };
+}
+
+// ==================== 主入口 ====================
+
+/**
+ * 运行 gitlog 应用
+ */
+export async function runApp(scanPath: string): Promise<void> {
+  // 扫描仓库
+  const s = clack.spinner();
+  s.start(`扫描目录: ${scanPath}`);
+  const repos = scanRepos(scanPath);
+  s.stop(`找到 ${repos.length} 个 Git 仓库`);
+
+  if (repos.length === 0) {
+    clack.log.warn("未找到任何 Git 仓库");
+    return;
+  }
+
+  // 显示仓库列表
+  noteBox(formatRepoOverview(repos), "仓库概览");
+
+  // 加载保存的筛选条件（since 默认7天前）
+  const filters = getSavedFilters();
+
+  const ctx: AppContext = { scanPath, repos, filters };
+  await mainLoop(ctx);
+}
+
+// ==================== 主循环 ====================
+
+async function mainLoop(ctx: AppContext): Promise<void> {
+  while (true) {
+    const action = handleCancel(
+      await clack.select({
+        message: "选择操作",
+        options: [
+          { value: "logs", label: "查看日志", hint: "选择仓库并查看提交日志" },
+          { value: "repos", label: "查看仓库概览", hint: "显示仓库状态" },
+          { value: "filters", label: "配置筛选条件", hint: "编辑作者、日期等筛选" },
+          { value: "rescan", label: "重新扫描", hint: "重新扫描目录" },
+          { value: "quit", label: "退出" },
+        ],
+      })
+    ) as string;
+
+    switch (action) {
+      case "logs":
+        await viewLogs(ctx);
+        break;
+      case "repos":
+        await viewRepos(ctx);
+        break;
+      case "filters":
+        await editFilters(ctx);
+        break;
+      case "rescan":
+        await rescan(ctx);
+        break;
+      case "quit":
+        return;
+    }
+  }
+}
+
+// ==================== 查看日志 ====================
+
+async function viewLogs(ctx: AppContext): Promise<void> {
+  const selected = handleCancel(
+    await clack.multiselect({
+      message: "选择要查看的仓库（a 全选/全反选）",
+      options: [
+        ...ctx.repos.map((repo) => ({
+          value: repo.path,
+          label: `${repo.name} (${repo.currentBranch || "-"})`,
+          hint: repo.hasChanges ? "有更改" : "无更改",
+        })),
+      ],
+      initialValues: ctx.filters.selectedRepos,
+      required: true,
+    })
+  ) as string[];
+
+  // 处理全选
+
+  ctx.filters.selectedRepos = selected;
+
+  // 直接使用当前筛选条件获取日志
+  await fetchAndBrowse(selected, ctx);
+}
+
+/**
+ * 获取日志并进入分页浏览
+ */
+async function fetchAndBrowse(repos: string[], ctx: AppContext): Promise<void> {
+  const logOptions = toLogOptions(ctx.filters);
+
+  // 显示筛选条件摘要
+  const filterHint = [
+    ctx.filters.author && `作者: ${ctx.filters.author}`,
+    ctx.filters.since && `起始: ${ctx.filters.since}`,
+    ctx.filters.until && `结束: ${ctx.filters.until}`,
+  ]
+    .filter(Boolean)
+    .join(" | ");
+  if (filterHint) {
+    clack.log.info(`筛选条件: ${filterHint}`);
+  }
+
+  const s = clack.spinner();
+  s.start("正在获取日志...");
+  const logs = await fetchLogsFromRepos(repos, logOptions);
+  s.stop(`获取到 ${logs.length} 条日志`);
+
+  if (logs.length === 0) {
+    clack.log.warn("未找到匹配的日志");
+    return;
+  }
+
+  // 进入分页浏览
+  const lines = formatLogEntries(logs);
+  let action: PagerAction = await runPager(lines, { linesPerEntry: LINES_PER_ENTRY });
+
+  // 按 r 重新筛选
+  while (action === "refilter") {
+    const newFilters = await collectFilterInputs(ctx.filters);
+    ctx.filters = newFilters;
+
+    const newLogOptions = toLogOptions(newFilters);
+    s.start("正在获取日志...");
+    const newLogs = await fetchLogsFromRepos(repos, newLogOptions);
+    s.stop(`获取到 ${newLogs.length} 条日志`);
+
+    if (newLogs.length === 0) {
+      clack.log.warn("未找到匹配的日志");
+      return;
+    }
+
+    const newLines = formatLogEntries(newLogs);
+    action = await runPager(newLines, { linesPerEntry: LINES_PER_ENTRY });
+  }
+}
+
+// ==================== 仓库概览 ====================
+
+async function viewRepos(ctx: AppContext): Promise<void> {
+  const overview = formatRepoOverview(ctx.repos);
+  noteBox(overview, "仓库概览");
+}
+
+// ==================== 筛选条件 ====================
+
+async function editFilters(ctx: AppContext): Promise<void> {
+  // 显示当前条件
+  noteBox(formatFilters(ctx.filters), "当前筛选条件");
+
+  // 收集新条件
+  const newFilters = await collectFilterInputs(ctx.filters);
+
+  // 保存
+  saveFilters(newFilters);
+  ctx.filters = newFilters;
+  clack.log.success("筛选条件已保存");
+}
+
+/**
+ * 交互式收集筛选条件
+ */
+async function collectFilterInputs(current?: LogFilters): Promise<LogFilters> {
+  const author = handleCancel(
+    await clack.text({
+      message: "作者（留空跳过）",
+      placeholder: "输入作者名或邮箱",
+      initialValue: current?.author || "",
+    })
+  ) as string;
+
+  const since = handleCancel(
+    await clack.text({
+      message: "起始日期（留空跳过，格式 YYYY-MM-DD）",
+      placeholder: "如 2025-01-01",
+      initialValue: current?.since || "",
+      validate: (v) => {
+        if (v && !/^\d{4}-\d{2}-\d{2}$/.test(v)) return "日期格式应为 YYYY-MM-DD";
+      },
+    })
+  ) as string;
+
+  const until = handleCancel(
+    await clack.text({
+      message: "结束日期（留空跳过，格式 YYYY-MM-DD）",
+      placeholder: "如 2025-12-31",
+      initialValue: current?.until || "",
+      validate: (v) => {
+        if (v && !/^\d{4}-\d{2}-\d{2}$/.test(v)) return "日期格式应为 YYYY-MM-DD";
+      },
+    })
+  ) as string;
+
+  return {
+    author: author || "",
+    since: since || "",
+    until: until || "",
+    selectedRepos: current?.selectedRepos || [],
+  };
+}
+
+// ==================== 重新扫描 ====================
+
+async function rescan(ctx: AppContext): Promise<void> {
+  const s = clack.spinner();
+  s.start(`重新扫描: ${ctx.scanPath}`);
+  ctx.repos = scanRepos(ctx.scanPath);
+  s.stop(`找到 ${ctx.repos.length} 个 Git 仓库`);
+
+  if (ctx.repos.length > 0) {
+    noteBox(formatRepoOverview(ctx.repos), "仓库概览");
+  }
+}
+
+// ==================== config 子命令 ====================
+
+/**
+ * 处理 config 子命令
+ */
+export async function showConfig(options: { show?: boolean; reset?: boolean }): Promise<void> {
+  if (options.reset) {
+    const defaultFilters: LogFilters = {
+      author: "",
+      since: "",
+      until: "",
+      selectedRepos: [],
+    };
+    saveFilters(defaultFilters);
+    clack.log.success("筛选条件已重置");
+    return;
+  }
+
+  const filters = getSavedFilters();
+  noteBox(formatFilters(filters), "当前筛选条件");
+}