@helloworlkd/pam-cli 0.1.16

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 PAM contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,44 @@
+# Portable AI Memory (PAM)
+
+CLI for persistent, portable, model-independent AI memory.
+
+## Installation
+
+```bash
+npm install -g @helloworlkd/pam-cli
+```
+
+This installs the `pam` command.
+
+For future global updates, prefer:
+
+```bash
+pam upgrade
+```
+
+This stops running PAM UI/MCP services before invoking npm, which avoids
+Windows native-file locks during updates.
+
+For automatic project bootstrap:
+
+```bash
+cd your-project
+npm install -D @helloworlkd/pam-cli
+```
+
+Local install creates `.ai-memory/` and supported agent/IDE integration files.
+After the first install, reload VS Code/Cursor windows, start a new Claude
+Code/OpenCode session, or restart/open a new Codex session so the client reloads
+project config.
+
+## Quick Start
+
+```bash
+pam init
+pam add -t decision -c "Use SQLite for the local pam index"
+pam checkpoint --summary "Finished CLI setup" --fact "PAM stores project memory in .ai-memory" --concept Architecture
+pam search "SQLite"
+pam server start
+```
+
+See the full documentation at https://github.com/supersekai64/pam.

package/dist/commands/add.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare function registerAddCommand(program: Command): void;
+//# sourceMappingURL=add.d.ts.map

package/dist/commands/add.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"add.d.ts","sourceRoot":"","sources":["../../src/commands/add.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAQnC,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,QA0ClD"}

package/dist/commands/add.js

@@ -0,0 +1,42 @@
+import { createMemory, getProjectMemoryPath, MEMORY_TYPES, assertSalience, } from '@helloworlkd/pam-core';
+export function registerAddCommand(program) {
+    program
+        .command('add')
+        .description('Add a new memory')
+        .requiredOption('-t, --type <type>', `Memory type (${MEMORY_TYPES.join(', ')})`)
+        .requiredOption('-c, --content <content>', 'Memory content')
+        .option('--title <title>', 'Short display title')
+        .option('--tags <tags>', 'Comma-separated tags')
+        .option('--concepts <concepts>', 'Comma-separated broad canonical concepts')
+        .option('--salience <score>', 'Importance score (0-1, default: 0.5)', '0.5')
+        .action(async (options) => {
+        if (!MEMORY_TYPES.includes(options.type)) {
+            console.error(`Invalid type. Must be one of: ${MEMORY_TYPES.join(', ')}`);
+            process.exit(1);
+        }
+        const basePath = getProjectMemoryPath(process.cwd());
+        const tags = options.tags ? options.tags.split(',').map((t) => t.trim()) : [];
+        const concepts = options.concepts
+            ? options.concepts.split(',').map((concept) => concept.trim())
+            : undefined;
+        let salience;
+        try {
+            salience = assertSalience(options.salience);
+        }
+        catch (error) {
+            console.error(error instanceof Error ? error.message : String(error));
+            process.exit(1);
+        }
+        const memory = await createMemory(basePath, {
+            type: options.type,
+            scope: 'project',
+            title: options.title,
+            content: options.content,
+            tags,
+            concepts,
+            salience,
+        });
+        console.log(`Memory created: ${memory.metadata.id}`);
+    });
+}
+//# sourceMappingURL=add.js.map

package/dist/commands/add.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"add.js","sourceRoot":"","sources":["../../src/commands/add.ts"],"names":[],"mappings":"AACA,OAAO,EACL,YAAY,EACZ,oBAAoB,EACpB,YAAY,EACZ,cAAc,GACf,MAAM,uBAAuB,CAAA;AAE9B,MAAM,UAAU,kBAAkB,CAAC,OAAgB;IACjD,OAAO;SACJ,OAAO,CAAC,KAAK,CAAC;SACd,WAAW,CAAC,kBAAkB,CAAC;SAC/B,cAAc,CAAC,mBAAmB,EAAE,gBAAgB,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;SAC/E,cAAc,CAAC,yBAAyB,EAAE,gBAAgB,CAAC;SAC3D,MAAM,CAAC,iBAAiB,EAAE,qBAAqB,CAAC;SAChD,MAAM,CAAC,eAAe,EAAE,sBAAsB,CAAC;SAC/C,MAAM,CAAC,uBAAuB,EAAE,0CAA0C,CAAC;SAC3E,MAAM,CAAC,oBAAoB,EAAE,sCAAsC,EAAE,KAAK,CAAC;SAC3E,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;QACxB,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YACzC,OAAO,CAAC,KAAK,CAAC,iCAAiC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;YACzE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QACjB,CAAC;QAED,MAAM,QAAQ,GAAG,oBAAoB,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAA;QAEpD,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;QACrF,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ;YAC/B,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,OAAe,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;YACtE,CAAC,CAAC,SAAS,CAAA;QACb,IAAI,QAAgB,CAAA;QACpB,IAAI,CAAC;YACH,QAAQ,GAAG,cAAc,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAA;QAC7C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAA;YACrE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QACjB,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,QAAQ,EAAE;YAC1C,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,KAAK,EAAE,SAAS;YAChB,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,IAAI;YACJ,QAAQ;YACR,QAAQ;SACT,CAAC,CAAA;QAEF,OAAO,CAAC,GAAG,CAAC,mBAAmB,MAAM,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC,CAAA;IACtD,CAAC,CAAC,CAAA;AACN,CAAC"}

package/dist/commands/approve.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare function registerApproveCommand(program: Command): void;
+//# sourceMappingURL=approve.d.ts.map

package/dist/commands/approve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"approve.d.ts","sourceRoot":"","sources":["../../src/commands/approve.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAGnC,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,QAgBtD"}

package/dist/commands/approve.js

@@ -0,0 +1,16 @@
+import { approveMemory, getProjectMemoryPath } from '@helloworlkd/pam-core';
+export function registerApproveCommand(program) {
+    program
+        .command('approve <id>')
+        .description('Approve a proposed memory')
+        .action(async (id) => {
+        const basePath = getProjectMemoryPath(process.cwd());
+        const approved = await approveMemory(basePath, id);
+        if (!approved) {
+            console.error(`Memory not found or not proposed: ${id}`);
+            process.exit(1);
+        }
+        console.log(`Memory approved: ${id}`);
+    });
+}
+//# sourceMappingURL=approve.js.map

package/dist/commands/approve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"approve.js","sourceRoot":"","sources":["../../src/commands/approve.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAA;AAE3E,MAAM,UAAU,sBAAsB,CAAC,OAAgB;IACrD,OAAO;SACJ,OAAO,CAAC,cAAc,CAAC;SACvB,WAAW,CAAC,2BAA2B,CAAC;SACxC,MAAM,CAAC,KAAK,EAAE,EAAE,EAAE,EAAE;QACnB,MAAM,QAAQ,GAAG,oBAAoB,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAA;QAEpD,MAAM,QAAQ,GAAG,MAAM,aAAa,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAA;QAElD,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO,CAAC,KAAK,CAAC,qCAAqC,EAAE,EAAE,CAAC,CAAA;YACxD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QACjB,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,oBAAoB,EAAE,EAAE,CAAC,CAAA;IACvC,CAAC,CAAC,CAAA;AACN,CAAC"}

package/dist/commands/archive.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare function registerArchiveCommand(program: Command): void;
+//# sourceMappingURL=archive.d.ts.map

package/dist/commands/archive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"archive.d.ts","sourceRoot":"","sources":["../../src/commands/archive.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAGnC,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,QAgBtD"}

package/dist/commands/archive.js

@@ -0,0 +1,16 @@
+import { archiveMemory, getProjectMemoryPath } from '@helloworlkd/pam-core';
+export function registerArchiveCommand(program) {
+    program
+        .command('archive <id>')
+        .description('Archive a memory')
+        .action(async (id) => {
+        const basePath = getProjectMemoryPath(process.cwd());
+        const archived = await archiveMemory(basePath, id);
+        if (!archived) {
+            console.error(`Memory not found or already archived: ${id}`);
+            process.exit(1);
+        }
+        console.log(`Memory archived: ${id}`);
+    });
+}
+//# sourceMappingURL=archive.js.map

package/dist/commands/archive.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"archive.js","sourceRoot":"","sources":["../../src/commands/archive.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAA;AAE3E,MAAM,UAAU,sBAAsB,CAAC,OAAgB;IACrD,OAAO;SACJ,OAAO,CAAC,cAAc,CAAC;SACvB,WAAW,CAAC,kBAAkB,CAAC;SAC/B,MAAM,CAAC,KAAK,EAAE,EAAE,EAAE,EAAE;QACnB,MAAM,QAAQ,GAAG,oBAAoB,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAA;QAEpD,MAAM,QAAQ,GAAG,MAAM,aAAa,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAA;QAElD,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO,CAAC,KAAK,CAAC,yCAAyC,EAAE,EAAE,CAAC,CAAA;YAC5D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QACjB,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,oBAAoB,EAAE,EAAE,CAAC,CAAA;IACvC,CAAC,CAAC,CAAA;AACN,CAAC"}

package/dist/commands/audit.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare function registerAuditCommand(program: Command): void;
+//# sourceMappingURL=audit.d.ts.map

package/dist/commands/audit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit.d.ts","sourceRoot":"","sources":["../../src/commands/audit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAGnC,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,QAqEpD"}

package/dist/commands/audit.js

@@ -0,0 +1,62 @@
+import { listMemories, MemoryIndex, getProjectMemoryPath } from '@helloworlkd/pam-core';
+export function registerAuditCommand(program) {
+    program
+        .command('audit')
+        .description('Display memory statistics and audit information')
+        .action(async () => {
+        const basePath = getProjectMemoryPath(process.cwd());
+        const memories = await listMemories(basePath);
+        const total = memories.length;
+        const active = memories.filter((m) => m.metadata.status === 'active').length;
+        const deleted = memories.filter((m) => m.metadata.status === 'deleted').length;
+        const archived = memories.filter((m) => m.metadata.status === 'archived').length;
+        const byType = {};
+        const byScope = {};
+        const allTags = {};
+        for (const memory of memories) {
+            byType[memory.metadata.type] = (byType[memory.metadata.type] || 0) + 1;
+            byScope[memory.metadata.scope] = (byScope[memory.metadata.scope] || 0) + 1;
+            for (const tag of memory.metadata.tags) {
+                allTags[tag] = (allTags[tag] || 0) + 1;
+            }
+        }
+        console.log('\n=== Memory Audit ===\n');
+        console.log(`Total memories: ${total}`);
+        console.log(`  Active: ${active}`);
+        console.log(`  Deleted: ${deleted}`);
+        console.log(`  Archived: ${archived}`);
+        if (Object.keys(byType).length > 0) {
+            console.log('\nBy type:');
+            for (const [type, count] of Object.entries(byType).sort((a, b) => b[1] - a[1])) {
+                console.log(`  ${type}: ${count}`);
+            }
+        }
+        if (Object.keys(byScope).length > 0) {
+            console.log('\nBy scope:');
+            for (const [scope, count] of Object.entries(byScope).sort((a, b) => b[1] - a[1])) {
+                console.log(`  ${scope}: ${count}`);
+            }
+        }
+        if (Object.keys(allTags).length > 0) {
+            console.log('\nTop tags:');
+            const sortedTags = Object.entries(allTags)
+                .sort((a, b) => b[1] - a[1])
+                .slice(0, 10);
+            for (const [tag, count] of sortedTags) {
+                console.log(`  ${tag}: ${count}`);
+            }
+        }
+        try {
+            const index = new MemoryIndex(basePath);
+            const stats = index.getStats();
+            index.close();
+            console.log(`\nIndex status:`);
+            console.log(`  Indexed: ${stats.total}`);
+            console.log(`  Active in index: ${stats.active}`);
+        }
+        catch {
+            console.log('\nIndex status: not available');
+        }
+    });
+}
+//# sourceMappingURL=audit.js.map

package/dist/commands/audit.js.map

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

package/dist/commands/capture.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare function registerCaptureCommand(program: Command): void;
+//# sourceMappingURL=capture.d.ts.map

package/dist/commands/capture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capture.d.ts","sourceRoot":"","sources":["../../src/commands/capture.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAQnC,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,QAyCtD"}

package/dist/commands/capture.js

@@ -0,0 +1,39 @@
+import { loadAutoCaptureConfig, saveAutoCaptureConfig, getProjectMemoryPath, } from '@helloworlkd/pam-core';
+export function registerCaptureCommand(program) {
+    const capture = program.command('capture').description('Auto-capture configuration');
+    capture
+        .command('show')
+        .description('Show current auto-capture configuration')
+        .action(async () => {
+        const basePath = getProjectMemoryPath(process.cwd());
+        const config = await loadAutoCaptureConfig(basePath);
+        console.log(`Mode: ${config.mode}`);
+        if (config.rules && config.rules.length > 0) {
+            console.log('\nRules:');
+            for (const rule of config.rules) {
+                console.log(`  - ${JSON.stringify(rule)}`);
+            }
+        }
+        if (config.exclude && config.exclude.length > 0) {
+            console.log('\nExclude:');
+            for (const rule of config.exclude) {
+                console.log(`  - ${JSON.stringify(rule)}`);
+            }
+        }
+    });
+    capture
+        .command('set <mode>')
+        .description('Set auto-capture mode (manual, assisted, auto)')
+        .action(async (mode) => {
+        if (!['manual', 'assisted', 'auto'].includes(mode)) {
+            console.error('Invalid mode. Must be one of: manual, assisted, auto');
+            process.exit(1);
+        }
+        const basePath = getProjectMemoryPath(process.cwd());
+        const config = await loadAutoCaptureConfig(basePath);
+        config.mode = mode;
+        await saveAutoCaptureConfig(basePath, config);
+        console.log(`Auto-capture mode set to: ${mode}`);
+    });
+}
+//# sourceMappingURL=capture.js.map

package/dist/commands/capture.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capture.js","sourceRoot":"","sources":["../../src/commands/capture.ts"],"names":[],"mappings":"AACA,OAAO,EACL,qBAAqB,EACrB,qBAAqB,EACrB,oBAAoB,GAErB,MAAM,uBAAuB,CAAA;AAE9B,MAAM,UAAU,sBAAsB,CAAC,OAAgB;IACrD,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,WAAW,CAAC,4BAA4B,CAAC,CAAA;IAEpF,OAAO;SACJ,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,yCAAyC,CAAC;SACtD,MAAM,CAAC,KAAK,IAAI,EAAE;QACjB,MAAM,QAAQ,GAAG,oBAAoB,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAA;QACpD,MAAM,MAAM,GAAG,MAAM,qBAAqB,CAAC,QAAQ,CAAC,CAAA;QAEpD,OAAO,CAAC,GAAG,CAAC,SAAS,MAAM,CAAC,IAAI,EAAE,CAAC,CAAA;QACnC,IAAI,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC5C,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;YACvB,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;gBAChC,OAAO,CAAC,GAAG,CAAC,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;YAC5C,CAAC;QACH,CAAC;QACD,IAAI,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAChD,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAA;YACzB,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;gBAClC,OAAO,CAAC,GAAG,CAAC,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;YAC5C,CAAC;QACH,CAAC;IACH,CAAC,CAAC,CAAA;IAEJ,OAAO;SACJ,OAAO,CAAC,YAAY,CAAC;SACrB,WAAW,CAAC,gDAAgD,CAAC;SAC7D,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;QACrB,IAAI,CAAC,CAAC,QAAQ,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YACnD,OAAO,CAAC,KAAK,CAAC,sDAAsD,CAAC,CAAA;YACrE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QACjB,CAAC;QAED,MAAM,QAAQ,GAAG,oBAAoB,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAA;QACpD,MAAM,MAAM,GAAG,MAAM,qBAAqB,CAAC,QAAQ,CAAC,CAAA;QACpD,MAAM,CAAC,IAAI,GAAG,IAAuB,CAAA;QAErC,MAAM,qBAAqB,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAA;QAC7C,OAAO,CAAC,GAAG,CAAC,6BAA6B,IAAI,EAAE,CAAC,CAAA;IAClD,CAAC,CAAC,CAAA;AACN,CAAC"}

package/dist/commands/checkpoint.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare function registerCheckpointCommand(program: Command): void;
+//# sourceMappingURL=checkpoint.d.ts.map

package/dist/commands/checkpoint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkpoint.d.ts","sourceRoot":"","sources":["../../src/commands/checkpoint.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAQnC,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,OAAO,QA+DzD"}

package/dist/commands/checkpoint.js

@@ -0,0 +1,48 @@
+import { memoryCheckpoint } from '@helloworlkd/pam-protocol';
+function collect(value, previous = []) {
+    return [...previous, value];
+}
+export function registerCheckpointCommand(program) {
+    program
+        .command('checkpoint')
+        .description('Submit durable session learnings as a structured checkpoint')
+        .option('--summary <summary>', 'Short summary of completed work')
+        .option('--decision <decision>', 'Durable technical decision (repeatable)', collect, [])
+        .option('--fact <fact>', 'Reusable project fact (repeatable)', collect, [])
+        .option('--preference <preference>', 'Durable UX or workflow preference (repeatable)', collect, [])
+        .option('--mistake <mistake>', 'Reusable lesson from a correction or bug (repeatable)', collect, [])
+        .option('--task <task>', 'Follow-up task (repeatable)', collect, [])
+        .option('--concept <concept>', 'Broad canonical concept for this checkpoint (repeatable)', collect, [])
+        .option('--agent <agent>', 'Agent name to tag checkpoint memories')
+        .option('--model <model>', 'Model name to tag checkpoint memories')
+        .option('--session-id <session_id>', 'Session identifier for hook/audit records')
+        .option('--json', 'Print the raw checkpoint result as JSON')
+        .action(async (options) => {
+        const result = await memoryCheckpoint({
+            summary: options.summary,
+            decisions: options.decision,
+            facts: options.fact,
+            preferences: options.preference,
+            mistakes: options.mistake,
+            tasks: options.task,
+            concepts: options.concept,
+            agent: options.agent,
+            model: options.model,
+            session_id: options.sessionId,
+            source: options.agent ? `cli-checkpoint:${options.agent}` : 'cli-checkpoint',
+        }, { cwd: process.cwd() });
+        if (options.json) {
+            console.log(JSON.stringify(result, null, 2));
+            return;
+        }
+        if (result.status === 'skipped') {
+            console.log(`Checkpoint skipped: ${result.reason}`);
+            return;
+        }
+        console.log(`Checkpoint recorded: ${result.created.length} ${result.status} memories`);
+        for (const memory of result.created) {
+            console.log(`- ${memory.metadata.id} (${memory.metadata.type})`);
+        }
+    });
+}
+//# sourceMappingURL=checkpoint.js.map

package/dist/commands/checkpoint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkpoint.js","sourceRoot":"","sources":["../../src/commands/checkpoint.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAA;AAE5D,SAAS,OAAO,CAAC,KAAa,EAAE,WAAqB,EAAE;IACrD,OAAO,CAAC,GAAG,QAAQ,EAAE,KAAK,CAAC,CAAA;AAC7B,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,OAAgB;IACxD,OAAO;SACJ,OAAO,CAAC,YAAY,CAAC;SACrB,WAAW,CAAC,6DAA6D,CAAC;SAC1E,MAAM,CAAC,qBAAqB,EAAE,iCAAiC,CAAC;SAChE,MAAM,CAAC,uBAAuB,EAAE,yCAAyC,EAAE,OAAO,EAAE,EAAE,CAAC;SACvF,MAAM,CAAC,eAAe,EAAE,oCAAoC,EAAE,OAAO,EAAE,EAAE,CAAC;SAC1E,MAAM,CACL,2BAA2B,EAC3B,gDAAgD,EAChD,OAAO,EACP,EAAE,CACH;SACA,MAAM,CACL,qBAAqB,EACrB,uDAAuD,EACvD,OAAO,EACP,EAAE,CACH;SACA,MAAM,CAAC,eAAe,EAAE,6BAA6B,EAAE,OAAO,EAAE,EAAE,CAAC;SACnE,MAAM,CACL,qBAAqB,EACrB,0DAA0D,EAC1D,OAAO,EACP,EAAE,CACH;SACA,MAAM,CAAC,iBAAiB,EAAE,uCAAuC,CAAC;SAClE,MAAM,CAAC,iBAAiB,EAAE,uCAAuC,CAAC;SAClE,MAAM,CAAC,2BAA2B,EAAE,2CAA2C,CAAC;SAChF,MAAM,CAAC,QAAQ,EAAE,yCAAyC,CAAC;SAC3D,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;QACxB,MAAM,MAAM,GAAG,MAAM,gBAAgB,CACnC;YACE,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,SAAS,EAAE,OAAO,CAAC,QAAQ;YAC3B,KAAK,EAAE,OAAO,CAAC,IAAI;YACnB,WAAW,EAAE,OAAO,CAAC,UAAU;YAC/B,QAAQ,EAAE,OAAO,CAAC,OAAO;YACzB,KAAK,EAAE,OAAO,CAAC,IAAI;YACnB,QAAQ,EAAE,OAAO,CAAC,OAAO;YACzB,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,UAAU,EAAE,OAAO,CAAC,SAAS;YAC7B,MAAM,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,kBAAkB,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,gBAAgB;SAC7E,EACD,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,EAAE,CACvB,CAAA;QAED,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;YACjB,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAA;YAC5C,OAAM;QACR,CAAC;QAED,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAChC,OAAO,CAAC,GAAG,CAAC,uBAAuB,MAAM,CAAC,MAAM,EAAE,CAAC,CAAA;YACnD,OAAM;QACR,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,wBAAwB,MAAM,CAAC,OAAO,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,WAAW,CAAC,CAAA;QACtF,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACpC,OAAO,CAAC,GAAG,CAAC,KAAK,MAAM,CAAC,QAAQ,CAAC,EAAE,KAAK,MAAM,CAAC,QAAQ,CAAC,IAAI,GAAG,CAAC,CAAA;QAClE,CAAC;IACH,CAAC,CAAC,CAAA;AACN,CAAC"}

package/dist/commands/context.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare function registerContextCommand(program: Command): void;
+//# sourceMappingURL=context.d.ts.map

package/dist/commands/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/commands/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAGnC,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,QAoCtD"}

package/dist/commands/context.js

@@ -0,0 +1,35 @@
+import { getProjectMemoryPath, compileContext, writeCompiledContext } from '@helloworlkd/pam-core';
+export function registerContextCommand(program) {
+    program
+        .command('context')
+        .description('Compile context from all memory sources')
+        .option('-q, --query <query>', 'Search query to include relevant memories')
+        .option('--max-tokens <tokens>', 'Maximum tokens in compiled context', '4000')
+        .option('--no-project', 'Exclude project memory')
+        .option('--no-search', 'Exclude search results')
+        .option('-o, --output', 'Write compiled context to compiled-context.md')
+        .action(async (options) => {
+        const projectBasePath = getProjectMemoryPath(process.cwd());
+        const maxTokens = parseInt(options.maxTokens, 10);
+        console.log('Compiling context...');
+        const compiled = await compileContext(projectBasePath, {
+            query: options.query,
+            maxTokens,
+            includeProject: options.project,
+            includeSearch: options.search,
+        });
+        if (options.output) {
+            const outputPath = await writeCompiledContext(projectBasePath, compiled);
+            console.log(`\nContext written to: ${outputPath}`);
+        }
+        else {
+            console.log('\n' + compiled.content);
+        }
+        console.log(`\n---`);
+        console.log(`Total tokens: ~${compiled.tokenCount}`);
+        console.log(`Sources:`);
+        console.log(`  Project: ${compiled.sources.project.length} memories`);
+        console.log(`  Search: ${compiled.sources.search.length} memories`);
+    });
+}
+//# sourceMappingURL=context.js.map

package/dist/commands/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/commands/context.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAA;AAElG,MAAM,UAAU,sBAAsB,CAAC,OAAgB;IACrD,OAAO;SACJ,OAAO,CAAC,SAAS,CAAC;SAClB,WAAW,CAAC,yCAAyC,CAAC;SACtD,MAAM,CAAC,qBAAqB,EAAE,2CAA2C,CAAC;SAC1E,MAAM,CAAC,uBAAuB,EAAE,oCAAoC,EAAE,MAAM,CAAC;SAC7E,MAAM,CAAC,cAAc,EAAE,wBAAwB,CAAC;SAChD,MAAM,CAAC,aAAa,EAAE,wBAAwB,CAAC;SAC/C,MAAM,CAAC,cAAc,EAAE,+CAA+C,CAAC;SACvE,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;QACxB,MAAM,eAAe,GAAG,oBAAoB,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAA;QAE3D,MAAM,SAAS,GAAG,QAAQ,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAA;QAEjD,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAA;QAEnC,MAAM,QAAQ,GAAG,MAAM,cAAc,CAAC,eAAe,EAAE;YACrD,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,SAAS;YACT,cAAc,EAAE,OAAO,CAAC,OAAO;YAC/B,aAAa,EAAE,OAAO,CAAC,MAAM;SAC9B,CAAC,CAAA;QAEF,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YACnB,MAAM,UAAU,GAAG,MAAM,oBAAoB,CAAC,eAAe,EAAE,QAAQ,CAAC,CAAA;YACxE,OAAO,CAAC,GAAG,CAAC,yBAAyB,UAAU,EAAE,CAAC,CAAA;QACpD,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAA;QACtC,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;QACpB,OAAO,CAAC,GAAG,CAAC,kBAAkB,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAA;QACpD,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;QACvB,OAAO,CAAC,GAAG,CAAC,cAAc,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,WAAW,CAAC,CAAA;QACrE,OAAO,CAAC,GAAG,CAAC,aAAa,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,WAAW,CAAC,CAAA;IACrE,CAAC,CAAC,CAAA;AACN,CAAC"}

package/dist/commands/debug.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare function registerDebugCommand(program: Command): void;
+//# sourceMappingURL=debug.d.ts.map

package/dist/commands/debug.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug.d.ts","sourceRoot":"","sources":["../../src/commands/debug.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAanC,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,QAuDpD"}

package/dist/commands/debug.js

@@ -0,0 +1,58 @@
+import { getMemoryDebugStatus, getProjectMemoryPath, setMemoryDebugMode, } from '@helloworlkd/pam-core';
+export function registerDebugCommand(program) {
+    const debug = program.command('debug').description('Configure project pam debug logging');
+    debug
+        .command('on')
+        .description('Enable pam debug logging')
+        .option('--agent <agent>', 'Agent name to record, e.g. codex, claude-code')
+        .option('--model <model>', 'Model name to record, e.g. gpt-5, claude-sonnet')
+        .option('--session <session>', 'Session id to record')
+        .action(async (options) => {
+        const basePath = resolveBasePath(options);
+        const status = await setMemoryDebugMode(basePath, true, {
+            agent: options.agent,
+            model: options.model,
+            session_id: options.session,
+        });
+        console.log('Memory debug logging enabled.');
+        console.log(`Log file: ${status.logPath}`);
+    });
+    debug
+        .command('off')
+        .description('Disable pam debug logging')
+        .action(async (options) => {
+        const basePath = resolveBasePath(options);
+        const status = await setMemoryDebugMode(basePath, false);
+        console.log('Memory debug logging disabled.');
+        console.log(`Log file: ${status.logPath}`);
+    });
+    debug
+        .command('status')
+        .description('Show pam debug logging status')
+        .action(async (options) => {
+        const basePath = resolveBasePath(options);
+        const status = await getMemoryDebugStatus(basePath);
+        console.log(`Memory debug: ${status.enabled ? 'enabled' : 'disabled'}`);
+        console.log(`Config: ${status.configPath}`);
+        console.log(`Log file: ${status.logPath}`);
+        if (status.config?.agent)
+            console.log(`Agent: ${status.config.agent}`);
+        if (status.config?.model)
+            console.log(`Model: ${status.config.model}`);
+        if (status.config?.session_id)
+            console.log(`Session: ${status.config.session_id}`);
+    });
+    debug
+        .command('path')
+        .description('Print the pam debug log path')
+        .action(async (options) => {
+        const basePath = resolveBasePath(options);
+        const status = await getMemoryDebugStatus(basePath);
+        console.log(status.logPath);
+    });
+}
+function resolveBasePath(options) {
+    void options;
+    return getProjectMemoryPath(process.cwd());
+}
+//# sourceMappingURL=debug.js.map

package/dist/commands/debug.js.map

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

package/dist/commands/decay.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare function registerDecayCommand(program: Command): void;
+//# sourceMappingURL=decay.d.ts.map

package/dist/commands/decay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decay.d.ts","sourceRoot":"","sources":["../../src/commands/decay.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAGnC,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,QAuDpD"}

package/dist/commands/decay.js

@@ -0,0 +1,73 @@
+import { forgetSweep, getProjectMemoryPath } from '@helloworlkd/pam-core';
+export function registerDecayCommand(program) {
+    const decay = program.command('decay').description('Memory decay management');
+    decay
+        .command('sweep')
+        .description('Run forget sweep (soft-delete memories below threshold)')
+        .option('--lambda <lambda>', 'Temporal decay rate', '0.02')
+        .option('--sigma <sigma>', 'Access reinforcement weight', '0.6')
+        .option('--mu <mu>', 'Access decay rate', '0.04')
+        .option('--threshold <threshold>', 'Cold threshold', '0.20')
+        .option('--hard-delete-days <days>', 'Days before hard-delete', '180')
+        .option('--dry-run', 'Preview without making changes')
+        .action(async (options) => {
+        const basePath = getProjectMemoryPath(process.cwd());
+        let config;
+        try {
+            config = {
+                lambda: parseMinimum(options.lambda, 'lambda', 0),
+                sigma: parseMinimum(options.sigma, 'sigma', 0),
+                mu: parseMinimum(options.mu, 'mu', 0),
+                coldThreshold: parseRange(options.threshold, 'threshold', 0, 1),
+                hardDeleteAfterDays: parseIntegerMinimum(options.hardDeleteDays, 'hard-delete-days', 0),
+            };
+        }
+        catch (error) {
+            console.error(error instanceof Error ? error.message : String(error));
+            process.exit(1);
+        }
+        console.log('Running forget sweep...');
+        if (options.dryRun) {
+            console.log('(dry run - no changes will be made)\n');
+        }
+        const result = await forgetSweep(basePath, config, options.dryRun);
+        console.log(`\nResults:`);
+        console.log(`  Soft-deleted: ${result.softDeleted.length}`);
+        console.log(`  Hard-deleted: ${result.hardDeleted.length}`);
+        console.log(`  Preserved: ${result.preserved.length}`);
+        if (result.softDeleted.length > 0) {
+            console.log(`\nSoft-deleted memories:`);
+            result.softDeleted.forEach((m) => {
+                console.log(`  - ${m.metadata.id}: ${m.content.substring(0, 60)}...`);
+            });
+        }
+        if (result.hardDeleted.length > 0) {
+            console.log(`\nHard-deleted memories:`);
+            result.hardDeleted.forEach((m) => {
+                console.log(`  - ${m.metadata.id}: ${m.content.substring(0, 60)}...`);
+            });
+        }
+    });
+}
+function parseMinimum(value, name, minimum) {
+    const number = Number(value);
+    if (!Number.isFinite(number) || number < minimum) {
+        throw new Error(`Invalid ${name}: ${value}. Must be >= ${minimum}.`);
+    }
+    return number;
+}
+function parseRange(value, name, minimum, maximum) {
+    const number = Number(value);
+    if (!Number.isFinite(number) || number < minimum || number > maximum) {
+        throw new Error(`Invalid ${name}: ${value}. Must be between ${minimum} and ${maximum}.`);
+    }
+    return number;
+}
+function parseIntegerMinimum(value, name, minimum) {
+    const number = Number(value);
+    if (!Number.isInteger(number) || number < minimum) {
+        throw new Error(`Invalid ${name}: ${value}. Must be an integer >= ${minimum}.`);
+    }
+    return number;
+}
+//# sourceMappingURL=decay.js.map

package/dist/commands/decay.js.map

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

package/dist/commands/delete.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare function registerDeleteCommand(program: Command): void;
+//# sourceMappingURL=delete.d.ts.map

package/dist/commands/delete.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete.d.ts","sourceRoot":"","sources":["../../src/commands/delete.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAGnC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,QAgCrD"}