@iflow-mcp/jkheadley-instar 0.26.2

package/dist/commands/relationship.js

@@ -0,0 +1,156 @@
+/**
+ * `instar relationship list|import|export` — Manage relationship records.
+ *
+ * PROP-166: Unified Identity Bridge — Portal People-Registry + Instar RelationshipManager
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import pc from 'picocolors';
+import { loadConfig, ensureStateDir } from '../core/Config.js';
+import { RelationshipManager } from '../core/RelationshipManager.js';
+function getRelationshipsManager() {
+    const config = loadConfig();
+    ensureStateDir(config.stateDir);
+    const relConfig = config.relationships;
+    if (!relConfig) {
+        console.log(pc.yellow('Relationships not configured.'));
+        console.log('Add to .instar/config.json:');
+        console.log(pc.dim('  "relationships": { "relationshipsDir": ".instar/relationships", "maxRecentInteractions": 50 }'));
+        return null;
+    }
+    return new RelationshipManager(relConfig);
+}
+export async function listRelationships(options) {
+    const manager = getRelationshipsManager();
+    if (!manager)
+        return;
+    const sortBy = (['significance', 'recent', 'name'].includes(options.sort || '')
+        ? options.sort
+        : 'significance');
+    const all = manager.getAll(sortBy);
+    if (all.length === 0) {
+        console.log(pc.dim('No relationships tracked yet.'));
+        return;
+    }
+    console.log(pc.bold(`\nRelationships (${all.length}):\n`));
+    for (const r of all) {
+        const channels = r.channels.map(c => `${c.type}:${c.identifier}`).join(', ');
+        const sig = '★'.repeat(Math.min(5, Math.round(r.significance / 2))) +
+            '☆'.repeat(Math.max(0, 5 - Math.round(r.significance / 2)));
+        console.log(`  ${pc.bold(r.name)} ${pc.dim(`(${r.significance}/10)`)} ${sig}`);
+        console.log(`    Channels: ${pc.dim(channels)}`);
+        console.log(`    Interactions: ${r.interactionCount}  Themes: ${r.themes.slice(0, 3).join(', ') || 'none'}`);
+        console.log(`    First: ${r.firstInteraction.slice(0, 10)}  Last: ${r.lastInteraction.slice(0, 10)}`);
+        console.log();
+    }
+}
+export async function importRelationships(options) {
+    const manager = getRelationshipsManager();
+    if (!manager)
+        return;
+    const filePath = path.resolve(options.file);
+    if (!fs.existsSync(filePath)) {
+        console.log(pc.red(`File not found: ${filePath}`));
+        process.exit(1);
+    }
+    let records;
+    try {
+        records = JSON.parse(fs.readFileSync(filePath, 'utf-8'));
+    }
+    catch (err) {
+        console.log(pc.red(`Failed to parse ${filePath}: ${err}`));
+        process.exit(1);
+    }
+    if (!Array.isArray(records)) {
+        console.log(pc.red('Expected a JSON array of relationship records'));
+        process.exit(1);
+    }
+    let created = 0;
+    let updated = 0;
+    let skipped = 0;
+    for (const rec of records) {
+        const name = rec.name;
+        const channels = (rec.channels || []);
+        if (!name || !channels.length) {
+            skipped++;
+            continue;
+        }
+        // Try to resolve by any channel
+        let existing = null;
+        for (const channel of channels) {
+            existing = manager.resolveByChannel(channel);
+            if (existing)
+                break;
+        }
+        if (options.dryRun) {
+            console.log(`  ${existing ? 'UPDATE' : 'CREATE'} ${name} (${channels.map(c => `${c.type}:${c.identifier}`).join(', ')})`);
+            if (existing)
+                updated++;
+            else
+                created++;
+            continue;
+        }
+        if (existing) {
+            // Update: link any new channels, update notes if richer
+            for (const channel of channels) {
+                manager.linkChannel(existing.id, channel);
+            }
+            const importNotes = rec.notes;
+            if (importNotes && importNotes.length > (existing.notes || '').length) {
+                manager.updateNotes(existing.id, importNotes);
+            }
+            updated++;
+        }
+        else {
+            // Create: use first channel to create, then link the rest
+            const record = manager.findOrCreate(name, channels[0]);
+            for (let i = 1; i < channels.length; i++) {
+                manager.linkChannel(record.id, channels[i]);
+            }
+            // Set notes
+            if (rec.notes) {
+                manager.updateNotes(record.id, rec.notes);
+            }
+            // Import themes via interaction recording
+            const themes = (rec.themes || []);
+            if (themes.length > 0) {
+                manager.recordInteraction(record.id, {
+                    timestamp: new Date().toISOString(),
+                    channel: channels[0].type,
+                    summary: `Imported from Portal people-registry with ${themes.length} themes`,
+                    topics: themes,
+                });
+            }
+            created++;
+        }
+    }
+    if (options.dryRun) {
+        console.log(pc.yellow(`\n  DRY RUN — no changes made`));
+    }
+    console.log(`\n${pc.green('Import complete:')}`);
+    console.log(`  Created: ${pc.bold(String(created))}`);
+    console.log(`  Updated: ${pc.bold(String(updated))}`);
+    console.log(`  Skipped: ${pc.dim(String(skipped))}`);
+}
+export async function exportRelationships(options) {
+    const manager = getRelationshipsManager();
+    if (!manager)
+        return;
+    const minSig = parseFloat(options.minSignificance || '0');
+    const all = manager.getAll('significance').filter(r => r.significance >= minSig);
+    if (all.length === 0) {
+        console.log(pc.dim('No relationships to export.'));
+        return;
+    }
+    const output = JSON.stringify(all, null, 2);
+    if (options.file) {
+        const filePath = path.resolve(options.file);
+        fs.writeFileSync(filePath, output);
+        console.log(pc.green(`Exported ${all.length} relationships to ${filePath}`));
+        console.log(pc.dim(`  To import in Portal: python3 .claude/scripts/update-people-registry.py --import-from-instar ${filePath}`));
+    }
+    else {
+        console.log(output);
+    }
+}
+//# sourceMappingURL=relationship.js.map

package/dist/commands/relationship.js.map

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

package/dist/commands/relay.d.ts

@@ -0,0 +1,26 @@
+/**
+ * `instar relay start|stop|status` — Manage the Threadline relay server.
+ *
+ * The relay is a standalone WebSocket server that enables agent-to-agent
+ * communication. Agents connect via outbound WebSocket, authenticate with
+ * Ed25519 signatures, and exchange E2E encrypted messages.
+ *
+ * Environment variables:
+ *   RELAY_PORT        — WebSocket port (default: 8787)
+ *   RELAY_HOST        — Bind address (default: 0.0.0.0)
+ *   RELAY_ADMIN_KEY   — Admin API bearer token (required for admin endpoints)
+ *   RELAY_ADMIN_PORT  — Admin API port (default: 9091)
+ */
+export interface RelayStartOptions {
+    port?: number;
+    host?: string;
+    adminPort?: number;
+    adminKey?: string;
+    foreground?: boolean;
+    dataDir?: string;
+}
+export declare function startRelay(opts: RelayStartOptions): Promise<void>;
+export declare function relayStatus(opts: {
+    port?: number;
+}): Promise<void>;
+//# sourceMappingURL=relay.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"relay.d.ts","sourceRoot":"","sources":["../../src/commands/relay.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH,MAAM,WAAW,iBAAiB;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,wBAAsB,UAAU,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAoFvE;AAED,wBAAsB,WAAW,CAAC,IAAI,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAuCxE"}

package/dist/commands/relay.js

@@ -0,0 +1,121 @@
+/**
+ * `instar relay start|stop|status` — Manage the Threadline relay server.
+ *
+ * The relay is a standalone WebSocket server that enables agent-to-agent
+ * communication. Agents connect via outbound WebSocket, authenticate with
+ * Ed25519 signatures, and exchange E2E encrypted messages.
+ *
+ * Environment variables:
+ *   RELAY_PORT        — WebSocket port (default: 8787)
+ *   RELAY_HOST        — Bind address (default: 0.0.0.0)
+ *   RELAY_ADMIN_KEY   — Admin API bearer token (required for admin endpoints)
+ *   RELAY_ADMIN_PORT  — Admin API port (default: 9091)
+ */
+import pc from 'picocolors';
+import crypto from 'node:crypto';
+export async function startRelay(opts) {
+    const port = opts.port ?? parseInt(process.env.RELAY_PORT ?? '8787', 10);
+    const host = opts.host ?? process.env.RELAY_HOST ?? '0.0.0.0';
+    const adminPort = opts.adminPort ?? parseInt(process.env.RELAY_ADMIN_PORT ?? '9091', 10);
+    const adminKey = opts.adminKey ?? process.env.RELAY_ADMIN_KEY ?? '';
+    if (!adminKey) {
+        // Generate a random key if none provided
+        const generatedKey = crypto.randomBytes(24).toString('base64url');
+        console.log(pc.yellow('No RELAY_ADMIN_KEY set — generating a random one for this session:'));
+        console.log(pc.cyan(`  RELAY_ADMIN_KEY=${generatedKey}`));
+        console.log();
+        console.log('Set this as an environment variable to persist it across restarts.');
+        console.log();
+        opts.adminKey = generatedKey;
+    }
+    const effectiveAdminKey = opts.adminKey ?? adminKey;
+    // Dynamic import to avoid loading relay code at CLI startup
+    const { RelayServer } = await import('../threadline/relay/RelayServer.js');
+    const { AdminServer } = await import('../threadline/relay/AdminServer.js');
+    console.log(pc.bold('Starting Threadline Relay...'));
+    console.log();
+    // Start relay server
+    const authRate = parseInt(process.env.RELAY_AUTH_RATE ?? '5', 10);
+    const dataDir = opts.dataDir ?? process.env.RELAY_DATA_DIR ?? './data';
+    const relay = new RelayServer({
+        port,
+        host,
+        rateLimitConfig: { authAttemptsPerMinute: authRate },
+        registryDataDir: dataDir,
+    });
+    await relay.start();
+    const addr = relay.address;
+    console.log(pc.green(`  Relay listening on ws://${addr.host}:${addr.port}/v1/connect`));
+    // Start admin server
+    const admin = new AdminServer({ port: adminPort, host: '127.0.0.1', adminKey: effectiveAdminKey }, {
+        presence: relay.presence,
+        rateLimiter: relay.rateLimiter,
+        connections: relay.connections,
+        abuseDetector: relay.abuseDetector,
+        offlineQueue: relay.offlineQueue,
+        metrics: relay.metrics,
+        getUptime: () => Math.round(process.uptime()),
+    });
+    await admin.start();
+    const adminAddr = admin.address;
+    console.log(pc.green(`  Admin API on http://${adminAddr.host}:${adminAddr.port}/admin/status`));
+    console.log();
+    console.log(pc.dim('  Health:     ') + `http://${addr.host}:${addr.port}/health`);
+    console.log(pc.dim('  Metrics:    ') + `http://${adminAddr.host}:${adminAddr.port}/admin/metrics`);
+    console.log(pc.dim('  A2A Bridge: ') + `http://${addr.host}:${addr.port}/a2a/{agentId}/messages`);
+    console.log();
+    console.log(pc.dim('Press Ctrl+C to stop.'));
+    // Graceful shutdown
+    const shutdown = async (signal) => {
+        console.log();
+        console.log(pc.yellow(`${signal} received — shutting down...`));
+        const stats = relay.metrics.getSnapshot();
+        console.log(pc.dim(`  Messages routed:    ${stats.messagesRouted}`));
+        console.log(pc.dim(`  Messages delivered: ${stats.messagesDelivered}`));
+        console.log(pc.dim(`  Messages queued:    ${stats.messagesQueued}`));
+        console.log(pc.dim(`  Connections total:  ${stats.connectionsTotal}`));
+        console.log(pc.dim(`  Uptime:             ${Math.round(stats.uptimeSeconds)}s`));
+        await admin.stop();
+        await relay.stop();
+        console.log(pc.green('Relay stopped cleanly.'));
+        process.exit(0);
+    };
+    process.on('SIGTERM', () => shutdown('SIGTERM'));
+    process.on('SIGINT', () => shutdown('SIGINT'));
+}
+export async function relayStatus(opts) {
+    const port = opts.port ?? parseInt(process.env.RELAY_PORT ?? '8787', 10);
+    try {
+        const res = await fetch(`http://127.0.0.1:${port}/health`);
+        if (!res.ok) {
+            console.log(pc.red(`Relay returned ${res.status}`));
+            process.exit(1);
+        }
+        const health = await res.json();
+        console.log(pc.bold('Threadline Relay Status'));
+        console.log();
+        console.log(`  Status:      ${pc.green(String(health.status))}`);
+        console.log(`  Agents:      ${health.agents ?? 0}`);
+        console.log(`  Connections: ${health.connections ?? 0}`);
+        const queue = health.offlineQueue;
+        if (queue) {
+            console.log(`  Queue:       ${queue.totalMessages} messages for ${queue.recipientCount} recipients`);
+        }
+        const abuse = health.abuse;
+        if (abuse) {
+            console.log(`  Bans:        ${abuse.activeBans} active`);
+        }
+        const throughput = health.throughput;
+        if (throughput) {
+            console.log(`  Throughput:  ${throughput.messagesRouted} routed, ${throughput.messagesPerMinute}/min`);
+        }
+        const uptimeNum = typeof health.uptime === 'number' ? Math.round(health.uptime) : 0;
+        console.log(`  Uptime:      ${uptimeNum}s`);
+    }
+    catch {
+        console.log(pc.red(`Cannot reach relay at http://127.0.0.1:${port}/health`));
+        console.log(pc.dim('Is the relay running? Start it with: instar relay start'));
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=relay.js.map

package/dist/commands/relay.js.map

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

package/dist/commands/review.d.ts

@@ -0,0 +1,18 @@
+/**
+ * System Review CLI command — `instar review`
+ *
+ * Runs the System Reviewer to verify feature functionality end-to-end.
+ * This is a client command that calls the running server's API endpoints.
+ */
+interface ReviewOptions {
+    dir?: string;
+    tier?: string;
+    probe?: string;
+    dryRun?: boolean;
+    history?: boolean;
+    trend?: boolean;
+    json?: boolean;
+}
+export declare function review(options: ReviewOptions): Promise<void>;
+export {};
+//# sourceMappingURL=review.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"review.d.ts","sourceRoot":"","sources":["../../src/commands/review.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,UAAU,aAAa;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAmBD,wBAAsB,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CA+BlE"}

package/dist/commands/review.js

@@ -0,0 +1,193 @@
+/**
+ * System Review CLI command — `instar review`
+ *
+ * Runs the System Reviewer to verify feature functionality end-to-end.
+ * This is a client command that calls the running server's API endpoints.
+ */
+import pc from 'picocolors';
+import { loadConfig } from '../core/Config.js';
+async function apiCall(baseUrl, path, method, authToken, body) {
+    const headers = { 'Content-Type': 'application/json' };
+    if (authToken)
+        headers['Authorization'] = `Bearer ${authToken}`;
+    const res = await fetch(`${baseUrl}${path}`, {
+        method,
+        headers,
+        body: body ? JSON.stringify(body) : undefined,
+    });
+    if (!res.ok) {
+        const text = await res.text();
+        throw new Error(`API ${res.status}: ${text}`);
+    }
+    return res.json();
+}
+export async function review(options) {
+    let config;
+    try {
+        config = loadConfig(options.dir);
+    }
+    catch {
+        console.log(pc.red('Not initialized. Run `instar init` first.'));
+        process.exit(1);
+    }
+    const port = config.port ?? 4321;
+    const baseUrl = `http://localhost:${port}`;
+    const authToken = config.authToken;
+    // Check server is running
+    try {
+        await fetch(`${baseUrl}/health`, { signal: AbortSignal.timeout(3000) });
+    }
+    catch {
+        console.log(pc.red('Server is not running. Start it with `instar server start`.'));
+        process.exit(1);
+    }
+    // Route to subcommand
+    if (options.history) {
+        return showHistory(baseUrl, authToken, options.json);
+    }
+    if (options.trend) {
+        return showTrend(baseUrl, authToken, options.json);
+    }
+    // Default: run a review
+    return runReview(baseUrl, authToken, options);
+}
+async function runReview(baseUrl, authToken, options) {
+    console.log(pc.bold(`\n  System Review\n`));
+    const body = {};
+    if (options.tier)
+        body.tier = Number(options.tier);
+    if (options.probe)
+        body.probeId = options.probe;
+    if (options.dryRun)
+        body.dryRun = true;
+    if (options.dryRun) {
+        console.log(pc.dim('  Dry run — showing what would execute\n'));
+    }
+    try {
+        const report = await apiCall(baseUrl, '/system-reviews', 'POST', authToken, body);
+        if (options.json) {
+            console.log(JSON.stringify(report, null, 2));
+            return;
+        }
+        // Group results by tier
+        const byTier = new Map();
+        for (const r of report.results) {
+            const tier = r.tier;
+            if (!byTier.has(tier))
+                byTier.set(tier, []);
+            byTier.get(tier).push(r);
+        }
+        const tierNames = {
+            1: 'Core Survival',
+            2: 'Intelligence',
+            3: 'Safety',
+            4: 'Coordination',
+            5: 'Communication Quality',
+        };
+        for (const [tier, results] of [...byTier.entries()].sort((a, b) => a[0] - b[0])) {
+            console.log(pc.bold(`  Tier ${tier}: ${tierNames[tier] ?? 'Unknown'}`));
+            for (const r of results) {
+                const icon = r.passed ? pc.green('✓') : pc.red('✗');
+                const duration = pc.dim(`${r.durationMs}ms`);
+                console.log(`    ${icon} ${r.name} ${duration}`);
+                if (!r.passed && r.description) {
+                    console.log(pc.dim(`      ${r.description}`));
+                }
+                if (!r.passed && r.error) {
+                    console.log(pc.red(`      ${r.error}`));
+                }
+                if (!r.passed && r.remediation?.length) {
+                    for (const step of r.remediation) {
+                        console.log(pc.yellow(`      → ${step}`));
+                    }
+                }
+            }
+            console.log();
+        }
+        // Summary
+        const { summary } = report;
+        const statusColor = report.status === 'all-clear' ? pc.green
+            : report.status === 'degraded' ? pc.yellow
+                : pc.red;
+        console.log(pc.bold('  Summary'));
+        console.log(`    Status: ${statusColor(report.status.toUpperCase())}`);
+        console.log(`    ${pc.green(String(summary.passed))} passed, ${summary.failed > 0 ? pc.red(String(summary.failed)) : '0'} failed, ${summary.skipped} skipped`);
+        console.log(`    Duration: ${report.duration}ms\n`);
+        // Exit code per spec
+        if (report.status === 'critical')
+            process.exit(2);
+        if (report.status === 'degraded')
+            process.exit(1);
+        process.exit(0);
+    }
+    catch (err) {
+        console.log(pc.red(`  Review failed: ${err instanceof Error ? err.message : String(err)}`));
+        process.exit(3);
+    }
+}
+async function showHistory(baseUrl, authToken, json) {
+    try {
+        const data = await apiCall(baseUrl, '/system-reviews/history', 'GET', authToken);
+        if (json) {
+            console.log(JSON.stringify(data, null, 2));
+            return;
+        }
+        console.log(pc.bold(`\n  Review History (${data.count} reports)\n`));
+        if (data.count === 0) {
+            console.log(pc.dim('  No reviews yet. Run `instar review` to start.\n'));
+            return;
+        }
+        for (const r of data.reports.slice(-10).reverse()) {
+            const statusColor = r.status === 'all-clear' ? pc.green
+                : r.status === 'degraded' ? pc.yellow
+                    : pc.red;
+            const date = new Date(r.timestamp).toLocaleString();
+            console.log(`  ${pc.dim(date)}  ${statusColor(r.status.padEnd(10))}  ${pc.green(String(r.summary.passed))}/${r.summary.total} passed  ${pc.dim(`${r.duration}ms`)}`);
+        }
+        console.log();
+    }
+    catch (err) {
+        console.log(pc.red(`  Failed to get history: ${err instanceof Error ? err.message : String(err)}`));
+        process.exit(3);
+    }
+}
+async function showTrend(baseUrl, authToken, json) {
+    try {
+        const trend = await apiCall(baseUrl, '/system-reviews/trend', 'GET', authToken);
+        if (json) {
+            console.log(JSON.stringify(trend, null, 2));
+            return;
+        }
+        console.log(pc.bold(`\n  Review Trend (${trend.reviewCount} reviews)\n`));
+        if (trend.reviewCount < 2) {
+            console.log(pc.dim('  Need at least 2 reviews for trend analysis.\n'));
+            return;
+        }
+        const dirColor = trend.direction === 'improving' ? pc.green
+            : trend.direction === 'degrading' ? pc.red
+                : pc.dim;
+        console.log(`  Direction: ${dirColor(trend.direction)}`);
+        console.log(`  Pass rate: ${(trend.passRate.current * 100).toFixed(0)}% (${trend.passRate.delta >= 0 ? '+' : ''}${(trend.passRate.delta * 100).toFixed(0)}%)`);
+        if (trend.newFailures.length > 0) {
+            console.log(pc.red(`\n  New failures:`));
+            for (const f of trend.newFailures)
+                console.log(pc.red(`    ✗ ${f}`));
+        }
+        if (trend.resolvedFailures.length > 0) {
+            console.log(pc.green(`\n  Resolved:`));
+            for (const f of trend.resolvedFailures)
+                console.log(pc.green(`    ✓ ${f}`));
+        }
+        if (trend.persistentFailures.length > 0) {
+            console.log(pc.yellow(`\n  Persistent failures:`));
+            for (const f of trend.persistentFailures)
+                console.log(pc.yellow(`    ⚠ ${f}`));
+        }
+        console.log();
+    }
+    catch (err) {
+        console.log(pc.red(`  Failed to get trend: ${err instanceof Error ? err.message : String(err)}`));
+        process.exit(3);
+    }
+}
+//# sourceMappingURL=review.js.map

package/dist/commands/review.js.map

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

package/dist/commands/semantic.d.ts

@@ -0,0 +1,37 @@
+/**
+ * `instar semantic` — Manage the semantic memory knowledge graph.
+ *
+ * Commands:
+ *   instar semantic search "query"   Search the knowledge graph
+ *   instar semantic remember         Add a knowledge entity
+ *   instar semantic forget <id>      Remove an entity
+ *   instar semantic stats            Show graph statistics
+ *   instar semantic export           Export all entities and edges
+ *   instar semantic decay            Run confidence decay
+ */
+interface SemanticOptions {
+    dir?: string;
+    limit?: number;
+}
+export declare function semanticSearch(query: string, opts: SemanticOptions & {
+    type?: string;
+    domain?: string;
+    minConfidence?: string;
+}): Promise<void>;
+export declare function semanticRemember(opts: SemanticOptions & {
+    type: string;
+    name: string;
+    content: string;
+    confidence?: string;
+    source?: string;
+    tags?: string;
+    domain?: string;
+}): Promise<void>;
+export declare function semanticForget(id: string, opts: SemanticOptions): Promise<void>;
+export declare function semanticStats(opts: SemanticOptions): Promise<void>;
+export declare function semanticExport(opts: SemanticOptions & {
+    output?: string;
+}): Promise<void>;
+export declare function semanticDecay(opts: SemanticOptions): Promise<void>;
+export {};
+//# sourceMappingURL=semantic.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"semantic.d.ts","sourceRoot":"","sources":["../../src/commands/semantic.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAQH,UAAU,eAAe;IACvB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAeD,wBAAsB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,GAAG;IAC1E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,GAAG,OAAO,CAAC,IAAI,CAAC,CA0ChB;AAED,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,eAAe,GAAG;IAC7D,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAAC,IAAI,CAAC,CA0BhB;AAED,wBAAsB,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAsBrF;AAED,wBAAsB,aAAa,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CA6BxE;AAED,wBAAsB,cAAc,CAAC,IAAI,EAAE,eAAe,GAAG;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAsB/F;AAED,wBAAsB,aAAa,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAwBxE"}