@atrib/revise 0.2.41 → 1.0.1

package/README.md

@@ -1,5 +1,14 @@
 # @atrib/revise
 
+**Legacy home.** The write-verb implementation moved to
+[`@atrib/attest`](../atrib-attest/README.md) per the attest/recall rename
+([D164](../../DECISIONS.md#d164-attestrecall-verb-rename-and-primitive-surface-collapse)).
+Revision folds into `attest` with `ref: { kind: "revises", target, reason }`.
+This package re-exports the same surface and forwards the `atrib-revise`
+binary to `@atrib/attest`'s handlers. Records are byte-identical. The
+`atrib-revise` tool name stays mounted as a permanent alias during the
+alias window, alongside the new `attest` tool.
+
 MCP server exposing the `atrib-revise` tool for atrib's verifiable action layer. Supersedes a prior signed position with a stated reason, so the contradiction lands as a first-class graph node rather than a silent edit.
 
 Records are immutable per spec [§1.6](https://github.com/creatornader/atrib/blob/main/atrib-spec.md#16-immutability): once signed, the bytes are fixed forever. When the agent now holds a position incompatible with a prior claim, the only honest move is to sign a revision that points at the prior record, names the prior position, names the new one, and gives the reason. The prior record stays in the graph; the revision adds a REVISES edge that supersedes it. A reader walking the graph sees both, and any policy or recall pipeline that respects revision can prefer the latest.
@@ -93,7 +102,7 @@ Or run as a one-off subprocess via `pnpm --filter @atrib/revise start`.
 
 ## Status
 
-Published and maintained. Cognitive primitive #3 per [D079](https://github.com/creatornader/atrib/blob/main/DECISIONS.md#d079-the-six-core-cognitive-primitives--atribs-agent-facing-surface). Builds clean against `@atrib/mcp` and `@atrib/emit`'s public exports introduced in `@atrib/emit@0.8.0`. The companion specialized writer `@atrib/annotate` covers the importance-and-meaning primitive (annotation event_type).
+Deprecated on npm; superseded by `@atrib/attest` (`ref.kind: "revises"`), with the `atrib-revise` tool name mounted as a permanent alias. Historically cognitive primitive #3 per [D079](https://github.com/creatornader/atrib/blob/main/DECISIONS.md#d079-the-six-core-cognitive-primitives--atribs-agent-facing-surface). Builds clean against `@atrib/mcp` and `@atrib/emit`'s public exports introduced in `@atrib/emit@0.8.0`. The companion specialized writer `@atrib/annotate` covers the importance-and-meaning primitive (annotation event_type).
 
 ## License
 

package/dist/index.d.ts

@@ -1,36 +1,2 @@
-import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import { z } from 'zod';
-import { type EmitLocalSubstrateShadowOptions, type ResolvedKey } from '@atrib/emit';
-export declare const ReviseInput: z.ZodObject<{
-    revises: z.ZodString;
-    prior_position: z.ZodString;
-    new_position: z.ZodString;
-    reason: z.ZodString;
-    topics: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    context_id: z.ZodOptional<z.ZodString>;
-    informed_by: z.ZodOptional<z.ZodArray<z.ZodString>>;
-}, z.core.$strip>;
-export interface AtribReviseServer {
-    /** Underlying McpServer; expose for testing or composition. */
-    mcp: McpServer;
-    /** Drain pending submissions (for tests/shutdown). */
-    flush(): Promise<void>;
-}
-export interface CreateAtribReviseServerOptions {
-    /** Override the resolved key (primarily for testing). */
-    key?: ResolvedKey | null | undefined;
-    /** 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-revise MCP server with one `atrib-revise` tool.
- * Per D079: this is a specialized form of @atrib/emit; the underlying
- * signing pipeline is shared via handleEmit so revision records are
- * byte-identical regardless of which tool produced them.
- */
-export declare function createAtribReviseServer(options?: CreateAtribReviseServerOptions): Promise<AtribReviseServer>;
+export { ReviseInput, createAtribReviseServer, registerReviseTool, } from '@atrib/attest';
+export type { AtribReviseServer, CreateAtribReviseServerOptions } from '@atrib/attest';

package/dist/index.js

@@ -1,126 +1,8 @@
-// @atrib/revise MCP server: cognitive primitive #3 of D079.
-//
-// Specialized form of @atrib/emit that narrows the schema to the revision
-// event_type (spec §1.2.9 / D059). Per D079's package layering: depends on
-// @atrib/emit as the canonical record-signing surface and wraps handleEmit
-// with a narrow Zod schema enforcing the revision-specific required fields
-// (revises + reason + prior_position + new_position). The signing + chain
-// composition path is byte-identical to atrib-emit's; a verifier MUST NOT
-// distinguish revision records signed via this tool from those signed via
-// emit's polymorphic surface.
-//
-// Scope:
-//   - One tool: atrib-revise
-//   - Narrow input schema: REQUIRES revises (sha256:<64-hex>), reason, prior_position, new_position
-//   - One key per process (same identity as the wrapper + atrib-emit)
-//   - Persists to the same JSONL mirror convention as atrib-emit
-//
-// Distinct from atrib-annotate: annotation comments on a past record while
-// leaving the prior position intact. Revision asserts the prior is no longer
-// held, the prior remains in the graph (records are immutable per spec
-// §1.6), and the revision adds a REVISES graph edge that supersedes it.
-import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import { z } from 'zod';
-import { resolveEmitLocalSubstrateShadowFromEnv, handleEmit, resolveKey, } from '@atrib/emit';
-import { createSubmissionQueue, EVENT_TYPE_REVISION_URI, } from '@atrib/mcp';
-const SHA256_REF_PATTERN = /^sha256:[0-9a-f]{64}$/;
-const HEX_32_PATTERN = /^[0-9a-f]{32}$/;
-export const ReviseInput = z.object({
-    revises: z.string().regex(SHA256_REF_PATTERN).describe("'sha256:<64-hex>' record_hash this revision supersedes per spec §1.2.9 / D059. " +
-        'REQUIRED. The target record can be any prior record (yours or another agent\'s).'),
-    prior_position: z.string().min(1).max(4096).describe('One-line summary of the position being superseded. Captures what was previously held ' +
-        'so a reader sees the contradiction surfaced as a first-class graph node rather than ' +
-        'a silent edit.'),
-    new_position: z.string().min(1).max(4096).describe('One-line summary of the new position replacing the prior. The substantive claim that ' +
-        'supersedes the revised record.'),
-    reason: z.string().min(1).max(4096).describe('Why the revision happened. New evidence, contradicting record, model update, ' +
-        'corrected reasoning, etc. Recall pipelines surface this verbatim so future-self ' +
-        'sees what motivated the change.'),
-    topics: z.array(z.string().min(1).max(128)).max(16).optional().describe('Optional topic tags. Used by recall_my_attribution_history\'s topics filter. ' +
-        'Lowercase-hyphenated convention (e.g. "contradiction", "model-update").'),
-    context_id: z.string().regex(HEX_32_PATTERN).optional().describe('32-hex context_id. Defaults to process.env.ATRIB_CONTEXT_ID per D078 when omitted; ' +
-        'falls back to a fresh genesis context_id if neither is set.'),
-    informed_by: z.array(z.string().regex(SHA256_REF_PATTERN)).optional().describe("Array of 'sha256:<64-hex>' record_hashes that informed this revision. " +
-        'Sorted lexicographically before signing per §1.2.5. The `revises` reference ' +
-        'is separate from `informed_by` and need not be duplicated here.'),
-});
-/**
- * Wire up the atrib-revise MCP server with one `atrib-revise` tool.
- * Per D079: this is a specialized form of @atrib/emit; the underlying
- * signing pipeline is shared via handleEmit so revision records are
- * byte-identical regardless of which tool produced them.
- */
-export async function createAtribReviseServer(options = {}) {
-    const resolveServerKey = createServerKeyResolver(options);
-    const logEndpoint = options.logEndpoint ?? process.env['ATRIB_LOG_ENDPOINT'];
-    const queue = createSubmissionQueue(logEndpoint);
-    const localSubstrate = options.localSubstrate === false
-        ? undefined
-        : (options.localSubstrate ??
-            resolveEmitLocalSubstrateShadowFromEnv({
-                producer: 'atrib-revise',
-                transport: 'stdio-mcp-server',
-            }));
-    const mcp = new McpServer({ name: 'atrib-revise', version: '0.1.0' });
-    mcp.registerTool('atrib-revise', {
-        description: 'Supersede a prior position with a stated reason. Cognitive primitive #3 of ' +
-            'D079; produces a signed revision event (spec §1.2.9 / D059) that adds a ' +
-            'REVISES graph edge to the target record. Use when you now hold a position ' +
-            'incompatible with a prior claim; the revision surfaces the change as a ' +
-            'first-class graph node rather than a silent edit (records are immutable).',
-        inputSchema: ReviseInput.shape,
-    }, async (rawInput) => {
-        const input = ReviseInput.parse(rawInput);
-        const result = await handleEmit({
-            input: {
-                event_type: EVENT_TYPE_REVISION_URI,
-                content: {
-                    revises: input.revises,
-                    prior_position: input.prior_position,
-                    new_position: input.new_position,
-                    reason: input.reason,
-                    ...(input.topics ? { topics: input.topics } : {}),
-                },
-                revises: input.revises,
-                ...(input.context_id ? { context_id: input.context_id } : {}),
-                ...(input.informed_by ? { informed_by: input.informed_by } : {}),
-            },
-            key: await resolveServerKey(),
-            queue,
-            producer: 'atrib-revise',
-            localSubstrate,
-        });
-        if (!result.signed) {
-            return {
-                isError: true,
-                content: [{ type: 'text', text: result.refusals.join('\n') }],
-            };
-        }
-        const out = {
-            signed: true,
-            record_hash: result.record_hash,
-            log_index: result.log_index,
-            inclusion_proof: result.inclusion_proof,
-            context_id: result.context_id,
-            warnings: result.warnings,
-        };
-        return {
-            content: [{ type: 'text', text: JSON.stringify(out, null, 2) }],
-        };
-    });
-    return {
-        mcp,
-        flush: () => queue.flush(),
-    };
-}
-function createServerKeyResolver(options) {
-    if (Object.prototype.hasOwnProperty.call(options, 'key')) {
-        const fixed = options.key ?? null;
-        return async () => fixed;
-    }
-    let resolved = null;
-    return async () => {
-        resolved ??= resolveKey();
-        return resolved;
-    };
-}
+// SPDX-License-Identifier: Apache-2.0
+// @atrib/revise is the legacy home of the atrib-revise write primitive
+// (cognitive primitive #3 of D079). The implementation lives in
+// @atrib/attest: revision folds into the write verb as
+// attest ref.kind='revises', and the atrib-revise tool name stays mounted
+// as a permanent alias over the same handler. Records signed through
+// either surface are byte-identical in canonical form.
+export { ReviseInput, createAtribReviseServer, registerReviseTool, } from '@atrib/attest';

package/dist/main.js

@@ -1,9 +1,9 @@
 #!/usr/bin/env node
-// atrib-revise standalone binary. Wires the McpServer to a stdio transport
-// so it can be launched as a subprocess by an MCP host (Claude Code,
-// Claude Desktop, etc.).
+// atrib-revise standalone binary (forwarding shim). Serves the legacy
+// atrib-revise server, which mounts `atrib-revise` plus `attest` per the
+// alias-window rule W1.
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
-import { createAtribReviseServer } from './index.js';
+import { createAtribReviseServer } from '@atrib/attest';
 async function main() {
     const { mcp } = await createAtribReviseServer();
     const transport = new StdioServerTransport();

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@atrib/revise",
-  "version": "0.2.41",
-  "description": "MCP server for atrib's verifiable action layer. Lets agents supersede a prior signed position with a stated reason.",
+  "version": "1.0.1",
+  "description": "Legacy home of atrib's revise write primitive. Superseded by @atrib/attest (the write verb, ref.kind=\"revises\"); this package re-exports the same surface and forwards the atrib-revise binary.",
   "author": "atrib <hello@atrib.dev>",
   "keywords": [
     "atrib",
@@ -24,15 +24,13 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",
-    "zod": "^3.25.76",
-    "@atrib/emit": "0.17.3",
-    "@atrib/mcp": "0.21.0"
+    "@atrib/attest": "0.2.0"
   },
   "devDependencies": {
-    "@types/node": "^25.9.3",
-    "tsx": "^4.22.4",
+    "@types/node": "^26.1.1",
+    "tsx": "^4.23.1",
     "typescript": "^6.0.3",
-    "vitest": "^4.1.8"
+    "vitest": "^4.1.10"
   },
   "files": [
     "dist"