gemstone-nexus · Phase 6
DOC12 — Development History
Metadata
| id | doc_id | title | category | source_path | summary | content_hash | indexed_at |
|---|---|---|---|---|---|---|---|
| 30 | DOC12 | DOC12 — Development History | doc_suite | DevResources/docs/DOC12-Development-History.md | 1. Original 21-document GemStone suite built: React Native/Expo/PWA mobile stack, Whisper/Piper voice pipeline, Atlas Vault via MCP Index B, Domain Pack framework, three-tier security model. 2. Amendment 1 (v1.1): security tier infrastructure, voice provider abstraction, External Research API added to Phase 1 MVP. HUME AI placed in Pending Review status. 3. Circular dependency identified in applying the standard Triptych-governance DOC26 template to GemStone itself; resolved… | e66c234145db45312d53d32e6b10952844c921df | 2026-07-22 18:33:18 |
Content
# DOC12 — Development History *Chronological record of major architectural decisions* **Initiative:** GemStone · **Version:** v2.0 (Rewrite) · **Status:** Approved for Build · **Date:** July 17, 2026 ## Timeline 1. Original 21-document GemStone suite built: React Native/Expo/PWA mobile stack, Whisper/Piper voice pipeline, Atlas Vault via MCP Index B, Domain Pack framework, three-tier security model. 2. Amendment 1 (v1.1): security tier infrastructure, voice provider abstraction, External Research API added to Phase 1 MVP. HUME AI placed in Pending Review status. 3. Circular dependency identified in applying the standard Triptych-governance DOC26 template to GemStone itself; resolved via Bootstrap/Self-Hosting two-phase lifecycle. 4. Didymus named and specified as the AI-orchestration hub (DIDYMUS-ARCH-01), distinct from HorizonNEXUS. 5. Human-in-the-loop established as a permanent, universal invariant: no autonomous execution for any task category, ever, at any maturity level. 6. Mobile stack migrated from React Native/Expo to Capacitor, aligning with DataRight Workforce and the prior StackOne Capacitor seed. 7. GemStone Mobility Layer specified (GS-MOB-01) in direct response to a documented review of Gemini Live production failures. 8. Universal orchestration architecture confirmed: GemStone is the single presentation/approval surface for all AI-tool-originated suggestions. 9. Field Mode / Extended Session audio architecture split finalized. 10. Android prioritized over iOS for native audio work; full default-assistant replacement considered and deferred. 11. v2.0 rewrite: full document set deepened with real schemas, API contracts, state machines, and testable acceptance criteria following an initial pass judged insufficiently detailed for Cursor to build from directly. 12. Stage 0 decision lock (July 2026): Auth0 + social logins; sovereign-first T4 backend; Postgres+Redis+SQLite ledger; Capacitor atomic concurrency; DataRightTailwind + HorizonORBIT login; primary EC2 `i-04333dae160ab0daa`; local clone source locked to `DataRightGoldenOVAFullBase`; DOC26 / DIDYMUS-ARCH-01 / GS-MOB-01 / DIDYMUS-PLAYBOOK authored into `DevResources/docs/`; legacy product-name purge deferred until first green GoldenAMI build. 13. Stage 1 (July 2026): DataRightAppBundle repaired (22-doc alignment, Capacitor path, missing scripts/Dockerfiles, SaaS modules, phase graph). 14. Stage 2 (July 2026): Operating model + Deploy pipeline. `DEVELOPMENT_DIRECTORY=/home/dr/AppDev/gemstone-nexus` on T4 EC2; plink/`dr` + PEM break-glass; host key pinned; PAT pull via Basic auth without storing token in remote URL; scripts `remote-exec.ps1`, `ensure-ec2-dev-dir.ps1`, `run-remote-docker-deploy.ps1`, `scripts/aws/deploy.sh`; EventBridge start/stop confirmed ENABLED; `launch_instance=true` documented as intentional for live host. Full product Deploy deferred until Stage 3 commit. 15. Phase 3A/3B (July 2026): Domain Pack system — Alembic `0002_phase3ab` extends `domain_packs` + practitioner-scoped `pack_installations` (RLS org_id retained); six first-party packs (PE Operating Partner, Healthcare Executive, FinTech/Capital Markets, Management Consulting, Construction/Real Estate, Manufacturing Operations); DOC03 install/uninstall API; Capacitor `/packs` UI; DOC20 §2 UAT harness with <10s activate gate. 16. Phase 3C (July 2026): Didymus universal approval orchestration — Alembic `0003_phase3c` status machine + `didymus_tasks_approval_gate` (RUNNING/COMPLETED/FAILED/VERIFIED require `approved_by`+`approved_at`); `didymus_workers` registry; three MVP workers (Cursor/Claude/Gemini) implementing DidymusWorker contract; REST `/api/didymus/*` + MCP `/mcp/didymus/*`; Capacitor `/didymus` blind-source queue; DIDYMUS-PLAYBOOK updated with secrets placement and registration steps. 17. Phase 4 (July 2026): Platform Dashboard (DOC21) — Alembic `0004_phase4` metric tables (`consent_events`, `audio_pipeline_holds`, `wake_activations`, `ledger_entries`, `sessions.ended_at`); REST `/api/dashboard` with eight views; Capacitor `/dashboard` under DataRightTailwind tokens; Auth0-ready HorizonORBIT-style login without fake tenant; WCAG AA focus/skip-link polish; DOC20 automatable UAT recorder in `phase4_bench`; Phase 5 hardening scaffold only (Playwright/load/SBOM stubs — pen test external). 18. Phase 5 engineering (July 2026): Playwright critical-path E2E, scaled load proxy + report, Syft/SBOM script + BABA checklist, pen-test engagement brief, store-submission prep checklist; full DOC02 Phase 5 exit still blocked on third-party pen test, 10k voice soak, principal BABA sign-off, and App/Play accounts. 19. Naming purge (July 2026): after first green GoldenAMI build, legacy product naming removed from code/config/docs; CI grep gate `scripts/ci/forbid-legacy-product-name.*` fails on reintroduction. 20. Production closeout punchlist (July 2026): Live Auth0 deferred non-blocking (`DOC-Auth0-Provisioning.md` + DOC07); Atlas vault keys absent from `DATARIGHT_DEV_SECRETS` — stub retained on punchlist; pen-test/BABA/store/device-UAT prep docs complete with human gates listed; EC2 root EBS 30→80G + HTTPS 10k `/healthz` proxy (not voice gate). ## Historical footnote (allowlisted) > StackOne frontend/backend seed for this repo was sourced from a prior StackOne > extraction formerly branded **DotOnTheMap**. That brand name is retained only > in this footnote for provenance; CI allows at most two `DotOnTheMap` mentions > in this file. --- NEXTECH Business Technology Management LLC · nex-tech.biz · (941) 499-5505