@chendpoc/pi-memory 0.2.1 → 0.2.3

package/README.md

@@ -1,3 +1,7 @@
+<p align="center">
+  <img src="https://raw.githubusercontent.com/chendpoc/pi-memory/main/assets/pi-memory-logo.png" alt="pi-memory logo" width="720" />
+</p>
+
 # @chendpoc/pi-memory
 
 <p align="center">
@@ -9,7 +13,7 @@ Cross-session episodic memory for the [Pi coding agent](https://pi.dev).
 
 `pi-memory` gives Pi a local, auditable memory layer across sessions. It keeps durable facts in **`MEMORY.md` as the source of truth**, derives a vector index in `memory.vec.sqlite`, and injects relevant private context through Preflight before the main model answers.
 
-## What It Does
+## 🧠 What It Does
 
 Pi already has compaction for long sessions. That solves "this conversation is too long"; it does not solve "a new session forgot my preferences, project conventions, prior decisions, and unresolved todos."
 
@@ -21,14 +25,15 @@ durable facts -> MEMORY.md -> derived vector index -> per-turn Preflight recall
 
 It provides:
 
-- **Explicit memory** through `/remember`.
-- **Automatic durable fact export** from Pi compaction.
-- **Shutdown queue recovery** for short or missed sessions.
-- **Per-turn private recall** before the main model runs.
-- **Human-editable storage** in Markdown, with vector search as a rebuildable index.
-- **Offline maintenance** for consolidation, dedupe, overflow handling, and queue draining.
+- ✍️ **Explicit memory** through `/remember`.
+- 🔁 **Automatic durable fact export** from Pi compaction.
+- 📥 **Shutdown queue recovery** for short or missed sessions.
+- 🔦 **Per-turn private recall** before the main model runs.
+- 📄 **Human-editable storage** in Markdown, with vector search as a rebuildable index.
+- 🔌 **Local UDS sidecar** for vector retrieval and reindexing, without opening an HTTP port.
+- ⏳ **Daemon-friendly maintenance**: shutdown enqueues metadata, while consolidation and queue draining can run offline.
 
-## Installation
+## 📦 Installation
 
 Requirements:
 
@@ -36,10 +41,10 @@ Requirements:
 - pnpm
 - Pi extension runtime packages supplied by Pi
 
-Install as a package in the Pi extension environment:
+Install from Pi:
 
 ```bash
-pnpm add @chendpoc/pi-memory
+pi install npm:@chendpoc/pi-memory
 ```
 
 For local development from this repository:
@@ -56,22 +61,36 @@ Enable the extension through Pi's extension loading mechanism. This package decl
 ```json
 {
   "pi": {
-    "extensions": ["./src/pi-extension.ts"]
+    "extensions": ["./dist/pi-extension.js"]
   }
 }
 ```
 
-Initialize memory explicitly when needed:
+Published npm packages ship precompiled `dist/`; `pi install npm:@chendpoc/pi-memory` loads the compiled extension entry directly.
+
+### 🌱 Memory workspace (automatic)
+
+You usually **do not need to run `pi-memory init` manually**. The same bootstrap (`initializeMemoryWorkspace`) runs automatically and **never overwrites a non-empty `MEMORY.md`**:
+
+| When | What happens |
+| --- | --- |
+| **`pnpm install`** | `postinstall` runs `pi-memory init` (or a pre-build fallback) |
+| **First Pi session** | `session_start` → `MemoryStore.ensureInitialized()` |
+| **Manual (optional)** | `pi-memory init` |
+
+Run `pi-memory init` explicitly only when:
+
+- You set **`PI_MEMORY_AGENT_DIR`** after install (postinstall may have seeded the default path).
+- Install scripts were skipped (`--ignore-scripts` or corporate policy).
+- You want to bootstrap before opening Pi, or verify setup with `pi-memory status`.
 
 ```bash
-pi-memory init
+pi-memory init   # optional; see above
 ```
 
-Initialization never overwrites a non-empty `MEMORY.md`.
-
-## Why Choose `pi-memory`
+## ✨ Why Choose `pi-memory`
 
-### Agent Before / After
+### 🔄 Agent Before / After
 
 | Situation | Without `pi-memory` | With `pi-memory` |
 | --- | --- | --- |
@@ -82,18 +101,30 @@ Initialization never overwrites a non-empty `MEMORY.md`.
 | Vector sidecar is down | A hard dependency would break the turn. | Preflight silently falls back to Markdown or injects nothing; the model still runs. |
 | Memory grows | A file can become noisy and unbounded. | 150-line `MEMORY.md` cap, `auto-*.md` overflow, consolidate merge/dedupe. |
 
-### Key Advantages
+### 🌟 Key Advantages
 
-- **Markdown Ground Truth**: `MEMORY.md` and `auto-*.md` can be opened, reviewed, edited, grepped, copied, or versioned.
-- **Derived index, not hidden state**: `memory.vec.sqlite` can be deleted and rebuilt from Markdown.
-- **Preflight recall**: Memory is injected before the main model answers instead of hoping the model calls a search tool.
-- **Hot-path budget**: Default Preflight budget is **800ms**, with QueryIntent, sidecar query, and fallback all bounded.
-- **Protected user notes**: `/remember` writes `[user]` entries that consolidate must not remove or rewrite.
-- **Sidecar isolation**: embedding, vector scan, MMR, stats, and reindex run outside the extension process, while writes stay owned by `MemoryStore`.
-- **Subagent policy**: root sessions get Memory Cap + Episodic Preflight; subagents get Memory Cap only by default.
-- **Graceful fallback**: if sidecar recall is empty, timed out, or unavailable, the turn still runs.
+- 📓 **Markdown Ground Truth**: `MEMORY.md` and `auto-*.md` can be opened, reviewed, edited, grepped, copied, or versioned.
+- 🏗️ **Derived index, not hidden state**: `memory.vec.sqlite` can be deleted and rebuilt from Markdown.
+- 🔎 **Preflight recall**: Memory is injected before the main model answers instead of hoping the model calls a search tool.
+- ⏱️ **Hot-path budget**: Default Preflight budget is **800ms**, with QueryIntent, sidecar query, and fallback all bounded.
+- 🔒 **Protected user notes**: `/remember` writes `[user]` entries that consolidate must not remove or rewrite.
+- 🔗 **UDS, not HTTP**: the agent talks to the sidecar over `node:net` Unix domain sockets with JSONL frames, so there is no local HTTP server or port to secure.
+- 🏭 **Sidecar process isolation**: embedding, vector scan, MMR, stats, and reindex run in a spawned Node process, while writes stay owned by `MemoryStore`.
+- 💤 **Daemon-safe writes**: `session_shutdown` only appends metadata; heavier consolidation and shutdown-queue draining are intended for `pi-memory maintenance` or background scheduling.
+- 👥 **Subagent policy**: root sessions get Memory Cap + Episodic Preflight; subagents get Memory Cap only by default.
+- ☂️ **Graceful fallback**: if sidecar recall is empty, timed out, or unavailable, the turn still runs.
+
+### ⚙️ Runtime Choices
+
+| Choice | Why it matters |
+| --- | --- |
+| `MEMORY.md` as Ground Truth | Durable memory remains inspectable and editable instead of becoming opaque database state. |
+| UDS JSONL over `node:net` | Local IPC stays private to the machine, avoids HTTP ports, and keeps request/response framing simple. |
+| Spawned sidecar process | Vector query/reindex work is isolated from the Pi extension process; failures degrade to Markdown fallback. |
+| Offline `maintenance` job | Consolidation and shutdown-queue draining can run outside the interactive agent turn. |
+| Bounded Preflight | QueryIntent, sidecar query, cache, and fallback all share a tight latency budget. |
 
-### Comparison
+### ⚖️ Comparison
 
 `pi-memory` is not trying to be every memory system. The value is a specific Pi-native loop: Markdown ground truth, Preflight injection, sidecar retrieval, compaction export, and offline maintenance.
 
@@ -115,9 +146,9 @@ Where other systems are stronger:
 - Mem0: hosted multi-tenant memory API.
 - Letta: autonomous context repositories and sleep-time memory work.
 
-## How It Works
+## ⚙️ How It Works
 
-### Architecture
+### 🏗️ Architecture
 
 ```text
 Pi extension process
@@ -142,14 +173,14 @@ Pi extension process
   `- consolidate scheduler
        `- merge/dedupe -> rewrite Ground Truth -> reindex
 
-Sidecar process over UDS JSONL
+Sidecar process over UDS JSONL (`node:net`, no HTTP port)
   |- ping
   |- stats
   |- query: embed -> cosine scan -> MMR
   `- reindex: upsert chunks into memory.vec.sqlite
 ```
 
-### Read Path
+### 🔎 Read Path
 
 Root session:
 
@@ -174,7 +205,7 @@ Sidecar results
   -> if empty: no injection
 ```
 
-### Write Paths
+### ✍️ Write Paths
 
 | Path | Trigger | LLM? | Blocking? | Purpose |
 | --- | --- | --- | --- | --- |
@@ -183,7 +214,7 @@ Sidecar results
 | Shutdown Queue | `session_shutdown` + `pi-memory maintenance` | Only offline, when no compaction summary exists | No during shutdown | Recover facts from short or missed sessions |
 | Consolidate | overflow >= 12, 7 days, or daily cron | Optional | Offline/background | Dedupe, merge, prune obsolete todos |
 
-## Data And Memory Format
+## 💾 Data And Memory Format
 
 All artifacts live under one memory agent directory.
 
@@ -233,7 +264,7 @@ Rules:
 - Overflow entries spill to `auto-*.md`, with a pointer in `MEMORY.md`.
 - Vector chunks are derived from entries; by default long entries split beyond `PI_MEMORY_CHUNK_MAX_CHARS=512`.
 
-## Configuration
+## 🎛️ Configuration
 
 Optional env file locations are loaded in this order:
 
@@ -262,7 +293,7 @@ Common variables:
 
 See [`.env.example`](./.env.example) for the full list.
 
-### Embedders
+### 🛰️ Embedders
 
 | Embedder | Use When | Notes |
 | --- | --- | --- |
@@ -272,7 +303,7 @@ See [`.env.example`](./.env.example) for the full list.
 
 The Vector Index stores embedding provider, model, and dimension metadata. When they change, old chunks are cleared and rebuilt.
 
-## Commands
+## ⌨️ Commands
 
 Inside Pi:
 
@@ -284,11 +315,11 @@ Inside Pi:
 CLI:
 
 ```bash
-pi-memory init
 pi-memory status
 pi-memory maintenance --cron --verbose
 pi-memory consolidate --force --verbose
 pi-memory drain-shutdown-queue --verbose
+pi-memory init   # optional — usually automatic after install + first session
 ```
 
 `maintenance` is the recommended scheduler entrypoint:
@@ -304,7 +335,7 @@ Scheduler templates:
 - [`templates/consolidate.cmd.example`](./templates/consolidate.cmd.example)
 - [`templates/schtasks.example.txt`](./templates/schtasks.example.txt)
 
-## Diagnostics
+## 🩺 Diagnostics
 
 Use `/memory-status` or `pi-memory status` to inspect:
 
@@ -335,7 +366,7 @@ Use `PI_MEMORY_DEBUG=1` to log Preflight timings:
 }
 ```
 
-## Non-Goals
+## 🚫 Non-Goals
 
 - Replacing Pi compaction.
 - Replacing session search; use a dedicated session-search extension for old conversations.
@@ -344,7 +375,7 @@ Use `PI_MEMORY_DEBUG=1` to log Preflight timings:
 - Storing full chat transcripts as memory.
 - Adding multi-second reflection to every user turn.
 
-## Development
+## 🛠️ Development
 
 ```bash
 pnpm typecheck
@@ -354,12 +385,12 @@ pnpm build
 
 The sidecar IPC test opens a Unix domain socket. If it fails with `listen EPERM` inside a restricted sandbox, run the test in a normal local shell.
 
-## Docs
+## 📚 Docs
 
 - [Chinese README](./doc/README-zh.md)
 - [Roadmap](./doc/ROADMAP.md)
 - [UBIQUITOUS_LANGUAGE.md](./UBIQUITOUS_LANGUAGE.md) - domain glossary
 
-## License
+## 📜 License
 
 MIT

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

@@ -4,4 +4,3 @@ export declare function getEmbedder(): Embedder;
 /** @internal test hook */
 export declare function resetEmbedderForTests(): void;
 export type { Embedder } from "./types.js";
-//# sourceMappingURL=factory.d.ts.map

package/dist/adapters/embed/factory.js

@@ -41,4 +41,3 @@ export function getEmbedder() {
 export function resetEmbedderForTests() {
     cachedEmbedder = undefined;
 }
-//# sourceMappingURL=factory.js.map

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

@@ -1,3 +1,2 @@
 import type { Embedder } from "./types.js";
 export declare function createHashEmbedder(dim: number): Embedder;
-//# sourceMappingURL=hash.d.ts.map

package/dist/adapters/embed/hash.js

@@ -23,4 +23,3 @@ export function createHashEmbedder(dim) {
         },
     };
 }
-//# sourceMappingURL=hash.js.map

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

@@ -1,3 +1,2 @@
 export declare function normalizeEmbedding(vec: Float32Array): Float32Array;
 export declare function assertEmbeddingDim(embedding: Float32Array, expectedDim: number, label: string): void;
-//# sourceMappingURL=normalize.d.ts.map

package/dist/adapters/embed/normalize.js

@@ -12,4 +12,3 @@ export function assertEmbeddingDim(embedding, expectedDim, label) {
         throw new Error(`${label} dimension mismatch: expected ${expectedDim}, got ${embedding.length}`);
     }
 }
-//# sourceMappingURL=normalize.js.map

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

@@ -5,4 +5,3 @@ export declare function createOllamaEmbedder(opts: {
     dim: number;
     timeoutMs: number;
 }): Embedder;
-//# sourceMappingURL=ollama.d.ts.map

package/dist/adapters/embed/ollama.js

@@ -28,4 +28,3 @@ export function createOllamaEmbedder(opts) {
         },
     };
 }
-//# sourceMappingURL=ollama.js.map

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

@@ -5,4 +5,3 @@ export declare function createOpenAiEmbedder(opts: {
     dim: number;
     timeoutMs: number;
 }): Embedder;
-//# sourceMappingURL=openai.d.ts.map

package/dist/adapters/embed/openai.js

@@ -27,4 +27,3 @@ export function createOpenAiEmbedder(opts) {
         },
     };
 }
-//# sourceMappingURL=openai.js.map

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

@@ -6,4 +6,3 @@ export type Embedder = {
     embed(text: string): Promise<Float32Array>;
     embedBatch(texts: string[]): Promise<Float32Array[]>;
 };
-//# sourceMappingURL=types.d.ts.map

package/dist/adapters/embed/types.js

@@ -1,2 +1 @@
 export {};
-//# sourceMappingURL=types.js.map

package/dist/adapters/http.d.ts

@@ -10,4 +10,3 @@ export declare class HttpRequestError extends Error {
     constructor(url: string, status: number, body: string);
 }
 export declare function postJson<T>(url: string, body: unknown, opts?: PostJsonOptions): Promise<T>;
-//# sourceMappingURL=http.d.ts.map

package/dist/adapters/http.js

@@ -28,4 +28,3 @@ export async function postJson(url, body, opts = {}) {
     }
     return JSON.parse(text);
 }
-//# sourceMappingURL=http.js.map

package/dist/adapters/index.d.ts

@@ -1,4 +1,3 @@
 export { HttpRequestError, postJson, type PostJsonOptions } from "./http.js";
 export { createEmbedder, getEmbedder, resetEmbedderForTests, type Embedder, } from "./embed/factory.js";
 export { createLlmClient, createOllamaLlmClient, createOpenAICompatLlmClient, createPiLlmClient, createStandaloneLlmClient, parseModelSpec, type LlmClient, } from "./llm/index.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/adapters/index.js

@@ -1,4 +1,3 @@
 export { HttpRequestError, postJson } from "./http.js";
 export { createEmbedder, getEmbedder, resetEmbedderForTests, } from "./embed/factory.js";
 export { createLlmClient, createOllamaLlmClient, createOpenAICompatLlmClient, createPiLlmClient, createStandaloneLlmClient, parseModelSpec, } from "./llm/index.js";
-//# sourceMappingURL=index.js.map

package/dist/adapters/llm/extractText.d.ts

@@ -2,4 +2,3 @@ export declare function extractTextFromResponse(content: Array<{
     type: string;
     text?: string;
 }>): string;
-//# sourceMappingURL=extractText.d.ts.map

package/dist/adapters/llm/extractText.js

@@ -4,4 +4,3 @@ export function extractTextFromResponse(content) {
         .map((block) => block.text ?? "")
         .join("\n");
 }
-//# sourceMappingURL=extractText.js.map

package/dist/adapters/llm/factory.d.ts

@@ -8,4 +8,3 @@ export type CreateLlmClientOptions = {
 };
 /** Best-effort LLM client for QueryIntent / consolidate. Returns null when unavailable. */
 export declare function createLlmClient(options?: CreateLlmClientOptions): Promise<LlmClient | null>;
-//# sourceMappingURL=factory.d.ts.map

package/dist/adapters/llm/factory.js

@@ -45,4 +45,3 @@ export async function createLlmClient(options = {}) {
     }
     return null;
 }
-//# sourceMappingURL=factory.js.map

package/dist/adapters/llm/index.d.ts

@@ -5,4 +5,3 @@ export { createOpenAICompatLlmClient, openaiCompatHealthCheck } from "./openai-c
 export { createPiLlmClient } from "./pi-ai.js";
 export { createStandaloneLlmClient } from "./standalone.js";
 export type { LlmClient, OllamaLlmConfig, OpenAICompatLlmConfig } from "./types.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/adapters/llm/index.js

@@ -4,4 +4,3 @@ export { createOllamaLlmClient, ollamaHealthCheck } from "./ollama.js";
 export { createOpenAICompatLlmClient, openaiCompatHealthCheck } from "./openai-compat.js";
 export { createPiLlmClient } from "./pi-ai.js";
 export { createStandaloneLlmClient } from "./standalone.js";
-//# sourceMappingURL=index.js.map

package/dist/adapters/llm/modelSpec.d.ts

@@ -7,4 +7,3 @@ export type ModelSpec = {
 export declare function parseModelSpec(spec: string | undefined, defaultProvider?: string, defaultModelId?: string): ModelSpec;
 export declare function isOllamaModelSpec(spec: string | undefined): boolean;
 export { DEFAULT_HELPER_MODEL_SPEC };
-//# sourceMappingURL=modelSpec.d.ts.map

package/dist/adapters/llm/modelSpec.js

@@ -18,4 +18,3 @@ export function isOllamaModelSpec(spec) {
     return !!spec?.trim().startsWith("ollama/");
 }
 export { DEFAULT_HELPER_MODEL_SPEC };
-//# sourceMappingURL=modelSpec.js.map

package/dist/adapters/llm/ollama.d.ts

@@ -1,4 +1,3 @@
 import type { LlmClient, OllamaLlmConfig } from "./types.js";
 export declare function ollamaHealthCheck(baseUrl: string): Promise<boolean>;
 export declare function createOllamaLlmClient(cfg: OllamaLlmConfig): LlmClient;
-//# sourceMappingURL=ollama.d.ts.map

package/dist/adapters/llm/ollama.js

@@ -29,4 +29,3 @@ export function createOllamaLlmClient(cfg) {
         },
     };
 }
-//# sourceMappingURL=ollama.js.map

package/dist/adapters/llm/openai-compat.d.ts

@@ -1,4 +1,3 @@
 import type { LlmClient, OpenAICompatLlmConfig } from "./types.js";
 export declare function openaiCompatHealthCheck(baseUrl: string): Promise<boolean>;
 export declare function createOpenAICompatLlmClient(cfg: OpenAICompatLlmConfig): LlmClient;
-//# sourceMappingURL=openai-compat.d.ts.map

package/dist/adapters/llm/openai-compat.js

@@ -33,4 +33,3 @@ export function createOpenAICompatLlmClient(cfg) {
         },
     };
 }
-//# sourceMappingURL=openai-compat.js.map

package/dist/adapters/llm/pi-ai.d.ts

@@ -2,4 +2,3 @@ import type { ExtensionContext } from "@earendil-works/pi-coding-agent";
 import type { LlmClient } from "./types.js";
 export declare function tryCreatePiLlmClient(ctx: ExtensionContext, modelSpec?: string): Promise<LlmClient | null>;
 export declare function createPiLlmClient(ctx: ExtensionContext, modelSpec?: string): LlmClient;
-//# sourceMappingURL=pi-ai.d.ts.map

package/dist/adapters/llm/pi-ai.js

@@ -57,4 +57,3 @@ export function createPiLlmClient(ctx, modelSpec) {
         },
     };
 }
-//# sourceMappingURL=pi-ai.js.map

package/dist/adapters/llm/standalone.d.ts

@@ -3,4 +3,3 @@ export declare function createStandaloneLlmClient(modelSpec: string, options?: {
     apiKey?: string;
     env?: NodeJS.ProcessEnv;
 }): LlmClient;
-//# sourceMappingURL=standalone.d.ts.map

package/dist/adapters/llm/standalone.js

@@ -41,4 +41,3 @@ export function createStandaloneLlmClient(modelSpec, options = {}) {
         },
     };
 }
-//# sourceMappingURL=standalone.js.map

package/dist/adapters/llm/types.d.ts

@@ -12,4 +12,3 @@ export type OpenAICompatLlmConfig = {
     apiKey?: string;
     timeoutMs?: number;
 };
-//# sourceMappingURL=types.d.ts.map

package/dist/adapters/llm/types.js

@@ -1,2 +1 @@
 export {};
-//# sourceMappingURL=types.js.map

package/dist/cli/init.d.ts

@@ -1,3 +1,2 @@
 import type { CliLog } from "./log.js";
 export declare function runInitCommand(agentDir: string, log: CliLog): Promise<number>;
-//# sourceMappingURL=init.d.ts.map

package/dist/cli/init.js

@@ -10,4 +10,3 @@ export async function runInitCommand(agentDir, log) {
     log.success("Created MEMORY.md from pi-memory template");
     return 0;
 }
-//# sourceMappingURL=init.js.map

package/dist/cli/jobs.d.ts

@@ -29,4 +29,3 @@ export declare function runConsolidateCommand(opts: {
     verbose: boolean;
     log: CliLog;
 }): Promise<number>;
-//# sourceMappingURL=jobs.d.ts.map

package/dist/cli/jobs.js

@@ -97,4 +97,3 @@ export async function runConsolidateCommand(opts) {
             return 1;
     }
 }
-//# sourceMappingURL=jobs.js.map

package/dist/cli/log.d.ts

@@ -11,4 +11,3 @@ export type CliLog = {
     line(label: string, value: string): void;
 };
 export declare function createCliLog(opts?: CliLogOptions): CliLog;
-//# sourceMappingURL=log.d.ts.map

package/dist/cli/log.js

@@ -29,4 +29,3 @@ export function createCliLog(opts = {}) {
         },
     };
 }
-//# sourceMappingURL=log.js.map

package/dist/cli/parseArgs.d.ts

@@ -32,4 +32,3 @@ export type ParsedCli = {
 };
 export declare function parseCliArgs(argv: string[]): ParsedCli;
 export declare const CLI_HELP = "pi-memory \u2014 standalone tools for Pi local memory\n\nUsage:\n  pi-memory init [options]\n  pi-memory status [options]\n  pi-memory maintenance [options]\n  pi-memory consolidate [options]\n  pi-memory drain-shutdown-queue [options]\n\nCommands:\n  init                    Create MEMORY.md from template when missing or empty\n  status                  Print MEMORY.md, sidecar, and vector index diagnostics\n  maintenance             Daily job: consolidate, then drain shutdown queue\n  consolidate             Run consolidate job (dedupe + optional reindex)\n  drain-shutdown-queue    Ingest durable facts from queued session shutdown metadata\n\nOptions:\n  --agent-dir PATH        Memory data directory (overrides PI_MEMORY_AGENT_DIR)\n  --verbose, -v           Extra stderr output (TTY colors when supported)\n\nConsolidate / maintenance:\n  --cron                  Daily OS cron slot (passes cronFired to shouldConsolidate)\n  --force                 Run consolidate even when shouldConsolidate is false\n\nEnvironment:\n  PI_MEMORY_ENV_FILE        Explicit .env path\n  PI_MEMORY_AGENT_DIR       Memory data root; default ~/.pi/pi-memory-data\n  PI_MEMORY_DEBUG=1         Debug stderr logs (extension preflight + CLI)\n  NO_COLOR                  Disable chalk colors\n\nExamples:\n  pi-memory init\n  pi-memory status\n  pi-memory maintenance --cron --verbose\n  pi-memory consolidate --force --verbose\n  pi-memory drain-shutdown-queue --verbose\n";
-//# sourceMappingURL=parseArgs.d.ts.map

package/dist/cli/parseArgs.js

@@ -124,4 +124,3 @@ Examples:
   pi-memory consolidate --force --verbose
   pi-memory drain-shutdown-queue --verbose
 `;
-//# sourceMappingURL=parseArgs.js.map

package/dist/cli/status.d.ts

@@ -41,4 +41,3 @@ export declare function formatMemoryStatusLines(report: MemoryStatusReport): str
 export declare function formatMemoryStatusTuiLines(report: MemoryStatusReport, palette: StatusPalette, theme: Theme): string[];
 export declare function printMemoryStatus(report: MemoryStatusReport, log: CliLog): void;
 export declare function runStatusCommand(agentDir: string, log: CliLog): Promise<number>;
-//# sourceMappingURL=status.d.ts.map

package/dist/cli/status.js

@@ -235,4 +235,3 @@ export async function runStatusCommand(agentDir, log) {
     printMemoryStatus(report, log);
     return 0;
 }
-//# sourceMappingURL=status.js.map

package/dist/cli/theme.d.ts

@@ -11,4 +11,3 @@ export declare const theme: {
     ok: (text: string, stream?: NodeJS.WriteStream) => string;
     bad: (text: string, stream?: NodeJS.WriteStream) => string;
 };
-//# sourceMappingURL=theme.d.ts.map

package/dist/cli/theme.js

@@ -17,4 +17,3 @@ export const theme = {
     ok: (text, stream) => paint(chalk.green, text, stream),
     bad: (text, stream) => paint(chalk.red, text, stream),
 };
-//# sourceMappingURL=theme.js.map

package/dist/cli.d.ts

@@ -1,3 +1,2 @@
 #!/usr/bin/env node
 export {};
-//# sourceMappingURL=cli.d.ts.map

package/dist/cli.js

@@ -79,4 +79,3 @@ main().then((code) => process.exit(code), (error) => {
     log.error(error instanceof Error ? error.message : String(error));
     process.exit(1);
 });
-//# sourceMappingURL=cli.js.map

package/dist/commands/index.d.ts

@@ -3,4 +3,3 @@ import type { CommandDeps } from "./types.js";
 export type { CommandDeps, MemoryStatusCommandDeps, RememberCommandDeps } from "./types.js";
 export { parseRememberArgs } from "./parseRememberArgs.js";
 export declare function registerCommands(pi: ExtensionAPI, deps: CommandDeps): void;
-//# sourceMappingURL=index.d.ts.map

package/dist/commands/index.js

@@ -11,4 +11,3 @@ export function registerCommands(pi, deps) {
         handler: createMemoryStatusCommand(deps),
     });
 }
-//# sourceMappingURL=index.js.map

package/dist/commands/parseMemoryStatusArgs.d.ts

@@ -1,3 +1,2 @@
 export type MemoryStatusAction = "toggle" | "refresh" | "hide" | "expand" | "collapse";
 export declare function parseMemoryStatusArgs(args: string | string[]): MemoryStatusAction;
-//# sourceMappingURL=parseMemoryStatusArgs.d.ts.map

package/dist/commands/parseMemoryStatusArgs.js

@@ -12,4 +12,3 @@ export function parseMemoryStatusArgs(args) {
         return "collapse";
     return "toggle";
 }
-//# sourceMappingURL=parseMemoryStatusArgs.js.map

package/dist/commands/parseRememberArgs.d.ts

@@ -7,4 +7,3 @@ export type ParsedRememberArgs = {
 };
 /** Parse `/remember [section]? content`. Default section: Findings. */
 export declare function parseRememberArgs(raw: string | string[]): ParsedRememberArgs;
-//# sourceMappingURL=parseRememberArgs.d.ts.map

package/dist/commands/parseRememberArgs.js

@@ -43,4 +43,3 @@ export function parseRememberArgs(raw) {
     }
     return { section: "Findings", content: text };
 }
-//# sourceMappingURL=parseRememberArgs.js.map

package/dist/commands/remember.d.ts

@@ -5,4 +5,3 @@ export type RememberCommandDeps = {
     onRemembered?(): Promise<void>;
 };
 export declare function createRememberCommand(deps: RememberCommandDeps): (args: string | string[], ctx: ExtensionCommandContext) => Promise<void>;
-//# sourceMappingURL=remember.d.ts.map

package/dist/commands/remember.js

@@ -27,4 +27,3 @@ export function createRememberCommand(deps) {
         }
     };
 }
-//# sourceMappingURL=remember.js.map

package/dist/commands/status.d.ts

@@ -7,4 +7,3 @@ export declare function resetMemoryStatusWidgetState(): void;
 export declare function createMemoryStatusCommand(deps: MemoryStatusCommandDeps): (args: string | string[], ctx: ExtensionCommandContext) => Promise<void>;
 export declare function getMemoryStatusWidgetStateForTest(): MemoryStatusWidgetState | null;
 export declare function setMemoryStatusWidgetStateForTest(state: MemoryStatusWidgetState | null): void;
-//# sourceMappingURL=status.d.ts.map

package/dist/commands/status.js

@@ -78,4 +78,3 @@ export function getMemoryStatusWidgetStateForTest() {
 export function setMemoryStatusWidgetStateForTest(state) {
     memoryStatusWidgetState = state;
 }
-//# sourceMappingURL=status.js.map

package/dist/commands/types.d.ts

@@ -7,4 +7,3 @@ export type MemoryStatusCommandDeps = {
     getAgentDir(): string | null;
 };
 export type CommandDeps = RememberCommandDeps & MemoryStatusCommandDeps;
-//# sourceMappingURL=types.d.ts.map

package/dist/commands/types.js

@@ -1,2 +1 @@
 export {};
-//# sourceMappingURL=types.js.map