Skip to content

Regulatory admin (ops) ​

UI: locus-ops → /regulatory.

Bank workspace never writes the platform legal vault. Analysts only resolve / open statutes and see findings overlaid from SoR.

Tabs / surfaces ​

SurfaceActions
Source RegistryWatchtower sources (URLs, fingerprints) from config + SoR
Legal VaultUpload official PDF → artifact on edition
ReviewHASH_CHANGE / new edition / extractor issues → Approve & publish (VaultPublisher) or reject
ApplicabilityMap provisions → instruments / deal types (LegalProvisionApplicability)
LogsOperator audit of vault actions

Attach & publish (happy path) ​

  1. Create or select edition / instrument context.
  2. Upload PDF (R2 when configured; else LEGAL_VAULT_LOCAL_DIR).
  3. POST /api/admin/regulatory/editions/{id}/artifact (via ops BFF/client).
  4. Open Review → human APPROVE.
  5. VaultPublisher marks legal_reviewed / in_force as designed.
  6. Bank: analyzeDealWithVault / resolve / open-statute can use vault IDs + hash-verified bytes.

Discovery vs validity ​

Watchtower / fetcher may enqueue candidates automatically when the scheduler is on (LEGAL_VAULT_WATCHTOWER_INTERVAL_MINUTES > 0). Scraped ≠ in force until APPROVE.

Fixtures ​

CI uses synthetic PDFs under data/regulatory/ — fixtures guide. Production corpus = official gazettes uploaded here.

Source of trust for Locus. If this conflicts with code, code + IMPLEMENTATION_TRACKER.md win.