@chendpoc/pi-memory 0.1.12 → 0.2.0

package/dist/constants/index.js

@@ -0,0 +1,8 @@
+export * from "./paths.js";
+export * from "./memory.js";
+export * from "./timing.js";
+export * from "./env.js";
+export * from "./preflight.js";
+export * from "./retrieval.js";
+export * from "./security.js";
+//# sourceMappingURL=index.js.map

package/dist/constants/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/constants/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC"}

package/dist/constants/memory.d.ts

@@ -0,0 +1,17 @@
+export declare const DEFAULT_MEMORY_FILE = "MEMORY.md";
+export declare const MEMORY_GC_FILE = ".memory_gc";
+export declare const COMPACTION_STATE_FILE = ".memory_compactions.json";
+export declare const SHUTDOWN_QUEUE_FILE = ".memory_shutdown_queue.jsonl";
+export declare const SHUTDOWN_PROCESSED_FILE = ".memory_shutdown_processed.json";
+export declare const AUTO_FILE_PREFIX = "auto-";
+export declare const OVERFLOW_POINTER_RE: RegExp;
+export declare const MEMORY_SECTIONS: readonly ["Preferences", "Conventions", "Findings", "Todos"];
+export type MemorySection = (typeof MEMORY_SECTIONS)[number];
+/** MEMORY.md line cap before spilling to auto-*.md. */
+export declare const DEFAULT_MAX_LINES = 150;
+/** Max chars for MEMORY.md fallback injection in preflight. */
+export declare const DEFAULT_FALLBACK_MAX_CHARS = 8000;
+/** Consolidate triggers (OR). */
+export declare const CONSOLIDATE_OVERFLOW_FILE_THRESHOLD = 12;
+export declare const CONSOLIDATE_GC_INTERVAL_DAYS = 7;
+//# sourceMappingURL=memory.d.ts.map

package/dist/constants/memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../src/constants/memory.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,mBAAmB,cAAc,CAAC;AAC/C,eAAO,MAAM,cAAc,eAAe,CAAC;AAC3C,eAAO,MAAM,qBAAqB,6BAA6B,CAAC;AAChE,eAAO,MAAM,mBAAmB,iCAAiC,CAAC;AAClE,eAAO,MAAM,uBAAuB,oCAAoC,CAAC;AACzE,eAAO,MAAM,gBAAgB,UAAU,CAAC;AAExC,eAAO,MAAM,mBAAmB,QACmC,CAAC;AAEpE,eAAO,MAAM,eAAe,8DAA+D,CAAC;AAC5F,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAE7D,uDAAuD;AACvD,eAAO,MAAM,iBAAiB,MAAM,CAAC;AAErC,+DAA+D;AAC/D,eAAO,MAAM,0BAA0B,OAAQ,CAAC;AAEhD,iCAAiC;AACjC,eAAO,MAAM,mCAAmC,KAAK,CAAC;AACtD,eAAO,MAAM,4BAA4B,IAAI,CAAC"}

package/dist/constants/memory.js

@@ -0,0 +1,16 @@
+export const DEFAULT_MEMORY_FILE = "MEMORY.md";
+export const MEMORY_GC_FILE = ".memory_gc";
+export const COMPACTION_STATE_FILE = ".memory_compactions.json";
+export const SHUTDOWN_QUEUE_FILE = ".memory_shutdown_queue.jsonl";
+export const SHUTDOWN_PROCESSED_FILE = ".memory_shutdown_processed.json";
+export const AUTO_FILE_PREFIX = "auto-";
+export const OVERFLOW_POINTER_RE = /^-\s*\(overflow\)\s*→\s*(auto-[\w-]+\.md)\s*(?:<!--.*?-->)?\s*$/;
+export const MEMORY_SECTIONS = ["Preferences", "Conventions", "Findings", "Todos"];
+/** MEMORY.md line cap before spilling to auto-*.md. */
+export const DEFAULT_MAX_LINES = 150;
+/** Max chars for MEMORY.md fallback injection in preflight. */
+export const DEFAULT_FALLBACK_MAX_CHARS = 8_000;
+/** Consolidate triggers (OR). */
+export const CONSOLIDATE_OVERFLOW_FILE_THRESHOLD = 12;
+export const CONSOLIDATE_GC_INTERVAL_DAYS = 7;
+//# sourceMappingURL=memory.js.map

package/dist/constants/memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.js","sourceRoot":"","sources":["../../src/constants/memory.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,mBAAmB,GAAG,WAAW,CAAC;AAC/C,MAAM,CAAC,MAAM,cAAc,GAAG,YAAY,CAAC;AAC3C,MAAM,CAAC,MAAM,qBAAqB,GAAG,0BAA0B,CAAC;AAChE,MAAM,CAAC,MAAM,mBAAmB,GAAG,8BAA8B,CAAC;AAClE,MAAM,CAAC,MAAM,uBAAuB,GAAG,iCAAiC,CAAC;AACzE,MAAM,CAAC,MAAM,gBAAgB,GAAG,OAAO,CAAC;AAExC,MAAM,CAAC,MAAM,mBAAmB,GAC9B,iEAAiE,CAAC;AAEpE,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,aAAa,EAAE,aAAa,EAAE,UAAU,EAAE,OAAO,CAAU,CAAC;AAG5F,uDAAuD;AACvD,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAAG,CAAC;AAErC,+DAA+D;AAC/D,MAAM,CAAC,MAAM,0BAA0B,GAAG,KAAK,CAAC;AAEhD,iCAAiC;AACjC,MAAM,CAAC,MAAM,mCAAmC,GAAG,EAAE,CAAC;AACtD,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,CAAC"}

package/dist/constants/paths.d.ts

@@ -0,0 +1,23 @@
+/** Default memory data root under ~/.pi/ (MEMORY.md, sidecar, vector DB). */
+export declare const PI_MEMORY_DATA_SUBDIR = "pi-memory-data";
+/** pi-memory config file under ~/.pi/agent/ (not a generic dotenv at ~/.pi root). */
+export declare const PI_MEMORY_ENV_FILE_NAME = "pi-memory.env";
+export declare const PI_LOGS_SUBDIR = "logs";
+/** Sidecar IPC + index files (under agent dir). */
+export declare const SIDECAR_SOCKET_FILE = "memory.sock";
+export declare const SIDECAR_DB_FILE = "memory.vec.sqlite";
+export declare const SIDECAR_PID_SUFFIX = ".pid";
+export declare const SIDECAR_SPAWN_LOCK_FILE = "sidecar.spawn.lock";
+/** Consolidate / maintenance scheduler log basenames (under ~/.pi/logs). */
+export declare const CONSOLIDATE_LOG_FILE = "maintenance.log";
+export declare const CONSOLIDATE_ERR_LOG_FILE = "maintenance.err.log";
+/** OS scheduler identifiers. */
+export declare const LAUNCHD_LABEL = "com.pi.memory.maintenance";
+export declare const SCHTASKS_TASK_NAME = "PiMemoryMaintenance";
+export declare const SCHEDULER_TEMPLATE_FILES: {
+    readonly launchd: "com.pi.memory.consolidate.plist.example";
+    readonly crontab: "crontab.example";
+    readonly windowsCmd: "consolidate.cmd.example";
+    readonly windowsSchtasks: "schtasks.example.txt";
+};
+//# sourceMappingURL=paths.d.ts.map

package/dist/constants/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/constants/paths.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,eAAO,MAAM,qBAAqB,mBAAmB,CAAC;AACtD,qFAAqF;AACrF,eAAO,MAAM,uBAAuB,kBAAkB,CAAC;AACvD,eAAO,MAAM,cAAc,SAAS,CAAC;AAErC,mDAAmD;AACnD,eAAO,MAAM,mBAAmB,gBAAgB,CAAC;AACjD,eAAO,MAAM,eAAe,sBAAsB,CAAC;AACnD,eAAO,MAAM,kBAAkB,SAAS,CAAC;AACzC,eAAO,MAAM,uBAAuB,uBAAuB,CAAC;AAE5D,4EAA4E;AAC5E,eAAO,MAAM,oBAAoB,oBAAoB,CAAC;AACtD,eAAO,MAAM,wBAAwB,wBAAwB,CAAC;AAE9D,gCAAgC;AAChC,eAAO,MAAM,aAAa,8BAA8B,CAAC;AACzD,eAAO,MAAM,kBAAkB,wBAAwB,CAAC;AAExD,eAAO,MAAM,wBAAwB;;;;;CAK3B,CAAC"}

package/dist/constants/paths.js

@@ -0,0 +1,23 @@
+/** Default memory data root under ~/.pi/ (MEMORY.md, sidecar, vector DB). */
+export const PI_MEMORY_DATA_SUBDIR = "pi-memory-data";
+/** pi-memory config file under ~/.pi/agent/ (not a generic dotenv at ~/.pi root). */
+export const PI_MEMORY_ENV_FILE_NAME = "pi-memory.env";
+export const PI_LOGS_SUBDIR = "logs";
+/** Sidecar IPC + index files (under agent dir). */
+export const SIDECAR_SOCKET_FILE = "memory.sock";
+export const SIDECAR_DB_FILE = "memory.vec.sqlite";
+export const SIDECAR_PID_SUFFIX = ".pid";
+export const SIDECAR_SPAWN_LOCK_FILE = "sidecar.spawn.lock";
+/** Consolidate / maintenance scheduler log basenames (under ~/.pi/logs). */
+export const CONSOLIDATE_LOG_FILE = "maintenance.log";
+export const CONSOLIDATE_ERR_LOG_FILE = "maintenance.err.log";
+/** OS scheduler identifiers. */
+export const LAUNCHD_LABEL = "com.pi.memory.maintenance";
+export const SCHTASKS_TASK_NAME = "PiMemoryMaintenance";
+export const SCHEDULER_TEMPLATE_FILES = {
+    launchd: "com.pi.memory.consolidate.plist.example",
+    crontab: "crontab.example",
+    windowsCmd: "consolidate.cmd.example",
+    windowsSchtasks: "schtasks.example.txt",
+};
+//# sourceMappingURL=paths.js.map

package/dist/constants/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/constants/paths.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,MAAM,CAAC,MAAM,qBAAqB,GAAG,gBAAgB,CAAC;AACtD,qFAAqF;AACrF,MAAM,CAAC,MAAM,uBAAuB,GAAG,eAAe,CAAC;AACvD,MAAM,CAAC,MAAM,cAAc,GAAG,MAAM,CAAC;AAErC,mDAAmD;AACnD,MAAM,CAAC,MAAM,mBAAmB,GAAG,aAAa,CAAC;AACjD,MAAM,CAAC,MAAM,eAAe,GAAG,mBAAmB,CAAC;AACnD,MAAM,CAAC,MAAM,kBAAkB,GAAG,MAAM,CAAC;AACzC,MAAM,CAAC,MAAM,uBAAuB,GAAG,oBAAoB,CAAC;AAE5D,4EAA4E;AAC5E,MAAM,CAAC,MAAM,oBAAoB,GAAG,iBAAiB,CAAC;AACtD,MAAM,CAAC,MAAM,wBAAwB,GAAG,qBAAqB,CAAC;AAE9D,gCAAgC;AAChC,MAAM,CAAC,MAAM,aAAa,GAAG,2BAA2B,CAAC;AACzD,MAAM,CAAC,MAAM,kBAAkB,GAAG,qBAAqB,CAAC;AAExD,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,OAAO,EAAE,yCAAyC;IAClD,OAAO,EAAE,iBAAiB;IAC1B,UAAU,EAAE,yBAAyB;IACrC,eAAe,EAAE,sBAAsB;CAC/B,CAAC"}

package/dist/constants/preflight.d.ts

@@ -0,0 +1,10 @@
+/** Injected private memory block size cap. */
+export declare const PRIVATE_MEMORY_BODY_BYTE_CAP: number;
+export declare const PRIVATE_MEMORY_TAG = "private_memory";
+export declare const PRIVATE_MEMORY_OPEN = "<private_memory>";
+export declare const PRIVATE_MEMORY_CLOSE = "</private_memory>";
+/** Regex gate: skip episodic preflight for short generic prompts. */
+export declare const MEMORY_CUE_RE: RegExp;
+export declare const PREFLIGHT_SKIP_MIN_LENGTH = 12;
+export declare const PREFLIGHT_EXTRACT_MIN_LENGTH = 24;
+//# sourceMappingURL=preflight.d.ts.map

package/dist/constants/preflight.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preflight.d.ts","sourceRoot":"","sources":["../../src/constants/preflight.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,eAAO,MAAM,4BAA4B,QAAW,CAAC;AAErD,eAAO,MAAM,kBAAkB,mBAAmB,CAAC;AACnD,eAAO,MAAM,mBAAmB,qBAA4B,CAAC;AAC7D,eAAO,MAAM,oBAAoB,sBAA6B,CAAC;AAE/D,qEAAqE;AACrE,eAAO,MAAM,aAAa,QACiF,CAAC;AAE5G,eAAO,MAAM,yBAAyB,KAAK,CAAC;AAC5C,eAAO,MAAM,4BAA4B,KAAK,CAAC"}

package/dist/constants/preflight.js

@@ -0,0 +1,10 @@
+/** Injected private memory block size cap. */
+export const PRIVATE_MEMORY_BODY_BYTE_CAP = 8 * 1024;
+export const PRIVATE_MEMORY_TAG = "private_memory";
+export const PRIVATE_MEMORY_OPEN = `<${PRIVATE_MEMORY_TAG}>`;
+export const PRIVATE_MEMORY_CLOSE = `</${PRIVATE_MEMORY_TAG}>`;
+/** Regex gate: skip episodic preflight for short generic prompts. */
+export const MEMORY_CUE_RE = /(?:\b(recent|recently|last time|continue|previous|remember|recall|before|earlier)\b|之前|上次|继续|记得|回忆|刚才)/i;
+export const PREFLIGHT_SKIP_MIN_LENGTH = 12;
+export const PREFLIGHT_EXTRACT_MIN_LENGTH = 24;
+//# sourceMappingURL=preflight.js.map

package/dist/constants/preflight.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preflight.js","sourceRoot":"","sources":["../../src/constants/preflight.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,GAAG,IAAI,CAAC;AAErD,MAAM,CAAC,MAAM,kBAAkB,GAAG,gBAAgB,CAAC;AACnD,MAAM,CAAC,MAAM,mBAAmB,GAAG,IAAI,kBAAkB,GAAG,CAAC;AAC7D,MAAM,CAAC,MAAM,oBAAoB,GAAG,KAAK,kBAAkB,GAAG,CAAC;AAE/D,qEAAqE;AACrE,MAAM,CAAC,MAAM,aAAa,GACxB,yGAAyG,CAAC;AAE5G,MAAM,CAAC,MAAM,yBAAyB,GAAG,EAAE,CAAC;AAC5C,MAAM,CAAC,MAAM,4BAA4B,GAAG,EAAE,CAAC"}

package/dist/constants/retrieval.d.ts

@@ -0,0 +1,10 @@
+export declare const DEFAULT_TOP_K = 3;
+export declare const CANDIDATE_POOL_MULTIPLIER = 3;
+export declare const MMR_LAMBDA = 0.8;
+/** Minimum cosine similarity (0–1) for a chunk to enter the candidate pool. */
+export declare const DEFAULT_MIN_RELEVANCE = 0.4;
+export declare const MIN_TOP_K = 1;
+export declare const MAX_TOP_K = 20;
+export declare const MIN_MMR_LAMBDA = 0;
+export declare const MAX_MMR_LAMBDA = 1;
+//# sourceMappingURL=retrieval.d.ts.map

package/dist/constants/retrieval.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retrieval.d.ts","sourceRoot":"","sources":["../../src/constants/retrieval.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,aAAa,IAAI,CAAC;AAC/B,eAAO,MAAM,yBAAyB,IAAI,CAAC;AAC3C,eAAO,MAAM,UAAU,MAAM,CAAC;AAC9B,+EAA+E;AAC/E,eAAO,MAAM,qBAAqB,MAAM,CAAC;AAEzC,eAAO,MAAM,SAAS,IAAI,CAAC;AAC3B,eAAO,MAAM,SAAS,KAAK,CAAC;AAC5B,eAAO,MAAM,cAAc,IAAI,CAAC;AAChC,eAAO,MAAM,cAAc,IAAI,CAAC"}

package/dist/constants/retrieval.js

@@ -0,0 +1,10 @@
+export const DEFAULT_TOP_K = 3;
+export const CANDIDATE_POOL_MULTIPLIER = 3;
+export const MMR_LAMBDA = 0.8;
+/** Minimum cosine similarity (0–1) for a chunk to enter the candidate pool. */
+export const DEFAULT_MIN_RELEVANCE = 0.4;
+export const MIN_TOP_K = 1;
+export const MAX_TOP_K = 20;
+export const MIN_MMR_LAMBDA = 0;
+export const MAX_MMR_LAMBDA = 1;
+//# sourceMappingURL=retrieval.js.map

package/dist/constants/retrieval.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retrieval.js","sourceRoot":"","sources":["../../src/constants/retrieval.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC;AAC/B,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC;AAC3C,MAAM,CAAC,MAAM,UAAU,GAAG,GAAG,CAAC;AAC9B,+EAA+E;AAC/E,MAAM,CAAC,MAAM,qBAAqB,GAAG,GAAG,CAAC;AAEzC,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,CAAC;AAC3B,MAAM,CAAC,MAAM,SAAS,GAAG,EAAE,CAAC;AAC5B,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC;AAChC,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC"}

package/dist/constants/security.d.ts

@@ -0,0 +1,5 @@
+/** Unix directory mode for agent / socket parent dirs (ignored on Windows). */
+export declare const SECURE_DIR_MODE = 448;
+/** Unix socket file mode (ignored on Windows). */
+export declare const SECURE_FILE_MODE = 384;
+//# sourceMappingURL=security.d.ts.map

package/dist/constants/security.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"security.d.ts","sourceRoot":"","sources":["../../src/constants/security.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,eAAO,MAAM,eAAe,MAAQ,CAAC;AAErC,kDAAkD;AAClD,eAAO,MAAM,gBAAgB,MAAQ,CAAC"}

package/dist/constants/security.js

@@ -0,0 +1,5 @@
+/** Unix directory mode for agent / socket parent dirs (ignored on Windows). */
+export const SECURE_DIR_MODE = 0o700;
+/** Unix socket file mode (ignored on Windows). */
+export const SECURE_FILE_MODE = 0o600;
+//# sourceMappingURL=security.js.map

package/dist/constants/security.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"security.js","sourceRoot":"","sources":["../../src/constants/security.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,MAAM,CAAC,MAAM,eAAe,GAAG,KAAK,CAAC;AAErC,kDAAkD;AAClD,MAAM,CAAC,MAAM,gBAAgB,GAAG,KAAK,CAAC"}

package/dist/constants/timing.d.ts

@@ -0,0 +1,36 @@
+export declare const MS_PER_DAY: number;
+/** HTTP / LLM adapters. */
+export declare const DEFAULT_HTTP_TIMEOUT_MS = 30000;
+export declare const DEFAULT_LLM_COMPAT_TIMEOUT_MS = 120000;
+/** Preflight episodic retrieval (shared deadline for intent + sidecar). */
+export declare const DEFAULT_PREFLIGHT_BUDGET_MS = 800;
+export declare const MIN_PREFLIGHT_BUDGET_MS = 250;
+export declare const MAX_PREFLIGHT_BUDGET_MS = 1500;
+/** Minimum time reserved for sidecar embed + scan after intent extraction. */
+export declare const MIN_PREFLIGHT_SIDECAR_RESERVE_MS = 200;
+/** @deprecated Use DEFAULT_PREFLIGHT_BUDGET_MS */
+export declare const DEFAULT_PREFLIGHT_TIMEOUT_MS = 800;
+/** Sidecar query cache (extension process). */
+export declare const QUERY_CACHE_MAX_ENTRIES = 500;
+/** Debounced sidecar reindex after MEMORY writes. */
+export declare const DEFAULT_REINDEX_DEBOUNCE_MS = 500;
+/** Debounced consolidate check after MEMORY writes. */
+export declare const DEFAULT_CONSOLIDATE_DEBOUNCE_MS = 2000;
+/** Session-alive periodic shouldConsolidate tick (7-day catch-up). */
+export declare const DEFAULT_CONSOLIDATE_CHECK_INTERVAL_MS: number;
+/** OS scheduler daily consolidate slot. */
+export declare const CONSOLIDATE_CRON_HOUR = 3;
+export declare const CONSOLIDATE_CRON_MINUTE = 0;
+/** Sidecar process lifecycle. */
+export declare const SIDECAR_START_TIMEOUT_MS = 5000;
+export declare const SIDECAR_SPAWN_LOCK_STALE_MS = 10000;
+export declare const SIDECAR_FORCE_KILL_DELAY_MS = 5000;
+/** Sidecar client RPC timeouts. */
+export declare const SIDECAR_PING_TIMEOUT_MS = 1000;
+export declare const SIDECAR_QUERY_TIMEOUT_MS = 3000;
+export declare const SIDECAR_REINDEX_TIMEOUT_MS = 10000;
+/** proper-lockfile on MEMORY.md. */
+export declare const MEMORY_LOCK_RETRIES = 5;
+export declare const MEMORY_LOCK_MIN_TIMEOUT_MS = 100;
+export declare const MEMORY_LOCK_MAX_TIMEOUT_MS = 500;
+//# sourceMappingURL=timing.d.ts.map

package/dist/constants/timing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timing.d.ts","sourceRoot":"","sources":["../../src/constants/timing.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,UAAU,QAAsB,CAAC;AAE9C,2BAA2B;AAC3B,eAAO,MAAM,uBAAuB,QAAS,CAAC;AAC9C,eAAO,MAAM,6BAA6B,SAAU,CAAC;AAErD,2EAA2E;AAC3E,eAAO,MAAM,2BAA2B,MAAM,CAAC;AAC/C,eAAO,MAAM,uBAAuB,MAAM,CAAC;AAC3C,eAAO,MAAM,uBAAuB,OAAQ,CAAC;AAC7C,8EAA8E;AAC9E,eAAO,MAAM,gCAAgC,MAAM,CAAC;AAEpD,kDAAkD;AAClD,eAAO,MAAM,4BAA4B,MAA8B,CAAC;AAExE,+CAA+C;AAC/C,eAAO,MAAM,uBAAuB,MAAM,CAAC;AAE3C,qDAAqD;AACrD,eAAO,MAAM,2BAA2B,MAAM,CAAC;AAE/C,uDAAuD;AACvD,eAAO,MAAM,+BAA+B,OAAQ,CAAC;AAErD,sEAAsE;AACtE,eAAO,MAAM,qCAAqC,QAAa,CAAC;AAEhE,2CAA2C;AAC3C,eAAO,MAAM,qBAAqB,IAAI,CAAC;AACvC,eAAO,MAAM,uBAAuB,IAAI,CAAC;AAEzC,iCAAiC;AACjC,eAAO,MAAM,wBAAwB,OAAQ,CAAC;AAC9C,eAAO,MAAM,2BAA2B,QAAS,CAAC;AAClD,eAAO,MAAM,2BAA2B,OAAQ,CAAC;AAEjD,mCAAmC;AACnC,eAAO,MAAM,uBAAuB,OAAQ,CAAC;AAC7C,eAAO,MAAM,wBAAwB,OAAQ,CAAC;AAC9C,eAAO,MAAM,0BAA0B,QAAS,CAAC;AAEjD,oCAAoC;AACpC,eAAO,MAAM,mBAAmB,IAAI,CAAC;AACrC,eAAO,MAAM,0BAA0B,MAAM,CAAC;AAC9C,eAAO,MAAM,0BAA0B,MAAM,CAAC"}

package/dist/constants/timing.js

@@ -0,0 +1,36 @@
+export const MS_PER_DAY = 24 * 60 * 60 * 1000;
+/** HTTP / LLM adapters. */
+export const DEFAULT_HTTP_TIMEOUT_MS = 30_000;
+export const DEFAULT_LLM_COMPAT_TIMEOUT_MS = 120_000;
+/** Preflight episodic retrieval (shared deadline for intent + sidecar). */
+export const DEFAULT_PREFLIGHT_BUDGET_MS = 800;
+export const MIN_PREFLIGHT_BUDGET_MS = 250;
+export const MAX_PREFLIGHT_BUDGET_MS = 1_500;
+/** Minimum time reserved for sidecar embed + scan after intent extraction. */
+export const MIN_PREFLIGHT_SIDECAR_RESERVE_MS = 200;
+/** @deprecated Use DEFAULT_PREFLIGHT_BUDGET_MS */
+export const DEFAULT_PREFLIGHT_TIMEOUT_MS = DEFAULT_PREFLIGHT_BUDGET_MS;
+/** Sidecar query cache (extension process). */
+export const QUERY_CACHE_MAX_ENTRIES = 500;
+/** Debounced sidecar reindex after MEMORY writes. */
+export const DEFAULT_REINDEX_DEBOUNCE_MS = 500;
+/** Debounced consolidate check after MEMORY writes. */
+export const DEFAULT_CONSOLIDATE_DEBOUNCE_MS = 2_000;
+/** Session-alive periodic shouldConsolidate tick (7-day catch-up). */
+export const DEFAULT_CONSOLIDATE_CHECK_INTERVAL_MS = MS_PER_DAY;
+/** OS scheduler daily consolidate slot. */
+export const CONSOLIDATE_CRON_HOUR = 3;
+export const CONSOLIDATE_CRON_MINUTE = 0;
+/** Sidecar process lifecycle. */
+export const SIDECAR_START_TIMEOUT_MS = 5_000;
+export const SIDECAR_SPAWN_LOCK_STALE_MS = 10_000;
+export const SIDECAR_FORCE_KILL_DELAY_MS = 5_000;
+/** Sidecar client RPC timeouts. */
+export const SIDECAR_PING_TIMEOUT_MS = 1_000;
+export const SIDECAR_QUERY_TIMEOUT_MS = 3_000;
+export const SIDECAR_REINDEX_TIMEOUT_MS = 10_000;
+/** proper-lockfile on MEMORY.md. */
+export const MEMORY_LOCK_RETRIES = 5;
+export const MEMORY_LOCK_MIN_TIMEOUT_MS = 100;
+export const MEMORY_LOCK_MAX_TIMEOUT_MS = 500;
+//# sourceMappingURL=timing.js.map

package/dist/constants/timing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timing.js","sourceRoot":"","sources":["../../src/constants/timing.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,UAAU,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AAE9C,2BAA2B;AAC3B,MAAM,CAAC,MAAM,uBAAuB,GAAG,MAAM,CAAC;AAC9C,MAAM,CAAC,MAAM,6BAA6B,GAAG,OAAO,CAAC;AAErD,2EAA2E;AAC3E,MAAM,CAAC,MAAM,2BAA2B,GAAG,GAAG,CAAC;AAC/C,MAAM,CAAC,MAAM,uBAAuB,GAAG,GAAG,CAAC;AAC3C,MAAM,CAAC,MAAM,uBAAuB,GAAG,KAAK,CAAC;AAC7C,8EAA8E;AAC9E,MAAM,CAAC,MAAM,gCAAgC,GAAG,GAAG,CAAC;AAEpD,kDAAkD;AAClD,MAAM,CAAC,MAAM,4BAA4B,GAAG,2BAA2B,CAAC;AAExE,+CAA+C;AAC/C,MAAM,CAAC,MAAM,uBAAuB,GAAG,GAAG,CAAC;AAE3C,qDAAqD;AACrD,MAAM,CAAC,MAAM,2BAA2B,GAAG,GAAG,CAAC;AAE/C,uDAAuD;AACvD,MAAM,CAAC,MAAM,+BAA+B,GAAG,KAAK,CAAC;AAErD,sEAAsE;AACtE,MAAM,CAAC,MAAM,qCAAqC,GAAG,UAAU,CAAC;AAEhE,2CAA2C;AAC3C,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC;AACvC,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC;AAEzC,iCAAiC;AACjC,MAAM,CAAC,MAAM,wBAAwB,GAAG,KAAK,CAAC;AAC9C,MAAM,CAAC,MAAM,2BAA2B,GAAG,MAAM,CAAC;AAClD,MAAM,CAAC,MAAM,2BAA2B,GAAG,KAAK,CAAC;AAEjD,mCAAmC;AACnC,MAAM,CAAC,MAAM,uBAAuB,GAAG,KAAK,CAAC;AAC7C,MAAM,CAAC,MAAM,wBAAwB,GAAG,KAAK,CAAC;AAC9C,MAAM,CAAC,MAAM,0BAA0B,GAAG,MAAM,CAAC;AAEjD,oCAAoC;AACpC,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC;AACrC,MAAM,CAAC,MAAM,0BAA0B,GAAG,GAAG,CAAC;AAC9C,MAAM,CAAC,MAAM,0BAA0B,GAAG,GAAG,CAAC"}

package/dist/index.d.ts

@@ -1,29 +1,12 @@
-export type { ErrorObject, FallbackQuery, HealthPayload, HopRecord, MemoryBlock, MemoryCandidateGroup, MemoryQuerier, MemoryRecallArgs, QueryCandidate, QueryIntent, QueryMode, QueryRequest, ReloadResponse, ResponseEnvelope, ServiceStatus, ToolResult, Warning, } from "./types.js";
-export { defaultMemoryConfig, normalizeMemoryConfig, type MemoryConfig, type MemoryProvider, } from "./config.js";
-export { defaultMemoryConfigPath, loadMemoryConfig, loadMemorySettings, resolveHelperModelSpec, type LoadedMemorySettings, type MemorySettingsFile, } from "./settings.js";
-export { defaultBundleRoot, defaultPiHome, defaultSessionsDir, defaultSocketPath, expandPath, } from "./paths.js";
-export { classifyHTTP, classifyTransportError, ErrTransport, type ErrorClass, } from "./errclass.js";
-export { SidecarClient } from "./sidecar/client.js";
-export { currentBundleReadable, readCurrentManifest, type BundleManifest, } from "./sidecar/bundle.js";
-export { installBundle, retainBundles, validateManifestPath, versionInRange, type InstallBundleOptions, type InstallBundleResult, } from "./bundle/install.js";
-export { createFallbackQuery, memoryMdSnippet, sessionKeywordSearch, type FallbackOptions, type SessionSearchHit, } from "./fallback/index.js";
-export { SidecarProcess } from "./sidecar/process.js";
-export { MemoryService, type MemoryServiceStatus, type QueryBatchResult, } from "./service.js";
-export { COMPILE_MEMORY_INTENTS_PARAMETERS, MEMORY_HELPER_TOOL_NAME, cleanMemoryAnchor, defaultDirectMemoryIntent, detectExactMemoryIntents, detectMemoryIntents, looksLikeTaskText, looksMemoryRelevant, sanitizeMemoryIntents, type CompileMemoryIntentsResult, type DetectIntentsOptions, type MemoryHelperLLM, } from "./preflight/detectIntents.js";
-export { PRIVATE_MEMORY_BODY_BYTE_CAP, renderFallbackPrivateMemory, renderPrivateMemoryContext, sanitizeUserBlock, truncatePrivateMemoryBody, type PreflightQueryResult, } from "./preflight/render.js";
-export { injectPrivateMemoryContext, stripPrivateMemory, } from "./preflight/strip.js";
-export { MEMORY_PREFLIGHT_QUERY_TIMEOUT_MS, createBeforeTurnHook, runMemoryPreflight, type BeforeTurnHook, type BeforeTurnInput, type MemoryPreflightOptions, type MemoryPreflightResult, } from "./preflight/hook.js";
-export { createMemoryRecallTool, createStubFallback, MemoryRecallTool, MEMORY_RECALL_DESCRIPTION, MEMORY_RECALL_NAME, MEMORY_RECALL_PARAMETERS, } from "./tools/memoryRecall.js";
-export { appendToMemoryMd, createMemoryAppendTool, MemoryAppendTool, MEMORY_APPEND_DESCRIPTION, MEMORY_APPEND_NAME, MEMORY_APPEND_PARAMETERS, } from "./tools/memoryAppend.js";
-export { default as piMemoryExtension, getSharedMemoryService, type PiAgentTool, type PiExtensionAPI, } from "./extension.js";
-export { createMemoryHelperLLM, createPiLLMClient, createStandaloneLLMClient, DEFAULT_HELPER_MODEL, DEFAULT_HELPER_PROVIDER, parseModelSpec, resolveMemoryHelperLLM, } from "./adapters/piComplete.js";
-export { trainBundle, loadSessions, extractFacts, extractFactsFromSessions, resolveEntities, buildBundle, readMarker, writeMarker, loadExistingBundle, deltaMerge, RELATION_CATALOG, ALL_RELATIONS, type TrainBundleConfig, type TrainBundleResult, type LoadedSession, type SessionTurn, type SessionLoaderOptions, type ExtractedEntity, type ExtractedRelation, type ExtractedEvent, type ExtractionResult, type EntityType, type LLMFactExtractor, type ExtractFactsOptions, type ResolvedEntity, type ResolvedRelation, type ResolvedGraph, type BundleData, type BuildBundleOptions, type BuildBundleResult, type ExistingBundle, type DeltaOp, type DeltaLogEntry, type DeltaLog, type MergeResult, } from "./trainer/index.js";
-export { createLLMFactExtractor, type LLMClient, type LLMExtractorOptions, } from "./trainer/llmExtractor.js";
-export { createTrainScheduler, parseInterval, type SchedulerConfig, type TrainScheduler, type SchedulerLog, type SchedulerLogger, } from "./trainer/scheduler.js";
-export { openSessionIndex, type SessionIndex, type SqliteDatabase, } from "./fallback/sessionIndex.js";
-export { defaultSessionDbPath } from "./fallback/sessionSearch.js";
-export { LocalGraphQuerier } from "./local/graphQuery.js";
-export { createOllamaLLMClient, createOllamaMemoryHelper, ollamaHealthCheck, DEFAULT_OLLAMA_CONFIG, type OllamaConfig, } from "./adapters/ollamaClient.js";
-export { createOpenAICompatLLMClient, createOpenAICompatMemoryHelper, openaiCompatHealthCheck, type OpenAICompatConfig, } from "./adapters/openaiCompatClient.js";
-export { rerankWithLLM, type RerankOptions, type RankedResult, } from "./fallback/llmRerank.js";
+export { initializeMemoryWorkspace, type InitMemoryWorkspaceResult } from "./init/workspace.js";
+export { loadEnv } from "./config/loadEnv.js";
+export { resolveAgentDirFromEnv, resolveMemoryAgentDir, type ResolveMemoryAgentDirOptions } from "./config/agentDir.js";
+export { readPiMemoryEnv, resolveEmbedDim, type PiMemoryEnv } from "./config/env.js";
+export { runConsolidateJob, type RunConsolidateJobResult } from "./consolidate/runJob.js";
+export * from "./constants/index.js";
+export * from "./utils/index.js";
+export { MemoryStore } from "./store/memoryStore.js";
+export { ensureSidecarRunning, stopSidecar } from "./sidecar/sidecarManager.js";
+export { query, reindex, ping } from "./sidecar/client.js";
+export { createLlmClient, type LlmClient } from "./adapters/llm/index.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,KAAK,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AAChG,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9C,OAAO,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,KAAK,4BAA4B,EAAE,MAAM,sBAAsB,CAAC;AACxH,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,KAAK,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACrF,OAAO,EAAE,iBAAiB,EAAE,KAAK,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAC1F,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC;AACjC,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,oBAAoB,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAChF,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,KAAK,SAAS,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/index.js

@@ -1,28 +1,12 @@
-export { defaultMemoryConfig, normalizeMemoryConfig, } from "./config.js";
-export { defaultMemoryConfigPath, loadMemoryConfig, loadMemorySettings, resolveHelperModelSpec, } from "./settings.js";
-export { defaultBundleRoot, defaultPiHome, defaultSessionsDir, defaultSocketPath, expandPath, } from "./paths.js";
-export { classifyHTTP, classifyTransportError, ErrTransport, } from "./errclass.js";
-export { SidecarClient } from "./sidecar/client.js";
-export { currentBundleReadable, readCurrentManifest, } from "./sidecar/bundle.js";
-export { installBundle, retainBundles, validateManifestPath, versionInRange, } from "./bundle/install.js";
-export { createFallbackQuery, memoryMdSnippet, sessionKeywordSearch, } from "./fallback/index.js";
-export { SidecarProcess } from "./sidecar/process.js";
-export { MemoryService, } from "./service.js";
-export { COMPILE_MEMORY_INTENTS_PARAMETERS, MEMORY_HELPER_TOOL_NAME, cleanMemoryAnchor, defaultDirectMemoryIntent, detectExactMemoryIntents, detectMemoryIntents, looksLikeTaskText, looksMemoryRelevant, sanitizeMemoryIntents, } from "./preflight/detectIntents.js";
-export { PRIVATE_MEMORY_BODY_BYTE_CAP, renderFallbackPrivateMemory, renderPrivateMemoryContext, sanitizeUserBlock, truncatePrivateMemoryBody, } from "./preflight/render.js";
-export { injectPrivateMemoryContext, stripPrivateMemory, } from "./preflight/strip.js";
-export { MEMORY_PREFLIGHT_QUERY_TIMEOUT_MS, createBeforeTurnHook, runMemoryPreflight, } from "./preflight/hook.js";
-export { createMemoryRecallTool, createStubFallback, MemoryRecallTool, MEMORY_RECALL_DESCRIPTION, MEMORY_RECALL_NAME, MEMORY_RECALL_PARAMETERS, } from "./tools/memoryRecall.js";
-export { appendToMemoryMd, createMemoryAppendTool, MemoryAppendTool, MEMORY_APPEND_DESCRIPTION, MEMORY_APPEND_NAME, MEMORY_APPEND_PARAMETERS, } from "./tools/memoryAppend.js";
-export { default as piMemoryExtension, getSharedMemoryService, } from "./extension.js";
-export { createMemoryHelperLLM, createPiLLMClient, createStandaloneLLMClient, DEFAULT_HELPER_MODEL, DEFAULT_HELPER_PROVIDER, parseModelSpec, resolveMemoryHelperLLM, } from "./adapters/piComplete.js";
-export { trainBundle, loadSessions, extractFacts, extractFactsFromSessions, resolveEntities, buildBundle, readMarker, writeMarker, loadExistingBundle, deltaMerge, RELATION_CATALOG, ALL_RELATIONS, } from "./trainer/index.js";
-export { createLLMFactExtractor, } from "./trainer/llmExtractor.js";
-export { createTrainScheduler, parseInterval, } from "./trainer/scheduler.js";
-export { openSessionIndex, } from "./fallback/sessionIndex.js";
-export { defaultSessionDbPath } from "./fallback/sessionSearch.js";
-export { LocalGraphQuerier } from "./local/graphQuery.js";
-export { createOllamaLLMClient, createOllamaMemoryHelper, ollamaHealthCheck, DEFAULT_OLLAMA_CONFIG, } from "./adapters/ollamaClient.js";
-export { createOpenAICompatLLMClient, createOpenAICompatMemoryHelper, openaiCompatHealthCheck, } from "./adapters/openaiCompatClient.js";
-export { rerankWithLLM, } from "./fallback/llmRerank.js";
+export { initializeMemoryWorkspace } from "./init/workspace.js";
+export { loadEnv } from "./config/loadEnv.js";
+export { resolveAgentDirFromEnv, resolveMemoryAgentDir } from "./config/agentDir.js";
+export { readPiMemoryEnv, resolveEmbedDim } from "./config/env.js";
+export { runConsolidateJob } from "./consolidate/runJob.js";
+export * from "./constants/index.js";
+export * from "./utils/index.js";
+export { MemoryStore } from "./store/memoryStore.js";
+export { ensureSidecarRunning, stopSidecar } from "./sidecar/sidecarManager.js";
+export { query, reindex, ping } from "./sidecar/client.js";
+export { createLlmClient } from "./adapters/llm/index.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAkC,MAAM,qBAAqB,CAAC;AAChG,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9C,OAAO,EAAE,sBAAsB,EAAE,qBAAqB,EAAqC,MAAM,sBAAsB,CAAC;AACxH,OAAO,EAAE,eAAe,EAAE,eAAe,EAAoB,MAAM,iBAAiB,CAAC;AACrF,OAAO,EAAE,iBAAiB,EAAgC,MAAM,yBAAyB,CAAC;AAC1F,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC;AACjC,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,oBAAoB,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAChF,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAkB,MAAM,yBAAyB,CAAC"}

package/dist/init/workspace.d.ts

@@ -0,0 +1,15 @@
+export type InitMemoryWorkspaceResult = {
+    agentDir: string;
+    memoryFile: string;
+    created: boolean;
+    skipped: boolean;
+    reason?: "already_initialized";
+};
+/**
+ * Ensure the memory data directory exists and MEMORY.md follows the canonical template.
+ * Never overwrites a non-empty MEMORY.md.
+ */
+export declare function initializeMemoryWorkspace(agentDir: string): Promise<InitMemoryWorkspaceResult>;
+/** Read bundled template from templates/MEMORY.md.example (postinstall / docs). */
+export declare function readMemoryTemplateExample(packageRoot: string): Promise<string>;
+//# sourceMappingURL=workspace.d.ts.map

package/dist/init/workspace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace.d.ts","sourceRoot":"","sources":["../../src/init/workspace.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,yBAAyB,GAAG;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,qBAAqB,CAAC;CAChC,CAAC;AAEF;;;GAGG;AACH,wBAAsB,yBAAyB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,yBAAyB,CAAC,CAoBpG;AAED,mFAAmF;AACnF,wBAAsB,yBAAyB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAEpF"}

package/dist/init/workspace.js

@@ -0,0 +1,32 @@
+import { DEFAULT_MEMORY_FILE } from "../constants/memory.js";
+import { MarkdownMemoryBackend } from "../store/backend.js";
+import { defaultMemoryTemplate } from "../store/markdown/template.js";
+import { resolveAgentDir } from "../store/paths.js";
+import { joinPath, readText } from "../utils/fs.js";
+/**
+ * Ensure the memory data directory exists and MEMORY.md follows the canonical template.
+ * Never overwrites a non-empty MEMORY.md.
+ */
+export async function initializeMemoryWorkspace(agentDir) {
+    const resolved = resolveAgentDir(agentDir);
+    const memoryFile = joinPath(resolved, DEFAULT_MEMORY_FILE);
+    const backend = new MarkdownMemoryBackend(memoryFile);
+    await backend.ensureAgentDir();
+    const existing = await backend.readText(memoryFile);
+    if (existing.trim()) {
+        return {
+            agentDir: resolved,
+            memoryFile,
+            created: false,
+            skipped: true,
+            reason: "already_initialized",
+        };
+    }
+    await backend.writeText(memoryFile, defaultMemoryTemplate());
+    return { agentDir: resolved, memoryFile, created: true, skipped: false };
+}
+/** Read bundled template from templates/MEMORY.md.example (postinstall / docs). */
+export async function readMemoryTemplateExample(packageRoot) {
+    return readText(joinPath(packageRoot, "templates", "MEMORY.md.example"));
+}
+//# sourceMappingURL=workspace.js.map

package/dist/init/workspace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace.js","sourceRoot":"","sources":["../../src/init/workspace.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAUpD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAAC,QAAgB;IAC9D,MAAM,QAAQ,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC;IAC3C,MAAM,UAAU,GAAG,QAAQ,CAAC,QAAQ,EAAE,mBAAmB,CAAC,CAAC;IAC3D,MAAM,OAAO,GAAG,IAAI,qBAAqB,CAAC,UAAU,CAAC,CAAC;IAEtD,MAAM,OAAO,CAAC,cAAc,EAAE,CAAC;IAE/B,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;IACpD,IAAI,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC;QACpB,OAAO;YACL,QAAQ,EAAE,QAAQ;YAClB,UAAU;YACV,OAAO,EAAE,KAAK;YACd,OAAO,EAAE,IAAI;YACb,MAAM,EAAE,qBAAqB;SAC9B,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,CAAC,SAAS,CAAC,UAAU,EAAE,qBAAqB,EAAE,CAAC,CAAC;IAC7D,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;AAC3E,CAAC;AAED,mFAAmF;AACnF,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAAC,WAAmB;IACjE,OAAO,QAAQ,CAAC,QAAQ,CAAC,WAAW,EAAE,WAAW,EAAE,mBAAmB,CAAC,CAAC,CAAC;AAC3E,CAAC"}

package/dist/ipc/jsonlFramer.d.ts

@@ -0,0 +1,9 @@
+/** Incremental JSONL (one JSON object per line) framing for UDS IPC. */
+export declare class JsonlFramer {
+    private buffer;
+    push(chunk: string): string[];
+    reset(): void;
+}
+export declare function serializeJsonlFrame(value: unknown): string;
+export declare function parseJsonlLine<T>(line: string): T;
+//# sourceMappingURL=jsonlFramer.d.ts.map

package/dist/ipc/jsonlFramer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonlFramer.d.ts","sourceRoot":"","sources":["../../src/ipc/jsonlFramer.ts"],"names":[],"mappings":"AAAA,wEAAwE;AAExE,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAM;IAEpB,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE;IAY7B,KAAK,IAAI,IAAI;CAGd;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAE1D;AAED,wBAAgB,cAAc,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,CAEjD"}

package/dist/ipc/jsonlFramer.js

@@ -0,0 +1,26 @@
+/** Incremental JSONL (one JSON object per line) framing for UDS IPC. */
+export class JsonlFramer {
+    buffer = "";
+    push(chunk) {
+        this.buffer += chunk;
+        const lines = [];
+        let idx;
+        while ((idx = this.buffer.indexOf("\n")) !== -1) {
+            const line = this.buffer.slice(0, idx);
+            this.buffer = this.buffer.slice(idx + 1);
+            if (line.trim())
+                lines.push(line);
+        }
+        return lines;
+    }
+    reset() {
+        this.buffer = "";
+    }
+}
+export function serializeJsonlFrame(value) {
+    return `${JSON.stringify(value)}\n`;
+}
+export function parseJsonlLine(line) {
+    return JSON.parse(line);
+}
+//# sourceMappingURL=jsonlFramer.js.map

package/dist/ipc/jsonlFramer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonlFramer.js","sourceRoot":"","sources":["../../src/ipc/jsonlFramer.ts"],"names":[],"mappings":"AAAA,wEAAwE;AAExE,MAAM,OAAO,WAAW;IACd,MAAM,GAAG,EAAE,CAAC;IAEpB,IAAI,CAAC,KAAa;QAChB,IAAI,CAAC,MAAM,IAAI,KAAK,CAAC;QACrB,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,IAAI,GAAW,CAAC;QAChB,OAAO,CAAC,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;YAChD,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;YACvC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC;YACzC,IAAI,IAAI,CAAC,IAAI,EAAE;gBAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACpC,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,KAAK;QACH,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC;IACnB,CAAC;CACF;AAED,MAAM,UAAU,mBAAmB,CAAC,KAAc;IAChD,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,cAAc,CAAI,IAAY;IAC5C,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAM,CAAC;AAC/B,CAAC"}

package/dist/pi-extension.d.ts

@@ -1,6 +1,4 @@
 import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
-import { MemoryService } from "./service.js";
-export declare function getSharedMemoryService(): MemoryService | null;
 export default function piMemoryExtension(pi: ExtensionAPI): void;
 export { piMemoryExtension };
 //# sourceMappingURL=pi-extension.d.ts.map

package/dist/pi-extension.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pi-extension.d.ts","sourceRoot":"","sources":["../src/pi-extension.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAoB,MAAM,iCAAiC,CAAC;AAgCtF,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AA+C7C,wBAAgB,sBAAsB,IAAI,aAAa,GAAG,IAAI,CAE7D;AA6ED,MAAM,CAAC,OAAO,UAAU,iBAAiB,CAAC,EAAE,EAAE,YAAY,GAAG,IAAI,CA4KhE;AAED,OAAO,EAAE,iBAAiB,EAAE,CAAC"}
+{"version":3,"file":"pi-extension.d.ts","sourceRoot":"","sources":["../src/pi-extension.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAoB,MAAM,iCAAiC,CAAC;AA8GtF,MAAM,CAAC,OAAO,UAAU,iBAAiB,CAAC,EAAE,EAAE,YAAY,GAAG,IAAI,CAgKhE;AAED,OAAO,EAAE,iBAAiB,EAAE,CAAC"}