causantic 0.4.1 → 0.4.2

package/README.md

@@ -8,7 +8,7 @@
 
 **Long-term memory for Claude Code — local-first, graph-augmented, self-benchmarking.**
 
-No cloud. No API keys. No data leaves your machine. Runs entirely on your hardware with optional per-chunk encryption.
+No cloud. No data leaves your machine. Runs entirely on your hardware with optional per-chunk encryption. An optional Anthropic API key enables cluster topic labeling via Haiku — all core retrieval works without it.
 
 <p align="center">
 <strong>Long-term episodic memory for Claude Code</strong><br/>
@@ -192,18 +192,18 @@ Causantic installs 14 Claude Code slash commands (via `npx causantic init`) for
 
 | Skill | Description |
 |-------|-------------|
-| `/causantic-recall [query]` | Walk causal chains to reconstruct narrative (how did we solve X?) |
-| `/causantic-search [query]` | Ranked discovery across memory by relevance (what do I know about X?) |
-| `/causantic-predict <context>` | Surface relevant past context proactively for a given task |
-| `/causantic-explain [question]` | Answer "why" questions and explore codebase areas |
+| `/causantic-recall [query]` | Reconstruct how something happened — walks backward through causal chains (how did we solve X?) |
+| `/causantic-search [query]` | Broad discovery — find everything memory knows about a topic (what do I know about X?) |
+| `/causantic-predict <context>` | Surface what came after similar past situations — walks forward through causal chains (what's likely relevant next?) |
+| `/causantic-explain [question]` | Answer "why" questions using memory + codebase (why does X work this way?) |
 | `/causantic-debug [error]` | Search for prior encounters with an error (auto-extracts from conversation if no argument) |
 | `/causantic-resume` | Resume interrupted work — start-of-session briefing |
-| `/causantic-reconstruct [time]` | Reconstruct session context by time range |
-| `/causantic-summary [time]` | Summarize recent work across sessions |
+| `/causantic-reconstruct [time]` | Replay a past session chronologically by time range |
+| `/causantic-summary [time]` | Factual recap of what was done across recent sessions |
 | `/causantic-list-projects` | Discover available projects in memory |
 | `/causantic-status` | Check system health and memory statistics |
 | `/causantic-crossref [pattern]` | Search across all projects for reusable patterns |
-| `/causantic-retro [scope]` | Retrospective analysis across past sessions |
+| `/causantic-retro [scope]` | Surface recurring patterns, problems, and decisions across sessions |
 | `/causantic-cleanup` | Memory-informed codebase review and cleanup plan |
 | `/causantic-forget [query]` | Delete memory by topic, time range, or session (always previews first) |
 

package/dist/cli/skill-templates.js

@@ -1330,24 +1330,24 @@ Long-term memory is available via the \`causantic\` MCP server.
 ### Skills
 
 **Core retrieval:**
-- \`/causantic-recall [query]\` — Walk causal chains to reconstruct narrative (how did we solve X?)
-- \`/causantic-search [query]\` — Ranked discovery across memory by relevance (what do I know about X?)
-- \`/causantic-predict <context>\` — Surface relevant past context proactively for a given task
+- \`/causantic-recall [query]\` — Reconstruct how something happened — walks backward through causal chains (how did we solve X?)
+- \`/causantic-search [query]\` — Broad discovery — find everything memory knows about a topic (what do I know about X?)
+- \`/causantic-predict <context>\` — Surface what came after similar past situations — walks forward through causal chains (what's likely relevant next?)
 
 **Understanding & analysis:**
-- \`/causantic-explain [question]\` — Answer "why" questions and explore codebase areas
+- \`/causantic-explain [question]\` — Answer "why" questions using memory + codebase (why does X work this way?)
 - \`/causantic-debug [error]\` — Search for prior encounters with an error (auto-extracts from conversation if no argument)
 
 **Session & project navigation:**
-- \`/causantic-resume\` — Resume interrupted work (start-of-session briefing)
-- \`/causantic-reconstruct [time range]\` — Reconstruct session context by time
-- \`/causantic-summary [time range]\` — Summarize recent work across sessions
+- \`/causantic-resume\` — Resume interrupted work — start-of-session briefing
+- \`/causantic-reconstruct [time range]\` — Replay a past session chronologically by time range
+- \`/causantic-summary [time range]\` — Factual recap of what was done across recent sessions
 - \`/causantic-list-projects\` — Discover available projects
 - \`/causantic-status\` — Check system health and memory statistics
 
 **Cross-cutting analysis:**
 - \`/causantic-crossref [pattern]\` — Search across all projects for reusable patterns
-- \`/causantic-retro [scope]\` — Retrospective pattern analysis across sessions
+- \`/causantic-retro [scope]\` — Surface recurring patterns, problems, and decisions across sessions
 - \`/causantic-cleanup\` — Memory-informed codebase review and cleanup plan
 
 **Memory management:**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "causantic",
-  "version": "0.4.1",
+  "version": "0.4.2",
   "description": "Long-term memory for Claude Code — local-first, graph-augmented, self-benchmarking",
   "type": "module",
   "private": false,