inboxd 1.0.13 → 1.2.0

package/README.md

@@ -30,7 +30,7 @@ npm install -g inboxd
 Run the interactive setup wizard:
 
 ```bash
-inbox setup
+inboxd setup
 ```
 
 The wizard will guide you through:
@@ -60,33 +60,33 @@ mv ~/Downloads/client_secret_*.json ~/.config/inboxd/credentials.json
 ### 2. Authenticate
 
 ```bash
-inbox auth --account personal
+inboxd auth --account personal
 ```
 
 ### 3. Check Your Inbox
 
 ```bash
-inbox summary
+inboxd summary
 ```
 
 ## Commands
 
 | Command | Description |
 |---------|-------------|
-| `inbox setup` | Interactive setup wizard |
-| `inbox auth -a <name>` | Authenticate a Gmail account |
-| `inbox accounts` | List configured accounts |
-| `inbox summary` | Show inbox summary for all accounts |
-| `inbox check` | Check for new emails + send notifications |
-| `inbox check -q` | Silent check (for background use) |
-| `inbox delete --ids <ids>` | Move emails to trash |
-| `inbox delete --sender <pattern>` | Delete by sender (with confirmation) |
-| `inbox delete --match <pattern>` | Delete by subject (with confirmation) |
-| `inbox restore --last 1` | Restore last deleted email |
-| `inbox deletion-log` | View deletion history |
-| `inbox logout --all` | Remove all accounts |
-| `inbox install-service` | Install background monitoring (macOS) |
-| `inbox install-skill` | Install Claude Code skill for AI agents |
+| `inboxd setup` | Interactive setup wizard |
+| `inboxd auth -a <name>` | Authenticate a Gmail account |
+| `inboxd accounts` | List configured accounts |
+| `inboxd summary` | Show inboxd summary for all accounts |
+| `inboxd check` | Check for new emails + send notifications |
+| `inboxd check -q` | Silent check (for background use) |
+| `inboxd delete --ids <ids>` | Move emails to trash |
+| `inboxd delete --sender <pattern>` | Delete by sender (with confirmation) |
+| `inboxd delete --match <pattern>` | Delete by subject (with confirmation) |
+| `inboxd restore --last 1` | Restore last deleted email |
+| `inboxd deletion-log` | View deletion history |
+| `inboxd logout --all` | Remove all accounts |
+| `inboxd install-service` | Install background monitoring (macOS) |
+| `inboxd install-skill` | Install Claude Code skill for AI agents |
 
 ## Configuration
 
@@ -106,10 +106,10 @@ Install as a macOS launchd service to check for new emails periodically:
 
 ```bash
 # Install and start with default 5-minute interval
-inbox install-service
+inboxd install-service
 
 # Or customize the interval
-inbox install-service --interval 10
+inboxd install-service --interval 10
 ```
 
 The service starts automatically after installation. Manage it with:
@@ -127,7 +127,7 @@ launchctl unload ~/Library/LaunchAgents/com.danielparedes.inboxd.plist
 
 **Note:** `install-service` is macOS-only. For Linux, use cron:
 ```bash
-*/5 * * * * /path/to/node /path/to/inbox check --quiet
+*/5 * * * * /path/to/node /path/to/inboxd check --quiet
 ```
 
 ## JSON Output
@@ -135,13 +135,13 @@ launchctl unload ~/Library/LaunchAgents/com.danielparedes.inboxd.plist
 For AI agent integration, use the `--json` flag:
 
 ```bash
-inbox summary --json
+inboxd summary --json
 ```
 
 Or use the `analyze` command for structured output:
 
 ```bash
-inbox analyze --count 20
+inboxd analyze --count 20
 ```
 
 ## AI Agent Integration
@@ -163,12 +163,12 @@ This package includes a **skill** that can be installed globally, enabling any C
 After installing inboxd, run:
 
 ```bash
-inbox install-skill
+inboxd install-skill
 ```
 
 This copies the inbox-assistant skill to `~/.claude/skills/`, making it available in all your Claude Code sessions.
 
-The setup wizard (`inbox setup`) also offers to install the skill automatically.
+The setup wizard (`inboxd setup`) also offers to install the skill automatically.
 
 ### What the Skill Enables
 
@@ -194,13 +194,13 @@ The skill auto-updates when you update inboxd (if already installed). You can al
 
 ```bash
 npm update -g inboxd
-inbox install-skill
+inboxd install-skill
 ```
 
 Safety features:
 - Won't overwrite skills not created by inboxd (uses `source: inboxd` marker)
 - Creates `SKILL.md.backup` before replacing if you've modified the skill
-- Use `inbox install-skill --force` to override ownership check
+- Use `inboxd install-skill --force` to override ownership check
 
 ### CLI vs MCP
 
@@ -208,9 +208,9 @@ Unlike an MCP server that exposes raw Gmail API primitives, `inboxd` provides **
 
 | inboxd CLI | Raw Gmail MCP |
 |------------|---------------|
-| `inbox delete` logs before trashing | Just trashes |
-| `inbox restore` removes from log | Just untrashes |
-| `inbox analyze` formats for AI consumption | Raw API response |
+| `inboxd delete` logs before trashing | Just trashes |
+| `inboxd restore` removes from log | Just untrashes |
+| `inboxd analyze` formats for AI consumption | Raw API response |
 
 The skill layer adds expert workflow guidance on top of these commands.
 
@@ -225,7 +225,7 @@ npm uninstall -g inboxd
 To also remove all account data and tokens:
 
 ```bash
-inbox logout --all
+inboxd logout --all
 ```
 
 To completely remove all data including credentials:
@@ -239,13 +239,13 @@ rm -rf ~/.config/inboxd
 ## Troubleshooting
 
 **"credentials.json not found"**
-Run `inbox setup` or manually download OAuth credentials from Google Cloud Console and save to `~/.config/inboxd/credentials.json`.
+Run `inboxd setup` or manually download OAuth credentials from Google Cloud Console and save to `~/.config/inboxd/credentials.json`.
 
 **"Token expired"**
 Delete the token file and re-authenticate:
 ```bash
 rm ~/.config/inboxd/token-<account>.json
-inbox auth -a <account>
+inboxd auth -a <account>
 ```
 
 **No notifications appearing**

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "inboxd",
-  "version": "1.0.13",
+  "version": "1.2.0",
   "description": "CLI assistant for Gmail monitoring with multi-account support and AI-ready JSON output",
   "main": "src/cli.js",
   "bin": {
-    "inbox": "src/cli.js"
+    "inboxd": "src/cli.js"
   },
   "repository": {
     "type": "git",
@@ -21,7 +21,7 @@
     "test": "vitest run",
     "test:watch": "vitest",
     "lint": "eslint src tests",
-    "inbox": "node src/cli.js",
+    "inboxd": "node src/cli.js",
     "postinstall": "node scripts/postinstall.js || true"
   },
   "keywords": [

package/scripts/postinstall.js

@@ -21,10 +21,10 @@ function showInstallHint() {
 │  inboxd installed successfully!                             │
 │                                                             │
 │  Quick start:                                               │
-│    inbox setup              # First-time configuration      │
+│    inboxd setup             # First-time configuration      │
 │                                                             │
 │  AI Agent Integration:                                      │
-│    inbox install-skill      # Enable Claude Code skill      │
+│    inboxd install-skill     # Enable Claude Code skill      │
 │                                                             │
 │  This lets AI agents manage your inbox with expert triage.  │
 │                                                             │
@@ -50,7 +50,7 @@ function handleSkillUpdate() {
       // Someone else's skill with same name → don't touch, warn
       console.log(`\n⚠️  ~/.claude/skills/inbox-assistant exists but isn't from inboxd`);
       console.log(`   The existing skill has source: "${status.source || 'none'}"`);
-      console.log(`   Run 'inbox install-skill --force' to replace it\n`);
+      console.log(`   Run 'inboxd install-skill --force' to replace it\n`);
       return;
     }
 
@@ -69,13 +69,13 @@ function handleSkillUpdate() {
         }
       } else if (result.reason === 'backup_failed') {
         console.log(`\n⚠️  Could not backup existing skill - update skipped`);
-        console.log(`   Run 'inbox install-skill' manually to update\n`);
+        console.log(`   Run 'inboxd install-skill' manually to update\n`);
       }
     }
     // Up-to-date → silent (no message)
   } catch (err) {
     // Fail silently - postinstall should not break npm install
-    // User can always run 'inbox install-skill' manually
+    // User can always run 'inboxd install-skill' manually
   }
 }
 

package/src/archive-log.js

@@ -0,0 +1,104 @@
+const fs = require('fs');
+const path = require('path');
+const { TOKEN_DIR } = require('./gmail-auth');
+const { atomicWriteJsonSync } = require('./utils');
+
+const LOG_DIR = TOKEN_DIR;
+const LOG_FILE = path.join(LOG_DIR, 'archive-log.json');
+
+/**
+ * Ensures the log directory exists
+ */
+function ensureLogDir() {
+  if (!fs.existsSync(LOG_DIR)) {
+    fs.mkdirSync(LOG_DIR, { recursive: true });
+  }
+}
+
+/**
+ * Reads the current archive log
+ * @returns {Array} Array of archive entries
+ */
+function readArchiveLog() {
+  ensureLogDir();
+  if (!fs.existsSync(LOG_FILE)) {
+    return [];
+  }
+  try {
+    const content = fs.readFileSync(LOG_FILE, 'utf8');
+    return JSON.parse(content);
+  } catch (_err) {
+    return [];
+  }
+}
+
+/**
+ * Logs archived emails to the archive log
+ * @param {Array} emails - Array of email objects with id, threadId, account, from, subject, snippet
+ */
+function logArchives(emails) {
+  ensureLogDir();
+  const log = readArchiveLog();
+  const timestamp = new Date().toISOString();
+
+  for (const email of emails) {
+    log.push({
+      archivedAt: timestamp,
+      account: email.account,
+      id: email.id,
+      threadId: email.threadId,
+      from: email.from,
+      subject: email.subject,
+      snippet: email.snippet,
+    });
+  }
+
+  atomicWriteJsonSync(LOG_FILE, log);
+}
+
+/**
+ * Gets recent archives from the log
+ * @param {number} days - Number of days to look back (default: 30)
+ * @returns {Array} Array of archive entries within the time range
+ */
+function getRecentArchives(days = 30) {
+  const log = readArchiveLog();
+  const cutoff = new Date();
+  cutoff.setDate(cutoff.getDate() - days);
+
+  return log.filter((entry) => {
+    const archivedAt = new Date(entry.archivedAt);
+    return archivedAt >= cutoff;
+  });
+}
+
+/**
+ * Gets the path to the log file (for display purposes)
+ * @returns {string} The log file path
+ */
+function getArchiveLogPath() {
+  return LOG_FILE;
+}
+
+/**
+ * Removes entries from the archive log (e.g., after unarchiving)
+ * @param {Array<string>} ids - Array of message IDs to remove
+ */
+function removeArchiveLogEntries(ids) {
+  ensureLogDir();
+  const log = readArchiveLog();
+
+  const newLog = log.filter(entry => !ids.includes(entry.id));
+
+  if (log.length !== newLog.length) {
+    atomicWriteJsonSync(LOG_FILE, newLog);
+  }
+}
+
+module.exports = {
+  logArchives,
+  getRecentArchives,
+  getArchiveLogPath,
+  readArchiveLog,
+  removeArchiveLogEntries,
+};