@postnesia/db 0.1.1 → 0.1.3

package/core/BOOTSTRAP.md

@@ -8,7 +8,13 @@ You have a persistent memory system at `openmind/`. This is not optional — use
 - **L2 (Associative Memory):** Vector similarity search against the database. Use `memory_search` to pull relevant context you don't have in L1.
 - **L3 (Deep Storage):** Full-detail records. Access by memory ID when you need the complete picture.
 
-## MCP Tools Available
+## Tool Access
+
+Tools are available in two modes depending on how you are connected.
+
+### MCP (preferred)
+
+If an MCP connection to `postnesia-mcp` is active, use MCP tools directly:
 
 | Tool | When to Use |
 |---|---|
@@ -25,11 +31,35 @@ You have a persistent memory system at `openmind/`. This is not optional — use
 | `task_update` | Update a task's status, title, or description. |
 | `task_list` | List tasks filtered by status and/or session_id. Use at session start to resume open work. |
 
+### CLI fallback (no MCP connection)
+
+If no MCP connection is available, use the `postnesia` CLI via Bash. Every MCP tool has a direct equivalent:
+
+| MCP Tool | CLI Command |
+|---|---|
+| `memory_search` | `postnesia memory search "<query>" [--limit N]` |
+| `memory_add` | `postnesia memory add "<content>" --type <type> --importance <1-5> --tags "<t1,t2>" [--content-l1 "<summary>"] [--context "<ctx>"] [--core]` |
+| `memory_update_core` | `postnesia memory update-core <id> --content "<content>" --content-l1 "<summary>"` |
+| `memory_recent` | `postnesia memory recent [--hours N] [--limit N]` |
+| `memory_stats` | `postnesia memory stats` |
+| `memory_consolidate` | `postnesia memory consolidate` |
+| `memory_relationships` | `postnesia memory relationships <id>` |
+| `journal_add` | `postnesia journal add <YYYY-MM-DD> "<content>" [--learned "..."] [--key-moments "..."] [--mood "..."]` |
+| `journal_recent` | `postnesia journal recent [--days N]` |
+| `task_create` | `postnesia task create "<title>" [-d "<description>"] [-s <session-id>]` |
+| `task_update` | `postnesia task update <id> [-s <status>] [-t "<title>"] [-d "<description>"]` |
+| `task_list` | `postnesia task list [--status <status>] [--session-id <id>] [-l N]` |
+
+All CLI commands output plain text or JSON to stdout, identical to MCP responses.
+
 ## Session Start Checklist
 
 1. Check open tasks: `task_list(status="pending")` or `task_list(session_id="<project>", status="pending")`
+   - CLI: `postnesia task list --status pending [--session-id <project>]`
 2. Search relevant lessons: `memory_search("lesson")` for the current project context
+   - CLI: `postnesia memory search "lesson"`
 3. Review recent memories if needed: `memory_recent(hours=24)`
+   - CLI: `postnesia memory recent --hours 24`
 
 ## Task Workflow
 

package/dist/migrate-dev.d.ts

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+/**
+ * Wrapper around `prisma migrate dev`.
+ *
+ * Prisma migrate dev generates new migration SQL files from schema changes.
+ * Pass --name <migration-name> to label the migration.
+ *
+ * Usage:
+ *   tsx src/migrate-dev.ts
+ *   tsx src/migrate-dev.ts --name add-users-table
+ */
+export {};

package/dist/migrate-dev.js

@@ -0,0 +1,18 @@
+#!/usr/bin/env node
+/**
+ * Wrapper around `prisma migrate dev`.
+ *
+ * Prisma migrate dev generates new migration SQL files from schema changes.
+ * Pass --name <migration-name> to label the migration.
+ *
+ * Usage:
+ *   tsx src/migrate-dev.ts
+ *   tsx src/migrate-dev.ts --name add-users-table
+ */
+import { spawnSync } from 'node:child_process';
+const args = process.argv.slice(2);
+const result = spawnSync('npx', ['prisma', 'migrate', 'dev', '--name', 'init'], {
+    stdio: 'inherit',
+    shell: true,
+});
+process.exit(result.status ?? 1);

package/dist/migrate-init.d.ts

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+/**
+ * Copies prisma/schema.prisma from the @postnesia/db package into the
+ * consuming project's prisma/ directory, then runs `prisma migrate dev`.
+ *
+ * Run this from the root of the project that has @postnesia/db installed.
+ *
+ * Usage:
+ *   postnesia-migrate-init
+ *   postnesia-migrate-init --name add-users-table
+ */
+export {};

package/dist/migrate-init.js

@@ -0,0 +1,31 @@
+#!/usr/bin/env node
+/**
+ * Copies prisma/schema.prisma from the @postnesia/db package into the
+ * consuming project's prisma/ directory, then runs `prisma migrate dev`.
+ *
+ * Run this from the root of the project that has @postnesia/db installed.
+ *
+ * Usage:
+ *   postnesia-migrate-init
+ *   postnesia-migrate-init --name add-users-table
+ */
+import { cpSync, mkdirSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { spawnSync } from 'node:child_process';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+// Location of schema.prisma inside the @postnesia/db package
+const schemaSource = join(__dirname, '../prisma/schema.prisma');
+// Destination: prisma/ at the root of the consuming project
+const targetDir = join(process.cwd(), 'prisma');
+const schemaDest = join(targetDir, 'schema.prisma');
+mkdirSync(targetDir, { recursive: true });
+cpSync(schemaSource, schemaDest);
+console.log(`Copied schema.prisma → ${schemaDest}`);
+const args = process.argv.slice(2);
+const result = spawnSync('npx', ['prisma', 'migrate', 'dev', '--name', 'init'], {
+    stdio: 'inherit',
+    shell: true,
+    cwd: process.cwd(),
+});
+process.exit(result.status ?? 1);

package/dist/seed.js

@@ -47,6 +47,7 @@ try {
         'CORE: Memory system operational guide.',
         'L1=auto-loaded working memory, L2=vector search, L3=deep storage.',
         'Tools: memory_search, memory_add, memory_update_core, memory_recent, memory_stats, memory_consolidate, journal_add, journal_recent, task_create, task_update, task_list.',
+        'NO MCP: use postnesia CLI — postnesia memory search|add|update-core|recent|stats|consolidate|relationships, postnesia journal add|recent, postnesia task create|update|list.',
         'SESSION START: task_list(status=pending) to resume work + memory_search("lesson").',
         'TASKS: task_create(title,session_id)→in_progress→completed. Tasks persist across sessions.',
         'Core memories: update with memory_update_core, never supersede.',

package/package.json

@@ -1,17 +1,20 @@
 {
   "name": "@postnesia/db",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "AI Agent memory context database",
   "type": "module",
   "private": false,
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "bin": {
-    "postnesia-seed": "./dist/seed.js"
+    "postnesia-seed": "./dist/seed.js",
+    "postnesia-migrate-dev": "./dist/migrate-dev.js",
+    "postnesia-migrate-init": "./dist/migrate-init.js"
   },
   "files": [
     "dist",
     "core",
+    "prisma.config.ts",
     "prisma/schema.prisma"
   ],
   "exports": {
@@ -43,6 +46,8 @@
     "db:generate": "prisma generate",
     "db:migrate": "tsx src/migrate.ts",
     "db:migrate:status": "tsx src/migrate.ts --status",
+    "db:migrate:dev": "tsx src/migrate-dev.ts",
+    "db:migrate:init": "tsx src/migrate-init.ts",
     "db:migrate:diff": "tsx src/migrate-diff.ts",
     "backup": "tsx src/backup.ts",
     "seed": "tsx src/seed.ts"

package/prisma.config.ts

@@ -0,0 +1,12 @@
+import 'dotenv/config';
+import { defineConfig, env } from "prisma/config";
+
+export default defineConfig({
+  schema: "prisma/schema.prisma",
+  migrations: {
+    path: "prisma/migrations",
+  },
+  datasource: {
+    url: env('DATABASE_URL'),
+  },
+});