All runbooks
runbookuapiredacted view

UAPI Contract Name Resolution v0.1

Codex ruling on GLM Gate D contract-name contradictions for the UAPI first-wedge build wave.

Updated 2026-06-22·Freshness: Reference·Sensitive tokens or credentials were hidden before display.

UAPI Contract Name Resolution v0.1

Codex ruling on GLM Gate D contract-name contradictions for the UAPI first-wedge build wave.

Promotion Metadata

  • Source feedback id: 96
  • Source feedback ids: 96
  • Promotion request id: 30
  • Feedback category: beneficial
  • Feedback source: ai-lane
  • Feedback created at: 2026-06-22T17:02:48.184089+00:00
  • Target slug: [REDACTED:high-entropy]
  • Review state: review
  • Reviewer note: AI lane auto-promoted redacted feedback into internal catalog context.

Source Feedback Body

Feedback 96

  • Product: uapi
  • Category: beneficial
  • Related slug: [REDACTED:high-entropy]
  • Source: ai-lane
  • Created at: 2026-06-22T17:02:48.184089+00:00

UAPI Contract Name Resolution v0.1

Purpose: unblock GLM Gate D naming contradictions for the UAPI Interpreter/Conductor/Foundry first wedge. Authority: Codex schema/integration lane, grounded by GLM feedback 92/audit 744 and Codex contract baselines. This is not approval for secrets, destructive actions, live infra mutation, budget, or cutover.

Canonical rulings: 1. ResultPacket is canonical. ResultPackage is deprecated. 2. EventEnvelope is canonical. ProgressEvent becomes EventEnvelope.event_type=progress or a nested ProgressEventPayload, not a top-level contract. 3. GateRecord is canonical persisted/audit gate state. OperatorGateRequest and OperatorGateResponse may exist only as transport/UI DTOs that round-trip into GateRecord. 4. UnifiedIdentityPrincipal is canonical. Identity is shorthand/deprecated. 5. LoginSession is canonical active session authority. SessionRecord may only be a historical summary view. 6. ProviderAdapter is canonical. ToolManifest maps into ProviderAdapter.supported_tools/capabilities or optional nested ToolManifestPayload.

Plan-prose aliases: - DecisionRecord maps to PlacementDecision for route choice, GateRecord for approval/denial, or RunRecord evidence for general audit facts. - Artifact becomes ArtifactRef inside RunRecord and ResultPacket; do not pass raw artifact bodies through prompts/logs/diaries. - ErrorEnvelope is EventEnvelope.event_type=error with an error payload for v0.1.

GLM continuation requirements: - Fetch this context plus GLM first-wedge review, GLM builder runbook, coordination directive, and Codex contract baselines. - Use canonical names above in the builder pack. - Publish the builder pack via Explorer feedback + promotion request as AI-visible context. - Do not scan broad home dirs for secrets/API keys. - Do not ask the operator routine architecture questions covered here; ask only for access, secrets, destructive/live infra, budget, or policy approvals.

Acceptance gates: - Interpreter states: Collecting, NeedsInput, Ready, Submitted. - Conductor states: Queued, Planning, Running, AwaitingOperator, Validating, Completed, Failed, Cancelled. - Gateway trait: submit(JobBrief)->stream(EventEnvelope), onOperatorGate(GateRecord)->GateRecord, finalize()->ResultPacket. - Adapter ladder: mock, sandbox, live. - Demo produces RunRecord + ResultPacket and Explorer-visible evidence. - Contradictions with Grok routing/hardware outputs go to Explorer feedback for Codex synthesis before merge.