@chendpoc/pi-memory 0.1.13 → 0.2.0

package/dist/utils/debugLog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"debugLog.js","sourceRoot":"","sources":["../../src/utils/debugLog.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAExC,MAAM,UAAU,oBAAoB,CAAC,MAAyB,OAAO,CAAC,GAAG;IACvE,OAAO,GAAG,CAAC,eAAe,KAAK,GAAG,IAAI,GAAG,CAAC,eAAe,KAAK,MAAM,CAAC;AACvE,CAAC;AAED,8DAA8D;AAC9D,MAAM,UAAU,WAAW,CACzB,KAAa,EACb,OAAe,EACf,MAAqE,EACrE,MAAyB,OAAO,CAAC,GAAG;IAEpC,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC;QAAE,OAAO;IAEvC,MAAM,MAAM,GACV,MAAM,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,GAAG,CAAC;QACtC,CAAC,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE;QACrF,CAAC,CAAC,EAAE,CAAC;IAET,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,KAAK,KAAK,OAAO,GAAG,MAAM,EAAE,CAAC,CAAC,CAAC;AAC7D,CAAC"}

package/dist/utils/fs.d.ts

@@ -0,0 +1,26 @@
+/** Cross-platform path join (`\` on Windows, `/` on POSIX). */
+export declare function joinPath(...segments: string[]): string;
+export declare function pathBasename(filePath: string): string;
+export declare function pathDirname(filePath: string): string;
+export declare function pathExists(filePath: string): boolean;
+/** True when the current process can read the path. */
+export declare function canRead(filePath: string): boolean;
+export declare function isENOENT(error: unknown): boolean;
+/** Create directory tree; Unix applies secure mode, Windows omits mode. */
+export declare function ensureDir(dirPath: string): Promise<void>;
+export declare function ensureDirSync(dirPath: string): void;
+/** Read UTF-8 text; missing file → empty string. */
+export declare function readText(filePath: string): Promise<string>;
+/** Read UTF-8 text; propagates ENOENT. */
+export declare function readTextRequired(filePath: string): Promise<string>;
+/** Write UTF-8 text; creates parent directories. */
+export declare function writeText(filePath: string, content: string): Promise<void>;
+/** Append UTF-8 text; creates parent directories. */
+export declare function appendText(filePath: string, content: string): Promise<void>;
+/** List directory entries; missing dir → empty array. */
+export declare function listDir(dirPath: string): Promise<string[]>;
+/** Delete file; missing file → no-op. */
+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.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.d.ts","sourceRoot":"","sources":["../../src/utils/fs.ts"],"names":[],"mappings":"AAcA,+DAA+D;AAC/D,wBAAgB,QAAQ,CAAC,GAAG,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,CAEtD;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAErD;AAED,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEpD;AAED,uDAAuD;AACvD,wBAAgB,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAOjD;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAEhD;AAED,2EAA2E;AAC3E,wBAAsB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE9D;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAEnD;AAED,oDAAoD;AACpD,wBAAsB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAOhE;AAED,0CAA0C;AAC1C,wBAAsB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAExE;AAED,oDAAoD;AACpD,wBAAsB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAIhF;AAED,qDAAqD;AACrD,wBAAsB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAIjF;AAED,yDAAyD;AACzD,wBAAsB,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAOhE;AAED,yCAAyC;AACzC,wBAAsB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAOhE;AAED,uDAAuD;AACvD,wBAAsB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAUhE"}

package/dist/utils/fs.js

@@ -0,0 +1,101 @@
+/** Runtime fs helpers. Pre-build postinstall mirror: scripts/platform-fs.mjs */
+import { accessSync, existsSync, mkdirSync, constants } from "node:fs";
+import { appendFile, mkdir, readFile, readdir, unlink, writeFile, } from "node:fs/promises";
+import { basename, dirname, join } from "node:path";
+import { expandHomePath, mkdirOptions } from "./paths.js";
+/** Cross-platform path join (`\` on Windows, `/` on POSIX). */
+export function joinPath(...segments) {
+    return join(...segments);
+}
+export function pathBasename(filePath) {
+    return basename(filePath);
+}
+export function pathDirname(filePath) {
+    return dirname(filePath);
+}
+export function pathExists(filePath) {
+    return existsSync(expandHomePath(filePath));
+}
+/** True when the current process can read the path. */
+export function canRead(filePath) {
+    try {
+        accessSync(expandHomePath(filePath), constants.R_OK);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export function isENOENT(error) {
+    return error?.code === "ENOENT";
+}
+/** Create directory tree; Unix applies secure mode, Windows omits mode. */
+export async function ensureDir(dirPath) {
+    await mkdir(expandHomePath(dirPath), mkdirOptions());
+}
+export function ensureDirSync(dirPath) {
+    mkdirSync(expandHomePath(dirPath), mkdirOptions());
+}
+/** Read UTF-8 text; missing file → empty string. */
+export async function readText(filePath) {
+    try {
+        return await readFile(expandHomePath(filePath), "utf8");
+    }
+    catch (error) {
+        if (isENOENT(error))
+            return "";
+        throw error;
+    }
+}
+/** Read UTF-8 text; propagates ENOENT. */
+export async function readTextRequired(filePath) {
+    return readFile(expandHomePath(filePath), "utf8");
+}
+/** Write UTF-8 text; creates parent directories. */
+export async function writeText(filePath, content) {
+    const resolved = expandHomePath(filePath);
+    await ensureDir(dirname(resolved));
+    await writeFile(resolved, content, "utf8");
+}
+/** Append UTF-8 text; creates parent directories. */
+export async function appendText(filePath, content) {
+    const resolved = expandHomePath(filePath);
+    await ensureDir(dirname(resolved));
+    await appendFile(resolved, content, "utf8");
+}
+/** List directory entries; missing dir → empty array. */
+export async function listDir(dirPath) {
+    try {
+        return await readdir(expandHomePath(dirPath));
+    }
+    catch (error) {
+        if (isENOENT(error))
+            return [];
+        throw error;
+    }
+}
+/** Delete file; missing file → no-op. */
+export async function removeFile(filePath) {
+    try {
+        await unlink(expandHomePath(filePath));
+    }
+    catch (error) {
+        if (isENOENT(error))
+            return;
+        throw error;
+    }
+}
+/** Ensure file exists (empty) for lockfile targets. */
+export async function ensureFile(filePath) {
+    try {
+        await readTextRequired(filePath);
+    }
+    catch (error) {
+        if (isENOENT(error)) {
+            await writeText(filePath, "");
+            return;
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=fs.js.map

package/dist/utils/fs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.js","sourceRoot":"","sources":["../../src/utils/fs.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACvE,OAAO,EACL,UAAU,EACV,KAAK,EACL,QAAQ,EACR,OAAO,EACP,MAAM,EACN,SAAS,GACV,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEpD,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1D,+DAA+D;AAC/D,MAAM,UAAU,QAAQ,CAAC,GAAG,QAAkB;IAC5C,OAAO,IAAI,CAAC,GAAG,QAAQ,CAAC,CAAC;AAC3B,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,QAAgB;IAC3C,OAAO,QAAQ,CAAC,QAAQ,CAAC,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,QAAgB;IAC1C,OAAO,OAAO,CAAC,QAAQ,CAAC,CAAC;AAC3B,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,QAAgB;IACzC,OAAO,UAAU,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAC;AAC9C,CAAC;AAED,uDAAuD;AACvD,MAAM,UAAU,OAAO,CAAC,QAAgB;IACtC,IAAI,CAAC;QACH,UAAU,CAAC,cAAc,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC;QACrD,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,KAAc;IACrC,OAAQ,KAA+B,EAAE,IAAI,KAAK,QAAQ,CAAC;AAC7D,CAAC;AAED,2EAA2E;AAC3E,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,OAAe;IAC7C,MAAM,KAAK,CAAC,cAAc,CAAC,OAAO,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC;AACvD,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,OAAe;IAC3C,SAAS,CAAC,cAAc,CAAC,OAAO,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC;AACrD,CAAC;AAED,oDAAoD;AACpD,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,QAAgB;IAC7C,IAAI,CAAC;QACH,OAAO,MAAM,QAAQ,CAAC,cAAc,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,CAAC;IAC1D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,QAAQ,CAAC,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QAC/B,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,0CAA0C;AAC1C,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,QAAgB;IACrD,OAAO,QAAQ,CAAC,cAAc,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,CAAC;AACpD,CAAC;AAED,oDAAoD;AACpD,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,QAAgB,EAAE,OAAe;IAC/D,MAAM,QAAQ,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC;IAC1C,MAAM,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;IACnC,MAAM,SAAS,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;AAC7C,CAAC;AAED,qDAAqD;AACrD,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,QAAgB,EAAE,OAAe;IAChE,MAAM,QAAQ,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC;IAC1C,MAAM,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;IACnC,MAAM,UAAU,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;AAC9C,CAAC;AAED,yDAAyD;AACzD,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,OAAe;IAC3C,IAAI,CAAC;QACH,OAAO,MAAM,OAAO,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC;IAChD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,QAAQ,CAAC,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QAC/B,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,yCAAyC;AACzC,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,QAAgB;IAC/C,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAC;IACzC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,QAAQ,CAAC,KAAK,CAAC;YAAE,OAAO;QAC5B,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,uDAAuD;AACvD,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,QAAgB;IAC/C,IAAI,CAAC;QACH,MAAM,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IACnC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YACpB,MAAM,SAAS,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;YAC9B,OAAO;QACT,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/utils/index.d.ts

@@ -0,0 +1,8 @@
+export { getPlatform, isMacOS, isUnixLike, isWindows, type PiMemoryPlatform, } from "./platform.js";
+export { CONFIG_DIR_NAME, defaultMemoryAgentDir, defaultPiConfigDir, defaultPiMemoryEnvFile, defaultPiLogsDir, expandHomePath, getAgentDir, mkdirOptions, secureDirMode, secureFileMode, } from "./paths.js";
+export { appendText, canRead, ensureDir, ensureDirSync, ensureFile, isENOENT, joinPath, listDir, pathBasename, pathDirname, pathExists, readText, readTextRequired, removeFile, writeText, } from "./fs.js";
+export { cleanupSocketFiles, removeSocketFile, secureSocketPath } from "./socket.js";
+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.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EACX,OAAO,EACP,UAAU,EACV,SAAS,EACT,KAAK,gBAAgB,GACtB,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,eAAe,EACf,qBAAqB,EACrB,kBAAkB,EAClB,sBAAsB,EACtB,gBAAgB,EAChB,cAAc,EACd,WAAW,EACX,YAAY,EACZ,aAAa,EACb,cAAc,GACf,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,UAAU,EACV,OAAO,EACP,SAAS,EACT,aAAa,EACb,UAAU,EACV,QAAQ,EACR,QAAQ,EACR,OAAO,EACP,YAAY,EACZ,WAAW,EACX,UAAU,EACV,QAAQ,EACR,gBAAgB,EAChB,UAAU,EACV,SAAS,GACV,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAErF,OAAO,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAElE,OAAO,EACL,SAAS,EACT,cAAc,EACd,eAAe,EACf,eAAe,EACf,GAAG,EACH,KAAK,EACL,SAAS,EACT,WAAW,EACX,KAAK,SAAS,GACf,MAAM,WAAW,CAAC;AAEnB,OAAO,EACL,uBAAuB,EACvB,uBAAuB,EACvB,gCAAgC,EAChC,yBAAyB,EACzB,yBAAyB,EACzB,2BAA2B,EAC3B,2BAA2B,EAC3B,KAAK,wBAAwB,EAC7B,KAAK,wBAAwB,EAC7B,KAAK,yBAAyB,EAC9B,KAAK,uBAAuB,GAC7B,MAAM,gBAAgB,CAAC"}

package/dist/utils/index.js

@@ -0,0 +1,8 @@
+export { getPlatform, isMacOS, isUnixLike, isWindows, } from "./platform.js";
+export { CONFIG_DIR_NAME, defaultMemoryAgentDir, defaultPiConfigDir, defaultPiMemoryEnvFile, defaultPiLogsDir, expandHomePath, getAgentDir, mkdirOptions, secureDirMode, secureFileMode, } from "./paths.js";
+export { appendText, canRead, ensureDir, ensureDirSync, ensureFile, isENOENT, joinPath, listDir, pathBasename, pathDirname, pathExists, readText, readTextRequired, removeFile, writeText, } from "./fs.js";
+export { cleanupSocketFiles, removeSocketFile, secureSocketPath } from "./socket.js";
+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/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EACX,OAAO,EACP,UAAU,EACV,SAAS,GAEV,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,eAAe,EACf,qBAAqB,EACrB,kBAAkB,EAClB,sBAAsB,EACtB,gBAAgB,EAChB,cAAc,EACd,WAAW,EACX,YAAY,EACZ,aAAa,EACb,cAAc,GACf,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,UAAU,EACV,OAAO,EACP,SAAS,EACT,aAAa,EACb,UAAU,EACV,QAAQ,EACR,QAAQ,EACR,OAAO,EACP,YAAY,EACZ,WAAW,EACX,UAAU,EACV,QAAQ,EACR,gBAAgB,EAChB,UAAU,EACV,SAAS,GACV,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAErF,OAAO,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAElE,OAAO,EACL,SAAS,EACT,cAAc,EACd,eAAe,EACf,eAAe,EACf,GAAG,EACH,KAAK,EACL,SAAS,EACT,WAAW,GAEZ,MAAM,WAAW,CAAC;AAEnB,OAAO,EACL,uBAAuB,EACvB,uBAAuB,EACvB,gCAAgC,EAChC,yBAAyB,EACzB,yBAAyB,EACzB,2BAA2B,EAC3B,2BAA2B,GAK5B,MAAM,gBAAgB,CAAC"}

package/dist/utils/paths.d.ts

@@ -0,0 +1,22 @@
+import { CONFIG_DIR_NAME, getAgentDir } from "@earendil-works/pi-coding-agent";
+export { CONFIG_DIR_NAME, getAgentDir };
+/** Expand leading `~` or `~/` using the current user's home directory. */
+export declare function expandHomePath(input: string): string;
+/** Pi user config root (~/.pi). Uses Pi's CONFIG_DIR_NAME. */
+export declare function defaultPiConfigDir(): string;
+/** Memory data root: ~/.pi/pi-memory-data */
+export declare function defaultMemoryAgentDir(): string;
+/** pi-memory config: ~/.pi/agent/pi-memory.env */
+export declare function defaultPiMemoryEnvFile(): string;
+export declare function defaultPiLogsDir(): string;
+export declare function defaultConsolidateLogPath(): string;
+export declare function defaultConsolidateErrLogPath(): string;
+/** Directory mode for agent / socket parent dirs (Unix only; ignored on Windows). */
+export declare function secureDirMode(): number | undefined;
+/** File mode for socket files (Unix only; ignored on Windows). */
+export declare function secureFileMode(): number | undefined;
+export declare function mkdirOptions(): {
+    recursive: true;
+    mode?: number;
+};
+//# sourceMappingURL=paths.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/utils/paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAc/E,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,CAAC;AAExC,0EAA0E;AAC1E,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAOpD;AAED,8DAA8D;AAC9D,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C;AAED,6CAA6C;AAC7C,wBAAgB,qBAAqB,IAAI,MAAM,CAE9C;AAED,kDAAkD;AAClD,wBAAgB,sBAAsB,IAAI,MAAM,CAE/C;AAED,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAED,wBAAgB,yBAAyB,IAAI,MAAM,CAElD;AAED,wBAAgB,4BAA4B,IAAI,MAAM,CAErD;AAED,qFAAqF;AACrF,wBAAgB,aAAa,IAAI,MAAM,GAAG,SAAS,CAElD;AAED,kEAAkE;AAClE,wBAAgB,cAAc,IAAI,MAAM,GAAG,SAAS,CAEnD;AAED,wBAAgB,YAAY,IAAI;IAAE,SAAS,EAAE,IAAI,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAGjE"}

package/dist/utils/paths.js

@@ -0,0 +1,51 @@
+import { CONFIG_DIR_NAME, getAgentDir } from "@earendil-works/pi-coding-agent";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { CONSOLIDATE_ERR_LOG_FILE, CONSOLIDATE_LOG_FILE, PI_MEMORY_DATA_SUBDIR, PI_MEMORY_ENV_FILE_NAME, PI_LOGS_SUBDIR, } from "../constants/paths.js";
+import { SECURE_DIR_MODE, SECURE_FILE_MODE } from "../constants/security.js";
+import { isWindows } from "./platform.js";
+export { CONFIG_DIR_NAME, getAgentDir };
+/** Expand leading `~` or `~/` using the current user's home directory. */
+export function expandHomePath(input) {
+    const trimmed = input.trim();
+    if (trimmed === "~")
+        return homedir();
+    if (trimmed.startsWith("~/") || trimmed.startsWith("~\\")) {
+        return join(homedir(), trimmed.slice(2));
+    }
+    return trimmed;
+}
+/** Pi user config root (~/.pi). Uses Pi's CONFIG_DIR_NAME. */
+export function defaultPiConfigDir() {
+    return join(homedir(), CONFIG_DIR_NAME);
+}
+/** Memory data root: ~/.pi/pi-memory-data */
+export function defaultMemoryAgentDir() {
+    return join(defaultPiConfigDir(), PI_MEMORY_DATA_SUBDIR);
+}
+/** pi-memory config: ~/.pi/agent/pi-memory.env */
+export function defaultPiMemoryEnvFile() {
+    return join(getAgentDir(), PI_MEMORY_ENV_FILE_NAME);
+}
+export function defaultPiLogsDir() {
+    return join(defaultPiConfigDir(), PI_LOGS_SUBDIR);
+}
+export function defaultConsolidateLogPath() {
+    return join(defaultPiLogsDir(), CONSOLIDATE_LOG_FILE);
+}
+export function defaultConsolidateErrLogPath() {
+    return join(defaultPiLogsDir(), CONSOLIDATE_ERR_LOG_FILE);
+}
+/** Directory mode for agent / socket parent dirs (Unix only; ignored on Windows). */
+export function secureDirMode() {
+    return isWindows() ? undefined : SECURE_DIR_MODE;
+}
+/** File mode for socket files (Unix only; ignored on Windows). */
+export function secureFileMode() {
+    return isWindows() ? undefined : SECURE_FILE_MODE;
+}
+export function mkdirOptions() {
+    const mode = secureDirMode();
+    return mode === undefined ? { recursive: true } : { recursive: true, mode };
+}
+//# sourceMappingURL=paths.js.map

package/dist/utils/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/utils/paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAC/E,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EACL,wBAAwB,EACxB,oBAAoB,EACpB,qBAAqB,EACrB,uBAAuB,EACvB,cAAc,GACf,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC7E,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE1C,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,CAAC;AAExC,0EAA0E;AAC1E,MAAM,UAAU,cAAc,CAAC,KAAa;IAC1C,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,IAAI,OAAO,KAAK,GAAG;QAAE,OAAO,OAAO,EAAE,CAAC;IACtC,IAAI,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1D,OAAO,IAAI,CAAC,OAAO,EAAE,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3C,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,8DAA8D;AAC9D,MAAM,UAAU,kBAAkB;IAChC,OAAO,IAAI,CAAC,OAAO,EAAE,EAAE,eAAe,CAAC,CAAC;AAC1C,CAAC;AAED,6CAA6C;AAC7C,MAAM,UAAU,qBAAqB;IACnC,OAAO,IAAI,CAAC,kBAAkB,EAAE,EAAE,qBAAqB,CAAC,CAAC;AAC3D,CAAC;AAED,kDAAkD;AAClD,MAAM,UAAU,sBAAsB;IACpC,OAAO,IAAI,CAAC,WAAW,EAAE,EAAE,uBAAuB,CAAC,CAAC;AACtD,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC9B,OAAO,IAAI,CAAC,kBAAkB,EAAE,EAAE,cAAc,CAAC,CAAC;AACpD,CAAC;AAED,MAAM,UAAU,yBAAyB;IACvC,OAAO,IAAI,CAAC,gBAAgB,EAAE,EAAE,oBAAoB,CAAC,CAAC;AACxD,CAAC;AAED,MAAM,UAAU,4BAA4B;IAC1C,OAAO,IAAI,CAAC,gBAAgB,EAAE,EAAE,wBAAwB,CAAC,CAAC;AAC5D,CAAC;AAED,qFAAqF;AACrF,MAAM,UAAU,aAAa;IAC3B,OAAO,SAAS,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,eAAe,CAAC;AACnD,CAAC;AAED,kEAAkE;AAClE,MAAM,UAAU,cAAc;IAC5B,OAAO,SAAS,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,gBAAgB,CAAC;AACpD,CAAC;AAED,MAAM,UAAU,YAAY;IAC1B,MAAM,IAAI,GAAG,aAAa,EAAE,CAAC;IAC7B,OAAO,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;AAC9E,CAAC"}

package/dist/utils/platform.d.ts

@@ -0,0 +1,7 @@
+export type PiMemoryPlatform = "darwin" | "win32" | "other";
+export declare function getPlatform(): PiMemoryPlatform;
+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.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform.d.ts","sourceRoot":"","sources":["../../src/utils/platform.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,OAAO,GAAG,OAAO,CAAC;AAE5D,wBAAgB,WAAW,IAAI,gBAAgB,CAI9C;AAED,wBAAgB,SAAS,IAAI,OAAO,CAEnC;AAED,wBAAgB,OAAO,IAAI,OAAO,CAEjC;AAED,2DAA2D;AAC3D,wBAAgB,UAAU,IAAI,OAAO,CAEpC"}

package/dist/utils/platform.js

@@ -0,0 +1,18 @@
+export function getPlatform() {
+    if (process.platform === "darwin")
+        return "darwin";
+    if (process.platform === "win32")
+        return "win32";
+    return "other";
+}
+export function isWindows() {
+    return process.platform === "win32";
+}
+export function isMacOS() {
+    return process.platform === "darwin";
+}
+/** Unix-like platforms where chmod / UDS cleanup apply. */
+export function isUnixLike() {
+    return !isWindows();
+}
+//# sourceMappingURL=platform.js.map

package/dist/utils/platform.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform.js","sourceRoot":"","sources":["../../src/utils/platform.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,WAAW;IACzB,IAAI,OAAO,CAAC,QAAQ,KAAK,QAAQ;QAAE,OAAO,QAAQ,CAAC;IACnD,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO;QAAE,OAAO,OAAO,CAAC;IACjD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,SAAS;IACvB,OAAO,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,OAAO;IACrB,OAAO,OAAO,CAAC,QAAQ,KAAK,QAAQ,CAAC;AACvC,CAAC;AAED,2DAA2D;AAC3D,MAAM,UAAU,UAAU;IACxB,OAAO,CAAC,SAAS,EAAE,CAAC;AACtB,CAAC"}

package/dist/utils/scheduler.d.ts

@@ -0,0 +1,33 @@
+import { LAUNCHD_LABEL, SCHEDULER_TEMPLATE_FILES, SCHTASKS_TASK_NAME } from "../constants/paths.js";
+import { isMacOS, isWindows, type PiMemoryPlatform } from "./platform.js";
+export type ConsolidateSchedulerKind = "launchd" | "crontab" | "schtasks";
+/** Recommended OS scheduler for daily consolidate on this platform. */
+export declare function getConsolidateSchedulerKind(platform?: PiMemoryPlatform): ConsolidateSchedulerKind;
+export type ConsolidateSchedulerPaths = {
+    agentDir: string;
+    envFile: string;
+    logsDir: string;
+    stdoutLog: string;
+    stderrLog: string;
+};
+export declare function defaultConsolidateSchedulerPaths(): ConsolidateSchedulerPaths;
+export type ConsolidateCliInvocation = {
+    nodePath: string;
+    cliPath: string;
+    cron: boolean;
+    verbose: boolean;
+    agentDir?: string;
+};
+/** argv for `pi-memory maintenance` (OS scheduler / wrapper scripts). */
+export declare function buildMaintenanceCliArgs(opts: Pick<ConsolidateCliInvocation, "cron" | "verbose" | "agentDir">): string[];
+/** @deprecated Prefer buildMaintenanceCliArgs for OS schedulers. */
+export declare function buildConsolidateCliArgs(opts: Pick<ConsolidateCliInvocation, "cron" | "verbose" | "agentDir">): string[];
+/** Single-line shell command (macOS / Linux crontab). */
+export declare function formatMaintenanceCronLine(opts: ConsolidateCliInvocation & ConsolidateSchedulerPaths): string;
+/** @deprecated Prefer formatMaintenanceCronLine. */
+export declare function formatConsolidateCronLine(opts: ConsolidateCliInvocation & ConsolidateSchedulerPaths): string;
+export type ConsolidateTemplateName = (typeof SCHEDULER_TEMPLATE_FILES)[keyof typeof SCHEDULER_TEMPLATE_FILES];
+/** 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.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduler.d.ts","sourceRoot":"","sources":["../../src/utils/scheduler.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,wBAAwB,EACxB,kBAAkB,EACnB,MAAM,uBAAuB,CAAC;AAQ/B,OAAO,EAAe,OAAO,EAAE,SAAS,EAAE,KAAK,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEvF,MAAM,MAAM,wBAAwB,GAAG,SAAS,GAAG,SAAS,GAAG,UAAU,CAAC;AAE1E,uEAAuE;AACvE,wBAAgB,2BAA2B,CAAC,QAAQ,GAAE,gBAAgC,GAAG,wBAAwB,CAIhH;AAED,MAAM,MAAM,yBAAyB,GAAG;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,wBAAgB,gCAAgC,IAAI,yBAAyB,CAQ5E;AAED,MAAM,MAAM,wBAAwB,GAAG;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,yEAAyE;AACzE,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,IAAI,CAAC,wBAAwB,EAAE,MAAM,GAAG,SAAS,GAAG,UAAU,CAAC,GACpE,MAAM,EAAE,CAMV;AAED,oEAAoE;AACpE,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,IAAI,CAAC,wBAAwB,EAAE,MAAM,GAAG,SAAS,GAAG,UAAU,CAAC,GAAG,MAAM,EAAE,CAEvH;AAED,yDAAyD;AACzD,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,wBAAwB,GAAG,yBAAyB,GAAG,MAAM,CAU5G;AAED,oDAAoD;AACpD,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,wBAAwB,GAAG,yBAAyB,GAAG,MAAM,CAE5G;AAED,MAAM,MAAM,uBAAuB,GACjC,CAAC,OAAO,wBAAwB,CAAC,CAAC,MAAM,OAAO,wBAAwB,CAAC,CAAC;AAE3E,yEAAyE;AACzE,wBAAgB,2BAA2B,CAAC,QAAQ,GAAE,gBAAgC,GAAG,uBAAuB,EAAE,CAQjH;AAED,OAAO,EAAE,aAAa,EAAE,wBAAwB,EAAE,kBAAkB,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC"}

package/dist/utils/scheduler.js

@@ -0,0 +1,63 @@
+import { LAUNCHD_LABEL, SCHEDULER_TEMPLATE_FILES, SCHTASKS_TASK_NAME, } from "../constants/paths.js";
+import { defaultConsolidateErrLogPath, defaultConsolidateLogPath, defaultMemoryAgentDir, defaultPiMemoryEnvFile, defaultPiLogsDir, } from "./paths.js";
+import { getPlatform, isMacOS, isWindows } from "./platform.js";
+/** Recommended OS scheduler for daily consolidate on this platform. */
+export function getConsolidateSchedulerKind(platform = getPlatform()) {
+    if (platform === "darwin")
+        return "launchd";
+    if (platform === "win32")
+        return "schtasks";
+    return "crontab";
+}
+export function defaultConsolidateSchedulerPaths() {
+    return {
+        agentDir: defaultMemoryAgentDir(),
+        envFile: defaultPiMemoryEnvFile(),
+        logsDir: defaultPiLogsDir(),
+        stdoutLog: defaultConsolidateLogPath(),
+        stderrLog: defaultConsolidateErrLogPath(),
+    };
+}
+/** argv for `pi-memory maintenance` (OS scheduler / wrapper scripts). */
+export function buildMaintenanceCliArgs(opts) {
+    const args = ["maintenance"];
+    if (opts.cron)
+        args.push("--cron");
+    if (opts.verbose)
+        args.push("--verbose");
+    if (opts.agentDir)
+        args.push("--agent-dir", opts.agentDir);
+    return args;
+}
+/** @deprecated Prefer buildMaintenanceCliArgs for OS schedulers. */
+export function buildConsolidateCliArgs(opts) {
+    return buildMaintenanceCliArgs(opts);
+}
+/** Single-line shell command (macOS / Linux crontab). */
+export function formatMaintenanceCronLine(opts) {
+    const args = buildMaintenanceCliArgs(opts).join(" ");
+    return [
+        `PI_MEMORY_ENV_FILE=${opts.envFile}`,
+        `PI_MEMORY_AGENT_DIR=${opts.agentDir}`,
+        opts.nodePath,
+        opts.cliPath,
+        args,
+        `>> ${opts.stdoutLog} 2>&1`,
+    ].join(" ");
+}
+/** @deprecated Prefer formatMaintenanceCronLine. */
+export function formatConsolidateCronLine(opts) {
+    return formatMaintenanceCronLine(opts);
+}
+/** Template file basename shipped under templates/ for this platform. */
+export function getConsolidateTemplateNames(platform = getPlatform()) {
+    if (platform === "darwin") {
+        return [SCHEDULER_TEMPLATE_FILES.launchd, SCHEDULER_TEMPLATE_FILES.crontab];
+    }
+    if (platform === "win32") {
+        return [SCHEDULER_TEMPLATE_FILES.windowsCmd, SCHEDULER_TEMPLATE_FILES.windowsSchtasks];
+    }
+    return [SCHEDULER_TEMPLATE_FILES.crontab];
+}
+export { LAUNCHD_LABEL, SCHEDULER_TEMPLATE_FILES, SCHTASKS_TASK_NAME, isMacOS, isWindows };
+//# sourceMappingURL=scheduler.js.map

package/dist/utils/scheduler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduler.js","sourceRoot":"","sources":["../../src/utils/scheduler.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,wBAAwB,EACxB,kBAAkB,GACnB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,4BAA4B,EAC5B,yBAAyB,EACzB,qBAAqB,EACrB,sBAAsB,EACtB,gBAAgB,GACjB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,SAAS,EAAyB,MAAM,eAAe,CAAC;AAIvF,uEAAuE;AACvE,MAAM,UAAU,2BAA2B,CAAC,WAA6B,WAAW,EAAE;IACpF,IAAI,QAAQ,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IAC5C,IAAI,QAAQ,KAAK,OAAO;QAAE,OAAO,UAAU,CAAC;IAC5C,OAAO,SAAS,CAAC;AACnB,CAAC;AAUD,MAAM,UAAU,gCAAgC;IAC9C,OAAO;QACL,QAAQ,EAAE,qBAAqB,EAAE;QACjC,OAAO,EAAE,sBAAsB,EAAE;QACjC,OAAO,EAAE,gBAAgB,EAAE;QAC3B,SAAS,EAAE,yBAAyB,EAAE;QACtC,SAAS,EAAE,4BAA4B,EAAE;KAC1C,CAAC;AACJ,CAAC;AAUD,yEAAyE;AACzE,MAAM,UAAU,uBAAuB,CACrC,IAAqE;IAErE,MAAM,IAAI,GAAG,CAAC,aAAa,CAAC,CAAC;IAC7B,IAAI,IAAI,CAAC,IAAI;QAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACnC,IAAI,IAAI,CAAC,OAAO;QAAE,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACzC,IAAI,IAAI,CAAC,QAAQ;QAAE,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC3D,OAAO,IAAI,CAAC;AACd,CAAC;AAED,oEAAoE;AACpE,MAAM,UAAU,uBAAuB,CAAC,IAAqE;IAC3G,OAAO,uBAAuB,CAAC,IAAI,CAAC,CAAC;AACvC,CAAC;AAED,yDAAyD;AACzD,MAAM,UAAU,yBAAyB,CAAC,IAA0D;IAClG,MAAM,IAAI,GAAG,uBAAuB,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACrD,OAAO;QACL,sBAAsB,IAAI,CAAC,OAAO,EAAE;QACpC,uBAAuB,IAAI,CAAC,QAAQ,EAAE;QACtC,IAAI,CAAC,QAAQ;QACb,IAAI,CAAC,OAAO;QACZ,IAAI;QACJ,MAAM,IAAI,CAAC,SAAS,OAAO;KAC5B,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACd,CAAC;AAED,oDAAoD;AACpD,MAAM,UAAU,yBAAyB,CAAC,IAA0D;IAClG,OAAO,yBAAyB,CAAC,IAAI,CAAC,CAAC;AACzC,CAAC;AAKD,yEAAyE;AACzE,MAAM,UAAU,2BAA2B,CAAC,WAA6B,WAAW,EAAE;IACpF,IAAI,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAC1B,OAAO,CAAC,wBAAwB,CAAC,OAAO,EAAE,wBAAwB,CAAC,OAAO,CAAC,CAAC;IAC9E,CAAC;IACD,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;QACzB,OAAO,CAAC,wBAAwB,CAAC,UAAU,EAAE,wBAAwB,CAAC,eAAe,CAAC,CAAC;IACzF,CAAC;IACD,OAAO,CAAC,wBAAwB,CAAC,OAAO,CAAC,CAAC;AAC5C,CAAC;AAED,OAAO,EAAE,aAAa,EAAE,wBAAwB,EAAE,kBAAkB,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC"}

package/dist/utils/socket.d.ts

@@ -0,0 +1,7 @@
+/** Remove stale socket file before bind (Unix domain sockets only). */
+export declare function removeSocketFile(socketPath: string): void;
+/** Restrict socket permissions after bind (Unix only). */
+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.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"socket.d.ts","sourceRoot":"","sources":["../../src/utils/socket.ts"],"names":[],"mappings":"AAKA,uEAAuE;AACvE,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAOzD;AAED,0DAA0D;AAC1D,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAIzD;AAED,yDAAyD;AACzD,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAS7E"}

package/dist/utils/socket.js

@@ -0,0 +1,35 @@
+import { chmodSync, unlinkSync } from "node:fs";
+import { secureFileMode } from "./paths.js";
+import { isUnixLike } from "./platform.js";
+/** Remove stale socket file before bind (Unix domain sockets only). */
+export function removeSocketFile(socketPath) {
+    if (!isUnixLike())
+        return;
+    try {
+        unlinkSync(socketPath);
+    }
+    catch {
+        // ENOENT or in-use; listen() will surface real errors
+    }
+}
+/** Restrict socket permissions after bind (Unix only). */
+export function secureSocketPath(socketPath) {
+    const mode = secureFileMode();
+    if (mode === undefined)
+        return;
+    chmodSync(socketPath, mode);
+}
+/** Remove socket and pid companion files on shutdown. */
+export function cleanupSocketFiles(socketPath, pidPath) {
+    for (const path of [socketPath, pidPath]) {
+        if (!path)
+            continue;
+        try {
+            unlinkSync(path);
+        }
+        catch {
+            // already gone
+        }
+    }
+}
+//# sourceMappingURL=socket.js.map

package/dist/utils/socket.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"socket.js","sourceRoot":"","sources":["../../src/utils/socket.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAEhD,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAE3C,uEAAuE;AACvE,MAAM,UAAU,gBAAgB,CAAC,UAAkB;IACjD,IAAI,CAAC,UAAU,EAAE;QAAE,OAAO;IAC1B,IAAI,CAAC;QACH,UAAU,CAAC,UAAU,CAAC,CAAC;IACzB,CAAC;IAAC,MAAM,CAAC;QACP,sDAAsD;IACxD,CAAC;AACH,CAAC;AAED,0DAA0D;AAC1D,MAAM,UAAU,gBAAgB,CAAC,UAAkB;IACjD,MAAM,IAAI,GAAG,cAAc,EAAE,CAAC;IAC9B,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO;IAC/B,SAAS,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;AAC9B,CAAC;AAED,yDAAyD;AACzD,MAAM,UAAU,kBAAkB,CAAC,UAAkB,EAAE,OAAgB;IACrE,KAAK,MAAM,IAAI,IAAI,CAAC,UAAU,EAAE,OAAO,CAAC,EAAE,CAAC;QACzC,IAAI,CAAC,IAAI;YAAE,SAAS;QACpB,IAAI,CAAC;YACH,UAAU,CAAC,IAAI,CAAC,CAAC;QACnB,CAAC;QAAC,MAAM,CAAC;YACP,eAAe;QACjB,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/utils/time.d.ts

@@ -0,0 +1,22 @@
+import { type ConfigType, type Dayjs } from "dayjs";
+export type TimeInput = ConfigType;
+/** Current local time. */
+export declare function now(): Dayjs;
+/** Unix epoch ms (deadlines, lock files, external APIs). */
+export declare function nowMs(): number;
+/** Parse stored or external input; invalid values fall back to epoch. */
+export declare function parseTime(input: TimeInput): Dayjs;
+/**
+ * Local timestamp for MEMORY entries, GC markers, shutdown queue.
+ * Format: YYYY-MM-DDTHH:mm:ss.SSS (local wall clock, no Z suffix).
+ */
+export declare function formatTimestamp(input?: TimeInput): string;
+/** Local calendar date (e.g. auto-YYYY-MM-DD-*.md). */
+export declare function formatLocalDate(input?: TimeInput): string;
+/** Fallback timestamp when entry metadata is missing. */
+export declare function epochTimestamp(): string;
+/** Whole calendar days from `from` until `to` (local; default `to` = now). */
+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.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"time.d.ts","sourceRoot":"","sources":["../../src/utils/time.ts"],"names":[],"mappings":"AAAA,OAAc,EAAE,KAAK,UAAU,EAAE,KAAK,KAAK,EAAE,MAAM,OAAO,CAAC;AAE3D,MAAM,MAAM,SAAS,GAAG,UAAU,CAAC;AAEnC,0BAA0B;AAC1B,wBAAgB,GAAG,IAAI,KAAK,CAE3B;AAED,4DAA4D;AAC5D,wBAAgB,KAAK,IAAI,MAAM,CAE9B;AAED,yEAAyE;AACzE,wBAAgB,SAAS,CAAC,KAAK,EAAE,SAAS,GAAG,KAAK,CAGjD;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,CAAC,EAAE,SAAS,GAAG,MAAM,CAGzD;AAED,uDAAuD;AACvD,wBAAgB,eAAe,CAAC,KAAK,CAAC,EAAE,SAAS,GAAG,MAAM,CAGzD;AAED,yDAAyD;AACzD,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED,8EAA8E;AAC9E,wBAAgB,SAAS,CAAC,IAAI,EAAE,SAAS,EAAE,EAAE,CAAC,EAAE,SAAS,GAAG,MAAM,CAIjE;AAED,iEAAiE;AACjE,wBAAgB,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,GAAE,MAAgB,GAAG,MAAM,CAE9E"}

package/dist/utils/time.js

@@ -0,0 +1,42 @@
+import dayjs from "dayjs";
+/** Current local time. */
+export function now() {
+    return dayjs();
+}
+/** Unix epoch ms (deadlines, lock files, external APIs). */
+export function nowMs() {
+    return dayjs().valueOf();
+}
+/** Parse stored or external input; invalid values fall back to epoch. */
+export function parseTime(input) {
+    const parsed = dayjs(input);
+    return parsed.isValid() ? parsed : dayjs(0);
+}
+/**
+ * Local timestamp for MEMORY entries, GC markers, shutdown queue.
+ * Format: YYYY-MM-DDTHH:mm:ss.SSS (local wall clock, no Z suffix).
+ */
+export function formatTimestamp(input) {
+    const t = input === undefined ? dayjs() : parseTime(input);
+    return t.format("YYYY-MM-DDTHH:mm:ss.SSS");
+}
+/** Local calendar date (e.g. auto-YYYY-MM-DD-*.md). */
+export function formatLocalDate(input) {
+    const t = input === undefined ? dayjs() : parseTime(input);
+    return t.format("YYYY-MM-DD");
+}
+/** Fallback timestamp when entry metadata is missing. */
+export function epochTimestamp() {
+    return formatTimestamp(0);
+}
+/** Whole calendar days from `from` until `to` (local; default `to` = now). */
+export function daysSince(from, to) {
+    const end = to === undefined ? dayjs() : parseTime(to);
+    const start = parseTime(from);
+    return end.startOf("day").diff(start.startOf("day"), "day");
+}
+/** Milliseconds left until `deadlineMs` (default clock: now). */
+export function remainingMs(deadlineMs, atMs = nowMs()) {
+    return Math.max(0, deadlineMs - atMs);
+}
+//# sourceMappingURL=time.js.map

package/dist/utils/time.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"time.js","sourceRoot":"","sources":["../../src/utils/time.ts"],"names":[],"mappings":"AAAA,OAAO,KAAsC,MAAM,OAAO,CAAC;AAI3D,0BAA0B;AAC1B,MAAM,UAAU,GAAG;IACjB,OAAO,KAAK,EAAE,CAAC;AACjB,CAAC;AAED,4DAA4D;AAC5D,MAAM,UAAU,KAAK;IACnB,OAAO,KAAK,EAAE,CAAC,OAAO,EAAE,CAAC;AAC3B,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,SAAS,CAAC,KAAgB;IACxC,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC;IAC5B,OAAO,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AAC9C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,KAAiB;IAC/C,MAAM,CAAC,GAAG,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAC3D,OAAO,CAAC,CAAC,MAAM,CAAC,yBAAyB,CAAC,CAAC;AAC7C,CAAC;AAED,uDAAuD;AACvD,MAAM,UAAU,eAAe,CAAC,KAAiB;IAC/C,MAAM,CAAC,GAAG,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAC3D,OAAO,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;AAChC,CAAC;AAED,yDAAyD;AACzD,MAAM,UAAU,cAAc;IAC5B,OAAO,eAAe,CAAC,CAAC,CAAC,CAAC;AAC5B,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,SAAS,CAAC,IAAe,EAAE,EAAc;IACvD,MAAM,GAAG,GAAG,EAAE,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;IACvD,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IAC9B,OAAO,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC,CAAC;AAC9D,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,WAAW,CAAC,UAAkB,EAAE,OAAe,KAAK,EAAE;IACpE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC,CAAC;AACxC,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@chendpoc/pi-memory",
-  "version": "0.1.13",
-  "description": "Local episodic memory for Pi coding agent — knowledge graph + memory_recall tool + implicit preflight",
+  "version": "0.2.0",
+  "description": "Cross-session episodic memory for Pi agent — MEMORY.md ground truth, JSONL sidecar retrieval, and Preflight injection",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -16,10 +16,13 @@
     }
   },
   "bin": {
-    "pi-memory": "./dist/cli.js"
+    "pi-memory": "./dist/cli.js",
+    "pi-memory-sidecar": "./dist/sidecar/server/process.js"
   },
   "scripts": {
-    "build": "tsc",
+    "clean": "rm -rf dist",
+    "build": "rm -rf dist && tsc",
+    "postinstall": "node ./scripts/postinstall.mjs",
     "test": "vitest run",
     "test:watch": "vitest",
     "typecheck": "tsc --noEmit",
@@ -36,10 +39,16 @@
     "dist",
     "src/**/*.ts",
     "!src/**/*.test.ts",
-    "README.md"
+    "templates/MEMORY.md.example",
+    "scripts/path-utils.mjs",
+    "scripts/init-memory-workspace.mjs",
+    "scripts/platform-fs.mjs",
+    "scripts/postinstall.mjs",
+    "README.md",
+    "UBIQUITOUS_LANGUAGE.md"
   ],
   "engines": {
-    "node": ">=24"
+    "node": ">=24.0.0 <25"
   },
   "packageManager": "pnpm@10.12.1",
   "keywords": [
@@ -47,7 +56,7 @@
     "pi-extension",
     "pi-agent",
     "episodic-memory",
-    "knowledge-graph",
+    "recent-memory",
     "memory-recall"
   ],
   "license": "MIT",
@@ -66,7 +75,8 @@
     "@earendil-works/pi-agent-core": "*",
     "@earendil-works/pi-ai": "*",
     "@earendil-works/pi-coding-agent": "*",
-    "typebox": "*"
+    "@earendil-works/pi-tui": "*",
+    "typebox": "^1.1.38"
   },
   "optionalDependencies": {
     "better-sqlite3": "^12.10.0"
@@ -77,9 +87,11 @@
     "@earendil-works/pi-agent-core": "*",
     "@earendil-works/pi-ai": "*",
     "@earendil-works/pi-coding-agent": "*",
+    "@earendil-works/pi-tui": "*",
     "@types/better-sqlite3": "^7.6.0",
+    "@types/lodash": "^4.17.24",
     "@types/node": "^24.0.0",
-    "typebox": "*",
+    "typebox": "^1.3.3",
     "typescript": "^5.7.2",
     "vitest": "^3.0.0"
   },
@@ -87,6 +99,12 @@
     "better-sqlite3@12.11.1": true
   },
   "dependencies": {
-    "lru-cache": "^11.5.1"
+    "chalk": "^5.6.2",
+    "dayjs": "^1.11.21",
+    "dotenv": "^17.4.2",
+    "execa": "^9.6.1",
+    "lodash": "^4.18.1",
+    "lru-cache": "^11.5.1",
+    "proper-lockfile": "^4.1.2"
   }
 }