aethel 0.3.0 → 0.3.2

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 0.3.2 (2026-04-05)
+
+- Add --version flag, interactive init folder selection, and release script
+
+## 0.3.1 (2026-04-05)
+
+- Improve setup SOP: default credentials to ~/.config/aethel/ with guided error message
+
 ## 0.3.0 (2026-04-05)
 
 - Refactor to Repository pattern; add TUI command system with catalog, CLI runner, and tests

package/README.md

@@ -33,14 +33,38 @@ npm run install:cli   # symlinks `aethel` into ~/.local/bin
 
 ## Setup
 
-1. Create a project in the [Google Cloud Console](https://console.cloud.google.com/)
-2. Enable the **Google Drive API**
-3. Create an **OAuth 2.0 Client ID** (Desktop application)
-4. Download the credentials JSON and save it as `credentials.json` in your project root
+### 1. Get Google OAuth Credentials
+
+1. Go to [Google Cloud Console](https://console.cloud.google.com/)
+2. Create a project (or select an existing one)
+3. Enable the **Google Drive API** (APIs & Services → Library)
+4. Go to **APIs & Services → Credentials**
+5. Click **Create Credentials → OAuth 2.0 Client ID**
+6. Application type: **Desktop application**
+7. Download the JSON file
+
+### 2. Save Credentials
+
+Save the downloaded JSON as `~/.config/aethel/credentials.json`:
+
+```bash
+mkdir -p ~/.config/aethel
+mv ~/Downloads/client_secret_*.json ~/.config/aethel/credentials.json
+```
+
+You can also place `credentials.json` in the current directory, or pass a custom path with `--credentials`.
+
+### 3. Authenticate
 
 ```bash
 aethel auth                    # opens browser, saves token.json
-aethel init --local-path ./workspace --drive-folder <folder-id>
+```
+
+### 4. Initialize a Workspace
+
+```bash
+aethel init --local-path ./my-drive     # sync entire My Drive
+aethel init --local-path ./workspace --drive-folder <folder-id>  # sync specific folder
 ```
 
 > `credentials.json` and `token.json` are local secrets — never commit them.
@@ -143,8 +167,8 @@ build/
 
 | Variable | Default | Description |
 |----------|---------|-------------|
-| `GOOGLE_DRIVE_CREDENTIALS_PATH` | `credentials.json` | Path to OAuth credentials |
-| `GOOGLE_DRIVE_TOKEN_PATH` | `token.json` | Path to cached OAuth token |
+| `GOOGLE_DRIVE_CREDENTIALS_PATH` | `~/.config/aethel/credentials.json` | Path to OAuth credentials |
+| `GOOGLE_DRIVE_TOKEN_PATH` | `~/.config/aethel/token.json` | Path to cached OAuth token |
 | `AETHEL_DRIVE_CONCURRENCY` | `40` | Max concurrent Drive API requests |
 
 ## Architecture

package/package.json

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

package/src/cli.js

@@ -1,8 +1,25 @@
 #!/usr/bin/env node
 
+import { execSync } from "node:child_process";
 import fs from "node:fs";
 import path from "node:path";
+import readline from "node:readline/promises";
+import { fileURLToPath } from "node:url";
 import { Command } from "commander";
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const pkg = JSON.parse(fs.readFileSync(path.join(__dirname, "..", "package.json"), "utf-8"));
+
+function getGitHash() {
+  try {
+    return execSync("git rev-parse --short HEAD", { cwd: __dirname, stdio: ["ignore", "pipe", "ignore"] }).toString().trim();
+  } catch {
+    return null;
+  }
+}
+
+const gitHash = getGitHash();
+const versionString = gitHash ? `${pkg.version} (${gitHash})` : pkg.version;
 import { resolveCredentialsPath, resolveTokenPath } from "./core/auth.js";
 import {
   initWorkspace,
@@ -145,26 +162,59 @@ async function handleClean(options) {
 
 async function handleInit(options) {
   const localPath = path.resolve(options.localPath);
+  let driveFolderId = options.driveFolder || null;
+  let driveFolderName = options.driveFolderName || null;
+
+  // Interactive folder selection when no --drive-folder is provided
+  if (!driveFolderId) {
+    const repo = await openRepo(options, { requireWorkspace: false });
+    console.log("Fetching root-level Drive folders...");
+    const folders = await repo.listRootFolders();
+
+    if (folders.length === 0) {
+      console.log("No folders found in Drive root. Syncing entire My Drive.");
+      driveFolderName = "My Drive";
+    } else {
+      console.log("\nDrive folders:");
+      console.log("  0) My Drive (entire drive)");
+      for (const [i, folder] of folders.entries()) {
+        console.log(`  ${i + 1}) ${folder.name}`);
+      }
+
+      const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+      try {
+        const answer = await rl.question(`\nSelect a folder [0-${folders.length}]: `);
+        const index = Number.parseInt(answer, 10);
+
+        if (index === 0 || answer.trim() === "") {
+          driveFolderName = "My Drive";
+        } else if (index >= 1 && index <= folders.length) {
+          const selected = folders[index - 1];
+          driveFolderId = selected.id;
+          driveFolderName = selected.name;
+        } else {
+          console.log("Invalid selection. Aborting.");
+          return;
+        }
+      } finally {
+        rl.close();
+      }
+    }
+  }
 
   if (!fs.existsSync(localPath)) {
     await fs.promises.mkdir(localPath, { recursive: true });
   }
 
-  const root = initWorkspace(
-    localPath,
-    options.driveFolder || null,
-    options.driveFolderName || "My Drive"
-  );
+  const root = initWorkspace(localPath, driveFolderId, driveFolderName || "My Drive");
 
   const created = createDefaultIgnoreFile(root);
-  console.log(`Initialised Aethel workspace at ${root}`);
+  console.log(`\nInitialised Aethel workspace at ${root}`);
   if (created) {
     console.log("  Created .aethelignore with default patterns");
   }
-  if (options.driveFolder) {
-    console.log(
-      `  Drive folder: ${options.driveFolderName || "My Drive"} (${options.driveFolder})`
-    );
+  if (driveFolderId) {
+    console.log(`  Drive folder: ${driveFolderName} (${driveFolderId})`);
   } else {
     console.log("  Syncing entire My Drive");
   }
@@ -816,6 +866,7 @@ async function main() {
 
   program
     .name("aethel")
+    .version(versionString, "-v, --version")
     .description("Git-like Google Drive sync management and cleanup")
     .showHelpAfterError();
 
@@ -835,13 +886,14 @@ async function main() {
       .option("--confirm <phrase>", "Confirmation phrase required for --execute", "")
   ).action(handleClean);
 
-  program
-    .command("init")
-    .description("Initialise a sync workspace")
-    .option("--local-path <path>", "Local directory to sync", ".")
-    .option("--drive-folder <id>", "Drive folder ID to sync")
-    .option("--drive-folder-name <name>", "Display name for the Drive folder")
-    .action(handleInit);
+  addAuthOptions(
+    program
+      .command("init")
+      .description("Initialise a sync workspace")
+      .option("--local-path <path>", "Local directory to sync", ".")
+      .option("--drive-folder <id>", "Drive folder ID to sync (omit for interactive selection)")
+      .option("--drive-folder-name <name>", "Display name for the Drive folder")
+  ).action(handleInit);
 
   addAuthOptions(program.command("status").description("Show sync status")).action(
     handleStatus

package/src/core/auth.js

@@ -1,8 +1,8 @@
 import fs from "node:fs/promises";
 import fsSyncFallback from "node:fs";
 import http from "node:http";
+import os from "node:os";
 import path from "node:path";
-import { fileURLToPath } from "node:url";
 import { URL } from "node:url";
 import { google } from "googleapis";
 import open from "open";
@@ -10,8 +10,7 @@ import open from "open";
 const SCOPES = ["https://www.googleapis.com/auth/drive"];
 const DEFAULT_CREDENTIALS_PATH = "credentials.json";
 const DEFAULT_TOKEN_PATH = "token.json";
-const MODULE_DIR = path.dirname(fileURLToPath(import.meta.url));
-const PROJECT_ROOT = path.resolve(MODULE_DIR, "..", "..");
+const CONFIG_DIR = path.join(os.homedir(), ".config", "aethel");
 const AUTH_TIMEOUT_MS = 120_000;
 
 // ── Path resolution ─────────────────────────────────────────────────
@@ -22,7 +21,12 @@ function resolvePath(candidatePath, fallbackFileName) {
       ? candidatePath
       : path.resolve(process.cwd(), candidatePath);
   }
-  return path.join(PROJECT_ROOT, fallbackFileName);
+  // Also check cwd before falling back to ~/.config/aethel/
+  const cwdPath = path.resolve(process.cwd(), fallbackFileName);
+  if (fsSyncFallback.existsSync(cwdPath)) {
+    return cwdPath;
+  }
+  return path.join(CONFIG_DIR, fallbackFileName);
 }
 
 export function resolveCredentialsPath(customPath) {
@@ -47,7 +51,15 @@ async function loadClientConfig(credentialsPath) {
     raw = await fs.readFile(credentialsPath, "utf8");
   } catch {
     throw new Error(
-      `OAuth credentials file was not found. Expected path: ${credentialsPath}`
+      `OAuth credentials file not found: ${credentialsPath}\n\n` +
+      "Setup steps:\n" +
+      "  1. Go to https://console.cloud.google.com/\n" +
+      "  2. Create a project and enable the Google Drive API\n" +
+      "  3. Create an OAuth 2.0 Client ID (Desktop application)\n" +
+      "  4. Download the credentials JSON and save it as:\n" +
+      `     ${path.join(CONFIG_DIR, DEFAULT_CREDENTIALS_PATH)}\n\n` +
+      "Or pass a custom path:\n" +
+      "  aethel auth --credentials /path/to/credentials.json"
     );
   }
 

package/src/core/drive-api.js

@@ -685,6 +685,24 @@ export async function getAccountInfo(drive) {
   };
 }
 
+export async function listRootFolders(drive) {
+  const items = [];
+  let pageToken = null;
+
+  do {
+    const response = await drive.files.list({
+      q: `'root' in parents and mimeType = '${FOLDER_MIME}' and trashed = false`,
+      fields: "nextPageToken, files(id, name, modifiedTime)",
+      pageSize: PAGE_SIZE,
+      pageToken,
+    });
+    items.push(...(response.data.files || []));
+    pageToken = response.data.nextPageToken;
+  } while (pageToken);
+
+  return items.sort((a, b) => a.name.localeCompare(b.name));
+}
+
 export async function listAccessibleFiles(drive, includeSharedDrives = false) {
   const richFields =
     "nextPageToken, files(id, name, mimeType, size, modifiedTime, parents, ownedByMe, shared, driveId, owners(displayName,emailAddress), capabilities(canAddChildren,canEdit,canTrash,canDelete,canRename))";

package/src/core/repository.js

@@ -26,6 +26,7 @@ import {
   getAccountInfo,
   getRemoteState,
   listAccessibleFiles,
+  listRootFolders,
   syncLocalDirectoryToParent,
   uploadLocalEntry,
   withDriveRetry,
@@ -201,6 +202,10 @@ export class Repository {
 
   // ── File browser (TUI) ─────────────────────────────────────────────
 
+  async listRootFolders() {
+    return listRootFolders(this.drive);
+  }
+
   async listRemoteFiles({ includeSharedDrives = false } = {}) {
     return listAccessibleFiles(this.drive, includeSharedDrives);
   }