clementine-agent 1.0.1 → 1.0.2

package/dist/agent/assistant.d.ts

@@ -26,6 +26,10 @@ export interface ProjectMeta {
 export declare function findProjectByName(query: string): ProjectMeta | null;
 /** Get all linked projects. */
 export declare function getLinkedProjects(): ProjectMeta[];
+/** Add a project to the linked projects list. */
+export declare function addProject(projectPath: string, description?: string, keywords?: string[]): void;
+/** Remove a project from the linked projects list. Returns true if removed. */
+export declare function removeProject(projectPath: string): boolean;
 export declare class PersonalAssistant {
     static readonly MAX_SESSION_EXCHANGES = 40;
     private sessions;
@@ -50,6 +54,8 @@ export declare class PersonalAssistant {
     /** Per-session stall nudge — set after a query shows stall signals, consumed on the next query. */
     private stallNudges;
     private _compactedSessions;
+    /** Last auto-matched project per session — exposed for CLI display. */
+    private _lastMatchedProject;
     /** Hot correction buffer — explicit behavioral corrections applied before nightly SI. */
     private hotCorrections;
     constructor();
@@ -113,6 +119,11 @@ export declare class PersonalAssistant {
      * No LLM call — uses buildLocalSummary for instant summarization.
      */
     private compactContext;
+    /**
+     * Expire sessions inactive for more than 24 hours.
+     * Called periodically from chat() to prevent unbounded map growth.
+     */
+    private expireOldSessions;
     /**
      * Build an instant local summary from in-memory exchange history.
      * No LLM call — returns immediately. Used during session rotation
@@ -220,6 +231,8 @@ export declare class PersonalAssistant {
         content: string;
     }>>;
     clearSession(sessionKey: string): void;
+    /** Get the last auto-matched project for a session (for CLI display). */
+    getLastMatchedProject(sessionKey: string): ProjectMeta | null;
     getProfileManager(): AgentManager;
 }
 //# sourceMappingURL=assistant.d.ts.map

package/dist/agent/assistant.js

@@ -469,6 +469,33 @@ export function findProjectByName(query) {
 export function getLinkedProjects() {
     return loadProjectsMeta();
 }
+/** Add a project to the linked projects list. */
+export function addProject(projectPath, description, keywords) {
+    const resolved = path.resolve(projectPath);
+    const projects = loadProjectsMeta();
+    // Avoid duplicates
+    if (projects.some(p => path.resolve(p.path) === resolved))
+        return;
+    const entry = { path: resolved };
+    if (description)
+        entry.description = description;
+    if (keywords?.length)
+        entry.keywords = keywords;
+    projects.push(entry);
+    fs.writeFileSync(PROJECTS_META_FILE, JSON.stringify(projects, null, 4));
+    _projectsMetaCacheTime = 0; // invalidate cache
+}
+/** Remove a project from the linked projects list. Returns true if removed. */
+export function removeProject(projectPath) {
+    const resolved = path.resolve(projectPath);
+    const projects = loadProjectsMeta();
+    const filtered = projects.filter(p => path.resolve(p.path) !== resolved);
+    if (filtered.length === projects.length)
+        return false;
+    fs.writeFileSync(PROJECTS_META_FILE, JSON.stringify(filtered, null, 4));
+    _projectsMetaCacheTime = 0; // invalidate cache
+    return true;
+}
 // ── PersonalAssistant ───────────────────────────────────────────────
 export class PersonalAssistant {
     static MAX_SESSION_EXCHANGES = MAX_SESSION_EXCHANGES;
@@ -494,6 +521,8 @@ export class PersonalAssistant {
     /** Per-session stall nudge — set after a query shows stall signals, consumed on the next query. */
     stallNudges = new Map();
     _compactedSessions = new Set();
+    /** Last auto-matched project per session — exposed for CLI display. */
+    _lastMatchedProject = new Map();
     /** Hot correction buffer — explicit behavioral corrections applied before nightly SI. */
     hotCorrections = [];
     constructor() {
@@ -1482,6 +1511,8 @@ You have a cost budget per message — not a hard turn limit. Work until the tas
         const key = sessionKey ?? undefined;
         this._lastUserMessage = text;
         let sessionRotated = false;
+        // Periodic cleanup: expire all sessions older than 24 hours
+        this.expireOldSessions();
         // Expire old sessions (4 hours)
         if (key && this.sessionTimestamps.has(key)) {
             const elapsed = Date.now() - this.sessionTimestamps.get(key).getTime();
@@ -1735,6 +1766,9 @@ You have a cost budget per message — not a hard turn limit. Work until the tas
         setSendPolicy(profile?.sendPolicy ?? null, profile?.slug ?? null);
         setAgentDir(profile?.agentDir ?? null);
         setInteractionSource(inferInteractionSource(sessionKey));
+        // Track the matched project for CLI display
+        if (sessionKey)
+            this._lastMatchedProject.set(sessionKey, matchedProject);
         if (matchedProject) {
             logger.info({ project: matchedProject.path }, 'Auto-matched project from message');
             const projName = path.basename(matchedProject.path);
@@ -2133,13 +2167,17 @@ You have a cost budget per message — not a hard turn limit. Work until the tas
             return;
         // Build compaction block for working memory
         const exchangeCount = this.exchangeCounts.get(sessionKey) ?? 0;
+        const COMPACTION_START = '<!-- COMPACTION_START -->';
+        const COMPACTION_END = '<!-- COMPACTION_END -->';
         const compactionBlock = [
+            COMPACTION_START,
             `## Session Compaction (auto-generated)`,
             `Session ${sessionKey} compacted at ${exchangeCount} exchanges.`,
             ``,
             summary,
             ``,
             `*Continue from where this conversation left off.*`,
+            COMPACTION_END,
         ].join('\n');
         // Write to working memory so the next session picks it up via system prompt
         try {
@@ -2150,11 +2188,23 @@ You have a cost budget per message — not a hard turn limit. Work until the tas
             const existing = fs.existsSync(compactionWmFile)
                 ? fs.readFileSync(compactionWmFile, 'utf-8')
                 : '';
-            // Replace any prior compaction block, or append
-            const compactionRegex = /## Session Compaction \(auto-generated\)[\s\S]*?\*Continue from where this conversation left off\.\*/;
-            const updated = compactionRegex.test(existing)
-                ? existing.replace(compactionRegex, compactionBlock)
-                : existing.trimEnd() + '\n\n' + compactionBlock;
+            // Replace any prior compaction block (try new sentinel format first, then legacy)
+            const sentinelRegex = /<!-- COMPACTION_START -->[\s\S]*?<!-- COMPACTION_END -->/;
+            const legacyRegex = /## Session Compaction \(auto-generated\)[\s\S]*?\*Continue from where this conversation left off\.\*/;
+            let updated;
+            if (sentinelRegex.test(existing)) {
+                updated = existing.replace(sentinelRegex, compactionBlock);
+            }
+            else if (legacyRegex.test(existing)) {
+                updated = existing.replace(legacyRegex, compactionBlock);
+            }
+            else {
+                updated = existing.trimEnd() + '\n\n' + compactionBlock;
+            }
+            // Size guard: if working memory exceeds 10KB, keep only the compaction block
+            if (Buffer.byteLength(updated) > 10_240) {
+                updated = compactionBlock;
+            }
             fs.writeFileSync(compactionWmFile, updated);
         }
         catch {
@@ -2164,8 +2214,24 @@ You have a cost budget per message — not a hard turn limit. Work until the tas
         // The working memory summary will provide continuity
         this.sessions.delete(sessionKey);
         this.exchangeCounts.set(sessionKey, 0);
+        this.lastExchanges.delete(sessionKey);
+        this.sessionTimestamps.delete(sessionKey);
+        this.stallNudges.delete(sessionKey);
         this.saveSessions();
     }
+    /**
+     * Expire sessions inactive for more than 24 hours.
+     * Called periodically from chat() to prevent unbounded map growth.
+     */
+    expireOldSessions() {
+        const MAX_AGE_MS = 24 * 60 * 60 * 1000;
+        const now = Date.now();
+        for (const [key, ts] of this.sessionTimestamps) {
+            if (now - ts.getTime() > MAX_AGE_MS) {
+                this.clearSession(key);
+            }
+        }
+    }
     // ── Session Summarization ─────────────────────────────────────────
     /**
      * Build an instant local summary from in-memory exchange history.
@@ -3879,8 +3945,13 @@ You have a cost budget per message — not a hard turn limit. Work until the tas
         this.sessionTimestamps.delete(sessionKey);
         this.lastExchanges.delete(sessionKey);
         this.stallNudges.delete(sessionKey);
+        this._lastMatchedProject.delete(sessionKey);
         this.saveSessions();
     }
+    /** Get the last auto-matched project for a session (for CLI display). */
+    getLastMatchedProject(sessionKey) {
+        return this._lastMatchedProject.get(sessionKey) ?? null;
+    }
     getProfileManager() {
         return this.profileManager;
     }

package/dist/cli/chat.js

@@ -202,6 +202,11 @@ export async function cmdChat(opts) {
             const response = await gateway.handleMessage(sessionKey, effectiveText, undefined, oneOffModel);
             // Clear "thinking..." line
             process.stdout.write('\x1b[2K\r');
+            // Show active project if auto-matched
+            const matched = gateway.getLastMatchedProject(sessionKey);
+            if (matched) {
+                console.log(`\x1b[0;90m[project: ${path.basename(matched.path)}]\x1b[0m`);
+            }
             console.log(renderMarkdown(response));
             console.log();
         }

package/dist/cli/index.js

@@ -1295,6 +1295,131 @@ configCmd
     .command('list')
     .description('List all config values')
     .action(cmdConfigList);
+configCmd
+    .command('edit')
+    .description('Open .env in your editor')
+    .action(() => {
+    if (!existsSync(ENV_PATH)) {
+        console.log('  No .env file found. Run: clementine config setup');
+        process.exit(1);
+    }
+    const editor = process.env.EDITOR || process.env.VISUAL || 'vi';
+    try {
+        execSync(`${editor} "${ENV_PATH}"`, { stdio: 'inherit' });
+    }
+    catch {
+        console.error(`  Failed to open editor: ${editor}`);
+    }
+});
+// ── Memory commands ─────────────────────────────────────────────────
+const memoryCmd = program
+    .command('memory')
+    .description('Search and manage memory');
+memoryCmd
+    .command('search <query>')
+    .description('Search memory (full-text)')
+    .option('-n, --limit <n>', 'Max results', '10')
+    .action(async (query, opts) => {
+    const DIM = '\x1b[0;90m';
+    const BOLD = '\x1b[1m';
+    const CYAN = '\x1b[0;36m';
+    const RESET = '\x1b[0m';
+    try {
+        const { MemoryStore } = await import('../memory/store.js');
+        const VAULT_DIR = path.join(BASE_DIR, 'vault');
+        const DB_PATH = path.join(VAULT_DIR, '.memory.db');
+        const store = new MemoryStore(DB_PATH, VAULT_DIR);
+        const results = store.searchFts(query, parseInt(opts.limit, 10));
+        if (results.length === 0) {
+            console.log(`  No results for "${query}".`);
+            return;
+        }
+        console.log();
+        for (const r of results) {
+            const source = r.sourceFile ? path.basename(r.sourceFile) : 'unknown';
+            const section = r.section || '';
+            const snippet = r.content.replace(/\n/g, ' ').slice(0, 120);
+            console.log(`  ${BOLD}${source}${RESET}${section ? ` › ${CYAN}${section}${RESET}` : ''}`);
+            console.log(`  ${DIM}${snippet}${snippet.length >= 120 ? '…' : ''}${RESET}`);
+            console.log();
+        }
+    }
+    catch (err) {
+        console.error(`  Error searching memory: ${err}`);
+    }
+});
+// ── Projects commands ───────────────────────────────────────────────
+const projectsCmd = program
+    .command('projects')
+    .description('Manage linked projects');
+projectsCmd
+    .command('list')
+    .description('Show all linked projects')
+    .action(async () => {
+    const DIM = '\x1b[0;90m';
+    const BOLD = '\x1b[1m';
+    const RESET = '\x1b[0m';
+    try {
+        const { getLinkedProjects } = await import('../agent/assistant.js');
+        const projects = getLinkedProjects();
+        if (projects.length === 0) {
+            console.log('  No projects linked. Use: clementine projects add <path>');
+            return;
+        }
+        console.log();
+        for (const p of projects) {
+            console.log(`  ${BOLD}${path.basename(p.path)}${RESET}`);
+            console.log(`  ${DIM}${p.path}${RESET}`);
+            if (p.description)
+                console.log(`  ${p.description}`);
+            if (p.keywords?.length)
+                console.log(`  ${DIM}Keywords: ${p.keywords.join(', ')}${RESET}`);
+            console.log();
+        }
+    }
+    catch (err) {
+        console.error(`  Error listing projects: ${err}`);
+    }
+});
+projectsCmd
+    .command('add <path>')
+    .description('Link a project directory')
+    .option('-d, --description <desc>', 'Project description')
+    .option('-k, --keywords <kw>', 'Comma-separated keywords')
+    .action(async (projectPath, opts) => {
+    const resolved = path.resolve(projectPath);
+    if (!existsSync(resolved) || !statSync(resolved).isDirectory()) {
+        console.error(`  Not a directory: ${resolved}`);
+        process.exit(1);
+    }
+    try {
+        const { addProject } = await import('../agent/assistant.js');
+        const keywords = opts.keywords?.split(',').map(k => k.trim()).filter(Boolean);
+        addProject(resolved, opts.description, keywords);
+        console.log(`  Linked: ${resolved}`);
+    }
+    catch (err) {
+        console.error(`  Error adding project: ${err}`);
+    }
+});
+projectsCmd
+    .command('remove <path>')
+    .description('Unlink a project directory')
+    .action(async (projectPath) => {
+    const resolved = path.resolve(projectPath);
+    try {
+        const { removeProject } = await import('../agent/assistant.js');
+        if (removeProject(resolved)) {
+            console.log(`  Removed: ${resolved}`);
+        }
+        else {
+            console.log(`  Not found: ${resolved}`);
+        }
+    }
+    catch (err) {
+        console.error(`  Error removing project: ${err}`);
+    }
+});
 // ── Update command ──────────────────────────────────────────────────
 async function cmdUpdate(options) {
     const DIM = '\x1b[0;90m';

package/dist/gateway/router.d.ts

@@ -196,6 +196,11 @@ export declare class Gateway {
         memoryCount: number;
     };
     clearSession(sessionKey: string): void;
+    /** Get the last auto-matched project for a session. */
+    getLastMatchedProject(sessionKey: string): {
+        path: string;
+        description?: string;
+    } | null;
     /** Evict stale session entries (no activity in 48h, no active lock). */
     evictStaleSessions(): number;
     /** Get all active session provenance entries (for dashboard/monitoring). */

package/dist/gateway/router.js

@@ -1195,6 +1195,10 @@ export class Gateway {
         this.assistant.clearSession(sessionKey);
         this.sessions.delete(sessionKey);
     }
+    /** Get the last auto-matched project for a session. */
+    getLastMatchedProject(sessionKey) {
+        return this.assistant.getLastMatchedProject(sessionKey);
+    }
     /** Evict stale session entries (no activity in 48h, no active lock). */
     evictStaleSessions() {
         const cutoff = Date.now() - 48 * 60 * 60 * 1000;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clementine-agent",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "description": "Clementine — Personal AI Assistant (TypeScript)",
   "type": "module",
   "main": "dist/index.js",