@atrib/trace 0.5.14 → 0.5.15

package/README.md

@@ -1,8 +1,8 @@
 # @atrib/trace
 
-MCP server exposing the `trace` tool, walks a record's `informed_by` chain backward to surface the reasoning chain that led to it.
+MCP server exposing the `trace` tool, walks a record's `informed_by` chain backward to surface the signed relationship path that led to it.
 
-Closes the consumer-side cognitive-loop primitive: recall returns raw records; trace returns the causal chain, so an agent asking "why did I do X?" can see "X was informed by Y, which was informed by Z" without manually walking `informed_by` hash-by-hash.
+Closes the consumer-side cognitive-loop primitive: recall returns raw records; trace returns the declared-relationship trace, so an agent asking "why did I do X?" can see "X was claimed to be informed by Y, which was claimed to be informed by Z" without manually walking `informed_by` hash-by-hash.
 
 ## Tools
 
@@ -43,7 +43,7 @@ mcp__atrib-trace__trace_forward({  // FORWARD — what was informed by this?
 }
 ```
 
-- `trace` walks `informed_by` BACKWARD (toward causal ancestors). Answers "what informed this record?"
+- `trace` walks `informed_by` BACKWARD (toward declared ancestors). Answers "what did the signer claim informed this record?"
 - `trace_forward` walks `informed_by` FORWARD (records that cited this one). Answers "I made decision X, what did I do because of it?" The dual of `trace`. Same input schema, same response shape.
 - For forward walks, `next_informed_by` carries the CHILDREN visited at the next hop (records citing this one) rather than this record's own informed_by — field name kept for shape-compat with `trace`.
 

package/dist/index.d.ts

@@ -3,9 +3,9 @@
  * informed_by chain backward to surface the reasoning chain that led to it.
  *
  * Closes the consumer-side cognitive-loop primitive: recall returns raw
- * records; trace returns the causal chain, so an agent asking "why did
- * I do X?" can see "X was informed by Y, which was informed by Z" without
- * manually walking informed_by hash-by-hash.
+ * records; trace returns the declared-relationship path, so an agent asking
+ * "why did I do X?" can see "X claimed Y as input, and Y claimed Z as input"
+ * without manually walking informed_by hash-by-hash.
  *
  * Reads only the local mirror (~/.atrib/records/*.jsonl) for v1, same scope
  * as recall. v2 will fall back to log.atrib.dev/v1/lookup/<hash> for hashes
@@ -42,6 +42,8 @@ interface CompactVisited {
         model_name?: string;
         prompt_version?: string;
         topics?: string[];
+        intent?: string;
+        rationale?: string;
         /**
          * First 200 chars of the record's human-readable content, derived
          * per event_type from the @atrib/mcp normative shapes (D086):

package/dist/index.js

@@ -4,9 +4,9 @@
  * informed_by chain backward to surface the reasoning chain that led to it.
  *
  * Closes the consumer-side cognitive-loop primitive: recall returns raw
- * records; trace returns the causal chain, so an agent asking "why did
- * I do X?" can see "X was informed by Y, which was informed by Z" without
- * manually walking informed_by hash-by-hash.
+ * records; trace returns the declared-relationship path, so an agent asking
+ * "why did I do X?" can see "X claimed Y as input, and Y claimed Z as input"
+ * without manually walking informed_by hash-by-hash.
  *
  * Reads only the local mirror (~/.atrib/records/*.jsonl) for v1, same scope
  * as recall. v2 will fall back to log.atrib.dev/v1/lookup/<hash> for hashes
@@ -15,30 +15,55 @@
  */
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { z } from 'zod';
-import { resolveEnvContextId, logReadPrimitiveCall, } from '@atrib/mcp';
+import { resolveEnvContextId, logReadPrimitiveCall } from '@atrib/mcp';
 import { loadAllRecords } from './storage.js';
 import { traceBackward, traceForward } from './trace.js';
 const SHA256_REF_PATTERN = /^sha256:[0-9a-f]{64}$/;
 const HEX_32_PATTERN = /^[0-9a-f]{32}$/;
 const TraceInput = z.object({
-    record_hash: z.string().regex(SHA256_REF_PATTERN).describe("The 'sha256:<64-hex>' record_hash to start from. Walks backward via " +
+    record_hash: z
+        .string()
+        .regex(SHA256_REF_PATTERN)
+        .describe("The 'sha256:<64-hex>' record_hash to start from. Walks backward via " +
         'informed_by edges from this record.'),
-    context_id: z.string().regex(HEX_32_PATTERN).optional().describe('Optional 32-hex context_id scope. When set, edges crossing into a ' +
+    context_id: z
+        .string()
+        .regex(HEX_32_PATTERN)
+        .optional()
+        .describe('Optional 32-hex context_id scope. When set, edges crossing into a ' +
         'different context_id surface as dangling rather than expanding the ' +
         'walk. Defaults to process.env.ATRIB_CONTEXT_ID when valid; omit at ' +
         'the env-var level to walk cross-context. Used by Inspect-style ' +
-        'harnesses to keep each arm\'s trace inside its own context per D072.'),
-    depth: z.number().int().min(0).max(10).optional().describe('Maximum hop count from the starting record. Use 0 to return only ' +
+        "harnesses to keep each arm's trace inside its own context per D072."),
+    depth: z
+        .number()
+        .int()
+        .min(0)
+        .max(10)
+        .optional()
+        .describe('Maximum hop count from the starting record. Use 0 to return only ' +
         'the start record. Defaults to 3. Bounded ' +
         'at 10 to keep responses tractable; deeper chains should be walked ' +
         'in pieces by re-rooting at a returned upstream hash.'),
-    max_nodes: z.number().int().min(1).max(500).optional().describe('Hard cap on total visited records. Defaults to 200. Prevents pathological ' +
+    max_nodes: z
+        .number()
+        .int()
+        .min(1)
+        .max(500)
+        .optional()
+        .describe('Hard cap on total visited records. Defaults to 200. Prevents pathological ' +
         'fan-out (a record with hundreds of informed_by entries) from exploding ' +
         'the response.'),
-    compact: z.boolean().optional().describe('When true (the default), per-record output omits signature/content_id/' +
+    compact: z
+        .boolean()
+        .optional()
+        .describe('When true (the default), per-record output omits signature/content_id/' +
         'spec_version/chain_root to keep the response small. Set false for full ' +
         'record bytes (useful for re-verification).'),
-    include_content: z.boolean().optional().describe('When true and compact=true, include the D062 local mirror body as ' +
+    include_content: z
+        .boolean()
+        .optional()
+        .describe('When true and compact=true, include the D062 local mirror body as ' +
         'local_content and local_producer on each visited record. Defaults false ' +
         'so trace stays cheap for ordinary causal walks.'),
 });
@@ -65,8 +90,17 @@ export function summarizeSidecar(loadedRecord) {
         out.model_name = c['model_name'];
     if (c && typeof c['prompt_version'] === 'string')
         out.prompt_version = c['prompt_version'];
+    if (c && typeof c['intent'] === 'string') {
+        out.intent = c['intent'].length > 200 ? c['intent'].slice(0, 197) + '...' : c['intent'];
+    }
+    if (c && typeof c['rationale'] === 'string') {
+        out.rationale =
+            c['rationale'].length > 200 ? c['rationale'].slice(0, 197) + '...' : c['rationale'];
+    }
     if (c && Array.isArray(c['topics'])) {
-        out.topics = c['topics'].filter((t) => typeof t === 'string').slice(0, 6);
+        out.topics = c['topics']
+            .filter((t) => typeof t === 'string')
+            .slice(0, 6);
     }
     // Per-event_type human-readable text. The `what` slot here is generic
     // (it's the human-scannable summary regardless of event_type); the
@@ -146,8 +180,9 @@ export function extractRecordHashFieldsFromMcpResult(result) {
     const seen = new Set();
     const pattern = /^sha256:[0-9a-f]{64}$/;
     const content = result?.content;
-    const text = Array.isArray(content) && typeof content[0]?.text === 'string'
-        ? (content[0].text)
+    const text = Array.isArray(content) &&
+        typeof content[0]?.text === 'string'
+        ? content[0].text
         : undefined;
     let root = result;
     if (text) {
@@ -202,7 +237,7 @@ export async function createAtribTraceServer() {
     }
     mcp.registerTool('trace', {
         title: 'trace informed_by chain backward',
-        description: 'Walk a record\'s informed_by chain backward to surface the reasoning ' +
+        description: "Walk a record's informed_by chain backward to surface the reasoning " +
             'chain that led to it. Reads from the local signed-record mirror ' +
             '(~/.atrib/records/*.jsonl). Returns the records visited, parent links ' +
             'so the caller can reconstruct the tree, and dangling hashes (records ' +
@@ -226,7 +261,12 @@ export async function createAtribTraceServer() {
             ...(contextId ? { contextId } : {}),
         });
         return {
-            content: [{ type: 'text', text: JSON.stringify(buildPayload(result, byHash, compact, includeContent), null, 2) }],
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify(buildPayload(result, byHash, compact, includeContent), null, 2),
+                },
+            ],
         };
     }, extractRecordHashFieldsFromMcpResult));
     // Sibling tool: forward walk (records that cited THIS one). Mirrors
@@ -254,7 +294,12 @@ export async function createAtribTraceServer() {
             ...(contextId ? { contextId } : {}),
         });
         return {
-            content: [{ type: 'text', text: JSON.stringify(buildPayload(result, byHash, compact, includeContent), null, 2) }],
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify(buildPayload(result, byHash, compact, includeContent), null, 2),
+                },
+            ],
         };
     }, extractRecordHashFieldsFromMcpResult));
     return { mcp };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@atrib/trace",
-  "version": "0.5.14",
-  "description": "MCP server for atrib. Walks informed_by chains backward from a record_hash to surface the reasoning chain that produced it.",
+  "version": "0.5.15",
+  "description": "MCP server for atrib. Walks informed_by chains backward from a record_hash to surface the signed relationship path that produced it.",
   "author": "atrib <hello@atrib.dev>",
   "keywords": [
     "atrib",
@@ -13,7 +13,7 @@
     "cognitive-primitive",
     "trace",
     "provenance",
-    "causal-chain"
+    "lineage"
   ],
   "homepage": "https://atrib.dev",
   "license": "Apache-2.0",
@@ -25,7 +25,7 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",
     "zod": "^3.25.76",
-    "@atrib/mcp": "0.17.5"
+    "@atrib/mcp": "0.17.6"
   },
   "devDependencies": {
     "@types/node": "^25.9.2",