@chendpoc/pi-memory 0.2.1 → 0.2.3

package/dist/sidecar/client.js

@@ -68,4 +68,3 @@ export async function reindex(socketPath, documents = []) {
     const request_id = randomUUID();
     return sidecarRequest(socketPath, { type: "reindex", request_id, documents }, SIDECAR_REINDEX_TIMEOUT_MS);
 }
-//# sourceMappingURL=client.js.map

package/dist/sidecar/paths.d.ts

@@ -5,4 +5,3 @@ export type SidecarPaths = {
 export declare function resolveSidecarPaths(agentDir: string): SidecarPaths;
 /** Resolve compiled sidecar entry (dist/sidecar/server/process.js). */
 export declare function resolveSidecarEntry(): string;
-//# sourceMappingURL=paths.d.ts.map

package/dist/sidecar/paths.js

@@ -20,4 +20,3 @@ export function resolveSidecarEntry() {
     }
     throw new Error("Sidecar entry not found; run `pnpm build` first");
 }
-//# sourceMappingURL=paths.js.map

package/dist/sidecar/protocol.d.ts

@@ -51,4 +51,3 @@ export type SidecarResponse = {
 export declare function isErrorResponse(res: SidecarResponse): res is Extract<SidecarResponse, {
     type: "error";
 }>;
-//# sourceMappingURL=protocol.d.ts.map

package/dist/sidecar/protocol.js

@@ -1,4 +1,3 @@
 export function isErrorResponse(res) {
     return res.type === "error";
 }
-//# sourceMappingURL=protocol.js.map

package/dist/sidecar/reindexBridge.d.ts

@@ -10,4 +10,3 @@ export declare function createReindexScheduler(opts: {
     getDocuments: () => Promise<IndexDocument[]>;
     debounceMs?: number;
 }): ReindexScheduler;
-//# sourceMappingURL=reindexBridge.d.ts.map

package/dist/sidecar/reindexBridge.js

@@ -34,4 +34,3 @@ export function createReindexScheduler(opts) {
     }, opts.debounceMs ?? DEFAULT_REINDEX_DEBOUNCE_MS);
     return { schedule, runNow };
 }
-//# sourceMappingURL=reindexBridge.js.map

package/dist/sidecar/server/process.d.ts

@@ -1,2 +1 @@
 export {};
-//# sourceMappingURL=process.d.ts.map

package/dist/sidecar/server/process.js

@@ -19,4 +19,3 @@ function onSignal() {
 }
 process.on("SIGTERM", onSignal);
 process.on("SIGINT", onSignal);
-//# sourceMappingURL=process.js.map

package/dist/sidecar/server/query.d.ts

@@ -5,4 +5,3 @@ export type QueryContext = {
 export declare function handleQuery(requestId: string, queryText: string, ctx: QueryContext): Promise<Extract<SidecarResponse, {
     type: "result";
 }>>;
-//# sourceMappingURL=query.d.ts.map

package/dist/sidecar/server/query.js

@@ -4,4 +4,3 @@ export async function handleQuery(requestId, queryText, ctx) {
     const results = await store.query(queryText);
     return { type: "result", request_id: requestId, results };
 }
-//# sourceMappingURL=query.js.map

package/dist/sidecar/server/reindex.d.ts

@@ -5,4 +5,3 @@ export type ReindexContext = {
 export declare function handleReindex(requestId: string, ctx: ReindexContext, documents?: IndexDocument[]): Promise<Extract<SidecarResponse, {
     type: "reindex_ok";
 }>>;
-//# sourceMappingURL=reindex.d.ts.map

package/dist/sidecar/server/reindex.js

@@ -9,4 +9,3 @@ export async function handleReindex(requestId, ctx, documents = []) {
         index_generation: outcome.indexGeneration,
     };
 }
-//# sourceMappingURL=reindex.js.map

package/dist/sidecar/server/server.d.ts

@@ -8,4 +8,3 @@ export type SidecarServer = {
     shutdown: () => void;
 };
 export declare function createSidecarServer(opts: SidecarServerOpts): SidecarServer;
-//# sourceMappingURL=server.d.ts.map

package/dist/sidecar/server/server.js

@@ -73,4 +73,3 @@ export function createSidecarServer(opts) {
     });
     return { server, shutdown };
 }
-//# sourceMappingURL=server.js.map

package/dist/sidecar/server/stats.d.ts

@@ -5,4 +5,3 @@ export type StatsContext = {
 export declare function handleStats(ctx: StatsContext): Extract<SidecarResponse, {
     type: "stats_ok";
 }>;
-//# sourceMappingURL=stats.d.ts.map

package/dist/sidecar/server/stats.js

@@ -15,4 +15,3 @@ export function handleStats(ctx) {
             : {}),
     };
 }
-//# sourceMappingURL=stats.js.map

package/dist/sidecar/server/vec/embedder.d.ts

@@ -1,2 +1 @@
 export { getEmbedder, resetEmbedderForTests, createEmbedder, type Embedder } from "../../../adapters/embed/factory.js";
-//# sourceMappingURL=embedder.d.ts.map

package/dist/sidecar/server/vec/embedder.js

@@ -1,2 +1 @@
 export { getEmbedder, resetEmbedderForTests, createEmbedder } from "../../../adapters/embed/factory.js";
-//# sourceMappingURL=embedder.js.map

package/dist/sidecar/server/vec/mmr.d.ts

@@ -10,4 +10,3 @@ export declare function cosineSimilarity(a: Float32Array, b: Float32Array): numb
 /** MMR re-ranking: λ defaults from retrieval config (see constants/retrieval.ts). */
 export declare function mmrSelect(queryEmbedding: Float32Array, candidates: ScoredCandidate[], limit: number, lambda?: number): ScoredCandidate[];
 export declare function distanceToRelevance(distance: number): number;
-//# sourceMappingURL=mmr.d.ts.map

package/dist/sidecar/server/vec/mmr.js

@@ -33,4 +33,3 @@ export function mmrSelect(queryEmbedding, candidates, limit, lambda = MMR_LAMBDA
 export function distanceToRelevance(distance) {
     return Math.max(0, Math.min(1, 1 - distance));
 }
-//# sourceMappingURL=mmr.js.map

package/dist/sidecar/server/vec/store.d.ts

@@ -27,4 +27,3 @@ export declare class VecStore {
 export declare function getVecStore(dbPath: string): VecStore;
 /** @internal test hook */
 export declare function resetVecStoreForTests(): void;
-//# sourceMappingURL=store.d.ts.map

package/dist/sidecar/server/vec/store.js

@@ -176,4 +176,3 @@ export function resetVecStoreForTests() {
         store.close();
     stores.clear();
 }
-//# sourceMappingURL=store.js.map

package/dist/sidecar/sidecarManager.d.ts

@@ -7,4 +7,3 @@ export type SidecarOpts = {
 /** 上层唯一入口：确保 sidecar 在跑（attach 或 spawn） */
 export declare function ensureSidecarRunning(opts: SidecarOpts): Promise<void>;
 export declare function stopSidecar(): Promise<void>;
-//# sourceMappingURL=sidecarManager.d.ts.map

package/dist/sidecar/sidecarManager.js

@@ -108,4 +108,3 @@ function releaseSpawnLock(socketPath) {
     }
     catch { }
 }
-//# sourceMappingURL=sidecarManager.js.map

package/dist/sidecar/utils.d.ts

@@ -1,3 +1,2 @@
 export declare function waitUntilReady(predicate: () => Promise<boolean>, timeout: number): Promise<void>;
 export declare function canConnect(socketPath: string): Promise<boolean>;
-//# sourceMappingURL=utils.d.ts.map

package/dist/sidecar/utils.js

@@ -24,4 +24,3 @@ export function canConnect(socketPath) {
         });
     });
 }
-//# sourceMappingURL=utils.js.map

package/dist/sidecar/warmup.d.ts

@@ -3,4 +3,3 @@ export type WarmSidecarOptions = {
 };
 /** Pre-open sidecar DB and optionally smoke-test embed + vec paths. Fail-silent. */
 export declare function warmSidecar(socketPath: string, options?: WarmSidecarOptions): Promise<void>;
-//# sourceMappingURL=warmup.d.ts.map

package/dist/sidecar/warmup.js

@@ -36,4 +36,3 @@ export async function warmSidecar(socketPath, options = {}) {
         total_ms: nowMs() - startedAt,
     });
 }
-//# sourceMappingURL=warmup.js.map

package/dist/store/backend.d.ts

@@ -9,4 +9,3 @@ export declare class MarkdownMemoryBackend {
     deleteAutoFile(path: string): Promise<void>;
     withMemoryLock<T>(fn: () => Promise<T>): Promise<T>;
 }
-//# sourceMappingURL=backend.d.ts.map

package/dist/store/backend.js

@@ -44,4 +44,3 @@ export class MarkdownMemoryBackend {
         }
     }
 }
-//# sourceMappingURL=backend.js.map

package/dist/store/index.d.ts

@@ -3,4 +3,3 @@ export { MarkdownMemoryBackend } from "./backend.js";
 export { getAgentPaths, resolveAgentDir } from "./paths.js";
 export * from "./types.js";
 export * from "../constants/memory.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/store/index.js

@@ -3,4 +3,3 @@ export { MarkdownMemoryBackend } from "./backend.js";
 export { getAgentPaths, resolveAgentDir } from "./paths.js";
 export * from "./types.js";
 export * from "../constants/memory.js";
-//# sourceMappingURL=index.js.map

package/dist/store/indexChunks.d.ts

@@ -6,4 +6,3 @@ import type { ParsedEntry } from "./types.js";
  */
 export declare function splitTextByMaxChars(text: string, maxChars: number): string[];
 export declare function buildIndexDocuments(entries: ParsedEntry[], chunking: ChunkingConfig): IndexDocument[];
-//# sourceMappingURL=indexChunks.d.ts.map

package/dist/store/indexChunks.js

@@ -75,4 +75,3 @@ export function buildIndexDocuments(entries, chunking) {
     }
     return docs;
 }
-//# sourceMappingURL=indexChunks.js.map

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

@@ -2,4 +2,3 @@ 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.js

@@ -11,4 +11,3 @@ export function countLines(content) {
         return 0;
     return content.split("\n").length;
 }
-//# sourceMappingURL=format.js.map

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

@@ -2,4 +2,3 @@ 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.js

@@ -54,4 +54,3 @@ export function listOverflowPointers(content) {
 export function isKnownSection(name) {
     return MEMORY_SECTIONS.includes(name);
 }
-//# sourceMappingURL=parse.js.map

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

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

package/dist/store/markdown/template.js

@@ -19,4 +19,3 @@ export function defaultMemoryTemplate() {
 
 ${sections}`;
 }
-//# sourceMappingURL=template.js.map

package/dist/store/memoryStore.d.ts

@@ -66,4 +66,3 @@ export declare class MemoryStore {
     private readCompactionState;
 }
 export declare function createMemoryStore(opts: MemoryStoreOptions): MemoryStore;
-//# sourceMappingURL=memoryStore.d.ts.map

package/dist/store/memoryStore.js

@@ -418,4 +418,3 @@ export class MemoryStore {
 export function createMemoryStore(opts) {
     return new MemoryStore(opts);
 }
-//# sourceMappingURL=memoryStore.js.map

package/dist/store/paths.d.ts

@@ -7,4 +7,3 @@ export type AgentPaths = {
 export declare function resolveAgentDir(agentDir: string): string;
 export declare function getAgentPaths(agentDir: string, memoryFileName?: string): AgentPaths;
 export declare function isAutoOverflowFile(name: string): boolean;
-//# sourceMappingURL=paths.d.ts.map

package/dist/store/paths.js

@@ -16,4 +16,3 @@ export function getAgentPaths(agentDir, memoryFileName = DEFAULT_MEMORY_FILE) {
 export function isAutoOverflowFile(name) {
     return name.startsWith(AUTO_FILE_PREFIX) && name.endsWith(".md");
 }
-//# sourceMappingURL=paths.js.map

package/dist/store/types.d.ts

@@ -35,4 +35,3 @@ export type MemoryStoreOptions = {
     defaultFallbackMaxChars?: number;
 };
 export type { IndexDocument };
-//# sourceMappingURL=types.d.ts.map

package/dist/store/types.js

@@ -1,3 +1,2 @@
 import { MEMORY_SECTIONS } from "../constants/memory.js";
 export { MEMORY_SECTIONS };
-//# sourceMappingURL=types.js.map

package/dist/ui/memoryStatusWidget.d.ts

@@ -17,4 +17,3 @@ export declare class MemoryStatusWidget implements Component {
     render(width: number): string[];
 }
 export declare function createMemoryStatusWidget(_tui: TUI, theme: Theme, state: MemoryStatusWidgetState): MemoryStatusWidget;
-//# sourceMappingURL=memoryStatusWidget.d.ts.map

package/dist/ui/memoryStatusWidget.js

@@ -48,4 +48,3 @@ export class MemoryStatusWidget {
 export function createMemoryStatusWidget(_tui, theme, state) {
     return new MemoryStatusWidget(theme, state);
 }
-//# sourceMappingURL=memoryStatusWidget.js.map

package/dist/utils/debugLog.d.ts

@@ -1,4 +1,3 @@
 export declare function isMemoryDebugEnabled(env?: NodeJS.ProcessEnv): boolean;
 /** Debug-only stderr log; never shown to Pi UI or session. */
 export declare function debugMemory(scope: string, message: string, fields?: Record<string, string | number | boolean | null | undefined>, env?: NodeJS.ProcessEnv): void;
-//# sourceMappingURL=debugLog.d.ts.map

package/dist/utils/debugLog.js

@@ -11,4 +11,3 @@ export function debugMemory(scope, message, fields, env = process.env) {
         : "";
     console.error(theme.dim(`[${scope}] ${message}${suffix}`));
 }
-//# sourceMappingURL=debugLog.js.map

package/dist/utils/fs.d.ts

@@ -23,4 +23,3 @@ export declare function listDir(dirPath: string): Promise<string[]>;
 export declare function removeFile(filePath: string): Promise<void>;
 /** Ensure file exists (empty) for lockfile targets. */
 export declare function ensureFile(filePath: string): Promise<void>;
-//# sourceMappingURL=fs.d.ts.map

package/dist/utils/fs.js

@@ -98,4 +98,3 @@ export async function ensureFile(filePath) {
         throw error;
     }
 }
-//# sourceMappingURL=fs.js.map

package/dist/utils/index.d.ts

@@ -5,4 +5,3 @@ export { cleanupSocketFiles, removeSocketFile, secureSocketPath } from "./socket
 export { debugMemory, isMemoryDebugEnabled } from "./debugLog.js";
 export { daysSince, epochTimestamp, formatLocalDate, formatTimestamp, now, nowMs, parseTime, remainingMs, type TimeInput, } from "./time.js";
 export { buildConsolidateCliArgs, buildMaintenanceCliArgs, defaultConsolidateSchedulerPaths, formatConsolidateCronLine, formatMaintenanceCronLine, getConsolidateSchedulerKind, getConsolidateTemplateNames, type ConsolidateCliInvocation, type ConsolidateSchedulerKind, type ConsolidateSchedulerPaths, type ConsolidateTemplateName, } from "./scheduler.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/utils/index.js

@@ -5,4 +5,3 @@ export { cleanupSocketFiles, removeSocketFile, secureSocketPath } from "./socket
 export { debugMemory, isMemoryDebugEnabled } from "./debugLog.js";
 export { daysSince, epochTimestamp, formatLocalDate, formatTimestamp, now, nowMs, parseTime, remainingMs, } from "./time.js";
 export { buildConsolidateCliArgs, buildMaintenanceCliArgs, defaultConsolidateSchedulerPaths, formatConsolidateCronLine, formatMaintenanceCronLine, getConsolidateSchedulerKind, getConsolidateTemplateNames, } from "./scheduler.js";
-//# sourceMappingURL=index.js.map

package/dist/utils/paths.d.ts

@@ -19,4 +19,3 @@ export declare function mkdirOptions(): {
     recursive: true;
     mode?: number;
 };
-//# sourceMappingURL=paths.d.ts.map

package/dist/utils/paths.js

@@ -48,4 +48,3 @@ export function mkdirOptions() {
     const mode = secureDirMode();
     return mode === undefined ? { recursive: true } : { recursive: true, mode };
 }
-//# sourceMappingURL=paths.js.map

package/dist/utils/platform.d.ts

@@ -4,4 +4,3 @@ export declare function isWindows(): boolean;
 export declare function isMacOS(): boolean;
 /** Unix-like platforms where chmod / UDS cleanup apply. */
 export declare function isUnixLike(): boolean;
-//# sourceMappingURL=platform.d.ts.map

package/dist/utils/platform.js

@@ -15,4 +15,3 @@ export function isMacOS() {
 export function isUnixLike() {
     return !isWindows();
 }
-//# sourceMappingURL=platform.js.map

package/dist/utils/scheduler.d.ts

@@ -30,4 +30,3 @@ export type ConsolidateTemplateName = (typeof SCHEDULER_TEMPLATE_FILES)[keyof ty
 /** Template file basename shipped under templates/ for this platform. */
 export declare function getConsolidateTemplateNames(platform?: PiMemoryPlatform): ConsolidateTemplateName[];
 export { LAUNCHD_LABEL, SCHEDULER_TEMPLATE_FILES, SCHTASKS_TASK_NAME, isMacOS, isWindows };
-//# sourceMappingURL=scheduler.d.ts.map

package/dist/utils/scheduler.js

@@ -60,4 +60,3 @@ export function getConsolidateTemplateNames(platform = getPlatform()) {
     return [SCHEDULER_TEMPLATE_FILES.crontab];
 }
 export { LAUNCHD_LABEL, SCHEDULER_TEMPLATE_FILES, SCHTASKS_TASK_NAME, isMacOS, isWindows };
-//# sourceMappingURL=scheduler.js.map

package/dist/utils/socket.d.ts

@@ -4,4 +4,3 @@ export declare function removeSocketFile(socketPath: string): void;
 export declare function secureSocketPath(socketPath: string): void;
 /** Remove socket and pid companion files on shutdown. */
 export declare function cleanupSocketFiles(socketPath: string, pidPath?: string): void;
-//# sourceMappingURL=socket.d.ts.map

package/dist/utils/socket.js

@@ -32,4 +32,3 @@ export function cleanupSocketFiles(socketPath, pidPath) {
         }
     }
 }
-//# sourceMappingURL=socket.js.map

package/dist/utils/time.d.ts

@@ -19,4 +19,3 @@ export declare function epochTimestamp(): string;
 export declare function daysSince(from: TimeInput, to?: TimeInput): number;
 /** Milliseconds left until `deadlineMs` (default clock: now). */
 export declare function remainingMs(deadlineMs: number, atMs?: number): number;
-//# sourceMappingURL=time.d.ts.map

package/dist/utils/time.js

@@ -39,4 +39,3 @@ export function daysSince(from, to) {
 export function remainingMs(deadlineMs, atMs = nowMs()) {
     return Math.max(0, deadlineMs - atMs);
 }
-//# sourceMappingURL=time.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chendpoc/pi-memory",
-  "version": "0.2.1",
+  "version": "0.2.3",
   "description": "Cross-session episodic memory for Pi agent — MEMORY.md ground truth, JSONL sidecar retrieval, and Preflight injection",
   "type": "module",
   "main": "./dist/index.js",
@@ -21,7 +21,8 @@
   },
   "scripts": {
     "clean": "rm -rf dist",
-    "build": "rm -rf dist && tsc",
+    "build": "rm -rf dist && tsc -p tsconfig.dist.json",
+    "prepare": "node ./scripts/prepare.mjs",
     "postinstall": "node ./scripts/postinstall.mjs",
     "test": "vitest run",
     "test:watch": "vitest",
@@ -37,18 +38,13 @@
   },
   "files": [
     "dist",
-    "src/**/*.ts",
-    "!src/**/*.test.ts",
     "templates/MEMORY.md.example",
     "scripts/path-utils.mjs",
     "scripts/init-memory-workspace.mjs",
     "scripts/platform-fs.mjs",
     "scripts/postinstall.mjs",
-    "README.md",
-    "doc/README-zh.md",
-    "doc/ROADMAP.md",
-    "doc/ROADMAP-zh.md",
-    "UBIQUITOUS_LANGUAGE.md"
+    "scripts/prepare.mjs",
+    "README.md"
   ],
   "engines": {
     "node": ">=24.0.0 <25"
@@ -71,7 +67,7 @@
   "homepage": "https://github.com/chendpoc/pi-memory#readme",
   "pi": {
     "extensions": [
-      "./src/pi-extension.ts"
+      "./dist/pi-extension.js"
     ]
   },
   "peerDependencies": {

package/scripts/prepare.mjs

@@ -0,0 +1,24 @@
+#!/usr/bin/env node
+/**
+ * Build dist only when missing (git clone / local dev).
+ * Published tarballs already include dist/ — skip rebuild on consumer install.
+ */
+import { existsSync } from "node:fs";
+import { spawnSync } from "node:child_process";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const packageRoot = join(dirname(fileURLToPath(import.meta.url)), "..");
+const entry = join(packageRoot, "dist", "pi-extension.js");
+
+if (existsSync(entry)) {
+  process.exit(0);
+}
+
+const result = spawnSync("pnpm", ["run", "build"], {
+  cwd: packageRoot,
+  stdio: "inherit",
+  shell: process.platform === "win32",
+});
+
+process.exit(result.status ?? 1);

package/UBIQUITOUS_LANGUAGE.md

@@ -1,81 +0,0 @@
-# Ubiquitous Language
-
-> pi-memory 扩展的领域术语表。实现与文档以本表 canonical 名称为准。
-
-## Storage
-
-| Term | Definition | Aliases to avoid |
-| ---- | ---------- | ---------------- |
-| **Ground Truth** | The durable cross-session fact store: `MEMORY.md` plus overflow `auto-*.md` files. | memory.db, chat backup |
-| **Vector Index** | A derived SQLite file (`memory.vec.sqlite`) holding embeddings for episodic retrieval. | memory.db, sqlite-vec ANN |
-| **Memory Entry** | One bullet fact in Ground Truth under Preferences, Conventions, Findings, or Todos. | note, fact, bullet |
-| **Overflow File** | An `auto-*.md` spill file created when `MEMORY.md` exceeds the line cap. | auto file, spill |
-
-## Read path
-
-| Term | Definition | Aliases to avoid |
-| ---- | ---------- | ---------------- |
-| **Preflight** | Best-effort retrieval and injection before the main model sees each user message. | memory recall, pre-fetch |
-| **QueryIntent** | Structured retrieval hints (what/who/where or raw_query) extracted by a helper LLM. | search intent |
-| **Memory Cap** | Session-scoped static summary of Ground Truth injected without episodic query. | turnMemoryIndex, static cap |
-| **Episodic Preflight** | QueryIntent → Sidecar query → optional Fallback for query-dependent recall. | full preflight |
-| **Fallback** | Silent read of Ground Truth when Sidecar returns nothing or errors. | md fallback |
-| **Private Memory** | The `<private_memory>` block prefixed to in-flight user messages only. | injected context |
-
-## Write path
-
-| Term | Definition | Aliases to avoid |
-| ---- | ---------- | ---------------- |
-| **Memory Export** | The cross-session facts section inside a dual-purpose compact summary. | memoryQueue, export block |
-| **Compact Delta** | New Memory Export facts filtered against existing Ground Truth before append (subagent). | Stage1, shutdown extract |
-| **Dual-Purpose Summary** | One LLM compact output with Session Context and Memory Export sections. | compact summary |
-| **Consolidate** | Periodic LLM merge/dedupe of Ground Truth; not a source of new facts. | GC, merge |
-| **Shutdown Queue** | Append-only JSONL file (`.memory_shutdown_queue.jsonl`) of session metadata on shutdown; drained by `pi-memory maintenance`. | session enqueue pipeline |
-
-## Infrastructure
-
-| Term | Definition | Aliases to avoid |
-| ---- | ---------- | ---------------- |
-| **Sidecar** | Separate Node process for embed, vector scan, MMR, and reindex over UDS. | tlm, daemon |
-| **JSONL Framing** | One JSON object per line over UDS IPC. | NDJSON, ndjson |
-| **Index Generation** | Monotonic counter bumped on reindex; invalidates query cache. | indexGeneration |
-| **onSyncToSidecar** | Callback fired after Ground Truth writes to schedule debounced reindex. | onDirty |
-| **onConsolidateCheck** | Callback fired after writes to schedule debounced consolidate evaluation. | onDirty |
-
-## Session types
-
-| Term | Definition | Aliases to avoid |
-| ---- | ---------- | ---------------- |
-| **Root Session** | A top-level Pi agent session without a parent session header. | main session |
-| **Subagent Session** | A forked session whose header includes `parentSession` or `parent_session`. | child session, fork |
-
-## Relationships
-
-- **Ground Truth** is the source; the **Vector Index** is derived and may lag.
-- **Preflight** reads **Ground Truth** via **Sidecar** first, then **Fallback**.
-- **Root Session** runs **Episodic Preflight** plus **Memory Cap** each turn; **Subagent Session** runs **Memory Cap** only.
-- **Memory Export** from compaction flows through **Compact Delta** for **Subagent Session**, then **appendIfAbsent**.
-- **Shutdown Queue** records metadata only; it does not write **Ground Truth**.
-- **Consolidate** rewrites **Ground Truth** and triggers **onSyncToSidecar**.
-
-## Example dialogue
-
-> **Dev:** "When a **Subagent Session** compacts, do we run **Episodic Preflight** on its turns?"
->
-> **Domain expert:** "No. Subagents get **Memory Cap** at **session_start** and skip **Episodic Preflight**. New durable facts still arrive via **Memory Export**, but **Compact Delta** filters out anything already in parent **Ground Truth**."
->
-> **Dev:** "What happens on **session_shutdown**?"
->
-> **Domain expert:** "We append one line to the **Shutdown Queue**—session file, parent path, reason. No LLM on shutdown. **`pi-memory maintenance`** drains the queue offline (after consolidate), reusing **Compact Delta** rules for subagents."
->
-> **Dev:** "If **Sidecar** is down, does **Preflight** fail?"
->
-> **Domain expert:** "It **Fallback**s to **Ground Truth** or **Private Memory** stays empty. The user never sees an error."
-
-## Flagged ambiguities
-
-- **memory.db** was used for the vector file — canonical name is **Vector Index** file `memory.vec.sqlite`.
-- **sqlite-vec** implied ANN search — MVP uses **better-sqlite3 + full-table cosine scan**; ANN is future work.
-- **NDJSON / ndjson** — canonical term is **JSONL Framing** (one JSON object per line).
-- **memoryQueue / onDirty / Stage1** — replaced by **appendFromCompaction**, **onSyncToSidecar**, and **Compact Delta**.
-- **MVP chunking**：**1 Memory Entry = 1+ vector chunks**；超过 `PI_MEMORY_CHUNK_MAX_CHARS`（默认 512）按段落/句界拆分，`chunk_id = entry.id` 或 `entry.id#N`；embed 文本带 `[Section]` 前缀。Ground Truth 仍为 1 bullet = 1 entry。

package/dist/adapters/embed/factory.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../src/adapters/embed/factory.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAI3C,wBAAgB,cAAc,CAAC,GAAG,4CAAoB,GAAG,QAAQ,CA4BhE;AAED,wBAAgB,WAAW,IAAI,QAAQ,CAGtC;AAED,0BAA0B;AAC1B,wBAAgB,qBAAqB,IAAI,IAAI,CAE5C;AAED,YAAY,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC"}

package/dist/adapters/embed/factory.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../../src/adapters/embed/factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACvE,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAGnD,IAAI,cAAoC,CAAC;AAEzC,MAAM,UAAU,cAAc,CAAC,GAAG,GAAG,eAAe,EAAE;IACpD,QAAQ,GAAG,CAAC,QAAQ,EAAE,CAAC;QACrB,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE,CAAC;gBACtB,MAAM,IAAI,KAAK,CAAC,+EAA+E,CAAC,CAAC;YACnG,CAAC;YACD,MAAM,GAAG,GAAG,eAAe,CAAC,GAAG,CAAC,gBAAgB,EAAE,GAAG,CAAC,gBAAgB,CAAC,CAAC;YACxE,OAAO,oBAAoB,CAAC;gBAC1B,MAAM,EAAE,GAAG,CAAC,YAAY;gBACxB,KAAK,EAAE,GAAG,CAAC,gBAAgB;gBAC3B,GAAG;gBACH,SAAS,EAAE,GAAG,CAAC,aAAa;aAC7B,CAAC,CAAC;QACL,CAAC;QACD,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,MAAM,GAAG,GAAG,eAAe,CAAC,GAAG,CAAC,gBAAgB,EAAE,GAAG,CAAC,gBAAgB,CAAC,CAAC;YACxE,OAAO,oBAAoB,CAAC;gBAC1B,OAAO,EAAE,GAAG,CAAC,aAAa;gBAC1B,KAAK,EAAE,GAAG,CAAC,gBAAgB;gBAC3B,GAAG;gBACH,SAAS,EAAE,GAAG,CAAC,aAAa;aAC7B,CAAC,CAAC;QACL,CAAC;QACD,OAAO,CAAC,CAAC,CAAC;YACR,MAAM,GAAG,GAAG,GAAG,CAAC,gBAAgB,IAAI,sBAAsB,CAAC;YAC3D,OAAO,kBAAkB,CAAC,GAAG,CAAC,CAAC;QACjC,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,UAAU,WAAW;IACzB,cAAc,KAAK,cAAc,EAAE,CAAC;IACpC,OAAO,cAAc,CAAC;AACxB,CAAC;AAED,0BAA0B;AAC1B,MAAM,UAAU,qBAAqB;IACnC,cAAc,GAAG,SAAS,CAAC;AAC7B,CAAC"}

package/dist/adapters/embed/hash.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"hash.d.ts","sourceRoot":"","sources":["../../../src/adapters/embed/hash.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAG3C,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ,CAuBxD"}

package/dist/adapters/embed/hash.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"hash.js","sourceRoot":"","sources":["../../../src/adapters/embed/hash.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzC,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAEpD,MAAM,UAAU,kBAAkB,CAAC,GAAW;IAC5C,MAAM,SAAS,GAAG,CAAC,IAAY,EAAgB,EAAE;QAC/C,MAAM,GAAG,GAAG,IAAI,YAAY,CAAC,GAAG,CAAC,CAAC;QAClC,MAAM,MAAM,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC;QAC1D,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;YAC7B,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,CAAE,CAAC;YACxC,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,CAAE,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAC3D,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,CAAC;QAC/B,CAAC;QACD,OAAO,kBAAkB,CAAC,GAAG,CAAC,CAAC;IACjC,CAAC,CAAC;IAEF,OAAO;QACL,QAAQ,EAAE,MAAM;QAChB,KAAK,EAAE,UAAU;QACjB,GAAG;QACH,KAAK,CAAC,KAAK,CAAC,IAAI;YACd,OAAO,SAAS,CAAC,IAAI,CAAC,CAAC;QACzB,CAAC;QACD,KAAK,CAAC,UAAU,CAAC,KAAK;YACpB,OAAO,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC9B,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/adapters/embed/normalize.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"normalize.d.ts","sourceRoot":"","sources":["../../../src/adapters/embed/normalize.ts"],"names":[],"mappings":"AAAA,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,YAAY,GAAG,YAAY,CAMlE;AAED,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAIpG"}

package/dist/adapters/embed/normalize.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"normalize.js","sourceRoot":"","sources":["../../../src/adapters/embed/normalize.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,kBAAkB,CAAC,GAAiB;IAClD,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE;QAAE,IAAI,IAAI,GAAG,CAAC,CAAC,CAAE,GAAG,GAAG,CAAC,CAAC,CAAE,CAAC;IAC/D,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC5B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE;QAAE,GAAG,CAAC,CAAC,CAAE,IAAI,IAAI,CAAC;IACrD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,SAAuB,EAAE,WAAmB,EAAE,KAAa;IAC5F,IAAI,SAAS,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;QACrC,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,iCAAiC,WAAW,SAAS,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC;IACnG,CAAC;AACH,CAAC"}

package/dist/adapters/embed/ollama.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ollama.d.ts","sourceRoot":"","sources":["../../../src/adapters/embed/ollama.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAW3C,wBAAgB,oBAAoB,CAAC,IAAI,EAAE;IACzC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;CACnB,GAAG,QAAQ,CA8BX"}

package/dist/adapters/embed/ollama.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ollama.js","sourceRoot":"","sources":["../../../src/adapters/embed/ollama.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAQxE,SAAS,OAAO,CAAC,OAAe,EAAE,IAAY;IAC5C,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,IAKpC;IACC,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;IAEhD,MAAM,WAAW,GAAG,KAAK,EAAE,KAAe,EAA2B,EAAE;QACrE,MAAM,IAAI,GAAG,MAAM,QAAQ,CACzB,GAAG,EACH,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,EACnE,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAC9B,CAAC;QAEF,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE;YACxC,MAAM,SAAS,GAAG,kBAAkB,CAAC,IAAI,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC;YAC5D,kBAAkB,CAAC,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,UAAU,IAAI,CAAC,KAAK,QAAQ,KAAK,EAAE,CAAC,CAAC;YAC7E,OAAO,SAAS,CAAC;QACnB,CAAC,CAAC,CAAC;IACL,CAAC,CAAC;IAEF,OAAO;QACL,QAAQ,EAAE,QAAQ;QAClB,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,GAAG,EAAE,IAAI,CAAC,GAAG;QACb,KAAK,CAAC,KAAK,CAAC,IAAI;YACd,MAAM,CAAC,SAAS,CAAC,GAAG,MAAM,WAAW,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;YAC9C,OAAO,SAAU,CAAC;QACpB,CAAC;QACD,KAAK,CAAC,UAAU,CAAC,KAAK;YACpB,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO,EAAE,CAAC;YAClC,OAAO,WAAW,CAAC,KAAK,CAAC,CAAC;QAC5B,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/adapters/embed/openai.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"openai.d.ts","sourceRoot":"","sources":["../../../src/adapters/embed/openai.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAM3C,wBAAgB,oBAAoB,CAAC,IAAI,EAAE;IACzC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;CACnB,GAAG,QAAQ,CAgCX"}

package/dist/adapters/embed/openai.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"openai.js","sourceRoot":"","sources":["../../../src/adapters/embed/openai.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAOxE,MAAM,UAAU,oBAAoB,CAAC,IAKpC;IACC,MAAM,WAAW,GAAG,KAAK,EAAE,KAAe,EAA2B,EAAE;QACrE,MAAM,IAAI,GAAG,MAAM,QAAQ,CACzB,sCAAsC,EACtC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,EACnC;YACE,OAAO,EAAE,EAAE,aAAa,EAAE,UAAU,IAAI,CAAC,MAAM,EAAE,EAAE;YACnD,SAAS,EAAE,IAAI,CAAC,SAAS;SAC1B,CACF,CAAC;QAEF,OAAO,IAAI,CAAC,IAAI;aACb,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC;aACjC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;YACX,MAAM,SAAS,GAAG,kBAAkB,CAAC,IAAI,YAAY,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC;YACtE,kBAAkB,CAAC,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,UAAU,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;YAChE,OAAO,SAAS,CAAC;QACnB,CAAC,CAAC,CAAC;IACP,CAAC,CAAC;IAEF,OAAO;QACL,QAAQ,EAAE,QAAQ;QAClB,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,GAAG,EAAE,IAAI,CAAC,GAAG;QACb,KAAK,CAAC,KAAK,CAAC,IAAI;YACd,MAAM,CAAC,SAAS,CAAC,GAAG,MAAM,WAAW,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;YAC9C,OAAO,SAAU,CAAC;QACpB,CAAC;QACD,KAAK,CAAC,UAAU,CAAC,KAAK;YACpB,OAAO,WAAW,CAAC,KAAK,CAAC,CAAC;QAC5B,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/adapters/embed/types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/adapters/embed/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAE5D,MAAM,MAAM,QAAQ,GAAG;IACrB,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAC3C,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;CACtD,CAAC"}