@mnemonik/scanner 5.136.2 → 5.151.0

package/dist/index.js

@@ -1,399 +0,0 @@
-#!/usr/bin/env node
-import { readFile, writeFile, unlink, mkdir, stat, chmod } from 'fs/promises';
-import { existsSync } from 'fs';
-import { join } from 'path';
-import { homedir } from 'os';
-import { ScannerDaemon } from './daemon.js';
-import { installFileLogging } from './fileLog.js';
-import { runDoctor } from './doctor.js';
-import { pidIsScanner } from './pid.js';
-const DEFAULT_SERVER = 'https://api.mnemonik.dev';
-const LOCAL_HOSTS = new Set(['localhost', '127.0.0.1', '[::1]']);
-/**
- * Reject plaintext http:// server URLs except when talking to a local
- * daemon on the same machine (localhost/127.0.0.1/[::1]) — e.g. during
- * development against a locally-run server. Everything else must be https://
- * since the scanner pushes full file content (see O2/O8b,
- * codebase-indexing-audit-2026-07-02.md §5) and a plaintext channel would
- * expose that content (and the API key) to network eavesdropping.
- * Extracted as a pure function so the guard is unit-testable without
- * spinning up the CLI.
- */
-export function validateServerUrl(url) {
-    let parsed;
-    try {
-        parsed = new URL(url);
-    }
-    catch {
-        return { valid: false, error: `[mnemonik] Invalid --server URL: "${url}"` };
-    }
-    if (parsed.protocol !== 'https:' && !LOCAL_HOSTS.has(parsed.hostname)) {
-        return {
-            valid: false,
-            error: `[mnemonik] Refusing insecure server URL "${url}".\n` +
-                '  Only https:// is allowed for --server, except for localhost/127.0.0.1/[::1]\n' +
-                '  (used for local development). Scanned file content and your API key would\n' +
-                '  otherwise be sent in plaintext.',
-        };
-    }
-    return { valid: true };
-}
-const MNEMONIK_DIR = join(homedir(), '.mnemonik');
-const PID_FILE = join(MNEMONIK_DIR, 'daemon.pid');
-const LOG_FILE = join(MNEMONIK_DIR, 'scanner.log');
-const CONFIG_FILE = join(MNEMONIK_DIR, 'scanner.json');
-const MAX_LOG_SIZE = 5 * 1024 * 1024; // 5MB
-function parseCliArgs() {
-    const args = process.argv.slice(2);
-    const command = (args[0] ?? 'help');
-    if (!['start', 'stop', 'status', 'log', 'doctor', 'help'].includes(command)) {
-        return { command: 'help' };
-    }
-    let key;
-    let server;
-    let roots;
-    for (let i = 1; i < args.length; i++) {
-        if (args[i] === '--key' && args[i + 1])
-            key = args[++i];
-        else if (args[i] === '--server' && args[i + 1])
-            server = args[++i];
-        else if (args[i] === '--roots' && args[i + 1]) {
-            roots = args[++i].split(',').map((r) => r.trim());
-        }
-    }
-    return { command, key, server, roots };
-}
-async function readConfig() {
-    try {
-        const raw = await readFile(CONFIG_FILE, 'utf-8');
-        return JSON.parse(raw);
-    }
-    catch {
-        return null;
-    }
-}
-async function writeConfig(config) {
-    await mkdir(MNEMONIK_DIR, { recursive: true });
-    await writeFile(CONFIG_FILE, JSON.stringify(config, null, 2), { mode: 0o600 });
-}
-async function checkConfigPermissions() {
-    try {
-        const s = await stat(CONFIG_FILE);
-        // Check if group or other have read/write permissions
-        const mode = s.mode & 0o077;
-        if (mode !== 0) {
-            console.warn(`[mnemonik] WARNING: ${CONFIG_FILE} has overly permissive permissions (${(s.mode & 0o777).toString(8)}).`);
-            console.warn(`[mnemonik] Fixing to 0600 (owner read/write only).`);
-            await chmod(CONFIG_FILE, 0o600);
-        }
-    }
-    catch {
-        // Config file doesn't exist yet
-    }
-}
-async function acquireLock(retried = false) {
-    try {
-        const { open: fsOpen } = await import('fs/promises');
-        const { constants } = await import('fs');
-        const fd = await fsOpen(PID_FILE, 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(PID_FILE, 'utf-8').catch(() => null);
-        if (existing) {
-            const pid = parseInt(existing.trim(), 10);
-            try {
-                process.kill(pid, 0);
-                // Alive is not enough — after PID reuse the number can belong to an
-                // unrelated process. Only an actual scanner holds the lock.
-                if (pidIsScanner(pid)) {
-                    return false; // Process alive and is the scanner — lock is valid
-                }
-                // Live but foreign PID — treat as stale and reclaim below.
-            }
-            catch {
-                // Holder is dead — remove stale lock and retry once
-            }
-        }
-        if (retried)
-            return false;
-        await unlink(PID_FILE).catch(() => { });
-        return acquireLock(true);
-    }
-}
-async function releaseLock() {
-    await unlink(PID_FILE).catch(() => { });
-}
-async function readPid() {
-    try {
-        const raw = await readFile(PID_FILE, 'utf-8');
-        const pid = parseInt(raw.trim(), 10);
-        if (isNaN(pid))
-            return null;
-        // Check if process is actually alive
-        try {
-            process.kill(pid, 0);
-        }
-        catch {
-            return null; // Stale PID
-        }
-        // Alive but foreign (PID reuse) is just as stale — never report it as
-        // the daemon, and never let handleStop() SIGTERM it.
-        if (!pidIsScanner(pid))
-            return null;
-        return pid;
-    }
-    catch {
-        return null;
-    }
-}
-function printHelp() {
-    console.log(`
-mnemonik-scanner - Automatic codebase indexing daemon
-
-Usage:
-  mnemonik-scanner start [options]    Start the scanner daemon
-  mnemonik-scanner stop               Stop the running daemon
-  mnemonik-scanner status             Show daemon status
-  mnemonik-scanner log                Tail the scanner log file
-  mnemonik-scanner doctor             Check install health (drift detection)
-  mnemonik-scanner help               Show this help
-
-Options (for start):
-  --key <api-key>       API key (or set MNEMONIK_API_KEY env var)
-  --server <url>        Server URL (default: https://api.mnemonik.dev)
-  --roots <dirs>        Comma-separated directories to scan for projects
-
-Examples:
-  mnemonik-scanner start --key mnk_... --roots ~/Projects,~/work
-  mnemonik-scanner status
-  mnemonik-scanner stop
-
-Configuration is saved to ~/.mnemonik/scanner.json after first run.
-Subsequent starts use saved config (CLI args override).
-
-Environment variables:
-  MNEMONIK_API_KEY      API key (takes precedence over config file)
-`);
-}
-async function handleStart(cli) {
-    // Guardrail — this daemon is meant to run under the systemd user service
-    // (`systemctl --user start mnemonik-scanner`; see BUILD_AND_DEPLOY.md
-    // "Scanner daemon"). systemd sets INVOCATION_ID on processes it spawns. A
-    // manual foreground `start` attaches the daemon to the invoking shell: it
-    // dies when the shell exits and can spawn duplicate/stale daemons — the exact
-    // failure mode behind version skew and apparent "restart loops". If a unit
-    // exists but we were NOT launched by systemd, refuse (overridable).
-    if (!process.env.INVOCATION_ID && !process.env.MNEMONIK_SCANNER_FOREGROUND) {
-        const unitPath = join(homedir(), '.config/systemd/user/mnemonik-scanner.service');
-        if (existsSync(unitPath)) {
-            console.error('[mnemonik] A systemd unit already manages this scanner.\n' +
-                '  Start/restart it with:\n' +
-                '      systemctl --user restart mnemonik-scanner\n' +
-                '  Running `mnemonik-scanner start` by hand attaches the daemon to your shell — it\n' +
-                '  dies when the shell exits and can leave duplicate/stale daemons running (version\n' +
-                '  skew, apparent "restart loops"). To force a foreground run, set\n' +
-                '  MNEMONIK_SCANNER_FOREGROUND=1.');
-            process.exit(1);
-        }
-    }
-    const config = await readConfig();
-    // Resolve API key: env var > CLI > config
-    const apiKey = process.env.MNEMONIK_API_KEY || cli.key || config?.apiKey;
-    if (!apiKey) {
-        console.error('[mnemonik] Missing API key.\n' +
-            '  Use --key <api-key>, set MNEMONIK_API_KEY env var,\n' +
-            '  or run once with --key to save to config.');
-        process.exit(1);
-    }
-    const roots = cli.roots || config?.roots;
-    if (!roots || roots.length === 0) {
-        console.error('[mnemonik] No roots specified.\n' +
-            '  Use --roots ~/Projects,~/work to specify directories to scan.');
-        process.exit(1);
-    }
-    const server = cli.server || config?.server || DEFAULT_SERVER;
-    const serverUrlCheck = validateServerUrl(server);
-    if (!serverUrlCheck.valid) {
-        console.error(serverUrlCheck.error);
-        process.exit(1);
-    }
-    // Ensure directories exist
-    await mkdir(MNEMONIK_DIR, { recursive: true });
-    // Mirror all console output into scanner.log so `mnemonik-scanner log`
-    // reflects live activity regardless of supervisor. Under systemd, stdout is
-    // wired to the journal socket, not this file — without the tee the on-disk
-    // log goes stale and `log` shows nothing current. Install before any daemon
-    // output so the whole session is captured.
-    installFileLogging(LOG_FILE, MAX_LOG_SIZE);
-    // Save config for future runs (never save env var key to file)
-    const configToSave = {
-        roots,
-        server,
-        refreshIntervalMs: config?.refreshIntervalMs,
-    };
-    // Only save API key to config if it came from CLI (not env var)
-    if (cli.key) {
-        configToSave.apiKey = cli.key;
-    }
-    else if (config?.apiKey && !process.env.MNEMONIK_API_KEY) {
-        configToSave.apiKey = config.apiKey;
-    }
-    await writeConfig(configToSave);
-    await checkConfigPermissions();
-    const locked = await acquireLock();
-    if (!locked) {
-        const pid = await readPid();
-        console.log(`[mnemonik] Scanner daemon already running (PID ${pid}). Use 'mnemonik-scanner stop' first.`);
-        process.exit(0);
-    }
-    const daemon = new ScannerDaemon({
-        serverUrl: server,
-        apiKey,
-        roots,
-        refreshIntervalMs: config?.refreshIntervalMs,
-    });
-    const shutdown = async () => {
-        console.log('\n[mnemonik] Shutting down...');
-        await daemon.stop();
-        await releaseLock();
-        process.exit(0);
-    };
-    process.on('SIGINT', shutdown);
-    process.on('SIGTERM', shutdown);
-    process.on('SIGHUP', shutdown); // Graceful restart — external tooling sends SIGHUP then relaunches
-    try {
-        await daemon.start();
-    }
-    catch (err) {
-        console.error(`[mnemonik] ${err.message}`);
-        await releaseLock();
-        process.exit(1);
-    }
-}
-async function handleStop() {
-    const pid = await readPid();
-    if (!pid) {
-        console.log('[mnemonik] Scanner daemon is not running.');
-        // Clean up stale PID file if it exists
-        await unlink(PID_FILE).catch(() => { });
-        return;
-    }
-    try {
-        process.kill(pid, 'SIGTERM');
-        console.log(`[mnemonik] Sent SIGTERM to daemon (PID ${pid}).`);
-        // Wait for process to exit (up to 5 seconds)
-        for (let i = 0; i < 50; i++) {
-            await new Promise((r) => setTimeout(r, 100));
-            try {
-                process.kill(pid, 0);
-            }
-            catch {
-                console.log('[mnemonik] Daemon stopped.');
-                return;
-            }
-        }
-        console.warn('[mnemonik] Daemon did not exit within 5 seconds.');
-    }
-    catch {
-        console.log('[mnemonik] Daemon process not found. Cleaning up PID file.');
-        await unlink(PID_FILE).catch(() => { });
-    }
-}
-async function handleStatus() {
-    const pid = await readPid();
-    const config = await readConfig();
-    if (!pid) {
-        console.log('Status: not running');
-        if (config?.roots) {
-            console.log(`Configured roots: ${config.roots.join(', ')}`);
-        }
-        console.log(`\nStart with: mnemonik-scanner start`);
-        return;
-    }
-    console.log(`Status: running (PID ${pid})`);
-    if (config?.roots) {
-        console.log(`Roots: ${config.roots.join(', ')}`);
-    }
-    if (config?.server) {
-        console.log(`Server: ${config.server}`);
-    }
-    // Check for old per-project daemons
-    try {
-        const { readdir: readdirAsync } = await import('fs/promises');
-        const oldDaemonsDir = join(MNEMONIK_DIR, 'daemons');
-        const oldPidFiles = await readdirAsync(oldDaemonsDir).catch(() => []);
-        const staleOldDaemons = [];
-        for (const f of oldPidFiles) {
-            if (!f.endsWith('.pid'))
-                continue;
-            const content = await readFile(join(oldDaemonsDir, f), 'utf-8').catch(() => null);
-            if (content) {
-                const oldPid = parseInt(content.trim(), 10);
-                try {
-                    process.kill(oldPid, 0);
-                    // Same PID-reuse guard as readPid(): only report genuinely live
-                    // scanner processes, not whatever now occupies a recycled PID.
-                    if (pidIsScanner(oldPid)) {
-                        staleOldDaemons.push(`${f} (PID ${oldPid})`);
-                    }
-                }
-                catch {
-                    // Dead process, just a stale file
-                }
-            }
-        }
-        if (staleOldDaemons.length > 0) {
-            console.log(`\nLegacy per-project daemons still running:`);
-            for (const d of staleOldDaemons) {
-                console.log(`  ${d}`);
-            }
-            console.log('  Consider stopping these — the global daemon handles all projects.');
-        }
-    }
-    catch {
-        // Old daemons dir doesn't exist
-    }
-}
-async function handleLog() {
-    try {
-        const content = await readFile(LOG_FILE, 'utf-8');
-        // Show last 50 lines
-        const lines = content.split('\n');
-        const tail = lines.slice(-50).join('\n');
-        console.log(tail);
-    }
-    catch {
-        console.log('[mnemonik] No log file found at', LOG_FILE);
-    }
-}
-async function main() {
-    const cli = parseCliArgs();
-    switch (cli.command) {
-        case 'start':
-            await handleStart(cli);
-            break;
-        case 'stop':
-            await handleStop();
-            break;
-        case 'status':
-            await handleStatus();
-            break;
-        case 'log':
-            await handleLog();
-            break;
-        case 'doctor':
-            await runDoctor();
-            break;
-        case 'help':
-        default:
-            printHelp();
-            break;
-    }
-}
-main();
-//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/pid.d.ts

@@ -1 +0,0 @@
-export declare function pidIsScanner(pid: number): boolean;

package/dist/pid.js

@@ -1,37 +0,0 @@
-import { execFileSync } from 'child_process';
-import { readFileSync } from 'fs';
-/**
- * PID-reuse guard shared by the CLI lock paths (index.ts) and doctor.
- *
- * `process.kill(pid, 0)` only proves that *some* process is alive at that
- * PID, not that it is ours. After a reboot or plain PID recycling the number
- * in daemon.pid can belong to an unrelated process — SIGTERMing it from
- * `stop`, or refusing to `start` because of it, would be wrong. So a live PID
- * only counts as the scanner when its command line matches the daemon's
- * signature (same pattern doctor uses to find daemon processes via `ps`).
- */
-const SCANNER_CMD_PATTERN = /(mnemonik-scanner|scanner\/dist\/index\.js)/;
-function processCmdline(pid) {
-    // Linux: /proc/<pid>/cmdline is NUL-separated argv — cheap and exact.
-    try {
-        return readFileSync(`/proc/${pid}/cmdline`, 'utf-8').replace(/\0/g, ' ');
-    }
-    catch {
-        // /proc unavailable (macOS) or unreadable — fall back to ps below.
-    }
-    try {
-        return execFileSync('ps', ['-o', 'args=', '-p', String(pid)], {
-            encoding: 'utf-8',
-            stdio: ['ignore', 'pipe', 'ignore'],
-            timeout: 5000,
-        }).trim();
-    }
-    catch {
-        return null; // No such process, or ps unavailable — cannot confirm identity.
-    }
-}
-export function pidIsScanner(pid) {
-    const cmdline = processCmdline(pid);
-    return cmdline !== null && SCANNER_CMD_PATTERN.test(cmdline);
-}
-//# sourceMappingURL=pid.js.map

package/dist/pid.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"pid.js","sourceRoot":"","sources":["../src/pid.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAElC;;;;;;;;;GASG;AACH,MAAM,mBAAmB,GAAG,6CAA6C,CAAC;AAE1E,SAAS,cAAc,CAAC,GAAW;IACjC,sEAAsE;IACtE,IAAI,CAAC;QACH,OAAO,YAAY,CAAC,SAAS,GAAG,UAAU,EAAE,OAAO,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAC3E,CAAC;IAAC,MAAM,CAAC;QACP,mEAAmE;IACrE,CAAC;IACD,IAAI,CAAC;QACH,OAAO,YAAY,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE;YAC5D,QAAQ,EAAE,OAAO;YACjB,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC;YACnC,OAAO,EAAE,IAAI;SACd,CAAC,CAAC,IAAI,EAAE,CAAC;IACZ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC,CAAC,gEAAgE;IAC/E,CAAC;AACH,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,GAAW;IACtC,MAAM,OAAO,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC;IACpC,OAAO,OAAO,KAAK,IAAI,IAAI,mBAAmB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AAC/D,CAAC"}

package/dist/watcher.d.ts

@@ -1,30 +0,0 @@
-export type ChangeHandler = (changedFiles: string[]) => void;
-export type ErrorHandler = (err: Error) => void;
-export declare class FileWatcher {
-    private rootPath;
-    private onChange;
-    private watchers;
-    private watchedDirs;
-    private watchedDirInodes;
-    private pendingFiles;
-    private flushTimer;
-    private debounceMs;
-    private onError;
-    constructor(rootPath: string, onChange: ChangeHandler, debounceMs?: number, onError?: ErrorHandler);
-    start(): Promise<void>;
-    stop(): void;
-    private scheduleFlush;
-    private watchDir;
-    /**
-     * Attach a watcher to a directory created after start(). Called from the
-     * per-directory change callback with every event path; stats the path and
-     * only recurses when it is a genuinely new, watchable directory.
-     */
-    private watchNewDir;
-    /**
-     * Forget a deleted directory and everything watched beneath it. fs.watch
-     * emits no per-descendant events on a recursive delete, so the whole
-     * prefix must be purged here for a recreate to re-watch the full subtree.
-     */
-    private unwatchSubtree;
-}