@psiclawops/hypermem 0.8.5 → 0.9.1

package/dist/topic-store.d.ts

@@ -1,51 +0,0 @@
-/**
- * hypermem Topic Store
- *
- * Cross-session topic tracking. Topics are conversation threads that
- * can span multiple sessions and channels.
- * Lives in the central library DB.
- */
-import type { DatabaseSync } from 'node:sqlite';
-import type { Topic, TopicStatus } from './types.js';
-export declare function normalizeTopicName(name: string): string;
-export declare class TopicStore {
-    private readonly db;
-    constructor(db: DatabaseSync);
-    /**
-     * Create a new topic.
-     */
-    create(agentId: string, name: string, description?: string, visibility?: string): Topic;
-    /**
-     * Find an existing topic by name (case-insensitive) or create a new one.
-     * Prevents duplicate topics for the same logical concept.
-     */
-    findOrCreate(agentId: string, rawName: string, description?: string, visibility?: string): Topic;
-    /**
-     * Touch a topic — update activity tracking.
-     */
-    touch(topicId: number, sessionKey: string, messagesDelta?: number): void;
-    /**
-     * Get active topics for an agent.
-     */
-    getActive(agentId: string, limit?: number): Topic[];
-    /**
-     * Get all topics for an agent.
-     */
-    getAll(agentId: string, opts?: {
-        status?: TopicStatus;
-        limit?: number;
-    }): Topic[];
-    /**
-     * Find topics matching a query.
-     */
-    search(agentId: string, query: string, limit?: number): Topic[];
-    /**
-     * Mark dormant topics (no activity for dormantAfterHours).
-     */
-    markDormant(agentId: string, dormantAfterHours?: number): number;
-    /**
-     * Close dormant topics.
-     */
-    closeDormant(agentId: string, closedAfterDays?: number): number;
-}
-//# sourceMappingURL=topic-store.d.ts.map

package/dist/topic-store.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"topic-store.d.ts","sourceRoot":"","sources":["../src/topic-store.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAmBrD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGvD;AAqBD,qBAAa,UAAU;IACT,OAAO,CAAC,QAAQ,CAAC,EAAE;gBAAF,EAAE,EAAE,YAAY;IAE7C;;OAEG;IACH,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,KAAK;IAwBvF;;;OAGG;IACH,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,KAAK;IAkBhG;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,aAAa,GAAE,MAAU,GAAG,IAAI;IAY3E;;OAEG;IACH,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,GAAE,MAAW,GAAG,KAAK,EAAE;IAWvD;;OAEG;IACH,MAAM,CACJ,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAC9C,KAAK,EAAE;IAoBV;;OAEG;IACH,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,GAAE,MAAW,GAAG,KAAK,EAAE;IAanE;;OAEG;IACH,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,iBAAiB,GAAE,MAAW,GAAG,MAAM;IAYpE;;OAEG;IACH,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,eAAe,GAAE,MAAU,GAAG,MAAM;CAWnE"}

package/dist/topic-store.js

@@ -1,175 +0,0 @@
-/**
- * hypermem Topic Store
- *
- * Cross-session topic tracking. Topics are conversation threads that
- * can span multiple sessions and channels.
- * Lives in the central library DB.
- */
-/**
- * Normalize a topic name for dedup purposes.
- * Preserves casing of known product names; lowercases everything else.
- */
-const KNOWN_NAMES = {
-    hypermem: 'HyperMem',
-    hyperbuilder: 'HyperBuilder',
-    canvas: 'canvas',
-    dashboard: 'dashboard',
-    dispatch: 'dispatch',
-    clawtext: 'ClawText',
-    automation: 'automation',
-    council: 'council',
-    openclaw: 'OpenClaw',
-    clawhub: 'ClawHub',
-};
-export function normalizeTopicName(name) {
-    const lower = name.trim().toLowerCase();
-    return KNOWN_NAMES[lower] ?? name.trim();
-}
-function nowIso() {
-    return new Date().toISOString();
-}
-function parseTopicRow(row) {
-    return {
-        id: row.id,
-        agentId: row.agent_id,
-        name: row.name,
-        description: row.description || null,
-        status: row.status,
-        visibility: row.visibility || 'org',
-        lastSessionKey: row.last_session_key || null,
-        messageCount: row.message_count,
-        createdAt: row.created_at,
-        updatedAt: row.updated_at,
-    };
-}
-export class TopicStore {
-    db;
-    constructor(db) {
-        this.db = db;
-    }
-    /**
-     * Create a new topic.
-     */
-    create(agentId, name, description, visibility) {
-        const now = nowIso();
-        const result = this.db.prepare(`
-      INSERT INTO topics (agent_id, name, description, status, visibility, message_count, created_at, updated_at)
-      VALUES (?, ?, ?, 'active', ?, 0, ?, ?)
-    `).run(agentId, name, description || null, visibility || 'org', now, now);
-        const id = Number(result.lastInsertRowid);
-        return {
-            id,
-            agentId,
-            name,
-            description: description || null,
-            status: 'active',
-            visibility: visibility || 'org',
-            lastSessionKey: null,
-            messageCount: 0,
-            createdAt: now,
-            updatedAt: now,
-        };
-    }
-    /**
-     * Find an existing topic by name (case-insensitive) or create a new one.
-     * Prevents duplicate topics for the same logical concept.
-     */
-    findOrCreate(agentId, rawName, description, visibility) {
-        const name = normalizeTopicName(rawName);
-        const existing = this.db.prepare(`
-      SELECT * FROM topics
-      WHERE agent_id = ?
-        AND lower(name) = lower(?)
-        AND status != 'closed'
-      ORDER BY updated_at DESC
-      LIMIT 1
-    `).get(agentId, name);
-        if (existing) {
-            return parseTopicRow(existing);
-        }
-        return this.create(agentId, name, description, visibility);
-    }
-    /**
-     * Touch a topic — update activity tracking.
-     */
-    touch(topicId, sessionKey, messagesDelta = 1) {
-        const now = nowIso();
-        this.db.prepare(`
-      UPDATE topics
-      SET last_session_key = ?,
-          message_count = message_count + ?,
-          status = 'active',
-          updated_at = ?
-      WHERE id = ?
-    `).run(sessionKey, messagesDelta, now, topicId);
-    }
-    /**
-     * Get active topics for an agent.
-     */
-    getActive(agentId, limit = 20) {
-        const rows = this.db.prepare(`
-      SELECT * FROM topics
-      WHERE agent_id = ? AND status = 'active'
-      ORDER BY updated_at DESC
-      LIMIT ?
-    `).all(agentId, limit);
-        return rows.map(parseTopicRow);
-    }
-    /**
-     * Get all topics for an agent.
-     */
-    getAll(agentId, opts) {
-        let sql = 'SELECT * FROM topics WHERE agent_id = ?';
-        const params = [agentId];
-        if (opts?.status) {
-            sql += ' AND status = ?';
-            params.push(opts.status);
-        }
-        sql += ' ORDER BY updated_at DESC';
-        if (opts?.limit) {
-            sql += ' LIMIT ?';
-            params.push(opts.limit);
-        }
-        const rows = this.db.prepare(sql).all(...params);
-        return rows.map(parseTopicRow);
-    }
-    /**
-     * Find topics matching a query.
-     */
-    search(agentId, query, limit = 10) {
-        const rows = this.db.prepare(`
-      SELECT * FROM topics
-      WHERE agent_id = ?
-      AND (name LIKE ? OR description LIKE ?)
-      AND status != 'closed'
-      ORDER BY updated_at DESC
-      LIMIT ?
-    `).all(agentId, `%${query}%`, `%${query}%`, limit);
-        return rows.map(parseTopicRow);
-    }
-    /**
-     * Mark dormant topics (no activity for dormantAfterHours).
-     */
-    markDormant(agentId, dormantAfterHours = 24) {
-        const cutoff = new Date(Date.now() - dormantAfterHours * 60 * 60 * 1000).toISOString();
-        const result = this.db.prepare(`
-      UPDATE topics
-      SET status = 'dormant', updated_at = ?
-      WHERE agent_id = ? AND status = 'active' AND updated_at < ?
-    `).run(nowIso(), agentId, cutoff);
-        return result.changes;
-    }
-    /**
-     * Close dormant topics.
-     */
-    closeDormant(agentId, closedAfterDays = 7) {
-        const cutoff = new Date(Date.now() - closedAfterDays * 24 * 60 * 60 * 1000).toISOString();
-        const result = this.db.prepare(`
-      UPDATE topics
-      SET status = 'closed', updated_at = ?
-      WHERE agent_id = ? AND status = 'dormant' AND updated_at < ?
-    `).run(nowIso(), agentId, cutoff);
-        return result.changes;
-    }
-}
-//# sourceMappingURL=topic-store.js.map

package/dist/topic-synthesizer.d.ts

@@ -1,51 +0,0 @@
-/**
- * Topic Synthesizer
- *
- * Synthesizes compiled knowledge pages (wiki-style) from stale topics.
- * Heuristic-only: no LLM calls. Uses content-type classifier + keystone scoring.
- *
- * Architecture: Karpathy LLM Wiki Pattern adapted for hypermem.
- * Raw sources (messages.db) → Wiki (knowledge table) → Compositor (compose-time)
- */
-import type { DatabaseSync } from 'node:sqlite';
-declare const SYNTHESIS_STALE_MINUTES = 30;
-declare const SYNTHESIS_MIN_MESSAGES = 5;
-declare const SYNTHESIS_REGROWTH_THRESHOLD = 5;
-declare const SYNTHESIS_MAX_SUMMARY_CHARS = 800;
-declare const SYNTHESIS_MAX_DECISIONS = 10;
-declare const SYNTHESIS_MAX_QUESTIONS = 5;
-declare const LINT_FREQUENCY = 10;
-declare const LINT_STALE_DAYS = 7;
-export { SYNTHESIS_STALE_MINUTES, SYNTHESIS_MIN_MESSAGES, SYNTHESIS_REGROWTH_THRESHOLD, SYNTHESIS_MAX_SUMMARY_CHARS, SYNTHESIS_MAX_DECISIONS, SYNTHESIS_MAX_QUESTIONS, LINT_FREQUENCY, LINT_STALE_DAYS, };
-export interface SynthesisConfig {
-    SYNTHESIS_STALE_MINUTES: number;
-    SYNTHESIS_MIN_MESSAGES: number;
-    SYNTHESIS_REGROWTH_THRESHOLD: number;
-    SYNTHESIS_MAX_SUMMARY_CHARS: number;
-    SYNTHESIS_MAX_DECISIONS: number;
-    SYNTHESIS_MAX_QUESTIONS: number;
-    LINT_FREQUENCY: number;
-    LINT_STALE_DAYS: number;
-}
-export interface SynthesisResult {
-    topicsSynthesized: number;
-    topicsSkipped: number;
-    knowledgeEntriesWritten: number;
-}
-export declare class TopicSynthesizer {
-    private readonly libraryDb;
-    private readonly getMessageDb;
-    private readonly config?;
-    private readonly effectiveConfig;
-    constructor(libraryDb: DatabaseSync, getMessageDb: (agentId: string) => DatabaseSync | null, config?: Partial<SynthesisConfig> | undefined);
-    /**
-     * Run one synthesis pass for an agent.
-     * Finds stale topics, synthesizes wiki pages, writes to knowledge table.
-     */
-    tick(agentId: string): SynthesisResult;
-    /**
-     * Synthesize a wiki page for a topic from its messages.
-     */
-    private synthesizeTopic;
-}
-//# sourceMappingURL=topic-synthesizer.d.ts.map

package/dist/topic-synthesizer.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"topic-synthesizer.d.ts","sourceRoot":"","sources":["../src/topic-synthesizer.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAMhD,QAAA,MAAM,uBAAuB,KAAK,CAAC;AACnC,QAAA,MAAM,sBAAsB,IAAI,CAAC;AACjC,QAAA,MAAM,4BAA4B,IAAI,CAAC;AACvC,QAAA,MAAM,2BAA2B,MAAM,CAAC;AACxC,QAAA,MAAM,uBAAuB,KAAK,CAAC;AACnC,QAAA,MAAM,uBAAuB,IAAI,CAAC;AAClC,QAAA,MAAM,cAAc,KAAK,CAAC;AAC1B,QAAA,MAAM,eAAe,IAAI,CAAC;AAG1B,OAAO,EACL,uBAAuB,EACvB,sBAAsB,EACtB,4BAA4B,EAC5B,2BAA2B,EAC3B,uBAAuB,EACvB,uBAAuB,EACvB,cAAc,EACd,eAAe,GAChB,CAAC;AAIF,MAAM,WAAW,eAAe;IAC9B,uBAAuB,EAAE,MAAM,CAAC;IAChC,sBAAsB,EAAE,MAAM,CAAC;IAC/B,4BAA4B,EAAE,MAAM,CAAC;IACrC,2BAA2B,EAAE,MAAM,CAAC;IACpC,uBAAuB,EAAE,MAAM,CAAC;IAChC,uBAAuB,EAAE,MAAM,CAAC;IAChC,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,eAAe;IAC9B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,uBAAuB,EAAE,MAAM,CAAC;CACjC;AA6HD,qBAAa,gBAAgB;IAIzB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;IAL1B,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAkB;gBAG/B,SAAS,EAAE,YAAY,EACvB,YAAY,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,YAAY,GAAG,IAAI,EACtD,MAAM,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,YAAA;IAcpD;;;OAGG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe;IAmFtC;;OAEG;IACH,OAAO,CAAC,eAAe;CA+GxB"}

package/dist/topic-synthesizer.js

@@ -1,316 +0,0 @@
-/**
- * Topic Synthesizer
- *
- * Synthesizes compiled knowledge pages (wiki-style) from stale topics.
- * Heuristic-only: no LLM calls. Uses content-type classifier + keystone scoring.
- *
- * Architecture: Karpathy LLM Wiki Pattern adapted for hypermem.
- * Raw sources (messages.db) → Wiki (knowledge table) → Compositor (compose-time)
- */
-import { classifyContentType } from './content-type-classifier.js';
-import { KnowledgeStore } from './knowledge-store.js';
-// ─── Configuration ──────────────────────────────────────────────
-const SYNTHESIS_STALE_MINUTES = 30;
-const SYNTHESIS_MIN_MESSAGES = 5;
-const SYNTHESIS_REGROWTH_THRESHOLD = 5;
-const SYNTHESIS_MAX_SUMMARY_CHARS = 800;
-const SYNTHESIS_MAX_DECISIONS = 10;
-const SYNTHESIS_MAX_QUESTIONS = 5;
-const LINT_FREQUENCY = 10;
-const LINT_STALE_DAYS = 7;
-// Export so tests can reference them
-export { SYNTHESIS_STALE_MINUTES, SYNTHESIS_MIN_MESSAGES, SYNTHESIS_REGROWTH_THRESHOLD, SYNTHESIS_MAX_SUMMARY_CHARS, SYNTHESIS_MAX_DECISIONS, SYNTHESIS_MAX_QUESTIONS, LINT_FREQUENCY, LINT_STALE_DAYS, };
-// ─── Helpers ────────────────────────────────────────────────────
-/**
- * Score a message for keystone quality.
- * Heuristic: count references (file paths, agent mentions, quoted content, backticks).
- */
-function keystoneScore(msg) {
-    const text = msg.text_content || '';
-    let score = 0;
-    // File path references
-    const pathMatches = text.match(/\/[\w./\-]+/g) || [];
-    score += pathMatches.length * 0.3;
-    // Backtick code references (inline or block)
-    const backtickMatches = text.match(/`[^`]+`/g) || [];
-    score += backtickMatches.length * 0.2;
-    // Agent mentions (known patterns)
-    const agentMentions = text.match(/\b(alice|bob|agent4|dave|oscar|carol|director1|director2|director7|specialist2|specialist1)\b/gi) || [];
-    score += agentMentions.length * 0.25;
-    // Quoted content
-    const quotedMatches = text.match(/"[^"]{10,}"/g) || [];
-    score += quotedMatches.length * 0.15;
-    // Decision/spec content type boosts score
-    const classification = classifyContentType(text);
-    if (classification.type === 'decision')
-        score += 1.0;
-    else if (classification.type === 'spec')
-        score += 0.5;
-    else if (classification.type === 'preference')
-        score += 0.3;
-    // Length bonus (up to 0.5 for ~500 chars)
-    score += Math.min(text.length / 1000, 0.5);
-    return score;
-}
-/**
- * Extract file artifact paths from a message's tool_calls JSON.
- */
-function extractArtifacts(msg) {
-    if (!msg.tool_calls)
-        return [];
-    const artifacts = [];
-    try {
-        const calls = JSON.parse(msg.tool_calls);
-        if (!Array.isArray(calls))
-            return [];
-        for (const call of calls) {
-            const args = call.input || call.function?.arguments || call.arguments || {};
-            let parsed = args;
-            if (typeof parsed === 'string') {
-                try {
-                    parsed = JSON.parse(parsed);
-                }
-                catch {
-                    continue;
-                }
-            }
-            if (typeof parsed !== 'object' || !parsed)
-                continue;
-            for (const key of ['path', 'file', 'filePath', 'file_path']) {
-                const val = parsed[key];
-                if (typeof val === 'string' && val.startsWith('/')) {
-                    artifacts.push(val);
-                }
-            }
-        }
-    }
-    catch {
-        // Malformed JSON — skip
-    }
-    return artifacts;
-}
-/**
- * Truncate text to maxChars with head+tail preservation.
- * head = 60% of budget, tail = 40%.
- */
-function truncateHeadTail(text, maxChars) {
-    if (text.length <= maxChars)
-        return text;
-    const headLen = Math.floor(maxChars * 0.6);
-    const tailLen = maxChars - headLen - 5; // 5 for " ... "
-    return text.slice(0, headLen) + ' ... ' + text.slice(text.length - tailLen);
-}
-/**
- * Parse the message_count stored in a knowledge source_ref or metadata.
- * source_ref format: "topic:<id>" — but we need to find message_count
- * from when the synthesis was stored. We store it in the content itself
- * as a comment, or we can read from the knowledge row's source_ref.
- *
- * Strategy: embed last message count in sourceRef as "topic:<id>:mc:<count>"
- */
-function parseStoredMessageCount(sourceRef) {
-    if (!sourceRef)
-        return 0;
-    const match = sourceRef.match(/:mc:(\d+)$/);
-    return match ? parseInt(match[1], 10) : 0;
-}
-// ─── TopicSynthesizer ───────────────────────────────────────────
-export class TopicSynthesizer {
-    libraryDb;
-    getMessageDb;
-    config;
-    effectiveConfig;
-    constructor(libraryDb, getMessageDb, config) {
-        this.libraryDb = libraryDb;
-        this.getMessageDb = getMessageDb;
-        this.config = config;
-        this.effectiveConfig = {
-            SYNTHESIS_STALE_MINUTES: config?.SYNTHESIS_STALE_MINUTES ?? SYNTHESIS_STALE_MINUTES,
-            SYNTHESIS_MIN_MESSAGES: config?.SYNTHESIS_MIN_MESSAGES ?? SYNTHESIS_MIN_MESSAGES,
-            SYNTHESIS_REGROWTH_THRESHOLD: config?.SYNTHESIS_REGROWTH_THRESHOLD ?? SYNTHESIS_REGROWTH_THRESHOLD,
-            SYNTHESIS_MAX_SUMMARY_CHARS: config?.SYNTHESIS_MAX_SUMMARY_CHARS ?? SYNTHESIS_MAX_SUMMARY_CHARS,
-            SYNTHESIS_MAX_DECISIONS: config?.SYNTHESIS_MAX_DECISIONS ?? SYNTHESIS_MAX_DECISIONS,
-            SYNTHESIS_MAX_QUESTIONS: config?.SYNTHESIS_MAX_QUESTIONS ?? SYNTHESIS_MAX_QUESTIONS,
-            LINT_FREQUENCY: config?.LINT_FREQUENCY ?? LINT_FREQUENCY,
-            LINT_STALE_DAYS: config?.LINT_STALE_DAYS ?? LINT_STALE_DAYS,
-        };
-    }
-    /**
-     * Run one synthesis pass for an agent.
-     * Finds stale topics, synthesizes wiki pages, writes to knowledge table.
-     */
-    tick(agentId) {
-        const result = {
-            topicsSynthesized: 0,
-            topicsSkipped: 0,
-            knowledgeEntriesWritten: 0,
-        };
-        const cfg = this.effectiveConfig;
-        const staleThresholdMinutes = cfg.SYNTHESIS_STALE_MINUTES;
-        // Query stale topics for this agent
-        // "Stale" = updated_at older than SYNTHESIS_STALE_MINUTES ago
-        let staleTopics;
-        try {
-            staleTopics = this.libraryDb.prepare(`
-        SELECT * FROM topics
-        WHERE agent_id = ?
-          AND message_count >= ?
-          AND updated_at < datetime('now', '-' || ? || ' minutes')
-          -- safe: staleThresholdMinutes is a validated integer
-        ORDER BY updated_at ASC
-      `).all(agentId, cfg.SYNTHESIS_MIN_MESSAGES, Math.floor(staleThresholdMinutes));
-        }
-        catch {
-            return result;
-        }
-        if (staleTopics.length === 0)
-            return result;
-        const knowledgeStore = new KnowledgeStore(this.libraryDb);
-        for (const topic of staleTopics) {
-            // Check if existing synthesis exists
-            const existing = knowledgeStore.get(agentId, 'topic-synthesis', topic.name);
-            if (existing) {
-                // Only re-synthesize if message_count has grown by >= threshold
-                const storedMc = parseStoredMessageCount(existing.sourceRef);
-                const growth = topic.message_count - storedMc;
-                if (growth < cfg.SYNTHESIS_REGROWTH_THRESHOLD) {
-                    result.topicsSkipped++;
-                    continue;
-                }
-            }
-            // Get messages for this topic from per-agent messages.db
-            const messageDb = this.getMessageDb(agentId);
-            if (!messageDb) {
-                result.topicsSkipped++;
-                continue;
-            }
-            let messages;
-            try {
-                messages = messageDb.prepare(`
-          SELECT * FROM messages WHERE topic_id = ? ORDER BY created_at ASC
-        `).all(String(topic.id));
-            }
-            catch {
-                result.topicsSkipped++;
-                continue;
-            }
-            if (messages.length === 0) {
-                result.topicsSkipped++;
-                continue;
-            }
-            // Build synthesis
-            const content = this.synthesizeTopic(topic, messages, cfg);
-            // Upsert into knowledge table
-            const sourceRef = `topic:${topic.id}:mc:${topic.message_count}`;
-            knowledgeStore.upsert(agentId, 'topic-synthesis', topic.name, content, {
-                sourceType: 'synthesizer',
-                sourceRef,
-            });
-            result.topicsSynthesized++;
-            result.knowledgeEntriesWritten++;
-        }
-        return result;
-    }
-    /**
-     * Synthesize a wiki page for a topic from its messages.
-     */
-    synthesizeTopic(topic, messages, cfg) {
-        // Classify + score all messages
-        const scored = messages.map(msg => ({
-            msg,
-            classification: classifyContentType(msg.text_content || ''),
-            score: keystoneScore(msg),
-        }));
-        // Extract decisions: classified as decision with confidence >= 0.7, top N
-        const decisions = scored
-            .filter(m => m.classification.type === 'decision' && m.classification.confidence >= 0.7)
-            .sort((a, b) => b.score - a.score)
-            .slice(0, cfg.SYNTHESIS_MAX_DECISIONS);
-        // Extract open questions: classified as discussion + ends with ?, no decision follow-up within 5 msgs
-        const openQuestions = [];
-        for (let i = 0; i < scored.length; i++) {
-            const item = scored[i];
-            const text = item.msg.text_content || '';
-            // Question detection: ends with ? OR is a discussion-type with question keywords
-            const isQuestion = /\?\s*$/.test(text.trim()) ||
-                (item.classification.type === 'discussion' && /\b(why|how|what|when|where|should|could|would|can|is there)\b/i.test(text));
-            if (!isQuestion)
-                continue;
-            // Check if there's a decision-type response within next 5 messages
-            const followup = scored.slice(i + 1, i + 6);
-            const hasDecisionFollowup = followup.some(f => f.classification.type === 'decision');
-            if (!hasDecisionFollowup) {
-                openQuestions.push(item);
-                if (openQuestions.length >= cfg.SYNTHESIS_MAX_QUESTIONS)
-                    break;
-            }
-        }
-        // Extract artifacts from tool_calls
-        const allArtifacts = new Set();
-        for (const { msg } of scored) {
-            for (const artifact of extractArtifacts(msg)) {
-                allArtifacts.add(artifact);
-            }
-        }
-        // Extract participants: unique agent_ids
-        const participants = [...new Set(messages.map(m => m.agent_id).filter(Boolean))];
-        // Build summary: top-3 scored messages, concatenated and truncated
-        const top3 = [...scored]
-            .sort((a, b) => b.score - a.score)
-            .slice(0, 3)
-            .map(m => (m.msg.text_content || '').trim())
-            .filter(t => t.length > 0)
-            .join(' ');
-        const summary = truncateHeadTail(top3, cfg.SYNTHESIS_MAX_SUMMARY_CHARS);
-        // Build the wiki page markdown
-        const lines = [];
-        lines.push(`# ${topic.name}`);
-        lines.push('');
-        lines.push(`**Status:** ${topic.status}`);
-        lines.push(`**Last activity:** ${topic.updated_at}`);
-        lines.push(`**Messages:** ${topic.message_count}`);
-        lines.push(`**Participants:** ${participants.join(', ') || 'unknown'}`);
-        lines.push('');
-        lines.push('## Summary');
-        lines.push(summary || '_No summary available_');
-        lines.push('');
-        lines.push('## Key Decisions');
-        if (decisions.length > 0) {
-            for (const { msg } of decisions) {
-                const text = (msg.text_content || '').trim();
-                const first = text.split('\n')[0].slice(0, 200);
-                lines.push(`- ${first}`);
-            }
-        }
-        else {
-            lines.push('_No key decisions recorded_');
-        }
-        lines.push('');
-        lines.push('## Open Questions');
-        if (openQuestions.length > 0) {
-            for (const { msg } of openQuestions) {
-                const text = (msg.text_content || '').trim();
-                const first = text.split('\n')[0].slice(0, 200);
-                lines.push(`- ${first}`);
-            }
-        }
-        else {
-            lines.push('_No open questions_');
-        }
-        lines.push('');
-        lines.push('## Artifacts');
-        if (allArtifacts.size > 0) {
-            for (const artifact of allArtifacts) {
-                lines.push(`- ${artifact}`);
-            }
-        }
-        else {
-            lines.push('_No artifacts recorded_');
-        }
-        lines.push('');
-        lines.push('## Cross-References');
-        lines.push('_Auto-generated — see knowledge graph for links_');
-        return lines.join('\n');
-    }
-}
-//# sourceMappingURL=topic-synthesizer.js.map

package/dist/trigger-registry.d.ts

@@ -1,63 +0,0 @@
-/**
- * hypermem Trigger Registry (W5)
- *
- * Centralizes ACA collection trigger definitions with owner/category metadata.
- * Extracted from compositor.ts for independent testability and auditability.
- *
- * - TRIGGER_REGISTRY_VERSION: semver string for the registry schema
- * - TRIGGER_REGISTRY_HASH:    12-char SHA-256 of (collection, keywords) per entry
- * - logRegistryStartup():     emits version + hash on first Compositor boot
- */
-/**
- * A trigger definition maps a collection to the conversation signals that
- * indicate it should be queried. When any keyword matches the user's latest
- * message, the compositor fetches relevant chunks from that collection.
- *
- * Centralizing trigger logic here (not in workspace stubs) means:
- * - One update propagates to all agents
- * - Stubs become documentation, not code
- * - Trigger logic can be tested independently
- *
- * W5 additions: owner, category, description (all optional — backward compat).
- */
-export interface CollectionTrigger {
-    /** Collection path: governance/policy, identity/job, etc. */
-    collection: string;
-    /** Keywords that trigger this collection (case-insensitive) */
-    keywords: string[];
-    /** Max tokens to inject from this collection */
-    maxTokens?: number;
-    /** Max chunks to retrieve */
-    maxChunks?: number;
-    /** Which agent/team owns this trigger set */
-    owner?: string;
-    /** Logical grouping: 'governance' | 'identity' | 'memory' | 'operations' */
-    category?: string;
-    /** Human-readable purpose */
-    description?: string;
-}
-export declare const TRIGGER_REGISTRY_VERSION = "1.0.0";
-/**
- * Default trigger registry for standard ACA collections.
- * Covers the core ACA offload use case from carol's spec.
- */
-export declare const TRIGGER_REGISTRY: CollectionTrigger[];
-/** Backward-compat alias — same reference as TRIGGER_REGISTRY */
-export declare const DEFAULT_TRIGGERS: CollectionTrigger[];
-/**
- * 12-char SHA-256 of the registry's (collection, keywords) pairs.
- * Changes when trigger definitions change; stable across metadata-only edits.
- * Computed once at module load.
- */
-export declare const TRIGGER_REGISTRY_HASH: string;
-/**
- * Match a user message against the trigger registry.
- * Returns triggered collections (deduplicated, ordered by trigger specificity).
- */
-export declare function matchTriggers(userMessage: string, triggers: CollectionTrigger[]): CollectionTrigger[];
-/**
- * Emit a one-line startup log with registry version, hash, and entry count.
- * Call once per process via the Compositor constructor guard.
- */
-export declare function logRegistryStartup(): void;
-//# sourceMappingURL=trigger-registry.d.ts.map

package/dist/trigger-registry.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"trigger-registry.d.ts","sourceRoot":"","sources":["../src/trigger-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAMH;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,iBAAiB;IAChC,6DAA6D;IAC7D,UAAU,EAAE,MAAM,CAAC;IACnB,+DAA+D;IAC/D,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,gDAAgD;IAChD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6BAA6B;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,6CAA6C;IAC7C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4EAA4E;IAC5E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6BAA6B;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAID,eAAO,MAAM,wBAAwB,UAAU,CAAC;AAEhD;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,iBAAiB,EAiH/C,CAAC;AAEF,iEAAiE;AACjE,eAAO,MAAM,gBAAgB,qBAAmB,CAAC;AAIjD;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,EAAE,MAGrB,CAAC;AAIhB;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,iBAAiB,EAAE,GAC5B,iBAAiB,EAAE,CAMrB;AAID;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAIzC"}