@getlore/cli 0.7.0 → 0.8.1

package/README.md

@@ -62,7 +62,7 @@ If the MCP host doesn't inherit your shell environment (e.g. Claude Desktop), ad
 | Command | Description |
 |---------|-------------|
 | `lore setup` | Guided configuration wizard |
-| `lore login` | Sign in with email OTP |
+| `lore auth login` | Sign in with email OTP |
 | `lore sync` | Sync all configured sources |
 | `lore sync add` | Add a source directory |
 | `lore search <query>` | Hybrid search |
@@ -77,7 +77,7 @@ If the MCP host doesn't inherit your shell environment (e.g. Claude Desktop), ad
 - **Node.js** 18+
 - **OpenAI API key** (embeddings)
 - **Anthropic API key** (metadata extraction & research)
-- **Lore account** (free — sign up via `lore login`)
+- **Lore account** (free — sign up via `lore auth login`)
 
 ## How Sync Works
 

package/dist/cli/commands/auth.js

@@ -8,6 +8,7 @@
  */
 import path from 'path';
 import { c } from '../colors.js';
+import { getLogo } from '../logo.js';
 // ============================================================================
 // Readline helper
 // ============================================================================
@@ -46,7 +47,7 @@ export function registerAuthCommands(program) {
             const { loadAuthSession } = await import('../../core/auth.js');
             const session = await loadAuthSession();
             console.log(c.success(`Already logged in as ${session?.user.email}`));
-            console.log(c.dim('Run \'lore logout\' first to switch accounts.'));
+            console.log(c.dim('Run \'lore auth logout\' first to switch accounts.'));
             return;
         }
         const email = options.email || await prompt('Email');
@@ -119,7 +120,7 @@ export function registerAuthCommands(program) {
         }
         else {
             callback.abort();
-            console.error(c.error('Login timed out. Try again with \'lore login\'.'));
+            console.error(c.error('Login timed out. Try again with \'lore auth login\'.'));
             process.exit(1);
         }
         if (verifyError || !session) {
@@ -153,7 +154,7 @@ export function registerAuthCommands(program) {
         }
         const session = await getValidSession();
         if (!session) {
-            console.log(c.dim('Not logged in. Run \'lore login\' to sign in.'));
+            console.log(c.dim('Not logged in. Run \'lore auth login\' to sign in.'));
             return;
         }
         console.log(`${c.bold('Email:')} ${session.user.email}`);
@@ -178,14 +179,21 @@ export function registerAuthCommands(program) {
         .option('--data-dir <dir>', 'Data directory path (skip prompt)')
         .option('--code <code>', 'OTP code (for non-interactive login)')
         .option('--skip-login', 'Skip the login step (use if already authenticated)')
+        .option('--sync-path <path>', 'Sync source directory path (non-interactive)')
+        .option('--sync-project <project>', 'Default project for sync source (non-interactive)')
+        .option('--sync-name <name>', 'Name for sync source (non-interactive, defaults to project name)')
         .action(async (options) => {
         const { saveLoreConfig, getLoreConfigPath } = await import('../../core/config.js');
         const { sendOTP, verifyOTP, sessionFromMagicLink, isAuthenticated, loadAuthSession } = await import('../../core/auth.js');
         const { bridgeConfigToEnv } = await import('../../core/config.js');
         // Non-interactive mode: skip prompts when all key flags are provided
         const nonInteractive = !!(options.openaiKey && options.anthropicKey && options.email);
-        console.log(`\n${c.title('Lore Setup Wizard')}`);
-        console.log(`${c.dim('=')}`.repeat(40) + '\n');
+        console.log('');
+        console.log(getLogo());
+        console.log('');
+        console.log(`  ${c.title('Setup Wizard')}`);
+        console.log(`  ${c.dim('━'.repeat(12))}`);
+        console.log('');
         // ── Step 1: Configuration ───────────────────────────────────────
         console.log(c.bold('Step 1: Configuration\n'));
         const { expandPath } = await import('../../sync/config.js');
@@ -479,8 +487,74 @@ export function registerAuthCommands(program) {
             console.log(c.warning(`Skipped — ${err instanceof Error ? err.message : 'could not index welcome document'}`));
             console.log(c.dim('You can add documents later with lore sync\n'));
         }
-        // ── Step 5: Background Daemon ──────────────────────────────────────
-        console.log(c.bold('Step 5: Background Daemon\n'));
+        // ── Step 5: Sync Sources ──────────────────────────────────────────
+        console.log(c.bold('Step 5: Sync Sources\n'));
+        if (nonInteractive) {
+            if (options.syncPath && options.syncProject) {
+                const { addSyncSource } = await import('../../sync/config.js');
+                const syncName = options.syncName || options.syncProject.charAt(0).toUpperCase() + options.syncProject.slice(1);
+                try {
+                    await addSyncSource({
+                        name: syncName,
+                        path: expandPath(options.syncPath),
+                        glob: '**/*',
+                        project: options.syncProject,
+                        enabled: true,
+                    });
+                    console.log(c.success(`Added sync source "${syncName}" → ${options.syncPath}\n`));
+                }
+                catch (err) {
+                    console.log(c.warning(`Could not add sync source: ${err instanceof Error ? err.message : err}\n`));
+                }
+            }
+            else {
+                console.log(c.dim('Skipped (no --sync-path/--sync-project provided).\n'));
+            }
+        }
+        else {
+            console.log(c.dim('Sync sources are directories on your machine that Lore watches'));
+            console.log(c.dim('for new files. When files appear or change, they\'re automatically'));
+            console.log(c.dim('indexed into your knowledge base.\n'));
+            console.log(c.dim('Supported formats: Markdown, JSON, JSONL, plain text, CSV,'));
+            console.log(c.dim('HTML, XML, PDF, and images.\n'));
+            let addMore = true;
+            while (addMore) {
+                const wantsSource = await prompt('Would you like to add a sync source? (y/n)', 'y');
+                if (wantsSource.toLowerCase() !== 'y') {
+                    if (wantsSource.toLowerCase() === 'n') {
+                        console.log(c.dim('You can add sources anytime with: lore sync add\n'));
+                    }
+                    break;
+                }
+                const sourceName = await prompt('Name (e.g., "Meeting Notes")');
+                const sourcePath = await prompt('Path (e.g., ~/Documents/notes)');
+                const sourceProject = await prompt('Default project');
+                if (!sourceName || !sourcePath || !sourceProject) {
+                    console.log(c.warning('Name, path, and project are all required. Skipping.\n'));
+                    break;
+                }
+                try {
+                    const { addSyncSource } = await import('../../sync/config.js');
+                    await addSyncSource({
+                        name: sourceName,
+                        path: expandPath(sourcePath),
+                        glob: '**/*',
+                        project: sourceProject,
+                        enabled: true,
+                    });
+                    console.log(c.success(`Added source "${sourceName}"`));
+                    console.log(c.dim(`  Path: ${sourcePath}`));
+                    console.log(c.dim(`  Glob: **/* (all supported files)\n`));
+                }
+                catch (err) {
+                    console.log(c.warning(`Could not add source: ${err instanceof Error ? err.message : err}\n`));
+                }
+                const another = await prompt('Add another source? (y/n)', 'n');
+                addMore = another.toLowerCase() === 'y';
+            }
+        }
+        // ── Step 6: Background Daemon ──────────────────────────────────────
+        console.log(c.bold('Step 6: Background Daemon\n'));
         const startDaemon = nonInteractive ? 'y' : await prompt('Start background sync daemon? (y/n)', 'y');
         if (startDaemon.toLowerCase() === 'y') {
             try {
@@ -504,8 +578,8 @@ export function registerAuthCommands(program) {
         else {
             console.log(c.dim('You can start it later with: lore sync start\n'));
         }
-        // ── Step 6: Agent Skills ──────────────────────────────────────────
-        console.log(c.bold('Step 6: Agent Skills\n'));
+        // ── Step 7: Agent Skills ──────────────────────────────────────────
+        console.log(c.bold('Step 7: Agent Skills\n'));
         if (nonInteractive) {
             console.log(c.dim('Skipped in non-interactive mode.'));
             console.log(c.dim('Install later with: lore skills install <name>\n'));

package/dist/cli/commands/docs.js

@@ -106,7 +106,7 @@ export function registerDocsCommand(program, defaultDataDir) {
         .option('-d, --data-dir <dir>', 'Data directory', defaultDataDir)
         .option('--no-push', 'Skip git push')
         .action(async (content, options) => {
-        const { handleRetain } = await import('../../mcp/handlers/retain.js');
+        const { handleIngest } = await import('../../mcp/handlers/ingest.js');
         const dataDir = options.dataDir;
         const dbPath = path.join(dataDir, 'lore.lance');
         const validTypes = ['insight', 'decision', 'requirement', 'note'];
@@ -114,21 +114,28 @@ export function registerDocsCommand(program, defaultDataDir) {
             console.error(`Invalid type: ${options.type}. Must be one of: ${validTypes.join(', ')}`);
             process.exit(1);
         }
-        const result = await handleRetain(dbPath, dataDir, {
+        // Map CLI type to source_type
+        const sourceTypeMap = {
+            decision: 'notes',
+            requirement: 'notes',
+            insight: 'notes',
+            note: 'notes',
+        };
+        const result = await handleIngest(dbPath, dataDir, {
             content,
             project: options.project,
-            type: options.type,
-            source_context: options.context,
+            title: `${options.type.charAt(0).toUpperCase() + options.type.slice(1)}: ${content.slice(0, 50)}${content.length > 50 ? '...' : ''}`,
+            source_type: sourceTypeMap[options.type] || 'notes',
             tags: options.tags?.split(',').map((t) => t.trim()),
-        }, { autoPush: options.push !== false });
+        }, { autoPush: options.push !== false, hookContext: { mode: 'cli' } });
         if (result.success) {
-            console.log(`\n✓ ${result.message}`);
+            console.log(`\n✓ Created ${options.type} for project "${options.project}"`);
             console.log(`  ID: ${result.id}`);
             console.log(`  Indexed: ${result.indexed ? 'yes' : 'no'}`);
             console.log(`  Synced: ${result.synced ? 'yes' : 'no'}`);
         }
         else {
-            console.error(`\nFailed to create: ${result.message}`);
+            console.error(`\nFailed to create ${options.type}`);
             process.exit(1);
         }
     });

package/dist/cli/commands/misc.js

@@ -148,7 +148,7 @@ Done! To use this data repository:
    "env": { "LORE_DATA_DIR": "${expandedPath}" }
 
 3. Add sync sources:
-   lore sync add --name "My Notes" --path ~/notes --glob "**/*.md" -p myproject
+   lore sync add --name "My Notes" --path ~/notes -p myproject
 
 Tip: Run 'lore setup' for the full guided experience (config + login + data repo).
 `);

package/dist/cli/commands/sync.js

@@ -4,7 +4,7 @@
  * All sync-related functionality: one-time sync, daemon, watch, sources.
  */
 import { spawn, spawnSync } from 'child_process';
-import { existsSync, readFileSync, writeFileSync, unlinkSync } from 'fs';
+import { existsSync, readFileSync, writeFileSync, unlinkSync, readdirSync } from 'fs';
 import { mkdir } from 'fs/promises';
 import path from 'path';
 import os from 'os';
@@ -598,54 +598,115 @@ export function registerSyncCommand(program, defaultDataDir) {
         .description('List configured sync sources')
         .action(async () => {
         const { loadSyncConfig, getConfigPath } = await import('../../sync/config.js');
-        console.log(`\nSync Sources`);
-        console.log(`============`);
-        console.log(`Config: ${getConfigPath()}\n`);
+        console.log('');
+        console.log(`  ${c.title('Sync Sources')}`);
+        console.log(`  ${c.dim('━'.repeat(12))}`);
+        console.log('');
         const config = await loadSyncConfig();
         if (config.sources.length === 0) {
-            console.log('No sources configured. Run "lore sync add" to add one.');
+            console.log(c.dim('  No sources configured.'));
+            console.log(`  Run ${c.bold('lore sync add')} to add one.`);
+            console.log('');
             return;
         }
         for (const source of config.sources) {
-            const status = source.enabled ? '✓' : '○';
-            console.log(`${status} ${source.name}`);
-            console.log(`    Path: ${source.path}`);
-            console.log(`    Glob: ${source.glob}`);
+            if (source.enabled) {
+                console.log(`  ${c.success('✓')} ${c.bold(source.name)}`);
+            }
+            else {
+                console.log(`  ${c.dim('○')} ${c.dim(source.name + ' (disabled)')}`);
+            }
+            console.log(`    Path:    ${source.path}`);
+            console.log(`    Glob:    ${c.dim(source.glob)}`);
             console.log(`    Project: ${source.project}`);
             console.log('');
         }
+        console.log(c.dim(`  Config: ${getConfigPath()}`));
+        console.log(c.dim(`  Add more with: lore sync add`));
+        console.log('');
     });
     syncCmd
         .command('add')
         .description('Add a new sync source directory')
         .option('-n, --name <name>', 'Source name')
         .option('-p, --path <path>', 'Directory path')
-        .option('-g, --glob <glob>', 'File glob pattern', '**/*.md')
+        .option('-g, --glob <glob>', 'File glob pattern', '**/*')
         .option('--project <project>', 'Default project')
         .action(async (options) => {
-        const { addSyncSource } = await import('../../sync/config.js');
+        const { addSyncSource, expandPath } = await import('../../sync/config.js');
+        // Non-interactive: path and project provided
+        const nonInteractive = !!(options.path && options.project);
+        if (nonInteractive) {
+            const dirBase = path.basename(expandPath(options.path)) || 'Source';
+            const name = options.name || dirBase.charAt(0).toUpperCase() + dirBase.slice(1);
+            try {
+                await addSyncSource({
+                    name,
+                    path: options.path,
+                    glob: options.glob || '**/*',
+                    project: options.project,
+                    enabled: true,
+                });
+                console.log(`\n  ${c.success('✓')} Added "${name}"`);
+                console.log(`    Path:    ${options.path}`);
+                console.log(`    Glob:    ${options.glob || '**/*'}`);
+                console.log(`    Project: ${options.project}`);
+                console.log(`\n  Run ${c.bold("'lore sync'")} to index these files now.\n`);
+            }
+            catch (error) {
+                console.error(`\nError: ${error}`);
+                process.exit(1);
+            }
+            return;
+        }
+        // Interactive flow: path → project → done
         const readline = await import('readline');
         const rl = readline.createInterface({
             input: process.stdin,
             output: process.stdout,
         });
         const ask = (question, defaultValue) => new Promise((resolve) => {
-            const prompt = defaultValue ? `${question} [${defaultValue}]: ` : `${question}: `;
+            const prompt = defaultValue ? `  ${question} [${defaultValue}]: ` : `  ${question}: `;
             rl.question(prompt, (answer) => {
                 resolve(answer.trim() || defaultValue || '');
             });
         });
-        console.log(`\nAdd Sync Source`);
-        console.log(`===============\n`);
-        const name = options.name || await ask('Name (e.g., "Granola Meetings")');
-        const sourcePath = options.path || await ask('Path (e.g., ~/granola-extractor/output)');
-        const glob = options.glob || await ask('Glob pattern', '**/*.md');
-        const project = options.project || await ask('Default project');
-        rl.close();
-        if (!name || !sourcePath || !project) {
-            console.log('\nAll fields are required.');
+        console.log('');
+        // Path
+        const sourcePath = options.path || await ask('Path');
+        if (!sourcePath) {
+            rl.close();
+            console.log(c.warning('\n  Path is required.\n'));
             process.exit(1);
         }
+        // Validate path
+        const resolved = expandPath(sourcePath);
+        if (existsSync(resolved)) {
+            try {
+                const count = readdirSync(resolved).length;
+                console.log(c.success(`  ✓ Found (${count} items)`));
+            }
+            catch {
+                console.log(c.success('  ✓ Directory exists'));
+            }
+        }
+        else {
+            console.log(c.warning('  ⚠ Directory does not exist yet'));
+        }
+        // Derive name from directory basename
+        const dirName = path.basename(resolved) || 'Source';
+        const defaultName = options.name || dirName.charAt(0).toUpperCase() + dirName.slice(1);
+        const defaultProject = options.project || dirName.toLowerCase().replace(/[^a-z0-9-]/g, '-');
+        // Project
+        const project = await ask('Project', defaultProject);
+        if (!project) {
+            rl.close();
+            console.log(c.warning('\n  Project is required.\n'));
+            process.exit(1);
+        }
+        rl.close();
+        const name = options.name || defaultName;
+        const glob = options.glob || '**/*';
         try {
             await addSyncSource({
                 name,
@@ -654,11 +715,17 @@ export function registerSyncCommand(program, defaultDataDir) {
                 project,
                 enabled: true,
             });
-            console.log(`\n✓ Added source "${name}"`);
-            console.log(`\nRun "lore sync" to process files from this source.`);
+            console.log('');
+            console.log(`  ${c.success('✓')} Added "${c.bold(name)}"`);
+            console.log(`    Path:    ${sourcePath}`);
+            console.log(`    Glob:    ${c.dim(glob)}`);
+            console.log(`    Project: ${project}`);
+            console.log('');
+            console.log(`  Run ${c.bold("'lore sync'")} to index these files now.`);
+            console.log('');
         }
         catch (error) {
-            console.error(`\nError: ${error}`);
+            console.error(`\n  ${c.error(String(error))}\n`);
             process.exit(1);
         }
     });

package/dist/cli/logo.d.ts

@@ -0,0 +1,13 @@
+/**
+ * ASCII Art Logo
+ *
+ * Renders the `> lore` brand as ASCII art:
+ * - Yellow chevron (╲ ▸ ╱) on the left
+ * - Cyan bold box-drawing "lore" on the right
+ *
+ * Used in the welcome screen and setup wizard.
+ */
+/**
+ * Returns the colored ASCII logo with tagline.
+ */
+export declare function getLogo(): string;

package/dist/cli/logo.js

@@ -0,0 +1,32 @@
+/**
+ * ASCII Art Logo
+ *
+ * Renders the `> lore` brand as ASCII art:
+ * - Yellow chevron (╲ ▸ ╱) on the left
+ * - Cyan bold box-drawing "lore" on the right
+ *
+ * Used in the welcome screen and setup wizard.
+ */
+import { colors, c } from './colors.js';
+// Yellow chevron          Cyan "lore" in box-drawing
+// ╲     ┃  ┏━┓ ┏━┓ ┏━━
+//  ▸    ┃  ┃ ┃ ┣┳┛ ┣━
+// ╱     ┗━ ┗━┛ ┗┻╸ ┗━━
+function yel(s) {
+    return `${colors.bold}${colors.yellow}${s}${colors.reset}`;
+}
+function lore(s) {
+    return c.title(s);
+}
+/**
+ * Returns the colored ASCII logo with tagline.
+ */
+export function getLogo() {
+    const lines = [
+        `  ${yel('╲')}     ${lore('┃  ┏━┓ ┏━┓ ┏━━')}`,
+        `   ${yel('▸')}    ${lore('┃  ┃ ┃ ┣┳┛ ┣━')}`,
+        `  ${yel('╱')}     ${lore('┗━ ┗━┛ ┗┻╸ ┗━━')}`,
+    ].join('\n');
+    const tagline = c.dim('        Research Knowledge Repository');
+    return `${lines}\n${tagline}`;
+}

package/dist/cli/welcome.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Welcome Screen
+ *
+ * Shown when `lore` is run with no command.
+ * Shows every command, categorized. This IS the help.
+ */
+export declare function showWelcomeScreen(): void;

package/dist/cli/welcome.js

@@ -0,0 +1,57 @@
+/**
+ * Welcome Screen
+ *
+ * Shown when `lore` is run with no command.
+ * Shows every command, categorized. This IS the help.
+ */
+import { c } from './colors.js';
+import { getLogo } from './logo.js';
+export function showWelcomeScreen() {
+    console.log('');
+    console.log(getLogo());
+    console.log('');
+    console.log(`  ${c.bold('Setup:')}`);
+    console.log(`  ${c.dim('•')} lore setup              ${c.dim('— guided first-time setup')}`);
+    console.log(`  ${c.dim('•')} lore auth login         ${c.dim('— sign in with email')}`);
+    console.log(`  ${c.dim('•')} lore auth logout        ${c.dim('— sign out')}`);
+    console.log(`  ${c.dim('•')} lore auth whoami        ${c.dim('— check login status')}`);
+    console.log('');
+    console.log(`  ${c.bold('Search & Research:')}`);
+    console.log(`  ${c.dim('•')} lore search "query"     ${c.dim('— semantic + keyword search')}`);
+    console.log(`  ${c.dim('•')} lore research "query"   ${c.dim('— AI-powered deep research')}`);
+    console.log(`  ${c.dim('•')} lore ask "question"     ${c.dim('— quick question answering')}`);
+    console.log(`  ${c.dim('•')} lore browse             ${c.dim('— interactive terminal browser')}`);
+    console.log('');
+    console.log(`  ${c.bold('Content:')}`);
+    console.log(`  ${c.dim('•')} lore ingest             ${c.dim('— add content (CLI, pipe, or file)')}`);
+    console.log(`  ${c.dim('•')} lore sync               ${c.dim('— sync all sources now')}`);
+    console.log(`  ${c.dim('•')} lore sync add           ${c.dim('— add a source directory')}`);
+    console.log(`  ${c.dim('•')} lore sync list          ${c.dim('— show configured sources')}`);
+    console.log(`  ${c.dim('•')} lore sync enable <name> ${c.dim('— enable a source')}`);
+    console.log(`  ${c.dim('•')} lore sync disable <name>${c.dim(' — disable')}`);
+    console.log(`  ${c.dim('•')} lore sync remove <name> ${c.dim('— remove')}`);
+    console.log('');
+    console.log(`  ${c.bold('Background Sync:')}`);
+    console.log(`  ${c.dim('•')} lore sync start         ${c.dim('— start daemon')}`);
+    console.log(`  ${c.dim('•')} lore sync stop          ${c.dim('— stop daemon')}`);
+    console.log(`  ${c.dim('•')} lore sync restart       ${c.dim('— restart daemon')}`);
+    console.log(`  ${c.dim('•')} lore sync status        ${c.dim('— daemon status')}`);
+    console.log(`  ${c.dim('•')} lore sync logs          ${c.dim('— view daemon logs')}`);
+    console.log(`  ${c.dim('•')} lore sync watch         ${c.dim('— watch in foreground')}`);
+    console.log('');
+    console.log(`  ${c.bold('Documents & Projects:')}`);
+    console.log(`  ${c.dim('•')} lore docs list          ${c.dim('— list indexed documents')}`);
+    console.log(`  ${c.dim('•')} lore docs get <id>      ${c.dim('— view a document')}`);
+    console.log(`  ${c.dim('•')} lore projects           ${c.dim('— list projects')}`);
+    console.log(`  ${c.dim('•')} lore projects archive   ${c.dim('— archive a project')}`);
+    console.log('');
+    console.log(`  ${c.bold('System:')}`);
+    console.log(`  ${c.dim('•')} lore update             ${c.dim('— check for and install updates')}`);
+    console.log(`  ${c.dim('•')} lore skills install     ${c.dim('— install agent integrations')}`);
+    console.log(`  ${c.dim('•')} lore skills list        ${c.dim('— available integrations')}`);
+    console.log(`  ${c.dim('•')} lore mcp                ${c.dim('— start MCP server')}`);
+    console.log(`  ${c.dim('•')} lore init               ${c.dim('— initialize data repository')}`);
+    console.log('');
+    console.log(c.dim(`  Run 'lore <command> --help' for options and flags.`));
+    console.log('');
+}

package/dist/core/auth.js

@@ -80,7 +80,7 @@ export async function verifyOTP(email, token) {
         }
     }
     // All types failed — return the last error
-    return { error: 'Token has expired or is invalid. Request a new code with \'lore login\'.' };
+    return { error: 'Token has expired or is invalid. Request a new code with \'lore auth login\'.' };
 }
 /**
  * Extract session from a magic link URL (Supabase sends these for new signups).

package/dist/core/data-repo.js

@@ -19,7 +19,6 @@ import path from 'path';
 export async function initDataRepo(dirPath) {
     await mkdir(dirPath, { recursive: true });
     await mkdir(path.join(dirPath, 'sources'), { recursive: true });
-    await mkdir(path.join(dirPath, 'retained'), { recursive: true });
     // Create .gitignore if missing
     const gitignorePath = path.join(dirPath, '.gitignore');
     if (!existsSync(gitignorePath)) {
@@ -34,8 +33,7 @@ Your personal knowledge repository for Lore.
 
 ## Structure
 
-- \`sources/\` - Ingested documents
-- \`retained/\` - Explicitly saved insights
+- \`sources/\` - Ingested content
 
 Vector embeddings are stored in Supabase (cloud) for multi-machine access.
 `);

package/dist/core/types.d.ts

@@ -8,7 +8,7 @@
  */
 export type SourceType = string;
 export type SearchMode = 'semantic' | 'keyword' | 'hybrid' | 'regex';
-export type ContentType = 'interview' | 'meeting' | 'conversation' | 'document' | 'note' | 'analysis' | 'survey' | 'research' | 'decision' | 'insight' | 'requirement';
+export type ContentType = 'interview' | 'meeting' | 'conversation' | 'document' | 'note' | 'analysis' | 'survey' | 'research';
 export interface SourceDocument {
     id: string;
     source_type: SourceType;
@@ -154,13 +154,6 @@ export interface SearchArgs {
     limit?: number;
     mode?: SearchMode;
 }
-export interface RetainArgs {
-    content: string;
-    project: string;
-    type: 'insight' | 'decision' | 'requirement' | 'note';
-    source_context?: string;
-    tags?: string[];
-}
 export interface ResearchArgs {
     task: string;
     project?: string;

package/dist/core/vector-store.js

@@ -45,7 +45,7 @@ export async function getSupabase() {
         }
     }
     // Mode 3: No auth
-    throw new Error('Not authenticated. Run \'lore login\' to sign in, or set SUPABASE_SERVICE_KEY for service mode.');
+    throw new Error('Not authenticated. Run \'lore auth login\' to sign in, or set SUPABASE_SERVICE_KEY for service mode.');
 }
 // ============================================================================
 // Index Management (compatibility layer - not needed for Supabase)
@@ -111,9 +111,7 @@ export async function addSource(_dbPath, source, vector, extras) {
     if (extras?.source_name) {
         record.source_name = extras.source_name;
     }
-    const { error } = await client.from('sources').upsert(record, {
-        ignoreDuplicates: true,
-    });
+    const { error } = await client.from('sources').upsert(record);
     if (error) {
         // Duplicate content_hash for this user — document already exists, skip silently
         if (error.code === '23505') {

package/dist/extensions/proposals.d.ts

@@ -2,13 +2,12 @@
  * Proposal-based write system for extensions
  */
 export interface ProposedChange {
-    type: 'create_source' | 'update_source' | 'delete_source' | 'retain_insight' | 'add_tags';
+    type: 'create_source' | 'update_source' | 'delete_source' | 'add_tags';
     title?: string;
     content?: string;
     project?: string;
     sourceId?: string;
     changes?: Record<string, unknown>;
-    insight?: string;
     tags?: string[];
     reason: string;
 }

package/dist/extensions/proposals.js

@@ -7,7 +7,6 @@ import { mkdir, readFile, readdir, writeFile } from 'fs/promises';
 import os from 'os';
 import path from 'path';
 import { handleIngest } from '../mcp/handlers/ingest.js';
-import { handleRetain } from '../mcp/handlers/retain.js';
 import { getDatabase, getSourceById } from '../core/vector-store.js';
 export function getPendingDir() {
     return path.join(os.homedir(), '.config', 'lore', 'pending');
@@ -84,18 +83,6 @@ async function applyProposalChange(proposal, dbPath, dataDir) {
             }, { hookContext: { mode: 'cli' } });
             return;
         }
-        case 'retain_insight': {
-            if (!change.insight) {
-                throw new Error('retain_insight requires insight');
-            }
-            const project = change.project || proposal.extensionName;
-            await handleRetain(dbPath, dataDir, {
-                content: change.insight,
-                project,
-                type: 'insight',
-            }, {});
-            return;
-        }
         case 'update_source': {
             if (!change.sourceId || !change.changes) {
                 throw new Error('update_source requires sourceId and changes');

package/dist/extensions/registry.js

@@ -83,7 +83,7 @@ export function createProposeFunction(extensionName, permissions) {
     return async (change) => {
         // Enforce permissions
         const perms = permissions || {};
-        if (change.type === 'create_source' || change.type === 'retain_insight') {
+        if (change.type === 'create_source') {
             if (!perms.proposeCreate) {
                 throw new Error(`Extension "${extensionName}" does not have permission to propose creating documents. Add permissions.proposeCreate = true to the extension.`);
             }

package/dist/index.js

@@ -34,6 +34,7 @@ import { registerIngestCommand } from './cli/commands/ingest.js';
 import { getExtensionRegistry, getLoreVersionString } from './extensions/registry.js';
 import { bridgeConfigToEnv } from './core/config.js';
 import { expandPath } from './sync/config.js';
+import { showWelcomeScreen } from './cli/welcome.js';
 // Load .env files silently (without the v17 logging)
 function loadEnvFile(filePath, override = false) {
     if (!existsSync(filePath))
@@ -95,6 +96,10 @@ try {
 catch {
     // Extensions not loaded — fine for initial release
 }
+// Default action: show welcome screen when no command is given
+program.action(() => {
+    showWelcomeScreen();
+});
 // Global error handler — show friendly messages instead of stack traces
 process.on('uncaughtException', (error) => {
     console.error(`\nError: ${error.message}`);

package/dist/mcp/handlers/ingest.d.ts

@@ -7,7 +7,7 @@
  */
 interface IngestArgs {
     content: string;
-    title: string;
+    title?: string;
     project: string;
     source_type?: string;
     date?: string;

package/dist/mcp/handlers/ingest.js

@@ -123,9 +123,12 @@ function mapContentType(sourceType) {
     }
 }
 export async function handleIngest(dbPath, dataDir, args, options = {}) {
-    const { content, title, project, source_type: raw_source_type, date, participants = [], tags = [], source_url, source_name, } = args;
+    const { content, project: rawProject, source_type: raw_source_type, date, participants = [], tags = [], source_url, source_name, } = args;
     const { autoPush = true, hookContext } = options;
     const source_type = normalizeSourceType(raw_source_type);
+    const project = rawProject.toLowerCase().trim();
+    // Auto-generate title if not provided
+    const title = args.title || `${source_type.charAt(0).toUpperCase() + source_type.slice(1)}: ${content.slice(0, 50)}${content.length > 50 ? '...' : ''}`;
     // Content hash deduplication — skip everything if already ingested
     const contentHash = createHash('sha256').update(content).digest('hex');
     try {
@@ -170,12 +173,17 @@ export async function handleIngest(dbPath, dataDir, args, options = {}) {
     await writeFile(path.join(sourceDir, 'metadata.json'), JSON.stringify(metadata, null, 2));
     // Save content.md
     await writeFile(path.join(sourceDir, 'content.md'), content);
-    // Extract insights using LLM
+    // Extract insights using LLM (skip for short content)
     let summary = content.slice(0, 200) + (content.length > 200 ? '...' : '');
     let themes = [];
     let quotes = [];
-    try {
-        if (content.trim().length > 100) {
+    const isShortContent = content.trim().length <= 500;
+    if (isShortContent) {
+        // Short content fast path — use content as its own summary, skip LLM extraction
+        summary = content;
+    }
+    else {
+        try {
             const insights = await extractInsights(content, title, id, { contentType });
             summary = insights.summary;
             themes = insights.themes.map((t) => ({ name: t.name, quotes: [] }));
@@ -183,10 +191,10 @@ export async function handleIngest(dbPath, dataDir, args, options = {}) {
             // Save insights.json
             await writeFile(path.join(sourceDir, 'insights.json'), JSON.stringify({ summary, themes, quotes }, null, 2));
         }
-    }
-    catch (error) {
-        console.error('Failed to extract insights:', error);
-        // Continue with basic summary
+        catch (error) {
+            console.error('Failed to extract insights:', error);
+            // Continue with basic summary
+        }
     }
     // Add to vector store immediately
     try {

package/dist/mcp/handlers/list-sources.js

@@ -3,7 +3,8 @@
  */
 import { getAllSources } from '../../core/vector-store.js';
 export async function handleListSources(dbPath, args) {
-    const { project, source_type, limit = 20 } = args;
+    const { project: rawProject, source_type, limit = 20 } = args;
+    const project = rawProject?.toLowerCase().trim();
     const sources = await getAllSources(dbPath, {
         project,
         source_type,

package/dist/mcp/handlers/research-agent.js

@@ -27,9 +27,9 @@ function createLoreToolsServer(dbPath, dataDir, archivedProjects) {
             tool('search', 'Semantic search across all sources in the knowledge repository. Returns summaries with relevant quotes. Use this to find information related to a topic.', {
                 query: z.string().describe('Semantic search query - describe what you\'re looking for'),
                 source_type: z
-                    .enum(['granola', 'claude-code', 'claude-desktop', 'chatgpt', 'markdown', 'document'])
+                    .string()
                     .optional()
-                    .describe('Filter by source type (e.g., "granola" for meeting transcripts)'),
+                    .describe('Filter by source type (e.g., "meeting", "slack", "document")'),
                 content_type: z
                     .enum(['interview', 'meeting', 'conversation', 'document', 'note', 'analysis'])
                     .optional()
@@ -91,6 +91,8 @@ ${quotes}`;
                         .slice(0, 10)
                         .map((q) => `- [${q.speaker || 'unknown'}] "${q.text}"`)
                         .join('\n');
+                    const sourceUrlLine = source.source_url ? `\n**Source URL:** ${source.source_url}` : '';
+                    const sourceNameLine = source.source_name ? `\n**Source:** ${source.source_name}` : '';
                     return {
                         content: [
                             {
@@ -99,7 +101,7 @@ ${quotes}`;
 
 **Type:** ${source.source_type} / ${source.content_type}
 **Created:** ${source.created_at}
-**Projects:** ${source.projects.join(', ') || 'none'}
+**Projects:** ${source.projects.join(', ') || 'none'}${sourceUrlLine}${sourceNameLine}
 
 ## Summary
 ${source.summary}
@@ -122,9 +124,9 @@ ${quotes || 'No quotes extracted'}`,
             // List sources - browse available sources
             tool('list_sources', 'List all sources in the repository. Use this to understand what knowledge is available before searching.', {
                 source_type: z
-                    .enum(['granola', 'claude-code', 'claude-desktop', 'chatgpt', 'markdown', 'document'])
+                    .string()
                     .optional()
-                    .describe('Filter by source type'),
+                    .describe('Filter by source type (e.g., "meeting", "slack", "document")'),
                 project: z.string().optional().describe('Filter to specific project'),
                 limit: z.number().optional().describe('Max results (default 20)'),
             }, async (args) => {

package/dist/mcp/handlers/research.js

@@ -240,7 +240,8 @@ Respond with only the JSON object.`;
     }
 }
 export async function handleResearch(dbPath, dataDir, args, options = {}) {
-    const { task, project, include_sources = true } = args;
+    const { task, project: rawProject, include_sources = true } = args;
+    const project = rawProject?.toLowerCase().trim();
     const { onProgress } = options;
     // Check if we should use agentic mode (default) or simple mode (fallback)
     const useAgenticMode = process.env.LORE_RESEARCH_MODE !== 'simple';

package/dist/mcp/handlers/search.js

@@ -15,7 +15,8 @@ import { generateEmbedding } from '../../core/embedder.js';
 import { searchLocalFiles, getMatchSnippet } from '../../core/local-search.js';
 import { loadArchivedProjects } from './archive-project.js';
 export async function handleSearch(dbPath, dataDir, args) {
-    const { query, project, source_type, content_type, limit = 10, include_archived = false, mode = 'hybrid', } = args;
+    const { query, project: rawProject, source_type, content_type, limit = 10, include_archived = false, mode = 'hybrid', } = args;
+    const project = rawProject?.toLowerCase().trim();
     // Handle regex mode separately - uses local file search
     if (mode === 'regex') {
         return handleRegexSearch(dbPath, dataDir, {

package/dist/mcp/server.js

@@ -19,7 +19,6 @@ import { toolDefinitions } from './tools.js';
 import { handleSearch } from './handlers/search.js';
 import { handleGetSource } from './handlers/get-source.js';
 import { handleListSources } from './handlers/list-sources.js';
-import { handleRetain } from './handlers/retain.js';
 import { handleIngest } from './handlers/ingest.js';
 import { startResearchJob, getResearchJobStatus } from './handlers/research.js';
 import { handleListProjects } from './handlers/list-projects.js';
@@ -136,7 +135,7 @@ async function main() {
     }
     const server = new Server({
         name: 'lore',
-        version: '0.7.0',
+        version: '0.8.1',
     }, {
         capabilities: {
             tools: {},
@@ -219,12 +218,6 @@ async function main() {
                 case 'list_projects':
                     result = await handleListProjects(DB_PATH);
                     break;
-                // Push-based retention
-                case 'retain':
-                    result = await handleRetain(DB_PATH, LORE_DATA_DIR, args, {
-                        autoPush: AUTO_GIT_PUSH,
-                    });
-                    break;
                 // Direct document ingestion
                 case 'ingest':
                     result = await handleIngest(DB_PATH, LORE_DATA_DIR, args, {

package/dist/mcp/tools.js

@@ -86,18 +86,6 @@ const ListSourcesSchema = z.object({
         .describe('Filter by source type (matches the source_type passed during ingest, e.g. "meeting", "slack", "github-issue")'),
     limit: z.number().optional().describe('Max results (default 20)'),
 });
-const RetainSchema = z.object({
-    content: z.string().describe('The insight, decision, or note to retain'),
-    project: z.string().describe('Project this belongs to'),
-    type: z
-        .enum(['insight', 'decision', 'requirement', 'note'])
-        .describe('Type of knowledge being retained'),
-    source_context: z
-        .string()
-        .optional()
-        .describe('Where this came from (e.g., "user interview with Sarah")'),
-    tags: z.array(z.string()).optional().describe('Optional tags for categorization'),
-});
 // ============================================================================
 // Agentic Research Tool
 // ============================================================================
@@ -116,7 +104,7 @@ const ResearchSchema = z.object({
 // ============================================================================
 const IngestSchema = z.object({
     content: z.string().describe('The document content to ingest'),
-    title: z.string().describe('Title for the document'),
+    title: z.string().optional().describe('Title for the document. Auto-generated from content if not provided.'),
     project: z.string().describe('Project this document belongs to'),
     source_type: z
         .string()
@@ -224,18 +212,6 @@ Use this to browse what exists in a project, understand the scope of available k
             properties: {},
         },
     },
-    {
-        name: 'retain',
-        description: `Save a discrete insight, decision, requirement, or note to the knowledge base. These are short, synthesized pieces of knowledge — NOT full documents.
-
-Examples of what to retain:
-- A decision: "We chose JWT over session cookies because of mobile app requirements"
-- An insight: "3 out of 5 users mentioned export speed as their top frustration"
-- A requirement: "Must support SSO for enterprise customers"
-
-USE 'ingest' INSTEAD for full documents, meeting notes, transcripts, or any content longer than a few paragraphs.`,
-        inputSchema: zodToJsonSchema(RetainSchema),
-    },
     // Agentic tool
     {
         name: 'research',
@@ -276,7 +252,7 @@ IDEMPOTENT: Content is deduplicated by SHA256 hash. Calling ingest with identica
 WHAT HAPPENS:
 1. Content hash checked for deduplication
 2. Document saved to disk
-3. LLM extracts summary, themes, and key quotes
+3. LLM extracts summary, themes, and key quotes (skipped for short content ≤500 chars)
 4. Embedding generated for semantic search
 5. Indexed in Supabase for instant retrieval
 
@@ -284,7 +260,7 @@ BEST PRACTICES:
 - Always pass source_url when available (enables citation linking back to the original)
 - Use source_name for human-readable origin context (e.g., "Slack #product-team")
 - source_type is a free-form hint — use whatever describes the content (slack, email, notion, github-issue, etc.)
-- Use 'retain' instead for short discrete insights/decisions (not full documents)`,
+- For short insights, decisions, or notes — just pass the content. Title and source_type are optional.`,
         inputSchema: zodToJsonSchema(IngestSchema),
     },
     // Sync tool
@@ -295,7 +271,7 @@ BEST PRACTICES:
 Phase 1 (Discovery — free, no LLM calls): Scans configured directories, computes content hashes, identifies new files.
 Phase 2 (Processing — only new files): Extracts metadata via LLM, generates embeddings, stores in Supabase.
 
-Use this when source directories have been updated externally, or to refresh the index after manual file changes. Source directories are configured via 'lore sources add' CLI command.
+Use this when source directories have been updated externally, or to refresh the index after manual file changes. Source directories are configured via 'lore sync add' CLI command.
 
 Note: For pushing content from agents, use 'ingest' instead — it's the direct path.`,
         inputSchema: zodToJsonSchema(SyncSchema),

package/dist/sync/config.js

@@ -35,7 +35,7 @@ function getDefaultConfig() {
             {
                 name: 'Example Source',
                 path: '~/Documents/notes',
-                glob: '**/*.md',
+                glob: '**/*',
                 project: 'notes',
                 enabled: false,
             },
@@ -103,6 +103,8 @@ export async function initializeSyncConfig() {
 // ============================================================================
 export async function addSyncSource(source) {
     const config = await loadSyncConfig();
+    // Normalize project name
+    source.project = source.project.toLowerCase().trim();
     // Check for duplicate names
     const existingIndex = config.sources.findIndex(s => s.name === source.name);
     if (existingIndex !== -1) {

package/dist/tui/browse-handlers.js

@@ -963,6 +963,23 @@ function showProjectDeleteConfirm(state, ui, header) {
     ui.deleteConfirm.show();
     ui.screen.render();
 }
+/**
+ * Start an animated spinner in the status bar.
+ * Returns a stop function that clears the interval.
+ */
+function startSpinner(ui, message) {
+    const frames = ['\u280b', '\u2819', '\u2838', '\u2834', '\u2826', '\u2807']; // braille dots spinner
+    let i = 0;
+    const interval = setInterval(() => {
+        ui.statusBar.setContent(` {red-fg}{bold}${frames[i % frames.length]}{/bold}{/red-fg} {black-fg}{bold}${message}{/bold}{/black-fg}`);
+        ui.screen.render();
+        i++;
+    }, 100);
+    // Show first frame immediately
+    ui.statusBar.setContent(` {red-fg}{bold}${frames[0]}{/bold}{/red-fg} {black-fg}{bold}${message}{/bold}{/black-fg}`);
+    ui.screen.render();
+    return () => clearInterval(interval);
+}
 /**
  * Cancel delete operation
  */
@@ -996,8 +1013,7 @@ export async function confirmDelete(state, ui, dbPath, dataDir, project, sourceT
     // Hide dialog and show progress
     ui.deleteConfirm.hide();
     state.mode = 'list';
-    ui.statusBar.setContent(` {yellow-fg}Deleting "${source.title}"...{/yellow-fg}`);
-    ui.screen.render();
+    const stopSpinner = startSpinner(ui, `Deleting "${source.title}"...`);
     try {
         // 1. Delete from Supabase (this also handles chunks cascade)
         const { sourcePath: originalPath } = await deleteSource(dbPath, source.id);
@@ -1037,11 +1053,12 @@ export async function confirmDelete(state, ui, dbPath, dataDir, project, sourceT
                 state.selectedIndex = Math.max(0, state.filtered.length - 1);
             }
         }
+        stopSpinner();
         // Update UI
         updateStatus(ui, state, state.currentProject, sourceType);
         renderList(ui, state);
         renderPreview(ui, state);
-        ui.statusBar.setContent(` {green-fg}Deleted successfully{/green-fg}`);
+        ui.statusBar.setContent(` {black-fg}{bold}Deleted successfully{/bold}{/black-fg}`);
         ui.screen.render();
         // Restore normal status after delay
         setTimeout(() => {
@@ -1050,6 +1067,7 @@ export async function confirmDelete(state, ui, dbPath, dataDir, project, sourceT
         }, 2000);
     }
     catch (error) {
+        stopSpinner();
         ui.statusBar.setContent(` {red-fg}Delete failed: ${error}{/red-fg}`);
         ui.screen.render();
     }
@@ -1058,11 +1076,10 @@ export async function confirmDelete(state, ui, dbPath, dataDir, project, sourceT
  * Confirm and execute project deletion (all documents in a project)
  */
 async function confirmProjectDelete(state, ui, dbPath, dataDir, header, project, sourceType) {
-    // Hide dialog and show progress
+    // Hide dialog and show spinner
     ui.deleteConfirm.hide();
     state.mode = 'list';
-    ui.statusBar.setContent(` {yellow-fg}Deleting ${header.documentCount} documents from "${header.displayName}"...{/yellow-fg}`);
-    ui.screen.render();
+    const stopSpinner = startSpinner(ui, `Deleting ${header.documentCount} documents from "${header.displayName}"...`);
     try {
         // Get all documents in this project
         const docsToDelete = state.filtered.filter(s => {
@@ -1122,15 +1139,16 @@ async function confirmProjectDelete(state, ui, dbPath, dataDir, header, project,
                 state.selectedIndex = Math.max(0, state.filtered.length - 1);
             }
         }
+        stopSpinner();
         // Update UI
         updateStatus(ui, state, state.currentProject, sourceType);
         renderList(ui, state);
         renderPreview(ui, state);
         if (errors.length > 0) {
-            ui.statusBar.setContent(` {yellow-fg}Deleted ${deleted} documents, ${errors.length} failed{/yellow-fg}`);
+            ui.statusBar.setContent(` {black-fg}{bold}Deleted ${deleted} documents, ${errors.length} failed{/bold}{/black-fg}`);
         }
         else {
-            ui.statusBar.setContent(` {green-fg}Deleted ${deleted} documents{/green-fg}`);
+            ui.statusBar.setContent(` {black-fg}{bold}Deleted ${deleted} documents{/bold}{/black-fg}`);
         }
         ui.screen.render();
         // Restore normal status after delay
@@ -1140,6 +1158,7 @@ async function confirmProjectDelete(state, ui, dbPath, dataDir, header, project,
         }, 2000);
     }
     catch (error) {
+        stopSpinner();
         ui.statusBar.setContent(` {red-fg}Delete failed: ${error}{/red-fg}`);
         ui.screen.render();
     }

package/dist/tui/browse-ui.js

@@ -54,6 +54,7 @@ export function createUIComponents() {
             type: 'line',
         },
         style: {
+            bg: 'black',
             border: {
                 fg: 'blue',
             },
@@ -103,6 +104,7 @@ export function createUIComponents() {
             type: 'line',
         },
         style: {
+            bg: 'black',
             border: {
                 fg: 'blue',
             },
@@ -148,6 +150,7 @@ export function createUIComponents() {
             type: 'line',
         },
         style: {
+            bg: 'black',
             border: {
                 fg: 'blue',
             },
@@ -258,7 +261,7 @@ export function createUIComponents() {
         top: 'center',
         left: 'center',
         width: 60,
-        height: 9,
+        height: 11,
         border: {
             type: 'line',
         },
@@ -351,7 +354,7 @@ export function createUIComponents() {
         height: 3,
         label: ' Ask Lore ',
         border: { type: 'line' },
-        style: { border: { fg: 'cyan' }, focus: { border: { fg: 'green' } } },
+        style: { bg: 'black', fg: 'white', border: { fg: 'cyan' }, focus: { border: { fg: 'green' } } },
         hidden: true,
         inputOnFocus: true,
     });
@@ -364,7 +367,7 @@ export function createUIComponents() {
         height: '100%-7',
         label: ' Response ',
         border: { type: 'line' },
-        style: { fg: 'white', border: { fg: 'cyan' } },
+        style: { fg: 'white', bg: 'black', border: { fg: 'cyan' } },
         hidden: true,
         tags: true,
         scrollable: true,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@getlore/cli",
-  "version": "0.7.0",
+  "version": "0.8.1",
   "description": "Research knowledge repository with semantic search, citations, and project lineage tracking",
   "type": "module",
   "main": "dist/index.js",

package/plugins/claude-code/skills/lore/SKILL.md

@@ -36,8 +36,7 @@ After setup, Lore works autonomously.
 | `get_source` | Low | Full document retrieval by ID |
 | `list_sources` | Low | Browse what exists in a project |
 | `list_projects` | Low | Discover available knowledge domains |
-| `retain` | Low | Save discrete insights/decisions |
-| `ingest` | Medium | Push full documents into the knowledge base |
+| `ingest` | Low-Medium | Push content — documents, insights, or decisions |
 | `research` | High | Cross-reference multiple sources, synthesize findings |
 | `sync` | Variable | Refresh from configured source directories |
 
@@ -50,6 +49,11 @@ Use `ingest` to push content into Lore when:
 
 Always pass `source_url` (original URL for linking) and `source_name` (human-readable label like "GitHub PR #123") when available. Ingestion is idempotent — safe to call repeatedly with the same content.
 
+For short insights, decisions, or notes — title and source_type are optional:
+```
+ingest(content: "We chose JWT for auth", project: "auth-system")
+```
+
 ## When to Search
 
 Before making recommendations or answering questions about past work:
@@ -57,13 +61,6 @@ Before making recommendations or answering questions about past work:
 2. Only use `research` if the question genuinely needs cross-referencing multiple sources
 3. Use `get_source(id, include_content: true)` when you need the full text
 
-## When to Retain
-
-Use `retain` for short synthesized knowledge (not full documents):
-- Decisions made during a session
-- Key insights distilled from analysis
-- Requirements extracted from conversations
-
 ## Example: Grounding a Decision
 
 ```
@@ -73,11 +70,9 @@ search("database migration approach", project: "backend-rewrite")
 # 2. If results are relevant, get full context
 get_source("abc-123", include_content: true)
 
-# 3. After making a decision, retain it
-retain(
+# 3. After making a decision, save it
+ingest(
   content: "Chose pgvector over Pinecone for embeddings — lower latency, simpler ops, sufficient scale",
-  project: "backend-rewrite",
-  type: "decision",
-  source_context: "Architecture review session"
+  project: "backend-rewrite"
 )
 ```

package/plugins/codex/SKILL.md

@@ -35,8 +35,7 @@ After setup, Lore works autonomously.
 | `get_source` | Low | Full document retrieval by ID |
 | `list_sources` | Low | Browse what exists in a project |
 | `list_projects` | Low | Discover available knowledge domains |
-| `retain` | Low | Save discrete insights/decisions |
-| `ingest` | Medium | Push full documents into the knowledge base |
+| `ingest` | Low-Medium | Push content — documents, insights, or decisions |
 | `research` | High | Cross-reference multiple sources, synthesize findings |
 | `sync` | Variable | Refresh from configured source directories |
 
@@ -51,6 +50,4 @@ Before making recommendations or answering questions about past work:
 2. Only use `research` for multi-source synthesis (10x more expensive)
 3. Use `get_source(id, include_content: true)` for full text
 
-## When to Retain
-
-Use `retain` for short synthesized knowledge (decisions, insights, requirements) — not full documents.
+For short insights or decisions, just pass the content — title and source_type are optional and auto-generated from content.

package/plugins/gemini/GEMINI.md

@@ -30,8 +30,7 @@ After setup, Lore works autonomously.
 | `get_source` | Low | Full document retrieval by ID |
 | `list_sources` | Low | Browse what exists in a project |
 | `list_projects` | Low | Discover available knowledge domains |
-| `retain` | Low | Save discrete insights/decisions |
-| `ingest` | Medium | Push full documents into the knowledge base |
+| `ingest` | Low-Medium | Push content — documents, insights, or decisions |
 | `research` | High | Cross-reference multiple sources, synthesize findings |
 | `sync` | Variable | Refresh from configured source directories |
 
@@ -46,6 +45,4 @@ Before making recommendations or answering questions about past work:
 2. Only use `research` for multi-source synthesis (10x more expensive)
 3. Use `get_source(id, include_content: true)` for full text
 
-## When to Retain
-
-Use `retain` for short synthesized knowledge (decisions, insights, requirements) — not full documents.
+For short insights or decisions, just pass the content — title and source_type are optional and auto-generated from content.

package/skills/generic-agent.md

@@ -26,7 +26,6 @@ After setup, Lore works autonomously.
 
 - **Sources**: Full documents (meeting notes, interviews, Slack threads, specs, etc.)
 - **Projects**: Organizational grouping for sources
-- **Insights**: Short retained knowledge (decisions, requirements, observations)
 - **Citations**: Every piece of knowledge links back to its original source
 
 ## Tools Reference
@@ -47,10 +46,19 @@ The primary way to add content. Accepts any document with metadata.
 }
 ```
 
+For short insights, decisions, or notes — title and source_type are optional:
+```json
+{
+  "content": "We chose JWT over session cookies because of mobile app requirements",
+  "project": "auth-system"
+}
+```
+
 - **Idempotent**: Duplicate content returns `{deduplicated: true}` with no processing cost.
 - **source_type**: Free-form string. Common values: `meeting`, `interview`, `document`, `notes`, `analysis`, `conversation`, `slack`, `email`, `github-issue`, `notion`.
 - **source_url**: Always pass when available — enables citation linking.
 - **source_name**: Human-readable origin label.
+- Short content (≤500 chars) skips LLM extraction for speed.
 
 ### `search` — Find relevant sources
 Fast lookup. Returns summaries with relevance scores.
@@ -79,18 +87,6 @@ List sources filtered by project or type. Sorted by date (newest first).
 ### `list_projects` — Discover projects
 Lists all projects with source counts and activity dates.
 
-### `retain` — Save discrete knowledge
-For short insights, decisions, or requirements — not full documents.
-
-```json
-{
-  "content": "Users consistently report export takes >30s for large datasets",
-  "project": "my-project",
-  "type": "insight",
-  "source_context": "User interview synthesis — Jan batch"
-}
-```
-
 ### `research` — Deep research with citations
 Runs an internal agent that iteratively searches, reads, and synthesizes findings.
 
@@ -101,7 +97,7 @@ Runs an internal agent that iteratively searches, reads, and synthesizes finding
 }
 ```
 
-**Cost warning**: Makes 3-8 internal LLM calls. Use `search` for simple lookups.
+**Async**: Returns a `job_id` immediately. Poll `research_status` for results (typically 2-8 minutes). Makes 10-30 internal LLM calls. Use `search` for simple lookups.
 
 ### `sync` — Refresh from source directories
 Scans configured directories for new files. Use `ingest` for agent-pushed content instead.
@@ -114,6 +110,6 @@ Excludes from default search. Only use when explicitly requested.
 1. **Search before you answer**: If a question might have documented context, search Lore first.
 2. **Ingest what matters**: After meaningful conversations or when processing external content, ingest it.
 3. **Always pass source_url**: Enables citation linking back to the original.
-4. **Use retain for synthesis**: After analyzing multiple sources, retain the key insight.
+4. **Ingest handles both long and short content**: For short insights, decisions, or notes — just pass the content. Title and source_type are optional.
 5. **Prefer search over research**: `search` is 10x cheaper. Only use `research` for multi-source synthesis.
 6. **Cite your sources**: When presenting Lore results, reference the source title and date.

package/skills/openclaw.md

@@ -37,12 +37,12 @@ Before answering questions about past decisions, user feedback, project history,
 
 3. **Use `get_source`** with `include_content=true` when you need the full original text of a specific document.
 
-## When to Retain Insights
+## Short Content
 
-Use `retain` (not `ingest`) for short, discrete pieces of knowledge:
-- Key decisions: "We chose X because Y"
-- Synthesized insights: "3/5 users mentioned Z as their top issue"
-- Requirements: "Must support SSO for enterprise"
+For short insights, decisions, or notes — title and source_type are optional:
+```
+ingest(content: "We chose X because Y", project: "my-project")
+```
 
 ## Citation Best Practices