@devkitvault/recall 1.2.0 → 1.2.1

package/dist/commands/ask.js

@@ -4,15 +4,20 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.askCommand = void 0;
+exports.printSuggestion = printSuggestion;
+exports.printAskError = printAskError;
+exports.saveSuggestion = saveSuggestion;
+exports.resolveAsk = resolveAsk;
 exports.runAsk = runAsk;
 const chalk_1 = __importDefault(require("chalk"));
 const commander_1 = require("commander");
 const inquirer_1 = __importDefault(require("inquirer"));
-const ora_1 = __importDefault(require("ora"));
 const api_1 = require("../lib/api");
 const auth_1 = require("../lib/auth");
 const events_1 = require("../lib/events");
+const project_1 = require("../lib/project");
 const runtime_1 = require("../lib/runtime");
+const spinner_1 = require("../lib/spinner");
 function riskColor(risk) {
     if (risk === 'DANGEROUS')
         return chalk_1.default.red(risk);
@@ -20,76 +25,107 @@ function riskColor(risk) {
         return chalk_1.default.yellow(risk);
     return chalk_1.default.green(risk);
 }
-async function runAsk(query) {
-    const token = await (0, auth_1.requireAuth)();
+function printSuggestion(result) {
+    console.log();
+    for (const line of result.command.split('\n')) {
+        console.log(`  ${chalk_1.default.white(line)}`);
+    }
+    if (result.explanation) {
+        console.log(`  ${chalk_1.default.dim(result.explanation)}`);
+    }
+    console.log();
+    console.log(`  ${chalk_1.default.dim('shell:')} ${result.shell}    ${chalk_1.default.dim('risk:')} ${riskColor(result.risk)}    ${chalk_1.default.dim('source:')} ${result.source}`);
+    if (result.source === 'vault') {
+        const playbook = result.explanation?.includes('playbooks');
+        console.log(chalk_1.default.dim(playbook ? '  from your playbooks' : '  from your vault'));
+    }
+    if (result.source === 'project') {
+        console.log(chalk_1.default.dim('  from this repo'));
+    }
+    if (result.remaining !== null) {
+        console.log(`  ${chalk_1.default.dim(`ai left this month: ${result.remaining}`)}`);
+    }
+    if (result.alternatives?.length) {
+        console.log();
+        for (const alt of result.alternatives) {
+            console.log(`  ${chalk_1.default.dim('alt')} ${alt}`);
+        }
+    }
+    console.log();
+    console.log(chalk_1.default.dim('  Ask mode does not run commands. Copy or save this yourself.'));
+    console.log();
+}
+function printAskError(err) {
+    if (err instanceof api_1.ApiError && err.status === 403 && err.body?.upgrade) {
+        console.log(chalk_1.default.yellow(`\n  ${err.message}`));
+        console.log(chalk_1.default.dim(`  Upgrade at ${chalk_1.default.white(err.body.upgrade)}\n`));
+        return;
+    }
+    if (err instanceof api_1.ApiError) {
+        console.error(chalk_1.default.red(`\n  ${err.message}\n`));
+        return;
+    }
+    console.error(chalk_1.default.red('\n  Failed to resolve that request.\n'));
+}
+async function saveSuggestion(token, command, name, source, risk) {
+    await api_1.ApiClient.post('/commands', {
+        command,
+        name: name?.trim() || undefined,
+    }, token);
+    await (0, events_1.track)('ai_accepted', { source, risk, saved: true });
+    console.log(chalk_1.default.green('\n  Saved.\n'));
+}
+async function resolveAsk(opts) {
     const runtime = (0, runtime_1.detectRuntime)();
-    const spinner = (0, ora_1.default)('Looking up...').start();
+    const spinner = (0, spinner_1.delayedSpinner)('Looking up...');
     try {
-        const result = await api_1.ApiClient.post('/ai/resolve', {
-            query,
+        const body = {
+            query: opts.query,
             os: runtime.os,
             shell: runtime.shell,
+            projectMeta: (0, project_1.detectProject)(),
             mode: 'ask',
-        }, token);
+        };
+        if (opts.turns?.length)
+            body.turns = opts.turns;
+        const result = await api_1.ApiClient.post('/ai/resolve', body, opts.token);
         spinner.stop();
-        console.log();
-        console.log(`  ${chalk_1.default.white(result.command)}`);
-        if (result.explanation) {
-            console.log(`  ${chalk_1.default.dim(result.explanation)}`);
-        }
-        console.log();
-        console.log(`  ${chalk_1.default.dim('shell:')} ${result.shell}    ${chalk_1.default.dim('risk:')} ${riskColor(result.risk)}    ${chalk_1.default.dim('source:')} ${result.source}`);
-        if (result.source === 'vault') {
-            console.log(chalk_1.default.dim('  from your vault'));
-        }
-        if (result.remaining !== null) {
-            console.log(`  ${chalk_1.default.dim(`ai left this month: ${result.remaining}`)}`);
-        }
-        if (result.alternatives?.length) {
-            console.log();
-            for (const alt of result.alternatives) {
-                console.log(`  ${chalk_1.default.dim('alt')} ${alt}`);
-            }
-        }
-        console.log();
-        console.log(chalk_1.default.dim('  Ask mode does not run commands. Copy or save this yourself.'));
-        console.log();
-        if (result.source === 'vault') {
-            await (0, events_1.track)('ai_accepted', { source: result.source, risk: result.risk, saved: false });
-            return;
-        }
-        const { save } = await inquirer_1.default.prompt([{
-                type: 'confirm',
-                name: 'save',
-                message: 'Save this command?',
-                default: false,
-            }]);
-        if (!save)
-            return;
-        const { name } = await inquirer_1.default.prompt([{
-                type: 'input',
-                name: 'name',
-                message: 'Name (optional):',
-            }]);
-        await api_1.ApiClient.post('/commands', {
-            command: result.command,
-            name: name?.trim() || undefined,
-        }, token);
-        await (0, events_1.track)('ai_accepted', { source: result.source, risk: result.risk, saved: true });
-        console.log(chalk_1.default.green('\n  Saved.\n'));
+        printSuggestion(result);
+        return result;
     }
     catch (err) {
         spinner.stop();
-        if (err instanceof api_1.ApiError && err.status === 403 && err.body?.upgrade) {
-            console.log(chalk_1.default.yellow(`\n  ${err.message}`));
-            console.log(chalk_1.default.dim(`  Upgrade at ${chalk_1.default.white(err.body.upgrade)}\n`));
-            return;
-        }
-        if (err instanceof api_1.ApiError) {
-            console.error(chalk_1.default.red(`\n  ${err.message}\n`));
-            return;
-        }
-        console.error(chalk_1.default.red('\n  Failed to resolve that request.\n'));
+        printAskError(err);
+        return null;
+    }
+}
+async function runAsk(query) {
+    const token = await (0, auth_1.requireAuth)();
+    const result = await resolveAsk({ query, token });
+    if (!result)
+        return;
+    if (result.source === 'vault') {
+        await (0, events_1.track)('ai_accepted', { source: result.source, risk: result.risk, saved: false });
+        return;
+    }
+    const { save } = await inquirer_1.default.prompt([{
+            type: 'confirm',
+            name: 'save',
+            message: 'Save this command?',
+            default: false,
+        }]);
+    if (!save)
+        return;
+    const { name } = await inquirer_1.default.prompt([{
+            type: 'input',
+            name: 'name',
+            message: 'Name (optional):',
+        }]);
+    try {
+        await saveSuggestion(token, result.command, name, result.source, result.risk);
+    }
+    catch (err) {
+        printAskError(err);
     }
 }
 exports.askCommand = new commander_1.Command('ask')

package/dist/commands/playbook.js

@@ -0,0 +1,139 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.playbookCommand = void 0;
+const chalk_1 = __importDefault(require("chalk"));
+const child_process_1 = require("child_process");
+const cli_table3_1 = __importDefault(require("cli-table3"));
+const commander_1 = require("commander");
+const ora_1 = __importDefault(require("ora"));
+const api_1 = require("../lib/api");
+const auth_1 = require("../lib/auth");
+const playbookSave = new commander_1.Command('save')
+    .argument('<name>', 'Playbook name')
+    .argument('<steps...>', 'Ordered commands to run')
+    .description('Save an ordered workflow')
+    .action(async (name, steps) => {
+    const token = await (0, auth_1.requireAuth)();
+    const cleaned = steps.map((s) => s.trim()).filter(Boolean);
+    if (!cleaned.length) {
+        console.log(chalk_1.default.yellow('\n  At least one step is required.\n'));
+        return;
+    }
+    const spinner = (0, ora_1.default)('Saving playbook...').start();
+    try {
+        await api_1.ApiClient.post('/playbooks', { name, steps: cleaned }, token);
+        spinner.succeed(chalk_1.default.green(`Playbook "${name}" saved`));
+        console.log(chalk_1.default.dim(`\n  ${cleaned.length} step${cleaned.length === 1 ? '' : 's'}. Ask never runs them.\n`));
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : 'Failed to save playbook';
+        spinner.fail(chalk_1.default.red(message));
+    }
+});
+const playbookList = new commander_1.Command('list')
+    .description('List your playbooks')
+    .action(async () => {
+    const token = await (0, auth_1.requireAuth)();
+    const spinner = (0, ora_1.default)('Fetching playbooks...').start();
+    try {
+        const { playbooks } = await api_1.ApiClient.get('/playbooks', token);
+        spinner.stop();
+        if (!playbooks.length) {
+            console.log(chalk_1.default.dim('\n  No playbooks yet.'));
+            console.log(chalk_1.default.dim('  Run: recall playbook save deploy "docker compose up -d" "pnpm migrate"\n'));
+            return;
+        }
+        const table = new cli_table3_1.default({
+            head: [chalk_1.default.cyan('Name'), chalk_1.default.cyan('Steps')],
+            style: { head: [], border: ['grey'] },
+            colWidths: [24, 48],
+            wordWrap: true,
+        });
+        for (const book of playbooks) {
+            table.push([
+                chalk_1.default.white(book.name),
+                book.steps.join(' → '),
+            ]);
+        }
+        console.log(table.toString());
+    }
+    catch {
+        spinner.fail(chalk_1.default.red('Failed to fetch playbooks'));
+    }
+});
+const playbookShow = new commander_1.Command('show')
+    .argument('<name>', 'Playbook name')
+    .description('Show playbook steps')
+    .action(async (name) => {
+    const token = await (0, auth_1.requireAuth)();
+    const spinner = (0, ora_1.default)('Fetching...').start();
+    try {
+        const book = await api_1.ApiClient.get(`/playbooks/by-name/${encodeURIComponent(name)}`, token);
+        spinner.stop();
+        console.log(chalk_1.default.bold(`\n  ${book.name}\n`));
+        book.steps.forEach((step, i) => {
+            console.log(`  ${chalk_1.default.dim(String(i + 1).padStart(2, '0'))}  ${step}`);
+        });
+        console.log();
+    }
+    catch {
+        spinner.fail(chalk_1.default.red(`Playbook "${name}" not found`));
+    }
+});
+const playbookRun = new commander_1.Command('run')
+    .argument('<name>', 'Playbook name')
+    .option('-d, --dry-run', 'Print steps without running')
+    .description('Run playbook steps in order (this executes)')
+    .action(async (name, opts) => {
+    const token = await (0, auth_1.requireAuth)();
+    const spinner = (0, ora_1.default)('Fetching playbook...').start();
+    try {
+        const book = await api_1.ApiClient.get(`/playbooks/by-name/${encodeURIComponent(name)}`, token);
+        spinner.stop();
+        console.log(chalk_1.default.dim(`\n  Playbook: ${chalk_1.default.white(book.name)}\n`));
+        if (opts.dryRun) {
+            book.steps.forEach((step, i) => {
+                console.log(`  ${i + 1}. ${step}`);
+            });
+            console.log();
+            return;
+        }
+        await api_1.ApiClient.post(`/playbooks/${book.id}/run`, {}, token);
+        for (const [i, step] of book.steps.entries()) {
+            console.log(chalk_1.default.dim(`  step ${i + 1}/${book.steps.length}`));
+            (0, child_process_1.execSync)(step, { stdio: 'inherit' });
+        }
+        console.log();
+    }
+    catch (err) {
+        spinner.stop();
+        const message = err instanceof Error ? err.message : `Playbook "${name}" failed`;
+        console.error(chalk_1.default.red(`\n  ${message}\n`));
+    }
+});
+const playbookDelete = new commander_1.Command('delete')
+    .argument('<name>', 'Playbook name')
+    .description('Delete a playbook')
+    .action(async (name) => {
+    const token = await (0, auth_1.requireAuth)();
+    const spinner = (0, ora_1.default)('Looking up...').start();
+    try {
+        const book = await api_1.ApiClient.get(`/playbooks/by-name/${encodeURIComponent(name)}`, token);
+        spinner.text = 'Deleting...';
+        await api_1.ApiClient.delete(`/playbooks/${book.id}`, token);
+        spinner.succeed(chalk_1.default.green(`Deleted playbook "${name}"`));
+    }
+    catch {
+        spinner.fail(chalk_1.default.red(`Playbook "${name}" not found`));
+    }
+});
+exports.playbookCommand = new commander_1.Command('playbook')
+    .description('Ordered multi-step workflows')
+    .addCommand(playbookSave)
+    .addCommand(playbookList)
+    .addCommand(playbookShow)
+    .addCommand(playbookRun)
+    .addCommand(playbookDelete);

package/dist/commands/repl.js

@@ -0,0 +1,112 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runRepl = runRepl;
+const node_readline_1 = __importDefault(require("node:readline"));
+const chalk_1 = __importDefault(require("chalk"));
+const auth_1 = require("../lib/auth");
+const events_1 = require("../lib/events");
+const turns_1 = require("../lib/turns");
+const ask_1 = require("./ask");
+function printReplHelp() {
+    console.log(chalk_1.default.dim('  Ask prints a command. It does not run it.'));
+    console.log(chalk_1.default.dim('  /save [name]  save the last suggestion'));
+    console.log(chalk_1.default.dim('  /clear        forget this session'));
+    console.log(chalk_1.default.dim('  /exit         leave'));
+}
+async function runRepl() {
+    const token = await (0, auth_1.requireAuth)();
+    await (0, events_1.track)('repl_started');
+    const rl = node_readline_1.default.createInterface({
+        input: process.stdin,
+        output: process.stdout,
+        prompt: 'Recall > ',
+    });
+    let turns = [];
+    let last = null;
+    let turnIndex = 0;
+    let busy = false;
+    let open = true;
+    console.log(chalk_1.default.dim('  Ask session. Prints only. /help for commands.'));
+    rl.prompt();
+    async function handleLine(raw) {
+        const line = raw.trim();
+        if (!line)
+            return;
+        if ((0, turns_1.isExitCommand)(line)) {
+            rl.close();
+            return;
+        }
+        if (line === '/help') {
+            printReplHelp();
+            return;
+        }
+        if (line === '/clear') {
+            turns = [];
+            last = null;
+            console.log(chalk_1.default.dim('  session cleared'));
+            return;
+        }
+        if (line === '/save' || line.startsWith('/save ')) {
+            if (!last) {
+                console.log(chalk_1.default.dim('  nothing to save'));
+                return;
+            }
+            const name = line === '/save' ? undefined : line.slice(6).trim();
+            try {
+                await (0, ask_1.saveSuggestion)(token, last.command, name, last.source, last.risk);
+            }
+            catch {
+                console.error(chalk_1.default.red('\n  Failed to save.\n'));
+            }
+            return;
+        }
+        if (line.startsWith('/')) {
+            console.log(chalk_1.default.dim('  unknown command. /help'));
+            return;
+        }
+        const result = await (0, ask_1.resolveAsk)({
+            query: line,
+            token,
+            turns: (0, turns_1.trimTurns)(turns),
+        });
+        if (!result)
+            return;
+        last = result;
+        turns = (0, turns_1.trimTurns)([...turns, { query: line, command: result.command }]);
+        turnIndex += 1;
+        await (0, events_1.track)('repl_turns', { source: result.source, n: turnIndex });
+        if (result.source === 'vault') {
+            await (0, events_1.track)('ai_accepted', { source: result.source, risk: result.risk, saved: false });
+        }
+    }
+    rl.on('line', (raw) => {
+        if (busy)
+            return;
+        busy = true;
+        rl.pause();
+        void handleLine(raw)
+            .catch(() => {
+            console.error(chalk_1.default.red('\n  Failed to resolve that request.\n'));
+        })
+            .finally(() => {
+            busy = false;
+            if (open) {
+                rl.resume();
+                rl.prompt();
+            }
+        });
+    });
+    rl.on('SIGINT', () => {
+        rl.close();
+    });
+    await new Promise((resolve) => {
+        rl.on('close', () => {
+            open = false;
+            console.log();
+            resolve();
+        });
+    });
+}

package/dist/commands/upgrade.js

@@ -17,6 +17,7 @@ const PLANS = {
         price: '$0/month',
         features: [
             '20 AI asks / month',
+            '3 playbooks',
             '100 command saves',
             'Search and filter',
             'Export as JSON or shell script',
@@ -28,6 +29,7 @@ const PLANS = {
         price: '$6/month',
         features: [
             '500 AI asks / month',
+            'Unlimited playbooks',
             'Unlimited commands',
             'Command groups',
             'Share commands via link',

package/dist/index.js

@@ -24,6 +24,8 @@ const import_1 = require("./commands/import");
 const list_1 = require("./commands/list");
 const org_1 = require("./commands/org");
 const pin_1 = require("./commands/pin");
+const playbook_1 = require("./commands/playbook");
+const repl_1 = require("./commands/repl");
 const run_1 = require("./commands/run");
 const save_1 = require("./commands/save");
 const search_1 = require("./commands/search");
@@ -42,7 +44,7 @@ const KNOWN = new Set([
     'export', 'import', 'whoami', 'upgrade', 'sync', 'group', 'org',
     'config', 'pin', 'alias', 'history', 'share', 'snippet', 'env',
     'audit', 'approve', 'template', 'doctor', 'completion', 'feedback',
-    'support', 'ask', 'help',
+    'support', 'ask', 'playbook', 'help',
 ]);
 const rawArgs = process.argv.slice(2);
 if (rawArgs.length > 0
@@ -80,12 +82,18 @@ program.addCommand(env_1.envCommand);
 program.addCommand(audit_1.auditCommand);
 program.addCommand(approve_1.approveCommand);
 program.addCommand(template_1.templateCommand);
+program.addCommand(playbook_1.playbookCommand);
 program.addCommand(doctor_1.doctorCommand);
 program.addCommand(completion_1.completionCommand);
 program.addCommand(feedback_1.feedbackCommand);
 program.addCommand(support_1.supportCommand);
 async function main() {
     void (0, events_1.trackInstalledOnce)();
+    const raw = process.argv.slice(2);
+    if (raw.length === 0) {
+        await (0, repl_1.runRepl)();
+        return;
+    }
     await program.parseAsync();
 }
 main().catch((err) => {

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 = "2.5.0";
+exports.APP_VERSION = "2.6.0";
 exports.ENVIRONMENTS = {
     production: 'https://api.devkitvault.com',
     local: 'http://127.0.0.1:3001',

package/dist/lib/project.js

@@ -0,0 +1,141 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.detectProject = detectProject;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const MAX_WALK = 16;
+const MAX_PACKAGE_JSON_BYTES = 200_000;
+const MAX_SCRIPTS = 40;
+const SECRETISH = /key|secret|token|password|credential/i;
+const LOCKFILES = [
+    { file: 'pnpm-lock.yaml', manager: 'pnpm' },
+    { file: 'yarn.lock', manager: 'yarn' },
+    { file: 'bun.lock', manager: 'bun' },
+    { file: 'bun.lockb', manager: 'bun' },
+    { file: 'package-lock.json', manager: 'npm' },
+];
+function exists(dir, name) {
+    try {
+        return fs_1.default.existsSync(path_1.default.join(dir, name));
+    }
+    catch {
+        return false;
+    }
+}
+function isBlockedDir(dir) {
+    const parts = dir.split(path_1.default.sep);
+    return parts.includes('node_modules') || parts.includes('.git');
+}
+function walkUp(start) {
+    const dirs = [];
+    let dir = path_1.default.resolve(start);
+    const root = path_1.default.parse(dir).root;
+    for (let i = 0; i < MAX_WALK; i++) {
+        dirs.push(dir);
+        if (exists(dir, '.git'))
+            break;
+        if (dir === root)
+            break;
+        const parent = path_1.default.dirname(dir);
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    return dirs;
+}
+function readScriptNames(packageJsonPath) {
+    try {
+        const stat = fs_1.default.statSync(packageJsonPath);
+        if (!stat.isFile() || stat.size > MAX_PACKAGE_JSON_BYTES)
+            return [];
+        const raw = fs_1.default.readFileSync(packageJsonPath, 'utf8');
+        const json = JSON.parse(raw);
+        if (!json || typeof json !== 'object' || Array.isArray(json))
+            return [];
+        const scripts = json.scripts;
+        if (!scripts || typeof scripts !== 'object' || Array.isArray(scripts))
+            return [];
+        const names = [];
+        for (const key of Object.keys(scripts)) {
+            if (!key || key.length > 64)
+                continue;
+            names.push(SECRETISH.test(key) ? '[redacted]' : key);
+            if (names.length >= MAX_SCRIPTS)
+                break;
+        }
+        return [...new Set(names)];
+    }
+    catch {
+        return [];
+    }
+}
+function markersIn(dir) {
+    const found = [];
+    if (exists(dir, '.git'))
+        found.push('git');
+    if (exists(dir, 'package.json'))
+        found.push('node');
+    if (exists(dir, 'requirements.txt') || exists(dir, 'pyproject.toml'))
+        found.push('python');
+    if (exists(dir, 'manage.py'))
+        found.push('django');
+    if (exists(dir, 'go.mod'))
+        found.push('go');
+    if (exists(dir, 'Cargo.toml'))
+        found.push('rust');
+    if (exists(dir, 'Dockerfile'))
+        found.push('docker');
+    if (exists(dir, 'compose.yml')
+        || exists(dir, 'compose.yaml')
+        || exists(dir, 'docker-compose.yml')
+        || exists(dir, 'docker-compose.yaml')) {
+        found.push('compose');
+    }
+    if (exists(dir, 'Makefile') || exists(dir, 'makefile'))
+        found.push('makefile');
+    return found;
+}
+function detectProject(cwd = process.cwd()) {
+    let start = cwd;
+    try {
+        start = fs_1.default.realpathSync(cwd);
+    }
+    catch {
+        start = path_1.default.resolve(cwd);
+    }
+    if (isBlockedDir(start))
+        return undefined;
+    const dirs = walkUp(start).filter((dir) => !isBlockedDir(dir));
+    if (!dirs.length)
+        return undefined;
+    const has = new Set();
+    for (const dir of dirs) {
+        for (const marker of markersIn(dir))
+            has.add(marker);
+    }
+    const pkgDir = dirs.find((dir) => exists(dir, 'package.json'));
+    const scripts = pkgDir ? readScriptNames(path_1.default.join(pkgDir, 'package.json')) : [];
+    let manager;
+    for (const dir of dirs) {
+        const hit = LOCKFILES.find((lock) => exists(dir, lock.file));
+        if (hit) {
+            manager = hit.manager;
+            break;
+        }
+    }
+    if (!manager && scripts.length)
+        manager = 'npm';
+    if (!has.size && !scripts.length && !manager)
+        return undefined;
+    const meta = {};
+    if (manager)
+        meta.manager = manager;
+    if (scripts.length)
+        meta.scripts = scripts;
+    if (has.size)
+        meta.has = [...has];
+    return meta;
+}

package/dist/lib/spinner.js

@@ -0,0 +1,20 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.delayedSpinner = delayedSpinner;
+const ora_1 = __importDefault(require("ora"));
+const DELAY_MS = 120;
+function delayedSpinner(label) {
+    let spinner = null;
+    const timer = setTimeout(() => {
+        spinner = (0, ora_1.default)(label).start();
+    }, DELAY_MS);
+    return {
+        stop() {
+            clearTimeout(timer);
+            spinner?.stop();
+        },
+    };
+}

package/dist/lib/turns.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.trimTurns = trimTurns;
+exports.isExitCommand = isExitCommand;
+const MAX_TURNS = 4;
+const MAX_FIELD = 200;
+function trimTurns(turns) {
+    const out = [];
+    for (const turn of turns) {
+        const query = turn.query.trim().slice(0, MAX_FIELD);
+        const command = turn.command.trim().slice(0, MAX_FIELD);
+        if (!query || !command)
+            continue;
+        out.push({ query, command });
+    }
+    return out.slice(-MAX_TURNS);
+}
+function isExitCommand(line) {
+    const t = line.trim().toLowerCase();
+    return t === 'exit' || t === 'quit' || t === '/exit' || t === '/quit';
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@devkitvault/recall",
-  "version": "1.2.0",
+  "version": "1.2.1",
   "description": "recall CLI — AI terminal copilot with a personal command vault",
   "keywords": [
     "cli",