bikky 0.3.2 → 0.3.3

package/dist/mcp/taxonomy.js

@@ -573,6 +573,76 @@ export function categoryPromptSection(category) {
 export function allCategoryPromptSections() {
     return Object.keys(CATEGORIES).map(categoryPromptSection).join("\n\n");
 }
+// ---------------------------------------------------------------------------
+// MCP enum descriptions — single source of truth shared with src/mcp/tools.ts
+// ---------------------------------------------------------------------------
+//
+// These render the canonical CATEGORIES / DOMAINS / KINDS / MEMORY_SUBTYPES /
+// SOURCES tables into the multiline strings agents see when they inspect a
+// tool schema. Keeping them here means tool descriptions never drift from
+// the ontology definitions above.
+function shortenDescription(text) {
+    // Collapse any whitespace and clip to the first sentence so per-value
+    // blurbs stay readable inside a tool schema description.
+    const collapsed = text.replace(/\s+/g, " ").trim();
+    const firstPeriod = collapsed.indexOf(". ");
+    if (firstPeriod > 0)
+        return collapsed.slice(0, firstPeriod + 1);
+    return collapsed;
+}
+/** Render the `category` enum description for memory_store / memory_recall. */
+export function categoryEnumDescription() {
+    const lines = Object.entries(CATEGORIES).map(([name, def]) => `  • ${name} — ${shortenDescription(def.description)}`);
+    return [
+        "Subject matter of the fact. One of:",
+        ...lines,
+        `Default when omitted: ${DEFAULT_CATEGORY}.`,
+    ].join("\n");
+}
+/** Render the `domain` enum description. */
+export function domainEnumDescription() {
+    const lines = Object.entries(DOMAINS).map(([name, def]) => `  • ${name} — ${shortenDescription(def.description)}`);
+    return [
+        "Activity profile that controls vocabulary and ranking. One of:",
+        ...lines,
+        `Default when omitted: ${DEFAULT_DOMAIN}.`,
+    ].join("\n");
+}
+/** Render the `kind` enum description. Telemetry is daemon-only — excluded. */
+export function kindEnumDescription() {
+    const lines = Object.entries(KINDS)
+        .filter(([name]) => name !== "telemetry")
+        .map(([name, def]) => `  • ${name} — ${shortenDescription(def.description)}`);
+    return [
+        "Knowledge form of the memory object. One of:",
+        ...lines,
+        `Default when omitted: ${DEFAULT_KIND}. (telemetry is reserved for the daemon.)`,
+    ].join("\n");
+}
+/**
+ * Render the `memory_subtype` enum description, grouped by kind so the agent
+ * knows which subtypes pair with which kind (the runtime enforces this via
+ * validateMemorySubtype).
+ */
+export function memorySubtypeEnumDescription() {
+    const groups = Object.entries(MEMORY_SUBTYPES)
+        .filter(([, subtypes]) => subtypes.length > 0)
+        .map(([kind, subtypes]) => `  • kind=${kind}: ${subtypes.join(", ")}`);
+    return [
+        "Optional finer-grained type within the kind. Only set when one of these clearly applies — otherwise leave blank.",
+        "Subtype must match the kind (validated server-side):",
+        ...groups,
+    ].join("\n");
+}
+/** Render the `source` enum description for memory_store. */
+export function sourceEnumDescription() {
+    const lines = Object.entries(SOURCES).map(([name, def]) => `  • ${name} — ${shortenDescription(def.description)}`);
+    return [
+        "Who created this memory. One of:",
+        ...lines,
+        `Default when omitted: ${DEFAULT_SOURCE}. Only override when the human explicitly asked you to remember this (use 'user').`,
+    ].join("\n");
+}
 export function memorySubtypeValues() {
     return Object.values(MEMORY_SUBTYPES).flat();
 }

package/dist/mcp/taxonomy.js.map

@@ -1 +1 @@
-{"version":3,"file":"taxonomy.js","sourceRoot":"","sources":["../../src/mcp/taxonomy.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"taxonomy.js","sourceRoot":"","sources":["../../src/mcp/taxonomy.ts"],"names":[],"mappings":"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"}

package/dist/mcp/tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/mcp/tools.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAqPzE,wBAAgB,aAAa,CAAC,GAAG,EAAE,SAAS,GAAG,IAAI,CAi9BlD"}
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/mcp/tools.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AA0PzE,wBAAgB,aAAa,CAAC,GAAG,EAAE,SAAS,GAAG,IAAI,CA4iClD"}

package/dist/mcp/tools.js

@@ -3,7 +3,7 @@
  */
 import crypto from "node:crypto";
 import { z } from "zod";
-import { STALENESS_DAYS, THRESHOLD_DUPLICATE, THRESHOLD_RELATED, QDRANT_INDEXES, categoryValues, domainValues, kindValues, memorySubtypeValues, sourceValues, DEFAULT_CATEGORY, DEFAULT_DOMAIN, DEFAULT_KIND, DEFAULT_SOURCE, categoryForMemorySubtype, layerForMemorySubtype, normalizeCategory, normalizeDomain, normalizeKind, validateMemorySubtype, } from "./taxonomy.js";
+import { STALENESS_DAYS, THRESHOLD_DUPLICATE, THRESHOLD_RELATED, QDRANT_INDEXES, categoryValues, categoryEnumDescription, domainValues, domainEnumDescription, kindValues, kindEnumDescription, memorySubtypeValues, memorySubtypeEnumDescription, sourceValues, sourceEnumDescription, DEFAULT_CATEGORY, DEFAULT_DOMAIN, DEFAULT_KIND, DEFAULT_SOURCE, categoryForMemorySubtype, layerForMemorySubtype, normalizeCategory, normalizeDomain, normalizeKind, validateMemorySubtype, } from "./taxonomy.js";
 import { contentHash, daysSince, lastActivityDate, computeCombinedScore, buildFilter, formatFact, MEMORY_RECALL_EXCLUDED_KINDS, } from "./helpers.js";
 import { ready, qdrantUrl, qdrantApiKey, setupError, setQdrantUrl, setQdrantApiKey, setReady, getCollection, log, embed, getEmbeddingConfig, qdrantReq, ensureCollection, qdrantUpsert, qdrantSearch, qdrantScroll, qdrantSetPayload, qdrantGetPoints, } from "./api.js";
 import { saveConfig, loadConfig } from "../config.js";
@@ -166,7 +166,11 @@ async function graphTraversal(primaryResults, limit, scope) {
 // ---------------------------------------------------------------------------
 export function registerTools(mcp) {
     // ── get_setup_status ────────────────────────────────────────────────────
-    mcp.tool("get_setup_status", "Check memory system status. Returns which credentials are configured and whether Qdrant and embeddings are reachable.", {}, async () => {
+    mcp.tool("get_setup_status", [
+        "Check whether the memory system is configured and reachable.",
+        "Use this when memory tools return a 'setup_required' error, or once at session start if you're not sure bikky is wired up. Reports which credentials are missing and includes onboarding instructions if anything is incomplete.",
+        "Read-only — safe to call any time.",
+    ].join(" "), {}, async () => {
         const status = {
             ready,
             qdrant_url: !!qdrantUrl,
@@ -206,7 +210,10 @@ export function registerTools(mcp) {
         return { content: [{ type: "text", text: JSON.stringify(status, null, 2) }] };
     });
     // ── configure_credentials ───────────────────────────────────────────────
-    mcp.tool("configure_credentials", "Store Qdrant + embedding credentials in ~/.bikky/config.json. Tests connectivity and creates the collection if needed.", {
+    mcp.tool("configure_credentials", [
+        "Persist Qdrant and embedding credentials to ~/.bikky/config.json and bring the memory system online.",
+        "Call this only during onboarding (or when rotating credentials). After it succeeds, the collection is created if missing and embeddings are tested. For day-to-day use, prefer get_setup_status.",
+    ].join(" "), {
         qdrant_url: z.string().optional().describe("Qdrant REST URL — Qdrant Cloud (https://xxx.cloud.qdrant.io:6333), local Docker (http://localhost:6333), or self-hosted"),
         qdrant_api_key: z.string().optional().describe("Qdrant API key — required for Qdrant Cloud; optional / leave blank for unauthenticated local or self-hosted instances"),
         openai_api_key: z.string().optional().describe("OpenAI API key (for OpenAI embedding/LLM provider)"),
@@ -252,7 +259,11 @@ export function registerTools(mcp) {
         return { content: [{ type: "text", text: JSON.stringify(results, null, 2) }] };
     });
     // ── verify_connection ───────────────────────────────────────────────────
-    mcp.tool("verify_connection", "Test that Qdrant is reachable, embeddings work, and the collection exists.", {}, async () => {
+    mcp.tool("verify_connection", [
+        "Confirm Qdrant is reachable, embeddings work, and the collection exists.",
+        "Use this to debug a sudden 'setup_required' or empty-recall after a network blip or credential change. Lighter than configure_credentials — does not write to disk.",
+        "Read-only.",
+    ].join(" "), {}, async () => {
         const results = { qdrant: false, embedding: false, collection: false };
         if (qdrantUrl) {
             try {
@@ -281,39 +292,36 @@ export function registerTools(mcp) {
         return { content: [{ type: "text", text: JSON.stringify(results, null, 2) }] };
     });
     // ── memory_store ────────────────────────────────────────────────────────
-    mcp.tool("memory_store", "Store a new fact in memory. Automatically deduplicates via content hash and vector similarity. " +
-        "Returns the action taken (inserted/reinforced/duplicate) and any similar facts found.", {
-        content: z.string().describe("The fact to store (atomic, single piece of knowledge)"),
-        category: z.enum(categoryValues())
-            .describe("Subject matter: codebase, infrastructure, operations, decisions, product_domain, projects, people, preferences, observations"),
-        entities: z.array(z.string()).describe("Related entities (lowercase, e.g. ['qdrant', 'platform'])"),
-        domain: z.enum(domainValues()).default(DEFAULT_DOMAIN)
-            .describe("Activity profile — e.g. software_engineering, product_strategy, business_operations, research, personal_productivity"),
-        kind: z.enum(kindValues()).default(DEFAULT_KIND)
-            .describe("Knowledge form — fact, summary, distilled, relation"),
-        memory_subtype: z.enum(memorySubtypeValues()).optional()
-            .describe("Optional subtype within kind, such as codebase_map, episode, workstream, convention, or recall_event"),
-        workspace_id: z.string().optional()
-            .describe("Optional workspace namespace for team memory."),
-        episode_id: z.string().optional().describe("Optional coherent episode identifier"),
-        workstream_key: z.string().optional().describe("Optional durable workstream key"),
-        task_key: z.string().optional().describe("Optional task or issue key"),
-        repo: z.string().optional().describe("Optional repository or project surface"),
-        branch: z.string().optional().describe("Optional branch or working surface"),
-        review_status: z.enum(["candidate", "reviewed", "approved", "rejected"]).optional()
-            .describe("Optional review lifecycle status"),
-        source: z.enum(sourceValues()).default(DEFAULT_SOURCE)
-            .describe("Creator — agent, daemon, system, user"),
-        confidence: z.number().min(0).max(1).default(0.9).describe("How certain (0.0-1.0)"),
-        importance: z.number().min(0).max(1).optional().describe("How important (0.0-1.0). Omit to default to 0.5."),
-        supersedes: z.string().optional().describe("ID of a fact this one replaces"),
+    mcp.tool("memory_store", [
+        "Persist one atomic fact to long-term memory.",
+        "Call this whenever you learn something a future session would need: a service detail, a decision rationale, a workaround, a user preference, an ownership fact, a task-resume pointer. One fact per call — split compound observations into separate calls.",
+        "Dedup is automatic (content hash + vector similarity), so you do NOT need to recall first. The tool returns one of: inserted (new fact), reinforced (exact or near-duplicate found — counters bumped), or — if there are similar-but-different facts — a list of potential conflicts so you can decide whether to use 'supersedes'.",
+        "To create a typed edge between two entities at the same time, set the optional 'relation' field — no separate tool call needed.",
+        "Do NOT use for ephemeral state (current cursor, in-flight todo). Use the harness task folder instead.",
+    ].join(" "), {
+        content: z.string().describe("The fact to store. Should be one atomic, self-contained statement (no compound 'A and B') that makes sense out of context."),
+        category: z.enum(categoryValues()).describe(categoryEnumDescription()),
+        entities: z.array(z.string()).describe("Lowercase entity names mentioned by this fact (e.g. ['qdrant', 'workspace_id']). Used for entity-scoped recall and graph traversal — keep them short and canonical."),
+        domain: z.enum(domainValues()).default(DEFAULT_DOMAIN).describe(domainEnumDescription()),
+        kind: z.enum(kindValues()).default(DEFAULT_KIND).describe(kindEnumDescription()),
+        memory_subtype: z.enum(memorySubtypeValues()).optional().describe(memorySubtypeEnumDescription()),
+        workspace_id: z.string().optional().describe("Workspace namespace for team-shared memory. Omit to use the default workspace from config."),
+        episode_id: z.string().optional().describe("Coherent activity-segment ID. Group facts captured during the same coherent task or transcript."),
+        workstream_key: z.string().optional().describe("Durable continuity key for a long-running objective (survives across sessions)."),
+        task_key: z.string().optional().describe("Task or issue key (e.g. GitHub issue number, JIRA key)."),
+        repo: z.string().optional().describe("Repository or project surface this fact relates to (e.g. 'bikky-dev/bikky')."),
+        branch: z.string().optional().describe("Branch or working surface (e.g. 'main', 'feat/x')."),
+        review_status: z.enum(["candidate", "reviewed", "approved", "rejected"]).optional().describe("Review lifecycle status. candidate=auto-extracted (daemon), reviewed=human-checked, approved=human-confirmed, rejected=incorrect. Agents normally leave this unset."),
+        source: z.enum(sourceValues()).default(DEFAULT_SOURCE).describe(sourceEnumDescription()),
+        confidence: z.number().min(0).max(1).default(0.9).describe("How certain you are this fact is correct (0.0-1.0). Default 0.9. Lower (~0.6) for inferred or unverified facts."),
+        importance: z.number().min(0).max(1).optional().describe("How important this fact is for future recall (0.0-1.0). Defaults to 0.5 if omitted. ≥0.8 surfaces in session briefings."),
+        supersedes: z.string().optional().describe("ID of an existing fact that this one replaces. The old fact is marked superseded and excluded from recall. Use this when a fact is updated; use memory_forget when a fact was simply wrong."),
         relation: z.object({
-            from: z.string().describe("Source entity"),
-            type: z.string().describe("Relation type (owns, uses, decided, prefers, works-on, etc.)"),
-            to: z.string().describe("Target entity"),
-        }).optional().describe("Optional typed relation between two entities"),
-        metadata: z.record(z.string(), z.string()).optional()
-            .describe("Optional key-value metadata. Stored with the fact and filterable via memory_recall."),
+            from: z.string().describe("Source entity (lowercase)."),
+            type: z.string().describe("Relation type (e.g. 'owns', 'uses', 'decided', 'prefers', 'works-on')."),
+            to: z.string().describe("Target entity (lowercase)."),
+        }).optional().describe("Optional typed edge between two entities — created in the same call. Use this whenever the fact also expresses a relationship; no separate tool call needed."),
+        metadata: z.record(z.string(), z.string()).optional().describe("Arbitrary key-value metadata. Stored with the fact and exact-match filterable via memory_recall.metadata_filter (all key/value pairs must match — AND logic)."),
     }, async ({ content, category, entities, domain, kind, memory_subtype, workspace_id, episode_id, workstream_key, task_key, repo, branch, review_status, source, confidence, importance, supersedes, relation, metadata, }) => {
         const guard = requireReady();
         if (guard)
@@ -556,29 +564,34 @@ export function registerTools(mcp) {
         return { content: [{ type: "text", text: JSON.stringify(result) }] };
     });
     // ── memory_recall ───────────────────────────────────────────────────────
-    mcp.tool("memory_recall", "Semantic search over memory. Returns facts ranked by relevance. " +
-        "Use on session start with a broad query for context briefing.", {
-        query: z.string().describe("What to search for (natural language)"),
-        category: z.string().optional().describe("Filter by category"),
-        domain: z.string().optional().describe("Filter by domain activity profile"),
-        kind: z.string().optional().describe("Filter by kind (fact, summary, distilled, relation)"),
-        memory_subtype: z.string().optional().describe("Filter by memory subtype"),
-        workspace_id: z.string().optional().describe("Filter by optional workspace namespace."),
-        include_legacy_workspace: z.boolean().optional()
-            .describe("Include legacy facts without workspace_id in this workspace query."),
-        entity: z.string().optional().describe("Filter by entity name"),
-        episode_id: z.string().optional().describe("Filter by coherent episode ID"),
-        workstream_key: z.string().optional().describe("Filter by durable workstream key"),
-        task_key: z.string().optional().describe("Filter by task or issue key"),
-        repo: z.string().optional().describe("Filter by repository or project surface"),
-        branch: z.string().optional().describe("Filter by branch or working surface"),
-        review_status: z.string().optional().describe("Filter by review lifecycle status"),
-        since: z.string().optional().describe("Only facts created after this ISO date"),
-        until: z.string().optional().describe("Only facts created before this ISO date"),
-        limit: z.number().optional().default(10).describe("Max results (default 10)"),
-        graph_depth: z.number().optional().default(0).describe("Entity graph traversal depth (0=none, 1=include 1-hop related entity facts)."),
-        metadata_filter: z.record(z.string(), z.string()).optional()
-            .describe("Filter by metadata key-value pairs. All pairs must match."),
+    mcp.tool("memory_recall", [
+        "Semantic + filtered search over memory. Returns facts ranked by relevance (vector similarity blended with recency, importance, and reinforcement).",
+        "Three main uses:",
+        "  1. Session-start briefing — broad query like 'session briefing: user preferences, active projects, recent decisions'.",
+        "  2. Per-prompt contextual recall — focused query derived from what the user just asked.",
+        "  3. Pre-store conflict check — recall similar facts before storing, so you can use 'supersedes' if the new fact replaces an older one.",
+        "Combine the natural-language query with structured filters (category, domain, entity, date range, metadata) for tighter results.",
+        "If you have a known entity name and want everything about it, prefer memory_entity. For 'what does X own/use?' style questions, prefer memory_relations.",
+    ].join("\n"), {
+        query: z.string().describe("Natural-language description of what you're looking for. Embedded and matched semantically — full sentences work better than keyword lists."),
+        category: z.string().optional().describe("Filter by category (same vocabulary as memory_store.category). Optional."),
+        domain: z.string().optional().describe("Filter by domain activity profile (same vocabulary as memory_store.domain). Optional."),
+        kind: z.string().optional().describe("Filter by kind: fact, summary, distilled, relation. Optional. Telemetry is excluded by default."),
+        memory_subtype: z.string().optional().describe("Filter by memory subtype (must be valid for the chosen kind). Optional."),
+        workspace_id: z.string().optional().describe("Filter to facts in this workspace namespace. Omit to use the default workspace from config."),
+        include_legacy_workspace: z.boolean().optional().describe("Backwards-compatibility flag: also include legacy facts that have no workspace_id. Default false. Only set this if you suspect pre-migration data is missing from results."),
+        entity: z.string().optional().describe("Restrict to facts mentioning this entity (case-insensitive). For full entity context prefer memory_entity."),
+        episode_id: z.string().optional().describe("Filter by coherent episode ID."),
+        workstream_key: z.string().optional().describe("Filter by durable workstream key."),
+        task_key: z.string().optional().describe("Filter by task or issue key."),
+        repo: z.string().optional().describe("Filter by repository or project surface."),
+        branch: z.string().optional().describe("Filter by branch or working surface."),
+        review_status: z.string().optional().describe("Filter by review lifecycle status (candidate / reviewed / approved / rejected)."),
+        since: z.string().optional().describe("Only facts created on or after this ISO 8601 date or datetime."),
+        until: z.string().optional().describe("Only facts created on or before this ISO 8601 date or datetime."),
+        limit: z.number().optional().default(10).describe("Max results to return (default 10)."),
+        graph_depth: z.number().optional().default(0).describe("Entity-graph traversal depth. 0 = vector search only (fast, default). 1 = also surface 1-hop entity-related facts (slower; use when the user asks 'what's connected to X?')."),
+        metadata_filter: z.record(z.string(), z.string()).optional().describe("Exact-match filter on the metadata map stored with each fact. All key/value pairs must match (AND logic)."),
     }, async ({ query, category, domain, kind, memory_subtype, workspace_id, include_legacy_workspace, entity, episode_id, workstream_key, task_key, repo, branch, review_status, since, until, limit, graph_depth, metadata_filter, }) => {
         const guard = requireReady();
         if (guard)
@@ -641,12 +654,15 @@ export function registerTools(mcp) {
         return { content: [{ type: "text", text: lines.join("\n") }] };
     });
     // ── memory_entity ───────────────────────────────────────────────────────
-    mcp.tool("memory_entity", "Get everything known about an entity — all facts mentioning it plus its relationships.", {
-        name: z.string().describe("Entity name (e.g. 'qdrant', 'platform')"),
-        limit: z.number().optional().default(20).describe("Max facts to return"),
-        workspace_id: z.string().optional().describe("Filter by optional workspace namespace."),
-        include_legacy_workspace: z.boolean().optional()
-            .describe("Include legacy facts without workspace_id in this workspace query."),
+    mcp.tool("memory_entity", [
+        "Get everything bikky knows about a specific entity — facts mentioning it plus typed relations into and out of it.",
+        "Prefer this over memory_recall when the user asks 'tell me about X' or 'what do we know about X' and X is a known entity name (service, person, repo, concept). Faster and more complete than semantic search for entity-centric queries.",
+        "If you only have a fuzzy description, use memory_recall first to find the entity name.",
+    ].join(" "), {
+        name: z.string().describe("Entity name (case-insensitive, e.g. 'qdrant', 'workspace_id'). Should match the lowercase canonical form used when facts were stored."),
+        limit: z.number().optional().default(20).describe("Max facts to return (default 20). Relations are always returned in full, capped at 50 each direction."),
+        workspace_id: z.string().optional().describe("Workspace namespace. Omit to use the default from config."),
+        include_legacy_workspace: z.boolean().optional().describe("Backwards-compatibility: also include legacy facts with no workspace_id. Default false."),
     }, async ({ name, limit, workspace_id, include_legacy_workspace }) => {
         const guard = requireReady();
         if (guard)
@@ -696,14 +712,16 @@ export function registerTools(mcp) {
         return { content: [{ type: "text", text: output.join("\n") }] };
     });
     // ── memory_relations ────────────────────────────────────────────────────
-    mcp.tool("memory_relations", "Query entity relationships. Returns typed edges between entities.", {
-        entity: z.string().describe("Entity name to query"),
-        relation_type: z.string().optional().describe("Filter by relation type (e.g. 'owns', 'uses', 'decided')"),
-        direction: z.enum(["from", "to", "both"]).optional().default("both")
-            .describe("Direction: 'from' (entity as source), 'to' (entity as target), 'both'"),
-        workspace_id: z.string().optional().describe("Filter by optional workspace namespace."),
-        include_legacy_workspace: z.boolean().optional()
-            .describe("Include legacy facts without workspace_id in this workspace query."),
+    mcp.tool("memory_relations", [
+        "Query typed edges between entities. Returns 'A --[type]--> B' triples that semantic search alone wouldn't surface.",
+        "Use for 'what does X own / use / depend on?' and 'who owns Y?' style questions. Optionally filter by direction (from / to / both) and relation type.",
+        "To create relations, use memory_store with the 'relation' field — there is no separate create-relation tool.",
+    ].join(" "), {
+        entity: z.string().describe("Entity name to query (case-insensitive)."),
+        relation_type: z.string().optional().describe("Filter to a specific edge label (e.g. 'owns', 'uses', 'decided', 'prefers', 'works-on'). Optional."),
+        direction: z.enum(["from", "to", "both"]).optional().default("both").describe("Which side of the edge the entity is on. 'from' = entity is the source (X --[?]--> ?). 'to' = entity is the target (? --[?]--> X). 'both' = either (default)."),
+        workspace_id: z.string().optional().describe("Workspace namespace. Omit to use the default from config."),
+        include_legacy_workspace: z.boolean().optional().describe("Backwards-compatibility: also include legacy facts with no workspace_id. Default false."),
     }, async ({ entity, relation_type, direction, workspace_id, include_legacy_workspace }) => {
         const guard = requireReady();
         if (guard)
@@ -746,10 +764,13 @@ export function registerTools(mcp) {
         return { content: [{ type: "text", text: lines.join("\n") }] };
     });
     // ── memory_forget ───────────────────────────────────────────────────────
-    mcp.tool("memory_forget", "Mark a fact as superseded/wrong. The fact remains but is excluded from recall results.", {
-        fact_id: z.string().describe("ID of the fact to forget"),
-        reason: z.string().describe("Why this fact is being superseded"),
-        workspace_id: z.string().optional().describe("Optional workspace namespace."),
+    mcp.tool("memory_forget", [
+        "Mark a fact as superseded/wrong. The fact stays in storage (for audit) but is excluded from all recall results.",
+        "Use this when a fact was simply incorrect or no longer applies and there is no replacement. If you have a corrected version, use memory_store with 'supersedes: <fact_id>' instead — that way the new fact stays linked to the old one.",
+    ].join(" "), {
+        fact_id: z.string().describe("ID of the fact to forget (returned by memory_store / memory_recall as 'id')."),
+        reason: z.string().describe("Short human-readable reason this fact is being retired (stored in 'superseded_by' for future audit)."),
+        workspace_id: z.string().optional().describe("Workspace namespace. Omit to use the default from config."),
     }, async ({ fact_id, reason, workspace_id }) => {
         const guard = requireReady();
         if (guard)
@@ -779,9 +800,13 @@ export function registerTools(mcp) {
         }
     });
     // ── memory_verify ───────────────────────────────────────────────────────
-    mcp.tool("memory_verify", "Confirm a fact is still accurate. Resets the staleness clock and bumps verification count.", {
-        fact_id: z.string().describe("ID of the fact to verify"),
-        workspace_id: z.string().optional().describe("Optional workspace namespace."),
+    mcp.tool("memory_verify", [
+        "Confirm an existing fact is still accurate, without re-storing it. Resets the staleness clock and bumps a verification counter.",
+        "Use this when memory_heartbeat surfaces a stale fact ID and you can confirm it's still true (e.g. you just observed the system in that state). Lighter than memory_store(supersedes:) — same content, fresh timestamp.",
+        "If the fact is no longer true, use memory_forget or memory_store(supersedes:) instead.",
+    ].join(" "), {
+        fact_id: z.string().describe("ID of the fact to verify (from memory_recall or memory_heartbeat)."),
+        workspace_id: z.string().optional().describe("Workspace namespace. Omit to use the default from config."),
     }, async ({ fact_id, workspace_id }) => {
         const guard = requireReady();
         if (guard)
@@ -819,16 +844,17 @@ export function registerTools(mcp) {
         }
     });
     // ── memory_review ───────────────────────────────────────────────────────
-    mcp.tool("memory_review", "Review recent daemon-extracted facts. Supports approve (verify), reject (forget), or correct (supersede with edited text).", {
-        limit: z.number().optional().default(10).describe("Max facts to return (default 10)"),
-        action: z.enum(["list", "approve", "reject", "correct"]).optional().default("list")
-            .describe("Action: list, approve, reject, correct"),
-        fact_id: z.string().optional().describe("Fact ID (required for approve/reject/correct)"),
-        reason: z.string().optional().describe("Reason for rejection"),
-        corrected_content: z.string().optional().describe("Corrected fact text (for correct action)"),
-        workspace_id: z.string().optional().describe("Filter by optional workspace namespace."),
-        include_legacy_workspace: z.boolean().optional()
-            .describe("Include legacy facts without workspace_id in this workspace query."),
+    mcp.tool("memory_review", [
+        "Triage facts that were extracted automatically by the bikky daemon (source='daemon').",
+        "Only useful when the daemon is running and capturing memories from logs/transcripts; otherwise this returns an empty list. Supports four actions: list (default — show recent daemon facts), approve (mark verified), reject (mark superseded with reason), correct (replace with edited content as a new fact).",
+    ].join(" "), {
+        limit: z.number().optional().default(10).describe("Max facts to return when action=list (default 10)."),
+        action: z.enum(["list", "approve", "reject", "correct"]).optional().default("list").describe("What to do. list = show recent daemon-extracted facts (default). approve = confirm a fact is correct (bumps verification count). reject = mark a fact as wrong (requires 'reason'). correct = supersede with an edited version (requires 'corrected_content')."),
+        fact_id: z.string().optional().describe("Fact ID to act on. Required for approve / reject / correct."),
+        reason: z.string().optional().describe("Required for action=reject. Short reason the fact is wrong."),
+        corrected_content: z.string().optional().describe("Required for action=correct. The fixed fact text. Stored as a new fact that supersedes the original."),
+        workspace_id: z.string().optional().describe("Workspace namespace. Omit to use the default from config."),
+        include_legacy_workspace: z.boolean().optional().describe("Backwards-compatibility: also include legacy facts with no workspace_id. Default false."),
     }, async ({ limit, action, fact_id, reason, corrected_content, workspace_id, include_legacy_workspace }) => {
         const guard = requireReady();
         if (guard)
@@ -947,7 +973,10 @@ export function registerTools(mcp) {
         return { content: [{ type: "text", text: `Unknown action: ${String(action)}` }] };
     });
     // ── memory_heartbeat ────────────────────────────────────────────────────
-    mcp.tool("memory_heartbeat", "Lightweight reflection check. Returns memory nudge (if no stores in 10+ min), staleness alerts (every 3rd call), and reflection prompt.", {}, async () => {
+    mcp.tool("memory_heartbeat", [
+        "Reflection check-in. Returns up to three things: a memory nudge if you haven't stored anything in 10+ minutes, stale-fact alerts every 3rd call (with IDs you can pass to memory_verify or memory_forget), and a reflection prompt asking whether the last few minutes of work produced anything worth storing.",
+        "Call periodically during interactive sessions — roughly every 10 minutes or every 3rd user prompt. No arguments. Cheap and read-only.",
+    ].join(" "), {}, async () => {
         heartbeatCount++;
         const sections = [];
         const nudge = buildMemoryNudge();