@chendpoc/pi-memory 0.1.13 → 0.2.0

package/dist/store/indexChunks.js

@@ -0,0 +1,78 @@
+import { CHUNKING_DISABLED_MAX_CHARS } from "../constants/chunking.js";
+import { pathBasename } from "../utils/fs.js";
+function formatChunkContent(section, body) {
+    return `[${section}] ${body.trim()}`;
+}
+/**
+ * Split long text on paragraph / line / sentence boundaries, then hard-wrap at maxChars.
+ */
+export function splitTextByMaxChars(text, maxChars) {
+    const trimmed = text.trim();
+    if (!trimmed)
+        return [];
+    if (maxChars <= 0 || trimmed.length <= maxChars)
+        return [trimmed];
+    const parts = [];
+    let remaining = trimmed;
+    while (remaining.length > maxChars) {
+        let cut = maxChars;
+        const minCut = Math.floor(maxChars * 0.35);
+        const paragraph = remaining.lastIndexOf("\n\n", cut);
+        if (paragraph >= minCut) {
+            cut = paragraph;
+        }
+        else {
+            const line = remaining.lastIndexOf("\n", cut);
+            if (line >= minCut) {
+                cut = line;
+            }
+            else {
+                const sentence = remaining.lastIndexOf(". ", cut);
+                if (sentence >= minCut) {
+                    cut = sentence + 1;
+                }
+                else {
+                    const space = remaining.lastIndexOf(" ", cut);
+                    if (space >= minCut) {
+                        cut = space;
+                    }
+                }
+            }
+        }
+        const part = remaining.slice(0, cut).trim();
+        if (part)
+            parts.push(part);
+        remaining = remaining.slice(cut).trim();
+        if (!part && remaining.length > 0) {
+            parts.push(remaining.slice(0, maxChars).trim());
+            remaining = remaining.slice(maxChars).trim();
+        }
+    }
+    if (remaining)
+        parts.push(remaining);
+    return parts.length > 0 ? parts : [trimmed];
+}
+export function buildIndexDocuments(entries, chunking) {
+    const docs = [];
+    const maxChars = chunking.maxChars <= CHUNKING_DISABLED_MAX_CHARS
+        ? CHUNKING_DISABLED_MAX_CHARS
+        : chunking.maxChars;
+    for (const entry of entries) {
+        const bodies = maxChars <= CHUNKING_DISABLED_MAX_CHARS
+            ? [entry.content.trim()].filter(Boolean)
+            : splitTextByMaxChars(entry.content, maxChars);
+        if (bodies.length === 0)
+            continue;
+        bodies.forEach((body, index) => {
+            const id = bodies.length === 1 ? entry.id : `${entry.id}#${index}`;
+            docs.push({
+                id,
+                content: formatChunkContent(entry.section, body),
+                source: pathBasename(entry.sourceFile),
+                timestamp: entry.timestamp,
+            });
+        });
+    }
+    return docs;
+}
+//# sourceMappingURL=indexChunks.js.map

package/dist/store/indexChunks.js.map

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

package/dist/store/markdown/format.d.ts

@@ -0,0 +1,5 @@
+import type { MemorySection, StoreMemoryEntry } from "../types.js";
+export declare function formatEntryLine(entry: StoreMemoryEntry): string;
+export declare function formatSectionHeader(section: MemorySection): string;
+export declare function countLines(content: string): number;
+//# sourceMappingURL=format.d.ts.map

package/dist/store/markdown/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../../src/store/markdown/format.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEnE,wBAAgB,eAAe,CAAC,KAAK,EAAE,gBAAgB,GAAG,MAAM,CAI/D;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,CAElE;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAGlD"}

package/dist/store/markdown/format.js

@@ -0,0 +1,14 @@
+export function formatEntryLine(entry) {
+    const prefix = entry.userAuthored ? "[user] " : "";
+    const meta = `<!-- id:${entry.id}${entry.userAuthored ? " user" : ""} ts:${entry.timestamp} -->`;
+    return `- ${prefix}${entry.content.trim()} ${meta}`;
+}
+export function formatSectionHeader(section) {
+    return `## ${section}`;
+}
+export function countLines(content) {
+    if (!content)
+        return 0;
+    return content.split("\n").length;
+}
+//# sourceMappingURL=format.js.map

package/dist/store/markdown/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../../../src/store/markdown/format.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,eAAe,CAAC,KAAuB;IACrD,MAAM,MAAM,GAAG,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;IACnD,MAAM,IAAI,GAAG,WAAW,KAAK,CAAC,EAAE,GAAG,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,KAAK,CAAC,SAAS,MAAM,CAAC;IACjG,OAAO,KAAK,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,IAAI,EAAE,CAAC;AACtD,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,OAAsB;IACxD,OAAO,MAAM,OAAO,EAAE,CAAC;AACzB,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,OAAe;IACxC,IAAI,CAAC,OAAO;QAAE,OAAO,CAAC,CAAC;IACvB,OAAO,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC;AACpC,CAAC"}

package/dist/store/markdown/parse.d.ts

@@ -0,0 +1,5 @@
+import { type MemorySection, type ParsedEntry } from "../types.js";
+export declare function parseMemoryMarkdown(content: string, sourceFile: string): ParsedEntry[];
+export declare function listOverflowPointers(content: string): string[];
+export declare function isKnownSection(name: string): name is MemorySection;
+//# sourceMappingURL=parse.d.ts.map

package/dist/store/markdown/parse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../../src/store/markdown/parse.ts"],"names":[],"mappings":"AAIA,OAAO,EAAmB,KAAK,aAAa,EAAE,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAMpF,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,WAAW,EAAE,CAuCtF;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAO9D;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,IAAI,aAAa,CAElE"}

package/dist/store/markdown/parse.js

@@ -0,0 +1,57 @@
+import { pathBasename } from "../../utils/fs.js";
+import { epochTimestamp } from "../../utils/time.js";
+import { OVERFLOW_POINTER_RE } from "../../constants/memory.js";
+import { MEMORY_SECTIONS } from "../types.js";
+const SECTION_RE = /^##\s+(Preferences|Conventions|Findings|Todos)\s*$/;
+const ENTRY_META_RE = /<!--\s*id:([^\s]+)(?:\s+user)?(?:\s+ts:([^\s]+))?\s*-->/;
+const USER_PREFIX_RE = /^\[user\]\s+/;
+export function parseMemoryMarkdown(content, sourceFile) {
+    const entries = [];
+    let section;
+    const lines = content.split("\n");
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        const sectionMatch = line.match(SECTION_RE);
+        if (sectionMatch) {
+            section = sectionMatch[1];
+            continue;
+        }
+        if (!line.startsWith("- ") || !section)
+            continue;
+        const pointerMatch = line.match(OVERFLOW_POINTER_RE);
+        if (pointerMatch)
+            continue;
+        const metaMatch = line.match(ENTRY_META_RE);
+        const id = metaMatch?.[1] ?? `${pathBasename(sourceFile)}:${i + 1}`;
+        const timestamp = metaMatch?.[2] ?? epochTimestamp();
+        let body = line.slice(2).replace(ENTRY_META_RE, "").trim();
+        const userAuthored = USER_PREFIX_RE.test(body);
+        if (userAuthored)
+            body = body.replace(USER_PREFIX_RE, "").trim();
+        if (!body)
+            continue;
+        entries.push({
+            id,
+            section,
+            content: body,
+            userAuthored: userAuthored || undefined,
+            timestamp,
+            sourceFile,
+            line: i + 1,
+        });
+    }
+    return entries;
+}
+export function listOverflowPointers(content) {
+    const files = [];
+    for (const line of content.split("\n")) {
+        const match = line.match(OVERFLOW_POINTER_RE);
+        if (match?.[1])
+            files.push(match[1]);
+    }
+    return files;
+}
+export function isKnownSection(name) {
+    return MEMORY_SECTIONS.includes(name);
+}
+//# sourceMappingURL=parse.js.map

package/dist/store/markdown/parse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.js","sourceRoot":"","sources":["../../../src/store/markdown/parse.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAE,eAAe,EAAwC,MAAM,aAAa,CAAC;AAEpF,MAAM,UAAU,GAAG,oDAAoD,CAAC;AACxE,MAAM,aAAa,GAAG,yDAAyD,CAAC;AAChF,MAAM,cAAc,GAAG,cAAc,CAAC;AAEtC,MAAM,UAAU,mBAAmB,CAAC,OAAe,EAAE,UAAkB;IACrE,MAAM,OAAO,GAAkB,EAAE,CAAC;IAClC,IAAI,OAAkC,CAAC;IACvC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAElC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC;QACvB,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QAC5C,IAAI,YAAY,EAAE,CAAC;YACjB,OAAO,GAAG,YAAY,CAAC,CAAC,CAAkB,CAAC;YAC3C,SAAS;QACX,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,SAAS;QAEjD,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC;QACrD,IAAI,YAAY;YAAE,SAAS;QAE3B,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;QAC5C,MAAM,EAAE,GAAG,SAAS,EAAE,CAAC,CAAC,CAAC,IAAI,GAAG,YAAY,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACpE,MAAM,SAAS,GAAG,SAAS,EAAE,CAAC,CAAC,CAAC,IAAI,cAAc,EAAE,CAAC;QACrD,IAAI,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QAC3D,MAAM,YAAY,GAAG,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC/C,IAAI,YAAY;YAAE,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QAEjE,IAAI,CAAC,IAAI;YAAE,SAAS;QAEpB,OAAO,CAAC,IAAI,CAAC;YACX,EAAE;YACF,OAAO;YACP,OAAO,EAAE,IAAI;YACb,YAAY,EAAE,YAAY,IAAI,SAAS;YACvC,SAAS;YACT,UAAU;YACV,IAAI,EAAE,CAAC,GAAG,CAAC;SACZ,CAAC,CAAC;IACL,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,OAAe;IAClD,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACvC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC;QAC9C,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC;YAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACvC,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,OAAQ,eAAqC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AAC/D,CAAC"}

package/dist/store/markdown/template.d.ts

@@ -0,0 +1,3 @@
+/** Canonical empty MEMORY.md scaffold (ground truth format). */
+export declare function defaultMemoryTemplate(): string;
+//# sourceMappingURL=template.d.ts.map

package/dist/store/markdown/template.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template.d.ts","sourceRoot":"","sources":["../../../src/store/markdown/template.ts"],"names":[],"mappings":"AASA,gEAAgE;AAChE,wBAAgB,qBAAqB,IAAI,MAAM,CAa9C"}

package/dist/store/markdown/template.js

@@ -0,0 +1,22 @@
+import { MEMORY_SECTIONS } from "../types.js";
+const SECTION_HINTS = {
+    Preferences: "User preferences and defaults.",
+    Conventions: "Project or workflow conventions.",
+    Findings: "Durable conclusions, decisions, and facts.",
+    Todos: "Items to carry forward across sessions.",
+};
+/** Canonical empty MEMORY.md scaffold (ground truth format). */
+export function defaultMemoryTemplate() {
+    const sections = MEMORY_SECTIONS.map((section) => {
+        return `## ${section}\n\n<!-- ${SECTION_HINTS[section]} -->\n`;
+    }).join("\n");
+    return `# Memory
+
+<!-- pi-memory ground truth — cross-session durable notes for the Pi agent.
+     Sections: Preferences | Conventions | Findings | Todos
+     User entries: /remember → - [user] text <!-- id:... user ts:... -->
+     Line cap: 150; overflow spills to auto-*.md in this directory. -->
+
+${sections}`;
+}
+//# sourceMappingURL=template.js.map

package/dist/store/markdown/template.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"template.js","sourceRoot":"","sources":["../../../src/store/markdown/template.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9C,MAAM,aAAa,GAAqD;IACtE,WAAW,EAAE,gCAAgC;IAC7C,WAAW,EAAE,kCAAkC;IAC/C,QAAQ,EAAE,4CAA4C;IACtD,KAAK,EAAE,yCAAyC;CACjD,CAAC;AAEF,gEAAgE;AAChE,MAAM,UAAU,qBAAqB;IACnC,MAAM,QAAQ,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE;QAC/C,OAAO,MAAM,OAAO,YAAY,aAAa,CAAC,OAAO,CAAC,QAAQ,CAAC;IACjE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEd,OAAO;;;;;;;EAOP,QAAQ,EAAE,CAAC;AACb,CAAC"}

package/dist/store/memoryStore.d.ts

@@ -0,0 +1,69 @@
+import { type TimeInput } from "../utils/time.js";
+import type { IndexDocument, IntegrityReport, LlmClient, MemoryStats, MemoryStoreOptions, ParsedEntry, ResolvedMemory, StoreMemoryEntry } from "./types.js";
+export declare class MemoryStore {
+    private readonly paths;
+    private readonly backend;
+    private readonly maxLines;
+    private readonly fallbackMaxChars;
+    private readonly syncToSidecarListeners;
+    private readonly consolidateCheckListeners;
+    private consolidating;
+    constructor(opts: MemoryStoreOptions);
+    get agentDir(): string;
+    ensureInitialized(): Promise<void>;
+    isEmpty(): Promise<boolean>;
+    getStats(): Promise<MemoryStats>;
+    readRaw(): Promise<string>;
+    listEntries(): Promise<ParsedEntry[]>;
+    readResolved(): Promise<ResolvedMemory>;
+    readForFallback(maxChars?: number): Promise<string>;
+    exportForIndex(): Promise<IndexDocument[]>;
+    append(entry: StoreMemoryEntry): Promise<void>;
+    appendUser(entry: Omit<StoreMemoryEntry, "userAuthored">): Promise<void>;
+    appendMany(entries: StoreMemoryEntry[], opts?: {
+        mode?: "ifAbsent";
+    }): Promise<void>;
+    appendIfAbsent(entry: StoreMemoryEntry): Promise<boolean>;
+    /** Fire-and-forget: parse Memory Export from compact summary → appendIfAbsent. */
+    appendFromCompaction(opts: {
+        compactionId: string;
+        summary: string;
+        subagent?: boolean;
+        onComplete?: () => void | Promise<void>;
+    }): void;
+    private ingestCompactionSummary;
+    updateEntry(id: string, patch: Partial<StoreMemoryEntry>): Promise<void>;
+    removeEntry(id: string, opts?: {
+        force?: boolean;
+    }): Promise<void>;
+    rewrite(content: string): Promise<void>;
+    shouldConsolidate(at?: TimeInput, cronFired?: boolean): Promise<boolean>;
+    consolidate(llm: LlmClient): Promise<void>;
+    consolidateInBackground(llm: LlmClient, opts?: {
+        onComplete?: () => void | Promise<void>;
+    }): void;
+    forceConsolidate(llm: LlmClient): Promise<void>;
+    hasProcessedCompaction(compactionId: string): Promise<boolean>;
+    markCompactionProcessed(compactionId: string): Promise<void>;
+    verifyIntegrity(): Promise<IntegrityReport>;
+    /** Register a listener to sync MEMORY.md changes to the sidecar vector index. */
+    onSyncToSidecar(listener: () => void): () => void;
+    /** Register a listener invoked after writes to check shouldConsolidate. */
+    onConsolidateCheck(listener: () => void): () => void;
+    private notifyAfterWrite;
+    private notifySyncToSidecar;
+    private notifyConsolidateCheck;
+    private appendUnlocked;
+    private appendIfAbsentUnlocked;
+    private appendToOverflowUnlocked;
+    private insertEntryIntoMarkdown;
+    private rewriteEntriesUnlocked;
+    private readResolvedUnlocked;
+    private normalizeEntry;
+    private newEntryId;
+    private newAutoFilePath;
+    private readGcTimestamp;
+    private readCompactionState;
+}
+export declare function createMemoryStore(opts: MemoryStoreOptions): MemoryStore;
+//# sourceMappingURL=memoryStore.d.ts.map

package/dist/store/memoryStore.d.ts.map

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