crbro-memory 1.0.0

package/dist/types/index.d.ts

@@ -0,0 +1,121 @@
+export interface Fact {
+    text: string;
+    confidence: number;
+    added: string;
+    source: string;
+}
+export interface Decision {
+    text: string;
+    date: string;
+    rationale: string;
+}
+export type NeuronType = 'project' | 'tech' | 'lang' | 'person' | 'domain' | 'process';
+export interface Neuron {
+    id: string;
+    name: string;
+    domain: string;
+    type: NeuronType;
+    created: string;
+    last_accessed: string;
+    access_count: number;
+    heat: number;
+    summary: string;
+    facts: Fact[];
+    decisions: Decision[];
+    patterns: string[];
+    preferences: string[];
+    connections: string[];
+    tags: string[];
+}
+export type SynapseType = 'dependency' | 'causal' | 'temporal' | 'conceptual' | 'hierarchy' | 'alternative';
+export interface Synapse {
+    id: string;
+    nodes: [string, string];
+    strength: number;
+    type: SynapseType;
+    context: string;
+    co_access_count: number;
+    last_co_access: string;
+}
+export interface SessionLog {
+    session_id: string;
+    date: string;
+    duration_estimate: string;
+    topics_touched: string[];
+    summary: string;
+    key_facts_added: number;
+    decisions_made: number;
+    new_neurons_created: number;
+    synapses_updated: number;
+}
+export interface ActiveContext {
+    last_session: string;
+    active_topics: string[];
+    pending_tasks: string[];
+    last_updated: string;
+}
+export interface HotTopic {
+    id: string;
+    name: string;
+    heat: number;
+    last_access: string;
+    domain: string;
+}
+export interface HotTopics {
+    topics: HotTopic[];
+    last_recalculated: string;
+}
+export interface Cluster {
+    name: string;
+    nodes: string[];
+    summary: string;
+    heat: number;
+}
+export interface Bridge {
+    from: string;
+    to: string;
+    via: string[];
+    context: string;
+}
+export interface GlobalMap {
+    last_rebuilt: string;
+    clusters: Cluster[];
+    bridges: Bridge[];
+}
+export interface Manifest {
+    version: string;
+    created: string;
+    owner: string;
+    brain_path: string;
+    total_neurons: number;
+    total_synapses: number;
+    total_sessions: number;
+    last_boot: string | null;
+    last_consolidation: string | null;
+    license_key: string | null;
+}
+export interface BootResult {
+    status: 'ok' | 'initialized' | 'error';
+    total_neurons: number;
+    total_synapses: number;
+    total_sessions: number;
+    hot_topics: HotTopic[];
+    last_session: string | null;
+    active_context: ActiveContext | null;
+    message: string;
+}
+export interface SearchResult {
+    neuron_id: string;
+    name: string;
+    domain: string;
+    relevance_score: number;
+    matching_content: string;
+    heat: number;
+}
+export type PremiumFeature = 'global_map' | 'maintenance' | 'export' | 'import' | 'advanced_search';
+export interface LicenseInfo {
+    valid: boolean;
+    tier: 'free' | 'premium';
+    features: PremiumFeature[];
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,IAAI;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEvF,MAAM,WAAW,MAAM;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,UAAU,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAID,MAAM,MAAM,WAAW,GAAG,YAAY,GAAG,QAAQ,GAAG,UAAU,GAAG,YAAY,GAAG,WAAW,GAAG,aAAa,CAAC;AAE5G,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;CACxB;AAID,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,iBAAiB,EAAE,MAAM,CAAC;IAC1B,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAID,MAAM,WAAW,aAAa;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,QAAQ,EAAE,CAAC;IACnB,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,MAAM;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,EAAE,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,SAAS;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAID,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAID,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,IAAI,GAAG,aAAa,GAAG,OAAO,CAAC;IACvC,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,QAAQ,EAAE,CAAC;IACvB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,cAAc,EAAE,aAAa,GAAG,IAAI,CAAC;IACrC,OAAO,EAAE,MAAM,CAAC;CACjB;AAID,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC;CACd;AAID,MAAM,MAAM,cAAc,GAAG,YAAY,GAAG,aAAa,GAAG,QAAQ,GAAG,QAAQ,GAAG,iBAAiB,CAAC;AAEpG,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,QAAQ,EAAE,cAAc,EAAE,CAAC;CAC5B"}

package/dist/types/index.js

@@ -0,0 +1,5 @@
+"use strict";
+// ─── CRBRO Types ─────────────────────────────────────────────────
+// Biological neural memory architecture types
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":";AAAA,oEAAoE;AACpE,8CAA8C"}

package/dist/utils/fs.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Safely read and parse a JSON file. Returns null if file doesn't exist.
+ * Never throws on missing file — only on corrupted JSON.
+ */
+export declare function readJSON<T>(filePath: string): Promise<T | null>;
+/**
+ * Write JSON to file atomically (write to temp, then rename).
+ * Creates parent directories if they don't exist.
+ */
+export declare function writeJSON<T>(filePath: string, data: T): Promise<void>;
+/**
+ * Check if a file exists.
+ */
+export declare function fileExists(filePath: string): Promise<boolean>;
+/**
+ * List all JSON files in a directory. Returns filenames without extension.
+ */
+export declare function listJSONFiles(dirPath: string): Promise<string[]>;
+/**
+ * Delete a JSON file. Returns true if deleted, false if didn't exist.
+ */
+export declare function deleteJSON(filePath: string): Promise<boolean>;
+/**
+ * Move a file from one location to another.
+ */
+export declare function moveFile(from: string, to: string): Promise<void>;
+/**
+ * Get the current date as ISO string (date only).
+ */
+export declare function today(): string;
+/**
+ * Get the current datetime as ISO string.
+ */
+export declare function now(): string;
+//# sourceMappingURL=fs.d.ts.map

package/dist/utils/fs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.d.ts","sourceRoot":"","sources":["../../src/utils/fs.ts"],"names":[],"mappings":"AAMA;;;GAGG;AACH,wBAAsB,QAAQ,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAUrE;AAED;;;GAGG;AACH,wBAAsB,SAAS,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAS3E;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAOnE;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAYtE;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAUnE;AAED;;GAEG;AACH,wBAAsB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAItE;AAED;;GAEG;AACH,wBAAgB,KAAK,IAAI,MAAM,CAE9B;AAED;;GAEG;AACH,wBAAgB,GAAG,IAAI,MAAM,CAE5B"}

package/dist/utils/fs.js

@@ -0,0 +1,110 @@
+"use strict";
+// ─── CRBRO File System Utilities ─────────────────────────────────
+// Safe JSON read/write with error handling and atomic writes
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readJSON = readJSON;
+exports.writeJSON = writeJSON;
+exports.fileExists = fileExists;
+exports.listJSONFiles = listJSONFiles;
+exports.deleteJSON = deleteJSON;
+exports.moveFile = moveFile;
+exports.today = today;
+exports.now = now;
+const node_fs_1 = require("node:fs");
+const node_path_1 = __importDefault(require("node:path"));
+/**
+ * Safely read and parse a JSON file. Returns null if file doesn't exist.
+ * Never throws on missing file — only on corrupted JSON.
+ */
+async function readJSON(filePath) {
+    try {
+        const content = await node_fs_1.promises.readFile(filePath, 'utf-8');
+        return JSON.parse(content);
+    }
+    catch (err) {
+        if (err instanceof Error && 'code' in err && err.code === 'ENOENT') {
+            return null;
+        }
+        throw new Error(`CRBRO: Corrupted JSON at ${filePath}: ${err instanceof Error ? err.message : String(err)}`);
+    }
+}
+/**
+ * Write JSON to file atomically (write to temp, then rename).
+ * Creates parent directories if they don't exist.
+ */
+async function writeJSON(filePath, data) {
+    const dir = node_path_1.default.dirname(filePath);
+    await node_fs_1.promises.mkdir(dir, { recursive: true });
+    const tempPath = `${filePath}.tmp`;
+    const content = JSON.stringify(data, null, 2);
+    await node_fs_1.promises.writeFile(tempPath, content, 'utf-8');
+    await node_fs_1.promises.rename(tempPath, filePath);
+}
+/**
+ * Check if a file exists.
+ */
+async function fileExists(filePath) {
+    try {
+        await node_fs_1.promises.access(filePath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * List all JSON files in a directory. Returns filenames without extension.
+ */
+async function listJSONFiles(dirPath) {
+    try {
+        const files = await node_fs_1.promises.readdir(dirPath);
+        return files
+            .filter(f => f.endsWith('.json'))
+            .map(f => f.replace('.json', ''));
+    }
+    catch (err) {
+        if (err instanceof Error && 'code' in err && err.code === 'ENOENT') {
+            return [];
+        }
+        throw err;
+    }
+}
+/**
+ * Delete a JSON file. Returns true if deleted, false if didn't exist.
+ */
+async function deleteJSON(filePath) {
+    try {
+        await node_fs_1.promises.unlink(filePath);
+        return true;
+    }
+    catch (err) {
+        if (err instanceof Error && 'code' in err && err.code === 'ENOENT') {
+            return false;
+        }
+        throw err;
+    }
+}
+/**
+ * Move a file from one location to another.
+ */
+async function moveFile(from, to) {
+    const dir = node_path_1.default.dirname(to);
+    await node_fs_1.promises.mkdir(dir, { recursive: true });
+    await node_fs_1.promises.rename(from, to);
+}
+/**
+ * Get the current date as ISO string (date only).
+ */
+function today() {
+    return new Date().toISOString().split('T')[0];
+}
+/**
+ * Get the current datetime as ISO string.
+ */
+function now() {
+    return new Date().toISOString();
+}
+//# sourceMappingURL=fs.js.map

package/dist/utils/fs.js.map

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

package/dist/utils/ids.d.ts

@@ -0,0 +1,32 @@
+import type { NeuronType } from '../types/index.js';
+/**
+ * Convert a string to a valid snake_case ID.
+ * "OctoChat Plugin" → "octochat_plugin"
+ */
+export declare function toSnakeCase(str: string): string;
+/**
+ * Generate a neuron ID from name and type.
+ * ("OctoChat", "project") → "project_octochat"
+ */
+export declare function neuronId(name: string, type: NeuronType): string;
+/**
+ * Generate a synapse ID from two neuron IDs.
+ * ("project_octochat", "tech_firebase") → "syn_octochat__firebase"
+ * Always sorted alphabetically for consistency.
+ */
+export declare function synapseId(nodeA: string, nodeB: string): string;
+/**
+ * Generate a session ID for today.
+ * → "session_2026-05-06"
+ */
+export declare function sessionId(date?: string): string;
+/**
+ * Validate that a string is a valid neuron ID.
+ */
+export declare function isValidNeuronId(id: string): boolean;
+/**
+ * Infer neuron type from topic name using simple heuristics.
+ * Falls back to 'project' if unsure.
+ */
+export declare function inferNeuronType(topic: string): NeuronType;
+//# sourceMappingURL=ids.d.ts.map

package/dist/utils/ids.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ids.d.ts","sourceRoot":"","sources":["../../src/utils/ids.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAWpD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAQ/C;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,MAAM,CAI/D;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAI9D;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAG/C;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAEnD;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,CAuBzD"}

package/dist/utils/ids.js

@@ -0,0 +1,92 @@
+"use strict";
+// ─── CRBRO ID Utilities ──────────────────────────────────────────
+// Generate and validate neuron/synapse IDs
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toSnakeCase = toSnakeCase;
+exports.neuronId = neuronId;
+exports.synapseId = synapseId;
+exports.sessionId = sessionId;
+exports.isValidNeuronId = isValidNeuronId;
+exports.inferNeuronType = inferNeuronType;
+const TYPE_PREFIXES = {
+    project: 'project_',
+    tech: 'tech_',
+    lang: 'lang_',
+    person: 'person_',
+    domain: 'domain_',
+    process: 'process_',
+};
+/**
+ * Convert a string to a valid snake_case ID.
+ * "OctoChat Plugin" → "octochat_plugin"
+ */
+function toSnakeCase(str) {
+    return str
+        .toLowerCase()
+        .trim()
+        .replace(/[^a-z0-9\s_-]/g, '') // Remove special chars
+        .replace(/[\s-]+/g, '_') // Spaces/hyphens to underscores
+        .replace(/_+/g, '_') // Collapse multiple underscores
+        .replace(/^_|_$/g, ''); // Trim leading/trailing underscores
+}
+/**
+ * Generate a neuron ID from name and type.
+ * ("OctoChat", "project") → "project_octochat"
+ */
+function neuronId(name, type) {
+    const prefix = TYPE_PREFIXES[type];
+    const slug = toSnakeCase(name);
+    return `${prefix}${slug}`;
+}
+/**
+ * Generate a synapse ID from two neuron IDs.
+ * ("project_octochat", "tech_firebase") → "syn_octochat__firebase"
+ * Always sorted alphabetically for consistency.
+ */
+function synapseId(nodeA, nodeB) {
+    const stripPrefix = (id) => id.replace(/^(project_|tech_|lang_|person_|domain_|process_)/, '');
+    const parts = [stripPrefix(nodeA), stripPrefix(nodeB)].sort();
+    return `syn_${parts[0]}__${parts[1]}`;
+}
+/**
+ * Generate a session ID for today.
+ * → "session_2026-05-06"
+ */
+function sessionId(date) {
+    const d = date || new Date().toISOString().split('T')[0];
+    return `session_${d}`;
+}
+/**
+ * Validate that a string is a valid neuron ID.
+ */
+function isValidNeuronId(id) {
+    return /^(project|tech|lang|person|domain|process)_[a-z0-9_]+$/.test(id);
+}
+/**
+ * Infer neuron type from topic name using simple heuristics.
+ * Falls back to 'project' if unsure.
+ */
+function inferNeuronType(topic) {
+    const lower = topic.toLowerCase();
+    // Tech keywords
+    const techKeywords = ['firebase', 'react', 'node', 'docker', 'kubernetes', 'aws', 'gcp', 'cloud', 'api', 'rest',
+        'graphql', 'mongodb', 'postgres', 'redis', 'nginx', 'webpack', 'vite', 'git', 'npm', 'supabase', 'stripe',
+        'vercel', 'netlify', 'cloudflare', 'orama', 'chromadb', 'openai', 'gemini', 'claude'];
+    if (techKeywords.some(kw => lower.includes(kw)))
+        return 'tech';
+    // Language keywords
+    const langKeywords = ['python', 'javascript', 'typescript', 'php', 'rust', 'go', 'java', 'swift', 'kotlin', 'css', 'html', 'sql'];
+    if (langKeywords.some(kw => lower === kw || lower.includes(` ${kw}`) || lower.includes(`${kw} `)))
+        return 'lang';
+    // Process keywords
+    const processKeywords = ['deploy', 'migration', 'workflow', 'pipeline', 'ci/cd', 'backup', 'setup', 'install'];
+    if (processKeywords.some(kw => lower.includes(kw)))
+        return 'process';
+    // Domain keywords
+    const domainKeywords = ['seo', 'marketing', 'trading', 'crypto', 'design', 'security', 'devops', 'data', 'analytics'];
+    if (domainKeywords.some(kw => lower === kw))
+        return 'domain';
+    // Default to project
+    return 'project';
+}
+//# sourceMappingURL=ids.js.map

package/dist/utils/ids.js.map

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

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "crbro-memory",
+  "version": "1.0.0",
+  "description": "CRBRO — Persistent neural memory for AI. A biological file-based MCP server that gives your AI long-term memory across sessions.",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "crbro-memory": "./bin/crbro.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/index.js",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "memory",
+    "ai",
+    "persistent-memory",
+    "model-context-protocol",
+    "llm",
+    "synthetica"
+  ],
+  "author": "Synthetica Decks",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Octonove/crbro-memory"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "files": [
+    "dist/",
+    "bin/",
+    "README.md",
+    "LICENSE"
+  ],
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "@orama/orama": "^3.1.18",
+    "zod": "^4.4.3"
+  },
+  "devDependencies": {
+    "@types/node": "^25.6.0",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.5"
+  }
+}