Skip to content

feat(conversational): evidence and replay integration seam for conversational services#289

Open
mdheller wants to merge 2 commits into
mainfrom
feat/conversational-evidence-replay
Open

feat(conversational): evidence and replay integration seam for conversational services#289
mdheller wants to merge 2 commits into
mainfrom
feat/conversational-evidence-replay

Conversation

@mdheller

Copy link
Copy Markdown
Member

Summary

  • ConversationalActionEvidence schema: integration seam binding a conversational turn (session_id, turn_id, action_type) to an AgentPlane execution artifact — covers 8 action types (trigger_execution through replay_request), policy decision ref, execution_artifact_ref, replay_linkage with scope/verified/divergence_detected, and hellgraph_evidence_refs for emission to Prophet Core
  • ConversationalReplayRecord schema: replay artifact for conversational execution triggers — status enum (completed/failed/diverged/pending), replay_scope (turn/session/execution_artifact), conditional divergence_record (required when status=diverged) with 5 divergence_types and resolution_status, non_claims required
  • Policy gates: approval_denial action_type requires deny/escalate outcome; replay_divergence_detected=true requires replay_divergence_ref; diverged status enforces divergence_record presence

Test plan

  • make validate-conversational-evidence — PASS (4 valid, 2 reject)
  • Valid trigger-execution: allow outcome, replay_eligible, hellgraph refs, oql execution_artifact_ref
  • Valid approval-denial: deny outcome, replay unverified, non-claims, hellgraph refs
  • Valid replay-completed: no divergence_record, non_claims required
  • Valid replay-diverged: divergence_record with policy_change type + escalated resolution
  • Reject: missing hellgraph_evidence_refs (schema required)
  • Reject: replay_status=diverged without divergence_record (conditional schema)

Closes #149

mdheller added 2 commits June 11, 2026 20:43
…del civic architecture (#154)

- CivicStackRunCapsule schema: run_id, actor_ref, oql_plan_id, artifact_manifest_id,
  policy_decision_id, tool_grants, action_dispatch_records, oql_plan_acceptance,
  oac_compiler_invocation, subagent_delegations, attestation_events, rationalgrl_trace,
  hellgraph_evidence_refs, delivery_excellence_signal_ref, provenance_refs, timestamps
- RationalGRL trace: goals_addressed (goal/softgoal), tasks_executed, dependencies_blocked
  with defeater_reason on blocked tasks and denied goals
- OQL plan acceptance with OQL-to-agent-task mappings
- OAC compiler invocation with artifact emission refs
- Policy gates: deny outcome enforces empty tool_grants + all dispatches blocked;
  blocked dispatches require defeater_reason; oac failure forbids artifact_emission_refs
- 2 valid fixtures (allow + deny/policy-blocked) + 3 reject fixtures
- validate-civic-stack-runtime-evidence wired into Makefile aggregate validate target
- Upstream anchors: ontogenesis#80, #81, policy-fabric#72, sociosphere#323, delivery-excellence#28
…sational services (#149)

- ConversationalActionEvidence schema: binds conversation session/turn to AgentPlane
  execution artifact — action_type (8-value enum), policy_decision_ref, execution_artifact_ref,
  replay_linkage (eligible/verified/divergence_detected/scope), hellgraph_evidence_refs
- ConversationalReplayRecord schema: replay artifact for conversational triggers — status
  (completed/failed/diverged/pending), replay_scope (turn/session/execution_artifact),
  divergence_record (conditional required when status=diverged) with divergence_type
  and resolution_status enums, non_claims required
- Policy gates: approval_denial forces deny/escalate outcome; replay_divergence_detected
  requires replay_divergence_ref; diverged status requires divergence_record
- 4 valid fixtures (trigger-execution, approval-denial, replay-completed, replay-diverged)
  + 2 reject fixtures
- validate-conversational-evidence wired into Makefile aggregate validate target
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Add conversational evidence and replay integration

1 participant