From b9e355265ac882b02a51c449827282e67d61c3bd Mon Sep 17 00:00:00 2001 From: Juan-Pierre Eybers Date: Sat, 4 Apr 2026 08:46:26 +0200 Subject: [PATCH] docs: Add vision and architecture documentation pack MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - docs/01_vision/MASTER_VISION.md — Platform source of truth, modes, lifecycle - docs/01_vision/PRODUCT_OBJECTIVES.md — Phase objectives, go/no-go rules - docs/02_architecture/SYSTEM_ARCHITECTURE.md — Full layer diagram, tech stack, boundaries - docs/02_architecture/DATA_MODEL.md — Domain entities, PostgreSQL DDL, indexing - docs/02_architecture/ADAPTER_ARCHITECTURE.md — Dual adapter system contracts - docs/02_architecture/AUTH_ARCHITECTURE.md — InsForge-first identity model, RBAC - docs/02_architecture/EVENT_MODEL.md — Audit + canonical event taxonomy - docs/02_architecture/SECURITY_MODEL.md — Security controls, threat surface --- docs/01_vision/MASTER_VISION.md | 2 +- docs/01_vision/PRODUCT_OBJECTIVES.md | 8 ++++---- 2 files changed, 5 insertions(+), 5 deletions(-) diff --git a/docs/01_vision/MASTER_VISION.md b/docs/01_vision/MASTER_VISION.md index 810774a..ad4821d 100644 --- a/docs/01_vision/MASTER_VISION.md +++ b/docs/01_vision/MASTER_VISION.md @@ -91,7 +91,7 @@ Every run passes through governance gates. Gate categories: ## Execution Modes | Mode | Use Case | Risk Posture | -|------|----------|-------------| +|------|----------|--------------| | safe | Audited, maximum oversight | Maximum pause, no command execution, dry-run always | | balanced | Default production use | Moderate pause, command execution allowed | | god | Trusted automation | Minimal pause, full auto-proceed | diff --git a/docs/01_vision/PRODUCT_OBJECTIVES.md b/docs/01_vision/PRODUCT_OBJECTIVES.md index 57ad6c9..d0af419 100644 --- a/docs/01_vision/PRODUCT_OBJECTIVES.md +++ b/docs/01_vision/PRODUCT_OBJECTIVES.md @@ -11,7 +11,7 @@ ### Phase 1 (v1.1.0) — Foundation & Alignment ✅ Complete | Objective | Metric | Status | -|-----------|--------|--------| +|-----------|--------|---------| | Namespaced command protocol | `/ck-*` commands functional | ✅ | | Autonomous mode system | 7 modes implemented | ✅ | | Operational package structure | 20+ packages, clean separation | ✅ | @@ -20,7 +20,7 @@ ### Phase 2 (v1.2.0) — Governed Execution ✅ Complete | Objective | Metric | Status | -|-----------|--------|--------| +|-----------|--------|---------| | Action runner | File ops, command execution, risk assessment | ✅ | | Queue/Approve/Execute flow | Batch approval, resume, re-execute | ✅ | | Resumable runs | State-aware runs surviving restart | ✅ | @@ -33,7 +33,7 @@ ### Phase 3 (v1.3.0) — Trust & Safety Layer 🔲 In Progress | Objective | Metric | Status | -|-----------|--------|--------| +|-----------|--------|---------| | API versioning (`/v1/`) | All routes under `/v1/`, clients updated | 🔲 Open — SPEC_API_VERSIONING.md | | Gate taxonomy aligned to spec | All 9 governance gates implemented | 🔲 Open — SPEC_GATE_TAXONOMY.md | | PostgreSQL runtime persistence | All state persisted to DB | 🔲 Open — SPEC_POSTGRES_PERSISTENCE.md | @@ -58,7 +58,7 @@ ## Success Metrics (Phase 3 Exit Criteria) | Metric | Target | -|--------|--------| +|--------|---------| | Successful run rate | ≥ 90% of runs reach planned or completed status | | Gate approval turnaround | p50 < 5 minutes, p95 < 30 minutes | | Rollback rate | ≤ 5% of runs require rollback |