GOTT · Sibyla · docs/

Documentation index

Updated 2026-08-22. Runtime baseline fe17469 is the immutable merge from MR !137 (the Stage 11 related-party re-bind and the host-only proof fixes); later docs-only merges do not change that runtime baseline. Authority runs V6.md (plan of record) → STATE.md (live state, one page) → project-todo-v6.md (backlog). When two documents disagree, the one higher in that chain wins; docs/archive/ carries no authority. Markdown files open in the editor or GitLab; HTML and SVG files open in the browser.

S0 · 8/8closed 2026-08-18 · GD-1 E2E through /api/channel-intake/v1
S1 · closed2026-08-20 · CTT exit demonstrated and validated with screenshots
S1.5 · completeMR !59 · empty contract diff
S2 · intakein progress · registry-bridge slices 1–5 merged · ~3 wk
S3 · review/learn~2 wk
S4 · izibizi push~2 wk · B1 provisioned · B2 set, not closed
S5 · channels~2 wk
S6 · archive~2 wk
S7 · pilot4 wk running

Live — read these first

STATE.md live · in place The one-page state: the nine steps honestly marked, where the code stands, what is open. Updated in place, never appended.
project-todo-v6.md backlog · rev 54 80 live items across S0–S7. Itemised through S2, sketched after. Counts are observations, never acceptance criteria.
project-evolution-v6.html dashboard KPIs, commit history (code vs governance), roadmap, open items, deferred list, chronicle — all counted by stated rules.
Organigrama Fluxo v19 (SVG) diagram · current v19 is current. The information flow under plan v6.0 with per-phase status — green built, blue current, dashed future. Supersedes v18: the reference-layer panel is repainted complete (all S1-9 pieces ai in main, the eleven Entity 360 slices named, only g3 and the DOCEFL editor carried out of S1), DOCEFL reads 64 rules / 93 targets, the suite counts are the ones measured in the green main pipeline 2780097183 at fe17469, S6 carries the canonical-filename / ArchiveNameLedger split, S2-5 states the audit-event-now / flag-at-S2-11 position, and the S4 footer carries the verified B1/B2 host state rather than "untouched".

Plans and decisions

V6.md plan of record Development Plan v6.0 — decisions V6-D1…D5 and V6-O1, the nine-step loop, phases S0–S7, cuts with reinstatement triggers.
master-data-and-ui-plan.md · html approved · rev 18 M-D1…M-D12, the ENTMST collapse, the generic reference grid, the seven hand-built screens, menu tree, S1-9 breakout. M-D8 (2026-08-21) records the Stage 11 rule: a source retirement is evidence, not a target mutation, and an identity pin binds to a natural key rather than to a code. M-D9…M-D12 (2026-08-22) close the four Stage 11 follow-ups carried by S2-6 — the ITMCLS re-key, Relevancy persistence, RelatedParty/Kind pair resolution, and ITMMST joining the DOCFLG RelatedRecordType domain. Decisions only; no code. The .md is authoritative; the html rendering carries a dated status banner and is not updated by this pass.
master-data-phase2-plan.md · html approved Deferred structural items P2-1…P2-7, each with its decision point. P2-2 closed without consolidation; P2-4 taken for EXCRAT.
p1-0-schema-mapping.md schema reference The FDR schema mapping — the main P1-0 output that survives, kept current (updated by !62). §3 holds the S1-2 source-semantics decisions of record.
p1-0-vocabularies.md reference Controlled vocabularies the CHECK constraints are generated from. Regenerated in full from Stage 11 4ea2e67 on 2026-08-22 by scripts/generate-vocabulary-annex.py, so the table has one provenance instead of three. The earlier open question is closed: the 2026-08-21 re-measure had been partial, and all six of BlockingLevel, FlagCategory, ReviewPriority, AutoActionAllowed, AutoReviewable and Active are non-blank on all 64 rules — every DOCEFL row now sums to 64 and the Aug-6 → Stage 11 increments reconcile field by field. Findings F-1F-16 separate source additions from prior annex incompleteness.
database-erd.md · html reference Entity-relationship view of the live schema (last reconciled after !72: DocumentTypeSetting removed; the BusinessEntity block maps to table ENTMST).
golden-documents.md registry The golden-document registry (GD-1 onward): path + SHA-256 against the read-only prototype. Grows to ~30 in S2.

Agent prompts

AGENT-PROMPT-v6-S1.md S1 closed · history Superseded by the S1 close of 2026-08-20 — the “CTT” exit it was written to reach was demonstrated and validated with screenshots, and g2 shipped as !117; kept as the record of the S1 run. Its text: Finish S1: Entity 360 — all nine tabs built; what remained was the S1 exit criterion, the demonstrated “CTT” search · S1-9c complete (EXCRAT !100, ITMALS !101, ENTALS !102) · DOCEFL read catalogue (!104) and the DOCTYP presentation write (!105) landed · the Companies entity-half repoint (!107) landed · the ITMMST item master (!109) and the entity-item matrix with the classification queue (!110) landed · entity banking (!112) and the SNC tree (!113) landed — every buildable S1-9 piece is delivered; g2 (IsActive toggle) proceeds through the normal flow, g3 waits on O-1 (Luís), and the DOCEFL editor is formally deferred to S2 (O-4 stays Miguel's). The CI-minutes quota ran out and was topped up the same day; !110's post-merge pipeline retried green.
AGENT-PROMPT-v6-S0.md S0 closed · history The S0 run-one-document prompt. Its final GD-1 channel-intake run completed 2026-08-18 and closed S0-4/S0-5; the 2026-08-10 run was preliminary and is superseded. Kept as the record of that run.
archive/ — v5 prompts no authority The 31 v5-era agent-prompt and governance files — the prompt subset of the frozen archive corpus (~62 files, 1.7 MB in total). History only.

Integrations and channels

cegid-integration.md correct at S4 Operational doc for the S4 target. Still describes the pre-refactor ledger and a "Moloni not implemented" placeholder — S4-5 brings it current at the start of S4; read with that caution.
moloni-integration.md · plan built · parked Adapter built and parked. Activation is a business blocker (client's API subscription and credentials), Phase 2.
whatsapp-lid-and-e164…​.md for S5 Dual-alias (LID + E.164) authorisation design for the Baileys channel.
hermes-documental-agent-instructions.md reference Extraction and Portuguese fiscal-QR rules — good work that ports to the new engine. Companion: financial-agent instructions, lessons learned, Apolo intake addendum, runtime acceptance, target remediation.
FDR-to-Sibyla decisions for Luís v2 · pdf O-1 pending The decision letter — O-1 (Payables/Receivable spelling) remains unanswered and gets fixed at source in the DOCTYP screen. v1 kept for history.

Deployment and operations

izibizi-b1-verification.mdizibizi-activation.md B1 done · B2 not closed Verified live on the host 2026-08-22, so the verification document now carries a result rather than a plan. B1 (Miguel) was provisioned 2026-07-21 and reconfirmed live — certificate with private key, key ring with one key-*.xml, ACLs on the three runtime identities, .pfx backup present; one named closeout remains, backing up the live key-ring XML before disaster recovery is called complete. B2 (Luís) credentials are already set — but the connection is disabled and unvalidated and the latest test failed, so B2 is not operationally closed. Do not reprovision, enable or call Cegid.
iis-and-worker.md runbook Host deployment of API, Web and Worker under IIS / Windows Service.
o5-target-host-runbook.md · design O5 · production gate Restricted-identity validation on the target host. Owner Miguel; nothing in S0–S6 waits on it, must close before S7 runs on real data.
moloni-oauth-reauthorization-runbook.md runbook Moloni OAuth re-authorisation steps, for when the adapter is activated.
production.env.example.ps1 template Per-host environment template — each host sets its own Sibyla__StorageRoot and connection strings.

Superseded and absorbed — kept to avoid re-arguing

Each was absorbed by a v6 phase or deferred with a trigger (V6.md §7 / Appendix B). Read them as history, not instruction.

general-document-archive-scope-plan.md absorbed → S6 DOCTYP + DocClass + ProcessingRoute + DOCARC already do its job; its new asks are Phase 2.
document-cataloging-remediation-plan.md root cause → S2-7 The Tranquilidade case. Its root cause is fixed properly at S2-7; its Phase 3 (per-supplier hints) is deferred.
multi-provider-per-company-plan.md deferred Returns at a second live ERP for a company that also needs the first.
company-integration-provider-selection-plan.md · legal-entities-cataloging-switchover.md · graph-spike-setup.md · f0-spike-results.md history Earlier selection plans and spike records; shipped or overtaken.
Organigrama v18 · v17 · v16 · v15 · v14 · v13 superseded Earlier flow diagrams. v19 above is current; v18 (2026-08-21) joined this list when v19 replaced it on 2026-08-22.
project-evolution v5 · v4 · original superseded Earlier evolution pages, kept for the record.
archive/ no authority The whole frozen v5 process corpus — ~62 files, 1.7 MB, of which 31 are the v5-era agent-prompt and governance files listed above. archive/README.md states the folder carries no authority.

This index is a map, not an authority — if it disagrees with V6.md, STATE.md or the backlog, they win and this file needs the edit. Maintained by hand; update it when a document is added, superseded or renamed. Repo: GOTT.Sibyla · GitLab gottsolutions.dev/sibyla/GOTT.Sibyla.