aethel 1.2.0 → 1.2.1

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## 1.2.1 (2026-04-26)
+
+- Document the `verify` integrity-check command in the README help guide.
+- Add `verify` to the TUI command catalog with local and remote verification actions.
+- Fix legacy local-delete staging so remote deletions can resolve Drive file IDs from the latest snapshot.
+- Add a debug installer command that symlinks the working-copy CLI as `debug_aethel`.
+
 ## 1.2.0 (2026-04-15)
 
 - Add Packing modules

package/README.md

@@ -23,6 +23,7 @@ git clone https://github.com/CCJ-0617/Aethel.git
 cd Aethel
 npm install
 npm run install:cli   # symlinks `aethel` into ~/.local/bin
+npm run install:debug # symlinks `debug_aethel` without replacing `aethel`
 ```
 
 </details>
@@ -85,6 +86,7 @@ aethel commit -m "sync"        # execute staged operations
 aethel pull -m "pull"          # fetch remote changes and apply
 aethel pull --all              # download the full remote tree to local
 aethel push -m "push"          # push local changes to Drive
+aethel verify                  # verify local files against the last snapshot
 ```
 
 `pull` applies remote changes relative to the latest snapshot. Use `pull --all` for the first full download or to rehydrate a local workspace from the current remote tree.
@@ -131,10 +133,20 @@ Processes deepest-first for single-pass convergence, caches child state to minim
 | `restore`        | Restore files from the last snapshot                                |
 | `rm`             | Remove local files and stage remote deletion                        |
 | `mv`             | Move or rename local files                                          |
+| `verify`         | Verify local and optional remote integrity against the last snapshot |
 | `clean`          | List and optionally trash/delete Drive files                        |
 | `dedupe-folders` | Detect and merge duplicate remote folders                           |
 | `tui`            | Launch interactive terminal UI                                      |
 
+### Integrity Verification
+
+```bash
+aethel verify          # check snapshot checksum and local file hashes
+aethel verify --remote # also compare Drive file hashes
+```
+
+`verify` compares the latest snapshot with the workspace on disk and exits non-zero when files are missing or modified. Add `--remote` when you also want to verify Drive state before a release, migration, or restore.
+
 ## TUI
 
 ```bash

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aethel",
-  "version": "1.2.0",
+  "version": "1.2.1",
   "description": "Git-style Google Drive sync CLI with interactive TUI",
   "type": "module",
   "license": "MIT",
@@ -48,6 +48,7 @@
     "auth": "node src/cli.js auth",
     "clean": "node src/cli.js clean",
     "install:cli": "bash scripts/install.sh",
+    "install:debug": "bash scripts/install-debug.sh",
     "release": "bash scripts/release.sh",
     "pack:check": "npm pack --dry-run",
     "prepublishOnly": "npm test && npm run pack:check",

package/src/core/diff.js

@@ -306,6 +306,20 @@ function collectFolderPaths(filePaths) {
   return folders;
 }
 
+function indexSnapshotFilesByPath(snapshotFiles) {
+  const byPath = new Map();
+
+  for (const [fileId, entry] of Object.entries(snapshotFiles || {})) {
+    for (const pathValue of [entry.path, entry.localPath]) {
+      if (pathValue && !byPath.has(pathValue)) {
+        byPath.set(pathValue, { fileId, entry });
+      }
+    }
+  }
+
+  return byPath;
+}
+
 export function computeDiff(snapshot, remoteFiles, localFiles, { root, respectIgnore = true } = {}) {
   const ignoreRules = root && respectIgnore ? loadIgnoreRules(root) : null;
 
@@ -321,6 +335,7 @@ export function computeDiff(snapshot, remoteFiles, localFiles, { root, respectIg
   const changes = [];
   const snapshotFiles = snapshot?.files || {};
   const snapshotLocalFiles = snapshot?.localFiles || {};
+  const snapshotRemoteByPath = indexSnapshotFilesByPath(snapshotFiles);
 
   // Build sets of all folder paths that implicitly exist on each side
   // (from parent directories of files), so we can skip redundant folder additions.
@@ -409,10 +424,12 @@ export function computeDiff(snapshot, remoteFiles, localFiles, { root, respectIg
     }
 
     if (localChanged(snapshotEntry, localMeta)) {
+      const remoteEntry = snapshotRemoteByPath.get(relativePath);
       changes.push(
         createChange({
           changeType: ChangeType.LOCAL_MODIFIED,
           path: relativePath,
+          fileId: remoteEntry?.fileId || null,
           localMeta,
           snapshotMeta: snapshotEntry,
         })
@@ -426,10 +443,12 @@ export function computeDiff(snapshot, remoteFiles, localFiles, { root, respectIg
       if (snapshotEntry.isFolder && localFolderPaths.has(relativePath)) {
         continue;
       }
+      const remoteEntry = snapshotRemoteByPath.get(relativePath);
       changes.push(
         createChange({
           changeType: ChangeType.LOCAL_DELETED,
           path: relativePath,
+          fileId: remoteEntry?.fileId || null,
           snapshotMeta: snapshotEntry,
         })
       );

package/src/core/sync.js

@@ -1,6 +1,6 @@
 import fs from "node:fs";
 import path from "node:path";
-import { readConfig, readIndex, writeIndex } from "./config.js";
+import { readConfig, readIndex, readLatestSnapshot, writeIndex } from "./config.js";
 import { downloadFile, ensureFolder, trashFile, uploadFile } from "./drive-api.js";
 import { md5Local } from "./snapshot.js";
 
@@ -157,12 +157,31 @@ async function deleteLocalFile(entry, root) {
   }
 }
 
-async function deleteRemoteFile(drive, entry) {
-  if (!entry.fileId) {
+function findSnapshotFileIdByPath(snapshot, entry) {
+  const targetPaths = new Set(
+    [entry.remotePath, entry.path, entry.localPath].filter(Boolean)
+  );
+
+  for (const [fileId, snapshotEntry] of Object.entries(snapshot?.files || {})) {
+    if (
+      targetPaths.has(snapshotEntry.path) ||
+      targetPaths.has(snapshotEntry.localPath)
+    ) {
+      return fileId;
+    }
+  }
+
+  return null;
+}
+
+async function deleteRemoteFile(drive, entry, snapshot) {
+  const fileId = entry.fileId || findSnapshotFileIdByPath(snapshot, entry);
+
+  if (!fileId) {
     throw new Error("No fileId was found for delete_remote.");
   }
 
-  await trashFile(drive, entry.fileId);
+  await trashFile(drive, fileId);
 }
 
 // ── Bounded-concurrency runner ───────────────────────────────────────
@@ -205,6 +224,7 @@ export async function executeStaged(drive, root, progress) {
   const config = readConfig(root);
   const index = readIndex(root);
   const staged = index.staged || [];
+  const snapshot = readLatestSnapshot(root);
   const driveFolderId = config.drive_folder_id || null;
   const result = new CommitResult();
 
@@ -248,7 +268,7 @@ export async function executeStaged(drive, root, progress) {
         if (entry.isFolder) result.foldersCreated++;
         else result.uploaded++;
       } else if (action === "delete_remote") {
-        await deleteRemoteFile(drive, entry);
+        await deleteRemoteFile(drive, entry, snapshot);
         result.deletedRemote++;
       } else {
         throw new Error(`Unknown action '${action}'`);

package/src/tui/command-catalog.js

@@ -137,4 +137,13 @@ export const COMMAND_CATALOG = [
     template: "mv old/path new/path",
     actions: [],
   },
+  {
+    name: "verify",
+    description: "Verify file integrity against the last snapshot",
+    template: "verify",
+    actions: [
+      { label: "Local Snapshot", command: "verify" },
+      { label: "Local and Remote", command: "verify --remote" },
+    ],
+  },
 ];