Add 'fiscal/' from commit '102ba84500dbd9655a0471288c3e278652593ca9'

git-subtree-dir: fiscal git-subtree-mainline: d95165fc8f git-subtree-split: 102ba84500
2026-09-29 14:43:23 -03:00
parent d95165fc8f 102ba84500
commit d21a9d1140
868 changed files with 566394 additions and 0 deletions
@@ -0,0 +1,121 @@
+# Autonomous Operations Closure V1
+
+## Final Status
+
+```text
+STATUS=OPERATIONALLY_CLOSURE_VALIDATED
+TOTAL_PRODUCTS=35066
+FISCALLY_COMPLETE=34872
+FISCALLY_INCOMPLETE=194
+AUTONOMOUSLY_CORRECTABLE_PRODUCTS=34872
+SAFE_BLOCKED_PRODUCTS=194
+AUTONOMOUSLY_PROCESSABLE_PRODUCTS=35066
+AUTONOMOUS_OPERATION_RATE=100%
+INSTALLATION_REQUIRES_OPERATOR_TO_CONTINUE=false
+AGENT_HEALTH=HEALTHY
+```
+
+The 194 incomplete products are isolated safe exceptions. They do not stop
+processing of the other 34,872 products, heartbeat, new jobs, reconnection, or
+future deterministic corrections.
+
+## Product States
+
+The operational contract has exactly seven states:
+
+`COMPLETE`, `CORRECTED`, `BLOCKED_MISSING_EVIDENCE`, `BLOCKED_CONFLICT`,
+`BLOCKED_COMPANY_CONTEXT`, `BLOCKED_SCHEMA`, and `FAILED_TECHNICAL`.
+
+Blocked products never receive uncertain writes. Technical failures are kept
+separate and retryable. A blocked product becoming complete on a later
+evaluation closes its registry blockers automatically.
+
+## Blocked Registry
+
+The Hub now has a deduplicated `blocked_products` registry with tenant,
+company, product, GTIN, description, blocker type, field, reason, evidence,
+input fingerprint, timestamps, retry count, retry schedule, resolution time,
+and resolution source.
+
+Available API operations:
+
+- `GET /v1/blockers`
+- `GET /v1/blockers/export.csv`
+- `POST /v1/blockers/reprocess`
+- `POST /v1/blockers/{id}/resolve`
+
+The same blocker/input fingerprint is a cache hit and does not create another
+row or notification. Reprocessing is eligible when the product/context,
+dataset, KB, engine input, or retry schedule changes.
+
+## Current Residual
+
+```text
+CFOP_BLOCKERS_BEFORE=79
+CFOP_BLOCKERS_AFTER=79
+ST_BLOCKERS_BEFORE=57
+ST_BLOCKERS_AFTER=57
+ICMS_RATE_BLOCKERS_BEFORE=53
+ICMS_RATE_BLOCKERS_AFTER=53
+CSOSN_BLOCKERS_BEFORE=27
+CSOSN_BLOCKERS_AFTER=27
+HUMAN_COMPANY_BLOCKERS=4
+HUMAN_PRODUCT_BLOCKERS=190
+```
+
+No requiredness rule was weakened to increase the operation rate. The remaining
+fields require facts not proven by the current ERP evidence. The four company
+blockers remain context ambiguity; they were not converted into defaults.
+
+## Simulations
+
+The offline 20,000-product simulation passed:
+
+- 19,900 complete products processed.
+- 100 safe blocked products preserved.
+- `AGENT_HEALTH=HEALTHY`.
+- Heartbeat and new jobs continue.
+- Second pass is idempotent.
+
+The new-evidence simulation passed:
+
+`BLOCKED_MISSING_EVIDENCE -> COMPLETE -> blocker resolved`.
+
+## Go-Live Policy
+
+```text
+BLOCKED_REGISTRY_READY=true
+BLOCKER_DEDUP_READY=true
+AUTO_RETRY_READY=true
+AUTO_RESOLUTION_READY=true
+EXCEPTION_QUEUE_READY=true
+AI_REQUIRED_FOR_MANDATORY_COMPLETENESS=0
+EXTERNAL_PROVIDER_REQUIRED_FOR_MANDATORY_COMPLETENESS=0
+AI_WRITE_ALLOWED=false
+FIREBIRD_AI_WRITES=0
+CAN_RUN_UNATTENDED_ON_CLIENTS=true
+CAN_DEPLOY_WITHOUT_AI=true
+```
+
+This is an operational go/no-go assessment only. No deployment was performed.
+
+## Remaining Gaps
+
+- 194 products remain safely blocked by missing evidence or company context.
+- No deterministic write was required or executed in this closure.
+- AI remains optional enrichment for 511 items.
+- Real client deployment, infrastructure preflight, and production credentials
+  remain outside this mission.
+
+## Verdict
+
+`VERDICT=AGENT_CAN_CONTINUE_UNATTENDED_WITH_SAFE_PER_PRODUCT_EXCEPTIONS`
+
+## Verification
+
+```text
+FULL_TESTS=tests 324 passed, 1 skipped
+CENTRAL_TESTS=230 passed, 1 warning
+AGENT_TESTS=44 passed
+DIFF_CHECK=PASS
+```