@principles/codex-adapter 0.3.0 → 0.4.0

package/dist/pd-hook.d.ts

@@ -5,5 +5,6 @@ export interface PdHookResult {
     exitCode: number;
     stderr: string[];
 }
+export declare function annotateContextWarnings(warnings: readonly string[]): string[];
 export declare function processHookInvocation(rawStdin: string, _env?: EnvMap, cwd?: string): Promise<PdHookResult>;
 export {};

package/dist/pd-hook.js

@@ -54,6 +54,26 @@ function diagnostic(reason, nextAction) {
 function errorMessage(error) {
     return error instanceof Error ? error.message.slice(0, MAX_DIAGNOSTIC) : 'unknown_error';
 }
+/**
+ * PRI-780 Codex capability declaration (structured UNSUPPORTED — suspension
+ * semantics, revised after Codex review round 2 P1): the Codex host has no
+ * runtime context provider, and the "unavailable → allow" contract is
+ * generation-time prompt discipline, NOT a runtime-enforced invariant. Handing
+ * v2 rules a truthy unavailable-posture context would let a persisted rule
+ * evaluate context-blind and DENY tool calls that were previously suspended —
+ * a silent governance behavior change. Codex therefore passes NO context
+ * provider: the shared gate skips v2 rules with its structured
+ * `rule_context_v2_unavailable` warning, and this hook annotates that warning
+ * with the explicit host-unsupported reason before it reaches Codex stderr
+ * (see annotateContextWarnings — ticket option B: 明确 unsupported + 结构化
+ * warning, never a silent skip).
+ */
+const CODEX_CONTEXT_UNSUPPORTED_NOTE = 'codex_runtime_context_unsupported: the Codex host provides no runtime context provider; v2 rules stay suspended on this host';
+export function annotateContextWarnings(warnings) {
+    return warnings.map((warning) => warning.startsWith('rule_context_v2_unavailable')
+        ? `${warning}; ${CODEX_CONTEXT_UNSUPPORTED_NOTE}`
+        : warning);
+}
 // Bounded governance-observation ingestion (Codex Governance Closure Slice
 // A) followed by the Slice B signal-admission pass (SPEC §12/§13): detection
 // → canonical pain → evidence promotion → one pending Diagnostician task.
@@ -163,8 +183,11 @@ export async function processHookInvocation(rawStdin, _env = process.env, cwd =
             hostKind: 'codex',
             toolSemantics: CODEX_TOOL_SEMANTICS,
             events: codexEventEmitter(path.join(resolution.workspaceDir, '.state')),
+            // PRI-780 (revised after Codex review round 2 P1): NO context provider —
+            // v2 rules stay SUSPENDED on Codex (never loaded context-blind). See
+            // annotateContextWarnings for the structured unsupported declaration.
         }).dispatch(event);
-        const stderr = [...(result.warnings ?? []).slice(0, 16).map((warning) => diagnostic(warning, 'Inspect PD Workspace state and retry; the hook failed open.')), ...ingestionDiagnostics];
+        const stderr = [...annotateContextWarnings(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 };
     }
     catch (error) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@principles/codex-adapter",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "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",