@aigne/doc-smith 0.9.8-alpha.3 → 0.9.8-alpha.5

package/utils/history-utils.mjs

@@ -1,203 +0,0 @@
-import { execSync } from "node:child_process";
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
-import { join } from "node:path";
-import { parse, stringify } from "yaml";
-import { DOC_SMITH_DIR } from "./constants/index.mjs";
-import { isInGitRepository } from "./file-utils.mjs";
-
-const HISTORY_FILE = "history.yaml";
-
-/**
- * Checks if Git is available in the system.
- */
-export function isGitAvailable() {
-  try {
-    execSync("git --version", { stdio: "ignore" });
-    return true;
-  } catch {
-    return false;
-  }
-}
-
-/**
- * Initializes a Git repository in the DOC_SMITH_DIR if it doesn't already exist.
- */
-export function ensureGitRepo() {
-  if (!isGitAvailable()) return false;
-
-  const gitDir = join(process.cwd(), DOC_SMITH_DIR, ".git");
-
-  if (!existsSync(gitDir)) {
-    try {
-      const cwd = join(process.cwd(), DOC_SMITH_DIR);
-
-      execSync("git init", { cwd, stdio: "ignore" });
-
-      // Create .gitignore to exclude temporary files
-      const gitignore = "*.tmp\n.local/\n";
-      writeFileSync(join(cwd, ".gitignore"), gitignore);
-
-      // Initial commit
-      execSync('git add .gitignore && git commit -m "Initialize doc-smith history"', {
-        cwd,
-        stdio: "ignore",
-      });
-
-      console.log("✔ Git history tracking has been initialized.");
-      return true;
-    } catch (error) {
-      console.warn("Could not initialize the Git history:", error.message);
-      return false;
-    }
-  }
-
-  return true;
-}
-
-/**
- * Record update using git commit (if available)
- */
-function recordUpdateGit({ feedback }) {
-  try {
-    const cwd = join(process.cwd(), DOC_SMITH_DIR);
-
-    // Stage changed files (only if they exist)
-    const filesToAdd = ["docs/", "config.yaml", "preferences.yml", "history.yaml"]
-      .filter((file) => existsSync(join(cwd, file)))
-      .join(" ");
-
-    if (filesToAdd) {
-      execSync(`git add ${filesToAdd}`, {
-        cwd,
-        stdio: "ignore",
-      });
-    }
-
-    // Check if there are changes to commit
-    try {
-      execSync("git diff --cached --quiet", { cwd, stdio: "ignore" });
-      console.log("✔ No update history changes to commit.");
-      return;
-    } catch {
-      // There are changes, so we'll continue.
-    }
-
-    // Build commit message (only user feedback)
-    const message = feedback;
-
-    // Commit
-    execSync(`git commit -m ${JSON.stringify(message)}`, {
-      cwd,
-      stdio: "ignore",
-    });
-    console.log("✔ The update history has been committed successfully.");
-  } catch (error) {
-    console.warn("The update history commit failed:", error.message);
-  }
-}
-
-/**
- * Records an update in the YAML file.
- */
-function recordUpdateYaml({ operation, feedback, docPaths = null }) {
-  try {
-    const docSmithDir = join(process.cwd(), DOC_SMITH_DIR);
-    if (!existsSync(docSmithDir)) {
-      mkdirSync(docSmithDir, { recursive: true });
-    }
-    const historyPath = join(docSmithDir, HISTORY_FILE);
-
-    // Read existing history
-    let history = { entries: [] };
-    if (existsSync(historyPath)) {
-      try {
-        const content = readFileSync(historyPath, "utf8");
-        history = parse(content) || { entries: [] };
-      } catch (error) {
-        console.warn("Could not read the history file:", error.message);
-      }
-    }
-
-    // Create new entry
-    const entry = {
-      timestamp: new Date().toISOString(),
-      operation,
-      feedback,
-    };
-
-    // Add document paths if provided
-    if (Array.isArray(docPaths) && docPaths.length > 0) {
-      entry.docPaths = docPaths;
-    }
-
-    // Add to beginning (newest first)
-    history.entries = history.entries || [];
-    history.entries.unshift(entry);
-
-    // Write back
-    const yamlContent = stringify(history, {
-      indent: 2,
-      lineWidth: 100,
-    });
-
-    writeFileSync(historyPath, yamlContent, "utf8");
-  } catch (error) {
-    console.warn("The YAML history tracking failed:", error.message);
-  }
-}
-
-/**
- * Records an update after user feedback.
- * - Always writes to YAML.
- * - Also commits to Git if available.
- * @param {Object} params
- * @param {string} params.operation - The type of operation (e.g., 'document_update', 'structure_update', 'translation_update').
- * @param {string} params.feedback - The user's feedback text.
- * @param {string[]} [params.docPaths] - Document path list for updates.
- */
-export function recordUpdate({ operation, feedback, docPaths = null }) {
-  // Skip if no feedback
-  if (!feedback?.trim()) return;
-
-  // Always record in YAML
-  recordUpdateYaml({ operation, feedback, docPaths });
-
-  // Also record in git if git is available and not in a git repository
-  if (isGitAvailable() && !isInGitRepository(process.cwd())) {
-    ensureGitRepo();
-    recordUpdateGit({ feedback });
-  } else {
-    console.warn("Git is not available, so I am skipping the Git-based update history.");
-  }
-}
-
-/**
- * Gets the history entries from YAML.
- */
-export function getHistory() {
-  const historyPath = join(process.cwd(), DOC_SMITH_DIR, HISTORY_FILE);
-
-  if (!existsSync(historyPath)) {
-    return { entries: [] };
-  }
-
-  try {
-    const content = readFileSync(historyPath, "utf8");
-    const parsed = parse(content) || { entries: [] };
-    const entries = Array.isArray(parsed.entries) ? parsed.entries : [];
-
-    const normalized = entries.map((entry) => {
-      if (!entry) return entry;
-      // Normalize legacy entries: documentPath -> docPaths: [documentPath]
-      if (!entry.docPaths && entry.documentPath) {
-        return { ...entry, docPaths: [entry.documentPath] };
-      }
-      return entry;
-    });
-
-    return { ...parsed, entries: normalized };
-  } catch (error) {
-    console.warn("Could not read the history:", error.message);
-    return { entries: [] };
-  }
-}