@kybernesis/brain-core 0.1.0

package/dist/ops.js

@@ -0,0 +1,307 @@
+/**
+ * CLI output formatters — port of KAD's cli-formatters.ts (renamed ops.ts
+ * per CANONICAL.md §4). Output is byte-identical to what KAD renders.
+ * Wire contract for MCP skills — do NOT change output format.
+ */
+import { getDb } from '@kybernesis/brain-storage-sqlite';
+import { getEntityContext, searchEntities, getEntityGraphStats, getMostMentionedEntities, getTypedRelationships, getEntityProfile, getOpenContradictions, getEntityInsights, } from './entity-graph.js';
+import { formatRelationship } from './relationship-extractor.js';
+import { getFactsForEntity } from './fact-store.js';
+import { queryTimeline, getTimelineStats, getRecentActivity, getActivityOnDate, searchTimeline, } from './timeline.js';
+import { hybridSearch } from './hybrid-search.js';
+// ─── Recall ───────────────────────────────────────────────────────────────────
+function extractEntityName(query) {
+    return query
+        .replace(/^(who is|what is|what do (i|you) know about|tell me about|recall)\s+/i, '')
+        .replace(/\?+$/, '')
+        .trim();
+}
+async function formatEntityContext(t, context) {
+    const { entity, mentions, relatedEntities } = context;
+    const lines = [];
+    lines.push(`# ${entity.name}`, '');
+    try {
+        const profile = await getEntityProfile(t, entity.id);
+        if (profile) {
+            lines.push(profile.profile, '');
+        }
+    }
+    catch { /* non-critical */ }
+    lines.push(`Mentioned ${entity.mentionCount} times | First seen: ${new Date(entity.firstSeen).toLocaleDateString()} | Last seen: ${new Date(entity.lastSeen).toLocaleDateString()}`);
+    lines.push(`Type: ${entity.type}`);
+    if (entity.aliases.length > 0)
+        lines.push(`Also known as: ${entity.aliases.join(', ')}`);
+    try {
+        const facts = await getFactsForEntity(t, entity.name, { latestOnly: true, limit: 10 });
+        if (facts.length > 0) {
+            lines.push('', '## Known Facts');
+            for (const f of facts) {
+                const conf = f.confidence < 0.7 ? ` (${Math.round(f.confidence * 100)}%)` : '';
+                lines.push(`- ${f.content}${conf}`);
+            }
+        }
+    }
+    catch { /* non-critical */ }
+    try {
+        const rels = await getTypedRelationships(t, entity.id);
+        if (rels.length > 0) {
+            lines.push('', '## Relationships');
+            for (const rel of rels) {
+                const verb = formatRelationship(rel.entity.name, rel.relationship, rel.direction);
+                const conf = rel.confidence >= 0.8 ? '' : ` (${Math.round(rel.confidence * 100)}% confident)`;
+                lines.push(`- ${entity.name} ${verb} ${rel.entity.name}${conf}`);
+                if (rel.rationale)
+                    lines.push(`  -- ${rel.rationale}`);
+            }
+        }
+    }
+    catch { /* non-critical */ }
+    try {
+        const insights = await getEntityInsights(t, entity.id);
+        if (insights.length > 0) {
+            lines.push('', '## Insights');
+            for (const ins of insights.slice(0, 5)) {
+                const tag = ins.insightType === 'inference' ? 'inferred'
+                    : ins.insightType === 'pattern' ? 'pattern'
+                        : ins.insightType === 'quality' ? 'note' : 'insight';
+                lines.push(`- ${ins.insight} [${tag}]`);
+            }
+        }
+    }
+    catch { /* non-critical */ }
+    try {
+        const contradictions = await getOpenContradictions(t, entity.id);
+        if (contradictions.length > 0) {
+            lines.push('');
+            for (const c of contradictions) {
+                lines.push(`Note: I have conflicting info — "${c.factA}" vs "${c.factB}". Want to clarify which is correct?`);
+            }
+        }
+    }
+    catch { /* non-critical */ }
+    if (mentions.length > 0) {
+        lines.push('', '## Mentions');
+        for (const m of mentions.slice(0, 10)) {
+            const date = new Date(m.timestamp).toLocaleDateString();
+            lines.push(m.context ? `- [${date}] ${m.context}` : `- [${date}] Mentioned in conversation`);
+        }
+        if (mentions.length > 10)
+            lines.push(`- ... and ${mentions.length - 10} more mentions`);
+    }
+    if (relatedEntities.length > 0) {
+        lines.push('', '## Co-occurred With');
+        for (const rel of relatedEntities.slice(0, 10)) {
+            lines.push(`- ${rel.entity.name} (${rel.entity.type}) - appeared together ${rel.strength} time(s)`);
+        }
+    }
+    return lines.join('\n');
+}
+async function getRelatedMemories(t, entityName) {
+    try {
+        const db = getDb(t, 'timeline');
+        let sleep = null;
+        try {
+            sleep = getDb(t, 'sleep');
+        }
+        catch {
+            return [];
+        }
+        const entityLower = entityName.toLowerCase();
+        const sourcePaths = db.prepare(`
+      SELECT DISTINCT source_path FROM timeline_events
+      WHERE LOWER(title) LIKE ? OR LOWER(tags_json) LIKE ? OR LOWER(entities_json) LIKE ?
+      LIMIT 20
+    `).all(`%${entityLower}%`, `%${entityLower}%`, `%${entityLower}%`);
+        if (sourcePaths.length === 0)
+            return [];
+        const relatedPaths = new Set();
+        for (const { source_path } of sourcePaths) {
+            try {
+                const edges = sleep.prepare(`
+          SELECT CASE WHEN from_path = ? THEN to_path ELSE from_path END as related_path,
+                 confidence, shared_tags
+          FROM memory_edges
+          WHERE from_path = ? OR to_path = ?
+          ORDER BY confidence DESC LIMIT 3
+        `).all(source_path, source_path, source_path);
+                for (const edge of edges) {
+                    if (!sourcePaths.some(s => s.source_path === edge.related_path)) {
+                        relatedPaths.add(edge.related_path);
+                    }
+                }
+            }
+            catch { /* memory_edges may not exist */ }
+        }
+        if (relatedPaths.size === 0)
+            return [];
+        const lines = [];
+        for (const path of relatedPaths) {
+            const item = db.prepare('SELECT title, tier, timestamp FROM timeline_events WHERE source_path = ?')
+                .get(path);
+            if (item) {
+                const date = new Date(item.timestamp).toLocaleDateString();
+                lines.push(`- ${item.title} [${date}] (${item.tier})`);
+            }
+        }
+        return lines;
+    }
+    catch {
+        return [];
+    }
+}
+async function trackEntityAccess(t, entityId) {
+    try {
+        const db = getDb(t, 'entityGraph');
+        db.prepare(`
+      UPDATE entities SET access_count = access_count + 1, last_accessed = datetime('now') WHERE id = ?
+    `).run(entityId);
+    }
+    catch { /* non-critical */ }
+}
+export async function formatRecall(t, query) {
+    if (!query || !query.trim()) {
+        const stats = await getEntityGraphStats(t);
+        const top = await getMostMentionedEntities(t, { limit: 10 });
+        return formatStats(stats) + '\n\n' + formatTopEntities(top);
+    }
+    const entityName = extractEntityName(query);
+    const context = await getEntityContext(t, entityName);
+    if (context) {
+        const out = [await formatEntityContext(t, context)];
+        const related = await getRelatedMemories(t, entityName);
+        if (related.length > 0) {
+            out.push('', '## Connected Memories', ...related);
+        }
+        await trackEntityAccess(t, context.entity.id);
+        return out.join('\n');
+    }
+    const results = await searchEntities(t, entityName, { limit: 10 });
+    if (results.length === 1) {
+        const ctx = await getEntityContext(t, results[0].id);
+        if (ctx) {
+            const out = [await formatEntityContext(t, ctx)];
+            const related = await getRelatedMemories(t, results[0].name);
+            if (related.length > 0) {
+                out.push('', '## Connected Memories', ...related);
+            }
+            await trackEntityAccess(t, ctx.entity.id);
+            return out.join('\n');
+        }
+    }
+    if (results.length > 0)
+        return formatSearchResults(results);
+    return `No information found about "${entityName}".\n\nThis entity has not been mentioned in any processed conversations yet.`;
+}
+function formatSearchResults(results) {
+    if (results.length === 0)
+        return 'No matching entities found.';
+    return ['# Search Results', '', ...results.map(e => `- ${e.name} (${e.type}) - ${e.mentionCount} mention(s)`)].join('\n');
+}
+function formatStats(stats) {
+    return [
+        '# Entity Graph Summary', '',
+        `Total entities tracked: ${stats.totalEntities}`,
+        `Total mentions recorded: ${stats.totalMentions}`,
+        `Entity relationships: ${stats.totalRelations}`, '',
+        '## By Type',
+        `- People: ${stats.byType.person}`,
+        `- Companies: ${stats.byType.company}`,
+        `- Projects: ${stats.byType.project}`,
+        `- Places: ${stats.byType.place}`,
+        `- Topics: ${stats.byType.topic}`,
+    ].join('\n');
+}
+function formatTopEntities(entities) {
+    if (entities.length === 0)
+        return 'No entities recorded yet.';
+    return ['# Most Mentioned Entities', '', ...entities.map(e => `- ${e.name} (${e.type}) - ${e.mentionCount} mention(s)`)].join('\n');
+}
+// ─── Timeline ─────────────────────────────────────────────────────────────────
+function getToday() { return new Date().toISOString().slice(0, 10); }
+function getYesterday() {
+    const d = new Date();
+    d.setDate(d.getDate() - 1);
+    return d.toISOString().slice(0, 10);
+}
+function getWeekStart() {
+    const d = new Date();
+    const day = d.getDay();
+    const diff = d.getDate() - day + (day === 0 ? -6 : 1);
+    d.setDate(diff);
+    d.setHours(0, 0, 0, 0);
+    return d.toISOString();
+}
+function formatTimelineEvents(events, title) {
+    if (events.length === 0)
+        return `# ${title}\n\nNo events found.`;
+    const lines = [`# ${title}`, '', `${events.length} event(s)`, ''];
+    for (const event of events) {
+        const date = new Date(event.timestamp).toLocaleDateString();
+        const time = new Date(event.timestamp).toLocaleTimeString([], { hour: '2-digit', minute: '2-digit' });
+        lines.push(`## [${event.type}] ${event.title}`);
+        const tier = event['tier'];
+        lines.push(`${date} ${time}${tier ? ` | tier: ${tier}` : ''}`);
+        if (event.summary)
+            lines.push(event.summary);
+        const ents = event['entities'] ?? [];
+        if (Array.isArray(ents) && ents.length > 0)
+            lines.push(`Entities: ${ents.join(', ')}`);
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+function formatTimelineStats(stats) {
+    return [
+        '# Timeline Statistics', '',
+        `Total events: ${stats.totalEvents}`, '',
+        '## By Type',
+        ...Object.entries(stats.byType).map(([k, v]) => `- ${k}: ${v}`),
+    ].join('\n');
+}
+export async function formatTimelineRich(t, opts) {
+    if (opts.stats)
+        return formatTimelineStats(await getTimelineStats(t));
+    const limit = opts.limit ?? 20;
+    let events;
+    let title;
+    if (opts.today) {
+        events = await getActivityOnDate(t, getToday());
+        title = "Today's Activity";
+    }
+    else if (opts.yesterday) {
+        events = await getActivityOnDate(t, getYesterday());
+        title = "Yesterday's Activity";
+    }
+    else if (opts.week) {
+        events = await queryTimeline(t, { start: getWeekStart(), limit: 50 });
+        title = 'This Week';
+    }
+    else if (opts.search) {
+        events = await searchTimeline(t, opts.search, { limit, type: opts.type });
+        title = `Search: "${opts.search}"`;
+    }
+    else {
+        events = await getRecentActivity(t, limit);
+        title = 'Recent Activity';
+    }
+    return formatTimelineEvents(events, title);
+}
+export async function formatSearchRich(t, opts) {
+    const limit = opts.limit ?? 20;
+    const results = await hybridSearch(t, opts.q, { limit });
+    if (results.length === 0)
+        return `# Search\n\nNo matches for "${opts.q}".`;
+    const lines = [`# Search: "${opts.q}"`, '', `${results.length} result(s)`, ''];
+    for (const r of results) {
+        const date = r.timestamp ? new Date(r.timestamp).toLocaleDateString() : '';
+        const tier = r.tier ? ` | ${r.tier}` : '';
+        lines.push(`## ${r.title ?? '(untitled)'}${date ? `  — ${date}` : ''}${tier}`);
+        if (r.content)
+            lines.push(r.content.slice(0, 500));
+        if (r.source_path)
+            lines.push(`_${r.source_path}_`);
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=ops.js.map

package/dist/ops.js.map

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

package/dist/queue.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Per-tenant single-fiber write queue.
+ *
+ * Every brain write (timeline, fact, entity, sleep) is queued on the
+ * tenant's serial channel. better-sqlite3 + WAL is multi-reader-safe but
+ * single-writer — concurrent writes risk corruption. This queue makes the
+ * "daemon is the sole writer per tenant" invariant load-bearing in code.
+ */
+type Job<T> = () => Promise<T>;
+export declare function enqueueWrite<T>(slug: string, job: Job<T>): Promise<T>;
+export declare function queueDepth(slug: string): number;
+export {};
+//# sourceMappingURL=queue.d.ts.map

package/dist/queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue.d.ts","sourceRoot":"","sources":["../src/queue.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,KAAK,GAAG,CAAC,CAAC,IAAI,MAAM,OAAO,CAAC,CAAC,CAAC,CAAC;AAS/B,wBAAgB,YAAY,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAcrE;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE/C"}

package/dist/queue.js

@@ -0,0 +1,28 @@
+/**
+ * Per-tenant single-fiber write queue.
+ *
+ * Every brain write (timeline, fact, entity, sleep) is queued on the
+ * tenant's serial channel. better-sqlite3 + WAL is multi-reader-safe but
+ * single-writer — concurrent writes risk corruption. This queue makes the
+ * "daemon is the sole writer per tenant" invariant load-bearing in code.
+ */
+const queues = new Map();
+export function enqueueWrite(slug, job) {
+    const state = queues.get(slug) ?? { tail: Promise.resolve(), depth: 0 };
+    state.depth += 1;
+    const run = state.tail.then(() => {
+        return job().catch((err) => {
+            console.warn('[brain-core/queue] write failed', { slug, err: String(err) });
+            throw err;
+        }).finally(() => {
+            state.depth -= 1;
+        });
+    });
+    state.tail = run.catch(() => undefined);
+    queues.set(slug, state);
+    return run;
+}
+export function queueDepth(slug) {
+    return queues.get(slug)?.depth ?? 0;
+}
+//# sourceMappingURL=queue.js.map

package/dist/queue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue.js","sourceRoot":"","sources":["../src/queue.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AASH,MAAM,MAAM,GAAG,IAAI,GAAG,EAAsB,CAAC;AAE7C,MAAM,UAAU,YAAY,CAAI,IAAY,EAAE,GAAW;IACvD,MAAM,KAAK,GAAe,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;IACpF,KAAK,CAAC,KAAK,IAAI,CAAC,CAAC;IACjB,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE;QAC/B,OAAO,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;YACzB,OAAO,CAAC,IAAI,CAAC,iCAAiC,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAC5E,MAAM,GAAG,CAAC;QACZ,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE;YACd,KAAK,CAAC,KAAK,IAAI,CAAC,CAAC;QACnB,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IACH,KAAK,CAAC,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IACxC,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACxB,OAAO,GAAiB,CAAC;AAC3B,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,OAAO,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,KAAK,IAAI,CAAC,CAAC;AACtC,CAAC"}

package/dist/relationship-extractor.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Relationship extractor — port of KAD's relationship-extractor.ts.
+ *
+ * Uses Claude Haiku to extract typed relationships between entities
+ * from conversation text.
+ */
+import type { TenantContext, EntityType, RelationshipType } from '@kybernesis/brain-contracts';
+export interface ExtractedRelationship {
+    source: {
+        name: string;
+        type: EntityType;
+    };
+    target: {
+        name: string;
+        type: EntityType;
+    };
+    relationship: RelationshipType;
+    confidence: number;
+    rationale: string;
+}
+export interface RelationshipExtractionResult {
+    entities: Array<{
+        name: string;
+        type: EntityType;
+    }>;
+    relationships: ExtractedRelationship[];
+}
+/**
+ * Extract entities and typed relationships from conversation text.
+ * Uses Claude Haiku for fast, cost-effective extraction.
+ * `t` is accepted for signature parity with other brain-core modules.
+ */
+export declare function extractRelationships(_t: TenantContext, text: string, options?: {
+    maxTokens?: number;
+}): Promise<RelationshipExtractionResult>;
+/** Format a relationship verb for display in recall output. */
+export declare function formatRelationship(_entityName: string, relationship: RelationshipType, direction: 'outgoing' | 'incoming'): string;
+//# sourceMappingURL=relationship-extractor.d.ts.map

package/dist/relationship-extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relationship-extractor.d.ts","sourceRoot":"","sources":["../src/relationship-extractor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAE/F,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,UAAU,CAAA;KAAE,CAAC;IAC3C,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,UAAU,CAAA;KAAE,CAAC;IAC3C,YAAY,EAAE,gBAAgB,CAAC;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,UAAU,CAAA;KAAE,CAAC,CAAC;IACpD,aAAa,EAAE,qBAAqB,EAAE,CAAC;CACxC;AAgED;;;;GAIG;AACH,wBAAsB,oBAAoB,CAExC,EAAE,EAAE,aAAa,EACjB,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAO,GACnC,OAAO,CAAC,4BAA4B,CAAC,CA+BvC;AAED,+DAA+D;AAC/D,wBAAgB,kBAAkB,CAChC,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,gBAAgB,EAC9B,SAAS,EAAE,UAAU,GAAG,UAAU,GACjC,MAAM,CAoBR"}

package/dist/relationship-extractor.js

@@ -0,0 +1,119 @@
+/**
+ * Relationship extractor — port of KAD's relationship-extractor.ts.
+ *
+ * Uses Claude Haiku to extract typed relationships between entities
+ * from conversation text.
+ */
+import { callClaude } from './claude-call.js';
+const EXTRACTION_PROMPT = `You are an entity relationship extractor. Analyze the conversation text and extract:
+
+1. **Entities**: People, companies, projects, places, and topics mentioned
+2. **Relationships**: Explicit relationships between entities
+
+## Entity Types
+- person: Individual people (e.g., "John", "Dr. Smith", "my brother")
+- company: Companies, organizations (e.g., "Google", "Acme Corp", "the university")
+- project: Specific named projects, products, or apps that someone is building or working on (e.g., "KyberBot", "Project Alpha", "the mobile app"). NOTE: Programming languages, frameworks, libraries, databases, and tools are NOT projects — classify them as topic instead.
+- place: Locations (e.g., "New York", "the office", "Thailand")
+- topic: Topics, concepts, technologies, tools, frameworks, programming languages (e.g., "AI", "funding", "TypeScript", "Docker", "React", "SQLite", "Express", "deployment")
+
+## Relationship Types (only use these exact values)
+- founded: Person founded company/project
+- works_at: Person works at company
+- invested_in: Person/company invested in company/project
+- met_with: Person met with person
+- created: Person created project
+- manages: Person manages project/company
+- partners_with: Company partners with company
+- located_in: Company/project located in place
+- discussed: Entities discussed together (topic-related)
+- related_to: Generic relationship when specific type unclear
+- reports_to: Person reports to person (management hierarchy)
+- uses: Project/company uses a technology or tool (topic)
+- depends_on: Project depends on another project or technology
+- part_of: Entity is part of a larger entity (team part of company, module part of project)
+
+## Rules
+- Only extract relationships that are EXPLICITLY stated or strongly implied
+- Do NOT create relationships just because entities appear together
+- Do NOT extract shell commands (curl, bash, git), file paths (.claude/settings.json), error messages (BLOCKED, timeout), or infrastructure noise (sandbox, permissions, max turns limit) as entities
+- The speaker is "user" unless otherwise specified
+- Set confidence 0.8-0.95 for explicit statements, 0.5-0.7 for implied relationships
+- Provide brief rationale explaining why you identified each relationship
+
+Respond with JSON only:
+{
+  "entities": [
+    { "name": "John Smith", "type": "person" },
+    { "name": "Acme Corp", "type": "company" }
+  ],
+  "relationships": [
+    {
+      "source": { "name": "John Smith", "type": "person" },
+      "target": { "name": "Acme Corp", "type": "company" },
+      "relationship": "founded",
+      "confidence": 0.9,
+      "rationale": "Text explicitly states John founded Acme Corp"
+    }
+  ]
+}
+
+If no explicit relationships found, return empty relationships array but still list entities.`;
+const VALID_ENTITY_TYPES = new Set(['person', 'company', 'project', 'place', 'topic']);
+const VALID_RELATIONSHIP_TYPES = new Set([
+    'co-occurred', 'founded', 'works_at', 'invested_in', 'met_with', 'created',
+    'manages', 'partners_with', 'located_in', 'discussed', 'related_to',
+    'reports_to', 'uses', 'depends_on', 'part_of',
+]);
+/**
+ * Extract entities and typed relationships from conversation text.
+ * Uses Claude Haiku for fast, cost-effective extraction.
+ * `t` is accepted for signature parity with other brain-core modules.
+ */
+export async function extractRelationships(
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+_t, text, options = {}) {
+    const maxTokens = options.maxTokens ?? 4096;
+    try {
+        const truncated = text.length > 4000 ? text.slice(0, 4000) + '\n\n[Text truncated...]' : text;
+        const response = await callClaude(`Extract entities and relationships from this conversation:\n\n${truncated}`, { system: EXTRACTION_PROMPT, maxTokens });
+        if (!response)
+            return { entities: [], relationships: [] };
+        const jsonMatch = response.match(/\{[\s\S]*\}/);
+        if (!jsonMatch)
+            return { entities: [], relationships: [] };
+        const raw = JSON.parse(jsonMatch[0]);
+        const entities = (raw.entities || []).filter((e) => e.name && e.type && VALID_ENTITY_TYPES.has(e.type));
+        const relationships = (raw.relationships || []).filter((r) => r.source?.name && r.source?.type &&
+            r.target?.name && r.target?.type &&
+            r.relationship && VALID_RELATIONSHIP_TYPES.has(r.relationship));
+        return { entities, relationships };
+    }
+    catch (err) {
+        console.warn('[brain-core/relationship-extractor] extraction failed', { err: String(err) });
+        return { entities: [], relationships: [] };
+    }
+}
+/** Format a relationship verb for display in recall output. */
+export function formatRelationship(_entityName, relationship, direction) {
+    const formats = {
+        founded: { outgoing: 'founded', incoming: 'was founded by' },
+        works_at: { outgoing: 'works at', incoming: 'employs' },
+        invested_in: { outgoing: 'invested in', incoming: 'received investment from' },
+        met_with: { outgoing: 'met with', incoming: 'met with' },
+        created: { outgoing: 'created', incoming: 'was created by' },
+        manages: { outgoing: 'manages', incoming: 'is managed by' },
+        partners_with: { outgoing: 'partners with', incoming: 'partners with' },
+        located_in: { outgoing: 'is located in', incoming: 'is location of' },
+        discussed: { outgoing: 'discussed', incoming: 'was discussed with' },
+        related_to: { outgoing: 'related to', incoming: 'related to' },
+        'co-occurred': { outgoing: 'mentioned with', incoming: 'mentioned with' },
+        reports_to: { outgoing: 'reports to', incoming: 'has report' },
+        uses: { outgoing: 'uses', incoming: 'is used by' },
+        depends_on: { outgoing: 'depends on', incoming: 'is dependency of' },
+        part_of: { outgoing: 'is part of', incoming: 'contains' },
+    };
+    const fmt = formats[relationship] ?? formats['related_to'];
+    return direction === 'outgoing' ? fmt.outgoing : fmt.incoming;
+}
+//# sourceMappingURL=relationship-extractor.js.map

package/dist/relationship-extractor.js.map

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

package/dist/sleep/config.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Sleep config — port of KAD's sleep/config.ts (verbatim per ADR-0003).
+ * All constants are locked at parity (CANONICAL.md §2 "Sleep cadence + default config").
+ */
+export interface SleepConfig {
+    intervalMinutes: number;
+    initialDelayMinutes: number;
+    batchSize: number;
+    maxTagsPerRun: number;
+    maxLinksPerRun: number;
+    maxSummariesPerRun: number;
+    decayRatePerHour: number;
+    maxDecay: number;
+    minConfidenceForLink: number;
+    maxEdgesPerMemory: number;
+    hotPriorityThreshold: number;
+    warmPriorityThreshold: number;
+    hotDecayThreshold: number;
+    hotAccessDays: number;
+    warmAccessDays: number;
+    hotEdgeCount: number;
+    warmEdgeCount: number;
+    tagStaleDays: number;
+    hotWarmSummarySentences: number;
+    archiveSummarySentences: number;
+    enableTagging: boolean;
+    enableRewriting: boolean;
+    enableEntityHygiene: boolean;
+    maxMergesPerRun: number;
+    hygieneConfidenceThreshold: number;
+    pruneMinAgeDays: number;
+    enableConsolidation: boolean;
+    consolidationTitleThreshold: number;
+    repetitiveDecayMultiplier: number;
+    enableObservations: boolean;
+    maxObservationsPerRun: number;
+    enableFactExtraction: boolean;
+    maxFactsPerRun: number;
+    enableContradictionDetection: boolean;
+    maxContradictionChecksPerRun: number;
+    enableUserProfile: boolean;
+    profileRefreshMinutes: number;
+    enableReasoning: boolean;
+    maxReasoningPerRun: number;
+}
+export declare const DEFAULT_CONFIG: SleepConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/sleep/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/sleep/config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,WAAW;IAC1B,eAAe,EAAE,MAAM,CAAC;IACxB,mBAAmB,EAAE,MAAM,CAAC;IAE5B,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,kBAAkB,EAAE,MAAM,CAAC;IAE3B,gBAAgB,EAAE,MAAM,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IAEjB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,iBAAiB,EAAE,MAAM,CAAC;IAE1B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IAEtB,YAAY,EAAE,MAAM,CAAC;IAErB,uBAAuB,EAAE,MAAM,CAAC;IAChC,uBAAuB,EAAE,MAAM,CAAC;IAEhC,aAAa,EAAE,OAAO,CAAC;IACvB,eAAe,EAAE,OAAO,CAAC;IAEzB,mBAAmB,EAAE,OAAO,CAAC;IAC7B,eAAe,EAAE,MAAM,CAAC;IACxB,0BAA0B,EAAE,MAAM,CAAC;IACnC,eAAe,EAAE,MAAM,CAAC;IAExB,mBAAmB,EAAE,OAAO,CAAC;IAC7B,2BAA2B,EAAE,MAAM,CAAC;IACpC,yBAAyB,EAAE,MAAM,CAAC;IAElC,kBAAkB,EAAE,OAAO,CAAC;IAC5B,qBAAqB,EAAE,MAAM,CAAC;IAE9B,oBAAoB,EAAE,OAAO,CAAC;IAC9B,cAAc,EAAE,MAAM,CAAC;IAEvB,4BAA4B,EAAE,OAAO,CAAC;IACtC,4BAA4B,EAAE,MAAM,CAAC;IAErC,iBAAiB,EAAE,OAAO,CAAC;IAC3B,qBAAqB,EAAE,MAAM,CAAC;IAE9B,eAAe,EAAE,OAAO,CAAC;IACzB,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED,eAAO,MAAM,cAAc,EAAE,WAsD5B,CAAC"}

package/dist/sleep/config.js

@@ -0,0 +1,46 @@
+/**
+ * Sleep config — port of KAD's sleep/config.ts (verbatim per ADR-0003).
+ * All constants are locked at parity (CANONICAL.md §2 "Sleep cadence + default config").
+ */
+export const DEFAULT_CONFIG = {
+    intervalMinutes: 60,
+    initialDelayMinutes: 5,
+    batchSize: 50,
+    maxTagsPerRun: 5,
+    maxLinksPerRun: 100,
+    maxSummariesPerRun: 5,
+    decayRatePerHour: 0.002,
+    maxDecay: 1.0,
+    minConfidenceForLink: 0.15,
+    maxEdgesPerMemory: 5,
+    hotPriorityThreshold: 0.65,
+    warmPriorityThreshold: 0.3,
+    hotDecayThreshold: 0.25,
+    hotAccessDays: 3,
+    warmAccessDays: 21,
+    hotEdgeCount: 6,
+    warmEdgeCount: 3,
+    tagStaleDays: 7,
+    hotWarmSummarySentences: 5,
+    archiveSummarySentences: 3,
+    enableTagging: true,
+    enableRewriting: false,
+    enableEntityHygiene: true,
+    maxMergesPerRun: 10,
+    hygieneConfidenceThreshold: 0.8,
+    pruneMinAgeDays: 30,
+    enableConsolidation: true,
+    consolidationTitleThreshold: 3,
+    repetitiveDecayMultiplier: 3.0,
+    enableObservations: true,
+    maxObservationsPerRun: 10,
+    enableFactExtraction: true,
+    maxFactsPerRun: 5,
+    enableContradictionDetection: true,
+    maxContradictionChecksPerRun: 5,
+    enableUserProfile: true,
+    profileRefreshMinutes: 60,
+    enableReasoning: true,
+    maxReasoningPerRun: 5,
+};
+//# sourceMappingURL=config.js.map