> **Status (Stage 2):** Ohio T4 host is live (`i-04333dae160ab0daa`, us-east-2). > Day-to-day Deploy is documented in `DOC-Deploy-Pipeline.md` and driven by > `scripts/run-remote-d
This playbook is the end-to-end install and operate guide. It does **not** replace mobility specs or device UAT scripts — those live in the referenced docs below.
Behavioral contract for the ported stack. These notes capture what the API and voice loop promise, and what changed during the port from a prior StackOne extraction.
Didymus is the AI-orchestration hub that registers build suggestions from AI tools and desktop workers, stores them under a schema-enforced approval gate, and presents every task t
Operator and practitioner guide for provisioning AI development-tool workers, storing credentials in the secrets tier, registering workers with Didymus, and running the human appro
vault may still be stubbed. GemStone remains an MCP *client*; these Postgres tables are the durable local Index B mirror (org + practitioner segmented).
GemStone is an **MCP client** to a remote Atlas Vault. This document describes the Index B contract GemStone speaks, how to point at a real vault, and the local stub used when no r
On punchlist (`DOC07-Punchlist.md` § Deferred). No live Auth0 credentials exist in AWS Secrets Manager or on the T4 host. Stack remains bootable with placeholders. **Phases 0–5 and
Agent “text me” uses **Amazon SNS SMS**. The account is still in the **SNS SMS sandbox**. Destination `+14193063078` is stuck **Pending** (OTP never completed). US carriers often f
| Component | Origin claim | Evidence in repo | Engineering status | | --- | --- | --- | --- | | Whisper large-v3 | OpenAI (US) | DOC18 §1; whisper service | Confirmed in DOC18 bas
Auth0 deferred (not required). Device UAT still open (`DOC-Device-UAT-Checklist.md`).
| Role | Where | |------|--------| | Author / edit | Windows workstation (this repo) | | Git | Local commit → `git push` with PAT (from `DATARIGHT_DEV_SECRETS`, never stored in rep
| Check | Notes | | --- | --- | | Capacitor Android project present | `frontend/android` after `npm run cap:sync` | | Capacitor iOS project present | `frontend/ios` — requires macO
GemStone is the **orchestrator**. Practitioners connect AI workers (Cursor, Claude, Gemini, Ollama). Didymus shows approval-gated tasks and buffered conversation events linked to *
# GemStone-Golden host contract verify
Before GemStone answers (sovereign chat, Gemini Live, or ledger RAG), it checks **GemStoneGuardRails**. If the user question matches a rule (exact or inferred similarity), GemStone
- Independent third-party assessment covering OWASP Top 10 at minimum. - All Critical and High findings remediated and re-tested before production. - Medium findings: documented re
| View | API | UI | | --- | --- | --- | | Approval Queue | `/api/dashboard/approval-queue` | `/app/dashboard` | | Worker Health | `/api/dashboard/worker-health` | same | | Tier Dis
| Work item | Engineering (this pass) | Practitioner / vendor | | --- | --- | --- | | Playwright E2E ×2 clean | `frontend/e2e/` critical paths + `npm run test:e2e:twice` | Device U
Each signed-in practitioner can save **personal** fixed-response rules in their Atlas segment (`org_id` + `practitioner_id`). These are consulted **after** product-wide `GemStoneGu
Do these in order. Do **not** paste secret values into chat or git.
| Blocker | Status | | --- | --- | | Apple Developer Program enrollment | **On punchlist** — required for App Store Connect | | Google Play Console developer account | **On punchli
| Capability | Doc source | Live code | Status | |---|---|---|---| | Gemini Live voice (`/ws/gemstone/live`) | contract-notes, punchlist | `api/app/ws/gemstone_live.py`, `web/gemst
Didymus live worker execution (Cursor, Claude, Gemini, optional Ollama) runs against **your** vendor accounts. This playbook explains how a practitioner connects each worker by pro
GemStone is the voice-first, mobile-first agentic interface layer of the NEXTECH Triptych (GemStone, Horizon Atlas, Horizon IQ), functioning as an executive assistant that works al
| Term | Definition | | --- | --- | | Practitioner | The licensed end user of GemStone; owns one Atlas Vault; scoped by org_id and practitioner_id. | | Session | A single continuou
``` class SecurityTier(str, Enum): HIGH_SECURITY = "high_security" # numeric value 0 (most restrictive) STANDARD = "standard" # numeric value 1 OPEN_MODE = "open_mode
US-01: As a practitioner, I can speak a request to GemStone and receive a response without losing context if I step away mid-session.
| ID | Feature | Acceptance Criteria Summary | Dependency | | --- | --- | --- | --- | | FR-GS-001 | Capacitor Field Mode voice interaction | Voice activates <1s on tap; standard We
This is the last document in the GemStone set, built only after DOC01 through DOC05 and DOC07 through DOC21 (plus Amendments 1 and 2) are complete, because it aggregates and refere
| Item | Owner | Verification Artifact | | --- | --- | --- | | Docker Compose stack, all services healthy | Engineering | docker compose ps output, 10-min idle stability log | | ge
1. Query the sessions table for the session_id; confirm state and check interruption_snapshot is non-null. 2. If interruption_snapshot is null and state is PAUSED, this is a defect
GemStone: the voice-first, mobile-first agentic interface layer of the NEXTECH Triptych, and the single universal presentation/approval surface for all build task suggestions.
1. Security tier selection: explain High Security, Standard, and Open Mode (canonical display names; wire values high_security / standard / open_mode per DOC03); confirm the practi
GemStone is positioned as a full-capability AI partner, not a chatbot, and its mobility layer is explicitly positioned against the documented shortcomings of existing voice-assista
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 secur
``` Practitioner gemstone-api atlas-ollama (Whisper) gemstone-tts (Piper) |-- audio chunk -->| | | |
GemStone implements a three-tier testing architecture plus a UAT framework. All runs are logged to a dated narrative file and the Project Ledger database. make test executes all ti
| System | RTO | RPO | Backup Frequency | | --- | --- | --- | --- | | gemstone-db (sessions, tiers, ledger) | 15 minutes | 5 minutes | Continuous WAL archiving + hourly snapshot |
- Session transcripts are never transmitted externally, in any security tier, without exception. - Human approval is required for every build task execution, without exception, reg
GemStone and its Mobility Layer adhere to the standing Western-origin technology stack constraint across AI/ML frameworks, messaging infrastructure, and MQTT brokering. Core voice
| Component | Origin | License | Container | | --- | --- | --- | --- | | FastAPI | OSS (International) | MIT | gemstone-api | | Whisper large-v3 (weights) | OpenAI (US) | MIT | atl
The GemStone Project Ledger is a standalone ledger-api instance tracking session history, deploy events, UAT results, Domain Pack versions, and Didymus task/approval history, bidir
1. Start a Standard-tier session and begin a voice conversation. 2. Background the app for 2 minutes (within Extended Session grace window). 3. Reopen the app. Expected: session re
| View | Metric | Source / Calculation | | --- | --- | --- | | Approval Queue | Pending task count by age bucket | COUNT from didymus_tasks WHERE status=PENDING, grouped by created
This document defines the maturity gates that move GemStone from Bootstrap (human-directed build with external AI workers proposing tasks) to Self-Hosting (GemStone may propose bui
This amendment folds the Didymus orchestration architecture and the Bootstrap-to-Self-Hosting lifecycle into the core GemStone suite by reference. GemStone is the single, universal
This amendment folds the Capacitor-based GemStone Mobility Layer into the core GemStone suite by reference, replacing the original React Native/Expo/PWA mobile stack in full.
This document is the executable Mobility Layer specification named by DOCA2, DOC02 Phases 2B/2C, DOC03 Section 13, and DOC06 Section 7. It replaces the superseded React Native/Expo
Recreate the GemStone dev stack in **us-east-2 (Ohio)** — the home datacenter — as