aethel 0.3.8 → 0.4.0

package/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Changelog
 
+## 0.4.0 (2026-04-06)
+
+- Add pull --all for full remote download
+
 ## 0.3.8 (2026-04-06)
 
 - Fix Drive upload checksum test stub

package/README.md

@@ -78,6 +78,7 @@ aethel add --all               # stage default suggested actions
 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
 ```
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aethel",
-  "version": "0.3.8",
+  "version": "0.4.0",
   "description": "Git-style Google Drive sync CLI with interactive TUI",
   "type": "module",
   "license": "MIT",

package/src/cli.js

@@ -513,6 +513,37 @@ async function handlePull(paths, options) {
   const repo = await openRepo(options);
   const { diff, remoteState } = await loadStateWithProgress(repo, { useCache: false });
 
+  if (options.all) {
+    let remoteFiles = remoteState.files;
+
+    if (paths && paths.length > 0) {
+      remoteFiles = remoteFiles.filter((file) =>
+        paths.some((p) => matchesPattern(file.path, p))
+      );
+    }
+
+    if (!remoteFiles.length) {
+      console.log("No remote files matched.");
+      return;
+    }
+
+    if (options.dryRun) {
+      console.log(`Would pull ${remoteFiles.length} remote item(s):`);
+      for (const file of remoteFiles) {
+        console.log(`  +R ${file.path}  (full remote download)`);
+      }
+      return;
+    }
+
+    const count = repo.stageRemoteFilesForDownload(remoteFiles);
+    console.log(`Staged ${count} remote item(s). Committing...`);
+    await handleCommit({ ...options, message: options.message || "pull" }, {
+      repo,
+      snapshotHint: { remote: remoteState },
+    });
+    return;
+  }
+
   let remoteChanges = diff.changes.filter((change) =>
     [
       ChangeType.REMOTE_ADDED,
@@ -1100,6 +1131,7 @@ async function main() {
       .command("pull")
       .description("Download remote changes")
       .argument("[paths...]", "Specific paths to pull (default: all)")
+      .option("--all", "Download all remote files regardless of snapshot state")
       .option("-m, --message <message>", "Commit message")
       .option("--force", "Force-pull conflicts (remote wins)")
       .option("--dry-run", "Preview changes without applying")

package/src/core/repository.js

@@ -47,6 +47,7 @@ import {
   stageChange,
   stageChanges,
   stageConflictResolution,
+  stageRemoteFilesForDownload,
   stagedEntries,
   unstageAll,
   unstagePath,
@@ -190,6 +191,10 @@ export class Repository {
     return stageChanges(this._root, changes);
   }
 
+  stageRemoteFilesForDownload(remoteFiles) {
+    return stageRemoteFilesForDownload(this._root, remoteFiles);
+  }
+
   unstagePath(targetPath) {
     return unstagePath(this._root, targetPath);
   }

package/src/core/staging.js

@@ -50,6 +50,26 @@ export function stageChanges(root, changes) {
   return changes.length;
 }
 
+export function stageRemoteFilesForDownload(root, remoteFiles) {
+  const index = readIndex(root);
+  const byPath = new Map((index.staged || []).map((entry) => [entry.path, entry]));
+
+  for (const remoteFile of remoteFiles) {
+    byPath.set(remoteFile.path, {
+      action: "download",
+      path: remoteFile.path,
+      localPath: remoteFile.path,
+      fileId: remoteFile.id,
+      remotePath: remoteFile.path,
+      ...(remoteFile.isFolder ? { isFolder: true } : {}),
+    });
+  }
+
+  index.staged = [...byPath.values()];
+  writeIndex(root, index);
+  return remoteFiles.length;
+}
+
 export function unstagePath(root, targetPath) {
   const index = readIndex(root);
   const staged = index.staged || [];