pmem-ai 0.7.1 → 0.7.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (51) hide show
  1. package/CHANGELOG.md +21 -0
  2. package/README.md +40 -2
  3. package/dist/commands/integration.js +1 -1
  4. package/dist/commands/mcp.d.ts +9 -0
  5. package/dist/commands/mcp.d.ts.map +1 -0
  6. package/dist/commands/mcp.js +64 -0
  7. package/dist/commands/mcp.js.map +1 -0
  8. package/dist/commands/milestone.d.ts +5 -0
  9. package/dist/commands/milestone.d.ts.map +1 -0
  10. package/dist/commands/milestone.js +197 -0
  11. package/dist/commands/milestone.js.map +1 -0
  12. package/dist/commands/update.d.ts +2 -0
  13. package/dist/commands/update.d.ts.map +1 -1
  14. package/dist/commands/update.js +87 -3
  15. package/dist/commands/update.js.map +1 -1
  16. package/dist/commands/verify.d.ts.map +1 -1
  17. package/dist/commands/verify.js +19 -8
  18. package/dist/commands/verify.js.map +1 -1
  19. package/dist/core/consistency.d.ts.map +1 -1
  20. package/dist/core/consistency.js +6 -0
  21. package/dist/core/consistency.js.map +1 -1
  22. package/dist/core/query/ask.d.ts +20 -0
  23. package/dist/core/query/ask.d.ts.map +1 -0
  24. package/dist/core/query/ask.js +256 -0
  25. package/dist/core/query/ask.js.map +1 -0
  26. package/dist/core/query/recall.d.ts +21 -0
  27. package/dist/core/query/recall.d.ts.map +1 -0
  28. package/dist/core/query/recall.js +148 -0
  29. package/dist/core/query/recall.js.map +1 -0
  30. package/dist/core/query/related.d.ts +29 -0
  31. package/dist/core/query/related.d.ts.map +1 -0
  32. package/dist/core/query/related.js +106 -0
  33. package/dist/core/query/related.js.map +1 -0
  34. package/dist/core/query/status.d.ts +24 -0
  35. package/dist/core/query/status.d.ts.map +1 -0
  36. package/dist/core/query/status.js +236 -0
  37. package/dist/core/query/status.js.map +1 -0
  38. package/dist/index.js +19 -1
  39. package/dist/index.js.map +1 -1
  40. package/dist/mcp/security.d.ts +21 -0
  41. package/dist/mcp/security.d.ts.map +1 -0
  42. package/dist/mcp/security.js +150 -0
  43. package/dist/mcp/security.js.map +1 -0
  44. package/dist/mcp/server.d.ts +2 -0
  45. package/dist/mcp/server.d.ts.map +1 -0
  46. package/dist/mcp/server.js +177 -0
  47. package/dist/mcp/server.js.map +1 -0
  48. package/docs/dogfooding.md +98 -0
  49. package/docs/pmem-rt.md +137 -0
  50. package/package.json +3 -2
  51. package/skills/pmem/SKILL.md +43 -2
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "pmem-ai",
3
- "version": "0.7.1",
3
+ "version": "0.7.2",
4
4
  "description": "Project Memory for AI Agents: a local CLI runtime for project context, recall, and memory updates",
5
5
  "main": "dist/index.js",
6
6
  "bin": {
@@ -11,7 +11,7 @@
11
11
  "pretest": "npm run build",
12
12
  "dev": "ts-node src/index.ts",
13
13
  "start": "node dist/index.js",
14
- "test": "node --require ts-node/register --test src/core/*.test.ts src/commands/*.test.ts",
14
+ "test": "node --require ts-node/register --test src/core/*.test.ts src/commands/*.test.ts src/mcp/*.test.ts",
15
15
  "test:e2e:install": "bash scripts/e2e-install-smoke.sh",
16
16
  "test:e2e:workflow": "bash scripts/e2e-real-workflow.sh",
17
17
  "test:e2e:non-git": "bash scripts/e2e-non-git-fallback.sh",
@@ -73,6 +73,7 @@
73
73
  "typescript": "^6.0.3"
74
74
  },
75
75
  "dependencies": {
76
+ "@modelcontextprotocol/sdk": "^1.29.0",
76
77
  "better-sqlite3": "^12.10.0",
77
78
  "commander": "^14.0.3",
78
79
  "js-yaml": "^4.1.1"
@@ -209,6 +209,7 @@ pmem status --format compact # human-readable, shows [git] or [mtime]
209
209
  # Mark affected cards as potentially stale
210
210
  pmem mark-dirty --auto
211
211
  pmem mark-dirty -r "Refactored auth module"
212
+ pmem mark-dirty --card module.core --card decision.jwt -r "Manual frontmatter edit"
212
213
 
213
214
  # Get memory update suggestions
214
215
  pmem update --suggest --format json
@@ -217,6 +218,9 @@ pmem update --suggest --format json
217
218
  # Confirm and write changes
218
219
  pmem update --confirm -s "Updated auth module" -n "Add token refresh"
219
220
 
221
+ # Refresh last_verified on specific cards without creating separate traces
222
+ pmem update --confirm -s "Reviewed changes" --refresh-verified module.core,decision.jwt
223
+
220
224
  # OR use the shortcut to sync changes in a single command (v0.7.1)
221
225
  pmem sync -s "Updated auth module" -n "Add token refresh"
222
226
  ```
@@ -226,10 +230,14 @@ pmem sync -s "Updated auth module" -n "Add token refresh"
226
230
  ```bash
227
231
  # Check consistency
228
232
  pmem verify
229
- pmem verify --fix # auto-fix stale indexes and missing DB
230
- pmem verify --fix-stale # auto-fix stale mtime warnings by updating card verified timestamps
233
+ pmem verify --fix # repair structural issues (stale index, missing DB, orphan edges)
234
+ pmem verify --fix-stale # --fix + refresh stale_memory last_verified timestamps (one-shot cleanup)
231
235
  pmem verify --relaxed # temporarily double token limits for verification
232
236
 
237
+ # Record a release milestone
238
+ pmem milestone v0.8.0 -m "Graph visualization closeout"
239
+ pmem milestone v1.0.0 --tag v1.0.0-rc1
240
+
233
241
  # Create a new card template
234
242
  pmem new decision "Choice of library"
235
243
 
@@ -272,6 +280,39 @@ pmem install --skills --all # → all detected agents
272
280
  pmem integration verify
273
281
  ```
274
282
 
283
+ ### MCP Server (pmem-rt v1)
284
+
285
+ Start a read-only stdio MCP server for agent tool integration:
286
+
287
+ ```bash
288
+ pmem mcp
289
+ ```
290
+
291
+ **Agent configuration example** (Claude Code `mcpServers`):
292
+
293
+ ```json
294
+ {
295
+ "mcpServers": {
296
+ "pmem-rt": {
297
+ "command": "pmem",
298
+ "args": ["mcp"],
299
+ "cwd": "/path/to/your/project"
300
+ }
301
+ }
302
+ }
303
+ ```
304
+
305
+ **Available tools**:
306
+
307
+ | Tool | Description |
308
+ |------|-------------|
309
+ | `pmem_recall` | Restore project memory context (stage, focus, next, active cards, updates) |
310
+ | `pmem_ask` | Search memory with 6-step retrieval (ID → alias → tag → graph → FTS5 → LIKE) |
311
+ | `pmem_related` | Query graph neighbors of a card (edges grouped by type with direction/confidence) |
312
+ | `pmem_status` | Detect changed files and affected memory cards (git or mtime) |
313
+
314
+ All card content carries `content_trust: "untrusted_project_data"`. Tools are read-only. See [docs/pmem-rt.md](../docs/pmem-rt.md) for the full integration guide.
315
+
275
316
  ## Exit Codes
276
317
 
277
318
  v0.6.2+: `0` = ok, `2` = runtime error. Exit code `1` is no longer used as a workflow signal.