14 — GPT / MCP-Readable Checkpoint

macro: DOT_AGENT_API_ENDPOINT_TRUE_DRYRUN_JOBCUT_UI_D1D2_AND_PROCESS_READINESS
date: 2026-06-04
status: PARTIAL
execution_mode: EXECUTION_MODE
live_mutation: true            # additive only; birth-free
births: {start: 1163409, end: 1163429, delta_cause: background_kb_doc_ingestion}
guard_alerts: 129              # unchanged
observations: {dry_run: 0, real_run: 0, simulated_dry_run: 4}
verified_candidates_v3: [PROC-CAND:job:cut]   # invariant held

endpoint_status: producer_blocked_external    # no agent_api executor service/route/credential on VPS
endpoint_ref_binding: NULL                     # both contracts; no fake binding
verifier_logic: implemented_real               # fn_dryrun_fixture_selfcheck, pure, 7/7 on real fixture, fails on ghost node
true_dry_run: not_executed_exact_blocker       # dispatcher refuses DRY_RUN while endpoint_ref NULL

live_objects:
  function: [fn_dryrun_fixture_selfcheck(jsonb)]   # IMMUTABLE pure
  views:
    - v_process_discovery_agent_api_endpoint_status
    - v_process_discovery_endpoint_binding_status
    - v_process_discovery_candidate_status_v6
    - v_process_discovery_birth_readiness_v6
    - v_process_discovery_auto_workflow_policy_gaps

candidate_status_v6:
  PROC-CAND:dot:kg: {status: plan_only_tested, endpoint_binding: all_missing, birth_readiness: blocked_endpoint_missing}
  PROC-CAND:job:cut: {status: verified_candidate, birth_readiness: verified_pending_owner, owner_missing: true, members: 8, correlation: job_queue.run_id}

policy_view: v_process_discovery_auto_workflow_policy_gaps   # ladder gates + next_required_action per candidate
admission_ladder: [structural, simulated, dry_run(real, endpoint-gated for agent_api), real_run, verified, owner, birth]

ui_packet: ready_operator_gated     # 7 routes, badges, verified-only-from-v3, no Nuxt math
job_cut_prep: ready_owner_pending   # no birth/approval; action='review' note
dot_kg_prep: sequenced              # endpoint->correlation->real_run->verified->owner->10def_split->events
d1_d2_expansion: published          # d1-supp + d2-supp companions; no source IU edit
auto_workflow_policy: live          # view + doc 10

safety_audit: PASS                  # no exec, no mutating agent_api, no REAL_RUN, no fake verified, no birth/canon, no approval, no event activation, no IU edit
artifacts:
  apply: /opt/incomex/docs/mcp-writes/dot-agent-api-endpoint-2026-06-04/v6_apply.sql
  rollback: /opt/incomex/docs/mcp-writes/dot-agent-api-endpoint-2026-06-04/v6_rollback.sql
  report_dir: knowledge/dev/reports/architecture/dot-agent-api-endpoint-true-dryrun-jobcut-ui-d1d2-readiness-2026-06-04/
  checkpoint: knowledge/dev/reports/architecture/checkpoint-dot-agent-api-endpoint-dryrun-readiness-2026-06-04.md

next_macro:
  primary: AGENT_API_PLAN_ONLY_ENDPOINT_SERVICE_IMPLEMENTATION
  parallel: [PROCESS_DISCOVERY_V6_UI_DEPLOY, JOB_CUT_PROCESS_REGISTRATION_OWNER_PACKET, INFORMATION_PIECE_D1_D2_KG_DOT_EXPANSION_CONTINUE]

exact_blocker: >
  A registered no-mutation agent_api PRODUCER invocation endpoint for DOT_KG_EXPLAIN
  (agent/LLM + credential + hosting surface) consuming FIXTURE:dot:kg:explain:v1,
  writing only to DRYRUN-NS:dot:kg:explain, returning a verifier-checkable output;
  bind as dot_agent_api_contract.endpoint_ref and flip mode->DRY_RUN. External infra, not DB engineering.