script-build-and-framework-tmp/visualization/backend/app/contracts.py

"""Exact field names mirrored from the current Host domain and Agent wire models.

This module intentionally has no dependency on the parent source tree.  The
visualization stays independently runnable while its tests reject incomplete or
invented fake records.
"""

from __future__ import annotations

SCHEMA_CATALOG: dict[str, tuple[str, ...]] = {
    "ScriptBuildRecord": (
        "id",
        "execution_id",
        "topic_build_id",
        "topic_id",
        "agent_type",
        "agent_config",
        "data_source_url",
        "status",
        "reson_trace_id",
        "is_deleted",
        "is_favorited",
        "summary",
        "error_message",
        "script_direction",
        "build_workflow",
        "paragraph_count",
        "element_count",
        "input_tokens",
        "output_tokens",
        "cost_usd",
        "strategies_config",
        "start_time",
        "end_time",
    ),
    "ScriptBuildInputSnapshotV1": (
        "snapshot_id",
        "script_build_id",
        "execution_id",
        "topic_build_id",
        "topic_id",
        "topic",
        "account",
        "persona_points",
        "section_patterns",
        "strategies",
        "prompt_manifest",
        "datasource_manifest",
        "model_manifest",
        "canonical_sha256",
        "created_at",
        "parent_snapshot_id",
        "parent_snapshot_sha256",
        "business_input_sha256",
    ),
    "InputSnapshotRow": (
        "id",
        "script_build_id",
        "version",
        "canonical_json",
        "canonical_sha256",
        "prompt_manifest_json",
        "schema_version",
        "created_at",
    ),
    "MissionBinding": (
        "binding_id",
        "script_build_id",
        "root_trace_id",
        "input_snapshot_id",
        "active_direction_artifact_version_id",
        "accepted_root_artifact_version_id",
        "engine_version",
        "schema_version",
        "created_at",
        "updated_at",
        "owner_epoch",
        "stop_epoch",
        "owner_instance_id",
        "owner_acquired_at",
    ),
    "MissionOwnerToken": (
        "script_build_id",
        "root_trace_id",
        "owner_epoch",
        "stop_epoch",
        "owner_instance_id",
    ),
    "TaskView": (
        "task_id",
        "goal_id",
        "parent_task_id",
        "display_path",
        "specs",
        "current_spec_version",
        "status",
        "child_task_ids",
        "attempt_ids",
        "validation_ids",
        "decision_ids",
        "repair_count_by_version",
        "blocked_reason",
        "superseded_by",
        "created_at",
        "updated_at",
    ),
    "TaskSpecView": (
        "version",
        "objective",
        "acceptance_criteria",
        "context_refs",
        "created_at",
    ),
    "ScriptTaskContractV1": (
        "schema_version",
        "task_kind",
        "scope_ref",
        "intent_class",
        "objective",
        "input_decision_refs",
        "base_artifact_ref",
        "write_scope",
        "gap_ref",
        "output_schema",
        "criteria",
        "budget",
        "supersedes_decision_ids",
        "candidate_closure_decision_refs",
        "adopted_decision_ids",
        "held_or_rejected_decision_ids",
        "compose_order",
        "comparison_decision_refs",
    ),
    "OperationView": (
        "operation_id",
        "root_trace_id",
        "kind",
        "status",
        "task_ids",
        "attempt_ids",
        "validation_ids",
        "result_ref",
        "execution_epoch",
        "deadline_at",
        "error",
        "started_at",
        "completed_at",
        "created_at",
        "updated_at",
    ),
    "AttemptView": (
        "attempt_id",
        "task_id",
        "spec_version",
        "worker_trace_id",
        "worker_preset",
        "execution_mode",
        "accepted_child_decision_ids",
        "status",
        "operation_id",
        "execution_epoch",
        "continue_from_trace_id",
        "snapshot_id",
        "submission",
        "execution_stats",
        "error",
        "started_at",
        "completed_at",
        "duration_ms",
        "created_at",
        "updated_at",
    ),
    "ValidationView": (
        "validation_id",
        "task_id",
        "attempt_id",
        "spec_version",
        "snapshot_id",
        "validator_trace_id",
        "validator_preset",
        "validation_plan",
        "evidence_queries_used",
        "status",
        "operation_id",
        "execution_epoch",
        "verdict",
        "criterion_results",
        "summary",
        "evidence_refs",
        "unverified_claims",
        "risks",
        "recommendation",
        "execution_stats",
        "error",
        "started_at",
        "completed_at",
        "duration_ms",
        "created_at",
        "updated_at",
    ),
    "PlannerDecisionView": (
        "decision_id",
        "task_id",
        "action",
        "reason",
        "from_status",
        "to_status",
        "attempt_id",
        "validation_id",
        "payload",
        "created_at",
    ),
    "EvidenceRecordV1": (
        "schema_version",
        "evidence_id",
        "source_type",
        "tool_name",
        "query",
        "source_refs",
        "raw_artifact_ref",
        "summary",
        "supports",
        "confidence",
        "limitations",
        "created_at",
    ),
    "ScriptDirectionArtifactV1": (
        "schema_version",
        "goals",
        "criteria",
        "domain_criteria",
        "topic_refs",
        "persona_refs",
        "strategy_refs",
        "evidence_refs",
        "legacy_markdown",
    ),
    "CandidateLineageV1": (
        "scope_ref",
        "input_snapshot_ref",
        "input_closure_digest",
        "base_artifact_ref",
        "base_artifact_digest",
        "base_revision",
        "write_scope",
        "supersedes_decision_ids",
        "source_lineage",
    ),
    "StructureArtifactV1": (
        "schema_version",
        "scope_ref",
        "input_snapshot_ref",
        "input_closure_digest",
        "base_artifact_ref",
        "base_artifact_digest",
        "base_revision",
        "write_scope",
        "supersedes_decision_ids",
        "source_lineage",
        "paragraphs",
    ),
    "ParagraphArtifactV1": (
        "schema_version",
        "scope_ref",
        "input_snapshot_ref",
        "input_closure_digest",
        "base_artifact_ref",
        "base_artifact_digest",
        "base_revision",
        "write_scope",
        "supersedes_decision_ids",
        "source_lineage",
        "paragraphs",
        "elements",
        "paragraph_element_links",
        "change_manifest",
    ),
    "ElementSetArtifactV1": (
        "schema_version",
        "scope_ref",
        "input_snapshot_ref",
        "input_closure_digest",
        "base_artifact_ref",
        "base_artifact_digest",
        "base_revision",
        "write_scope",
        "supersedes_decision_ids",
        "source_lineage",
        "paragraphs",
        "elements",
        "paragraph_element_links",
        "change_manifest",
    ),
    "ComparisonArtifactV1": (
        "schema_version",
        "scope_ref",
        "input_snapshot_ref",
        "input_closure_digest",
        "base_artifact_ref",
        "base_artifact_digest",
        "base_revision",
        "write_scope",
        "supersedes_decision_ids",
        "source_lineage",
        "candidate_artifact_refs",
        "criterion_results",
        "conflicts",
        "recommendation",
    ),
    "StructuredScriptArtifactV1": (
        "schema_version",
        "direction_ref",
        "input_closure_digest",
        "paragraphs",
        "elements",
        "paragraph_element_links",
        "source_artifact_refs",
        "evidence_refs",
        "acceptance_notes",
    ),
    "CandidatePortfolioArtifactV1": (
        "schema_version",
        "adopted_structured_script_ref",
        "candidate_structured_script_refs",
        "accepted_decision_ids",
        "superseded_decision_ids",
        "rejected_or_held_decision_ids",
        "input_closure_digest",
        "unresolved_defects",
        "compose_order",
    ),
    "ArtifactVersion": (
        "artifact_version_id",
        "script_build_id",
        "task_id",
        "attempt_id",
        "spec_version",
        "artifact_type",
        "canonical_sha256",
        "state",
        "artifact",
        "created_at",
        "frozen_at",
    ),
    "ArtifactVersionRow": (
        "id",
        "script_build_id",
        "task_id",
        "attempt_id",
        "spec_version",
        "artifact_type",
        "legacy_branch_id",
        "base_revision",
        "parent_artifact_version_id",
        "canonical_json",
        "canonical_sha256",
        "state",
        "created_at",
        "frozen_at",
        "published_at",
    ),
    "ParagraphRow": (
        "id",
        "script_build_id",
        "branch_id",
        "base_ref_id",
        "paragraph_index",
        "level",
        "parent_id",
        "name",
        "content_range",
        "theme",
        "form",
        "function",
        "feeling",
        "theme_elements",
        "form_elements",
        "function_elements",
        "feeling_elements",
        "description",
        "full_description",
        "is_active",
        "created_at",
        "updated_at",
    ),
    "ElementRow": (
        "id",
        "script_build_id",
        "branch_id",
        "base_ref_id",
        "name",
        "dimension_primary",
        "dimension_secondary",
        "commonality_analysis",
        "topic_support",
        "weight_score",
        "support_elements",
        "is_active",
        "created_at",
        "updated_at",
    ),
    "ParagraphElementLinkRow": (
        "id",
        "script_build_id",
        "branch_id",
        "paragraph_id",
        "element_id",
    ),
    "RootDeliveryManifestV1": (
        "schema_version",
        "direction_ref",
        "candidate_portfolio_ref",
        "structured_script_ref",
        "input_closure_digest",
        "legacy_projection_digest",
        "build_summary",
        "blocking_defects",
    ),
    "LegacyProjectionCanonicalV1": (
        "schema_version",
        "direction",
        "summary",
        "paragraph_count",
        "element_count",
        "link_count",
        "paragraphs",
        "elements",
        "paragraph_element_links",
    ),
    "Publication": (
        "publication_id",
        "script_build_id",
        "publication_type",
        "accept_decision_id",
        "artifact_version_id",
        "expected_sha256",
        "state",
        "attempt_count",
        "publication_revision",
        "last_error_code",
        "last_error_summary",
        "created_at",
        "updated_at",
        "published_at",
    ),
    "PublicationResult": (
        "script_build_id",
        "publication_id",
        "publication_type",
        "state",
        "legacy_projection_digest",
        "committed",
        "post_commit_readback_ok",
    ),
    "HttpCommandRecord": (
        "id",
        "principal_scope_sha256",
        "route_family",
        "idempotency_key",
        "request_fingerprint",
        "preallocated_root_trace_id",
        "resource_id",
        "state",
        "response_status",
        "response_json",
        "created_at",
        "updated_at",
    ),
}

ENUM_CATALOG: dict[str, tuple[str, ...]] = {
    "BuildStatus": ("running", "stopping", "success", "failed", "partial", "stopped"),
    "TaskStatus": (
        "pending",
        "running",
        "awaiting_validation",
        "validating",
        "awaiting_decision",
        "needs_replan",
        "waiting_children",
        "completed",
        "superseded",
        "blocked",
        "cancelled",
    ),
    "AttemptStatus": ("running", "submitted", "failed", "stopped", "expired"),
    "ValidationRunStatus": (
        "pending",
        "running",
        "completed",
        "error",
        "stopped",
        "expired",
    ),
    "ValidationVerdict": ("passed", "failed", "inconclusive"),
    "DecisionAction": (
        "accept",
        "repair",
        "retry",
        "revalidate",
        "revise",
        "split",
        "block",
        "unblock",
        "cancel",
        "supersede",
    ),
    "ArtifactState": ("draft", "frozen", "published", "discarded"),
    "PublicationState": ("pending", "publishing", "published", "failed"),
    "ScriptTaskKind": (
        "direction",
        "pattern-retrieval",
        "decode-retrieval",
        "external-retrieval",
        "knowledge-retrieval",
        "structure",
        "paragraph",
        "element-set",
        "compare",
        "compose",
        "candidate-portfolio",
        "root-delivery",
    ),
}