@nueldotdev/amnesiac 1.0.1 → 1.0.2

package/CHANGELOG.md

@@ -1,5 +1,20 @@
-## 2025-10-03 — v1.0.1
-
-- Default model updated: Now uses `gemini-2.5-flash` by default to align with the latest Gemini API.
-
-
+## 2026-01-21 — v1.0.2
+
+### Added
+
+*   **Changelog Preview & Edit:** Introduced a new `--dry-run` option allowing users to preview and edit generated changelog entries before saving them.
+*   **Changelog Save Recovery:** Implemented a recovery mechanism to persist generated changelog content locally if saving fails.
+*   **Git Status & Diff Command:** Added a new `show-git` command with `--status` and `--diff` options to display the current Git repository status or changes directly from the CLI.
+*   **New Dependencies:** Added `open` and `update-notifier` for future enhancements and version notifications.
+
+### Changed
+
+*   **Refactored Changelog Generation:** The `generateDocs` function now returns the generated changelog entry instead of directly writing it to a file, providing more control over the saving process.
+*   **Improved Configuration Loading:** Enhanced `loadConfig` to better manage active profiles and ensure CLI options correctly override existing configurations.
+*   **Git Status JSDoc:** Added detailed JSDoc comments to the `getStatus` function in `lib/git.js` for improved code clarity.
+
+## 2025-10-03 — v1.0.1
+
+- Default model updated: Now uses `gemini-2.5-flash` by default to align with the latest Gemini API.
+
+

package/README.md

@@ -80,6 +80,29 @@ npm update -g @nueldotdev/amnesiac
     - Receive a concise changelog entry.
     - Prepend the new entry to your `CHANGELOG.md` file (or the file specified in your config).
 
+### Preview/edit workflow (recommended)
+
+If you want to review and tweak the generated entry before it is written to your changelog, use `--dry-run`:
+
+```bash
+amnesiac --dry-run
+```
+
+This flow will:
+
+- Open a temporary `.md` file containing the generated entry in your default editor
+- Let you edit it
+- Ask you to confirm before saving it to your changelog
+
+**Important (Windows/editor note):** some editors don't allow the CLI to reliably detect when the file is closed. After you edit the temp file, **save it in your editor (Ctrl+S)**, then return to the terminal and press Enter when prompted.
+
+### Safety: backups and recovery
+
+When saving to your changelog file, Amnesiac writes safely:
+
+- If a changelog file already exists, it may create a best-effort backup alongside it (e.g. `CHANGELOG.md.bak.<timestamp>`).
+- If saving fails (permissions/locked file/etc.), Amnesiac will write a **recovery copy** to your OS temp directory and print the path so you don't lose the generated/edited entry.
+
 ## Configuration & Profiles
 
 Amnesiac offers a flexible configuration system that allows you to manage settings at different levels: per-project, globally, or as a one-off CLI override.
@@ -124,6 +147,18 @@ amnesiac
 amnesiac -p "Custom prompt for this run" # Override prompt for a single run
 amnesiac -m "gemini-2.5-flash" # Override model for a single run
 amnesiac -u work # Use 'work' profile for a single run
+amnesiac -d # Preview/edit in your editor before saving
+```
+
+### `amnesiac show-git`
+
+Display the current Git status or diff for the repository you are currently in.
+
+**Usage:**
+
+```bash
+amnesiac show-git --status
+amnesiac show-git --diff
 ```
 
 ### `amnesiac init`

package/bin/cli.js

@@ -6,6 +6,7 @@ import os from "os";
 import inquirer from "inquirer";
 import { generateDocs } from "../lib/doc_generator.js";
 import { loadConfig } from "../lib/config.js";
+import { previewAndEditChangelog, saveChangelogEntry, persistRecoveryCopy } from "../lib/display.js";
 import { readFileSync } from 'fs';
 
 const program = new Command();
@@ -113,6 +114,41 @@ program
     }
   });
 
+
+program
+  .command("show-git")
+  .option("-s, --status", "Display the status of the files within the repository")
+  .option("-d, --diff", "Display the changes within the files of the repository")
+  .description("Display the current status or changes in your Git repository")
+  .action(async (options) => {
+    // Only allow one of --status or --diff at a time
+    if (options.status && options.diff) {
+      console.error("\n❌ You can only use one of --status or --diff at a time.\n");
+      process.exit(1);
+    }
+    if (!options.status && !options.diff) {
+      console.error("\n❌ Please specify either --status or --diff.\n");
+      process.exit(1);
+    }
+
+    try {
+      if (options.status) {
+        const { getStatus } = await import('../lib/git.js');
+        const statusStr = await getStatus();
+        console.log("\n--- Git Status ---\n" + statusStr + "\n");
+      } else if (options.diff) {
+        const { getDiff } = await import('../lib/git.js');
+        const { displayChanges } = await import('../lib/display.js');
+        const diffStr = await getDiff();
+        await displayChanges(diffStr);
+      }
+    } catch (error) {
+      console.error(`\n❌ An error occurred while displaying git info: ${error.message}`);
+      process.exit(1);
+    }
+  });
+
+
 program
   .command("config")
   .description("Set up or edit Amnesiac config")
@@ -258,19 +294,62 @@ program
     }
   });
 
-program
+  program
+  .option("-d, --dry-run", "Preview and edit before saving")
   .option("-u, --use <profile>", "Use a specific profile for this run")
   .option("-p, --prompt <text>", "Override prompt")
   .option("-m, --model <name>", "Override model")
-  // Future: .option("-u, --use <profile>", "Use specific profile")
   .action(async (opts) => {
     try {
       const config = await loadConfig(opts);
-      await generateDocs(config);
+      const changelogEntry = await generateDocs(config);
+      
+      if (!changelogEntry) {
+        return; // No changes detected
+      }
+
+      if (opts.dryRun) {
+        // Preview and let user edit/confirm
+        console.log("\n🔄 Previewing changelog entry. \nYou can review and edit before saving");
+        const { content, shouldSave, wasModified } = await previewAndEditChangelog(changelogEntry);
+
+        if (shouldSave) {
+          let savedPath;
+          try {
+            savedPath = saveChangelogEntry(config, content);
+          } catch (e) {
+            const recoveryPath = persistRecoveryCopy(content, "save_failed");
+            console.error(`\n❌ Failed to save changelog: ${e.message}`);
+            console.error(`✅ Your generated entry was saved for recovery at: ${recoveryPath}\n`);
+            process.exit(1);
+          }
+
+          if (wasModified) {
+            console.log(`✅ Your edited changelog has been saved to ${savedPath}`);
+          } else {
+            console.log(`✅ Changelog updated at ${savedPath}`);
+          }
+        } else {
+          console.log("❌ Changelog not saved.");
+        }
+      } else {
+        // No preview, just save
+        console.log("🔄 Saving changelog entry...");
+        let savedPath;
+        try {
+          savedPath = saveChangelogEntry(config, changelogEntry);
+        } catch (e) {
+          const recoveryPath = persistRecoveryCopy(changelogEntry, "save_failed");
+          console.error(`\n❌ Failed to save changelog: ${e.message}`);
+          console.error(`✅ Your generated entry was saved for recovery at: ${recoveryPath}\n`);
+          process.exit(1);
+        }
+        console.log(`✅ Changelog updated at ${savedPath}`);
+      }
     } catch (error) {
       console.error(`\n❌ An error occurred: ${error.message}`);
       process.exit(1);
     }
   });
 
-program.parse(process.argv);
+program.parse(process.argv);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nueldotdev/amnesiac",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "description": "A command-line tool to automatically generate documentation for recent codebase changes using the Gemini API.",
   "keywords": [
     "cli-tool",
@@ -34,6 +34,8 @@
     "@google/generative-ai": "^0.24.1",
     "commander": "^14.0.1",
     "inquirer": "^12.9.6",
-    "simple-git": "^3.28.0"
+    "open": "^11.0.0",
+    "simple-git": "^3.28.0",
+    "update-notifier": "^7.3.1"
   }
 }