gemstone-nexus · Phase 6

DOC19 — Project Ledger and Intelligence Layer

← Documents

Metadata

iddoc_idtitlecategorysource_pathsummarycontent_hashindexed_at
37DOC19DOC19 — Project Ledger and Intelligence Layerdoc_suiteDevResources/docs/DOC19-Project-Ledger-Intelligence-Layer.mdThe 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).133f9c27ad0138110cfd1ae260cd5f38ec791c752026-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