npm - @memnexus-ai/cli - Versions diffs - 1.7.176 → 1.7.177 - Mend

@memnexus-ai/cli 1.7.176 → 1.7.177

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 (4) hide show

package/dist/lib/setup/rules-templates.d.ts.map +1 -1
package/dist/lib/setup/rules-templates.js +48 -162
package/dist/lib/setup/rules-templates.js.map +1 -1
package/package.json +1 -1

package/dist/lib/setup/rules-templates.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"rules-templates.d.ts","sourceRoot":"","sources":["../../../src/lib/setup/rules-templates.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAEvD,QAAA,MAAM,YAAY,wFACgE,CAAC;AACnF,QAAA,MAAM,UAAU,gCAAgC,CAAC;AAEjD,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,CAAC;~~AAgQpC~~;;;;;;GAMG;AACH,wBAAgB,oCAAoC,IAAI,MAAM,CA2C7D;AAID;;GAEG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,oBAAoB,GACjC,MAAM,CAkBR;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGnE"}
1	+ {"version":3,"file":"rules-templates.d.ts","sourceRoot":"","sources":["../../../src/lib/setup/rules-templates.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAEvD,QAAA,MAAM,YAAY,wFACgE,CAAC;AACnF,QAAA,MAAM,UAAU,gCAAgC,CAAC;AAEjD,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,CAAC;AA8IpC;;;;;;GAMG;AACH,wBAAgB,oCAAoC,IAAI,MAAM,CA2C7D;AAID;;GAEG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,oBAAoB,GACjC,MAAM,CAkBR;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGnE"}

package/dist/lib/setup/rules-templates.js CHANGED Viewed

@@ -16,191 +16,77 @@ exports.END_MARKER = END_MARKER;
 function getMcpCoreRules() {
     return `# MemNexus Memory Management
-MemNexus gives you persistent memory across sessions via MCP tools. Save important context, search past work, and build on previous decisions.
+You have persistent memory across sessions. Use it proactively — save what matters, retrieve what you need.
-## When to Save Memories
+## Save Proactively
-Save a memory after:
-- Completing significant milestones (features, bug fixes, architectural changes)
-- Making important technical decisions (why an approach was chosen)
-- Resolving complex bugs (root cause, solution, lessons learned)
-- Discovering patterns or gotchas (reusable knowledge)
-- Before switching tasks (current progress, next steps, blockers)
+**You MUST save a memory after completing any of these — do not wait for the user to ask:**
+- Finishing a feature, bug fix, or refactor
+- Making a technical decision (what was chosen and why)
+- Resolving a complex bug (root cause, fix, lessons learned)
+- Discovering a pattern or gotcha (reusable knowledge)
+- Before switching tasks (progress so far, next steps, blockers)
-## MCP Tools Quick Reference
+Write for a future reader: include what you did, why, references (issue numbers, commits, file paths), and next steps.
-### Context & Planning
-| Tool | Purpose |
-|------|---------|
-| \`build_context\` | Get a briefing before starting work — returns active work, key facts, gotchas, recent activity, and patterns. **Use this first when starting any task.** |
+**Conversation tracking:** Use \`conversationId: "NEW"\` for the first memory of a task. Capture the returned \`conv_xxx\` ID and reuse it for follow-up memories in the same task. Use \`"NEW"\` again when switching to a different task.
-### Save & Update
-| Tool | Purpose |
-|------|---------|
-| \`create_memory\` | Save a new memory with content, optional topics, and conversationId |
-| \`manage_memory\` | Update content/topics, or delete by ID (requires \`confirmDeletion: true\` for deletes) |
+**Topics** are auto-extracted from content. Only add manual \`topics\` for status tags (\`completed\`, \`in-progress\`) or component names.
-### Search & Retrieve
-| Tool | Purpose |
-|------|---------|
-| \`search_memories\` | Search by query with \`mode\` (\`"unified"\`, \`"content"\`, \`"facts"\`), filter by \`topics\`/\`excludeTopics\`/\`recent\`, sort with \`sortBy\`/\`order\` |
-| \`get_memory\` | Retrieve by ID or named key. Set \`detail\` to \`"minimal"\`, \`"standard"\`, or \`"full"\` for relationship depth |
-| \`recall\` | AI-synthesized digest with key facts, entities, and state breakdown — set \`format\` to \`"structured"\`, \`"narrative"\`, \`"timeline"\`, or \`"status-report"\` |
-| \`conversations\` | List conversations, or get a \`"summary"\`/\`"timeline"\` view for a specific conversation |
-### Explore & Analyze
-| Tool | Purpose |
-|------|---------|
-| \`knowledge_graph\` | Explore entities (\`type: "entities"\`, optional \`entityType\`), facts (\`type: "facts"\`), topics (\`type: "topics"\`), related topics (\`type: "related_topics"\`), entity memories (\`type: "entity_memories"\` + \`entityId\`), or graph health (\`type: "health"\`) |
-| \`patterns\` | Detect patterns (\`action: "detect"\`), analyze trends (\`action: "analyze"\`), compile from memories (\`action: "compile"\`), or list stored (\`action: "list"\`) |
-### Account
-| Tool | Purpose |
-|------|---------|
-| \`get_user_profile\` | Check plan, quota, usage stats — the ONLY way to get account info |
-## Starting New Work
-Before diving into any task, use \`build_context\` to get a briefing:
-\`\`\`
-build_context({ context: "refactor authentication middleware", files: ["src/middleware/auth.ts"] })
-\`\`\`
+**Code context:** When saving memories about code (architecture, implementations, bugs, decisions), include \`codeContext\` with at least \`product\` and \`service\` to scope the knowledge. Infer \`product\` from the repo name or \`package.json\`. Infer \`service\` from the package/directory you're working in. Omit \`codeContext\` for general notes, status updates, or non-code discussions.
-This returns in a single call:
-- **Active work** — what you were last working on in this area
-- **Key facts** — extracted knowledge relevant to the task
-- **Gotchas** — recurring issues that appeared in multiple memories
-- **Recent activity** — related memories from the last 24h (configurable via \`recent_hours\`)
-- **Patterns** — behavioral patterns related to the work
+## Find Context
-Use the results to avoid repeating past mistakes and build on prior decisions.
+Use the right tool for the situation:
-## Conversation Tracking (Critical)
+| Situation | Tool | Why |
+|-----------|------|-----|
+| Starting a task | \`build_context\` | One-call briefing: active work, key facts, gotchas, patterns (~200ms) |
+| Need an overview of a topic | \`recall\` | AI-synthesized digest across multiple memories (~3-5s) |
+| Looking for specific memories | \`search_memories\` | Semantic search with filters (query, topics, recent, scope) |
+| Know the ID or name | \`get_memory\` | Direct retrieval by ID or named key |
+| Exploring the knowledge graph | \`knowledge_graph\` | Browse entities, facts, topics, and their connections |
-Group related memories into conversations to maintain context:
+**Do not** call \`get_memory\` in a loop to compile context — use \`recall\` instead.
+**Do not** use \`search_memories\` for initial briefing — use \`build_context\`.
-1. **First memory of a new task** — set \`conversationId\` to \`"NEW"\`
-2. **Parse the response** — it returns the new conversation ID (e.g., \`conv_abc123\`)
-3. **Store that ID** — use it for all subsequent memories in this task
-4. **Subsequent memories** — set \`conversationId\` to \`"conv_abc123"\`
-5. **New topic/task** — use \`"NEW"\` again to start a fresh conversation
+## Tool Reference
-Example flow:
-\`\`\`
-create_memory({ conversationId: "NEW", content: "Starting work on auth refactor..." })
-→ response includes conversationId: "conv_abc123"
-create_memory({ conversationId: "conv_abc123", content: "Switched to JWT tokens..." })
-create_memory({ conversationId: "conv_abc123", content: "Auth refactor complete..." })
-\`\`\`
-## Search & Retrieval Strategies
-- **\`build_context\`** — use first when starting work. Combines 5 queries into one call to give you a complete briefing.
-- **\`search_memories\`** — primary search tool. Key parameters:
-  - \`query\` — semantic search (omit to list recent)
-  - \`mode\` — \`"unified"\` (default, searches content + facts + entities), \`"content"\`, or \`"facts"\`
-  - \`topics\`/\`excludeTopics\` — filter by topic tags
-  - \`recent\` — time filter (e.g. \`"24h"\`, \`"7d"\`, \`"2w"\`)
-  - \`sortBy\` — \`"relevance"\`, \`"createdAt"\`, \`"updatedAt"\`, or \`"eventTime"\`
-- **\`recall\`** — AI-synthesized digest with structured graph context. Returns key facts, entities, and effective state breakdown alongside the narrative. Use for "give me an overview of X" or "get me up to speed on Y". Set \`format\` to \`"structured"\`, \`"narrative"\`, \`"timeline"\`, or \`"status-report"\`.
-- **\`conversations\`** — list work sessions with \`recent\` filter, or get a \`"summary"\`/\`"timeline"\` view for a specific conversation.
-- **\`knowledge_graph\`** — explore graph structure:
-  - \`type: "entities"\` — list all entities, filter by \`entityType\` (PERSON, TECHNOLOGY, etc.)
-  - \`type: "entity_memories"\` + \`entityId\` — find memories connected to a specific entity
-  - \`type: "health"\` — check extraction coverage and graph statistics
-  - \`type: "facts"\` + \`query\` — search structured facts extracted from memories
-  - \`type: "topics"\` — list all topics, or search with \`query\`
-  - \`type: "related_topics"\` + \`topicId\` — discover connected topics
-- **\`patterns\`** — behavioral analysis:
-  - \`action: "detect"\` — find new patterns in your memories
-  - \`action: "analyze"\` — AI-generated insights and recommendations
-  - \`action: "compile"\` — compile patterns from recent memories
-  - \`action: "list"\` — view stored patterns
-## Topic Conventions
-Topics are auto-extracted from content. Only add manual \`topics\` for:
-- **Status**: \`completed\`, \`in-progress\`, \`blocked\`, \`needs-review\`
-- **Component**: project-specific component names (e.g. \`mx-cli\`, \`mx-core-api\`)
-Example: \`topics: ["mx-core-api", "completed"]\`
-Do NOT manually tag things like \`debugging\`, \`authentication\`, \`api-development\` — the extraction pipeline handles these automatically from well-written content.
-## Best Practices
-- **Use \`build_context\` first** — before starting any task, get a briefing to avoid repeating mistakes
-- **Search before asking** — use \`search_memories\` to check for existing context
-- **Use \`get_user_profile\` for account info** — never search memories for plan/quota details
-- **Start with \`recall\` for topic questions** — it synthesizes a narrative, returns key facts and entities, and filters superseded info. Use \`search_memories\` when you need specific raw results
-- **Use named memories for living documents** — pass \`name\` param (e.g. \`"project-status"\`) for memories you update regularly
-- **Include references** — mention issue numbers, commit hashes, file paths in content
-- **Write for others** — assume future readers are unfamiliar with the work
-## Code Context (Scoping Memories)
-When creating memories, include \`codeContext\` to scope the knowledge to your environment. This enables scoped retrieval — finding only memories relevant to your product, service, or team.
+| Tool | Purpose |
+|------|---------|
+| \`build_context\` | Session-start briefing — active work, facts, gotchas, patterns |
+| \`create_memory\` | Save a new memory (with optional conversationId, topics, codeContext) |
+| \`manage_memory\` | Update or delete an existing memory |
+| \`search_memories\` | Search by meaning, filter by topics/recent/scope |
+| \`get_memory\` | Retrieve by ID or named key (use \`detail\` for depth) |
+| \`recall\` | AI-synthesized digest of a topic area |
+| \`conversations\` | List or summarize work sessions |
+| \`knowledge_graph\` | Explore entities, facts, topics, connections |
+| \`patterns\` | Detect, analyze, or list behavioral patterns |
+| \`get_user_profile\` | Check plan, quota, usage (the ONLY way to get account info) |
-\`\`\`
-create_memory({
-  content: "Decided to use JWT for auth because...",
-  codeContext: {
-    product: "my-product",       // product name
-    service: "auth-service",     // service or package
-    team: "backend",             // team that owns this knowledge
-    component: "authentication", // subsystem
-    role: "implementer"          // your role (team-lead, implementer, reviewer)
-  }
-})
-\`\`\`
+## Tips
-**Fields** (all optional — include what you know):
-| Field | Purpose | Example |
-|-------|---------|---------|
-| \`product\` | Product name | \`"my-app"\`, \`"memnexus"\` |
-| \`repo\` | Repository (if different from product) | \`"my-app-monorepo"\` |
-| \`service\` | Service or package | \`"api"\`, \`"web"\`, \`"cli"\` |
-| \`component\` | Subsystem | \`"billing"\`, \`"search"\` |
-| \`team\` | Team name | \`"backend"\`, \`"platform"\` |
-| \`role\` | Your role | \`"team-lead"\`, \`"implementer"\` |
-**Scoped search** — filter memories by scope:
-\`\`\`
-search_memories({ query: "auth decisions", scope: { product: "my-product", service: "auth-service" } })
-\`\`\``;
+- **Use named memories** for documents you update regularly — pass \`name\` param (e.g. \`"project-status"\`)
+- **Include references** in content — issue numbers, commit hashes, file paths get extracted as facts and entities
+- **Write for others** — assume future readers have no context about your work`;
 }
 // ── CLI Appendix (only for agents with terminal access) ──────────
 function getCliSection() {
     return `
-## CLI Workflows (Terminal)
+## CLI-Only Workflows
-The \`mx\` CLI provides additional workflows beyond MCP tools:
+Use MCP tools for all standard memory operations. The CLI adds workflows that MCP cannot do:
 | Workflow | Command |
 |----------|---------|
-| Context briefing | \`mx memories build-context --context "what you're working on"\` |
-| Recent work recap | \`mx memories recap --recent 24h\` |
-| AI digest of topic | \`mx memories digest --query "..." --digest-format structured\` |
-| Timeline search | \`mx memories search --query "..." --timeline\` |
-| Search by mode | \`mx memories search --query "..." --mode facts\` |
-| Grouped by session | \`mx memories search --query "..." --group-by conversation\` |
-| List conversations | \`mx conversations list --recent 7d\` |
-| Conversation summary | \`mx conversations summary <conversation-id>\` |
-| Search facts | \`mx facts search --query "..."\` |
-| List entities | \`mx entities list --type TECHNOLOGY\` |
-| Entity memories | \`mx entities memories <entity-id>\` |
-| Graph health | \`mx entities health\` |
-| Explore topics | \`mx topics discover-related --topic "..."\` |
-| Detect patterns | \`mx patterns detect\` |
-| List commit contexts | \`mx commit-context list --recent 7d\` |
-| Show commit context | \`mx commit-context show <sha>\` |
-| Full CLI help | \`mx agent-help\` |
-Run \`mx agent-help\` for full AI-optimized documentation of all commands.`;
+| Recent work recap (raw, fast) | \`mx memories recap --recent 24h\` |
+| AI digest for handoffs/reports | \`mx memories digest --query "..." --digest-format structured\` |
+| Timeline view (chronological) | \`mx memories search --query "..." --timeline\` |
+| Group by conversation | \`mx memories search --query "..." --group-by conversation\` |
+| Commit context history | \`mx commit-context list --recent 7d\` |
+| Full CLI reference | \`mx agent-help\` |`;
 }
 // ── Agent-Specific Additions ─────────────────────────────────────
 const AGENT_RULES = {

package/dist/lib/setup/rules-templates.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"rules-templates.js","sourceRoot":"","sources":["../../../src/lib/setup/rules-templates.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;~~AA+QH~~,oFA2CC;AAOD,oCAsBC;AAMD,oDAGC;~~AA5VD~~,MAAM,YAAY,GAChB,gFAAgF,CAAC;AAG1E,oCAAY;AAFrB,MAAM,UAAU,GAAG,6BAA6B,CAAC;AAE1B,gCAAU;AAEjC,oEAAoE;AAEpE,SAAS,eAAe;IACtB,OAAO~~;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4JF~~,CAAC;~~AACR~~,CAAC;AAED,oEAAoE;AAEpE,SAAS,aAAa;IACpB,OAAO~~;;;;;;;;;;;;;;;;;;;;;;;;;;2EA0BkE~~,CAAC;~~AAC5E~~,CAAC;AAED,oEAAoE;AAEpE,MAAM,WAAW,GAA2B;IAC1C,aAAa,EAAE;;;;;;mEAMkD;IAEjE,MAAM,EAAE;;;;;;mEAMyD;IAEjE,OAAO,EAAE;;;;;;mEAMwD;IAEjE,KAAK,EAAE;;;;;;mDAM0C;IAEjD,QAAQ,EAAE;;;;;;mEAMuD;IAEjE,gBAAgB,EAAE;;;;;;;;kEAQ8C;CACjE,CAAC;AAEF,gEAAgE;AAChE,EAAE;AACF,2EAA2E;AAC3E,6EAA6E;AAC7E,+EAA+E;AAE/E;;;;;;GAMG;AACH,SAAgB,oCAAoC;IAClD,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yGAyCgG,CAAC;AAC1G,CAAC;AAED,oEAAoE;AAEpE;;GAEG;AACH,SAAgB,YAAY,CAC1B,OAAe,EACf,OAAe,EACf,YAAkC;IAElC,MAAM,IAAI,GAAG,eAAe,EAAE,CAAC;IAC/B,MAAM,GAAG,GAAG,YAAY,KAAK,MAAM,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAC3D,MAAM,aAAa,GAAG,WAAW,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;IAEjD,MAAM,KAAK,GAAG;QACZ,YAAY;QACZ,iBAAiB,OAAO,aAAa,OAAO,MAAM;QAClD,EAAE;QACF,IAAI;QACJ,GAAG;QACH,aAAa;QACb,EAAE;QACF,UAAU;QACV,EAAE;KACH,CAAC;IAEF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;;GAGG;AACH,SAAgB,oBAAoB,CAAC,OAAe;IAClD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,yBAAyB,CAAC,CAAC;IACvD,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AACjC,CAAC"}
1	+ {"version":3,"file":"rules-templates.js","sourceRoot":"","sources":["../../../src/lib/setup/rules-templates.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AA6JH,oFA2CC;AAOD,oCAsBC;AAMD,oDAGC;AA1OD,MAAM,YAAY,GAChB,gFAAgF,CAAC;AAG1E,oCAAY;AAFrB,MAAM,UAAU,GAAG,6BAA6B,CAAC;AAE1B,gCAAU;AAEjC,oEAAoE;AAEpE,SAAS,eAAe;IACtB,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;+EAuDsE,CAAC;AAChF,CAAC;AAED,oEAAoE;AAEpE,SAAS,aAAa;IACpB,OAAO;;;;;;;;;;;;;2CAakC,CAAC;AAC5C,CAAC;AAED,oEAAoE;AAEpE,MAAM,WAAW,GAA2B;IAC1C,aAAa,EAAE;;;;;;mEAMkD;IAEjE,MAAM,EAAE;;;;;;mEAMyD;IAEjE,OAAO,EAAE;;;;;;mEAMwD;IAEjE,KAAK,EAAE;;;;;;mDAM0C;IAEjD,QAAQ,EAAE;;;;;;mEAMuD;IAEjE,gBAAgB,EAAE;;;;;;;;kEAQ8C;CACjE,CAAC;AAEF,gEAAgE;AAChE,EAAE;AACF,2EAA2E;AAC3E,6EAA6E;AAC7E,+EAA+E;AAE/E;;;;;;GAMG;AACH,SAAgB,oCAAoC;IAClD,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yGAyCgG,CAAC;AAC1G,CAAC;AAED,oEAAoE;AAEpE;;GAEG;AACH,SAAgB,YAAY,CAC1B,OAAe,EACf,OAAe,EACf,YAAkC;IAElC,MAAM,IAAI,GAAG,eAAe,EAAE,CAAC;IAC/B,MAAM,GAAG,GAAG,YAAY,KAAK,MAAM,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAC3D,MAAM,aAAa,GAAG,WAAW,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;IAEjD,MAAM,KAAK,GAAG;QACZ,YAAY;QACZ,iBAAiB,OAAO,aAAa,OAAO,MAAM;QAClD,EAAE;QACF,IAAI;QACJ,GAAG;QACH,aAAa;QACb,EAAE;QACF,UAAU;QACV,EAAE;KACH,CAAC;IAEF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;;GAGG;AACH,SAAgB,oBAAoB,CAAC,OAAe;IAClD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,yBAAyB,CAAC,CAAC;IACvD,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AACjC,CAAC"}

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@memnexus-ai/cli",
-  "version": "1.7.176",
+  "version": "1.7.177",
   "description": "Command-line interface for MemNexus Core API",
   "main": "dist/index.js",
   "bin": {