@mnemonik/scanner 1.0.0

package/dist/client.d.ts

@@ -0,0 +1,32 @@
+export interface ScanPushFile {
+    path: string;
+    hash: string;
+    chunks: Array<{
+        content: string;
+        startLine: number;
+        endLine: number;
+        chunkType: string;
+        language: string;
+        contentHash: string;
+        metadata: {
+            fileName: string;
+            extension: string;
+            size: number;
+        };
+    }>;
+}
+export interface ScanPushPayload {
+    projectId: string;
+    files: ScanPushFile[];
+}
+export declare class MnemonikClient {
+    private serverUrl;
+    private apiKey;
+    constructor(serverUrl: string, apiKey: string);
+    private request;
+    getStatus(projectId: string): Promise<Map<string, string>>;
+    pushFiles(projectId: string, files: ScanPushFile[]): Promise<{
+        success: boolean;
+    }>;
+    healthCheck(): Promise<boolean>;
+}

package/dist/client.js

@@ -0,0 +1,72 @@
+export class MnemonikClient {
+    serverUrl;
+    apiKey;
+    constructor(serverUrl, apiKey) {
+        this.serverUrl = serverUrl;
+        this.apiKey = apiKey;
+    }
+    async request(path, body, retries = 3) {
+        const url = `${this.serverUrl}${path}`;
+        for (let attempt = 0; attempt <= retries; attempt++) {
+            try {
+                const res = await fetch(url, {
+                    method: 'POST',
+                    headers: {
+                        'Content-Type': 'application/json',
+                        Authorization: `Bearer ${this.apiKey}`,
+                    },
+                    body: JSON.stringify(body),
+                });
+                if (!res.ok) {
+                    const text = await res.text().catch(() => 'Unknown error');
+                    if (res.status === 401 || res.status === 403) {
+                        throw new Error(`Auth failed (${res.status}). Check your API key.`);
+                    }
+                    if (res.status === 503 && attempt < retries) {
+                        const retryAfter = parseInt(res.headers.get('Retry-After') || '5', 10);
+                        await new Promise((r) => setTimeout(r, retryAfter * 1000));
+                        continue;
+                    }
+                    if (res.status >= 500 && attempt < retries) {
+                        await new Promise((r) => setTimeout(r, 2000 * (attempt + 1)));
+                        continue;
+                    }
+                    throw new Error(`${res.status} ${res.statusText}: ${text}`);
+                }
+                return res.json();
+            }
+            catch (err) {
+                if (attempt < retries && err.message?.includes('fetch failed')) {
+                    await new Promise((r) => setTimeout(r, 2000 * (attempt + 1)));
+                    continue;
+                }
+                throw err;
+            }
+        }
+        throw new Error(`Request to ${path} failed after ${retries} retries`);
+    }
+    async getStatus(projectId) {
+        const result = await this.request('/api/v1/scan/status', { projectId });
+        return new Map(result.files.map((f) => [f.path, f.hash]));
+    }
+    async pushFiles(projectId, files) {
+        const batchSize = 25;
+        for (let i = 0; i < files.length; i += batchSize) {
+            const batch = files.slice(i, i + batchSize);
+            await this.request('/api/v1/scan/push', { projectId, files: batch });
+        }
+        return { success: true };
+    }
+    async healthCheck() {
+        try {
+            const res = await fetch(`${this.serverUrl}/api/v1/health`, {
+                headers: { Authorization: `Bearer ${this.apiKey}` },
+            });
+            return res.ok;
+        }
+        catch {
+            return false;
+        }
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}

package/dist/daemon.d.ts

@@ -0,0 +1,25 @@
+export interface DaemonConfig {
+    projectId: string;
+    projectRoot: string;
+    serverUrl: string;
+    apiKey: string;
+}
+export declare class ScannerDaemon {
+    private config;
+    private client;
+    private scanner;
+    private watcher;
+    private pendingRetries;
+    private retryTimer;
+    constructor(config: DaemonConfig);
+    start(): Promise<void>;
+    private waitForServer;
+    getProjectRoot(): string;
+    getProjectId(): string;
+    stop(): Promise<void>;
+    private startRetryLoop;
+    private initialScan;
+    private startWatching;
+    private handleChanges;
+    private groupChunksByFile;
+}

package/dist/daemon.js

@@ -0,0 +1,181 @@
+import { createHash } from 'crypto';
+import { readFile } from 'fs/promises';
+import { join } from 'path';
+import { CodeScanner } from '@mnemonik/shared';
+import { MnemonikClient } from './client.js';
+import { FileWatcher } from './watcher.js';
+export class ScannerDaemon {
+    config;
+    client;
+    scanner;
+    watcher = null;
+    pendingRetries = new Set();
+    retryTimer = null;
+    constructor(config) {
+        this.config = config;
+        this.client = new MnemonikClient(config.serverUrl, config.apiKey);
+        this.scanner = new CodeScanner();
+    }
+    async start() {
+        console.log(`[scanner] Starting daemon for project: ${this.config.projectId}`);
+        console.log(`[scanner] Server: ${this.config.serverUrl}`);
+        console.log(`[scanner] Root: ${this.config.projectRoot}`);
+        await this.waitForServer();
+        await this.initialScan();
+        await this.startWatching();
+    }
+    async waitForServer() {
+        let logged = false;
+        let delay = 3000;
+        const maxDelay = 30000;
+        const maxRetries = 20;
+        for (let attempt = 0; attempt < maxRetries; attempt++) {
+            if (await this.client.healthCheck()) {
+                if (logged)
+                    console.log('[scanner] Server is back');
+                else
+                    console.log('[scanner] Server health check passed');
+                return;
+            }
+            if (!logged) {
+                console.log('[scanner] Server unreachable, waiting...');
+                logged = true;
+            }
+            const jitter = delay * (0.5 + Math.random());
+            await new Promise((r) => setTimeout(r, jitter));
+            delay = Math.min(delay * 1.5, maxDelay);
+        }
+        throw new Error(`Server unreachable after ${maxRetries} attempts`);
+    }
+    getProjectRoot() {
+        return this.config.projectRoot;
+    }
+    getProjectId() {
+        return this.config.projectId;
+    }
+    async stop() {
+        this.watcher?.stop();
+        if (this.retryTimer)
+            clearInterval(this.retryTimer);
+        console.log('[scanner] Daemon stopped');
+    }
+    startRetryLoop() {
+        if (this.retryTimer)
+            return;
+        console.log(`[scanner] ${this.pendingRetries.size} file(s) queued for retry`);
+        this.retryTimer = setInterval(async () => {
+            if (this.pendingRetries.size === 0) {
+                if (this.retryTimer)
+                    clearInterval(this.retryTimer);
+                this.retryTimer = null;
+                return;
+            }
+            const files = [...this.pendingRetries];
+            this.pendingRetries.clear();
+            await this.handleChanges(files);
+        }, 10_000);
+        this.retryTimer.unref();
+    }
+    async initialScan() {
+        console.log('[scanner] Starting initial scan...');
+        const startTime = Date.now();
+        const chunks = await this.scanner.scanDirectory(this.config.projectRoot);
+        console.log(`[scanner] Scanned ${chunks.length} chunks locally`);
+        const serverHashes = await this.client.getStatus(this.config.projectId);
+        console.log(`[scanner] Server knows ${serverHashes.size} files`);
+        const files = await this.groupChunksByFile(chunks);
+        const filesToPush = files.filter((f) => {
+            const serverHash = serverHashes.get(f.path);
+            return !serverHash || serverHash !== f.hash;
+        });
+        if (filesToPush.length === 0) {
+            console.log('[scanner] All files up to date, nothing to push');
+        }
+        else {
+            console.log(`[scanner] Pushing ${filesToPush.length} changed files...`);
+            await this.client.pushFiles(this.config.projectId, filesToPush);
+            console.log(`[scanner] Push complete`);
+        }
+        const duration = ((Date.now() - startTime) / 1000).toFixed(1);
+        console.log(`[scanner] Initial scan complete in ${duration}s`);
+    }
+    async startWatching() {
+        this.watcher = new FileWatcher(this.config.projectRoot, (changedFiles) => this.handleChanges(changedFiles), 500);
+        await this.watcher.start();
+    }
+    async handleChanges(changedFiles) {
+        try {
+            const absPaths = changedFiles.map((rel) => join(this.config.projectRoot, rel));
+            const chunks = await this.scanner.scanFiles(absPaths, this.config.projectRoot);
+            if (chunks.length === 0)
+                return;
+            const files = await this.groupChunksByFile(chunks);
+            // Push in batches, only retrying files from failed batches
+            const batchSize = 25;
+            const succeededPaths = new Set();
+            let hadFailure = false;
+            for (let i = 0; i < files.length; i += batchSize) {
+                const batch = files.slice(i, i + batchSize);
+                try {
+                    await this.client.pushFiles(this.config.projectId, batch);
+                    for (const f of batch)
+                        succeededPaths.add(f.path);
+                }
+                catch {
+                    hadFailure = true;
+                    for (const f of batch)
+                        this.pendingRetries.add(f.path);
+                }
+            }
+            if (succeededPaths.size > 0) {
+                console.log(`[scanner] Pushed ${succeededPaths.size} changed file(s): ${[...succeededPaths].join(', ')}`);
+            }
+            if (hadFailure) {
+                console.warn(`[scanner] ${this.pendingRetries.size} file(s) failed, queued for retry`);
+                this.startRetryLoop();
+            }
+        }
+        catch (err) {
+            console.error('[scanner] Error handling changes:', err);
+        }
+    }
+    async groupChunksByFile(chunks) {
+        const fileMap = new Map();
+        for (const chunk of chunks) {
+            const key = chunk.filePath;
+            if (!fileMap.has(key)) {
+                fileMap.set(key, {
+                    path: key,
+                    hash: '',
+                    chunks: [],
+                });
+            }
+            const file = fileMap.get(key);
+            file.chunks.push({
+                content: chunk.content,
+                startLine: chunk.startLine,
+                endLine: chunk.endLine,
+                chunkType: chunk.chunkType,
+                language: chunk.language,
+                contentHash: chunk.contentHash,
+                metadata: chunk.metadata,
+            });
+        }
+        for (const file of fileMap.values()) {
+            try {
+                const absPath = join(this.config.projectRoot, file.path);
+                const raw = await readFile(absPath, 'utf-8');
+                file.hash = createHash('sha256').update(raw).digest('hex');
+            }
+            catch (err) {
+                console.warn(`[scanner] Cannot read ${file.path} for hashing, using chunk-based fallback`, {
+                    error: err instanceof Error ? err.message : String(err),
+                });
+                const allContent = file.chunks.map((c) => c.content).join('\n');
+                file.hash = createHash('sha256').update(allContent).digest('hex');
+            }
+        }
+        return Array.from(fileMap.values());
+    }
+}
+//# sourceMappingURL=daemon.js.map

package/dist/daemon.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"daemon.js","sourceRoot":"","sources":["../src/daemon.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AACpC,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,WAAW,EAAkB,MAAM,kBAAkB,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAqB,MAAM,aAAa,CAAC;AAChE,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAS3C,MAAM,OAAO,aAAa;IAOJ;IANZ,MAAM,CAAiB;IACvB,OAAO,CAAc;IACrB,OAAO,GAAuB,IAAI,CAAC;IACnC,cAAc,GAAgB,IAAI,GAAG,EAAE,CAAC;IACxC,UAAU,GAA0C,IAAI,CAAC;IAEjE,YAAoB,MAAoB;QAApB,WAAM,GAAN,MAAM,CAAc;QACtC,IAAI,CAAC,MAAM,GAAG,IAAI,cAAc,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;QAClE,IAAI,CAAC,OAAO,GAAG,IAAI,WAAW,EAAE,CAAC;IACnC,CAAC;IAED,KAAK,CAAC,KAAK;QACT,OAAO,CAAC,GAAG,CAAC,0CAA0C,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC;QAC/E,OAAO,CAAC,GAAG,CAAC,qBAAqB,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC;QAC1D,OAAO,CAAC,GAAG,CAAC,mBAAmB,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC;QAE1D,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC;QAC3B,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QACzB,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC;IAC7B,CAAC;IAEO,KAAK,CAAC,aAAa;QACzB,IAAI,MAAM,GAAG,KAAK,CAAC;QACnB,IAAI,KAAK,GAAG,IAAI,CAAC;QACjB,MAAM,QAAQ,GAAG,KAAK,CAAC;QACvB,MAAM,UAAU,GAAG,EAAE,CAAC;QAEtB,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,GAAG,UAAU,EAAE,OAAO,EAAE,EAAE,CAAC;YACtD,IAAI,MAAM,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,EAAE,CAAC;gBACpC,IAAI,MAAM;oBAAE,OAAO,CAAC,GAAG,CAAC,0BAA0B,CAAC,CAAC;;oBAC/C,OAAO,CAAC,GAAG,CAAC,sCAAsC,CAAC,CAAC;gBACzD,OAAO;YACT,CAAC;YACD,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,OAAO,CAAC,GAAG,CAAC,0CAA0C,CAAC,CAAC;gBACxD,MAAM,GAAG,IAAI,CAAC;YAChB,CAAC;YACD,MAAM,MAAM,GAAG,KAAK,GAAG,CAAC,GAAG,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;YAC7C,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;YAChD,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,GAAG,GAAG,EAAE,QAAQ,CAAC,CAAC;QAC1C,CAAC;QAED,MAAM,IAAI,KAAK,CAAC,4BAA4B,UAAU,WAAW,CAAC,CAAC;IACrE,CAAC;IAED,cAAc;QACZ,OAAO,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC;IACjC,CAAC;IAED,YAAY;QACV,OAAO,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC;IAC/B,CAAC;IAED,KAAK,CAAC,IAAI;QACR,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC;QACrB,IAAI,IAAI,CAAC,UAAU;YAAE,aAAa,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACpD,OAAO,CAAC,GAAG,CAAC,0BAA0B,CAAC,CAAC;IAC1C,CAAC;IAEO,cAAc;QACpB,IAAI,IAAI,CAAC,UAAU;YAAE,OAAO;QAC5B,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,CAAC,cAAc,CAAC,IAAI,2BAA2B,CAAC,CAAC;QAC9E,IAAI,CAAC,UAAU,GAAG,WAAW,CAAC,KAAK,IAAI,EAAE;YACvC,IAAI,IAAI,CAAC,cAAc,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;gBACnC,IAAI,IAAI,CAAC,UAAU;oBAAE,aAAa,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;gBACpD,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;gBACvB,OAAO;YACT,CAAC;YACD,MAAM,KAAK,GAAG,CAAC,GAAG,IAAI,CAAC,cAAc,CAAC,CAAC;YACvC,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,CAAC;YAC5B,MAAM,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;QAClC,CAAC,EAAE,MAAM,CAAC,CAAC;QACX,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;IAC1B,CAAC;IAEO,KAAK,CAAC,WAAW;QACvB,OAAO,CAAC,GAAG,CAAC,oCAAoC,CAAC,CAAC;QAClD,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAE7B,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;QACzE,OAAO,CAAC,GAAG,CAAC,qBAAqB,MAAM,CAAC,MAAM,iBAAiB,CAAC,CAAC;QAEjE,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QACxE,OAAO,CAAC,GAAG,CAAC,0BAA0B,YAAY,CAAC,IAAI,QAAQ,CAAC,CAAC;QAEjE,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC;QACnD,MAAM,WAAW,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE;YACrC,MAAM,UAAU,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YAC5C,OAAO,CAAC,UAAU,IAAI,UAAU,KAAK,CAAC,CAAC,IAAI,CAAC;QAC9C,CAAC,CAAC,CAAC;QAEH,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC7B,OAAO,CAAC,GAAG,CAAC,iDAAiD,CAAC,CAAC;QACjE,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,qBAAqB,WAAW,CAAC,MAAM,mBAAmB,CAAC,CAAC;YACxE,MAAM,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;YAChE,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC;QACzC,CAAC;QAED,MAAM,QAAQ,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QAC9D,OAAO,CAAC,GAAG,CAAC,sCAAsC,QAAQ,GAAG,CAAC,CAAC;IACjE,CAAC;IAEO,KAAK,CAAC,aAAa;QACzB,IAAI,CAAC,OAAO,GAAG,IAAI,WAAW,CAC5B,IAAI,CAAC,MAAM,CAAC,WAAW,EACvB,CAAC,YAAY,EAAE,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,YAAY,CAAC,EAClD,GAAG,CACJ,CAAC;QACF,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;IAC7B,CAAC;IAEO,KAAK,CAAC,aAAa,CAAC,YAAsB;QAChD,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,CAAC;YAC/E,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;YAE/E,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO;YAEhC,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC;YAEnD,2DAA2D;YAC3D,MAAM,SAAS,GAAG,EAAE,CAAC;YACrB,MAAM,cAAc,GAAG,IAAI,GAAG,EAAU,CAAC;YACzC,IAAI,UAAU,GAAG,KAAK,CAAC;YAEvB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,IAAI,SAAS,EAAE,CAAC;gBACjD,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC,CAAC;gBAC5C,IAAI,CAAC;oBACH,MAAM,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;oBAC1D,KAAK,MAAM,CAAC,IAAI,KAAK;wBAAE,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;gBACpD,CAAC;gBAAC,MAAM,CAAC;oBACP,UAAU,GAAG,IAAI,CAAC;oBAClB,KAAK,MAAM,CAAC,IAAI,KAAK;wBAAE,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;gBACzD,CAAC;YACH,CAAC;YAED,IAAI,cAAc,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;gBAC5B,OAAO,CAAC,GAAG,CACT,oBAAoB,cAAc,CAAC,IAAI,qBAAqB,CAAC,GAAG,cAAc,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC7F,CAAC;YACJ,CAAC;YACD,IAAI,UAAU,EAAE,CAAC;gBACf,OAAO,CAAC,IAAI,CAAC,aAAa,IAAI,CAAC,cAAc,CAAC,IAAI,mCAAmC,CAAC,CAAC;gBACvF,IAAI,CAAC,cAAc,EAAE,CAAC;YACxB,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,KAAK,CAAC,mCAAmC,EAAE,GAAG,CAAC,CAAC;QAC1D,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,iBAAiB,CAAC,MAAmB;QACjD,MAAM,OAAO,GAAG,IAAI,GAAG,EAAwB,CAAC;QAEhD,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,MAAM,GAAG,GAAG,KAAK,CAAC,QAAQ,CAAC;YAC3B,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;gBACtB,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE;oBACf,IAAI,EAAE,GAAG;oBACT,IAAI,EAAE,EAAE;oBACR,MAAM,EAAE,EAAE;iBACX,CAAC,CAAC;YACL,CAAC;YACD,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAE,CAAC;YAC/B,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;gBACf,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,SAAS,EAAE,KAAK,CAAC,SAAS;gBAC1B,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,SAAS,EAAE,KAAK,CAAC,SAAS;gBAC1B,QAAQ,EAAE,KAAK,CAAC,QAAQ;gBACxB,WAAW,EAAE,KAAK,CAAC,WAAW;gBAC9B,QAAQ,EAAE,KAAK,CAAC,QAAQ;aACzB,CAAC,CAAC;QACL,CAAC;QAED,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;YACpC,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;gBACzD,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;gBAC7C,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAC7D,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,OAAO,CAAC,IAAI,CAAC,yBAAyB,IAAI,CAAC,IAAI,0CAA0C,EAAE;oBACzF,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;iBACxD,CAAC,CAAC;gBACH,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAChE,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACpE,CAAC;QACH,CAAC;QAED,OAAO,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACtC,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,138 @@
+#!/usr/bin/env node
+import { readFile, unlink, mkdir } from 'fs/promises';
+import { join } from 'path';
+import { homedir } from 'os';
+import { ScannerDaemon } from './daemon.js';
+const DEFAULT_SERVER = 'https://api.mnemonik.dev';
+const MNEMONIK_DIR = join(homedir(), '.mnemonik');
+const DAEMONS_DIR = join(MNEMONIK_DIR, 'daemons');
+const LOGS_DIR = join(MNEMONIK_DIR, 'logs');
+const MAX_LOG_SIZE = 5 * 1024 * 1024; // 5MB
+function parseCliArgs() {
+    const args = process.argv.slice(2);
+    let server;
+    let key;
+    for (let i = 0; i < args.length; i++) {
+        if (args[i] === '--server' && args[i + 1])
+            server = args[++i];
+        else if (args[i] === '--key' && args[i + 1])
+            key = args[++i];
+    }
+    return { server, key };
+}
+async function readProjectId() {
+    const configPath = join(process.cwd(), '.mnemonik.json');
+    try {
+        const raw = await readFile(configPath, 'utf-8');
+        const parsed = JSON.parse(raw);
+        if (typeof parsed.projectId === 'string' && parsed.projectId.length > 0) {
+            return parsed.projectId;
+        }
+        console.error('[mnemonik] .mnemonik.json missing "projectId" field.');
+        process.exit(1);
+    }
+    catch {
+        console.error('[mnemonik] No .mnemonik.json found in current directory.\n' +
+            '  Run session_bootstrap from your IDE to create one.');
+        process.exit(1);
+    }
+}
+function lockFile(projectId) {
+    return join(DAEMONS_DIR, `${projectId}.pid`);
+}
+function logFile(projectId) {
+    return join(LOGS_DIR, `${projectId}.log`);
+}
+async function rotateLogIfNeeded(path) {
+    try {
+        const { stat: fsStat, rename } = await import('fs/promises');
+        const s = await fsStat(path);
+        if (s.size > MAX_LOG_SIZE) {
+            await rename(path, path + '.old');
+        }
+    }
+    catch {
+        // Log file doesn't exist yet
+    }
+}
+async function acquireLock(lockPath, retried = false) {
+    try {
+        const { open: fsOpen } = await import('fs/promises');
+        const { constants } = await import('fs');
+        const fd = await fsOpen(lockPath, constants.O_CREAT | constants.O_EXCL | constants.O_WRONLY, 0o644);
+        await fd.writeFile(String(process.pid));
+        await fd.close();
+        return true;
+    }
+    catch (err) {
+        if (err.code !== 'EEXIST')
+            return false;
+        const existing = await readFile(lockPath, 'utf-8').catch(() => null);
+        if (existing) {
+            const pid = parseInt(existing.trim(), 10);
+            try {
+                process.kill(pid, 0);
+                return false; // Process alive, lock is valid
+            }
+            catch {
+                // Holder is dead — remove stale lock and retry once
+            }
+        }
+        if (retried)
+            return false;
+        await unlink(lockPath).catch(() => { });
+        return acquireLock(lockPath, true);
+    }
+}
+async function releaseLock(lockPath) {
+    await unlink(lockPath).catch(() => { });
+}
+async function main() {
+    const cli = parseCliArgs();
+    const projectId = await readProjectId();
+    const server = cli.server || DEFAULT_SERVER;
+    const apiKey = cli.key;
+    if (!apiKey) {
+        console.error('[mnemonik] Missing API key.\n' +
+            '  Usage: mnemonik-scanner --key <api-key>\n' +
+            '  The API key is provided by _scannerSetup in session_bootstrap.');
+        process.exit(1);
+    }
+    // Ensure directories exist
+    await mkdir(DAEMONS_DIR, { recursive: true });
+    await mkdir(LOGS_DIR, { recursive: true });
+    const lock = lockFile(projectId);
+    const log = logFile(projectId);
+    await rotateLogIfNeeded(log);
+    const locked = await acquireLock(lock);
+    if (!locked) {
+        console.log(`[mnemonik] Scanner already running for project ${projectId}. Exiting.`);
+        process.exit(0);
+    }
+    const projectRoot = process.cwd();
+    const daemon = new ScannerDaemon({
+        projectId,
+        projectRoot,
+        serverUrl: server,
+        apiKey,
+    });
+    const shutdown = async () => {
+        console.log('\n[mnemonik] Shutting down...');
+        await daemon.stop();
+        await releaseLock(lock);
+        process.exit(0);
+    };
+    process.on('SIGINT', shutdown);
+    process.on('SIGTERM', shutdown);
+    try {
+        await daemon.start();
+        console.log('[mnemonik] Watching for changes.');
+    }
+    catch (err) {
+        console.error(`[mnemonik] ${err.message}`);
+        await releaseLock(lock);
+        process.exit(1);
+    }
+}
+main();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/watcher.d.ts

@@ -0,0 +1,14 @@
+export type ChangeHandler = (changedFiles: string[]) => void;
+export declare class FileWatcher {
+    private rootPath;
+    private onChange;
+    private watchers;
+    private pendingFiles;
+    private flushTimer;
+    private debounceMs;
+    constructor(rootPath: string, onChange: ChangeHandler, debounceMs?: number);
+    start(): Promise<void>;
+    stop(): void;
+    private scheduleFlush;
+    private watchDir;
+}

package/dist/watcher.js

@@ -0,0 +1,88 @@
+import { watch } from 'fs';
+import { join, relative } from 'path';
+import { readdir } from 'fs/promises';
+const SKIP_DIRS = new Set([
+    'node_modules',
+    '.git',
+    'dist',
+    'build',
+    '.next',
+    '.nuxt',
+    '.output',
+    '__pycache__',
+    '.venv',
+    'venv',
+    '.tox',
+    'target',
+    '.cache',
+    'coverage',
+    '.turbo',
+    '.vercel',
+    '.svelte-kit',
+]);
+export class FileWatcher {
+    rootPath;
+    onChange;
+    watchers = [];
+    pendingFiles = new Set();
+    flushTimer = null;
+    debounceMs;
+    constructor(rootPath, onChange, debounceMs = 500) {
+        this.rootPath = rootPath;
+        this.onChange = onChange;
+        this.debounceMs = debounceMs;
+    }
+    async start() {
+        await this.watchDir(this.rootPath);
+        console.log(`[scanner] Watching ${this.rootPath} for changes`);
+    }
+    stop() {
+        for (const w of this.watchers) {
+            w.close();
+        }
+        this.watchers = [];
+        if (this.flushTimer) {
+            clearTimeout(this.flushTimer);
+            this.flushTimer = null;
+        }
+        this.pendingFiles.clear();
+    }
+    scheduleFlush() {
+        if (this.flushTimer)
+            clearTimeout(this.flushTimer);
+        this.flushTimer = setTimeout(() => {
+            this.flushTimer = null;
+            if (this.pendingFiles.size === 0)
+                return;
+            const batch = [...this.pendingFiles];
+            this.pendingFiles.clear();
+            this.onChange(batch);
+        }, this.debounceMs);
+    }
+    async watchDir(dir) {
+        const dirName = dir.split('/').pop() ?? '';
+        if (SKIP_DIRS.has(dirName))
+            return;
+        try {
+            const watcher = watch(dir, { persistent: true }, (_event, filename) => {
+                if (!filename)
+                    return;
+                const fullPath = join(dir, filename);
+                const relPath = relative(this.rootPath, fullPath);
+                this.pendingFiles.add(relPath);
+                this.scheduleFlush();
+            });
+            this.watchers.push(watcher);
+            const entries = await readdir(dir, { withFileTypes: true });
+            for (const entry of entries) {
+                if (entry.isDirectory() && !SKIP_DIRS.has(entry.name)) {
+                    await this.watchDir(join(dir, entry.name));
+                }
+            }
+        }
+        catch {
+            // Permission denied or inaccessible directory
+        }
+    }
+}
+//# sourceMappingURL=watcher.js.map

package/dist/watcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"watcher.js","sourceRoot":"","sources":["../src/watcher.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,21 @@
+{
+  "name": "@mnemonik/scanner",
+  "version": "1.0.0",
+  "description": "Mnemonik scanner daemon - automatic codebase indexing",
+  "type": "module",
+  "bin": {
+    "mnemonik-scanner": "./dist/index.js"
+  },
+  "main": "dist/index.js",
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js"
+  },
+  "dependencies": {
+    "@mnemonik/shared": "1.0.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.3.3",
+    "@types/node": "^22.0.0"
+  }
+}

package/src/client.ts

@@ -0,0 +1,99 @@
+export interface ScanPushFile {
+  path: string;
+  hash: string;
+  chunks: Array<{
+    content: string;
+    startLine: number;
+    endLine: number;
+    chunkType: string;
+    language: string;
+    contentHash: string;
+    metadata: {
+      fileName: string;
+      extension: string;
+      size: number;
+    };
+  }>;
+}
+
+export interface ScanPushPayload {
+  projectId: string;
+  files: ScanPushFile[];
+}
+
+export class MnemonikClient {
+  constructor(
+    private serverUrl: string,
+    private apiKey: string
+  ) {}
+
+  private async request<T>(path: string, body: unknown, retries = 3): Promise<T> {
+    const url = `${this.serverUrl}${path}`;
+    for (let attempt = 0; attempt <= retries; attempt++) {
+      try {
+        const res = await fetch(url, {
+          method: 'POST',
+          headers: {
+            'Content-Type': 'application/json',
+            Authorization: `Bearer ${this.apiKey}`,
+          },
+          body: JSON.stringify(body),
+        });
+
+        if (!res.ok) {
+          const text = await res.text().catch(() => 'Unknown error');
+          if (res.status === 401 || res.status === 403) {
+            throw new Error(`Auth failed (${res.status}). Check your API key.`);
+          }
+          if (res.status === 503 && attempt < retries) {
+            const retryAfter = parseInt(res.headers.get('Retry-After') || '5', 10);
+            await new Promise((r) => setTimeout(r, retryAfter * 1000));
+            continue;
+          }
+          if (res.status >= 500 && attempt < retries) {
+            await new Promise((r) => setTimeout(r, 2000 * (attempt + 1)));
+            continue;
+          }
+          throw new Error(`${res.status} ${res.statusText}: ${text}`);
+        }
+
+        return res.json() as Promise<T>;
+      } catch (err) {
+        if (attempt < retries && (err as Error).message?.includes('fetch failed')) {
+          await new Promise((r) => setTimeout(r, 2000 * (attempt + 1)));
+          continue;
+        }
+        throw err;
+      }
+    }
+    throw new Error(`Request to ${path} failed after ${retries} retries`);
+  }
+
+  async getStatus(projectId: string): Promise<Map<string, string>> {
+    const result = await this.request<{ files: Array<{ path: string; hash: string }> }>(
+      '/api/v1/scan/status',
+      { projectId }
+    );
+    return new Map(result.files.map((f) => [f.path, f.hash]));
+  }
+
+  async pushFiles(projectId: string, files: ScanPushFile[]): Promise<{ success: boolean }> {
+    const batchSize = 25;
+    for (let i = 0; i < files.length; i += batchSize) {
+      const batch = files.slice(i, i + batchSize);
+      await this.request('/api/v1/scan/push', { projectId, files: batch });
+    }
+    return { success: true };
+  }
+
+  async healthCheck(): Promise<boolean> {
+    try {
+      const res = await fetch(`${this.serverUrl}/api/v1/health`, {
+        headers: { Authorization: `Bearer ${this.apiKey}` },
+      });
+      return res.ok;
+    } catch {
+      return false;
+    }
+  }
+}

package/src/daemon.ts

@@ -0,0 +1,207 @@
+import { createHash } from 'crypto';
+import { readFile } from 'fs/promises';
+import { join } from 'path';
+import { CodeScanner, type CodeChunk } from '@mnemonik/shared';
+import { MnemonikClient, type ScanPushFile } from './client.js';
+import { FileWatcher } from './watcher.js';
+
+export interface DaemonConfig {
+  projectId: string;
+  projectRoot: string;
+  serverUrl: string;
+  apiKey: string;
+}
+
+export class ScannerDaemon {
+  private client: MnemonikClient;
+  private scanner: CodeScanner;
+  private watcher: FileWatcher | null = null;
+  private pendingRetries: Set<string> = new Set();
+  private retryTimer: ReturnType<typeof setInterval> | null = null;
+
+  constructor(private config: DaemonConfig) {
+    this.client = new MnemonikClient(config.serverUrl, config.apiKey);
+    this.scanner = new CodeScanner();
+  }
+
+  async start(): Promise<void> {
+    console.log(`[scanner] Starting daemon for project: ${this.config.projectId}`);
+    console.log(`[scanner] Server: ${this.config.serverUrl}`);
+    console.log(`[scanner] Root: ${this.config.projectRoot}`);
+
+    await this.waitForServer();
+    await this.initialScan();
+    await this.startWatching();
+  }
+
+  private async waitForServer(): Promise<void> {
+    let logged = false;
+    let delay = 3000;
+    const maxDelay = 30000;
+    const maxRetries = 20;
+
+    for (let attempt = 0; attempt < maxRetries; attempt++) {
+      if (await this.client.healthCheck()) {
+        if (logged) console.log('[scanner] Server is back');
+        else console.log('[scanner] Server health check passed');
+        return;
+      }
+      if (!logged) {
+        console.log('[scanner] Server unreachable, waiting...');
+        logged = true;
+      }
+      const jitter = delay * (0.5 + Math.random());
+      await new Promise((r) => setTimeout(r, jitter));
+      delay = Math.min(delay * 1.5, maxDelay);
+    }
+
+    throw new Error(`Server unreachable after ${maxRetries} attempts`);
+  }
+
+  getProjectRoot(): string {
+    return this.config.projectRoot;
+  }
+
+  getProjectId(): string {
+    return this.config.projectId;
+  }
+
+  async stop(): Promise<void> {
+    this.watcher?.stop();
+    if (this.retryTimer) clearInterval(this.retryTimer);
+    console.log('[scanner] Daemon stopped');
+  }
+
+  private startRetryLoop(): void {
+    if (this.retryTimer) return;
+    console.log(`[scanner] ${this.pendingRetries.size} file(s) queued for retry`);
+    this.retryTimer = setInterval(async () => {
+      if (this.pendingRetries.size === 0) {
+        if (this.retryTimer) clearInterval(this.retryTimer);
+        this.retryTimer = null;
+        return;
+      }
+      const files = [...this.pendingRetries];
+      this.pendingRetries.clear();
+      await this.handleChanges(files);
+    }, 10_000);
+    this.retryTimer.unref();
+  }
+
+  private async initialScan(): Promise<void> {
+    console.log('[scanner] Starting initial scan...');
+    const startTime = Date.now();
+
+    const chunks = await this.scanner.scanDirectory(this.config.projectRoot);
+    console.log(`[scanner] Scanned ${chunks.length} chunks locally`);
+
+    const serverHashes = await this.client.getStatus(this.config.projectId);
+    console.log(`[scanner] Server knows ${serverHashes.size} files`);
+
+    const files = await this.groupChunksByFile(chunks);
+    const filesToPush = files.filter((f) => {
+      const serverHash = serverHashes.get(f.path);
+      return !serverHash || serverHash !== f.hash;
+    });
+
+    if (filesToPush.length === 0) {
+      console.log('[scanner] All files up to date, nothing to push');
+    } else {
+      console.log(`[scanner] Pushing ${filesToPush.length} changed files...`);
+      await this.client.pushFiles(this.config.projectId, filesToPush);
+      console.log(`[scanner] Push complete`);
+    }
+
+    const duration = ((Date.now() - startTime) / 1000).toFixed(1);
+    console.log(`[scanner] Initial scan complete in ${duration}s`);
+  }
+
+  private async startWatching(): Promise<void> {
+    this.watcher = new FileWatcher(
+      this.config.projectRoot,
+      (changedFiles) => this.handleChanges(changedFiles),
+      500
+    );
+    await this.watcher.start();
+  }
+
+  private async handleChanges(changedFiles: string[]): Promise<void> {
+    try {
+      const absPaths = changedFiles.map((rel) => join(this.config.projectRoot, rel));
+      const chunks = await this.scanner.scanFiles(absPaths, this.config.projectRoot);
+
+      if (chunks.length === 0) return;
+
+      const files = await this.groupChunksByFile(chunks);
+
+      // Push in batches, only retrying files from failed batches
+      const batchSize = 25;
+      const succeededPaths = new Set<string>();
+      let hadFailure = false;
+
+      for (let i = 0; i < files.length; i += batchSize) {
+        const batch = files.slice(i, i + batchSize);
+        try {
+          await this.client.pushFiles(this.config.projectId, batch);
+          for (const f of batch) succeededPaths.add(f.path);
+        } catch {
+          hadFailure = true;
+          for (const f of batch) this.pendingRetries.add(f.path);
+        }
+      }
+
+      if (succeededPaths.size > 0) {
+        console.log(
+          `[scanner] Pushed ${succeededPaths.size} changed file(s): ${[...succeededPaths].join(', ')}`
+        );
+      }
+      if (hadFailure) {
+        console.warn(`[scanner] ${this.pendingRetries.size} file(s) failed, queued for retry`);
+        this.startRetryLoop();
+      }
+    } catch (err) {
+      console.error('[scanner] Error handling changes:', err);
+    }
+  }
+
+  private async groupChunksByFile(chunks: CodeChunk[]): Promise<ScanPushFile[]> {
+    const fileMap = new Map<string, ScanPushFile>();
+
+    for (const chunk of chunks) {
+      const key = chunk.filePath;
+      if (!fileMap.has(key)) {
+        fileMap.set(key, {
+          path: key,
+          hash: '',
+          chunks: [],
+        });
+      }
+      const file = fileMap.get(key)!;
+      file.chunks.push({
+        content: chunk.content,
+        startLine: chunk.startLine,
+        endLine: chunk.endLine,
+        chunkType: chunk.chunkType,
+        language: chunk.language,
+        contentHash: chunk.contentHash,
+        metadata: chunk.metadata,
+      });
+    }
+
+    for (const file of fileMap.values()) {
+      try {
+        const absPath = join(this.config.projectRoot, file.path);
+        const raw = await readFile(absPath, 'utf-8');
+        file.hash = createHash('sha256').update(raw).digest('hex');
+      } catch (err) {
+        console.warn(`[scanner] Cannot read ${file.path} for hashing, using chunk-based fallback`, {
+          error: err instanceof Error ? err.message : String(err),
+        });
+        const allContent = file.chunks.map((c) => c.content).join('\n');
+        file.hash = createHash('sha256').update(allContent).digest('hex');
+      }
+    }
+
+    return Array.from(fileMap.values());
+  }
+}

package/src/index.ts

@@ -0,0 +1,159 @@
+#!/usr/bin/env node
+
+import { readFile, unlink, mkdir } from 'fs/promises';
+import { join } from 'path';
+import { homedir } from 'os';
+import { ScannerDaemon } from './daemon.js';
+
+const DEFAULT_SERVER = 'https://api.mnemonik.dev';
+const MNEMONIK_DIR = join(homedir(), '.mnemonik');
+const DAEMONS_DIR = join(MNEMONIK_DIR, 'daemons');
+const LOGS_DIR = join(MNEMONIK_DIR, 'logs');
+const MAX_LOG_SIZE = 5 * 1024 * 1024; // 5MB
+
+function parseCliArgs(): { server?: string; key?: string } {
+  const args = process.argv.slice(2);
+  let server: string | undefined;
+  let key: string | undefined;
+
+  for (let i = 0; i < args.length; i++) {
+    if (args[i] === '--server' && args[i + 1]) server = args[++i]!;
+    else if (args[i] === '--key' && args[i + 1]) key = args[++i]!;
+  }
+
+  return { server, key };
+}
+
+async function readProjectId(): Promise<string> {
+  const configPath = join(process.cwd(), '.mnemonik.json');
+  try {
+    const raw = await readFile(configPath, 'utf-8');
+    const parsed = JSON.parse(raw) as Record<string, unknown>;
+    if (typeof parsed.projectId === 'string' && parsed.projectId.length > 0) {
+      return parsed.projectId;
+    }
+    console.error('[mnemonik] .mnemonik.json missing "projectId" field.');
+    process.exit(1);
+  } catch {
+    console.error(
+      '[mnemonik] No .mnemonik.json found in current directory.\n' +
+        '  Run session_bootstrap from your IDE to create one.'
+    );
+    process.exit(1);
+  }
+}
+
+function lockFile(projectId: string): string {
+  return join(DAEMONS_DIR, `${projectId}.pid`);
+}
+
+function logFile(projectId: string): string {
+  return join(LOGS_DIR, `${projectId}.log`);
+}
+
+async function rotateLogIfNeeded(path: string): Promise<void> {
+  try {
+    const { stat: fsStat, rename } = await import('fs/promises');
+    const s = await fsStat(path);
+    if (s.size > MAX_LOG_SIZE) {
+      await rename(path, path + '.old');
+    }
+  } catch {
+    // Log file doesn't exist yet
+  }
+}
+
+async function acquireLock(lockPath: string, retried = false): Promise<boolean> {
+  try {
+    const { open: fsOpen } = await import('fs/promises');
+    const { constants } = await import('fs');
+    const fd = await fsOpen(
+      lockPath,
+      constants.O_CREAT | constants.O_EXCL | constants.O_WRONLY,
+      0o644
+    );
+    await fd.writeFile(String(process.pid));
+    await fd.close();
+    return true;
+  } catch (err: unknown) {
+    if ((err as NodeJS.ErrnoException).code !== 'EEXIST') return false;
+
+    const existing = await readFile(lockPath, 'utf-8').catch(() => null);
+    if (existing) {
+      const pid = parseInt(existing.trim(), 10);
+      try {
+        process.kill(pid, 0);
+        return false; // Process alive, lock is valid
+      } catch {
+        // Holder is dead — remove stale lock and retry once
+      }
+    }
+    if (retried) return false;
+    await unlink(lockPath).catch(() => {});
+    return acquireLock(lockPath, true);
+  }
+}
+
+async function releaseLock(lockPath: string): Promise<void> {
+  await unlink(lockPath).catch(() => {});
+}
+
+async function main(): Promise<void> {
+  const cli = parseCliArgs();
+  const projectId = await readProjectId();
+  const server = cli.server || DEFAULT_SERVER;
+  const apiKey = cli.key;
+
+  if (!apiKey) {
+    console.error(
+      '[mnemonik] Missing API key.\n' +
+        '  Usage: mnemonik-scanner --key <api-key>\n' +
+        '  The API key is provided by _scannerSetup in session_bootstrap.'
+    );
+    process.exit(1);
+  }
+
+  // Ensure directories exist
+  await mkdir(DAEMONS_DIR, { recursive: true });
+  await mkdir(LOGS_DIR, { recursive: true });
+
+  const lock = lockFile(projectId);
+  const log = logFile(projectId);
+
+  await rotateLogIfNeeded(log);
+
+  const locked = await acquireLock(lock);
+  if (!locked) {
+    console.log(`[mnemonik] Scanner already running for project ${projectId}. Exiting.`);
+    process.exit(0);
+  }
+
+  const projectRoot = process.cwd();
+  const daemon = new ScannerDaemon({
+    projectId,
+    projectRoot,
+    serverUrl: server,
+    apiKey,
+  });
+
+  const shutdown = async () => {
+    console.log('\n[mnemonik] Shutting down...');
+    await daemon.stop();
+    await releaseLock(lock);
+    process.exit(0);
+  };
+
+  process.on('SIGINT', shutdown);
+  process.on('SIGTERM', shutdown);
+
+  try {
+    await daemon.start();
+    console.log('[mnemonik] Watching for changes.');
+  } catch (err) {
+    console.error(`[mnemonik] ${(err as Error).message}`);
+    await releaseLock(lock);
+    process.exit(1);
+  }
+}
+
+main();

package/src/watcher.ts

@@ -0,0 +1,94 @@
+import { watch, type FSWatcher } from 'fs';
+import { join, relative } from 'path';
+import { readdir, stat } from 'fs/promises';
+
+const SKIP_DIRS = new Set([
+  'node_modules',
+  '.git',
+  'dist',
+  'build',
+  '.next',
+  '.nuxt',
+  '.output',
+  '__pycache__',
+  '.venv',
+  'venv',
+  '.tox',
+  'target',
+  '.cache',
+  'coverage',
+  '.turbo',
+  '.vercel',
+  '.svelte-kit',
+]);
+
+export type ChangeHandler = (changedFiles: string[]) => void;
+
+export class FileWatcher {
+  private watchers: FSWatcher[] = [];
+  private pendingFiles = new Set<string>();
+  private flushTimer: ReturnType<typeof setTimeout> | null = null;
+  private debounceMs: number;
+
+  constructor(
+    private rootPath: string,
+    private onChange: ChangeHandler,
+    debounceMs = 500
+  ) {
+    this.debounceMs = debounceMs;
+  }
+
+  async start(): Promise<void> {
+    await this.watchDir(this.rootPath);
+    console.log(`[scanner] Watching ${this.rootPath} for changes`);
+  }
+
+  stop(): void {
+    for (const w of this.watchers) {
+      w.close();
+    }
+    this.watchers = [];
+    if (this.flushTimer) {
+      clearTimeout(this.flushTimer);
+      this.flushTimer = null;
+    }
+    this.pendingFiles.clear();
+  }
+
+  private scheduleFlush(): void {
+    if (this.flushTimer) clearTimeout(this.flushTimer);
+    this.flushTimer = setTimeout(() => {
+      this.flushTimer = null;
+      if (this.pendingFiles.size === 0) return;
+      const batch = [...this.pendingFiles];
+      this.pendingFiles.clear();
+      this.onChange(batch);
+    }, this.debounceMs);
+  }
+
+  private async watchDir(dir: string): Promise<void> {
+    const dirName = dir.split('/').pop() ?? '';
+    if (SKIP_DIRS.has(dirName)) return;
+
+    try {
+      const watcher = watch(dir, { persistent: true }, (_event, filename) => {
+        if (!filename) return;
+        const fullPath = join(dir, filename);
+        const relPath = relative(this.rootPath, fullPath);
+        this.pendingFiles.add(relPath);
+        this.scheduleFlush();
+      });
+
+      this.watchers.push(watcher);
+
+      const entries = await readdir(dir, { withFileTypes: true });
+      for (const entry of entries) {
+        if (entry.isDirectory() && !SKIP_DIRS.has(entry.name)) {
+          await this.watchDir(join(dir, entry.name));
+        }
+      }
+    } catch {
+      // Permission denied or inaccessible directory
+    }
+  }
+}

package/tsconfig.json

@@ -0,0 +1,18 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "lib": ["ES2022"],
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "declaration": true,
+    "sourceMap": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}