@tnotesjs/core 0.2.2 → 0.4.0

package/services/timestamp/service.ts

@@ -1,465 +0,0 @@
-/**
- * services/TimestampService.ts
- *
- * 时间戳服务 - 管理笔记的创建时间和更新时间
- */
-
-import { execSync } from 'child_process'
-import {
-  existsSync,
-  readFileSync,
-  writeFileSync,
-  readdirSync,
-  statSync,
-} from 'fs'
-import { join } from 'path'
-
-import {
-  NOTES_DIR_PATH,
-  ROOT_DIR_PATH,
-  ROOT_CONFIG_PATH,
-} from '../../config/constants'
-import { NoteManager } from '../../core/NoteManager'
-import { logger } from '../../utils'
-
-import type { NoteConfig, TNotesConfig } from '../../types'
-
-/**
- * 出生日期（用于计算 days_since_birth）
- * 1999-06-29 作为第 1 天
- */
-const BIRTH_DATE = new Date('1999-06-29T00:00:00+08:00').getTime()
-
-/**
- * 时间戳服务类
- */
-export class TimestampService {
-  private noteManager: NoteManager
-
-  constructor() {
-    this.noteManager = NoteManager.getInstance()
-  }
-
-  /**
-   * 批量获取所有笔记 README.md 的 git 时间戳
-   * 只执行 2 次 git log，构建 filePath → {created_at, updated_at} 的映射
-   *
-   * - 第 1 次：git log --name-only --format=... --diff-filter=A
-   *   获取每个文件的首次提交时间（created_at）
-   * - 第 2 次：git log --name-only --format=...
-   *   获取每个文件的最后修改时间（updated_at）
-   */
-  private buildGitTimestampMap(): Map<
-    string,
-    { created_at: number; updated_at: number }
-  > {
-    const createdMap = new Map<string, number>()
-    const updatedMap = new Map<string, number>()
-
-    try {
-      // 1) 获取所有文件的首次提交时间（--diff-filter=A 只看 add 事件）
-      //    --reverse 让最早的 commit 排在前面，同文件多次出现时后面覆盖前面
-      //    但我们取首次出现（最早），所以不用 --reverse，直接取最后出现的即可
-      const createdRaw = execSync(
-        `git log --name-only --format="---COMMIT---%ct" --diff-filter=A -- "notes/*/README.md"`,
-        {
-          cwd: ROOT_DIR_PATH,
-          encoding: 'utf-8',
-          maxBuffer: 100 * 1024 * 1024,
-          stdio: ['pipe', 'pipe', 'ignore'],
-        },
-      )
-
-      let currentTimestamp = 0
-      for (const line of createdRaw.split(/\r?\n/)) {
-        if (line.startsWith('---COMMIT---')) {
-          currentTimestamp = parseInt(line.slice(12)) * 1000
-        } else if (line.trim() && currentTimestamp) {
-          // git log 从新到旧，后出现的是更早的 commit，持续覆盖即可
-          // 最终 map 中保留的就是最早（首次）提交时间
-          createdMap.set(line.trim(), currentTimestamp)
-        }
-      }
-
-      // 2) 获取所有文件的最后修改时间
-      //    git log 从新到旧，只取首次出现（最新 commit）
-      const updatedRaw = execSync(
-        `git log --name-only --format="---COMMIT---%ct" -- "notes/*/README.md"`,
-        {
-          cwd: ROOT_DIR_PATH,
-          encoding: 'utf-8',
-          maxBuffer: 100 * 1024 * 1024,
-          stdio: ['pipe', 'pipe', 'ignore'],
-        },
-      )
-
-      currentTimestamp = 0
-      for (const line of updatedRaw.split(/\r?\n/)) {
-        if (line.startsWith('---COMMIT---')) {
-          currentTimestamp = parseInt(line.slice(12)) * 1000
-        } else if (line.trim() && currentTimestamp) {
-          // 只取第一次出现（最新的 commit 时间）
-          if (!updatedMap.has(line.trim())) {
-            updatedMap.set(line.trim(), currentTimestamp)
-          }
-        }
-      }
-    } catch (error) {
-      logger.error('批量获取 git 时间戳失败', error)
-    }
-
-    // 合并为统一的 map
-    const result = new Map<string, { created_at: number; updated_at: number }>()
-    for (const [file, created_at] of createdMap) {
-      const updated_at = updatedMap.get(file) ?? created_at
-      result.set(file, { created_at, updated_at })
-    }
-    // 补充只在 updatedMap 中出现的文件（理论上不会，但防御性编程）
-    for (const [file, updated_at] of updatedMap) {
-      if (!result.has(file)) {
-        result.set(file, { created_at: updated_at, updated_at })
-      }
-    }
-
-    return result
-  }
-
-  /**
-   * 从 git 获取文件的创建时间和最后修改时间
-   * @param noteDirPath - 笔记目录路径
-   * @returns 时间戳对象，包含 created_at 和 updated_at
-   */
-  private getGitTimestamps(noteDirPath: string): {
-    created_at: number
-    updated_at: number
-  } | null {
-    try {
-      const readmePath = join(noteDirPath, 'README.md')
-
-      // 获取 README.md 的首次提交时间（创建时间）- 兼容 Windows，不依赖 tail/head
-      const createdAtOutput = execSync(
-        `git log --diff-filter=A --follow --format=%ct -- "${readmePath}"`,
-        {
-          cwd: ROOT_DIR_PATH,
-          encoding: 'utf-8',
-          stdio: ['pipe', 'pipe', 'ignore'],
-        },
-      )
-        .split(/\r?\n/)
-        .filter(Boolean)
-        .pop() // 取最后一条（最早的提交）
-
-      // 获取 README.md 的最后修改时间（只看 README.md，忽略 .tnotes.json）
-      const updatedAtOutput = execSync(
-        `git log -1 --format=%ct -- "${readmePath}"`,
-        {
-          cwd: ROOT_DIR_PATH,
-          encoding: 'utf-8',
-          stdio: ['pipe', 'pipe', 'ignore'],
-        },
-      ).trim()
-
-      if (!createdAtOutput || !updatedAtOutput) {
-        return null
-      }
-
-      return {
-        created_at: parseInt(createdAtOutput) * 1000, // 转换为毫秒
-        updated_at: parseInt(updatedAtOutput) * 1000,
-      }
-    } catch (error) {
-      // git 命令失败（可能是新文件未提交）；便于排查时输出调试信息
-      logger.debug?.(`getGitTimestamps failed: ${noteDirPath}`, error)
-      return null
-    }
-  }
-
-  /**
-   * 修复单个笔记的时间戳
-   * @param noteDir - 笔记目录名
-   * @param forceUpdate - 是否强制更新（忽略现有值）
-   * @param timestampMap - 预构建的时间戳映射（批量模式传入，避免逐个 git log）
-   * @returns 是否进行了修复
-   */
-  private fixNoteTimestamps(
-    noteDir: string,
-    forceUpdate: boolean = false,
-    timestampMap?: Map<string, { created_at: number; updated_at: number }>,
-  ): boolean {
-    const configPath = join(NOTES_DIR_PATH, noteDir, '.tnotes.json')
-
-    if (!existsSync(configPath)) {
-      return false
-    }
-
-    try {
-      // 读取配置
-      const configContent = readFileSync(configPath, 'utf-8')
-      const config: NoteConfig = JSON.parse(configContent)
-
-      // 获取 git 时间戳：优先从批量 map 查，fallback 到逐个 git log
-      const readmeRelPath = `notes/${noteDir}/README.md`
-      const timestamps = timestampMap
-        ? (timestampMap.get(readmeRelPath) ?? null)
-        : this.getGitTimestamps(join(NOTES_DIR_PATH, noteDir))
-
-      if (!timestamps) {
-        return false
-      }
-
-      let modified = false
-
-      // 修复 created_at（设置为首次提交时间）
-      if (
-        forceUpdate ||
-        !config.created_at ||
-        config.created_at !== timestamps.created_at
-      ) {
-        config.created_at = timestamps.created_at
-        modified = true
-      }
-
-      // 修复 updated_at
-      if (forceUpdate) {
-        // 强制更新：直接使用 git 时间戳
-        if (config.updated_at !== timestamps.updated_at) {
-          config.updated_at = timestamps.updated_at
-          modified = true
-        }
-      } else {
-        // 常规更新：只在 git 时间戳更新时更新，避免覆盖用户手动修改
-        if (!config.updated_at) {
-          // 如果没有 updated_at，初始化为 git 时间戳
-          config.updated_at = timestamps.updated_at
-          modified = true
-        } else if (timestamps.updated_at > config.updated_at) {
-          // 如果 git 显示有更新（README.md 被修改），才更新时间戳
-          config.updated_at = timestamps.updated_at
-          modified = true
-        }
-        // 如果 git 时间戳 <= config 时间戳，说明没有新的提交，保持原值
-      }
-
-      if (modified) {
-        // 保持字段顺序写回文件
-        this.noteManager.writeNoteConfig(configPath, config)
-        return true
-      }
-
-      return false
-    } catch (error) {
-      logger.error(`修复时间戳失败: ${noteDir}`, error)
-      return false
-    }
-  }
-
-  /**
-   * 修复根配置文件的时间戳
-   * @param forceUpdate - 是否强制更新
-   * @returns 是否进行了修复
-   */
-  private fixRootConfigTimestamps(forceUpdate: boolean = false): boolean {
-    try {
-      // 读取根配置文件
-      const configContent = readFileSync(ROOT_CONFIG_PATH, 'utf-8')
-      const config: TNotesConfig = JSON.parse(configContent)
-
-      // 获取首次提交时间（项目创建时间）
-      const createdAtOutput = execSync('git log --reverse --format=%ct', {
-        cwd: ROOT_DIR_PATH,
-        encoding: 'utf-8',
-        stdio: ['pipe', 'pipe', 'ignore'],
-      }).trim()
-
-      // 获取最后提交时间（项目最后更新时间）
-      const updatedAtOutput = execSync('git log -1 --format=%ct', {
-        cwd: ROOT_DIR_PATH,
-        encoding: 'utf-8',
-        stdio: ['pipe', 'pipe', 'ignore'],
-      }).trim()
-
-      if (!createdAtOutput || !updatedAtOutput) {
-        return false
-      }
-
-      const firstTimestamp = createdAtOutput.split('\n')[0]
-      const createdAt = parseInt(firstTimestamp) * 1000
-      const updatedAt = parseInt(updatedAtOutput) * 1000
-
-      let modified = false
-
-      // 修复 created_at
-      if (
-        forceUpdate ||
-        !config.root_item.created_at ||
-        config.root_item.created_at !== createdAt
-      ) {
-        config.root_item.created_at = createdAt
-        modified = true
-      }
-
-      // 修复 updated_at
-      if (
-        forceUpdate ||
-        !config.root_item.updated_at ||
-        config.root_item.updated_at !== updatedAt
-      ) {
-        config.root_item.updated_at = updatedAt
-        modified = true
-      }
-
-      // 重新计算天数（从 1999-06-29 作为第 1 天开始计算）
-      if (modified) {
-        // 计算从出生日期到当前更新时间的天数
-        // 公式：Math.floor((updatedAt - BIRTH_DATE) / (1000 * 60 * 60 * 24)) + 1
-        // +1 是因为 1999-06-29 作为第 1 天
-        const daysSinceBirth =
-          Math.floor((updatedAt - BIRTH_DATE) / (1000 * 60 * 60 * 24)) + 1
-        config.root_item.days_since_birth = daysSinceBirth
-
-        // 写回配置文件
-        writeFileSync(
-          ROOT_CONFIG_PATH,
-          JSON.stringify(config, null, 2) + '\n',
-          'utf-8',
-        )
-        return true
-      }
-
-      return false
-    } catch (error) {
-      logger.error('修复根配置文件时间戳失败', error)
-      return false
-    }
-  }
-
-  /**
-   * 修复所有笔记的时间戳
-   * @param forceUpdate - 是否强制更新（忽略现有值，用于修复历史错误数据）
-   * @returns 修复统计信息
-   */
-  async fixAllTimestamps(forceUpdate: boolean = false): Promise<{
-    fixed: number
-    skipped: number
-    total: number
-    rootConfigFixed: boolean
-  }> {
-    if (forceUpdate) {
-      logger.info('正在强制修复笔记时间戳（使用 git 真实时间）...')
-    } else {
-      logger.info('正在修复笔记时间戳...')
-    }
-
-    // 1. 修复根配置文件的时间戳
-    const rootConfigFixed = this.fixRootConfigTimestamps(forceUpdate)
-    if (rootConfigFixed) {
-      logger.success('✅ 根配置文件时间戳已修复')
-    }
-
-    // 2. 批量获取所有笔记的 git 时间戳（只执行 2 次 git log）
-    const timestampMap = this.buildGitTimestampMap()
-    logger.info(`已从 git 历史中提取 ${timestampMap.size} 个文件的时间戳信息`)
-
-    // 3. 修复所有笔记的时间戳
-    if (!existsSync(NOTES_DIR_PATH)) {
-      logger.error('notes 目录不存在')
-      return { fixed: 0, skipped: 0, total: 0, rootConfigFixed }
-    }
-
-    const noteDirs = readdirSync(NOTES_DIR_PATH)
-      .filter((name) => {
-        const fullPath = join(NOTES_DIR_PATH, name)
-        return statSync(fullPath).isDirectory() && /^\d{4}\./.test(name)
-      })
-      .sort()
-
-    let fixedCount = 0
-    let skippedCount = 0
-
-    for (const noteDir of noteDirs) {
-      const fixed = this.fixNoteTimestamps(noteDir, forceUpdate, timestampMap)
-      if (fixed) {
-        fixedCount++
-      } else {
-        skippedCount++
-      }
-    }
-
-    if (fixedCount > 0) {
-      logger.success(`时间戳修复完成: ${fixedCount} 个笔记已更新`)
-    } else {
-      logger.info('所有笔记时间戳均已正确')
-    }
-
-    return {
-      fixed: fixedCount,
-      skipped: skippedCount,
-      total: noteDirs.length,
-      rootConfigFixed,
-    }
-  }
-
-  /**
-   * 更新指定笔记的时间戳为当前时间
-   * @param noteDirNames - 笔记目录名数组
-   * @returns 更新的笔记数量
-   */
-  async updateNotesTimestamp(noteDirNames: string[]): Promise<number> {
-    if (noteDirNames.length === 0) {
-      return 0
-    }
-
-    const now = Date.now()
-    let updatedCount = 0
-
-    for (const noteDir of noteDirNames) {
-      const configPath = join(NOTES_DIR_PATH, noteDir, '.tnotes.json')
-
-      if (!existsSync(configPath)) {
-        continue
-      }
-
-      try {
-        // 读取配置
-        const configContent = readFileSync(configPath, 'utf-8')
-        const config: NoteConfig = JSON.parse(configContent)
-
-        // 更新 updated_at 为当前时间
-        config.updated_at = now
-
-        // 保持字段顺序写回文件
-        this.noteManager.writeNoteConfig(configPath, config)
-        updatedCount++
-      } catch (error) {
-        logger.error(`更新时间戳失败: ${noteDir}`, error)
-      }
-    }
-
-    return updatedCount
-  }
-
-  /**
-   * 获取本次变更中包含 README.md 的笔记列表
-   * @param changedFiles - git status 返回的变更文件列表
-   * @returns 变更的笔记目录名数组
-   */
-  getChangedNotes(changedFiles: string[]): string[] {
-    const changedNotes = new Set<string>()
-
-    for (let file of changedFiles) {
-      // 移除 git 添加的引号（git 对包含特殊字符的路径会加引号）
-      // 支持两种格式：
-      // 1. "notes/xxx/README.md" (完整包裹)
-      // 2. notes/xxx/README.md" (只有末尾引号)
-      file = file.replace(/^"(.*)"$/, '$1').replace(/"$/, '')
-
-      // 检查是否是 notes 目录下的 README.md 文件
-      const match = file.match(/^notes\/([^/]+)\/README\.md$/)
-      if (match) {
-        changedNotes.add(match[1])
-      }
-    }
-
-    return Array.from(changedNotes)
-  }
-}