@devkitvault/recall 1.2.9 → 1.2.11

package/README.md

@@ -1,10 +1,13 @@
 # @devkitvault/recall
 
-**recall** is a CLI command vault for your terminal. Save the commands you keep losing, search them, run them by name, and sync when you want cloud backup.
+I kept losing useful shell commands. So I built a small vault for the ones I actually reuse.
 
-Product site and docs: [recall.devkitvault.com](https://recall.devkitvault.com)
+**recall** saves commands locally, lets you search and run them by name, and optionally syncs when you want the same vault on another machine.
 
-Open source: [github.com/devkitvault/recall-cli](https://github.com/devkitvault/recall-cli)
+- **Free:** local vault only — no account, nothing uploads (`~/.recall/commands.json`)
+- **Pro / Team:** `recall sync` + Ask (prints a suggestion; never runs it)
+
+Product: [recall.devkitvault.com](https://recall.devkitvault.com) · Docs: [docs](https://recall.devkitvault.com/docs)
 
 ## Requirements
 
@@ -23,44 +26,43 @@ recall --version
 recall doctor
 ```
 
-## Quick start (local vault)
+## Quick start (Free — local)
 
-Free is **fully local** — save / list / search / run on your machine with **no account**. Cloud **sync** and **Ask** are Pro/Team.
+No account needed.
 
 ```sh
-recall save "docker compose up -d" --name docker --tags docker
+recall save "docker compose up -d" -n up -t docker
 recall save --last -n useful -t docker
+recall import history -n 20
 recall list
 recall search docker
-recall run docker
+recall run up
 ```
 
-Commands live in `~/.recall/commands.json`.
+`recall import history` reads your shell history file (zsh / bash / PowerShell) and lets you pick what to keep. It does not sit in the background recording keystrokes.
 
-`recall save --last` (or `-L`) reads the last line from zsh / bash / PowerShell history. Not supported in Windows `cmd.exe`. On bash, if the command is missing: `history -a && recall save --last`.
+`recall save --last` (or `-L`) takes the last history line. Not supported in Windows `cmd.exe`. On bash, if it’s empty: `history -a && recall save --last`.
 
 ```sh
 recall playbook save deploy "docker compose up -d" "pnpm migrate"
 recall playbook run deploy --dry-run
 ```
 
-Local playbooks follow the same idea when available; cloud playbooks need Pro. `recall playbook run` executes steps. Ask never does.
+`recall playbook run` executes steps. Ask never does.
 
 ## Ask (Pro / Team)
 
-Natural-language Ask prints a suggestion and never runs it. Requires a Pro or Team plan.
-
 ```sh
 recall auth login
 recall "find the 10 biggest files in this directory"
 rec "that docker command from last week"
 ```
 
-No-args `recall` opens an Ask session (`Recall >`). `/save [name]` stores the last suggestion. `/exit` leaves.
+Ask only prints. You run the command yourself.
 
-## Auth & sync (Pro / Team)
+No-args `recall` opens an Ask session (`Recall >`). `/save [name]` stores the last suggestion. `/exit` leaves.
 
-Account + Pro/Team syncs your **local** commands to the cloud and unlocks Ask.
+## Sync (Pro / Team)
 
 ```sh
 recall auth login
@@ -70,12 +72,13 @@ recall sync --push   # local-only → cloud
 recall sync --status
 recall whoami
 ```
-## Prefer a standalone binary?
+
+## Native binary (optional)
 
 - **macOS / Linux:** `curl -fsSL https://devkitvault.com/recall/install.sh | sh`
 - **Windows:** `irm https://devkitvault.com/recall/install.ps1 | iex`
 
-See [recall.devkitvault.com/docs/install](https://recall.devkitvault.com/docs/install).
+See [install docs](https://recall.devkitvault.com/docs/install).
 
 ## Update
 
@@ -90,18 +93,17 @@ recall doctor
 recall whoami
 ```
 
-If something still fails, open an issue on [GitHub](https://github.com/devkitvault/recall-cli/issues) or visit [recall.devkitvault.com](https://recall.devkitvault.com).
+Issues: [github.com/devkitvaultorg/recall-cli/issues](https://github.com/devkitvaultorg/recall-cli/issues)
 
 ## Links
 
-|           |                                                                                           |
+| | |
 | --------- | ----------------------------------------------------------------------------------------- |
-| Website   | [recall.devkitvault.com](https://recall.devkitvault.com)                                  |
-| Docs      | [recall.devkitvault.com/docs](https://recall.devkitvault.com/docs)                        |
-| Dashboard | [recall.devkitvault.com](https://recall.devkitvault.com)                                  |
-| Source    | [github.com/devkitvault/recall-cli](https://github.com/devkitvault/recall-cli)            |
-| VS Code   | [Marketplace](https://marketplace.visualstudio.com/items?itemName=devkitvault.recall-cmd) |
-| Issues    | [github.com/devkitvault/recall-cli](https://github.com/devkitvault/recall-cli/issues)     |
+| Website | [recall.devkitvault.com](https://recall.devkitvault.com) |
+| Docs | [recall.devkitvault.com/docs](https://recall.devkitvault.com/docs) |
+| Source | [github.com/devkitvaultorg/recall-cli](https://github.com/devkitvaultorg/recall-cli) |
+| npm | [@devkitvault/recall](https://www.npmjs.com/package/@devkitvault/recall) |
+| VS Code | [Marketplace](https://marketplace.visualstudio.com/items?itemName=devkitvault.recall-cmd) |
 
 ## License
 

package/dist/commands/import.js

@@ -7,19 +7,22 @@ exports.importCommand = void 0;
 const chalk_1 = __importDefault(require("chalk"));
 const commander_1 = require("commander");
 const fs_1 = __importDefault(require("fs"));
-const ora_1 = __importDefault(require("ora"));
+const inquirer_1 = __importDefault(require("inquirer"));
 const path_1 = __importDefault(require("path"));
-const api_1 = require("../lib/api");
-const auth_1 = require("../lib/auth");
+const local_vault_1 = require("../lib/local-vault");
+const tags_1 = require("../lib/tags");
+const shell_history_1 = require("../lib/shell-history");
 function parseJSON(content) {
     const data = JSON.parse(content);
     if (!Array.isArray(data))
         throw new Error('JSON must be an array of commands');
     return data.map((item) => ({
-        command: item.command,
-        name: item.name,
-        tags: item.tags ?? [],
-    }));
+        command: String(item.command ?? ''),
+        name: typeof item.name === 'string' ? item.name : undefined,
+        tags: Array.isArray(item.tags)
+            ? item.tags.filter((t) => typeof t === 'string')
+            : undefined,
+    })).filter((e) => e.command.trim());
 }
 function parseSh(content) {
     const lines = content.split('\n');
@@ -28,14 +31,13 @@ function parseSh(content) {
     let currentTags = [];
     for (const raw of lines) {
         const line = raw.trim();
-        // skip empty lines and shebang
         if (!line || line.startsWith('#!'))
             continue;
         if (line.startsWith('# tags:')) {
             currentTags = line
                 .replace('# tags:', '')
                 .split(',')
-                .map(t => t.trim())
+                .map((t) => t.trim())
                 .filter(Boolean);
             continue;
         }
@@ -43,24 +45,59 @@ function parseSh(content) {
             currentName = line.replace('#', '').trim();
             continue;
         }
-        // it's a command
         entries.push({
             command: line,
             name: currentName,
-            tags: currentTags,
+            tags: currentTags.length ? currentTags : undefined,
         });
-        // reset
         currentName = undefined;
         currentTags = [];
     }
     return entries;
 }
-exports.importCommand = new commander_1.Command('import')
-    .description('Import commands from a JSON or shell script file')
-    .argument('<file>', 'Path to the file to import')
-    .option('-s, --skip-duplicates', 'Skip commands that already exist by name')
-    .action(async (file, opts) => {
-    const token = await (0, auth_1.requireAuth)();
+function commandAlreadyLocal(command, name) {
+    if (name && (0, local_vault_1.findLocalByName)(name))
+        return true;
+    return (0, local_vault_1.listLocalCommands)().some((c) => c.command === command);
+}
+function suggestName(command, used) {
+    const base = command
+        .replace(/[^a-zA-Z0-9]+/g, '-')
+        .replace(/^-|-$/g, '')
+        .toLowerCase()
+        .slice(0, 32) || 'cmd';
+    let name = base;
+    let n = 2;
+    while (used.has(name) || (0, local_vault_1.findLocalByName)(name)) {
+        name = `${base.slice(0, 28)}-${n}`;
+        n++;
+    }
+    used.add(name);
+    return name;
+}
+async function importEntries(entries, opts) {
+    let imported = 0;
+    let skipped = 0;
+    const usedNames = new Set();
+    for (const entry of entries) {
+        if (opts.skipDuplicates && commandAlreadyLocal(entry.command, entry.name)) {
+            skipped++;
+            continue;
+        }
+        const name = entry.name
+            ?? (opts.nameThem ? suggestName(entry.command, usedNames) : undefined);
+        if (name)
+            usedNames.add(name);
+        (0, local_vault_1.saveLocalCommand)({
+            command: entry.command,
+            name,
+            tags: entry.tags,
+        });
+        imported++;
+    }
+    return { imported, skipped };
+}
+async function importFromFile(file, opts) {
     const filePath = path_1.default.resolve(file);
     if (!fs_1.default.existsSync(filePath)) {
         console.error(chalk_1.default.red(`\n  File not found: ${filePath}\n`));
@@ -77,7 +114,6 @@ exports.importCommand = new commander_1.Command('import')
             entries = parseSh(content);
         }
         else {
-            // try JSON first, then sh
             try {
                 entries = parseJSON(content);
             }
@@ -87,40 +123,114 @@ exports.importCommand = new commander_1.Command('import')
         }
     }
     catch (err) {
-        console.error(chalk_1.default.red(`\n  Failed to parse file: ${err.message}\n`));
+        const message = err instanceof Error ? err.message : String(err);
+        console.error(chalk_1.default.red(`\n  Failed to parse file: ${message}\n`));
         process.exit(1);
     }
     if (!entries.length) {
         console.log(chalk_1.default.dim('\n  No commands found in file.\n'));
         return;
     }
-    console.log(chalk_1.default.dim(`\n  Found ${entries.length} command${entries.length === 1 ? '' : 's'} to import\n`));
-    let imported = 0;
-    let skipped = 0;
-    let failed = 0;
-    for (const entry of entries) {
-        const spinner = (0, ora_1.default)(`Importing: ${chalk_1.default.white(entry.name ?? entry.command.slice(0, 40))}`).start();
-        try {
-            await api_1.ApiClient.post('/commands', {
-                command: entry.command,
-                name: entry.name,
-                tags: entry.tags,
-            }, token);
-            spinner.succeed(chalk_1.default.green(`Imported: ${entry.name ?? entry.command.slice(0, 40)}`));
-            imported++;
-        }
-        catch (err) {
-            if (opts.skipDuplicates && err.status === 409) {
-                spinner.warn(chalk_1.default.yellow(`Skipped: ${entry.name ?? entry.command.slice(0, 40)}`));
-                skipped++;
-            }
-            else {
-                spinner.fail(chalk_1.default.red(`Failed: ${entry.name ?? entry.command.slice(0, 40)}`));
-                failed++;
-            }
+    console.log(chalk_1.default.dim(`\n  Found ${entries.length} command${entries.length === 1 ? '' : 's'} in file\n`));
+    const { imported, skipped } = await importEntries(entries, {
+        skipDuplicates: opts.skipDuplicates,
+        nameThem: false,
+    });
+    console.log(`  ${chalk_1.default.green(`${imported} imported`)}  ${chalk_1.default.yellow(`${skipped} skipped`)}`);
+    console.log(chalk_1.default.dim(`  Vault: ${local_vault_1.VAULT_FILE}\n`));
+}
+exports.importCommand = new commander_1.Command('import')
+    .description('Import commands into your local vault')
+    .argument('[file]', 'JSON or shell script to import (or use: recall import history)')
+    .option('-s, --skip-duplicates', 'Skip commands that already exist locally', true)
+    .addHelpText('after', `
+Examples:
+  $ recall import history
+  $ recall import history -n 20 -y
+  $ recall import ./backup.json
+`)
+    .action(async (file, opts) => {
+    if (!file) {
+        console.log(chalk_1.default.dim('\n  Usage:'));
+        console.log(chalk_1.default.dim('    recall import history     # from shell history (curated)'));
+        console.log(chalk_1.default.dim('    recall import <file>      # from JSON or .sh\n'));
+        process.exit(1);
+    }
+    await importFromFile(file, opts);
+});
+exports.importCommand
+    .command('history')
+    .description('Import curated commands from shell history into the local vault (not live capture)')
+    .option('-n, --limit <count>', 'Max unique recent commands to consider', '40')
+    .option('-y, --yes', 'Import all candidates without prompting')
+    .option('-i, --interactive', 'Choose which commands to import (default unless --yes)')
+    .option('--dry-run', 'Show candidates only; do not write')
+    .option('-t, --tags <tags>', 'Tags applied to imported commands')
+    .option('--min-length <n>', 'Skip commands shorter than this', '3')
+    .option('--no-names', 'Do not auto-generate names')
+    .option('--no-skip-duplicates', 'Import even if the same command text already exists')
+    .action(async (opts) => {
+    const limit = Math.max(1, parseInt(String(opts.limit), 10) || 40);
+    const minLength = Math.max(1, parseInt(String(opts.minLength), 10) || 3);
+    const tags = (0, tags_1.parseTags)(opts.tags);
+    let commands;
+    let source;
+    let shell;
+    try {
+        const result = (0, shell_history_1.readHistoryCommands)({ limit, minLength });
+        commands = result.commands;
+        source = result.source;
+        shell = result.shell;
+    }
+    catch (err) {
+        if (err instanceof shell_history_1.LastCommandError) {
+            console.log(chalk_1.default.red(`\n  ${err.message}\n`));
+            process.exit(1);
         }
+        throw err;
     }
     console.log();
-    console.log(`  ${chalk_1.default.green(`${imported} imported`)}  ${chalk_1.default.yellow(`${skipped} skipped`)}  ${chalk_1.default.red(`${failed} failed`)}`);
+    console.log(chalk_1.default.dim(`  Shell: ${shell} · ${source}`));
+    console.log(chalk_1.default.dim(`  ${commands.length} unique candidate${commands.length === 1 ? '' : 's'} (newest first)\n`));
+    let selected = commands;
+    const interactive = !opts.yes && (opts.interactive || !opts.dryRun);
+    if (opts.yes) {
+        selected = commands;
+    }
+    else if (interactive && !opts.dryRun) {
+        const { picked } = await inquirer_1.default.prompt([
+            {
+                type: 'checkbox',
+                name: 'picked',
+                message: 'Select commands to save locally',
+                pageSize: 16,
+                choices: commands.map((c) => ({
+                    name: c.length > 80 ? `${c.slice(0, 77)}…` : c,
+                    value: c,
+                    checked: false,
+                })),
+            },
+        ]);
+        selected = picked;
+        if (!selected.length) {
+            console.log(chalk_1.default.dim('\n  Nothing selected.\n'));
+            return;
+        }
+    }
+    if (opts.dryRun) {
+        for (const [i, c] of selected.entries()) {
+            console.log(`  ${chalk_1.default.dim(String(i + 1).padStart(2))}. ${c}`);
+        }
+        console.log(chalk_1.default.dim(`\n  Dry run — nothing written. Drop --dry-run to import.\n`));
+        return;
+    }
+    const entries = selected.map((command) => ({ command, tags }));
+    const { imported, skipped } = await importEntries(entries, {
+        skipDuplicates: opts.skipDuplicates !== false,
+        nameThem: opts.names !== false,
+    });
     console.log();
+    console.log(`  ${chalk_1.default.green(`${imported} imported`)}  ${chalk_1.default.yellow(`${skipped} skipped`)}`);
+    console.log(chalk_1.default.dim(`  Vault: ${local_vault_1.VAULT_FILE}`));
+    console.log(chalk_1.default.dim('  Sync to cloud (Pro): recall sync\n'));
 });

package/dist/commands/sync.js

@@ -10,29 +10,47 @@ const commander_1 = require("commander");
 const ora_1 = __importDefault(require("ora"));
 const api_1 = require("../lib/api");
 const auth_1 = require("../lib/auth");
+const local_collections_1 = require("../lib/local-collections");
 const local_vault_1 = require("../lib/local-vault");
 exports.syncCommand = new commander_1.Command('sync')
     .description('Sync local vault ↔ cloud (Pro/Team)')
     .option('-s, --status', 'Show local vault + last sync status')
     .option('--pull', 'Pull cloud → local only')
-    .option('--push', 'Push local-only commands → cloud only')
+    .option('--push', 'Push local-only items → cloud only')
     .action(async (opts) => {
     const vault = (0, local_vault_1.readVault)();
     if (opts.status) {
+        const groups = (0, local_collections_1.listLocalGroups)().length;
+        const templates = (0, local_collections_1.listLocalTemplates)().length;
+        const snippets = (0, local_collections_1.listLocalSnippets)().length;
+        const envSets = (0, local_collections_1.listLocalEnvSets)().length;
+        const aliases = (0, local_collections_1.listLocalAliases)().length;
         console.log();
-        console.log(`  Local commands: ${chalk_1.default.white(vault.commands.length)}`);
-        console.log(`  Vault file:     ${chalk_1.default.dim(local_vault_1.VAULT_FILE)}`);
+        console.log(chalk_1.default.white('  Local vault (Free soft caps)'));
+        console.log(`  Commands:   ${chalk_1.default.white(vault.commands.length)}/${local_collections_1.LOCAL_SOFT_CAPS.commands}`);
+        console.log(`  Groups:     ${chalk_1.default.white(groups)}/${local_collections_1.LOCAL_SOFT_CAPS.groups}`);
+        console.log(`  Templates:  ${chalk_1.default.white(templates)}/${local_collections_1.LOCAL_SOFT_CAPS.templates}`);
+        console.log(`  Snippets:   ${chalk_1.default.white(snippets)}/${local_collections_1.LOCAL_SOFT_CAPS.snippets}`);
+        console.log(`  Env sets:   ${chalk_1.default.white(envSets)}/${local_collections_1.LOCAL_SOFT_CAPS.envSets}`);
+        console.log(`  Aliases:    ${chalk_1.default.white(aliases)}/${local_collections_1.LOCAL_SOFT_CAPS.aliases}`);
+        console.log(`  Vault file: ${chalk_1.default.dim(local_vault_1.VAULT_FILE)}`);
         if (!vault.syncedAt) {
             console.log(chalk_1.default.dim('  Never synced to cloud.'));
         }
         else {
             const ago = Math.round((Date.now() - new Date(vault.syncedAt).getTime()) / 1000 / 60);
-            console.log(`  Last synced:    ${chalk_1.default.white(ago < 1 ? 'just now' : `${ago} minutes ago`)}`);
+            console.log(`  Last synced: ${chalk_1.default.white(ago < 1 ? 'just now' : `${ago} minutes ago`)}`);
         }
-        const pending = (0, local_vault_1.localCommandsNeedingPush)().length;
+        const pending = (0, local_vault_1.localCommandsNeedingPush)().length +
+            (0, local_collections_1.groupsNeedingPush)().length +
+            (0, local_collections_1.templatesNeedingPush)().length +
+            (0, local_collections_1.snippetsNeedingPush)().length +
+            (0, local_collections_1.envSetsNeedingPush)().length +
+            (0, local_collections_1.aliasesNeedingPush)().length;
         if (pending) {
-            console.log(`  Not on cloud:   ${chalk_1.default.yellow(String(pending))} (recall sync --push)`);
+            console.log(`  Not on cloud: ${chalk_1.default.yellow(String(pending))} (recall sync --push)`);
         }
+        console.log(chalk_1.default.dim('  Sync requires Pro/Team. Free cloud quota is always 0.'));
         console.log();
         return;
     }
@@ -44,9 +62,11 @@ exports.syncCommand = new commander_1.Command('sync')
         const { user } = await api_1.ApiClient.get('/auth/me', token);
         const plan = (user.plan ?? 'free');
         spinner.stop();
+        // Anti-scam: never sync on Free — cloud Free quotas are 0
         if (plan !== 'pro' && plan !== 'team') {
             console.log(chalk_1.default.yellow('\n  Cloud sync requires Pro or Team.'));
             console.log(chalk_1.default.dim('  Local vault still works without sync.'));
+            console.log(chalk_1.default.dim('  Free accounts cannot push to cloud (anti-abuse).'));
             console.log(chalk_1.default.dim('  Upgrade: recall upgrade\n'));
             process.exit(1);
         }
@@ -64,9 +84,56 @@ exports.syncCommand = new commander_1.Command('sync')
         const pullSpinner = (0, ora_1.default)('Pulling from cloud...').start();
         try {
             const { commands } = await api_1.ApiClient.get('/commands', token);
-            const { added, updated } = (0, local_vault_1.mergeCloudIntoLocal)(commands);
-            pulled = added + updated;
-            pullSpinner.succeed(chalk_1.default.green(`Pulled cloud vault (${added} new, ${updated} updated)`));
+            const cmdMerge = (0, local_vault_1.mergeCloudIntoLocal)(commands);
+            pulled += cmdMerge.added + cmdMerge.updated;
+            try {
+                const { groups } = await api_1.ApiClient.get('/groups', token);
+                const g = (0, local_collections_1.mergeCloudGroups)(groups ?? []);
+                pulled += g.added + g.updated;
+            }
+            catch {
+                /* Free/legacy — ignore */
+            }
+            try {
+                const { templates } = await api_1.ApiClient.get('/templates', token);
+                const t = (0, local_collections_1.mergeCloudTemplates)(templates ?? []);
+                pulled += t.added + t.updated;
+            }
+            catch {
+                /* ignore */
+            }
+            try {
+                const { snippets } = await api_1.ApiClient.get('/snippets', token);
+                const s = (0, local_collections_1.mergeCloudSnippets)(snippets ?? []);
+                pulled += s.added + s.updated;
+            }
+            catch {
+                /* ignore */
+            }
+            // Env list omits vars — fetch each by name
+            try {
+                const { envSets } = await api_1.ApiClient.get('/env', token);
+                const full = [];
+                for (const e of envSets ?? []) {
+                    try {
+                        const row = await api_1.ApiClient.get(`/env/${encodeURIComponent(e.name)}`, token);
+                        full.push({
+                            id: row.id,
+                            name: row.name,
+                            vars: row.vars ?? {},
+                        });
+                    }
+                    catch {
+                        /* skip */
+                    }
+                }
+                const em = (0, local_collections_1.mergeCloudEnvSets)(full);
+                pulled += em.added + em.updated;
+            }
+            catch {
+                /* ignore */
+            }
+            pullSpinner.succeed(chalk_1.default.green(`Pulled cloud vault (≈${pulled} changes)`));
         }
         catch (err) {
             pullSpinner.fail(chalk_1.default.red('Pull failed'));
@@ -77,32 +144,76 @@ exports.syncCommand = new commander_1.Command('sync')
         }
     }
     if (doPush) {
-        const pending = (0, local_vault_1.localCommandsNeedingPush)();
-        if (!pending.length) {
-            console.log(chalk_1.default.dim('  Nothing new to push.'));
-        }
-        else {
-            const pushSpinner = (0, ora_1.default)(`Pushing ${pending.length} local command(s)...`).start();
-            try {
-                for (const cmd of pending) {
-                    const saved = await api_1.ApiClient.post('/commands', {
-                        command: cmd.command,
-                        name: cmd.name,
-                        tags: cmd.tags,
-                    }, token);
-                    if (saved?.id)
-                        (0, local_vault_1.attachCloudId)(cmd.id, saved.id);
-                    pushed++;
-                }
-                pushSpinner.succeed(chalk_1.default.green(`Pushed ${pushed} command${pushed === 1 ? '' : 's'} to cloud`));
+        const pushSpinner = (0, ora_1.default)('Pushing local items...').start();
+        try {
+            for (const cmd of (0, local_vault_1.localCommandsNeedingPush)()) {
+                const saved = await api_1.ApiClient.post('/commands', {
+                    command: cmd.command,
+                    name: cmd.name,
+                    tags: cmd.tags,
+                }, token);
+                if (saved?.id)
+                    (0, local_vault_1.attachCloudId)(cmd.id, saved.id);
+                pushed++;
+            }
+            for (const g of (0, local_collections_1.groupsNeedingPush)()) {
+                const saved = await api_1.ApiClient.post('/groups', { name: g.name }, token);
+                if (saved?.id)
+                    (0, local_collections_1.attachGroupCloudId)(g.id, saved.id);
+                pushed++;
             }
-            catch (err) {
-                pushSpinner.fail(chalk_1.default.red('Push failed'));
-                if (err instanceof api_1.ApiError && err.status === 403) {
-                    console.log(chalk_1.default.yellow('\n  Cloud save requires Pro. Local vault is unchanged.\n'));
+            for (const t of (0, local_collections_1.templatesNeedingPush)()) {
+                const saved = await api_1.ApiClient.post('/templates', { name: t.name, template: t.template, tags: t.tags ?? [] }, token);
+                if (saved?.id)
+                    (0, local_collections_1.attachTemplateCloudId)(t.id, saved.id);
+                pushed++;
+            }
+            for (const s of (0, local_collections_1.snippetsNeedingPush)()) {
+                const saved = await api_1.ApiClient.post('/snippets', { name: s.name, content: s.content, tags: s.tags ?? [] }, token);
+                if (saved?.id)
+                    (0, local_collections_1.attachSnippetCloudId)(s.id, saved.id);
+                pushed++;
+            }
+            for (const e of (0, local_collections_1.envSetsNeedingPush)()) {
+                const saved = await api_1.ApiClient.post('/env', { name: e.name, vars: e.vars }, token);
+                // Env upsert may return without id — treat name as synced marker via cloudId if present
+                if (saved?.id)
+                    (0, local_collections_1.attachEnvCloudId)(e.id, saved.id);
+                else if (saved?.name)
+                    (0, local_collections_1.attachEnvCloudId)(e.id, saved.name);
+                pushed++;
+            }
+            // Aliases need cloud commandId — resolve via local command's cloudId
+            for (const a of (0, local_collections_1.aliasesNeedingPush)()) {
+                const localCmd = (0, local_vault_1.listLocalCommands)().find((c) => c.id === a.localCommandId);
+                const cloudCommandId = localCmd?.cloudId ??
+                    (localCmd?.name ? (0, local_vault_1.findLocalByName)(localCmd.name)?.cloudId : undefined);
+                if (!cloudCommandId) {
+                    continue; // skip until command is synced
                 }
-                process.exit(1);
+                const saved = await api_1.ApiClient.post('/aliases', { alias: a.alias, commandId: cloudCommandId }, token);
+                if (saved?.id)
+                    (0, local_collections_1.attachAliasCloudId)(a.id, saved.id);
+                else
+                    (0, local_collections_1.attachAliasCloudId)(a.id, a.alias);
+                pushed++;
+            }
+            if (!pushed) {
+                pushSpinner.succeed(chalk_1.default.dim('Nothing new to push'));
             }
+            else {
+                pushSpinner.succeed(chalk_1.default.green(`Pushed ${pushed} item${pushed === 1 ? '' : 's'} to cloud`));
+            }
+        }
+        catch (err) {
+            pushSpinner.fail(chalk_1.default.red('Push failed'));
+            if (err instanceof api_1.ApiError && err.status === 403) {
+                console.log(chalk_1.default.yellow('\n  Cloud save blocked (plan limit or Free). Local vault unchanged.\n'));
+            }
+            else if (err instanceof Error) {
+                console.log(chalk_1.default.red(`\n  ${err.message}\n`));
+            }
+            process.exit(1);
         }
     }
     console.log();

package/dist/lib/config.js

@@ -11,7 +11,7 @@ const os_1 = __importDefault(require("os"));
 const path_1 = __importDefault(require("path"));
 const CONFIG_DIR = path_1.default.join(os_1.default.homedir(), '.recall');
 const CONFIG_FILE = path_1.default.join(CONFIG_DIR, 'config.json');
-exports.APP_VERSION = '1.2.9';
+exports.APP_VERSION = '1.2.11';
 exports.ENVIRONMENTS = {
     production: 'https://api.devkitvault.com',
     local: 'http://127.0.0.1:3001',