@chendpoc/pi-memory 0.1.12 → 0.2.0

package/dist/store/paths.js

@@ -0,0 +1,19 @@
+import { expandHomePath } from "../utils/paths.js";
+import { joinPath } from "../utils/fs.js";
+import { AUTO_FILE_PREFIX, COMPACTION_STATE_FILE, DEFAULT_MEMORY_FILE, MEMORY_GC_FILE, } from "../constants/memory.js";
+export function resolveAgentDir(agentDir) {
+    return expandHomePath(agentDir);
+}
+export function getAgentPaths(agentDir, memoryFileName = DEFAULT_MEMORY_FILE) {
+    const resolved = resolveAgentDir(agentDir);
+    return {
+        agentDir: resolved,
+        memoryFile: joinPath(resolved, memoryFileName),
+        memoryGcFile: joinPath(resolved, MEMORY_GC_FILE),
+        compactionStateFile: joinPath(resolved, COMPACTION_STATE_FILE),
+    };
+}
+export function isAutoOverflowFile(name) {
+    return name.startsWith(AUTO_FILE_PREFIX) && name.endsWith(".md");
+}
+//# sourceMappingURL=paths.js.map

package/dist/store/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/store/paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EACL,gBAAgB,EAChB,qBAAqB,EACrB,mBAAmB,EACnB,cAAc,GACf,MAAM,wBAAwB,CAAC;AAShC,MAAM,UAAU,eAAe,CAAC,QAAgB;IAC9C,OAAO,cAAc,CAAC,QAAQ,CAAC,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,QAAgB,EAAE,cAAc,GAAG,mBAAmB;IAClF,MAAM,QAAQ,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC;IAC3C,OAAO;QACL,QAAQ,EAAE,QAAQ;QAClB,UAAU,EAAE,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;QAC9C,YAAY,EAAE,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;QAChD,mBAAmB,EAAE,QAAQ,CAAC,QAAQ,EAAE,qBAAqB,CAAC;KAC/D,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,IAAY;IAC7C,OAAO,IAAI,CAAC,UAAU,CAAC,gBAAgB,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AACnE,CAAC"}

package/dist/store/types.d.ts

@@ -0,0 +1,38 @@
+import type { IndexDocument } from "../sidecar/protocol.js";
+import { MEMORY_SECTIONS, type MemorySection } from "../constants/memory.js";
+export { MEMORY_SECTIONS, type MemorySection };
+/** Durable note stored in MEMORY.md (+ overflow files). */
+export type StoreMemoryEntry = {
+    id: string;
+    section: MemorySection;
+    content: string;
+    userAuthored?: boolean;
+    timestamp: string;
+};
+export type ParsedEntry = StoreMemoryEntry & {
+    sourceFile: string;
+    line: number;
+};
+export type MemoryStats = {
+    lineCount: number;
+    overflowFileCount: number;
+    entryCount: number;
+    lastConsolidatedAt: string | null;
+};
+export type ResolvedMemory = {
+    content: string;
+    entries: ParsedEntry[];
+};
+export type IntegrityReport = {
+    ok: boolean;
+    issues: string[];
+};
+export type { LlmClient } from "../adapters/llm/types.js";
+export type MemoryStoreOptions = {
+    agentDir: string;
+    memoryFileName?: string;
+    maxLines?: number;
+    defaultFallbackMaxChars?: number;
+};
+export type { IndexDocument };
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/store/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,KAAK,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAE7E,OAAO,EAAE,eAAe,EAAE,KAAK,aAAa,EAAE,CAAC;AAE/C,2DAA2D;AAC3D,MAAM,MAAM,gBAAgB,GAAG;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,aAAa,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG,gBAAgB,GAAG;IAC3C,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;CACnC,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,WAAW,EAAE,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB,CAAC;AAEF,YAAY,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAE1D,MAAM,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uBAAuB,CAAC,EAAE,MAAM,CAAC;CAClC,CAAC;AAEF,YAAY,EAAE,aAAa,EAAE,CAAC"}

package/dist/store/types.js

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

package/dist/store/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/store/types.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAsB,MAAM,wBAAwB,CAAC;AAE7E,OAAO,EAAE,eAAe,EAAsB,CAAC"}

package/dist/ui/memoryStatusWidget.d.ts

@@ -0,0 +1,20 @@
+import type { Theme } from "@earendil-works/pi-coding-agent";
+import type { Component, TUI } from "@earendil-works/pi-tui";
+import type { MemoryStatusReport } from "../cli/status.js";
+export type MemoryStatusWidgetState = {
+    report: MemoryStatusReport;
+    expanded: boolean;
+};
+export declare class MemoryStatusWidget implements Component {
+    private readonly theme;
+    private state;
+    private cachedWidth?;
+    private cachedLines?;
+    private version;
+    private cachedVersion;
+    constructor(theme: Theme, state: MemoryStatusWidgetState);
+    invalidate(): void;
+    render(width: number): string[];
+}
+export declare function createMemoryStatusWidget(_tui: TUI, theme: Theme, state: MemoryStatusWidgetState): MemoryStatusWidget;
+//# sourceMappingURL=memoryStatusWidget.d.ts.map

package/dist/ui/memoryStatusWidget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memoryStatusWidget.d.ts","sourceRoot":"","sources":["../../src/ui/memoryStatusWidget.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iCAAiC,CAAC;AAC7D,OAAO,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,wBAAwB,CAAC;AAG7D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAO3D,MAAM,MAAM,uBAAuB,GAAG;IACpC,MAAM,EAAE,kBAAkB,CAAC;IAC3B,QAAQ,EAAE,OAAO,CAAC;CACnB,CAAC;AAUF,qBAAa,kBAAmB,YAAW,SAAS;IAOhD,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,KAAK;IAPf,OAAO,CAAC,WAAW,CAAC,CAAS;IAC7B,OAAO,CAAC,WAAW,CAAC,CAAW;IAC/B,OAAO,CAAC,OAAO,CAAK;IACpB,OAAO,CAAC,aAAa,CAAM;gBAGR,KAAK,EAAE,KAAK,EACrB,KAAK,EAAE,uBAAuB;IAGxC,UAAU,IAAI,IAAI;IAIlB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE;CAgChC;AAED,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,GAAG,EACT,KAAK,EAAE,KAAK,EACZ,KAAK,EAAE,uBAAuB,GAC7B,kBAAkB,CAEpB"}

package/dist/ui/memoryStatusWidget.js

@@ -0,0 +1,51 @@
+import { truncateToWidth } from "@earendil-works/pi-tui";
+import { formatMemoryStatusSummary, formatMemoryStatusTuiLines, piStatusPalette, } from "../cli/status.js";
+function formatHeader(theme, width) {
+    const title = theme.fg("accent", theme.bold("pi-memory status"));
+    const fill = Math.max(0, width - title.length - 2);
+    const left = Math.floor(fill / 2);
+    const right = fill - left;
+    return `${theme.fg("borderMuted", "─".repeat(left))} ${title} ${theme.fg("borderMuted", "─".repeat(right))}`;
+}
+export class MemoryStatusWidget {
+    theme;
+    state;
+    cachedWidth;
+    cachedLines;
+    version = 0;
+    cachedVersion = -1;
+    constructor(theme, state) {
+        this.theme = theme;
+        this.state = state;
+    }
+    invalidate() {
+        this.cachedLines = undefined;
+    }
+    render(width) {
+        if (this.cachedLines && this.cachedWidth === width && this.cachedVersion === this.version) {
+            return this.cachedLines;
+        }
+        const palette = piStatusPalette(this.theme);
+        const lines = [];
+        if (!this.state.expanded) {
+            const summary = formatMemoryStatusSummary(this.state.report, palette, (text) => this.theme.fg("accent", text));
+            const hint = this.theme.fg("dim", " (/memory-status to expand)");
+            lines.push(truncateToWidth(`${summary}${hint}`, width));
+        }
+        else {
+            lines.push(truncateToWidth(formatHeader(this.theme, width), width));
+            for (const line of formatMemoryStatusTuiLines(this.state.report, palette, this.theme)) {
+                lines.push(truncateToWidth(`  ${line}`, width));
+            }
+            lines.push(truncateToWidth(this.theme.fg("dim", "  /memory-status to collapse · /memory-status hide to dismiss"), width));
+        }
+        this.cachedLines = lines;
+        this.cachedWidth = width;
+        this.cachedVersion = this.version;
+        return lines;
+    }
+}
+export function createMemoryStatusWidget(_tui, theme, state) {
+    return new MemoryStatusWidget(theme, state);
+}
+//# sourceMappingURL=memoryStatusWidget.js.map

package/dist/ui/memoryStatusWidget.js.map

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

package/dist/utils/debugLog.d.ts

@@ -0,0 +1,4 @@
+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.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"debugLog.d.ts","sourceRoot":"","sources":["../../src/utils/debugLog.ts"],"names":[],"mappings":"AAEA,wBAAgB,oBAAoB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,OAAO,CAElF;AAED,8DAA8D;AAC9D,wBAAgB,WAAW,CACzB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC,EACrE,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,IAAI,CASN"}

package/dist/utils/debugLog.js

@@ -0,0 +1,14 @@
+import { theme } from "../cli/theme.js";
+export function isMemoryDebugEnabled(env = process.env) {
+    return env.PI_MEMORY_DEBUG === "1" || env.PI_MEMORY_DEBUG === "true";
+}
+/** Debug-only stderr log; never shown to Pi UI or session. */
+export function debugMemory(scope, message, fields, env = process.env) {
+    if (!isMemoryDebugEnabled(env))
+        return;
+    const suffix = fields && Object.keys(fields).length > 0
+        ? ` ${JSON.stringify(fields, (_key, value) => (value === undefined ? null : value))}`
+        : "";
+    console.error(theme.dim(`[${scope}] ${message}${suffix}`));
+}
+//# sourceMappingURL=debugLog.js.map

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":"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"}

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"}