@vinaes/succ 1.3.19

package/dist/commands/daemon.js

@@ -0,0 +1,218 @@
+/**
+ * Daemon CLI Command
+ *
+ * Manage the succ daemon process:
+ * - succ daemon status   - Show daemon status and active sessions
+ * - succ daemon sessions - List all active sessions
+ * - succ daemon start    - Start daemon (usually auto-started by hooks)
+ * - succ daemon stop     - Stop daemon (warns if sessions active)
+ * - succ daemon logs     - Show recent daemon logs
+ */
+import fs from 'fs';
+import path from 'path';
+import { createDaemonClient, getDaemonPort, getDaemonPid, getDaemonStatus, ensureDaemonRunning, } from '../daemon/client.js';
+import { getSuccDir } from '../lib/config.js';
+import { logError } from '../lib/fault-logger.js';
+/**
+ * Show daemon status
+ */
+export async function daemonStatus(options = {}) {
+    const status = await getDaemonStatus();
+    if (options.json) {
+        console.log(JSON.stringify(status, null, 2));
+        return;
+    }
+    console.log('=== succ Daemon Status ===\n');
+    if (status.running) {
+        console.log(`Status:   Running`);
+        console.log(`Port:     ${status.port}`);
+        console.log(`PID:      ${status.pid}`);
+        console.log(`Uptime:   ${formatUptime(status.health?.uptime || 0)}`);
+        console.log(`Sessions: ${status.health?.activeSessions || 0}`);
+        console.log(`CWD:      ${status.health?.cwd || 'unknown'}`);
+    }
+    else {
+        console.log('Status:   Not running');
+        if (status.port) {
+            console.log(`Port file exists (${status.port}) but daemon not responding`);
+        }
+        if (status.pid) {
+            console.log(`PID file exists (${status.pid}) but process may have crashed`);
+        }
+    }
+}
+/**
+ * List active sessions
+ */
+export async function daemonSessions(options = {}) {
+    const client = createDaemonClient();
+    if (!(await client.isRunning())) {
+        console.log('Daemon is not running');
+        return;
+    }
+    const sessions = await client.getSessions(options.all);
+    const sessionList = Object.entries(sessions);
+    if (options.json) {
+        console.log(JSON.stringify(sessions, null, 2));
+        return;
+    }
+    console.log(`=== Active Sessions${options.all ? ' (including service)' : ''} ===\n`);
+    if (sessionList.length === 0) {
+        console.log('No active sessions');
+        return;
+    }
+    for (const [id, session] of sessionList) {
+        const idleTime = Date.now() - session.lastActivity;
+        const idleStr = formatUptime(idleTime);
+        const serviceTag = session.isService ? ' [service]' : '';
+        console.log(`Session: ${id}${serviceTag}`);
+        console.log(`  Transcript: ${session.transcriptPath || '(none)'}`);
+        console.log(`  Registered: ${new Date(session.registeredAt).toLocaleString()}`);
+        console.log(`  Last Activity: ${session.lastActivityType || 'none'} (${idleStr} ago)`);
+        console.log(`  Reflections: ${session.reflectionCount}`);
+        console.log('');
+    }
+}
+/**
+ * Start daemon
+ */
+export async function daemonStart(_options = {}) {
+    const client = createDaemonClient();
+    if (await client.isRunning()) {
+        const health = await client.getHealth();
+        console.log(`Daemon already running on port ${health?.pid || 'unknown'}`);
+        return;
+    }
+    console.log('Starting daemon...');
+    const success = await ensureDaemonRunning();
+    if (success) {
+        const health = await client.getHealth();
+        console.log(`Daemon started on port ${getDaemonPort()} (pid=${health?.pid})`);
+    }
+    else {
+        logError('daemon-cmd', 'Failed to start daemon');
+        console.error('Failed to start daemon');
+        process.exit(1);
+    }
+}
+/**
+ * Stop daemon
+ */
+export async function daemonStop(options = {}) {
+    const client = createDaemonClient();
+    if (!(await client.isRunning())) {
+        console.log('Daemon is not running');
+        // Clean up stale files
+        cleanupDaemonFiles();
+        return;
+    }
+    const sessions = await client.getSessions();
+    const sessionCount = Object.keys(sessions).length;
+    if (sessionCount > 0 && !options.force) {
+        console.log(`Warning: ${sessionCount} active session(s)`);
+        console.log('Use --force to stop anyway');
+        return;
+    }
+    // Send unregister for all sessions to trigger graceful shutdown
+    for (const sessionId of Object.keys(sessions)) {
+        await client.unregisterSession(sessionId, false);
+    }
+    // If still running, kill the process
+    const pid = getDaemonPid();
+    if (pid) {
+        try {
+            process.kill(pid, 'SIGTERM');
+            console.log(`Sent SIGTERM to daemon (pid=${pid})`);
+        }
+        catch {
+            // Process may have already exited
+        }
+    }
+    // Wait a moment and clean up files
+    await new Promise((resolve) => setTimeout(resolve, 1000));
+    cleanupDaemonFiles();
+    console.log('Daemon stopped');
+}
+/**
+ * Show daemon logs
+ */
+export async function daemonLogs(options = {}) {
+    const logFile = path.join(getSuccDir(), 'daemon.log');
+    if (!fs.existsSync(logFile)) {
+        console.log('No daemon logs found');
+        return;
+    }
+    const lines = options.lines || 50;
+    const content = fs.readFileSync(logFile, 'utf8');
+    const allLines = content.trim().split('\n');
+    const lastLines = allLines.slice(-lines);
+    console.log(`=== Last ${lastLines.length} lines from daemon.log ===\n`);
+    console.log(lastLines.join('\n'));
+}
+/**
+ * Main daemon command dispatcher
+ */
+export async function daemon(subcommand, options = {}) {
+    switch (subcommand) {
+        case 'status':
+            await daemonStatus(options);
+            break;
+        case 'sessions':
+            await daemonSessions(options);
+            break;
+        case 'start':
+            await daemonStart(options);
+            break;
+        case 'stop':
+            await daemonStop(options);
+            break;
+        case 'logs':
+            await daemonLogs(options);
+            break;
+        default:
+            console.log('Usage: succ daemon <subcommand>');
+            console.log('');
+            console.log('Subcommands:');
+            console.log('  status    Show daemon status');
+            console.log('  sessions  List active sessions (use --all to include service sessions)');
+            console.log('  start     Start daemon');
+            console.log('  stop      Stop daemon (use --force if sessions active)');
+            console.log('  logs      Show daemon logs (use --lines=N for more)');
+    }
+}
+// ============================================================================
+// Helpers
+// ============================================================================
+function formatUptime(ms) {
+    const seconds = Math.floor(ms / 1000);
+    const minutes = Math.floor(seconds / 60);
+    const hours = Math.floor(minutes / 60);
+    const days = Math.floor(hours / 24);
+    if (days > 0) {
+        return `${days}d ${hours % 24}h`;
+    }
+    if (hours > 0) {
+        return `${hours}h ${minutes % 60}m`;
+    }
+    if (minutes > 0) {
+        return `${minutes}m ${seconds % 60}s`;
+    }
+    return `${seconds}s`;
+}
+function cleanupDaemonFiles() {
+    const succDir = getSuccDir();
+    const tmpDir = path.join(succDir, '.tmp');
+    try {
+        fs.unlinkSync(path.join(tmpDir, 'daemon.pid'));
+    }
+    catch {
+        // intentional
+    }
+    try {
+        fs.unlinkSync(path.join(tmpDir, 'daemon.port'));
+    }
+    catch {
+        // intentional
+    }
+}
+//# sourceMappingURL=daemon.js.map

package/dist/commands/daemon.js.map

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

package/dist/commands/embedding.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Embedding management CLI commands.
+ *
+ * - info: Show current embedding model, dimensions, and backend status
+ * - migrate: Change embedding model/dimensions with automatic config update
+ */
+/**
+ * Show current embedding configuration and status.
+ */
+export declare function embeddingInfo(): Promise<void>;
+interface MigrateOptions {
+    model?: string;
+    dims?: string;
+    apiUrl?: string;
+    apiKey?: string;
+    mode?: string;
+    yes?: boolean;
+    project?: boolean;
+}
+/**
+ * Migrate embedding model/dimensions.
+ * Updates config in both global and project scope, then tests connectivity.
+ */
+export declare function embeddingMigrate(options: MigrateOptions): Promise<void>;
+export {};
+//# sourceMappingURL=embedding.d.ts.map

package/dist/commands/embedding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedding.d.ts","sourceRoot":"","sources":["../../src/commands/embedding.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAYH;;GAEG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAoDnD;AAED,UAAU,cAAc;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAuH7E"}

package/dist/commands/embedding.js

@@ -0,0 +1,168 @@
+/**
+ * Embedding management CLI commands.
+ *
+ * - info: Show current embedding model, dimensions, and backend status
+ * - migrate: Change embedding model/dimensions with automatic config update
+ */
+import { getConfig, getLLMTaskConfig, invalidateConfigCache } from '../lib/config.js';
+import { getEmbeddingInfo, getEmbedding, getModelDimension } from '../lib/embeddings.js';
+import { initStorageDispatcher, getStoredEmbeddingDimension, getMemoryCount, getMemoryEmbeddingCount, } from '../lib/storage/index.js';
+import { configSet } from './config.js';
+/**
+ * Show current embedding configuration and status.
+ */
+export async function embeddingInfo() {
+    const info = getEmbeddingInfo();
+    const config = getConfig();
+    const taskCfg = getLLMTaskConfig('embeddings');
+    console.log('Embedding Configuration');
+    console.log('=======================');
+    console.log(`  Mode:       ${info.mode}`);
+    console.log(`  Model:      ${info.model}`);
+    console.log(`  Dimensions: ${info.dimensions ?? 'auto (model default)'}`);
+    console.log(`  API URL:    ${taskCfg.api_url || '(local)'}`);
+    const nativeDims = getModelDimension(info.model);
+    const configDims = config.llm?.embeddings?.dimensions;
+    if (nativeDims && configDims && configDims !== nativeDims) {
+        console.log(`  MRL:        ${nativeDims} -> ${configDims} (Matryoshka truncation)`);
+    }
+    // Test embedding
+    console.log('\nConnectivity Test');
+    console.log('-----------------');
+    try {
+        const testEmb = await getEmbedding('test');
+        console.log(`  API call:   OK (${testEmb.length} dims returned)`);
+    }
+    catch (err) {
+        console.log(`  API call:   FAILED - ${err.message}`);
+    }
+    // Storage status
+    console.log('\nStorage Status');
+    console.log('--------------');
+    const backend = config.storage?.backend ?? 'sqlite';
+    console.log(`  Backend:    ${backend}`);
+    try {
+        await initStorageDispatcher();
+        const storedDim = await getStoredEmbeddingDimension();
+        const memTotal = await getMemoryCount();
+        const memWithEmb = await getMemoryEmbeddingCount();
+        console.log(`  Stored dim: ${storedDim ?? 'none (empty index)'}`);
+        console.log(`  Memories:   ${memWithEmb}/${memTotal} have embeddings`);
+        if (storedDim && info.dimensions && storedDim !== info.dimensions) {
+            console.log(`\n  WARNING: Dimension mismatch! Stored=${storedDim}, Config=${info.dimensions}`);
+            console.log('  Run: succ index --force && succ index --memories');
+        }
+    }
+    catch (err) {
+        console.log(`  Status:     Error - ${err.message}`);
+    }
+}
+/**
+ * Migrate embedding model/dimensions.
+ * Updates config in both global and project scope, then tests connectivity.
+ */
+export async function embeddingMigrate(options) {
+    const currentInfo = getEmbeddingInfo();
+    const newModel = options.model;
+    const newDims = options.dims ? parseInt(options.dims, 10) : undefined;
+    const newMode = options.mode;
+    const newApiUrl = options.apiUrl;
+    const newApiKey = options.apiKey;
+    // Validate dimensions
+    if (newDims !== undefined && (isNaN(newDims) || newDims < 1)) {
+        console.error('Invalid dimensions. Must be a positive integer.');
+        process.exitCode = 1;
+        return;
+    }
+    // Must specify at least something
+    if (!newModel && !newDims && !newMode && !newApiUrl && !newApiKey) {
+        console.log('Usage: succ embedding migrate [options]');
+        console.log('');
+        console.log('Options:');
+        console.log('  --model <model>     Embedding model ID (e.g., qwen/qwen3-embedding-8b)');
+        console.log('  --dims <number>     Output dimensions (MRL truncation)');
+        console.log('  --mode <mode>       Embedding mode (local|api)');
+        console.log('  --api-url <url>     API endpoint URL');
+        console.log('  --api-key <key>     API key');
+        console.log('  --project           Apply to project config only (default: both)');
+        console.log('  -y, --yes           Skip confirmation');
+        console.log('');
+        console.log('Current:');
+        console.log(`  Model: ${currentInfo.model} (${currentInfo.dimensions ?? '?'} dims, mode: ${currentInfo.mode})`);
+        return;
+    }
+    // Get effective dims
+    const nativeDims = newModel ? getModelDimension(newModel) : getModelDimension(currentInfo.model);
+    const effectiveModel = newModel ?? currentInfo.model;
+    const effectiveDims = newDims ?? nativeDims ?? currentInfo.dimensions;
+    console.log('Embedding Migration');
+    console.log('===================');
+    console.log(`  Current: ${currentInfo.model} (${currentInfo.dimensions ?? '?'} dims, mode: ${currentInfo.mode})`);
+    console.log(`  New:     ${effectiveModel} (${effectiveDims ?? '?'} dims${newMode ? `, mode: ${newMode}` : ''})`);
+    if (nativeDims && newDims && newDims !== nativeDims) {
+        console.log(`  MRL:     ${nativeDims} native -> ${newDims} truncated`);
+    }
+    // Confirm
+    if (!options.yes) {
+        const inquirer = await import('inquirer');
+        const { confirm } = await inquirer.default.prompt([
+            {
+                type: 'confirm',
+                name: 'confirm',
+                message: 'Apply changes? You will need to reindex after this.',
+                default: true,
+            },
+        ]);
+        if (!confirm) {
+            console.log('Cancelled.');
+            return;
+        }
+    }
+    // Build config changes
+    const changes = [];
+    if (newModel)
+        changes.push(['llm.embeddings.model', newModel]);
+    if (newDims !== undefined)
+        changes.push(['llm.embeddings.dimensions', String(newDims)]);
+    if (newMode)
+        changes.push(['llm.embeddings.mode', newMode]);
+    if (newApiUrl)
+        changes.push(['llm.embeddings.api_url', newApiUrl]);
+    if (newApiKey)
+        changes.push(['llm.embeddings.api_key', newApiKey]);
+    // Apply to global config
+    console.log('\nUpdating global config...');
+    for (const [key, value] of changes) {
+        await configSet(key, value, {});
+    }
+    // Also apply to project config (unless --project-only was not specified, apply to both)
+    if (!options.project) {
+        console.log('Updating project config...');
+        for (const [key, value] of changes) {
+            await configSet(key, value, { project: true });
+        }
+    }
+    invalidateConfigCache();
+    // Test new embedding model
+    console.log('\nTesting new embedding model...');
+    try {
+        const testEmb = await getEmbedding('migration test');
+        console.log(`  OK: ${testEmb.length} dimensions returned`);
+        if (effectiveDims && testEmb.length !== effectiveDims) {
+            console.warn(`  WARNING: Expected ${effectiveDims} dims, got ${testEmb.length}`);
+        }
+    }
+    catch (err) {
+        console.error(`  FAILED: ${err.message}`);
+        console.error('  Config was updated but the new model may not work.');
+        console.error('  Fix the issue or revert with: succ embedding migrate --model <old-model> --dims <old-dims>');
+        return;
+    }
+    // Show next steps
+    console.log('\nNext steps (reindexing required):');
+    console.log('  succ index --force           # Reindex brain vault');
+    console.log('  succ index --memories         # Re-embed all memories');
+    console.log('  succ index-code --force       # Reindex source code (if used)');
+    console.log('\nPostgreSQL/Qdrant dimension migration happens automatically on next startup.');
+}
+//# sourceMappingURL=embedding.js.map

package/dist/commands/embedding.js.map

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

package/dist/commands/graph.d.ts

@@ -0,0 +1,20 @@
+interface GraphOptions {
+    action: 'export' | 'stats' | 'auto-link' | 'enrich-relations' | 'proximity' | 'communities' | 'centrality' | 'cleanup';
+    format?: 'obsidian' | 'json';
+    threshold?: number;
+    orphanThreshold?: number;
+    output?: string;
+    force?: boolean;
+    limit?: number;
+    dryRun?: boolean;
+    minCount?: number;
+    skipEnrich?: boolean;
+    skipOrphans?: boolean;
+    skipFinalize?: boolean;
+}
+/**
+ * Knowledge graph management command
+ */
+export declare function graph(options: GraphOptions): Promise<void>;
+export {};
+//# sourceMappingURL=graph.d.ts.map

package/dist/commands/graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph.d.ts","sourceRoot":"","sources":["../../src/commands/graph.ts"],"names":[],"mappings":"AAGA,UAAU,YAAY;IACpB,MAAM,EACF,QAAQ,GACR,OAAO,GACP,WAAW,GACX,kBAAkB,GAClB,WAAW,GACX,aAAa,GACb,YAAY,GACZ,SAAS,CAAC;IACd,MAAM,CAAC,EAAE,UAAU,GAAG,MAAM,CAAC;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,wBAAsB,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CA+BhE"}

package/dist/commands/graph.js

@@ -0,0 +1,128 @@
+import { closeDb, getGraphStats, autoLinkSimilarMemories } from '../lib/storage/index.js';
+import { exportGraphSilent } from '../lib/graph-export.js';
+/**
+ * Knowledge graph management command
+ */
+export async function graph(options) {
+    try {
+        switch (options.action) {
+            case 'export':
+                await exportGraph(options.format || 'obsidian', options.output);
+                break;
+            case 'stats':
+                await showStats();
+                break;
+            case 'auto-link':
+                await autoLink(options.threshold || 0.75);
+                break;
+            case 'enrich-relations':
+                await enrichRelations(options.force, options.limit);
+                break;
+            case 'proximity':
+                await proximity(options.minCount, options.dryRun);
+                break;
+            case 'communities':
+                await communities();
+                break;
+            case 'centrality':
+                await centrality();
+                break;
+            case 'cleanup':
+                await cleanup(options);
+                break;
+        }
+    }
+    finally {
+        closeDb();
+    }
+}
+/**
+ * Export graph to Obsidian-compatible markdown
+ */
+async function exportGraph(format, outputDir) {
+    const result = await exportGraphSilent(format, outputDir);
+    if (result.memoriesExported === 0) {
+        console.log('No memories to export.');
+        return;
+    }
+    console.log(`Exported ${result.memoriesExported} memories and ${result.linksExported} links.`);
+    if (format === 'obsidian') {
+        console.log('Open the graph folder in Obsidian to visualize the knowledge graph.');
+    }
+}
+async function showStats() {
+    const stats = await getGraphStats();
+    console.log('\nKnowledge Graph Statistics\n');
+    console.log(`  Memories:         ${stats.total_memories}`);
+    console.log(`  Links:            ${stats.total_links}`);
+    console.log(`  Avg links/memory: ${stats.avg_links_per_memory.toFixed(2)}`);
+    console.log(`  Isolated:         ${stats.isolated_memories}`);
+    if (Object.keys(stats.relations).length > 0) {
+        console.log('\n  By relation:');
+        for (const [relation, count] of Object.entries(stats.relations)) {
+            console.log(`    ${relation}: ${count}`);
+        }
+    }
+    console.log('');
+}
+async function autoLink(threshold) {
+    console.log(`Auto-linking similar memories (threshold: ${threshold})...`);
+    const created = await autoLinkSimilarMemories(threshold, 3);
+    console.log(`Created ${created} new links.`);
+}
+async function enrichRelations(force, limit) {
+    const { enrichExistingLinks } = await import('../lib/graph/llm-relations.js');
+    console.log('Enriching link relations via LLM...');
+    const result = await enrichExistingLinks({ force, limit });
+    console.log(`Enriched: ${result.enriched}, Failed: ${result.failed}, Skipped: ${result.skipped}`);
+}
+async function proximity(minCount, dryRun) {
+    const { createProximityLinks } = await import('../lib/graph/contextual-proximity.js');
+    console.log('Creating contextual proximity links...');
+    const result = await createProximityLinks({ minCooccurrence: minCount ?? 2, dryRun });
+    if (dryRun) {
+        console.log(`Dry run: ${result.total_pairs} pairs found (minCooccurrence: ${minCount ?? 2}).`);
+    }
+    else {
+        console.log(`Created: ${result.created}, Skipped: ${result.skipped}, Total pairs: ${result.total_pairs}`);
+    }
+}
+async function communities() {
+    const { detectCommunities } = await import('../lib/graph/community-detection.js');
+    console.log('Running community detection...');
+    const result = await detectCommunities();
+    console.log(`Detected ${result.communities.length} communities, ${result.isolated} isolated nodes.`);
+    for (const c of result.communities) {
+        console.log(`  Community ${c.id}: ${c.size} members [${c.members.slice(0, 10).join(', ')}${c.size > 10 ? '...' : ''}]`);
+    }
+}
+async function centrality() {
+    const { updateCentralityCache } = await import('../lib/graph/centrality.js');
+    console.log('Computing centrality scores...');
+    const result = await updateCentralityCache();
+    console.log(`Updated centrality for ${result.updated} memories.`);
+}
+async function cleanup(options) {
+    const { graphCleanup } = await import('../lib/graph/cleanup.js');
+    const mode = options.dryRun ? 'DRY RUN' : 'LIVE';
+    console.log(`\nGraph Cleanup (${mode})\n`);
+    const result = await graphCleanup({
+        pruneThreshold: options.threshold,
+        orphanThreshold: options.orphanThreshold,
+        skipEnrich: options.skipEnrich,
+        skipOrphans: options.skipOrphans,
+        skipFinalize: options.skipFinalize,
+        dryRun: options.dryRun,
+        onProgress: (step, detail) => {
+            console.log(`  [${step}] ${detail}`);
+        },
+    });
+    console.log('\nResults:');
+    console.log(`  Pruned:              ${result.pruned}`);
+    console.log(`  Enriched:            ${result.enriched}`);
+    console.log(`  Orphans connected:   ${result.orphansConnected}`);
+    console.log(`  Communities:         ${result.communitiesDetected === -1 ? 'skipped' : result.communitiesDetected}`);
+    console.log(`  Centrality updated:  ${result.centralityUpdated === -1 ? 'skipped' : result.centralityUpdated}`);
+    console.log('');
+}
+//# sourceMappingURL=graph.js.map

package/dist/commands/graph.js.map

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

package/dist/commands/index-code.d.ts

@@ -0,0 +1,23 @@
+interface IndexCodeOptions {
+    patterns?: string[];
+    ignore?: string[];
+    force?: boolean;
+    maxFileSize?: number;
+    autoReindex?: boolean;
+}
+export declare function indexCode(targetPath?: string, options?: IndexCodeOptions): Promise<void>;
+export interface IndexCodeFileResult {
+    success: boolean;
+    chunks?: number;
+    error?: string;
+    skipped?: boolean;
+    reason?: string;
+}
+/**
+ * Index a single code file
+ */
+export declare function indexCodeFile(filePath: string, options?: {
+    force?: boolean;
+}): Promise<IndexCodeFileResult>;
+export {};
+//# sourceMappingURL=index-code.d.ts.map

package/dist/commands/index-code.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-code.d.ts","sourceRoot":"","sources":["../../src/commands/index-code.ts"],"names":[],"mappings":"AA4BA,UAAU,gBAAgB;IACxB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,wBAAsB,SAAS,CAC7B,UAAU,CAAC,EAAE,MAAM,EACnB,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,IAAI,CAAC,CAsIf;AASD,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,wBAAsB,aAAa,CACjC,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAO,GAChC,OAAO,CAAC,mBAAmB,CAAC,CAwF9B"}