@atrib/annotate 0.2.27 → 0.2.29

package/README.md

@@ -61,6 +61,8 @@ Or run as a one-off subprocess via `pnpm --filter @atrib/annotate start`.
 - `ATRIB_AUTOCHAIN_SOURCE`: optional cross-producer chain inheritance source.
 - `ATRIB_LOG_ENDPOINT`: log.atrib.dev override (e.g. for self-hosted log nodes).
 - `ATRIB_CONTEXT_ID`: default context_id per [D078](https://github.com/creatornader/atrib/blob/main/DECISIONS.md#d078-mcp-servers-honor-atrib_context_id-env-as-context_id-default).
+- `ATRIB_LOCAL_SUBSTRATE_ENDPOINT` + `ATRIB_LOCAL_SUBSTRATE_MODE=shadow`: opt-in P042 local-substrate shadow probe inherited from `@atrib/emit`. The annotation is still signed, mirrored, and queued locally.
+- `ATRIB_LOCAL_SUBSTRATE_TIMEOUT_MS`: optional timeout for that shadow probe.
 
 ## Relationship to @atrib/emit
 

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { z } from 'zod';
-import { type ResolvedKey } from '@atrib/emit';
+import { type EmitLocalSubstrateShadowOptions, type ResolvedKey } from '@atrib/emit';
 export declare const Importance: z.ZodEnum<{
     critical: "critical";
     high: "high";
@@ -33,6 +33,11 @@ export interface CreateAtribAnnotateServerOptions {
     key?: ResolvedKey;
     /** Override the log endpoint (defaults to env or @atrib/mcp default). */
     logEndpoint?: string | undefined;
+    /**
+     * Optional long-lived-agent local substrate shadow probe. `undefined` reads
+     * opt-in env config; `false` disables env config for this server.
+     */
+    localSubstrate?: EmitLocalSubstrateShadowOptions | false | undefined;
 }
 /**
  * Wire up the atrib-annotate MCP server with one `atrib-annotate` tool.

package/dist/index.js

@@ -16,7 +16,7 @@
 //   - Persists to the same JSONL mirror convention as atrib-emit
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { z } from 'zod';
-import { handleEmit, resolveKey, } from '@atrib/emit';
+import { resolveEmitLocalSubstrateShadowFromEnv, handleEmit, resolveKey, } from '@atrib/emit';
 import { createSubmissionQueue, EVENT_TYPE_ANNOTATION_URI, } from '@atrib/mcp';
 const SHA256_REF_PATTERN = /^sha256:[0-9a-f]{64}$/;
 const HEX_32_PATTERN = /^[0-9a-f]{32}$/;
@@ -52,6 +52,13 @@ export async function createAtribAnnotateServer(options = {}) {
     const key = options.key ?? (await resolveKey());
     const logEndpoint = options.logEndpoint ?? process.env['ATRIB_LOG_ENDPOINT'];
     const queue = createSubmissionQueue(logEndpoint);
+    const localSubstrate = options.localSubstrate === false
+        ? undefined
+        : (options.localSubstrate ??
+            resolveEmitLocalSubstrateShadowFromEnv({
+                producer: 'atrib-annotate',
+                transport: 'stdio-mcp-server',
+            }));
     const mcp = new McpServer({ name: 'atrib-annotate', version: '0.1.0' });
     mcp.registerTool('atrib-annotate', {
         description: 'Mark a past record\'s importance and meaning without superseding it. ' +
@@ -78,6 +85,7 @@ export async function createAtribAnnotateServer(options = {}) {
             key,
             queue,
             producer: 'atrib-annotate',
+            localSubstrate,
         });
         const out = {
             record_hash: result.record_hash,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@atrib/annotate",
-  "version": "0.2.27",
+  "version": "0.2.29",
   "description": "MCP server for atrib. Lets agents mark a past record's importance and meaning. Adds an ANNOTATES graph edge so recall surfaces weighted annotations ahead of flat scans.",
   "author": "atrib <hello@atrib.dev>",
   "keywords": [
@@ -25,8 +25,8 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",
     "zod": "^3.25.76",
-    "@atrib/emit": "0.14.18",
-    "@atrib/mcp": "0.17.3"
+    "@atrib/emit": "0.14.20",
+    "@atrib/mcp": "0.17.5"
   },
   "devDependencies": {
     "@types/node": "^25.9.2",