wotann 0.5.0 → 0.5.39

package/dist/desktop/supabase-relay.js

@@ -1,335 +0,0 @@
-/**
- * Supabase Realtime Relay — enables iOS connectivity when not on same WiFi.
- *
- * Architecture:
- * - Desktop KAIROS publishes RPC responses to a Supabase Realtime channel
- * - iOS subscribes to the same channel
- * - All traffic E2E encrypted with existing ECDH keys (Supabase sees only encrypted blobs)
- * - Auto-configured on first QR pairing — user never sees Supabase
- *
- * Free tier: 500MB database, 2GB bandwidth, unlimited real-time connections
- */
-import { readFileSync, existsSync, mkdirSync } from "node:fs";
-import { writeFileAtomic } from "../utils/atomic-io.js";
-import { join } from "node:path";
-import { resolveWotannHome } from "../utils/wotann-home.js";
-import WebSocket from "ws";
-// ── Constants ────────────────────────────────────────────
-const HEARTBEAT_INTERVAL_MS = 30_000;
-const RECONNECT_BASE_MS = 1_000;
-const RECONNECT_MAX_MS = 60_000;
-const WS_OPEN = 1;
-// ── Relay Manager ────────────────────────────────────────
-export class SupabaseRelay {
-    config = null;
-    connected = false;
-    configPath;
-    onMessageCallback = null;
-    ws = null;
-    heartbeatTimer = null;
-    reconnectTimer = null;
-    reconnectAttempt = 0;
-    refCounter = 0;
-    joinRef = null;
-    intentionalDisconnect = false;
-    constructor() {
-        const wotannDir = resolveWotannHome();
-        this.configPath = join(wotannDir, "relay.json");
-    }
-    /**
-     * Load relay configuration from disk.
-     * Returns false if no config exists (relay not set up).
-     */
-    loadConfig() {
-        if (!existsSync(this.configPath)) {
-            return false;
-        }
-        try {
-            const content = readFileSync(this.configPath, "utf-8");
-            this.config = JSON.parse(content);
-            return true;
-        }
-        catch {
-            return false;
-        }
-    }
-    /**
-     * Auto-configure relay during QR pairing.
-     * Generates a unique channel ID and stores the config.
-     */
-    autoConfigureOnPair(devicePairId) {
-        // Supabase relay credentials must be configured via ~/.wotann/wotann.yaml
-        // or the desktop app Settings > Remote Relay.
-        // No hardcoded defaults — relay is disabled until configured.
-        const DEFAULT_SUPABASE_URL = "";
-        const DEFAULT_SUPABASE_KEY = "";
-        const config = {
-            // iOS team expects SUPABASE_URL / SUPABASE_ANON_KEY. Fall back to the
-            // legacy WOTANN_SUPABASE_* names so existing installs keep working
-            // while users migrate their env files.
-            supabaseUrl: process.env.SUPABASE_URL ?? process.env.WOTANN_SUPABASE_URL ?? DEFAULT_SUPABASE_URL,
-            supabaseAnonKey: process.env.SUPABASE_ANON_KEY ??
-                process.env.WOTANN_SUPABASE_ANON_KEY ??
-                DEFAULT_SUPABASE_KEY,
-            channelId: `wotann-relay-${devicePairId.slice(0, 8)}`,
-            devicePairId,
-        };
-        // Persist to disk
-        const dir = resolveWotannHome();
-        if (!existsSync(dir)) {
-            mkdirSync(dir, { recursive: true });
-        }
-        // Wave 6.5-UU (H-22) — Supabase relay credentials. Atomic write so
-        // a crash mid-save doesn't break iOS relay on next start.
-        writeFileAtomic(this.configPath, JSON.stringify(config, null, 2));
-        this.config = config;
-        return config;
-    }
-    // ── Private helpers ──────────────────────────────────
-    nextRef() {
-        this.refCounter += 1;
-        return String(this.refCounter);
-    }
-    topic() {
-        return `realtime:${this.config.channelId}`;
-    }
-    /** Build the Supabase Realtime WebSocket URL from an HTTPS project URL. */
-    buildWsUrl() {
-        // this.config!.supabaseUrl looks like "https://xxx.supabase.co"
-        const httpsUrl = this.config.supabaseUrl.replace(/\/$/, "");
-        const wsUrl = httpsUrl.replace(/^https:\/\//, "wss://");
-        return `${wsUrl}/realtime/v1/websocket?apikey=${this.config.supabaseAnonKey}&vsn=1.0.0`;
-    }
-    /** Send a JSON message over the WebSocket. */
-    wsSend(msg) {
-        if (this.ws && this.ws.readyState === WS_OPEN) {
-            this.ws.send(JSON.stringify(msg));
-        }
-    }
-    /** Join the Phoenix channel after the WebSocket opens. */
-    sendJoin() {
-        this.joinRef = this.nextRef();
-        this.wsSend({
-            topic: this.topic(),
-            event: "phx_join",
-            payload: { config: { broadcast: { self: false } } },
-            ref: this.joinRef,
-        });
-    }
-    /** Start the 30-second heartbeat loop. */
-    startHeartbeat() {
-        this.stopHeartbeat();
-        this.heartbeatTimer = setInterval(() => {
-            this.wsSend({
-                topic: "phoenix",
-                event: "heartbeat",
-                payload: {},
-                ref: "heartbeat",
-            });
-        }, HEARTBEAT_INTERVAL_MS);
-    }
-    stopHeartbeat() {
-        if (this.heartbeatTimer) {
-            clearInterval(this.heartbeatTimer);
-            this.heartbeatTimer = null;
-        }
-    }
-    /** Handle a raw incoming WebSocket message. */
-    handleMessage(raw) {
-        let parsed;
-        try {
-            parsed = JSON.parse(raw);
-        }
-        catch {
-            return; // Ignore non-JSON frames
-        }
-        const event = parsed.event;
-        // Join acknowledgement
-        if (event === "phx_reply" && parsed.ref === this.joinRef) {
-            const resp = parsed.payload;
-            if (resp?.status === "ok") {
-                this.connected = true;
-                this.reconnectAttempt = 0;
-                console.log(`Supabase relay connected: channel ${this.config.channelId}`);
-            }
-            else {
-                console.error("Supabase relay join rejected:", resp);
-            }
-            return;
-        }
-        // Incoming broadcast from iOS
-        if (event === "broadcast") {
-            const outer = parsed.payload;
-            if (outer?.event === "relay" && outer.payload && this.onMessageCallback) {
-                const relayMsg = outer.payload;
-                this.onMessageCallback(relayMsg);
-            }
-            return;
-        }
-        // System messages (phx_error, phx_close) — trigger reconnect
-        if (event === "phx_error" || event === "phx_close") {
-            this.handleDisconnect();
-        }
-    }
-    /** Schedule a reconnection with exponential backoff. */
-    scheduleReconnect() {
-        if (this.intentionalDisconnect)
-            return;
-        if (this.reconnectTimer)
-            return;
-        const delay = Math.min(RECONNECT_BASE_MS * Math.pow(2, this.reconnectAttempt), RECONNECT_MAX_MS);
-        this.reconnectAttempt += 1;
-        console.log(`Supabase relay reconnecting in ${delay}ms (attempt ${this.reconnectAttempt})`);
-        this.reconnectTimer = setTimeout(() => {
-            this.reconnectTimer = null;
-            void this.connect().catch(() => {
-                // connect() handles its own errors; schedule next retry
-                this.scheduleReconnect();
-            });
-        }, delay);
-    }
-    /** Clean up after an unexpected disconnect. */
-    handleDisconnect() {
-        this.connected = false;
-        this.stopHeartbeat();
-        this.ws = null;
-        this.scheduleReconnect();
-    }
-    // ── Public API ───────────────────────────────────────
-    /**
-     * Connect to the Supabase Realtime channel via raw WebSocket.
-     * Uses the Phoenix Channels protocol — no Supabase SDK required.
-     * All messages are E2E encrypted — Supabase only sees encrypted blobs.
-     */
-    async connect() {
-        if (!this.config?.supabaseUrl || !this.config?.supabaseAnonKey) {
-            console.log("Supabase relay not configured — remote access unavailable");
-            return false;
-        }
-        // Tear down any existing connection cleanly
-        if (this.ws) {
-            try {
-                this.ws.close();
-            }
-            catch {
-                /* ignore */
-            }
-            this.ws = null;
-        }
-        this.stopHeartbeat();
-        this.intentionalDisconnect = false;
-        const wsUrl = this.buildWsUrl();
-        return new Promise((resolve) => {
-            try {
-                const ws = new WebSocket(wsUrl);
-                this.ws = ws;
-                let resolved = false;
-                ws.on("open", () => {
-                    this.sendJoin();
-                    this.startHeartbeat();
-                });
-                ws.on("message", (...args) => {
-                    const data = args[0];
-                    const raw = typeof data === "string"
-                        ? data
-                        : Buffer.isBuffer(data)
-                            ? data.toString("utf-8")
-                            : String(data);
-                    this.handleMessage(raw);
-                    // Resolve the connect() promise once we get a successful join reply
-                    if (!resolved && this.connected) {
-                        resolved = true;
-                        resolve(true);
-                    }
-                });
-                ws.on("close", () => {
-                    if (!resolved) {
-                        resolved = true;
-                        resolve(false);
-                    }
-                    this.handleDisconnect();
-                });
-                ws.on("error", (err) => {
-                    console.error("Supabase relay WebSocket error:", err);
-                    if (!resolved) {
-                        resolved = true;
-                        resolve(false);
-                    }
-                });
-                // Timeout: if join hasn't been acknowledged in 10s, give up this attempt
-                setTimeout(() => {
-                    if (!resolved) {
-                        resolved = true;
-                        resolve(false);
-                        this.handleDisconnect();
-                    }
-                }, 10_000);
-            }
-            catch (error) {
-                console.error("Supabase relay connection failed:", error);
-                resolve(false);
-                this.scheduleReconnect();
-            }
-        });
-    }
-    /**
-     * Publish an encrypted RPC response to the channel.
-     * iOS subscriber receives it in real-time via Phoenix broadcast.
-     */
-    async publish(encryptedPayload) {
-        if (!this.connected || !this.config)
-            return;
-        const message = {
-            type: "rpc-response",
-            payload: encryptedPayload,
-            timestamp: Date.now(),
-            sender: "desktop",
-        };
-        this.wsSend({
-            topic: this.topic(),
-            event: "broadcast",
-            payload: {
-                type: "broadcast",
-                event: "relay",
-                payload: message,
-            },
-            ref: this.nextRef(),
-        });
-    }
-    /**
-     * Register a callback for incoming iOS messages.
-     */
-    onMessage(callback) {
-        this.onMessageCallback = callback;
-    }
-    /**
-     * Disconnect from the relay and stop all timers.
-     */
-    disconnect() {
-        this.intentionalDisconnect = true;
-        this.connected = false;
-        this.stopHeartbeat();
-        this.onMessageCallback = null;
-        if (this.reconnectTimer) {
-            clearTimeout(this.reconnectTimer);
-            this.reconnectTimer = null;
-        }
-        if (this.ws) {
-            try {
-                this.ws.close();
-            }
-            catch {
-                /* ignore */
-            }
-            this.ws = null;
-        }
-        console.log("Supabase relay disconnected");
-    }
-    isConnected() {
-        return this.connected;
-    }
-    getConfig() {
-        return this.config;
-    }
-}
-//# sourceMappingURL=supabase-relay.js.map

package/dist/desktop/supabase-relay.js.map

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

package/dist/intelligence/kg-builder.d.ts

@@ -1,181 +0,0 @@
-/**
- * KG-First-Stage Builder — Blitzy port (Phase 2 P1-C3).
- *
- * Blitzy (66.5% SWE-bench Pro) front-loads a knowledge-graph build
- * before any codebase-modification task. The agent queries the KG as a
- * retrieval source alongside normal grep. This module ports that
- * first-stage approach: walk a workspace, extract symbols, build a
- * call/type graph, persist into MemoryStore's knowledge_nodes /
- * knowledge_edges tables, support incremental per-file updates, and
- * expose query helpers (findCallers, findUsages, findDefinition).
- *
- * Design:
- *
- * 1. Symbol extraction is pluggable. We try to dynamic-import the
- *    TypeScript compiler API (if available — it's a devDep of this
- *    repo). If the import fails in a published distribution that strips
- *    devDeps, we fall back to a conservative regex extractor. This is
- *    "honest failures" (Session 2 bar #6): the fallback is declared,
- *    not silent.
- *
- * 2. Builder state is per-workspace (Session 3 bar #11). Each
- *    `new KGBuilder(store, workspaceRoot, opts)` carries its own
- *    include/exclude/parser settings. Two builders over two roots do
- *    not share mutable state.
- *
- * 3. Persistence is delegated to MemoryStore. We populate
- *    knowledge_nodes with entity_type in {"code_symbol", "code_module"}
- *    and a properties JSON payload { kind, filePath, line, exported }.
- *    Edges use relation in {"calls", "uses_type", "imports",
- *    "defined_in"}. Those are additional to P1-M7's
- *    updates/extends/derives human-memory edges; the kinds namespace
- *    does not clash because code relations live alongside in the same
- *    knowledge_edges table and are filtered by relation-string.
- *
- * 4. Incremental update (`updateFile`) re-parses a single file and
- *    rewrites only that file's nodes + edges, so watcher-based
- *    pipelines stay linear-time in changed-file count.
- */
-import type { MemoryStore } from "../memory/store.js";
-/** High-level kind of a code symbol we persist. */
-export type CodeSymbolKind = "function" | "class" | "interface" | "type" | "enum" | "variable" | "method" | "unknown";
-export interface ExtractedSymbol {
-    /** Display name ("MyClass", "renderPrompt"). Unique within a file+kind. */
-    readonly name: string;
-    readonly kind: CodeSymbolKind;
-    /** 1-based line number in the source file where the symbol is defined. */
-    readonly line?: number;
-    /** True when the symbol is `export`ed. */
-    readonly exported: boolean;
-}
-export interface ExtractedImport {
-    /** Source specifier verbatim ("./foo", "node:path"). */
-    readonly specifier: string;
-    /** Named imports (empty when it's a side-effect-only import). */
-    readonly named: readonly string[];
-}
-export interface ExtractedCall {
-    /** Callee name (identifier text at the call site). */
-    readonly callee: string;
-    /** Name of the enclosing function/method when resolvable; "module" at top level. */
-    readonly enclosing: string;
-    readonly line?: number;
-}
-export interface ExtractedTypeRef {
-    /** Referenced type name (e.g. "SessionConfig", "Foo"). */
-    readonly typeName: string;
-    /** Name of the enclosing declaration using the type. */
-    readonly enclosing: string;
-    readonly line?: number;
-}
-export interface FileExtraction {
-    readonly filePath: string;
-    readonly symbols: readonly ExtractedSymbol[];
-    readonly imports: readonly ExtractedImport[];
-    readonly calls: readonly ExtractedCall[];
-    readonly typeRefs: readonly ExtractedTypeRef[];
-    /** Set when parsing failed. Other fields are still present but may be empty. */
-    readonly parseError?: string;
-    /** Which extractor produced this result. */
-    readonly source: "ts-compiler" | "regex";
-}
-export interface BuildOptions {
-    /** Glob-style includes. Default: common TS/JS sources. */
-    readonly includePatterns?: readonly string[];
-    /** Glob-style excludes. Default: node_modules/dist/build. */
-    readonly excludePatterns?: readonly string[];
-    /** Max files to process. Hard stop to avoid runaway walks. */
-    readonly maxFiles?: number;
-    /** Called for each file after extraction (useful for progress UIs). */
-    readonly onFile?: (relPath: string, extraction: FileExtraction) => void;
-    /** When set, forces the regex fallback (useful for tests). */
-    readonly forceRegex?: boolean;
-}
-export interface BuildSummary {
-    readonly filesVisited: number;
-    readonly filesProcessed: number;
-    readonly symbolsInserted: number;
-    readonly edgesInserted: number;
-    readonly parseErrors: readonly {
-        path: string;
-        error: string;
-    }[];
-    readonly extractorUsed: "ts-compiler" | "regex" | "mixed";
-}
-/** Relation strings emitted by this builder into knowledge_edges.relation. */
-export declare const KG_EDGE_RELATIONS: {
-    readonly calls: "code:calls";
-    readonly usesType: "code:uses_type";
-    readonly imports: "code:imports";
-    readonly definedIn: "code:defined_in";
-};
-export declare const KG_NODE_TYPES: {
-    readonly symbol: "code_symbol";
-    readonly module: "code_module";
-};
-/**
- * Conservative regex symbol/call/import extractor. Purposely narrower
- * than the TS compiler API — only picks up obvious patterns. Accepts
- * some false negatives to avoid false positives.
- */
-export declare function extractFromSourceRegex(filePath: string, source: string): FileExtraction;
-/** Visible for tests — lets a test force a "no TS api" state. */
-export declare function _resetTsApiCacheForTests(): void;
-export declare class KGBuilder {
-    private readonly store;
-    private readonly persistence;
-    private readonly workspaceRoot;
-    private readonly includePatterns;
-    private readonly excludePatterns;
-    private readonly maxFiles;
-    private readonly forceRegex;
-    constructor(store: MemoryStore, workspaceRoot: string, options?: Pick<BuildOptions, "includePatterns" | "excludePatterns" | "maxFiles" | "forceRegex">);
-    /**
-     * Walk the workspace, extract symbols from each matched file, and
-     * persist into the knowledge graph. Returns a BuildSummary.
-     */
-    buildForWorkspace(options?: Pick<BuildOptions, "onFile">): Promise<BuildSummary>;
-    /**
-     * Re-parse a single file and replace its contribution to the graph.
-     * Accepts either an absolute path or a workspace-relative path.
-     */
-    updateFile(filePath: string): Promise<{
-        readonly inserted: number;
-        readonly edges: number;
-        readonly parseError?: string;
-    }>;
-    /**
-     * Return the set of symbols (by enclosing name + file) that call
-     * `symbolName` across the workspace. Uses the per-file inventory +
-     * extraction records kept on each buildForWorkspace / updateFile call.
-     */
-    findCallers(symbolName: string): readonly {
-        file: string;
-        enclosing: string;
-        line?: number;
-    }[];
-    /**
-     * Return the set of symbols that reference type `typeName` as a type
-     * argument / annotation.
-     */
-    findUsages(typeName: string): readonly {
-        file: string;
-        enclosing: string;
-        line?: number;
-    }[];
-    /**
-     * Locate where a symbol is defined. Returns `{ file, kind, line }` for
-     * each definition (there may be more than one when the same name is
-     * used across files).
-     */
-    findDefinition(symbolName: string): readonly {
-        file: string;
-        kind: string;
-        line?: number;
-    }[];
-    /** File-paths that have been indexed (workspace-relative). */
-    indexedFiles(): readonly string[];
-    /** Current workspace root (absolute). */
-    getWorkspaceRoot(): string;
-}
-//# sourceMappingURL=kg-builder.d.ts.map

package/dist/intelligence/kg-builder.d.ts.map

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