@postnesia/cli 0.1.4 → 0.1.6

package/README.md

@@ -1,117 +1,50 @@
-# Postnesia Memory MCP Server
+# @postnesia/cli
 
-Model Context Protocol server for main agent memory system. Exposes memory operations as standardized tools.
+Commander CLI for the Postnesia memory system. A like-for-like interface over the MCP tools for use when no MCP connection is available.
 
-## Installation
+## Usage
 
 ```bash
-cd postnesia
-npm install
-npm run db:generate
+npx postnesia <command> [options]
 ```
 
-## Configuration
+Requires `DATABASE_URL` and `GEMINI_API_KEY` in a `.env` file in your working directory, or set as environment variables.
 
-Add to your MCP settings (e.g., Claude Desktop config):
+## Commands
 
-```json
-{
-  "mcpServers": {
-    "postnesia": {
-      "command": "/absolute/path/to/tsx",
-      "env": {
-        "DATABASE_URL": "file:/absolute/path/to/memory.db",
-        "GEMINI_API_KEY": "token-for-gemini-embedding-model-api"
-      }
-    }
-  }
-}
-```
-
-Or use npm script:
+### Memory
 
-```json
-{
-  "mcpServers": {
-    "openmind": {
-      "command": "/absolute/path/to/tsx",
-      "env": {
-        "DATABASE_URL": "/absolute/path/to/memory.db",
-        "GEMINI_API_KEY": "token-for-gemini-embedding-model-api"
-      }
-    }
-  }
-}
+```bash
+postnesia memory search "<query>" [--limit N]
+postnesia memory add "<content>" --type <type> --importance <1-5> --tags "<t1,t2>" [--content-l1 "<summary>"] [--context "<ctx>"] [--core]
+postnesia memory update-core <id> --content "<content>" --content-l1 "<summary>"
+postnesia memory recent [--hours N] [--limit N]
+postnesia memory stats
+postnesia memory consolidate
+postnesia memory relationships <id>
 ```
 
-## Available Tools
-
-### memory_search
-Semantic search across memories.
-- `query` (required): Search text
-- `maxResults` (optional): Max results (default: 10)
-- `minScore` (optional): Min similarity 0-1 (default: 0.3)
-
-### memory_add
-Create a new memory.
-- `content` (required): Full memory text
-- `contentL1` (optional): Compressed form
-- `type` (required): event|decision|lesson|preference|person|technical
-- `importance` (required): 1-5
-- `tags` (required): Array of tags
-- `context` (optional): Creation context
-
-### memory_recent
-Get recent memories.
-- `hours` (optional): Hours to look back (default: 24)
-- `limit` (optional): Max results (default: 20)
-
-### memory_context
-Get contextually related memories.
-- `query` (required): Context query
-- `maxResults` (optional): Max results (default: 5)
-
-### memory_stats
-Get database statistics. No parameters.
+**Memory types:** `event` `decision` `lesson` `preference` `person` `technical`
 
-### memory_consolidate
-Run consolidation cycle (decay + boost). No parameters - always applies changes.
+### Journal
 
-### journal_add
-Add daily journal entry.
-- `date` (required): YYYY-MM-DD
-- `content` (required): Full narrative
-- `learned` (optional): What I learned
-- `learnedAboutRye` (optional): What I learned about Rye
-- `keyMoments` (optional): Key moments
-- `mood` (optional): Mood/feeling
-
-### journal_recent
-Get recent journal entries.
-- `days` (optional): Days to look back (default: 7)
-
-### memory_relationships
-View relationship graph for a memory.
-- `memoryId` (required): Memory ID to explore
-
-## Access Tracking
-
-All read operations (search, recent, context) automatically log accesses, which feed into the importance dynamics system.
-
-## Testing
+```bash
+postnesia journal add <YYYY-MM-DD> "<content>" [--learned "..."] [--learned-about-rye "..."] [--key-moments "..."] [--mood "..."]
+postnesia journal recent [--days N]
+```
 
-Test the server manually:
+### Tasks
 
 ```bash
-npm run mcp
+postnesia task create "<title>" [-d "<description>"] [-s <session-id>] [-m <memory-id>]
+postnesia task update <id> [-s <status>] [-t "<title>"] [-d "<description>"]
+postnesia task list [--status <status>] [--session-id <id>] [-l N]
 ```
 
-Then send MCP requests via stdin (see MCP protocol docs).
+**Task statuses:** `pending` `in_progress` `completed` `cancelled`
 
-## Architecture
+## Notes
 
-- Built on Prisma + SQLite
-- Automatic access tracking
-- Dynamic importance scoring (decay + boost)
-- Relationship graph support
-- Journal integration
+- `memory search` uses Gemini vector embeddings — `GEMINI_API_KEY` is required
+- `memory add` and `memory update-core` also embed content before writing
+- Output is JSON for list/search commands; plain text for mutations

package/dist/index.js

@@ -8,8 +8,8 @@ import 'dotenv/config';
 import { Command } from 'commander';
 import { getDb, queries, createMemory } from '@postnesia/db';
 import { embed } from '@postnesia/db/embeddings';
-import { logAccess } from '@postnesia/mcp/access';
-import { runConsolidation } from '@postnesia/mcp/importance';
+import { logAccess } from '@postnesia/db/access';
+import { runConsolidation } from '@postnesia/db/importance';
 // ---------------------------------------------------------------------------
 // Bootstrap
 // ---------------------------------------------------------------------------
@@ -27,10 +27,10 @@ memory
     .command('search <query>')
     .description('Search memories by content')
     .option('-l, --limit <n>', 'Max results', '10')
-    .action((query, opts) => {
+    .action(async (query, opts) => {
     const limit = parseInt(opts.limit, 10);
-    const pattern = `%${query.toLowerCase()}%`;
-    const results = queries.searchMemories(db).all(pattern, pattern, limit);
+    const embedding = await embed(query);
+    const results = queries.vectorSearch(db).all(Buffer.from(embedding.buffer), limit);
     for (const r of results)
         logAccess(r.id, 'search');
     process.stdout.write(JSON.stringify(results, null, 2) + '\n');
@@ -61,7 +61,7 @@ memory
         tags,
         embedding,
     });
-    process.stdout.write(`✓ Created memory #${id}\n  Type: ${opts.type}\n  Core: ${core ? 'yes' : 'no'}\n  Importance: ${'⭐'.repeat(importance)}\n  Tags: ${tags.join(', ')}\n`);
+    process.stdout.write(`✓ Created memory #${id}\n  Type: ${opts.type}\n  Core: ${core ? 'yes' : 'no'}\n  Importance: ${importance}/5\n  Tags: ${tags.join(', ')}\n`);
 });
 memory
     .command('update-core <memoryId>')

package/package.json

@@ -1,8 +1,9 @@
 {
   "name": "@postnesia/cli",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "description": "Commander CLI for Postnesia — direct tool access for agents",
   "type": "module",
+  "private": false,
   "files": [
     "dist"
   ],
@@ -10,8 +11,7 @@
     "postnesia": "./dist/index.js"
   },
   "dependencies": {
-    "@postnesia/db": "^0.1.4",
-    "@postnesia/mcp": "^0.1.4",
+    "@postnesia/db": "^0.1.5",
     "commander": "^14.0.3",
     "dotenv": "^17.3.1"
   },
@@ -21,7 +21,8 @@
     "typescript": "^5.7.3"
   },
   "scripts": {
-    "build": "tsc -p tsconfig.json",
+    "build": "pnpm clean && tsc -p tsconfig.json",
+    "clean": "rm -rf ./dist",
     "start": "tsx src/index.ts"
   }
 }