kairo-mcp 1.3.0

package/dist/core/vector/types.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Vector / semantic memory model (v0.6.0). See ADR-0005 and docs/VECTOR_MEMORY.md.
+ * This is architecture-aware hybrid recall, NOT naive RAG.
+ */
+/** The five memory classes from the brief. */
+export type MemoryKind = 'structural' | 'semantic' | 'session' | 'decision' | 'operational';
+/**
+ * An architecture-aware semantic object — not a raw file slice. `text` is what gets
+ * embedded; the rest drives hybrid ranking and explanations.
+ */
+export interface MemoryChunk {
+    id: string;
+    kind: MemoryKind;
+    /** Repo-relative path or logical locator (e.g. a module-graph group). */
+    locator: string;
+    /** Enriched embeddable text (summary + structural context, not raw dump). */
+    text: string;
+    /** Salience [0,1+] from the salience subsystem (ADR-0004). */
+    salience: number;
+    /** Graph degree of the owning module group, if any. */
+    graphDegree: number;
+    /** True if reachable from a runtime entry point. */
+    runtimeReachable: boolean;
+    /** Module-graph neighbours (group labels) for dependency-proximity ranking. */
+    neighbors: string[];
+    /** ISO timestamp for session/decision recency; omitted for static structure. */
+    ts?: string;
+    /**
+     * Coordination namespace (v0.7.0). `workspace` (or omitted) = shared knowledge
+     * visible to all workers; a worker id = private session memory, isolated unless
+     * the searching worker matches. Deterministic filter, not a ranking change.
+     */
+    namespace?: string;
+}
+export interface EmbeddedChunk extends MemoryChunk {
+    vector: number[];
+}
+/** Pluggable embedder. Default impl is deterministic + local (ADR-0005). */
+export interface Embedder {
+    /** Stable id incl. version; stored with the index to detect provider changes. */
+    readonly id: string;
+    readonly dim: number;
+    /** Pure for the deterministic default: same input → same vector, always. */
+    embed(text: string): number[];
+}
+export interface VectorIndex {
+    schema: 3;
+    /** Repo fingerprint this index was built for (anti-recompute key). */
+    fingerprint: string;
+    /**
+     * Deterministic hash of the built chunk set (v0.7.1). Captures session/decision/
+     * checkpoint/namespace changes that the repo fingerprint does NOT, so cross-worker
+     * memory cannot go stale while still skipping the embed step on a true match.
+     */
+    memoryFingerprint: string;
+    embedderId: string;
+    dim: number;
+    builtAt: string;
+    chunks: EmbeddedChunk[];
+}
+export interface VectorStore {
+    save(index: VectorIndex): Promise<void>;
+    load(): Promise<VectorIndex | undefined>;
+}
+export interface RankFactor {
+    name: string;
+    /** Normalised [0,1] contribution before weighting. */
+    raw: number;
+    weight: number;
+    weighted: number;
+    note?: string;
+}
+export interface RetrievalResult {
+    chunk: MemoryChunk;
+    score: number;
+    similarity: number;
+    factors: RankFactor[];
+    /** Human-readable "why this ranked here". */
+    why: string;
+}
+export interface RetrievalQuery {
+    text: string;
+    limit?: number;
+    /** Optional bias toward a memory class. */
+    kind?: MemoryKind;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/core/vector/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/core/vector/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,8CAA8C;AAC9C,MAAM,MAAM,UAAU,GAAG,YAAY,GAAG,UAAU,GAAG,SAAS,GAAG,UAAU,GAAG,aAAa,CAAC;AAE5F;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,UAAU,CAAC;IACjB,yEAAyE;IACzE,OAAO,EAAE,MAAM,CAAC;IAChB,6EAA6E;IAC7E,IAAI,EAAE,MAAM,CAAC;IACb,8DAA8D;IAC9D,QAAQ,EAAE,MAAM,CAAC;IACjB,uDAAuD;IACvD,WAAW,EAAE,MAAM,CAAC;IACpB,oDAAoD;IACpD,gBAAgB,EAAE,OAAO,CAAC;IAC1B,+EAA+E;IAC/E,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,gFAAgF;IAChF,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,aAAc,SAAQ,WAAW;IAChD,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,4EAA4E;AAC5E,MAAM,WAAW,QAAQ;IACvB,iFAAiF;IACjF,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,4EAA4E;IAC5E,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,CAAC,CAAC;IACV,sEAAsE;IACtE,WAAW,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,iBAAiB,EAAE,MAAM,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,aAAa,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,IAAI,IAAI,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC,CAAC;CAC1C;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,sDAAsD;IACtD,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,WAAW,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,6CAA6C;IAC7C,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2CAA2C;IAC3C,IAAI,CAAC,EAAE,UAAU,CAAC;CACnB"}

package/dist/core/vector/types.js

@@ -0,0 +1,6 @@
+/**
+ * Vector / semantic memory model (v0.6.0). See ADR-0005 and docs/VECTOR_MEMORY.md.
+ * This is architecture-aware hybrid recall, NOT naive RAG.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/core/vector/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/core/vector/types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,30 @@
+#!/usr/bin/env node
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { FileStorageAdapter } from './storage/fileStorageAdapter.js';
+import { withRedaction } from './storage/redactingAdapter.js';
+import { SessionManager } from './core/session/sessionManager.js';
+import { createServer, SERVER_VERSION } from './server/createServer.js';
+import { resolveProjectRoot } from './storage/paths.js';
+import { systemClock } from './utils/time.js';
+import { logger } from './utils/logger.js';
+async function main() {
+    const projectRoot = resolveProjectRoot();
+    const adapter = withRedaction(new FileStorageAdapter(projectRoot), systemClock);
+    const sessions = new SessionManager(adapter, systemClock);
+    await sessions.init();
+    const server = createServer(sessions);
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    logger.info(`Kairo v${SERVER_VERSION} ready (stdio)`, { projectRoot });
+    const shutdown = (signal) => {
+        logger.info(`Received ${signal}, shutting down`);
+        void server.close().finally(() => process.exit(0));
+    };
+    process.on('SIGINT', () => shutdown('SIGINT'));
+    process.on('SIGTERM', () => shutdown('SIGTERM'));
+}
+main().catch((err) => {
+    logger.error('Fatal startup error', err instanceof Error ? err.message : String(err));
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AACrE,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAClE,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AACxE,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAE3C,KAAK,UAAU,IAAI;IACjB,MAAM,WAAW,GAAG,kBAAkB,EAAE,CAAC;IACzC,MAAM,OAAO,GAAG,aAAa,CAAC,IAAI,kBAAkB,CAAC,WAAW,CAAC,EAAE,WAAW,CAAC,CAAC;IAChF,MAAM,QAAQ,GAAG,IAAI,cAAc,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;IAC1D,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;IAEtB,MAAM,MAAM,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC;IACtC,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAEhC,MAAM,CAAC,IAAI,CAAC,UAAU,cAAc,gBAAgB,EAAE,EAAE,WAAW,EAAE,CAAC,CAAC;IAEvE,MAAM,QAAQ,GAAG,CAAC,MAAc,EAAQ,EAAE;QACxC,MAAM,CAAC,IAAI,CAAC,YAAY,MAAM,iBAAiB,CAAC,CAAC;QACjD,KAAK,MAAM,CAAC,KAAK,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IACrD,CAAC,CAAC;IACF,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC/C,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC;AACnD,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;IAC5B,MAAM,CAAC,KAAK,CAAC,qBAAqB,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;IACtF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/inspect/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/inspect/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/inspect/cli.ts"],"names":[],"mappings":""}

package/dist/inspect/cli.js

@@ -0,0 +1,40 @@
+#!/usr/bin/env node
+import { startInspectServer } from './server.js';
+import { resolveProjectRoot } from '../storage/paths.js';
+function parseArgs(argv) {
+    let port = Number(process.env.KAIRO_INSPECT_PORT ?? 4173);
+    let host = process.env.KAIRO_INSPECT_HOST ?? '127.0.0.1';
+    let projectRoot = resolveProjectRoot();
+    for (let i = 0; i < argv.length; i++) {
+        const a = argv[i];
+        if (a === '--port' || a === '-p')
+            port = Number(argv[++i]);
+        else if (a === '--host')
+            host = String(argv[++i]);
+        else if (a === '--project' || a === '-C')
+            projectRoot = String(argv[++i]);
+        else if (a === '--help' || a === '-h') {
+            process.stdout.write(`kairo-inspect — local read-only inspector for .kairo/ (v0.9.0, ADR-0011)
+Usage: kairo-inspect [--port 4173] [--host 127.0.0.1] [--project .]
+Loopback only by default. No network egress, no remote assets.\n`);
+            process.exit(0);
+        }
+    }
+    return { port, host, projectRoot };
+}
+async function main() {
+    const { port, host, projectRoot } = parseArgs(process.argv.slice(2));
+    const h = await startInspectServer({ port, host, projectRoot });
+    process.stdout.write(`Kairo Inspect at ${h.url}  (project: ${projectRoot})\n`);
+    process.stdout.write('Read-only · no network · Ctrl+C to stop\n');
+    const shutdown = () => {
+        void h.close().finally(() => process.exit(0));
+    };
+    process.on('SIGINT', shutdown);
+    process.on('SIGTERM', shutdown);
+}
+main().catch((err) => {
+    process.stderr.write(`Inspector failed: ${err instanceof Error ? err.message : String(err)}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/inspect/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../src/inspect/cli.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAQzD,SAAS,SAAS,CAAC,IAAc;IAC/B,IAAI,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,IAAI,CAAC,CAAC;IAC1D,IAAI,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,WAAW,CAAC;IACzD,IAAI,WAAW,GAAG,kBAAkB,EAAE,CAAC;IACvC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,IAAI,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI;YAAE,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;aACtD,IAAI,CAAC,KAAK,QAAQ;YAAE,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;aAC7C,IAAI,CAAC,KAAK,WAAW,IAAI,CAAC,KAAK,IAAI;YAAE,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;aACrE,IAAI,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;YACtC,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB;;iEAEyD,CAC1D,CAAC;YACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;AACrC,CAAC;AAED,KAAK,UAAU,IAAI;IACjB,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,GAAG,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACrE,MAAM,CAAC,GAAG,MAAM,kBAAkB,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC;IAChE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC,GAAG,eAAe,WAAW,KAAK,CAAC,CAAC;IAC/E,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,2CAA2C,CAAC,CAAC;IAClE,MAAM,QAAQ,GAAG,GAAS,EAAE;QAC1B,KAAK,CAAC,CAAC,KAAK,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IAChD,CAAC,CAAC;IACF,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAC/B,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;AAClC,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;IAC5B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,qBAAqB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAChG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/inspect/projections.d.ts

@@ -0,0 +1,141 @@
+import { type KairoPaths } from '../storage/paths.js';
+import type { EventFilter, TimelineEntry, TimelineKind, UnifiedEvent, ConflictEntry, LineageNode, RetrievalTrace } from '../core/query/types.js';
+import type { Checkpoint, SessionState } from '../types/domain.js';
+/**
+ * Pure deterministic projections shared by every developer surface (web
+ * inspector + VS Code extension). Read-only over `.kairo/`. No mutation, no
+ * new state — ADR-0011.
+ *
+ * Every method is idempotent and replay-safe: given the same `.kairo/`
+ * contents, the returned objects are byte-identical.
+ */
+export declare class InspectProjection {
+    readonly paths: KairoPaths;
+    private readonly adapter;
+    constructor(projectRoot?: string);
+    /** Does this project have a `.kairo/` directory at all? */
+    hasKairo(): boolean;
+    overview(): Promise<InspectOverview>;
+    listSessions(): Promise<SessionListEntry[]>;
+    getSession(id: string): Promise<SessionState | undefined>;
+    listCheckpoints(): Promise<CheckpointListEntry[]>;
+    getCheckpoint(id: string): Promise<Checkpoint | undefined>;
+    latestCheckpoint(): Promise<Checkpoint | undefined>;
+    readContinuation(name: string): Promise<string | undefined>;
+    listContinuations(): Promise<string[]>;
+    readGraph(kind: string): Promise<GraphSummary | undefined>;
+    listGraphs(): Promise<string[]>;
+    events(filter?: EventFilter): Promise<UnifiedEvent[]>;
+    timeline(kind: TimelineKind): Promise<TimelineEntry[]>;
+    conflicts(): Promise<ConflictEntry[]>;
+    retrieval(eventId: string): Promise<RetrievalTrace | undefined>;
+    lineage(checkpointId: string): Promise<LineageNode[]>;
+    coordination(): Promise<CoordinationSnapshot>;
+    risk(): Promise<RiskSnapshot>;
+    /** Memory chunks summary read directly from the vector index. */
+    memoryIndex(): Promise<MemoryIndexSnapshot | undefined>;
+    private readIntelligence;
+    private queryInputs;
+}
+export interface InspectOverview {
+    projectRoot: string;
+    hasKairo: boolean;
+    eventCount: number;
+    telemetryCount: number;
+    sessionCount: number;
+    checkpointCount: number;
+    /** Number of quarantined corrupt/invalid records under `.kairo/quarantine/` (ADR-0012). */
+    quarantineCount: number;
+    latestCheckpointId: string | undefined;
+    latestSessionId: string | undefined;
+    intelligence: IntelligenceSummary | undefined;
+}
+export interface IntelligenceSummary {
+    schema: number;
+    frameworks: string[];
+    languages: string[];
+    files: number;
+    truncated: boolean;
+}
+export interface SessionListEntry {
+    id: string;
+    agent: string;
+    task: string;
+    status: SessionState['status'];
+    startedAt: string;
+    lastActivityAt: string;
+    changedFiles: number;
+    decisions: number;
+    errors: number;
+}
+export interface CheckpointListEntry {
+    id: string;
+    sessionId: string;
+    agent: string;
+    ownerWorkerId?: string;
+    reason: string;
+    riskLevel: 'low' | 'medium' | 'high';
+    riskScore: number;
+    createdAt: string;
+    task: string;
+    continuationRef: string;
+    parentCheckpointId?: string;
+    changedFiles: number;
+}
+export interface GraphSummary {
+    kind: string;
+    nodes: number;
+    edges: number;
+    mermaid: string;
+    mirrorPath: string;
+}
+export interface LeaseSnapshot {
+    leaseId: string;
+    scope: string;
+    scopeKind: string;
+    holder: string;
+    acquiredAt: string;
+    expiresAt: string;
+    status: 'active' | 'released' | 'expired' | 'superseded';
+}
+export interface WorkerSnapshot {
+    workerId: string;
+    namespace: string;
+    agent: string;
+    lastSeen: string;
+}
+export interface CoordinationSnapshot {
+    activeLeases: LeaseSnapshot[];
+    allLeases: LeaseSnapshot[];
+    knownWorkers: WorkerSnapshot[];
+    conflicts: ConflictEntry[];
+}
+export interface RiskEscalation {
+    checkpointId: string;
+    sessionId: string;
+    createdAt: string;
+    level: 'low' | 'medium' | 'high';
+    score: number;
+    task: string;
+}
+export interface RiskSnapshot {
+    escalations: RiskEscalation[];
+    byLevel: {
+        low: number;
+        medium: number;
+        high: number;
+    };
+}
+export interface MemoryIndexSnapshot {
+    embedder: string;
+    fingerprint: string;
+    chunkCount: number;
+    byKind: Record<string, number>;
+    topChunks: Array<{
+        id: string;
+        kind: string;
+        locator: string;
+        salience: number;
+    }>;
+}
+//# sourceMappingURL=projections.d.ts.map

package/dist/inspect/projections.d.ts.map

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

package/dist/inspect/projections.js

@@ -0,0 +1,311 @@
+import { readFile, readdir } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { kairoPaths } from '../storage/paths.js';
+import { FileStorageAdapter } from '../storage/fileStorageAdapter.js';
+import { CoordinationManager } from '../core/coordination/coordinationManager.js';
+import { systemClock } from '../utils/time.js';
+import { buildSessionToWorker, queryEvents, timeline, conflictHistory, retrievalTrace, checkpointLineage, } from '../core/query/queryEngine.js';
+/**
+ * Pure deterministic projections shared by every developer surface (web
+ * inspector + VS Code extension). Read-only over `.kairo/`. No mutation, no
+ * new state — ADR-0011.
+ *
+ * Every method is idempotent and replay-safe: given the same `.kairo/`
+ * contents, the returned objects are byte-identical.
+ */
+export class InspectProjection {
+    paths;
+    adapter;
+    constructor(projectRoot) {
+        this.paths = kairoPaths(projectRoot);
+        this.adapter = new FileStorageAdapter(this.paths.root);
+    }
+    /** Does this project have a `.kairo/` directory at all? */
+    hasKairo() {
+        return existsSync(this.paths.base);
+    }
+    async overview() {
+        if (!this.hasKairo()) {
+            return {
+                projectRoot: this.paths.root,
+                hasKairo: false,
+                eventCount: 0,
+                telemetryCount: 0,
+                sessionCount: 0,
+                checkpointCount: 0,
+                quarantineCount: 0,
+                latestCheckpointId: undefined,
+                latestSessionId: undefined,
+                intelligence: undefined,
+            };
+        }
+        const [events, telemetry] = await Promise.all([
+            this.adapter.readEvents(),
+            this.adapter.readTelemetry(),
+        ]);
+        const sessionFiles = await safeReaddir(this.paths.sessionsDir);
+        const checkpointFiles = await safeReaddir(this.paths.checkpointsDir);
+        const latestCheckpoint = await this.latestCheckpoint();
+        const latestSessionEv = [...events].reverse().find((e) => e.type === 'session.started');
+        const intelligence = await this.readIntelligence();
+        const quarantineFiles = await safeReaddir(this.paths.quarantineDir);
+        let quarantineCount = 0;
+        for (const f of quarantineFiles) {
+            if (!f.endsWith('.jsonl'))
+                continue;
+            try {
+                const raw = await readFile(join(this.paths.quarantineDir, f), 'utf8');
+                quarantineCount += raw.split('\n').filter((l) => l.trim().length > 0).length;
+            }
+            catch {
+                /* ignore */
+            }
+        }
+        return {
+            projectRoot: this.paths.root,
+            hasKairo: true,
+            eventCount: events.length,
+            telemetryCount: telemetry.length,
+            sessionCount: sessionFiles.filter((f) => f.endsWith('.json')).length,
+            checkpointCount: checkpointFiles.filter((f) => f.endsWith('.json')).length,
+            quarantineCount,
+            latestCheckpointId: latestCheckpoint?.id,
+            latestSessionId: latestSessionEv?.sessionId,
+            intelligence,
+        };
+    }
+    async listSessions() {
+        const files = await safeReaddir(this.paths.sessionsDir);
+        const out = [];
+        for (const f of files.filter((x) => x.endsWith('.json')).sort()) {
+            const s = await this.adapter.loadSessionSnapshot(f.replace(/\.json$/, ''));
+            if (!s)
+                continue;
+            out.push({
+                id: s.id,
+                agent: s.agent,
+                task: s.task,
+                status: s.status,
+                startedAt: s.startedAt,
+                lastActivityAt: s.lastActivityAt,
+                changedFiles: Object.keys(s.changedFiles).length,
+                decisions: s.decisions.length,
+                errors: s.errors.length,
+            });
+        }
+        return out.sort((a, b) => a.startedAt.localeCompare(b.startedAt));
+    }
+    async getSession(id) {
+        return this.adapter.loadSessionSnapshot(id);
+    }
+    async listCheckpoints() {
+        const files = await safeReaddir(this.paths.checkpointsDir);
+        const out = [];
+        for (const f of files.filter((x) => x.endsWith('.json')).sort()) {
+            const cp = await this.adapter.loadCheckpoint(f.replace(/\.json$/, ''));
+            if (!cp)
+                continue;
+            const entry = {
+                id: cp.id,
+                sessionId: cp.sessionId,
+                agent: cp.agent,
+                reason: cp.reason,
+                riskLevel: cp.risk.level,
+                riskScore: cp.risk.score,
+                createdAt: cp.createdAt,
+                task: cp.task,
+                continuationRef: cp.continuationRef,
+                changedFiles: cp.changedFiles.length,
+            };
+            if (cp.ownerWorkerId)
+                entry.ownerWorkerId = cp.ownerWorkerId;
+            if (cp.parentCheckpointId)
+                entry.parentCheckpointId = cp.parentCheckpointId;
+            out.push(entry);
+        }
+        return out.sort((a, b) => a.createdAt.localeCompare(b.createdAt));
+    }
+    async getCheckpoint(id) {
+        return this.adapter.loadCheckpoint(id);
+    }
+    async latestCheckpoint() {
+        const list = await this.listCheckpoints();
+        const last = list[list.length - 1];
+        return last ? this.adapter.loadCheckpoint(last.id) : undefined;
+    }
+    async readContinuation(name) {
+        try {
+            return await readFile(this.paths.continuationFile(name), 'utf8');
+        }
+        catch {
+            return undefined;
+        }
+    }
+    async listContinuations() {
+        const files = await safeReaddir(this.paths.continuationsDir);
+        return files.filter((f) => f.endsWith('.md')).sort();
+    }
+    async readGraph(kind) {
+        try {
+            const md = await readFile(this.paths.graphFile(kind), 'utf8');
+            const { nodes, edges } = countMermaid(md);
+            return { kind, nodes, edges, mermaid: md, mirrorPath: this.paths.graphFile(kind) };
+        }
+        catch {
+            return undefined;
+        }
+    }
+    async listGraphs() {
+        const files = await safeReaddir(this.paths.graphsDir);
+        return files.filter((f) => f.endsWith('.md')).map((f) => f.replace(/\.md$/, ''));
+    }
+    async events(filter = {}) {
+        return queryEvents(filter, await this.queryInputs());
+    }
+    async timeline(kind) {
+        return timeline(kind, await this.queryInputs());
+    }
+    async conflicts() {
+        return conflictHistory(await this.queryInputs());
+    }
+    async retrieval(eventId) {
+        return retrievalTrace(eventId, await this.queryInputs());
+    }
+    async lineage(checkpointId) {
+        return checkpointLineage(checkpointId, (id) => this.adapter.loadCheckpoint(id));
+    }
+    async coordination() {
+        const coord = new CoordinationManager(this.adapter, systemClock);
+        const state = await coord.state();
+        return {
+            activeLeases: state.activeLeases.map((l) => ({
+                leaseId: l.id,
+                scope: l.scope,
+                scopeKind: l.scopeKind,
+                holder: l.workerId,
+                acquiredAt: l.acquiredAt,
+                expiresAt: l.expiresAt,
+                status: l.status,
+            })),
+            allLeases: state.allLeases.map((l) => ({
+                leaseId: l.id,
+                scope: l.scope,
+                scopeKind: l.scopeKind,
+                holder: l.workerId,
+                acquiredAt: l.acquiredAt,
+                expiresAt: l.expiresAt,
+                status: l.status,
+            })),
+            knownWorkers: state.workers.map((w) => ({
+                workerId: w.workerId,
+                namespace: w.namespace,
+                agent: w.agent,
+                lastSeen: w.lastSeen,
+            })),
+            conflicts: await this.conflicts(),
+        };
+    }
+    async risk() {
+        const checkpoints = await this.listCheckpoints();
+        const escalations = [];
+        for (const cp of checkpoints) {
+            if (cp.riskLevel === 'medium' || cp.riskLevel === 'high') {
+                escalations.push({
+                    checkpointId: cp.id,
+                    sessionId: cp.sessionId,
+                    createdAt: cp.createdAt,
+                    level: cp.riskLevel,
+                    score: cp.riskScore,
+                    task: cp.task,
+                });
+            }
+        }
+        return {
+            escalations: escalations.sort((a, b) => b.createdAt.localeCompare(a.createdAt)),
+            byLevel: {
+                low: checkpoints.filter((c) => c.riskLevel === 'low').length,
+                medium: checkpoints.filter((c) => c.riskLevel === 'medium').length,
+                high: checkpoints.filter((c) => c.riskLevel === 'high').length,
+            },
+        };
+    }
+    /** Memory chunks summary read directly from the vector index. */
+    async memoryIndex() {
+        try {
+            const raw = await readFile(this.paths.vectorIndexFile, 'utf8');
+            const idx = JSON.parse(raw);
+            const chunks = idx.chunks ?? [];
+            const byKind = {};
+            for (const c of chunks) {
+                const k = c.kind ?? 'unknown';
+                byKind[k] = (byKind[k] ?? 0) + 1;
+            }
+            return {
+                embedder: idx.embedder ?? 'unknown',
+                fingerprint: idx.fingerprint ?? '',
+                chunkCount: chunks.length,
+                byKind,
+                topChunks: chunks
+                    .slice()
+                    .sort((a, b) => (b.salience ?? 0) - (a.salience ?? 0))
+                    .slice(0, 20)
+                    .map((c) => ({
+                    id: c.id ?? '',
+                    kind: c.kind ?? 'unknown',
+                    locator: c.locator ?? '',
+                    salience: c.salience ?? 0,
+                })),
+            };
+        }
+        catch {
+            return undefined;
+        }
+    }
+    async readIntelligence() {
+        try {
+            const raw = await readFile(this.paths.latestIntelligenceFile, 'utf8');
+            const intel = JSON.parse(raw);
+            return {
+                schema: intel.schema ?? 0,
+                frameworks: (intel.frameworks ?? []).map((f) => f.id),
+                languages: (intel.languages ?? []).map((l) => l.name),
+                files: intel.files ?? 0,
+                truncated: !!intel.truncated,
+            };
+        }
+        catch {
+            return undefined;
+        }
+    }
+    async queryInputs() {
+        const [events, telemetry, audit] = await Promise.all([
+            this.adapter.readEvents(),
+            this.adapter.readTelemetry(),
+            this.adapter.readAudit(),
+        ]);
+        return { events, telemetry, audit, sessionToWorker: buildSessionToWorker(events) };
+    }
+}
+async function safeReaddir(p) {
+    try {
+        return await readdir(p);
+    }
+    catch {
+        return [];
+    }
+}
+function countMermaid(md) {
+    // Heuristic deterministic count over the mermaid block.
+    const m = md.match(/```mermaid\n([\s\S]*?)```/);
+    const body = m && m[1] !== undefined ? m[1] : md;
+    const edges = (body.match(/-->|---|==>|-\.->|:::/g) ?? []).filter((s) => s !== ':::').length;
+    const nodeIds = new Set();
+    for (const line of body.split('\n')) {
+        const ids = line.match(/\b[A-Za-z_][A-Za-z0-9_]*(?=\[|\(|\{)/g) ?? [];
+        for (const id of ids)
+            nodeIds.add(id);
+    }
+    return { nodes: nodeIds.size, edges };
+}
+//# sourceMappingURL=projections.js.map