@ivotoby/postgram-cli 1.33.3 → 1.34.1

package/README.md

@@ -82,6 +82,22 @@ commands (`search`, `list`, `task list`, `expand`) when an agent needs the
 smallest readable output. TOON and compacting are CLI-layer formats; the
 Postgram API remains JSON.
 
+Compact search may include an `edges` summary:
+
+```json
+"edges": {
+  "count": 3,
+  "relations": [{ "relation": "mentioned_in", "count": 2 }]
+}
+```
+
+`edges.count` and `edges.relations` are traversal affordances. They tell an
+agent that graph context exists without returning neighbor content. Use
+`--expand-graph` or `pgm expand <entity-id>` when the user asks about causes,
+provenance, decisions, dependencies, blockers, ownership, involvement,
+discussion participants, connected context, or ambiguous search hits. Do not
+expand when the compact result already answers a direct fact.
+
 ## Memory Roles
 
 Store durable memory:

package/dist/pgm.js

@@ -15,6 +15,13 @@ function readCliVersion() {
     const packageJson = JSON.parse(rawPackageJson);
     return packageJson.version;
 }
+function printTopLevelVersionAndExit(argv) {
+    if (argv.length === 3 && (argv[2] === '--version' || argv[2] === '-V')) {
+        process.stdout.write(`${readCliVersion()}\n`);
+        process.exit(0);
+    }
+}
+printTopLevelVersionAndExit(process.argv);
 function formatStoredEntity(entity) {
     return [
         `${entity.type} ${shortId(entity.id)}${entity.status ? ` [${entity.status}]` : ''}`,
@@ -244,7 +251,6 @@ const program = new Command();
 program
     .name('pgm')
     .description('Postgram CLI for humans and agents')
-    .version(readCliVersion())
     .option('--json', 'emit compact JSON for agents where supported');
 program
     .command('store')

package/dist/search-output.js

@@ -60,6 +60,7 @@ export function compactSearchResponse(response) {
             content: entry.entity.content,
             chunk: entry.chunk_content,
             ...(entry.entity.tags?.length ? { tags: entry.entity.tags } : {}),
+            ...(entry.edges ? { edges: entry.edges } : {}),
             ...(entry.related?.length
                 ? {
                     related: entry.related.map((related) => ({
@@ -98,9 +99,18 @@ function toonScalar(value) {
     }
     return /[,\n\r"]/u.test(scalar) ? JSON.stringify(scalar) : scalar;
 }
+function formatEdgeSummary(edges) {
+    if (!edges || edges.count === 0) {
+        return '';
+    }
+    const relations = edges.relations
+        .map((entry) => `${entry.relation}=${entry.count}`)
+        .join('|');
+    return `${edges.count} edges${relations ? `: ${relations}` : ''}`;
+}
 export function searchResponseToToon(response) {
     const lines = [
-        `results[${response.results.length}]{id,type,score,content,chunk,tags,related}:`
+        `results[${response.results.length}]{id,type,score,content,chunk,tags,edges,related}:`
     ];
     for (const result of response.results) {
         lines.push([
@@ -112,6 +122,7 @@ export function searchResponseToToon(response) {
             result.content,
             result.chunk,
             result.tags,
+            formatEdgeSummary(result.edges),
             result.related?.length ? `${result.related.length} related` : ''
         ]
             .map(toonScalar)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ivotoby/postgram-cli",
-  "version": "1.33.3",
+  "version": "1.34.1",
   "description": "Postgram CLI — store, search, and manage entities from the command line",
   "type": "module",
   "bin": {