gemstone-nexus · Phase 6

DOC12 — Development History

← Documents

Metadata

iddoc_idtitlecategorysource_pathsummarycontent_hashindexed_at
30DOC12DOC12 — Development Historydoc_suiteDevResources/docs/DOC12-Development-History.md1. 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…e66c234145db45312d53d32e6b10952844c921df2026-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