@polydeukes/adapter-claude-code 0.3.0 → 0.4.0

package/dist/index.d.ts

@@ -6,74 +6,10 @@
  * literals live here by design: this package is the boundary where Claude Code's
  * vocabulary is translated away before it reaches the core.
  */
-import { type CovenantInput } from '@polydeukes/core';
 export { collectFileChanges } from './file-changes.js';
 export { evaluatePrecedent } from './precedent.js';
 export { type DispatchOutcome, runAdapterPath } from './run-adapter-path.js';
 export { COMMAND_ARGS, MUTATING_TOOLS, SHELL_TOOLS, transcriptPathFromPayload, } from './session-vocabulary.js';
 export { transcriptFromJsonl, transcriptFromJsonlFile } from './transcript.js';
+export { buildCovenantInput, type ClaudePreToolUsePayload, type TranslatedEvent, translateEvent, } from './up-translate.js';
 export { type VirtualPostState, virtualPostState } from './virtual-post-state.js';
-/**
- * `ClaudePreToolUsePayload` — a Claude Code PreToolUse hook payload (PRD §4.1).
- *
- * Only `tool_name` and `tool_input` are required; the rest is preserved when present.
- * The agent/tool literals this package interprets live in the *values* of these fields,
- * never in core — this boundary is the package's reason to exist.
- */
-export type ClaudePreToolUsePayload = {
-    hook_event_name?: string;
-    session_id?: string;
-    transcript_path?: string;
-    cwd?: string;
-    tool_name: string;
-    tool_input: Record<string, unknown>;
-};
-/**
- * `TranslatedEvent` — the result of up-translating one payload (PRD §4.2).
- *
- * Success carries the IR fragment; failure carries a human-readable `reason`. A `Task`
- * with a string `subagent_type` becomes a `subagentSpawn`; every other tool becomes a
- * `toolCall`. Classification failure never demotes to a `toolCall` — losing spawn
- * evidence is a bypass vector (PRD §4.1).
- */
-export type TranslatedEvent = {
-    ok: true;
-    kind: 'toolCall';
-    value: {
-        name: string;
-        args?: Record<string, unknown>;
-    };
-} | {
-    ok: true;
-    kind: 'subagentSpawn';
-    value: {
-        kind: string;
-    };
-} | {
-    ok: false;
-    reason: string;
-};
-/**
- * Up-translate one Claude Code payload into an IR fragment (pure, PRD §4.2).
- *
- * Never throws: a payload that cannot be classified — a non-object, a missing/invalid
- * `tool_name` or `tool_input`, or a `Task` lacking a string `subagent_type` — resolves
- * to `{ ok: false, reason }` (fail-closed, PRD §5.2).
- */
-export declare function translateEvent(payload: unknown): TranslatedEvent;
-/**
- * Fold a sequence of payloads into one {@link CovenantInput} (pure, PRD §4.2).
- *
- * Preserves observation order into `toolCalls` / `subagentSpawns`; `userMessages` is
- * always `[]` (ADAPTER-04 supplies witness evidence later). If any payload fails
- * classification the whole build fails closed with the blocking exit code — a silent
- * drop would be a bypass vector (PRD §5.2/§7).
- */
-export declare function buildCovenantInput(payloads: unknown[]): {
-    ok: true;
-    value: CovenantInput;
-} | {
-    ok: false;
-    exitCode: 2;
-    reason: string;
-};

package/dist/index.js

@@ -6,60 +6,10 @@
  * literals live here by design: this package is the boundary where Claude Code's
  * vocabulary is translated away before it reaches the core.
  */
-import { EXIT_BREAK_BLOCKING } from '@polydeukes/core';
-import { parsePayloadEnvelope } from './payload-envelope.js';
 export { collectFileChanges } from './file-changes.js';
 export { evaluatePrecedent } from './precedent.js';
 export { runAdapterPath } from './run-adapter-path.js';
 export { COMMAND_ARGS, MUTATING_TOOLS, SHELL_TOOLS, transcriptPathFromPayload, } from './session-vocabulary.js';
 export { transcriptFromJsonl, transcriptFromJsonlFile } from './transcript.js';
+export { buildCovenantInput, translateEvent, } from './up-translate.js';
 export { virtualPostState } from './virtual-post-state.js';
-/**
- * Up-translate one Claude Code payload into an IR fragment (pure, PRD §4.2).
- *
- * Never throws: a payload that cannot be classified — a non-object, a missing/invalid
- * `tool_name` or `tool_input`, or a `Task` lacking a string `subagent_type` — resolves
- * to `{ ok: false, reason }` (fail-closed, PRD §5.2).
- */
-export function translateEvent(payload) {
-    const envelope = parsePayloadEnvelope(payload);
-    if (envelope.ok !== true) {
-        return { ok: false, reason: envelope.reason };
-    }
-    const { toolName, toolInput } = envelope;
-    if (toolName === 'Task') {
-        if (typeof toolInput.subagent_type !== 'string') {
-            return { ok: false, reason: 'Task payload is missing a string subagent_type' };
-        }
-        return { ok: true, kind: 'subagentSpawn', value: { kind: toolInput.subagent_type } };
-    }
-    return { ok: true, kind: 'toolCall', value: { name: toolName, args: toolInput } };
-}
-/**
- * Fold a sequence of payloads into one {@link CovenantInput} (pure, PRD §4.2).
- *
- * Preserves observation order into `toolCalls` / `subagentSpawns`; `userMessages` is
- * always `[]` (ADAPTER-04 supplies witness evidence later). If any payload fails
- * classification the whole build fails closed with the blocking exit code — a silent
- * drop would be a bypass vector (PRD §5.2/§7).
- */
-export function buildCovenantInput(payloads) {
-    const input = { toolCalls: [], subagentSpawns: [], userMessages: [] };
-    for (let index = 0; index < payloads.length; index++) {
-        const translated = translateEvent(payloads[index]);
-        if (translated.ok !== true) {
-            return {
-                ok: false,
-                exitCode: EXIT_BREAK_BLOCKING,
-                reason: `payload at index ${index} failed classification: ${translated.reason}`,
-            };
-        }
-        if (translated.kind === 'toolCall') {
-            input.toolCalls.push(translated.value);
-        }
-        else {
-            input.subagentSpawns.push(translated.value);
-        }
-    }
-    return { ok: true, value: input };
-}

package/dist/run-adapter-path.js

@@ -9,7 +9,7 @@
 import { readFileSync } from 'node:fs';
 import { appendRecordFailOpen, EXIT_BREAK_BLOCKING, EXIT_UPHOLD } from '@polydeukes/core';
 import { collectFileChanges } from './file-changes.js';
-import { buildCovenantInput } from './index.js';
+import { buildCovenantInput } from './up-translate.js';
 /** Default label for adapter-level telemetry records. */
 const DEFAULT_ADAPTER_LABEL = 'adapter-claude-code';
 /**

package/dist/up-translate.d.ts

@@ -0,0 +1,78 @@
+/**
+ * up-translate — Claude Code PreToolUse payloads into the agent-neutral IR (ADAPTER-01
+ * PRD §4.1–§4.2).
+ *
+ * Pure translation only — no I/O, no process spawning. Agent and tool literals live in
+ * this package by design: it is the boundary where Claude Code's vocabulary is
+ * translated away before it reaches the core.
+ *
+ * These live outside the barrel because `run-adapter-path.ts` consumes
+ * `buildCovenantInput` and the barrel re-exports `run-adapter-path`: importing through
+ * the barrel is an initialization cycle (CLEANUP-01 F1). The barrel re-exports this
+ * module, so every consumer outside the package still reaches it at the same path.
+ */
+import { type CovenantInput } from '@polydeukes/core';
+/**
+ * `ClaudePreToolUsePayload` — a Claude Code PreToolUse hook payload (PRD §4.1).
+ *
+ * Only `tool_name` and `tool_input` are required; the rest is preserved when present.
+ * The agent/tool literals this package interprets live in the *values* of these fields,
+ * never in core — this boundary is the package's reason to exist.
+ */
+export type ClaudePreToolUsePayload = {
+    hook_event_name?: string;
+    session_id?: string;
+    transcript_path?: string;
+    cwd?: string;
+    tool_name: string;
+    tool_input: Record<string, unknown>;
+};
+/**
+ * `TranslatedEvent` — the result of up-translating one payload (PRD §4.2).
+ *
+ * Success carries the IR fragment; failure carries a human-readable `reason`. A `Task`
+ * with a string `subagent_type` becomes a `subagentSpawn`; every other tool becomes a
+ * `toolCall`. Classification failure never demotes to a `toolCall` — losing spawn
+ * evidence is a bypass vector (PRD §4.1).
+ */
+export type TranslatedEvent = {
+    ok: true;
+    kind: 'toolCall';
+    value: {
+        name: string;
+        args?: Record<string, unknown>;
+    };
+} | {
+    ok: true;
+    kind: 'subagentSpawn';
+    value: {
+        kind: string;
+    };
+} | {
+    ok: false;
+    reason: string;
+};
+/**
+ * Up-translate one Claude Code payload into an IR fragment (pure, PRD §4.2).
+ *
+ * Never throws: a payload that cannot be classified — a non-object, a missing/invalid
+ * `tool_name` or `tool_input`, or a `Task` lacking a string `subagent_type` — resolves
+ * to `{ ok: false, reason }` (fail-closed, PRD §5.2).
+ */
+export declare function translateEvent(payload: unknown): TranslatedEvent;
+/**
+ * Fold a sequence of payloads into one {@link CovenantInput} (pure, PRD §4.2).
+ *
+ * Preserves observation order into `toolCalls` / `subagentSpawns`; `userMessages` is
+ * always `[]` (ADAPTER-04 supplies witness evidence later). If any payload fails
+ * classification the whole build fails closed with the blocking exit code — a silent
+ * drop would be a bypass vector (PRD §5.2/§7).
+ */
+export declare function buildCovenantInput(payloads: unknown[]): {
+    ok: true;
+    value: CovenantInput;
+} | {
+    ok: false;
+    exitCode: 2;
+    reason: string;
+};

package/dist/up-translate.js

@@ -0,0 +1,64 @@
+/**
+ * up-translate — Claude Code PreToolUse payloads into the agent-neutral IR (ADAPTER-01
+ * PRD §4.1–§4.2).
+ *
+ * Pure translation only — no I/O, no process spawning. Agent and tool literals live in
+ * this package by design: it is the boundary where Claude Code's vocabulary is
+ * translated away before it reaches the core.
+ *
+ * These live outside the barrel because `run-adapter-path.ts` consumes
+ * `buildCovenantInput` and the barrel re-exports `run-adapter-path`: importing through
+ * the barrel is an initialization cycle (CLEANUP-01 F1). The barrel re-exports this
+ * module, so every consumer outside the package still reaches it at the same path.
+ */
+import { EXIT_BREAK_BLOCKING } from '@polydeukes/core';
+import { parsePayloadEnvelope } from './payload-envelope.js';
+/**
+ * Up-translate one Claude Code payload into an IR fragment (pure, PRD §4.2).
+ *
+ * Never throws: a payload that cannot be classified — a non-object, a missing/invalid
+ * `tool_name` or `tool_input`, or a `Task` lacking a string `subagent_type` — resolves
+ * to `{ ok: false, reason }` (fail-closed, PRD §5.2).
+ */
+export function translateEvent(payload) {
+    const envelope = parsePayloadEnvelope(payload);
+    if (envelope.ok !== true) {
+        return { ok: false, reason: envelope.reason };
+    }
+    const { toolName, toolInput } = envelope;
+    if (toolName === 'Task') {
+        if (typeof toolInput.subagent_type !== 'string') {
+            return { ok: false, reason: 'Task payload is missing a string subagent_type' };
+        }
+        return { ok: true, kind: 'subagentSpawn', value: { kind: toolInput.subagent_type } };
+    }
+    return { ok: true, kind: 'toolCall', value: { name: toolName, args: toolInput } };
+}
+/**
+ * Fold a sequence of payloads into one {@link CovenantInput} (pure, PRD §4.2).
+ *
+ * Preserves observation order into `toolCalls` / `subagentSpawns`; `userMessages` is
+ * always `[]` (ADAPTER-04 supplies witness evidence later). If any payload fails
+ * classification the whole build fails closed with the blocking exit code — a silent
+ * drop would be a bypass vector (PRD §5.2/§7).
+ */
+export function buildCovenantInput(payloads) {
+    const input = { toolCalls: [], subagentSpawns: [], userMessages: [] };
+    for (let index = 0; index < payloads.length; index++) {
+        const translated = translateEvent(payloads[index]);
+        if (translated.ok !== true) {
+            return {
+                ok: false,
+                exitCode: EXIT_BREAK_BLOCKING,
+                reason: `payload at index ${index} failed classification: ${translated.reason}`,
+            };
+        }
+        if (translated.kind === 'toolCall') {
+            input.toolCalls.push(translated.value);
+        }
+        else {
+            input.subagentSpawns.push(translated.value);
+        }
+    }
+    return { ok: true, value: input };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@polydeukes/adapter-claude-code",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Polydeukes adapter for Claude Code — up-translates PreToolUse hook payloads into the agent-neutral covenant input IR. Alpha.",
   "license": "MIT",
   "repository": {
@@ -29,7 +29,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@polydeukes/core": "^0.3.0"
+    "@polydeukes/core": "^0.4.0"
   },
   "devDependencies": {
     "@types/node": "^24.0.0",