@principles/codex-adapter 0.2.2 → 0.2.4

package/dist/pd-hook.js

@@ -3,6 +3,7 @@ import { readFileSync } from 'node:fs';
 import process from 'node:process';
 import { pathToFileURL } from 'node:url';
 import { createProductionHostRuntime, loadPdConfigForPlugin, resolveNearestPdWorkspace } from '@principles/host-runtime';
+import { CODEX_TOOL_SEMANTICS } from './tool-semantics.js';
 import { computeFeatureFlagsFromConfig } from '@principles/core/runtime-v2';
 import { CodexHooksHostAdapter } from './host-adapter.js';
 import { CodexDecoderError, CodexEncoderError } from './codec/index.js';
@@ -117,7 +118,7 @@ export async function processHookInvocation(rawStdin, _env = process.env, cwd =
         const ingestionDiagnostics = ingestionEnabled
             ? await runConversationIngestion({ rawPayload: parsed, kind: event.kind, workspaceDir: resolution.workspaceDir, env: _env })
             : [];
-        const result = await createProductionHostRuntime({ hostKind: 'codex' }).dispatch(event);
+        const result = await createProductionHostRuntime({ hostKind: 'codex', toolSemantics: CODEX_TOOL_SEMANTICS }).dispatch(event);
         const stderr = [...(result.warnings ?? []).slice(0, 16).map((warning) => diagnostic(warning, 'Inspect PD Workspace state and retry; the hook failed open.')), ...ingestionDiagnostics];
         return { stdout: adapter.encodeOutput(result, event.kind), exitCode: 0, stderr };
     }

package/dist/tool-semantics.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Codex Tool Semantic Declaration — PRI-634-F R2 (review P1-2)
+ *
+ * PURPOSE: the Codex host layer of the Tool Semantic Registry. Codex names
+ * its shell tool `Bash` (capitalized — evidenced by the codex-adapter
+ * integration fixtures), which the core baseline's lowercase `bash` never
+ * matches: rules generated against the baseline name could pass replay and
+ * never fire on a real Codex event.
+ *
+ * EVIDENCE BOUND: this declaration contains only names with in-repo
+ * evidence — the installer's hook matcher `Bash|apply_patch`
+ * (create-principles-disciple/src/installers/codex-host-installer.ts:203,
+ * locked by codex-plugin-bundle.test.ts). Extending it with the remaining
+ * Codex tool surface is tracked as PRI-657 — a wrong guess would be worse
+ * than a gap (the reliability check rejects undeclared names, forcing
+ * correct names).
+ */
+import { type ToolSemanticMappingV1, type ToolSemanticRegistry } from '@principles/core/runtime-v2';
+export declare const CODEX_TOOL_SEMANTIC_MAPPINGS: readonly ToolSemanticMappingV1[];
+export declare const CODEX_TOOL_SEMANTICS: ToolSemanticRegistry;

package/dist/tool-semantics.js

@@ -0,0 +1,27 @@
+/**
+ * Codex Tool Semantic Declaration — PRI-634-F R2 (review P1-2)
+ *
+ * PURPOSE: the Codex host layer of the Tool Semantic Registry. Codex names
+ * its shell tool `Bash` (capitalized — evidenced by the codex-adapter
+ * integration fixtures), which the core baseline's lowercase `bash` never
+ * matches: rules generated against the baseline name could pass replay and
+ * never fire on a real Codex event.
+ *
+ * EVIDENCE BOUND: this declaration contains only names with in-repo
+ * evidence — the installer's hook matcher `Bash|apply_patch`
+ * (create-principles-disciple/src/installers/codex-host-installer.ts:203,
+ * locked by codex-plugin-bundle.test.ts). Extending it with the remaining
+ * Codex tool surface is tracked as PRI-657 — a wrong guess would be worse
+ * than a gap (the reliability check rejects undeclared names, forcing
+ * correct names).
+ */
+import { buildToolSemanticRegistry } from '@principles/core/runtime-v2';
+export const CODEX_TOOL_SEMANTIC_MAPPINGS = Object.freeze([
+    { rawToolName: 'Bash', canonicalKind: 'execute' },
+    { rawToolName: 'apply_patch', canonicalKind: 'write' },
+]);
+const built = buildToolSemanticRegistry(CODEX_TOOL_SEMANTIC_MAPPINGS);
+if (!built.ok) {
+    throw new Error(`[PD] Codex tool semantic declaration is invalid: ${built.errors.join('; ')}`);
+}
+export const CODEX_TOOL_SEMANTICS = built.registry;

package/dist/worker/workspace-worker.js

@@ -24,8 +24,9 @@
 import fs from 'node:fs';
 import path from 'node:path';
 import { computeFeatureFlagsFromConfig, createRuntimeStateHandle, createPainSignalBridge, isRetryWaitBackoffElapsed, PrincipleTreeLedgerAdapter, resolveDiagnosticianCapability, } from '@principles/core/runtime-v2';
-import { loadPdConfigForPlugin, loadFeatureFlagFromConfig, reconcileGovernanceContinuation, runInternalizationConsumerCycle, } from '@principles/host-runtime';
+import { loadPdConfigForPlugin, loadFeatureFlagFromConfig, reconcileGovernanceContinuation, runInternalizationConsumerCycle, saveHostToolDeclaration, } from '@principles/host-runtime';
 import { catchUpCodexIngestion } from '../ingestion/catch-up.js';
+import { CODEX_TOOL_SEMANTIC_MAPPINGS, CODEX_TOOL_SEMANTICS } from '../tool-semantics.js';
 const WORKER_OWNER = 'companion-worker';
 const DEFAULT_DIAG_CANDIDATE_LIMIT = 5;
 function workerLogger(logger) {
@@ -194,11 +195,24 @@ export async function runCodexWorkspaceWorkerCycle(options) {
     }
     // Step 7 — ONE bounded downstream consumer cycle via the shared executor
     // (same implementation the OpenClaw auto-consumer runs).
+    // PRI-634-F R2: persist the Codex tool declaration (workspace provenance
+    // for host-neutral consumers) and thread the registry into the cycle so
+    // activation-gate replay resolves Codex tool semantics (Bash, not bash).
+    const declared = saveHostToolDeclaration(workspaceDir, {
+        version: 1,
+        hostKind: 'codex',
+        mappings: CODEX_TOOL_SEMANTIC_MAPPINGS,
+        declaredAt: new Date().toISOString(),
+    });
+    if (!declared.ok) {
+        logger.warn?.(`[PD:CodexWorker] Failed to persist Codex tool declaration: ${declared.reason} — host-neutral consumers will not find it (rc-9)`);
+    }
     const downstream = await runInternalizationConsumerCycle(workspaceDir, {
         owner: WORKER_OWNER,
         logLabel: 'CodexWorker',
         logger,
         emitEvent,
+        toolSemantics: CODEX_TOOL_SEMANTICS,
         // No hostToolCatalog: PD has not declared a Codex tool catalog; a wrong
         // (OpenClaw) catalog would be worse than none (PRI-630 follow-up).
     });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@principles/codex-adapter",
-  "version": "0.2.2",
+  "version": "0.2.4",
   "description": "Codex CLI host adapter for Principles Disciple — implements HostAdapter interface for OpenAI Codex CLI's stdin/stdout JSON hook model (ADR-0020).",
   "type": "module",
   "main": "./dist/index.js",