trapic-mcp 0.1.3 → 0.1.4

package/bin/trapic-mcp.mjs

@@ -31,8 +31,8 @@ When the trapic-mcp MCP server is connected, automatically call \`trace_create\`
 - Important user preferences or project constraints learned
 
 **How to create traces:**
-- \`claim\`: One clear sentence describing what happened or was decided
-- \`reason\`: Why this decision was made or what caused it
+- \`content\`: One clear sentence describing what happened or was decided
+- \`context\`: Why this decision was made or what caused it
 - \`tags\`: **Always include the current project directory name as the first tag**, then add relevant tags (technology, category)
 - \`confidence\`: "high" for verified facts, "medium" for likely conclusions, "low" for hypotheses
 - \`source\`: "session" for conversation-derived traces
@@ -760,7 +760,7 @@ async function cmdStatus() {
 
     console.log("\nMost recent:");
     for (const t of traceList.slice(0, 5)) {
-      console.log(`  ${fmtDate(t.created_at)}  ${truncate(t.claim || t.title || "(no claim)", 70)}`);
+      console.log(`  ${fmtDate(t.created_at)}  ${truncate(t.content || "(no content)", 70)}`);
     }
     console.log();
   } catch (err) {
@@ -796,10 +796,10 @@ async function cmdSearch(query) {
       const tags = t.tags?.length ? `[${t.tags.join(", ")}]` : "";
       const conf = t.confidence || "";
 
-      console.log(`  ${sim.padEnd(7)} ${truncate(t.claim || "(no claim)", 65)}`);
+      console.log(`  ${sim.padEnd(7)} ${truncate(t.content || "(no content)", 65)}`);
       console.log(`          ${tags} ${conf} | ${fmtDate(t.created_at)}`);
-      if (t.reason) {
-        console.log(`          ${truncate(t.reason, 70)}`);
+      if (t.context) {
+        console.log(`          ${truncate(t.context, 70)}`);
       }
       console.log();
     }
@@ -838,10 +838,10 @@ async function cmdList() {
     for (const t of traces) {
       const tags = t.tags?.length ? `[${t.tags.join(", ")}]` : "";
       const conf = t.confidence ? t.confidence : "";
-      console.log(`  ${fmtDate(t.created_at)}  ${truncate(t.claim || "(no claim)", 60)}`);
+      console.log(`  ${fmtDate(t.created_at)}  ${truncate(t.content || "(no content)", 60)}`);
       console.log(`             ${tags} ${conf}`);
-      if (t.reason) {
-        console.log(`             ${truncate(t.reason, 65)}`);
+      if (t.context) {
+        console.log(`             ${truncate(t.context, 65)}`);
       }
       console.log();
     }

package/dist/conflict.js

@@ -13,6 +13,8 @@ A contradiction means the new trace says the OPPOSITE of an existing trace about
 - New: "Added pagination" vs Existing: "Added search" → NOT a conflict (different topics)
 - New: "Password min 8 chars" vs Existing: "Password min 6 chars" → CONFLICT (supersedes)
 
+Each trace has a "content" field (what was decided/discovered) and an optional "context" field (why).
+
 Return JSON:
 {
   "conflicts": [
@@ -53,13 +55,13 @@ export async function detectConflicts(traceId, userId) {
     const userMessage = JSON.stringify({
         new_trace: {
             id: trace.id,
-            claim: trace.content || trace.claim,
-            reason: trace.context || trace.reason,
+            content: trace.content || trace.claim,
+            context: trace.context || trace.reason,
         },
         existing_traces: candidates.slice(0, 5).map((t) => ({
             id: t.id,
-            claim: t.claim,
-            reason: t.reason,
+            content: t.content || t.claim,
+            context: t.context || t.reason,
             tags: t.tags,
         })),
     }, null, 2);

package/dist/tools/active.js

@@ -32,8 +32,8 @@ export function registerActive(server, userId) {
                 : (data ?? []);
             const traces = filtered.map((row) => ({
                 id: row.id,
-                claim: row.claim,
-                reason: row.reason,
+                content: row.content || row.claim,
+                context: row.context || row.reason,
                 tags: row.tags,
                 caused_by: row.caused_by,
                 confidence: row.confidence,

package/dist/tools/chain.js

@@ -31,8 +31,8 @@ export function registerChain(server, userId) {
                 : (data ?? []);
             const chain = filtered.map((row) => ({
                 id: row.id,
-                claim: row.claim,
-                reason: row.reason,
+                content: row.content || row.claim,
+                context: row.context || row.reason,
                 status: row.status,
                 tags: row.tags,
                 caused_by: row.caused_by,
@@ -88,8 +88,8 @@ export function registerChain(server, userId) {
                 : (data ?? []);
             const effects = filteredEffects.map((row) => ({
                 id: row.id,
-                claim: row.claim,
-                reason: row.reason,
+                content: row.content || row.claim,
+                context: row.context || row.reason,
                 status: row.status,
                 tags: row.tags,
                 caused_by: row.caused_by,

package/dist/tools/context.js

@@ -89,8 +89,8 @@ export async function contextualizeTrace(traceId) {
     const userMessage = JSON.stringify({
         new_trace: {
             id: trace.id,
-            claim: trace.claim,
-            reason: trace.reason,
+            content: trace.content || trace.claim,
+            context: trace.context || trace.reason,
             tags: trace.tags,
             author: trace.author,
         },
@@ -100,8 +100,8 @@ export async function contextualizeTrace(traceId) {
             resolution: c.resolution,
             vector_similarity: c.similarity,
             traces: c.traces.map((t) => ({
-                claim: t.claim,
-                reason: t.reason,
+                content: t.content,
+                context: t.context,
                 author: t.author,
                 role: t.role,
             })),
@@ -154,8 +154,6 @@ export async function contextualizeTrace(traceId) {
             resolution: "fragmented",
             embedding: summaryEmbedding,
             scope: trace.scope,
-            org_id: trace.org_id,
-            team_id: trace.team_id,
         })
             .select()
             .single();

package/dist/tools/create.js

@@ -55,15 +55,13 @@ export function registerCreate(server, userId) {
                         }],
                 };
             }
-            // Generate embedding from claim + reason
+            // Generate embedding from content + context
             const embeddingText = params.reason
                 ? `${params.claim} ${params.reason}`
                 : params.claim;
             const embedding = await generateEmbedding(embeddingText);
             // Use encrypted insert RPC
             const { data, error } = await supabase.rpc("insert_encrypted_trace", {
-                p_claim: params.claim,
-                p_reason: params.reason ?? null,
                 p_content: params.claim,
                 p_context: params.reason ?? null,
                 p_scope: params.scope,
@@ -73,7 +71,6 @@ export function registerCreate(server, userId) {
                 p_source: params.source,
                 p_source_id: params.source_id ?? null,
                 p_confidence: params.confidence,
-                p_references: params.references,
                 p_embedding: embedding,
             });
             if (error || !data?.id) {

package/dist/tools/extract.js

@@ -2,7 +2,7 @@ import { z } from "zod";
 import { llmChat } from "../llm.js";
 const EXTRACTION_SYSTEM_PROMPT = `You are a knowledge extraction engine for an organizational knowledge system called "Traces."
 
-A Trace is a minimal causal proposition — one clear statement (claim) with an optional reason (why).
+A Trace is a minimal causal proposition — one clear statement (content) with an optional context (why).
 
 Your job: given a text block (session transcript, meeting notes, discussion log), extract all meaningful propositions as candidate Traces.
 
@@ -17,8 +17,8 @@ Your job: given a text block (session transcript, meeting notes, discussion log)
 ## Extraction rules
 
 - Each trace = ONE proposition. Do not combine multiple ideas.
-- claim = what happened / what was concluded (one clear sentence)
-- reason = why (optional — some facts have no reason)
+- content = what happened / what was concluded (one clear sentence)
+- context = why (optional — some facts have no context/reason)
 - Auto-assign tags based on content (e.g., "architecture", "design", "api", "performance", "security", "ux", "database", "deployment", "process", "decision")
 - All extracted traces get confidence: "low" (they need human review)
 - Identify the type: conclusion, decision, rejection, discovery, or agreement
@@ -31,7 +31,7 @@ Your job: given a text block (session transcript, meeting notes, discussion log)
 
 ## Output format
 
-Return JSON: { "traces": [ { "claim": "...", "reason": "..." or null, "tags": [...], "type": "conclusion|decision|rejection|discovery|agreement" } ] }`;
+Return JSON: { "traces": [ { "content": "...", "context": "..." or null, "tags": [...], "type": "conclusion|decision|rejection|discovery|agreement" } ] }`;
 export function registerExtract(server) {
     server.tool("trapic_extract", "Extract candidate traces from a text block (session transcript, meeting notes, discussion). " +
         "Uses local LLM to identify conclusions, decisions, rejections, discoveries, and agreements. " +
@@ -55,8 +55,8 @@ export function registerExtract(server) {
                 const parsed = JSON.parse(content);
                 const rawCandidates = Array.isArray(parsed) ? parsed : (parsed.traces ?? parsed.results ?? []);
                 candidates = rawCandidates.map((c) => ({
-                    claim: String(c.claim ?? ""),
-                    reason: c.reason ? String(c.reason) : null,
+                    content: String(c.content || c.claim || ""),
+                    context: c.context || c.reason ? String(c.context || c.reason) : null,
                     tags: Array.isArray(c.tags) ? c.tags.map(String) : [],
                     source: params.source,
                     confidence: "low",
@@ -71,7 +71,7 @@ export function registerExtract(server) {
                         }],
                 };
             }
-            candidates = candidates.filter((c) => c.claim.trim().length > 0);
+            candidates = candidates.filter((c) => c.content.trim().length > 0);
             return {
                 content: [{
                         type: "text",

package/dist/tools/search.js

@@ -49,8 +49,8 @@ export function registerSearch(server, userId) {
                 : (data ?? []);
             const results = filtered.map((row) => ({
                 id: row.id,
-                claim: row.claim,
-                reason: row.reason,
+                content: row.content || row.claim,
+                context: row.context || row.reason,
                 status: row.status,
                 tags: row.tags,
                 caused_by: row.caused_by,

package/dist/tools/summary.js

@@ -6,7 +6,7 @@ import { llmChat } from "../llm.js";
 import { checkMonthlyQuota } from "../quota.js";
 const SUMMARY_EXTRACTION_PROMPT = `You are a knowledge extraction engine. Given a conversation summary, extract all key decisions, discoveries, and conclusions as Traces.
 
-A Trace is a minimal causal proposition — one clear statement (claim) with an optional reason (why).
+A Trace is a minimal causal proposition — one clear statement (content) with an optional context (why).
 
 ## What to extract
 
@@ -17,14 +17,14 @@ A Trace is a minimal causal proposition — one clear statement (claim) with an
 ## Rules
 
 - Each trace = ONE proposition. Do not combine multiple ideas.
-- claim = what happened / what was concluded (one clear sentence)
-- reason = why (optional — some facts have no reason)
+- content = what happened / what was concluded (one clear sentence)
+- context = why (optional — some facts have no context/reason)
 - Auto-assign tags based on content (e.g., "architecture", "design", "api", "performance", "security", "ux", "database", "deployment", "process", "decision")
 - Be thorough but avoid extracting trivial or obvious statements
 
 ## Output format
 
-Return JSON: { "traces": [{ "claim": "...", "reason": "..." or null, "tags": ["..."] }] }`;
+Return JSON: { "traces": [{ "content": "...", "context": "..." or null, "tags": ["..."] }] }`;
 export function registerSummary(server, userId) {
     server.tool("trapic_auto_summary", "Extract and create multiple traces from a conversation summary in one call. " +
         "Uses LLM to identify key decisions, discoveries, and conclusions, then writes them all to DB. " +
@@ -61,11 +61,11 @@ export function registerSummary(server, userId) {
                 const rawTraces = Array.isArray(parsed) ? parsed : (parsed.traces ?? parsed.results ?? []);
                 extracted = rawTraces
                     .map((t) => ({
-                    claim: String(t.claim ?? ""),
-                    reason: t.reason ? String(t.reason) : null,
+                    content: String(t.content || t.claim || ""),
+                    context: t.context || t.reason ? String(t.context || t.reason) : null,
                     tags: Array.isArray(t.tags) ? t.tags.map(String) : [],
                 }))
-                    .filter((t) => t.claim.trim().length > 0);
+                    .filter((t) => t.content.trim().length > 0);
             }
             catch {
                 return {
@@ -95,7 +95,7 @@ export function registerSummary(server, userId) {
             const created = [];
             const errors = [];
             // Batch embedding generation
-            const embeddingTexts = extracted.map((trace) => trace.reason ? `${trace.claim} ${trace.reason}` : trace.claim);
+            const embeddingTexts = extracted.map((trace) => trace.context ? `${trace.content} ${trace.context}` : trace.content);
             let embeddings;
             try {
                 embeddings = await generateEmbeddings(embeddingTexts);
@@ -118,8 +118,10 @@ export function registerSummary(server, userId) {
                     const { data, error } = await supabase
                         .from("traces")
                         .insert({
-                        claim: trace.claim,
-                        reason: trace.reason,
+                        content: trace.content,
+                        context: trace.context,
+                        claim: trace.content, // legacy column compat
+                        reason: trace.context, // legacy column compat
                         scope: "personal",
                         author: effectiveUserId,
                         tags: mergedTags,
@@ -133,14 +135,14 @@ export function registerSummary(server, userId) {
                         .select()
                         .single();
                     if (error) {
-                        throw new Error(`Failed to create trace "${trace.claim}": ${error.message}`);
+                        throw new Error(`Failed to create trace "${trace.content}": ${error.message}`);
                     }
                     // Contextualize (non-blocking failure)
                     await contextualizeTrace(data.id).catch(() => null);
                     return {
                         id: data.id,
-                        claim: data.claim,
-                        reason: data.reason,
+                        content: data.content || data.claim,
+                        context: data.context || data.reason,
                         tags: data.tags,
                     };
                 }));

package/dist/tools/update.js

@@ -3,8 +3,8 @@ import { getSupabase } from "../supabase.js";
 import { generateEmbedding } from "../embedding.js";
 import { audit } from "../audit.js";
 export function registerUpdate(server, userId) {
-    server.tool("trapic_update", "Update an existing trace — change status, tags, claim/reason, or mark as superseded. " +
-        "更新現有 trace — 可以變更狀態、標籤、claim/reason，或標記為被取代。", {
+    server.tool("trapic_update", "Update an existing trace — change status, tags, content/context, or mark as superseded. " +
+        "更新現有 trace — 可以變更狀態、標籤、content/context，或標記為被取代。", {
         trace_id: z.string().uuid().describe("ID of the trace to update. " +
             "要更新的 trace ID"),
         claim: z.string().optional().describe("Updated claim text. Will regenerate embedding if changed. " +
@@ -26,10 +26,14 @@ export function registerUpdate(server, userId) {
             const supabase = getSupabase();
             // Build update object with only provided fields
             const update = {};
-            if (params.claim !== undefined)
-                update.claim = params.claim;
-            if (params.reason !== undefined)
-                update.reason = params.reason;
+            if (params.claim !== undefined) {
+                update.content = params.claim;
+                update.claim = params.claim; // legacy column compat
+            }
+            if (params.reason !== undefined) {
+                update.context = params.reason;
+                update.reason = params.reason; // legacy column compat
+            }
             if (params.tags !== undefined)
                 update.tags = params.tags;
             if (params.confidence !== undefined)
@@ -44,12 +48,12 @@ export function registerUpdate(server, userId) {
             else if (params.status !== undefined) {
                 update.status = params.status;
             }
-            // Regenerate embedding if claim or reason changed
+            // Regenerate embedding if content or context changed
             if (params.claim !== undefined || params.reason !== undefined) {
-                // Fetch current trace to get existing claim/reason if only one changed
+                // Fetch current trace to get existing content/context if only one changed
                 let query = supabase
                     .from("traces")
-                    .select("claim, reason")
+                    .select("content, context, claim, reason")
                     .eq("id", params.trace_id);
                 if (userId)
                     query = query.eq("author", userId);
@@ -64,11 +68,11 @@ export function registerUpdate(server, userId) {
                         ],
                     };
                 }
-                const newClaim = params.claim ?? current.claim;
-                const newReason = params.reason ?? current.reason;
-                const embeddingText = newReason
-                    ? `${newClaim} ${newReason}`
-                    : newClaim;
+                const newContent = params.claim ?? current.content ?? current.claim;
+                const newContext = params.reason ?? current.context ?? current.reason;
+                const embeddingText = newContext
+                    ? `${newContent} ${newContext}`
+                    : newContent;
                 update.embedding = await generateEmbedding(embeddingText);
             }
             if (Object.keys(update).length === 0) {
@@ -111,8 +115,8 @@ export function registerUpdate(server, userId) {
                             message: "Trace updated successfully / Trace 更新成功",
                             trace: {
                                 id: data.id,
-                                claim: data.claim,
-                                reason: data.reason,
+                                content: data.content || data.claim,
+                                context: data.context || data.reason,
                                 status: data.status,
                                 superseded_by: data.superseded_by,
                                 tags: data.tags,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "trapic-mcp",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "description": "AI knowledge management MCP server — automatically capture, search, and connect decisions, facts, and conventions across AI coding sessions",
   "type": "module",
   "main": "dist/index.js",