@vainplex/openclaw-cortex 0.1.0

package/dist/src/patterns.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"patterns.js","sourceRoot":"","sources":["../../src/patterns.ts"],"names":[],"mappings":"AAEA,+DAA+D;AAC/D,2BAA2B;AAC3B,+DAA+D;AAE/D,MAAM,oBAAoB,GAAG;IAC3B,8DAA8D;CAC/D,CAAC;AAEF,MAAM,oBAAoB,GAAG;IAC3B,yEAAyE;CAC1E,CAAC;AAEF,MAAM,iBAAiB,GAAG;IACxB,+EAA+E;IAC/E,0CAA0C;IAC1C,GAAG;CACJ,CAAC;AAEF,MAAM,iBAAiB,GAAG;IACxB,yEAAyE;IACzE,gDAAgD;CACjD,CAAC;AAEF,MAAM,gBAAgB,GAAG;IACvB,yCAAyC;CAC1C,CAAC;AAEF,MAAM,gBAAgB,GAAG;IACvB,8CAA8C;CAC/C,CAAC;AAEF,MAAM,iBAAiB,GAAG;IACxB,sDAAsD;CACvD,CAAC;AAEF,MAAM,iBAAiB,GAAG;IACxB,2DAA2D;CAC5D,CAAC;AAEF,MAAM,aAAa,GAA6C;IAC9D,UAAU,EAAE,gFAAgF;IAC5F,OAAO,EAAE,gFAAgF;IACzF,KAAK,EAAE,gFAAgF;IACvF,UAAU,EAAE,uEAAuE;IACnF,WAAW,EAAE,6EAA6E;CAC3F,CAAC;AAeF;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,QAAyB;IACnD,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,IAAI;YACP,OAAO;gBACL,QAAQ,EAAE,oBAAoB;gBAC9B,KAAK,EAAE,iBAAiB;gBACxB,IAAI,EAAE,gBAAgB;gBACtB,KAAK,EAAE,iBAAiB;aACzB,CAAC;QACJ,KAAK,IAAI;YACP,OAAO;gBACL,QAAQ,EAAE,oBAAoB;gBAC9B,KAAK,EAAE,iBAAiB;gBACxB,IAAI,EAAE,gBAAgB;gBACtB,KAAK,EAAE,iBAAiB;aACzB,CAAC;QACJ,KAAK,MAAM;YACT,OAAO;gBACL,QAAQ,EAAE,CAAC,GAAG,oBAAoB,EAAE,GAAG,oBAAoB,CAAC;gBAC5D,KAAK,EAAE,CAAC,GAAG,iBAAiB,EAAE,GAAG,iBAAiB,CAAC;gBACnD,IAAI,EAAE,CAAC,GAAG,gBAAgB,EAAE,GAAG,gBAAgB,CAAC;gBAChD,KAAK,EAAE,CAAC,GAAG,iBAAiB,EAAE,GAAG,iBAAiB,CAAC;aACpD,CAAC;IACN,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,IAAI,CAAC,IAAI;QAAE,OAAO,SAAS,CAAC;IAE5B,IAAI,QAAQ,GAAS,SAAS,CAAC;IAC/B,IAAI,OAAO,GAAG,CAAC,CAAC,CAAC;IAEjB,KAAK,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,aAAa,CAAyC,EAAE,CAAC;QACpG,wCAAwC;QACxC,MAAM,aAAa,GAAG,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QACvD,IAAI,KAA6B,CAAC;QAClC,OAAO,CAAC,KAAK,GAAG,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;YACnD,IAAI,KAAK,CAAC,KAAK,GAAG,OAAO,EAAE,CAAC;gBAC1B,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC;gBACtB,QAAQ,GAAG,IAAI,CAAC;YAClB,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,yDAAyD;AACzD,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,cAAc,EAAE,aAAa,EAAE,UAAU,EAAE,YAAY;IACvD,WAAW,EAAE,QAAQ,EAAE,SAAS,EAAE,YAAY,EAAE,YAAY;IAC5D,QAAQ,EAAE,UAAU,EAAE,OAAO,EAAE,UAAU,EAAE,UAAU;IACrD,UAAU,EAAE,WAAW,EAAE,QAAQ,EAAE,UAAU,EAAE,SAAS;CACzD,CAAC;AAEF,uCAAuC;AACvC,OAAO,EAAE,aAAa,EAAE,CAAC"}

package/dist/src/pre-compaction.d.ts

@@ -0,0 +1,21 @@
+import type { CompactingMessage, PreCompactionResult, PluginLogger, CortexConfig } from "./types.js";
+import { ThreadTracker } from "./thread-tracker.js";
+/**
+ * Build a hot snapshot markdown from compacting messages.
+ */
+export declare function buildHotSnapshot(messages: CompactingMessage[], maxMessages: number): string;
+/**
+ * Pre-Compaction Pipeline — orchestrates all modules before memory compaction.
+ */
+export declare class PreCompaction {
+    private readonly workspace;
+    private readonly config;
+    private readonly logger;
+    private readonly threadTracker;
+    constructor(workspace: string, config: CortexConfig, logger: PluginLogger, threadTracker: ThreadTracker);
+    /**
+     * Run the full pre-compaction pipeline.
+     */
+    run(compactingMessages?: CompactingMessage[]): PreCompactionResult;
+}
+//# sourceMappingURL=pre-compaction.d.ts.map

package/dist/src/pre-compaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pre-compaction.d.ts","sourceRoot":"","sources":["../../src/pre-compaction.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,iBAAiB,EACjB,mBAAmB,EACnB,YAAY,EACZ,YAAY,EACb,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAKpD;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,iBAAiB,EAAE,EAC7B,WAAW,EAAE,MAAM,GAClB,MAAM,CAsBR;AAED;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;IACtC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;IACtC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgB;gBAG5C,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,YAAY,EACpB,MAAM,EAAE,YAAY,EACpB,aAAa,EAAE,aAAa;IAQ9B;;OAEG;IACH,GAAG,CAAC,kBAAkB,CAAC,EAAE,iBAAiB,EAAE,GAAG,mBAAmB;CA6EnE"}

package/dist/src/pre-compaction.js

@@ -0,0 +1,108 @@
+import { join } from "node:path";
+import { NarrativeGenerator } from "./narrative-generator.js";
+import { BootContextGenerator } from "./boot-context.js";
+import { saveText, rebootDir, ensureRebootDir } from "./storage.js";
+/**
+ * Build a hot snapshot markdown from compacting messages.
+ */
+export function buildHotSnapshot(messages, maxMessages) {
+    const now = new Date().toISOString().slice(0, 19) + "Z";
+    const parts = [
+        `# Hot Snapshot — ${now}`,
+        "## Last conversation before compaction",
+        "",
+    ];
+    const recent = messages.slice(-maxMessages);
+    if (recent.length > 0) {
+        parts.push("**Recent messages:**");
+        for (const msg of recent) {
+            const content = msg.content.trim();
+            const short = content.length > 200 ? content.slice(0, 200) + "..." : content;
+            parts.push(`- [${msg.role}] ${short}`);
+        }
+    }
+    else {
+        parts.push("(No recent messages captured)");
+    }
+    parts.push("");
+    return parts.join("\n");
+}
+/**
+ * Pre-Compaction Pipeline — orchestrates all modules before memory compaction.
+ */
+export class PreCompaction {
+    workspace;
+    config;
+    logger;
+    threadTracker;
+    constructor(workspace, config, logger, threadTracker) {
+        this.workspace = workspace;
+        this.config = config;
+        this.logger = logger;
+        this.threadTracker = threadTracker;
+    }
+    /**
+     * Run the full pre-compaction pipeline.
+     */
+    run(compactingMessages) {
+        const warnings = [];
+        const now = new Date().toISOString();
+        let messagesSnapshotted = 0;
+        ensureRebootDir(this.workspace, this.logger);
+        // 1. Flush thread tracker state
+        try {
+            this.threadTracker.flush();
+            this.logger.info("[cortex] Pre-compaction: thread state flushed");
+        }
+        catch (err) {
+            warnings.push(`Thread flush failed: ${err}`);
+            this.logger.warn(`[cortex] Pre-compaction: thread flush failed: ${err}`);
+        }
+        // 2. Build and write hot snapshot
+        try {
+            const messages = compactingMessages ?? [];
+            messagesSnapshotted = Math.min(messages.length, this.config.preCompaction.maxSnapshotMessages);
+            const snapshot = buildHotSnapshot(messages, this.config.preCompaction.maxSnapshotMessages);
+            const snapshotPath = join(rebootDir(this.workspace), "hot-snapshot.md");
+            const ok = saveText(snapshotPath, snapshot, this.logger);
+            if (!ok)
+                warnings.push("Hot snapshot write failed");
+            this.logger.info(`[cortex] Pre-compaction: hot snapshot (${messagesSnapshotted} messages)`);
+        }
+        catch (err) {
+            warnings.push(`Hot snapshot failed: ${err}`);
+            this.logger.warn(`[cortex] Pre-compaction: hot snapshot failed: ${err}`);
+        }
+        // 3. Generate narrative
+        try {
+            if (this.config.narrative.enabled) {
+                const narrative = new NarrativeGenerator(this.workspace, this.logger);
+                narrative.write();
+                this.logger.info("[cortex] Pre-compaction: narrative generated");
+            }
+        }
+        catch (err) {
+            warnings.push(`Narrative generation failed: ${err}`);
+            this.logger.warn(`[cortex] Pre-compaction: narrative generation failed: ${err}`);
+        }
+        // 4. Generate boot context
+        try {
+            if (this.config.bootContext.enabled) {
+                const boot = new BootContextGenerator(this.workspace, this.config.bootContext, this.logger);
+                boot.write();
+                this.logger.info("[cortex] Pre-compaction: boot context generated");
+            }
+        }
+        catch (err) {
+            warnings.push(`Boot context generation failed: ${err}`);
+            this.logger.warn(`[cortex] Pre-compaction: boot context generation failed: ${err}`);
+        }
+        return {
+            success: warnings.length === 0,
+            timestamp: now,
+            messagesSnapshotted,
+            warnings,
+        };
+    }
+}
+//# sourceMappingURL=pre-compaction.js.map

package/dist/src/pre-compaction.js.map

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

package/dist/src/storage.d.ts

@@ -0,0 +1,44 @@
+import type { PluginLogger } from "./types.js";
+/**
+ * Resolve the reboot directory path.
+ * Does NOT create it — use ensureRebootDir() for that.
+ */
+export declare function rebootDir(workspace: string): string;
+/**
+ * Ensure the memory/reboot/ directory exists.
+ * Returns false if creation fails (read-only workspace).
+ */
+export declare function ensureRebootDir(workspace: string, logger: PluginLogger): boolean;
+/**
+ * Check if the workspace is writable.
+ */
+export declare function isWritable(workspace: string): boolean;
+/**
+ * Load a JSON file. Returns empty object on any failure.
+ */
+export declare function loadJson<T = Record<string, unknown>>(filePath: string): T;
+/**
+ * Atomically write JSON to a file.
+ * Writes to .tmp first, then renames. This prevents partial writes on crash.
+ * Returns false on failure (read-only filesystem).
+ */
+export declare function saveJson(filePath: string, data: unknown, logger: PluginLogger): boolean;
+/**
+ * Load a text file. Returns empty string on failure.
+ */
+export declare function loadText(filePath: string): string;
+/**
+ * Write a text file atomically.
+ * Returns false on failure.
+ */
+export declare function saveText(filePath: string, content: string, logger: PluginLogger): boolean;
+/**
+ * Get file modification time as ISO string. Returns null if file doesn't exist.
+ */
+export declare function getFileMtime(filePath: string): string | null;
+/**
+ * Check if a file is older than the given number of hours.
+ * Returns true if the file doesn't exist.
+ */
+export declare function isFileOlderThan(filePath: string, hours: number): boolean;
+//# sourceMappingURL=storage.d.ts.map

package/dist/src/storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../src/storage.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C;;;GAGG;AACH,wBAAgB,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,GAAG,OAAO,CAShF;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAarD;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,EAAE,MAAM,GAAG,CAAC,CAOzE;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,GAAG,OAAO,CAWvF;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAMjD;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,GAAG,OAAO,CAWzF;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAO5D;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAKxE"}

package/dist/src/storage.js

@@ -0,0 +1,126 @@
+import { readFileSync, writeFileSync, renameSync, mkdirSync, accessSync, statSync } from "node:fs";
+import { constants } from "node:fs";
+import { join, dirname } from "node:path";
+/**
+ * Resolve the reboot directory path.
+ * Does NOT create it — use ensureRebootDir() for that.
+ */
+export function rebootDir(workspace) {
+    return join(workspace, "memory", "reboot");
+}
+/**
+ * Ensure the memory/reboot/ directory exists.
+ * Returns false if creation fails (read-only workspace).
+ */
+export function ensureRebootDir(workspace, logger) {
+    const dir = rebootDir(workspace);
+    try {
+        mkdirSync(dir, { recursive: true });
+        return true;
+    }
+    catch (err) {
+        logger.warn(`[cortex] Cannot create ${dir}: ${err}`);
+        return false;
+    }
+}
+/**
+ * Check if the workspace is writable.
+ */
+export function isWritable(workspace) {
+    try {
+        accessSync(join(workspace, "memory"), constants.W_OK);
+        return true;
+    }
+    catch {
+        // memory/ might not exist yet — check workspace itself
+        try {
+            accessSync(workspace, constants.W_OK);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+}
+/**
+ * Load a JSON file. Returns empty object on any failure.
+ */
+export function loadJson(filePath) {
+    try {
+        const content = readFileSync(filePath, "utf-8");
+        return JSON.parse(content);
+    }
+    catch {
+        return {};
+    }
+}
+/**
+ * Atomically write JSON to a file.
+ * Writes to .tmp first, then renames. This prevents partial writes on crash.
+ * Returns false on failure (read-only filesystem).
+ */
+export function saveJson(filePath, data, logger) {
+    try {
+        mkdirSync(dirname(filePath), { recursive: true });
+        const tmpPath = filePath + ".tmp";
+        writeFileSync(tmpPath, JSON.stringify(data, null, 2) + "\n", "utf-8");
+        renameSync(tmpPath, filePath);
+        return true;
+    }
+    catch (err) {
+        logger.warn(`[cortex] Failed to write ${filePath}: ${err}`);
+        return false;
+    }
+}
+/**
+ * Load a text file. Returns empty string on failure.
+ */
+export function loadText(filePath) {
+    try {
+        return readFileSync(filePath, "utf-8");
+    }
+    catch {
+        return "";
+    }
+}
+/**
+ * Write a text file atomically.
+ * Returns false on failure.
+ */
+export function saveText(filePath, content, logger) {
+    try {
+        mkdirSync(dirname(filePath), { recursive: true });
+        const tmpPath = filePath + ".tmp";
+        writeFileSync(tmpPath, content, "utf-8");
+        renameSync(tmpPath, filePath);
+        return true;
+    }
+    catch (err) {
+        logger.warn(`[cortex] Failed to write ${filePath}: ${err}`);
+        return false;
+    }
+}
+/**
+ * Get file modification time as ISO string. Returns null if file doesn't exist.
+ */
+export function getFileMtime(filePath) {
+    try {
+        const stat = statSync(filePath);
+        return stat.mtime.toISOString();
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Check if a file is older than the given number of hours.
+ * Returns true if the file doesn't exist.
+ */
+export function isFileOlderThan(filePath, hours) {
+    const mtime = getFileMtime(filePath);
+    if (!mtime)
+        return true;
+    const ageMs = Date.now() - new Date(mtime).getTime();
+    return ageMs > hours * 60 * 60 * 1000;
+}
+//# sourceMappingURL=storage.js.map

package/dist/src/storage.js.map

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

package/dist/src/thread-tracker.d.ts

@@ -0,0 +1,75 @@
+import type { Thread, ThreadSignals, PluginLogger } from "./types.js";
+import type { PatternLanguage } from "./patterns.js";
+export type ThreadTrackerConfig = {
+    enabled: boolean;
+    pruneDays: number;
+    maxThreads: number;
+};
+/**
+ * Check if text matches a thread via word overlap (≥ minOverlap words from title in text).
+ * Words shorter than 3 characters are excluded.
+ */
+export declare function matchesThread(thread: Thread, text: string, minOverlap?: number): boolean;
+/**
+ * Extract thread-related signals from message text.
+ */
+export declare function extractSignals(text: string, language: PatternLanguage): ThreadSignals;
+/**
+ * Thread Tracker — manages conversation thread state.
+ */
+export declare class ThreadTracker {
+    private threads;
+    private dirty;
+    private writeable;
+    private eventsProcessed;
+    private lastEventTimestamp;
+    private sessionMood;
+    private readonly filePath;
+    private readonly config;
+    private readonly language;
+    private readonly logger;
+    constructor(workspace: string, config: ThreadTrackerConfig, language: PatternLanguage, logger: PluginLogger);
+    /** Create new threads from topic signals. */
+    private createFromTopics;
+    /** Close threads matching closure signals. */
+    private closeMatching;
+    /** Append decisions to matching threads. */
+    private applyDecisions;
+    /** Update waiting_for on matching threads. */
+    private applyWaits;
+    /** Update mood on active threads matching content. */
+    private applyMood;
+    /**
+     * Process a message: extract signals, update threads, persist.
+     */
+    processMessage(content: string, sender: string): void;
+    /**
+     * Prune closed threads older than pruneDays and enforce maxThreads cap.
+     */
+    private pruneAndCap;
+    /**
+     * Attempt to persist current state to disk.
+     */
+    private persist;
+    /**
+     * Build the ThreadsData object for serialization.
+     */
+    private buildData;
+    /**
+     * Force-flush state to disk. Called by pre-compaction.
+     */
+    flush(): boolean;
+    /**
+     * Get current thread list (in-memory).
+     */
+    getThreads(): Thread[];
+    /**
+     * Get current session mood.
+     */
+    getSessionMood(): string;
+    /**
+     * Get events processed count.
+     */
+    getEventsProcessed(): number;
+}
+//# sourceMappingURL=thread-tracker.d.ts.map

package/dist/src/thread-tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"thread-tracker.d.ts","sourceRoot":"","sources":["../../src/thread-tracker.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,MAAM,EAEN,aAAa,EAEb,YAAY,EACb,MAAM,YAAY,CAAC;AAEpB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAGrD,MAAM,MAAM,mBAAmB,GAAG;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF;;;GAGG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,SAAI,GAAG,OAAO,CAanF;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,eAAe,GAAG,aAAa,CAwCrF;AAaD;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,SAAS,CAAQ;IACzB,OAAO,CAAC,eAAe,CAAK;IAC5B,OAAO,CAAC,kBAAkB,CAAM;IAChC,OAAO,CAAC,WAAW,CAAa;IAChC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAsB;IAC7C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkB;IAC3C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;gBAGpC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,mBAAmB,EAC3B,QAAQ,EAAE,eAAe,EACzB,MAAM,EAAE,YAAY;IAgBtB,6CAA6C;IAC7C,OAAO,CAAC,gBAAgB;IAexB,8CAA8C;IAC9C,OAAO,CAAC,aAAa;IAUrB,4CAA4C;IAC5C,OAAO,CAAC,cAAc;IActB,8CAA8C;IAC9C,OAAO,CAAC,UAAU;IAWlB,sDAAsD;IACtD,OAAO,CAAC,SAAS;IASjB;;OAEG;IACH,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAsBrD;;OAEG;IACH,OAAO,CAAC,WAAW;IAsBnB;;OAEG;IACH,OAAO,CAAC,OAAO;IAWf;;OAEG;IACH,OAAO,CAAC,SAAS;IAcjB;;OAEG;IACH,KAAK,IAAI,OAAO;IAKhB;;OAEG;IACH,UAAU,IAAI,MAAM,EAAE;IAItB;;OAEG;IACH,cAAc,IAAI,MAAM;IAIxB;;OAEG;IACH,kBAAkB,IAAI,MAAM;CAG7B"}

package/dist/src/thread-tracker.js

@@ -0,0 +1,250 @@
+import { randomUUID } from "node:crypto";
+import { join } from "node:path";
+import { getPatterns, detectMood, HIGH_IMPACT_KEYWORDS } from "./patterns.js";
+import { loadJson, saveJson, rebootDir, ensureRebootDir } from "./storage.js";
+/**
+ * Check if text matches a thread via word overlap (≥ minOverlap words from title in text).
+ * Words shorter than 3 characters are excluded.
+ */
+export function matchesThread(thread, text, minOverlap = 2) {
+    const threadWords = new Set(thread.title.toLowerCase().split(/\s+/).filter(w => w.length > 2));
+    const textWords = new Set(text.toLowerCase().split(/\s+/).filter(w => w.length > 2));
+    let overlap = 0;
+    for (const word of threadWords) {
+        if (textWords.has(word))
+            overlap++;
+    }
+    return overlap >= minOverlap;
+}
+/**
+ * Extract thread-related signals from message text.
+ */
+export function extractSignals(text, language) {
+    const patterns = getPatterns(language);
+    const signals = { decisions: [], closures: [], waits: [], topics: [] };
+    for (const pattern of patterns.decision) {
+        const globalPattern = new RegExp(pattern.source, "gi");
+        let match;
+        while ((match = globalPattern.exec(text)) !== null) {
+            const start = Math.max(0, match.index - 50);
+            const end = Math.min(text.length, match.index + match[0].length + 100);
+            signals.decisions.push(text.slice(start, end).trim());
+        }
+    }
+    for (const pattern of patterns.close) {
+        if (pattern.test(text)) {
+            signals.closures.push(true);
+        }
+    }
+    for (const pattern of patterns.wait) {
+        const globalPattern = new RegExp(pattern.source, "gi");
+        let match;
+        while ((match = globalPattern.exec(text)) !== null) {
+            const end = Math.min(text.length, match.index + match[0].length + 80);
+            signals.waits.push(text.slice(match.index, end).trim());
+        }
+    }
+    for (const pattern of patterns.topic) {
+        const globalPattern = new RegExp(pattern.source, "gi");
+        let match;
+        while ((match = globalPattern.exec(text)) !== null) {
+            if (match[1]) {
+                signals.topics.push(match[1].trim());
+            }
+        }
+    }
+    return signals;
+}
+/**
+ * Infer thread priority from content.
+ */
+function inferPriority(text) {
+    const lower = text.toLowerCase();
+    for (const kw of HIGH_IMPACT_KEYWORDS) {
+        if (lower.includes(kw))
+            return "high";
+    }
+    return "medium";
+}
+/**
+ * Thread Tracker — manages conversation thread state.
+ */
+export class ThreadTracker {
+    threads = [];
+    dirty = false;
+    writeable = true;
+    eventsProcessed = 0;
+    lastEventTimestamp = "";
+    sessionMood = "neutral";
+    filePath;
+    config;
+    language;
+    logger;
+    constructor(workspace, config, language, logger) {
+        this.config = config;
+        this.language = language;
+        this.logger = logger;
+        this.filePath = join(rebootDir(workspace), "threads.json");
+        // Ensure directory exists
+        ensureRebootDir(workspace, logger);
+        // Load existing state
+        const data = loadJson(this.filePath);
+        this.threads = Array.isArray(data.threads) ? data.threads : [];
+        this.sessionMood = data.session_mood ?? "neutral";
+    }
+    /** Create new threads from topic signals. */
+    createFromTopics(topics, sender, mood, now) {
+        for (const topic of topics) {
+            const exists = this.threads.some(t => t.title.toLowerCase() === topic.toLowerCase() || matchesThread(t, topic));
+            if (!exists) {
+                this.threads.push({
+                    id: randomUUID(), title: topic, status: "open",
+                    priority: inferPriority(topic), summary: `Topic detected from ${sender}`,
+                    decisions: [], waiting_for: null, mood, last_activity: now, created: now,
+                });
+            }
+        }
+    }
+    /** Close threads matching closure signals. */
+    closeMatching(content, closures, now) {
+        if (closures.length === 0)
+            return;
+        for (const thread of this.threads) {
+            if (thread.status === "open" && matchesThread(thread, content)) {
+                thread.status = "closed";
+                thread.last_activity = now;
+            }
+        }
+    }
+    /** Append decisions to matching threads. */
+    applyDecisions(decisions, now) {
+        for (const ctx of decisions) {
+            for (const thread of this.threads) {
+                if (thread.status === "open" && matchesThread(thread, ctx)) {
+                    const short = ctx.slice(0, 100);
+                    if (!thread.decisions.includes(short)) {
+                        thread.decisions.push(short);
+                        thread.last_activity = now;
+                    }
+                }
+            }
+        }
+    }
+    /** Update waiting_for on matching threads. */
+    applyWaits(waits, content, now) {
+        for (const waitCtx of waits) {
+            for (const thread of this.threads) {
+                if (thread.status === "open" && matchesThread(thread, content)) {
+                    thread.waiting_for = waitCtx.slice(0, 100);
+                    thread.last_activity = now;
+                }
+            }
+        }
+    }
+    /** Update mood on active threads matching content. */
+    applyMood(mood, content) {
+        if (mood === "neutral")
+            return;
+        for (const thread of this.threads) {
+            if (thread.status === "open" && matchesThread(thread, content)) {
+                thread.mood = mood;
+            }
+        }
+    }
+    /**
+     * Process a message: extract signals, update threads, persist.
+     */
+    processMessage(content, sender) {
+        if (!content)
+            return;
+        const signals = extractSignals(content, this.language);
+        const mood = detectMood(content);
+        const now = new Date().toISOString();
+        this.eventsProcessed++;
+        this.lastEventTimestamp = now;
+        if (mood !== "neutral")
+            this.sessionMood = mood;
+        this.createFromTopics(signals.topics, sender, mood, now);
+        this.closeMatching(content, signals.closures, now);
+        this.applyDecisions(signals.decisions, now);
+        this.applyWaits(signals.waits, content, now);
+        this.applyMood(mood, content);
+        this.dirty = true;
+        this.pruneAndCap();
+        this.persist();
+    }
+    /**
+     * Prune closed threads older than pruneDays and enforce maxThreads cap.
+     */
+    pruneAndCap() {
+        const cutoff = new Date(Date.now() - this.config.pruneDays * 24 * 60 * 60 * 1000).toISOString();
+        // Remove closed threads older than cutoff
+        this.threads = this.threads.filter(t => !(t.status === "closed" && t.last_activity < cutoff));
+        // Enforce maxThreads cap — remove oldest closed threads first
+        if (this.threads.length > this.config.maxThreads) {
+            const open = this.threads.filter(t => t.status === "open");
+            const closed = this.threads
+                .filter(t => t.status === "closed")
+                .sort((a, b) => a.last_activity.localeCompare(b.last_activity));
+            const budget = this.config.maxThreads - open.length;
+            this.threads = [...open, ...closed.slice(Math.max(0, closed.length - budget))];
+        }
+    }
+    /**
+     * Attempt to persist current state to disk.
+     */
+    persist() {
+        if (!this.writeable)
+            return;
+        const ok = saveJson(this.filePath, this.buildData(), this.logger);
+        if (!ok) {
+            this.writeable = false;
+            this.logger.warn("[cortex] Workspace not writable — running in-memory only");
+        }
+        if (ok)
+            this.dirty = false;
+    }
+    /**
+     * Build the ThreadsData object for serialization.
+     */
+    buildData() {
+        return {
+            version: 2,
+            updated: new Date().toISOString(),
+            threads: this.threads,
+            integrity: {
+                last_event_timestamp: this.lastEventTimestamp || new Date().toISOString(),
+                events_processed: this.eventsProcessed,
+                source: "hooks",
+            },
+            session_mood: this.sessionMood,
+        };
+    }
+    /**
+     * Force-flush state to disk. Called by pre-compaction.
+     */
+    flush() {
+        if (!this.dirty)
+            return true;
+        return saveJson(this.filePath, this.buildData(), this.logger);
+    }
+    /**
+     * Get current thread list (in-memory).
+     */
+    getThreads() {
+        return [...this.threads];
+    }
+    /**
+     * Get current session mood.
+     */
+    getSessionMood() {
+        return this.sessionMood;
+    }
+    /**
+     * Get events processed count.
+     */
+    getEventsProcessed() {
+        return this.eventsProcessed;
+    }
+}
+//# sourceMappingURL=thread-tracker.js.map