docs: verify every page, split those over 15 KB
Every page checked against src/, azure/ and live Azure. History,
future state and duplicated facts removed. Search, Architecture,
Extraction and Azure ops pages split by topic. Track feed ask is
ADR-009 Proposed. EPIC.search worksheet reduced to the divergence
table.
Claude-Session: https://claude.ai/code/session_01Lv5nbmWMatCc8PzYmpupNb
docs: correct the record after the 2026-08-23 audit
Two new authority pages, because the direction changed and nothing described it:
Identity-Model (Track project ids are the master id; Eagle _id becomes an
attribute; an Eagle project with no Track counterpart is retained and flagged)
and Sync-Architecture (eagle-api pushes to DEMI on write, authenticated — not a
change-stream worker, not a poller — and why DEMI needs far less cascade than
eagle-search).
Dangerous corrections, called out rather than silently swapped:
- The backup window was overstated everywhere. demi-cosmos-test is Periodic,
240-minute interval, 8-hour retention — two restore points, not Continuous7Days.
Every 7-day claim came from demi-cosmos-dev, torn down 2026-08-11. chunks is
the only extracted copy and its restore path has never been tested.
- The project-unpublish cascade fires only on unpublish and overwrites read[]
rather than intersecting it, so an overwrite can widen a document's ACL. Both
recorded as open defects.
- ADR-004 listed three privileged roles; SECURE_ROLES has four since ADR-007
added demi-service-read.
Cost reconciled against Cost Management ActualCost: ~451 CAD/month on
c4b0a8-test-rg (Aug 16-22, 7 full days), not the ~47 ADR-008 carried, which
averaged two days of billing across twelve. budgetAmount is now below the run
rate.
Business-Rules and ADR-003 labelled aspirational — no classifier exists, no
configs/ directory, and orcsClassification is a passthrough of Eagle's field.
BR-04 is the exception: it ships as the read[] ACL.
Dev was torn down 2026-08-11, NRPTI was removed entirely, and the live index
names are projects/documents/chunks. Six pages still said otherwise.
.github/antigravity.md deleted — a stale duplicate of a dead agent's rules.
docs: catalogue EPIC.search business rules as a comparison worksheet
EPIC.search is a vector/RAG stack and shares no implementation with DEMI
search. Its rules are recorded for comparison and business validation only;
nothing here is adopted policy.
docs: rewrite wiki for the system that exists
Every page described an OpenShift + Typesense + MongoDB stack that was
deleted in July. Nothing mentioned Azure AI Search, Cosmos NoSQL, App
Service or BM25.
Deleted the five pitch-era pages plus Technical-Decisions and
Architecture-Overview: written to win funding, costed against a
$500-2000/mo strawman, and describing a plan rather than a build.
Salvaged the business framing into Home and the GIS decision into
Architecture.
Added Architecture, Search-and-Retrieval, Extraction-Pipeline, ADR-005
and Cosmos-Migration-Record, sourced from the repo's MIGRATION.md so the
facts have a home before that file goes. Moved the landing-zone notes in
from docs/.
Superseded ADR-001 and ADR-002 in place. ADR-002's premise never held
here at all: Cosmos Mongo API has no change streams.
Every environment claim re-checked against live Azure first. Three
corrections that came out of that: demi-api-dev is a Function App kind on
a B1 Basic plan, not Y1 Consumption; WEBSITE_RUN_FROM_PACKAGE is 0, not
1; and MinIO is real and current, not Typesense-era residue.
docs(wiki): convert JSON drafts to AI-friendly MD, add business rules