PD Full Operationalization — 00 Readme First
00 — Readme First
Date: 2026-06-04 · Macro: PROCESS_DISCOVERY_FULL_OPERATIONALIZATION_ENDPOINT_DRYRUN_UI_REGISTRATION_PIVOTS_AND_RETURN_TO_CONTENT Final status: PARTIAL → but the headline blocker is CLEARED. The first true DRY_RUN is done. Execution mode: EXECUTION_MODE. RO=query_pg; RW=ssh contabo→docker exec -i postgres psql -U directus -d directus; KB=upload_document; staging=/opt/incomex/docs/mcp-writes/process-discovery-{endpoint-service,full-operationalization}-2026-06-04/.
What changed this run (vs every prior run)
The credential-reuse owner blocker that gated all prior runs was lifted by an explicit owner instruction this session: "retrieve any key/credential autonomously from the existing approved secret helper; do not ask for infrastructure details." With that authorization + the macro's standing permission to deploy internally if safe, Workstream A executed end-to-end:
- Built + deployed the staged no-mutation
agent_apiexecutor (incomex-agent-api-executor) internal-only (loopback127.0.0.1:8090+ docker networkdocker_incomex; no public route; read_only, cap_drop=ALL, no-new-privileges, user 10001, no DB driver). - Retrieved the existing
OPENAI_API_KEYfromincomex-agent-datainto a 0600 env file — reuse, not a new secret. /healthzok,/selfcheck7/7 (no LLM), real/dispatchDRY_RUN produced a verified gpt-4o output (is_mock=false, verifier 5/5),REAL_RUNrefused (403).- Bound
DOT_KG_EXPLAINendpoint_refand flipped mode→DRY_RUN. - Ran the DB dispatcher and upgraded the observation to a genuine
DRY_RUNbacked by the executor evidence.
Invariants held (proven)
birth_registry1,163,464 == 1,163,464 before==after the DB work (bind + dispatch + upgrade + v8 views birthed nothing).trigger_guard_alerts129 unchanged.- REAL_RUN = 0 preserved. DRY_RUN = 1 (PROC-CAND:dot:kg).
verified_candidates_v3= ONLY PROC-CAND:job:cut — dot:kg isdry_run_observed, not verified.
Read order
01 live state · 02 endpoint deploy/bind/dryrun · 03 v8/UI · 04 job:cut · 05 dot:kg · 06 AX-PROCESS pivots · 07 policy scheduler · 08 return-to-content · 09 3-macro roadmap · 10 safety audit · 11 next macro · 12 final summary · 13 GPT/MCP checkpoint.
Rollback (all reversible)
- un-bind:
UPDATE dot_agent_api_contract SET endpoint_ref=NULL, mode='PLAN_ONLY', contract_status='contract_ready' WHERE dot_code='DOT_KG_EXPLAIN'; - remove dry-run obs:
DELETE FROM process_component_observation WHERE correlation_id='dryrun-kgexplain-20260604T081942Z'; DELETE FROM process_run_observation WHERE correlation_id='dryrun-kgexplain-20260604T081942Z'; - drop v8 views:
sql/v8_rollback.sql - remove service:
docker rm -f incomex-agent-api-executor; docker rmi agent-api-executor-local:v1 - remove scheduler:
systemctl disable --now process-discovery-policy-scan.timer; rm /etc/systemd/system/process-discovery-policy-scan.{service,timer} /opt/incomex/scripts/process-discovery-policy-scan.sh