helixmind 0.5.4

package/dist/cli/brain/instance-manager.d.ts

@@ -0,0 +1,42 @@
+export interface BrainInstance {
+    id: string;
+    name: string;
+    type: 'global' | 'local';
+    path: string;
+    projectPath?: string;
+    createdAt: number;
+    lastAccessedAt: number;
+    nodeCount: number;
+    active: boolean;
+}
+export interface BrainLimits {
+    maxGlobal: number;
+    maxLocal: number;
+    maxActive: number;
+}
+export declare class BrainInstanceManager {
+    private registryPath;
+    private brains;
+    private limits;
+    constructor(baseDir: string);
+    register(opts: {
+        name: string;
+        type: 'global' | 'local';
+        path: string;
+        projectPath?: string;
+    }): BrainInstance;
+    rename(id: string, newName: string): void;
+    remove(id: string): void;
+    activate(id: string): boolean;
+    deactivate(id: string): void;
+    getAll(): BrainInstance[];
+    getById(id: string): BrainInstance | null;
+    getByPath(path: string): BrainInstance | null;
+    updateNodeCount(id: string, count: number): void;
+    getLimits(): BrainLimits;
+    setLimits(limits: BrainLimits): void;
+    isWithinLimits(): boolean;
+    private load;
+    private save;
+}
+//# sourceMappingURL=instance-manager.d.ts.map

package/dist/cli/brain/instance-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instance-manager.d.ts","sourceRoot":"","sources":["../../../src/cli/brain/instance-manager.ts"],"names":[],"mappings":"AAaA,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAWD,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,MAAM,CAIZ;gBAEU,OAAO,EAAE,MAAM;IAQ3B,QAAQ,CAAC,IAAI,EAAE;QACb,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC;QACzB,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,GAAG,aAAa;IAsBjB,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAOzC,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAOxB,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAmB7B,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAU5B,MAAM,IAAI,aAAa,EAAE;IAIzB,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI;IAIzC,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI;IAM7C,eAAe,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAWhD,SAAS,IAAI,WAAW;IAIxB,SAAS,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI;IAKpC,cAAc,IAAI,OAAO;IAczB,OAAO,CAAC,IAAI;IAmBZ,OAAO,CAAC,IAAI;CAWb"}

package/dist/cli/brain/instance-manager.js

@@ -0,0 +1,152 @@
+/**
+ * Brain Instance Manager — tracks and limits brain instances (spiral databases).
+ * Manages the brain registry at ~/.helixmind/brain-registry.json.
+ * Only active when user is logged in (FREE+ and above).
+ */
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { randomUUID } from 'node:crypto';
+// ---------------------------------------------------------------------------
+// Manager
+// ---------------------------------------------------------------------------
+export class BrainInstanceManager {
+    registryPath;
+    brains = [];
+    limits = {
+        maxGlobal: Infinity,
+        maxLocal: Infinity,
+        maxActive: Infinity,
+    };
+    constructor(baseDir) {
+        mkdirSync(baseDir, { recursive: true });
+        this.registryPath = join(baseDir, 'brain-registry.json');
+        this.load();
+    }
+    // ---- CRUD ----
+    register(opts) {
+        // Deduplicate by path
+        const existing = this.brains.find(b => b.path === opts.path);
+        if (existing)
+            return existing;
+        const brain = {
+            id: `brain_${randomUUID().slice(0, 12)}`,
+            name: opts.name,
+            type: opts.type,
+            path: opts.path,
+            projectPath: opts.projectPath,
+            createdAt: Date.now(),
+            lastAccessedAt: Date.now(),
+            nodeCount: 0,
+            active: false,
+        };
+        this.brains.push(brain);
+        this.save();
+        return brain;
+    }
+    rename(id, newName) {
+        const brain = this.brains.find(b => b.id === id);
+        if (!brain)
+            throw new Error(`Brain not found: ${id}`);
+        brain.name = newName;
+        this.save();
+    }
+    remove(id) {
+        this.brains = this.brains.filter(b => b.id !== id);
+        this.save();
+    }
+    // ---- Activation ----
+    activate(id) {
+        const brain = this.brains.find(b => b.id === id);
+        if (!brain || brain.active)
+            return brain?.active ?? false;
+        // Check limits
+        const activeGlobal = this.brains.filter(b => b.active && b.type === 'global').length;
+        const activeLocal = this.brains.filter(b => b.active && b.type === 'local').length;
+        const totalActive = this.brains.filter(b => b.active).length;
+        if (totalActive >= this.limits.maxActive)
+            return false;
+        if (brain.type === 'global' && activeGlobal >= this.limits.maxGlobal)
+            return false;
+        if (brain.type === 'local' && activeLocal >= this.limits.maxLocal)
+            return false;
+        brain.active = true;
+        brain.lastAccessedAt = Date.now();
+        this.save();
+        return true;
+    }
+    deactivate(id) {
+        const brain = this.brains.find(b => b.id === id);
+        if (brain) {
+            brain.active = false;
+            this.save();
+        }
+    }
+    // ---- Queries ----
+    getAll() {
+        return [...this.brains];
+    }
+    getById(id) {
+        return this.brains.find(b => b.id === id) ?? null;
+    }
+    getByPath(path) {
+        return this.brains.find(b => b.path === path) ?? null;
+    }
+    // ---- Updates ----
+    updateNodeCount(id, count) {
+        const brain = this.brains.find(b => b.id === id);
+        if (brain) {
+            brain.nodeCount = count;
+            brain.lastAccessedAt = Date.now();
+            this.save();
+        }
+    }
+    // ---- Limits ----
+    getLimits() {
+        return { ...this.limits };
+    }
+    setLimits(limits) {
+        this.limits = { ...limits };
+        this.save();
+    }
+    isWithinLimits() {
+        const activeGlobal = this.brains.filter(b => b.active && b.type === 'global').length;
+        const activeLocal = this.brains.filter(b => b.active && b.type === 'local').length;
+        const totalActive = this.brains.filter(b => b.active).length;
+        return (activeGlobal <= this.limits.maxGlobal &&
+            activeLocal <= this.limits.maxLocal &&
+            totalActive <= this.limits.maxActive);
+    }
+    // ---- Persistence ----
+    load() {
+        if (!existsSync(this.registryPath))
+            return;
+        try {
+            const raw = readFileSync(this.registryPath, 'utf-8');
+            const data = JSON.parse(raw);
+            this.brains = data.brains ?? [];
+            if (data.limits) {
+                this.limits = {
+                    maxGlobal: data.limits.maxGlobal ?? Infinity,
+                    maxLocal: data.limits.maxLocal ?? Infinity,
+                    maxActive: data.limits.maxActive ?? Infinity,
+                };
+            }
+        }
+        catch {
+            // Corrupted file — start fresh
+            this.brains = [];
+        }
+    }
+    save() {
+        const data = {
+            brains: this.brains,
+            limits: {
+                maxGlobal: this.limits.maxGlobal,
+                maxLocal: this.limits.maxLocal,
+                maxActive: this.limits.maxActive,
+            },
+        };
+        writeFileSync(this.registryPath, JSON.stringify(data, null, 2), 'utf-8');
+    }
+}
+//# sourceMappingURL=instance-manager.js.map

package/dist/cli/brain/instance-manager.js.map

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

package/dist/cli/brain/relay-client.d.ts

@@ -0,0 +1,8 @@
+import type { ControlHandlers, InstanceMeta } from './control-protocol.js';
+import type { BrainServer } from './server.js';
+interface RelayClient {
+    close(): void;
+}
+export declare function createRelayClient(relayUrl: string, apiKey: string, handlers: ControlHandlers, getInstanceMeta: () => InstanceMeta, brainServer: BrainServer | null): RelayClient;
+export {};
+//# sourceMappingURL=relay-client.d.ts.map

package/dist/cli/brain/relay-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relay-client.d.ts","sourceRoot":"","sources":["../../../src/cli/brain/relay-client.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,eAAe,EAAkB,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC3F,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAM/C,UAAU,WAAW;IACnB,KAAK,IAAI,IAAI,CAAC;CACf;AAED,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,eAAe,EACzB,eAAe,EAAE,MAAM,YAAY,EACnC,WAAW,EAAE,WAAW,GAAG,IAAI,GAC9B,WAAW,CAujBb"}