compact-agent 1.9.0 → 1.10.0

package/dist/mempalace/index.d.ts

@@ -0,0 +1,100 @@
+/**
+ * MemPalace — high-level API.
+ *
+ * Combines the global (cross-project) and project (per-repo) stores into
+ * one façade. Most callers use these functions rather than poking the
+ * JsonStore directly because they handle the scope selection:
+ *
+ *   - Reads with scope: 'both' search both stores and merge results
+ *   - Writes with scope: 'global' or 'project' target one
+ *   - Writes with scope: 'both' rejected at runtime — every drawer lives
+ *     in exactly one store
+ *
+ * This module is the boundary between the storage internals (types.ts,
+ * store.ts, search.ts) and the agent-facing tools (src/tools/memory.ts)
+ * + slash commands.
+ */
+import { JsonStore } from './store.js';
+import type { Drawer, Tunnel, KGTriple, Scope, SearchOptions, SearchHit, WingMeta, RoomMeta } from './types.js';
+export declare function getGlobalStore(): JsonStore;
+/**
+ * Per-project store keyed by `cwd`. If the cwd changes mid-session (the
+ * user `/cd`s elsewhere), the next call gets a fresh store pointing at
+ * the new location. The old one stays valid for any held references.
+ */
+export declare function getProjectStore(cwd: string): JsonStore;
+/**
+ * Heuristic: should a piece of content live in the global or project
+ * store? Used when the agent calls memory_add with scope: 'auto'.
+ *
+ * Signals pushing GLOBAL: content mentions the user by name, talks about
+ * preferences, recurring patterns, identity, or cross-project facts.
+ * Default lean is PROJECT since per-repo facts dominate by volume.
+ */
+export declare function inferScope(content: string, tags: string[]): Scope;
+export interface AddDrawerInput {
+    wing: string;
+    room: string;
+    content: string;
+    tags?: string[];
+    importance?: number;
+    scope?: Scope | 'auto';
+    sourceSessionId?: string;
+    cwd: string;
+}
+export declare function addDrawer(input: AddDrawerInput): Drawer;
+export declare function getDrawer(id: string, cwd: string): Drawer | null;
+export declare function listDrawers(opts: {
+    wing?: string;
+    room?: string;
+    tag?: string;
+    scope?: Scope;
+    cwd: string;
+}): Drawer[];
+/**
+ * Search both stores by default and merge results, re-sorted by score.
+ * Specify scope to limit to one. Returns the top `limit` hits across
+ * the union.
+ */
+export declare function search(query: string, cwd: string, opts?: SearchOptions): SearchHit[];
+/**
+ * Link two drawers with a labelled relation. Both drawers must live in
+ * the same store — we don't cross global ↔ project boundaries because
+ * the link would silently break if either side is moved/deleted.
+ */
+export declare function linkDrawers(fromId: string, toId: string, relation: string, cwd: string): Tunnel;
+export declare function traverseTunnels(startId: string, cwd: string, maxDepth?: number): {
+    drawer: Drawer;
+    depth: number;
+    via: string[];
+}[];
+export declare function kgAdd(triple: {
+    subject: string;
+    predicate: string;
+    object: string;
+    confidence?: number;
+    sourceSessionId?: string;
+    sourceDrawerId?: string;
+}, scope: Scope, cwd: string): KGTriple;
+export declare function kgQuery(q: {
+    subject?: string;
+    predicate?: string;
+    object?: string;
+}, cwd: string, scope?: Scope): KGTriple[];
+export declare function kgTimeline(cwd: string, limit?: number, scope?: Scope): KGTriple[];
+export declare function listWings(cwd: string, scope?: Scope): {
+    global: WingMeta[];
+    project: WingMeta[];
+};
+export declare function listRooms(cwd: string, wing?: string, scope?: Scope): {
+    global: RoomMeta[];
+    project: RoomMeta[];
+};
+export declare function stats(cwd: string): {
+    global: ReturnType<JsonStore['stats']>;
+    project: ReturnType<JsonStore['stats']>;
+    globalPath: string;
+    projectPath: string;
+    projectExists: boolean;
+};
+export type { Drawer, Tunnel, KGTriple, Scope, SearchHit, SearchOptions, WingMeta, RoomMeta } from './types.js';

package/dist/mempalace/index.js

@@ -0,0 +1,196 @@
+/**
+ * MemPalace — high-level API.
+ *
+ * Combines the global (cross-project) and project (per-repo) stores into
+ * one façade. Most callers use these functions rather than poking the
+ * JsonStore directly because they handle the scope selection:
+ *
+ *   - Reads with scope: 'both' search both stores and merge results
+ *   - Writes with scope: 'global' or 'project' target one
+ *   - Writes with scope: 'both' rejected at runtime — every drawer lives
+ *     in exactly one store
+ *
+ * This module is the boundary between the storage internals (types.ts,
+ * store.ts, search.ts) and the agent-facing tools (src/tools/memory.ts)
+ * + slash commands.
+ */
+import { existsSync } from 'node:fs';
+import { JsonStore, globalStorePath, projectStorePath } from './store.js';
+// Lazily-constructed singletons — we don't want to create the global file
+// just by importing the module. They materialize on first read or write.
+let _global = null;
+let _project = null;
+let _projectCwd = null;
+export function getGlobalStore() {
+    if (!_global)
+        _global = new JsonStore(globalStorePath(), 'global');
+    return _global;
+}
+/**
+ * Per-project store keyed by `cwd`. If the cwd changes mid-session (the
+ * user `/cd`s elsewhere), the next call gets a fresh store pointing at
+ * the new location. The old one stays valid for any held references.
+ */
+export function getProjectStore(cwd) {
+    if (!_project || _projectCwd !== cwd) {
+        _project = new JsonStore(projectStorePath(cwd), 'project');
+        _projectCwd = cwd;
+    }
+    return _project;
+}
+/**
+ * Heuristic: should a piece of content live in the global or project
+ * store? Used when the agent calls memory_add with scope: 'auto'.
+ *
+ * Signals pushing GLOBAL: content mentions the user by name, talks about
+ * preferences, recurring patterns, identity, or cross-project facts.
+ * Default lean is PROJECT since per-repo facts dominate by volume.
+ */
+export function inferScope(content, tags) {
+    const lc = content.toLowerCase();
+    const tagsLc = tags.map((t) => t.toLowerCase());
+    // User-modeling signals → global
+    const userKeywords = [
+        'i prefer', 'i like', 'i always', 'i never', 'the user',
+        'my style', 'my workflow', 'rsfit',
+    ];
+    for (const k of userKeywords) {
+        if (lc.includes(k))
+            return 'global';
+    }
+    if (tagsLc.some((t) => ['preference', 'user', 'identity', 'workflow'].includes(t))) {
+        return 'global';
+    }
+    // Default: project-scoped. Codebase-specific facts outnumber cross-
+    // project facts in most workflows.
+    return 'project';
+}
+export function addDrawer(input) {
+    const tags = input.tags || [];
+    const resolvedScope = input.scope === 'auto' || !input.scope
+        ? inferScope(input.content, tags)
+        : input.scope;
+    const store = resolvedScope === 'global' ? getGlobalStore() : getProjectStore(input.cwd);
+    return store.addDrawer({
+        wing: input.wing,
+        room: input.room,
+        content: input.content,
+        tags,
+        importance: input.importance ?? 0.5,
+        sourceSessionId: input.sourceSessionId,
+    });
+}
+export function getDrawer(id, cwd) {
+    return getGlobalStore().getDrawer(id) ?? getProjectStore(cwd).getDrawer(id);
+}
+export function listDrawers(opts) {
+    const { wing, room, tag, cwd, scope = 'both' } = opts;
+    const filter = { wing, room, tag };
+    if (scope === 'global')
+        return getGlobalStore().listDrawers(filter);
+    if (scope === 'project')
+        return getProjectStore(cwd).listDrawers(filter);
+    return [...getGlobalStore().listDrawers(filter), ...getProjectStore(cwd).listDrawers(filter)];
+}
+// ── Search (the main agent-facing query) ──────────────────
+/**
+ * Search both stores by default and merge results, re-sorted by score.
+ * Specify scope to limit to one. Returns the top `limit` hits across
+ * the union.
+ */
+export function search(query, cwd, opts = {}) {
+    const scope = opts.scope ?? 'both';
+    const limit = opts.limit ?? 20;
+    const hits = [];
+    if (scope === 'global' || scope === 'both') {
+        hits.push(...getGlobalStore().search(query, { ...opts, limit: limit * 2 }));
+    }
+    if (scope === 'project' || scope === 'both') {
+        hits.push(...getProjectStore(cwd).search(query, { ...opts, limit: limit * 2 }));
+    }
+    hits.sort((a, b) => b.score - a.score);
+    return hits.slice(0, limit);
+}
+// ── Tunnels (drawer relationships) ────────────────────────
+/**
+ * Link two drawers with a labelled relation. Both drawers must live in
+ * the same store — we don't cross global ↔ project boundaries because
+ * the link would silently break if either side is moved/deleted.
+ */
+export function linkDrawers(fromId, toId, relation, cwd) {
+    // Try both stores to find the source drawer's scope
+    if (getGlobalStore().getDrawer(fromId)) {
+        if (!getGlobalStore().getDrawer(toId)) {
+            throw new Error(`linkDrawers: ${toId} not found in global scope (cross-scope tunnels not supported)`);
+        }
+        return getGlobalStore().addTunnel(fromId, toId, relation);
+    }
+    if (getProjectStore(cwd).getDrawer(fromId)) {
+        if (!getProjectStore(cwd).getDrawer(toId)) {
+            throw new Error(`linkDrawers: ${toId} not found in project scope (cross-scope tunnels not supported)`);
+        }
+        return getProjectStore(cwd).addTunnel(fromId, toId, relation);
+    }
+    throw new Error(`linkDrawers: source drawer ${fromId} not found in either scope`);
+}
+export function traverseTunnels(startId, cwd, maxDepth = 3) {
+    // Detect which scope the start drawer lives in
+    if (getGlobalStore().getDrawer(startId)) {
+        return getGlobalStore().traverse(startId, maxDepth);
+    }
+    return getProjectStore(cwd).traverse(startId, maxDepth);
+}
+// ── Knowledge graph ───────────────────────────────────────
+export function kgAdd(triple, scope, cwd) {
+    if (scope === 'both')
+        throw new Error('kgAdd: scope must be global or project');
+    const store = scope === 'global' ? getGlobalStore() : getProjectStore(cwd);
+    return store.addTriple({
+        subject: triple.subject,
+        predicate: triple.predicate,
+        object: triple.object,
+        confidence: triple.confidence ?? 1.0,
+        sourceSessionId: triple.sourceSessionId,
+        sourceDrawerId: triple.sourceDrawerId,
+    });
+}
+export function kgQuery(q, cwd, scope = 'both') {
+    const out = [];
+    if (scope === 'global' || scope === 'both')
+        out.push(...getGlobalStore().queryTriples(q));
+    if (scope === 'project' || scope === 'both')
+        out.push(...getProjectStore(cwd).queryTriples(q));
+    return out;
+}
+export function kgTimeline(cwd, limit = 20, scope = 'both') {
+    const out = [];
+    if (scope === 'global' || scope === 'both')
+        out.push(...getGlobalStore().recentTriples(limit * 2));
+    if (scope === 'project' || scope === 'both')
+        out.push(...getProjectStore(cwd).recentTriples(limit * 2));
+    out.sort((a, b) => b.createdAt.localeCompare(a.createdAt));
+    return out.slice(0, limit);
+}
+// ── Inventory / status ────────────────────────────────────
+export function listWings(cwd, scope = 'both') {
+    return {
+        global: scope !== 'project' ? getGlobalStore().listWings() : [],
+        project: scope !== 'global' ? getProjectStore(cwd).listWings() : [],
+    };
+}
+export function listRooms(cwd, wing, scope = 'both') {
+    return {
+        global: scope !== 'project' ? getGlobalStore().listRooms(wing) : [],
+        project: scope !== 'global' ? getProjectStore(cwd).listRooms(wing) : [],
+    };
+}
+export function stats(cwd) {
+    return {
+        global: getGlobalStore().stats(),
+        project: getProjectStore(cwd).stats(),
+        globalPath: globalStorePath(),
+        projectPath: projectStorePath(cwd),
+        projectExists: existsSync(projectStorePath(cwd)),
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/mempalace/index.js.map

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

package/dist/mempalace/search.d.ts

@@ -0,0 +1,38 @@
+/**
+ * MemPalace text search — tokenized, field-weighted scoring.
+ *
+ * Design goals:
+ *   1. Zero dependencies (no FTS index, no embedding model)
+ *   2. Reasonable ranking out of the box: title-ish fields outrank body
+ *   3. Tolerant to short queries (single keyword should still rank well)
+ *   4. Tolerant to plural / case variations via simple stemming
+ *
+ * We tokenize on non-alphanumeric, lowercase everything, drop tokens
+ * shorter than 2 chars and a small stopword list, and score each drawer
+ * by summing per-token field weights:
+ *
+ *   tags     × 4   (semantic tags are the strongest signal)
+ *   room     × 3
+ *   wing     × 2
+ *   content  × 1   (matches anywhere in body)
+ *
+ * Importance acts as a multiplier on the final score so the user can
+ * boost high-signal drawers via the importance field. Recency also
+ * lightly boosts via a half-life of 90 days.
+ *
+ * This is good enough until the store gets large; the search() entry
+ * point is the swap-in for a real FTS / embedding search later.
+ */
+import type { Drawer, SearchOptions, SearchHit } from './types.js';
+/**
+ * Tokenize a string into lowercase, deduplicated, non-stopword tokens of
+ * length ≥ 2. Very lightweight stemming: trailing 's' is stripped to fold
+ * "drawer"/"drawers" together. Aggressive stemming (Porter, etc.) would
+ * cost a lot for marginal recall gains at this scale.
+ */
+export declare function tokenize(s: string): string[];
+/**
+ * Top-level search. Filters by scope/wing/room/tags first, then scores
+ * each remaining drawer and returns the top `limit` by score.
+ */
+export declare function searchDrawers(drawers: Drawer[], query: string, opts?: SearchOptions): SearchHit[];

package/dist/mempalace/search.js

@@ -0,0 +1,133 @@
+/**
+ * MemPalace text search — tokenized, field-weighted scoring.
+ *
+ * Design goals:
+ *   1. Zero dependencies (no FTS index, no embedding model)
+ *   2. Reasonable ranking out of the box: title-ish fields outrank body
+ *   3. Tolerant to short queries (single keyword should still rank well)
+ *   4. Tolerant to plural / case variations via simple stemming
+ *
+ * We tokenize on non-alphanumeric, lowercase everything, drop tokens
+ * shorter than 2 chars and a small stopword list, and score each drawer
+ * by summing per-token field weights:
+ *
+ *   tags     × 4   (semantic tags are the strongest signal)
+ *   room     × 3
+ *   wing     × 2
+ *   content  × 1   (matches anywhere in body)
+ *
+ * Importance acts as a multiplier on the final score so the user can
+ * boost high-signal drawers via the importance field. Recency also
+ * lightly boosts via a half-life of 90 days.
+ *
+ * This is good enough until the store gets large; the search() entry
+ * point is the swap-in for a real FTS / embedding search later.
+ */
+const STOPWORDS = new Set([
+    'a', 'an', 'and', 'or', 'but', 'the', 'is', 'are', 'was', 'were', 'be',
+    'been', 'being', 'have', 'has', 'had', 'do', 'does', 'did', 'will',
+    'would', 'should', 'could', 'may', 'might', 'must', 'can', 'this',
+    'that', 'these', 'those', 'of', 'in', 'on', 'at', 'to', 'for', 'with',
+    'by', 'from', 'as', 'into', 'about', 'it', 'its', 'i', 'you', 'we',
+    'they', 'them', 'me', 'my', 'your', 'our', 'their', 'his', 'her',
+]);
+/**
+ * Tokenize a string into lowercase, deduplicated, non-stopword tokens of
+ * length ≥ 2. Very lightweight stemming: trailing 's' is stripped to fold
+ * "drawer"/"drawers" together. Aggressive stemming (Porter, etc.) would
+ * cost a lot for marginal recall gains at this scale.
+ */
+export function tokenize(s) {
+    const out = new Set();
+    for (const raw of s.toLowerCase().split(/[^a-z0-9]+/)) {
+        if (raw.length < 2)
+            continue;
+        if (STOPWORDS.has(raw))
+            continue;
+        // Tiny stemmer: strip trailing 's' on words ≥ 4 chars (avoids "is"/"as" issues)
+        const stem = raw.length >= 4 && raw.endsWith('s') ? raw.slice(0, -1) : raw;
+        out.add(stem);
+    }
+    return [...out];
+}
+/**
+ * Score a single drawer against a tokenized query. Returns 0 if no match,
+ * otherwise a positive score (higher = better).
+ *
+ * The `matchedFields` array tracks which fields contributed so callers
+ * can use it for diagnostics / highlighting.
+ */
+function scoreDrawer(drawer, queryTokens, matchedFields) {
+    if (queryTokens.length === 0)
+        return 0;
+    const contentTokens = new Set(tokenize(drawer.content));
+    const tagSet = new Set(drawer.tags.flatMap(tokenize));
+    const wingTokens = new Set(tokenize(drawer.wing));
+    const roomTokens = new Set(tokenize(drawer.room));
+    let score = 0;
+    let anyMatch = false;
+    for (const qt of queryTokens) {
+        if (tagSet.has(qt)) {
+            score += 4;
+            matchedFields.add('tags');
+            anyMatch = true;
+        }
+        if (roomTokens.has(qt)) {
+            score += 3;
+            matchedFields.add('room');
+            anyMatch = true;
+        }
+        if (wingTokens.has(qt)) {
+            score += 2;
+            matchedFields.add('wing');
+            anyMatch = true;
+        }
+        if (contentTokens.has(qt)) {
+            score += 1;
+            matchedFields.add('content');
+            anyMatch = true;
+        }
+    }
+    if (!anyMatch)
+        return 0;
+    // Importance multiplier — 0.5 default gives no boost, 1.0 → 1.5×, 0 → 0.5×
+    score *= 1 + (drawer.importance - 0.5);
+    // Recency bonus — half-life of 90 days. Drawers from today get +50%,
+    // 90-day-old drawers get +25%, older fade toward baseline.
+    const ageDays = (Date.now() - new Date(drawer.updatedAt).getTime()) / (1000 * 60 * 60 * 24);
+    const recencyBoost = 0.5 * Math.pow(0.5, ageDays / 90);
+    score *= 1 + recencyBoost;
+    return score;
+}
+/**
+ * Top-level search. Filters by scope/wing/room/tags first, then scores
+ * each remaining drawer and returns the top `limit` by score.
+ */
+export function searchDrawers(drawers, query, opts = {}) {
+    const tokens = tokenize(query);
+    if (tokens.length === 0)
+        return [];
+    let candidates = drawers;
+    if (opts.wing)
+        candidates = candidates.filter((d) => d.wing === opts.wing.toLowerCase());
+    if (opts.room)
+        candidates = candidates.filter((d) => d.room === opts.room.toLowerCase());
+    if (opts.tags && opts.tags.length > 0) {
+        const required = opts.tags.map((t) => t.toLowerCase());
+        candidates = candidates.filter((d) => required.every((t) => d.tags.includes(t)));
+    }
+    if (opts.minImportance !== undefined) {
+        candidates = candidates.filter((d) => d.importance >= opts.minImportance);
+    }
+    const hits = [];
+    for (const d of candidates) {
+        const matchedFields = new Set();
+        const score = scoreDrawer(d, tokens, matchedFields);
+        if (score > 0) {
+            hits.push({ drawer: d, score, matchedFields: [...matchedFields] });
+        }
+    }
+    hits.sort((a, b) => b.score - a.score);
+    return hits.slice(0, opts.limit ?? 20);
+}
+//# sourceMappingURL=search.js.map

package/dist/mempalace/search.js.map

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

package/dist/mempalace/store.d.ts

@@ -0,0 +1,77 @@
+import type { Drawer, Tunnel, KGTriple, Scope, WingMeta, RoomMeta, SearchOptions, SearchHit } from './types.js';
+/** ~/.crowcoder/memory/store.json — cross-project knowledge */
+export declare function globalStorePath(): string;
+/** <cwd>/.crowcoder/memory/store.json — per-repo knowledge */
+export declare function projectStorePath(cwd: string): string;
+/**
+ * Time-ordered ID: hex timestamp + 8 random hex chars. Sorts naturally by
+ * creation time, no UUID library needed. ~96 bits of entropy total which
+ * is overkill for a single-user store but keeps collision chances at
+ * effective zero even across machines.
+ */
+export declare function newId(prefix: string): string;
+/**
+ * A single-file MemPalace store backed by JSON. Mutations are immediately
+ * persisted to disk — there's no in-memory cache to flush. Trades a small
+ * amount of throughput for crash safety, which matters more for a memory
+ * system.
+ */
+export declare class JsonStore {
+    private readonly path;
+    readonly scope: Scope;
+    constructor(path: string, scope: Scope);
+    private read;
+    private write;
+    addDrawer(input: Omit<Drawer, 'id' | 'createdAt' | 'updatedAt' | 'scope'>): Drawer;
+    getDrawer(id: string): Drawer | null;
+    updateDrawer(id: string, patch: Partial<Omit<Drawer, 'id' | 'createdAt' | 'scope'>>): Drawer | null;
+    deleteDrawer(id: string): boolean;
+    listDrawers(filter?: {
+        wing?: string;
+        room?: string;
+        tag?: string;
+    }): Drawer[];
+    listWings(): WingMeta[];
+    listRooms(wing?: string): RoomMeta[];
+    addTunnel(fromDrawerId: string, toDrawerId: string, relation: string): Tunnel;
+    /**
+     * Find all tunnels touching a drawer, in either direction. Useful for
+     * "what is this drawer related to?" queries.
+     */
+    findTunnels(drawerId: string): {
+        outgoing: Tunnel[];
+        incoming: Tunnel[];
+    };
+    /**
+     * Walk outgoing tunnels from a start drawer for up to maxDepth hops,
+     * returning every drawer reached and the path that got us there.
+     * Bounded by visited-set so cycles don't loop forever.
+     */
+    traverse(startId: string, maxDepth?: number): {
+        drawer: Drawer;
+        depth: number;
+        via: string[];
+    }[];
+    deleteTunnel(id: string): boolean;
+    addTriple(t: Omit<KGTriple, 'id' | 'createdAt' | 'scope'>): KGTriple;
+    /**
+     * Query triples with optional s/p/o filters. Any field left undefined
+     * acts as a wildcard. Matching is case-insensitive equality on each
+     * specified field.
+     */
+    queryTriples(q: {
+        subject?: string;
+        predicate?: string;
+        object?: string;
+    }): KGTriple[];
+    /** Most-recent triples first. For "what have I been learning?" views. */
+    recentTriples(limit?: number): KGTriple[];
+    search(query: string, opts?: SearchOptions): SearchHit[];
+    stats(): {
+        drawers: number;
+        tunnels: number;
+        triples: number;
+        wings: number;
+        rooms: number;
+    };
+}