gemstone-nexus · Phase 6
DOC19 — Project Ledger and Intelligence Layer
Metadata
| id | doc_id | title | category | source_path | summary | content_hash | indexed_at |
|---|---|---|---|---|---|---|---|
| 37 | DOC19 | DOC19 — Project Ledger and Intelligence Layer | doc_suite | DevResources/docs/DOC19-Project-Ledger-Intelligence-Layer.md | 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, bidirectionally synced with Development History (DOC12). | 133f9c27ad0138110cfd1ae260cd5f38ec791c75 | 2026-07-22 18:33:18 |
Content
# DOC19 — Project Ledger and Intelligence Layer
*Schema and Atlas distillation feed*
**Initiative:** GemStone · **Version:** v2.0 (Rewrite) · **Status:** Approved for Build · **Date:** July 17, 2026
## 1. Purpose
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, bidirectionally synced with Development History (DOC12).
## 2. Ledger Schema
```
class LedgerEntry(SQLModel, table=True):
__tablename__ = "ledger_entries"
id: UUID = Field(default_factory=uuid4, primary_key=True)
entry_type: str # "deploy" | "uat_result" | "pack_version" | "didymus_task" | "research_query"
payload: dict = Field(sa_column=Column(JSON))
created_at: datetime
confidence_score: Optional[float] = None # set when this entry is distilled
promoted_to_atlas: bool = Field(default=False)
```
## 3. Intelligence Layer Feed
This ledger feeds the same distillation discipline used platform-wide: decisions, rationale, and outcomes are captured and promoted into Atlas Vault; mechanical process detail is not. Every external Research Agent query audit token is recorded here.
## 4. Stage 2 ledger bootstrap (pre–SQLite service)
Until Stage 3 stands up the ledger-api + SQLite file on `/mnt/docker-data`, the project ledger is maintained as markdown + this DOC:
| Entry type | Stage 2 record |
| --- | --- |
| `deploy` | Pipeline documented in `DOC-Deploy-Pipeline.md`; host worktree at `/home/dr/AppDev/gemstone-nexus` (origin HEAD at first clone: initial commit only — product tree still local/untracked pending Stage 3 commit) |
| `ops` | EC2 `i-04333dae160ab0daa` / `18.116.188.14`; EventBridge start/stop ENABLED; host key rotated 2026-07-21 |
| `decision` | No local Docker; Deploy = commit→push→pull→compose; PAT never stored in EC2 remote URL |
Atomic concurrency rule (from day one): any change that touches schema, API, Swagger, UI, or tests updates DOC12 + DOC07 + a ledger entry in the same Deploy.
---
NEXTECH Business Technology Management LLC · nex-tech.biz · (941) 499-5505