@ivotoby/postgram-cli 1.30.0 → 1.31.0

package/dist/client.js

@@ -49,6 +49,12 @@ export function createPgmClient(options) {
                 body: input
             });
         },
+        groomSessionContext(input) {
+            return request(options, '/api/memory/session-context/groom', {
+                method: 'POST',
+                body: input
+            });
+        },
         recallEntity(id, input = {}) {
             const params = new URLSearchParams();
             if (input.owner) {

package/dist/pgm.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 import { spawn, spawnSync } from 'node:child_process';
-import { createWriteStream } from 'node:fs';
+import { createWriteStream, readFileSync } from 'node:fs';
 import { mkdir, readFile as fsReadFile, stat } from 'node:fs/promises';
 import path from 'node:path';
 import { Command } from 'commander';
@@ -10,6 +10,11 @@ import { handleCliFailure, isJsonMode, parseCommaList, parseJsonObject, printHum
 import { AppError, ErrorCode } from './errors.js';
 import { buildSyncManifest } from './sync-walk.js';
 import { compactEdgeResponse, compactEntityListResponse, compactGraphResponse, compactSearchResponse, compactStoredEntityResponse, entityListResponseToToon, graphResponseToToon, searchResponseToToon } from './search-output.js';
+function readCliVersion() {
+    const rawPackageJson = readFileSync(new URL('../package.json', import.meta.url), 'utf8');
+    const packageJson = JSON.parse(rawPackageJson);
+    return packageJson.version;
+}
 function formatStoredEntity(entity) {
     return [
         `${entity.type} ${shortId(entity.id)}${entity.status ? ` [${entity.status}]` : ''}`,
@@ -64,6 +69,43 @@ function validateToonOptions(options, json) {
         throw new AppError(ErrorCode.VALIDATION, '--toon cannot be combined with --json or --full-response');
     }
 }
+function parseDurationMs(value) {
+    const match = /^(\d+)([mhd])$/i.exec(value.trim());
+    if (!match) {
+        throw new AppError(ErrorCode.VALIDATION, `Invalid duration '${value}'. Use format like '15m', '2h', or '7d'.`);
+    }
+    const [, amountText, unitText] = match;
+    const amount = Number(amountText);
+    const unit = unitText.toLowerCase();
+    const milliseconds = unit === 'm'
+        ? amount * 60 * 1000
+        : unit === 'h'
+            ? amount * 60 * 60 * 1000
+            : amount * 24 * 60 * 60 * 1000;
+    if (milliseconds > 3650 * 24 * 60 * 60 * 1000) {
+        throw new AppError(ErrorCode.VALIDATION, `Duration '${value}' exceeds the maximum allowed (3650 days / ~10 years).`);
+    }
+    return milliseconds;
+}
+function formatGroomCandidates(candidates) {
+    if (candidates.length === 0) {
+        return ['No eligible session-context memories'];
+    }
+    const lines = [`Would archive ${candidates.length} session-context memories`];
+    for (const candidate of candidates) {
+        const metadata = candidate.metadata;
+        lines.push([
+            `  ${shortId(candidate.id)} ${candidate.createdAt.slice(0, 10)}`,
+            candidate.tags.length ? `tags=${candidate.tags.join(',')}` : 'tags=-',
+            metadata.topic ? `topic=${metadata.topic}` : undefined,
+            metadata.session_id ? `session=${metadata.session_id}` : undefined,
+            candidate.content ? `content=${candidate.content}` : 'content=-'
+        ]
+            .filter(Boolean)
+            .join(' | '));
+    }
+    return lines;
+}
 async function resolveStoreContent(content) {
     if (content !== undefined) {
         return content;
@@ -202,6 +244,7 @@ const program = new Command();
 program
     .name('pgm')
     .description('Postgram human CLI')
+    .version(readCliVersion())
     .option('--json', 'emit JSON output');
 program
     .command('store')
@@ -259,7 +302,6 @@ program
     .option('--expand-graph', 'include graph-connected entities in results')
     .option('--include-archived', 'include archived entities in results')
     .option('--memory-role <role>', 'memory role filter: durable_memory or session_context')
-    .option('--include-other-clients-session-context', 'include session context from other clients')
     .option('--full-response', 'emit the full API response instead of compact default output when used with --json')
     .option('--toon', 'emit compact TOON output for lower agent token use; formatting is applied in the CLI, not the API')
     .action(async (query, options, command) => {
@@ -282,8 +324,7 @@ program
             recency_weight: Number(options.recencyWeight),
             expand_graph: options.expandGraph === true ? true : undefined,
             include_archived: options.includeArchived === true ? true : undefined,
-            memory_role: options.memoryRole,
-            include_other_clients_session_context: options.includeOtherClientsSessionContext === true ? true : undefined
+            memory_role: options.memoryRole
         });
         if (options.toon === true) {
             return searchResponseToToon(compactSearchResponse(body));
@@ -299,6 +340,50 @@ program
 const memoryCommand = program
     .command('memory')
     .description('Memory-specific commands');
+memoryCommand
+    .command('groom')
+    .description('Preview or archive stale session-context memories for the authenticated client')
+    .option('--dry-run', 'preview without mutating')
+    .option('--older-than <duration>', 'only include memories older than this (e.g. 15m, 2h, 7d)', '7d')
+    .option('--limit <limit>', 'maximum candidates', '50')
+    .option('--topic <topic>', 'filter by topic')
+    .option('--session-id <sessionId>', 'filter by session id')
+    .option('--tag <tag>', 'filter by tag (repeatable)', (value, previous = []) => {
+    previous.push(value);
+    return previous;
+}, [])
+    .option('--yes', 'confirm archive mutation')
+    .action(async (options, command) => {
+    await runWithClient(command, async (client, json) => {
+        const limit = Number.parseInt(options.limit, 10);
+        if (!Number.isInteger(limit) || limit <= 0) {
+            throw new AppError(ErrorCode.VALIDATION, '--limit must be a positive integer');
+        }
+        if (options.dryRun !== true && options.yes !== true) {
+            throw new AppError(ErrorCode.VALIDATION, '--yes is required outside dry-run');
+        }
+        const body = await client.groomSessionContext({
+            dry_run: options.dryRun === true,
+            confirmed: options.dryRun === true ? undefined : true,
+            older_than_ms: parseDurationMs(options.olderThan),
+            limit,
+            topic: options.topic,
+            session_id: options.sessionId,
+            tags: options.tag
+        });
+        if (json) {
+            return body;
+        }
+        if (body.dryRun) {
+            return formatGroomCandidates(body.eligible ?? []);
+        }
+        return [
+            `Archived ${body.archived} session-context memories`,
+            `  promoted: ${body.promoted}`,
+            `  skipped: ${body.skipped}`
+        ];
+    });
+});
 memoryCommand
     .command('session-context')
     .alias('session')

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ivotoby/postgram-cli",
-  "version": "1.30.0",
+  "version": "1.31.0",
   "description": "Postgram CLI — store, search, and manage entities from the command line",
   "type": "module",
   "bin": {
@@ -33,6 +33,7 @@
   },
   "scripts": {
     "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc -p tsconfig.build.json --noEmit",
     "prepublishOnly": "npm run build",
     "test": "vitest run",
     "test:watch": "vitest",