docs: describe Track project poll
Track edits reach DEMI by a 5-minute poll with a nightly backstop. Replace the no-live-feed text.
docs: describe the layered write path
docs: wire Eagle new-kind routes and search
docs: describe React frontend in place of Angular
Add a build and test section to Frontend.
docs: test API is Flex, devbox replaces tunnel
demi-api-test and demi-plan-test are deleted; test API is demi-api-fc-test
(Flex) only. Dev access to Cosmos/Search moves to the devbox VM
(demi-devbox-test), replacing the App Service SSH tunnel in test. Prod keeps
its legacy app and tunnel until a prod devbox lands.
Claude-Session: https://claude.ai/code/session_01S8de7pb7tb7SQ2bdToXUto
docs: document per-user data feature
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(env): staging now c4b0a8-test
Dev estate torn down 2026-08-11; hosts repointed, greenfield traps noted.
docs: record what the 2026-08-04 TODO sweep measured and changed
Search-and-Retrieval: added the n=78 scorecard row and the reason it is the same
number as n=71 -- same index, seven more tiled labels, no code change. Replaced
the label-debt paragraph with what paying it found: tiled retrieval is binary
(every hit ranks 1st, nothing at 2-10) and one miss is a pure ranking failure on a
document holding the phrase verbatim. Recorded that project and document
highlighting moved server-side, and why the client path survives.
Azure-Environments: main.bicep now describes the environment, verified by what-if
with zero creates and zero deletes. Listed the drift the rewrite surfaced -- a
SystemAssigned identity that was never real, a Y1 plan that was always B1, fifteen
app settings that existed only live, and a hand-made search role assignment.
Environment-Reality: the VNet section said main.bicep builds its own network. It
no longer does; subnet IDs are parameters into the platform spoke.
Architecture: syncState deleted from the live account, empty and unreferenced.
leases stays, with the reason.
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.