Gmind Monorepo & Showcase

Cấu trúc hóa dự án Gmind dưới dạng Monorepo Đa ngôn ngữ (Go, Rust, TypeScript), trình diễn tầm nhìn Agentic SE — nơi AI Agent điều phối tự động qua Theo dõi Phổ quát (Beads-ID), Trí tuệ Mã nguồn (FastCode AST), và Cổng Xác minh SAFe 6.0 CI/CD.

gmind.gscfin.com

Trang web tĩnh (SSG) — trình diễn 4 trụ cột “tinh túy” được nghiên cứu qua 15+ Spike trước khi viết dòng code đầu tiên.

FastCode AST + Graph RAG

Giải pháp chống "mất trí nhớ cục bộ" của AI. FastCode tích hợp sẵn Tree-sitter AST → Graph Builder → BM25/Vector → LLM Iterative Retrieval. Agent chỉ cần gọigmind search-codebase

FrankenSQLite + Git JSONL

MVCC ghi đồng thời trong tiến trình. Cột SQL first-class (indexed, type-safe) thay JSON blob. Đồng bộ qua Git: SQLite → JSONL export → git push. Theo dõi Phổ quát quaBeads-ID:Git Trailer

Lớp 4: Cổng CI/CD + RTM

Agent KHÔNG thể tự đóng task — bắt buộc qua Nút Xác minh. Nguyên tắc Bốn Mắt: Code Agent ≠ Reviewer Agent. RTM 3 lớp:PRD ↔ Kế hoạch ↔ Task ↔ Commit

Agent Village & Knowledge Graph

Beads-ID = Nút Đồ thị Phổ quát. gmind xây Knowledge Graph tại thời điểm truy vấn từ 5+ nguồn (FrankenSQLite, Git, Zvec, GitHub, YAML). Khoá tệp Lease Timeout 15 phút quamcp_agent_mail

Kiến trúc 5+1 Lớp

Kiến trúc phân tách triệt để — mỗi lớp có trách nhiệm riêng biệt, giao tiếp qua giao diện rõ ràng.

1
Lớp 1

Lớp Lưu trữ

FrankenSQLite (Trạng thái SSOT, MVCC) + Zvec (Bộ nhớ Ngữ nghĩa cho Tài liệu/Chat)

2
Lớp 2

Lớp Công cụ Cốt lõi

gmind CLI (Cổng Ngữ cảnh) + beads_rust (Trình theo dõi Issue) + FastCode (Trí tuệ Mã nguồn) + mcp_agent_mail (Phối hợp)

3
Lớp 3

Lớp Thực thi / Agent

AI Agent xử lý task: Tìm kiếm → Ngữ cảnh → Khoá → Code → Kiểm tra. Tích hợp gmind trace để lấy toàn bộ ngữ cảnh Knowledge Graph.

4
Lớp 4

Lớp Xác minh

Cổng CI/CD qua GitHub Actions. Test + Linting bắt buộc trước khi hoàn thành. Sub-agent Reviewer kiểm tra và phê duyệt.

5
Lớp 5

Lớp API Gateway

Go REST API + nhúng FrankenSQLite. Giới hạn tốc độ, xác thực. Web UI KHÔNG đọc DB trực tiếp.

6
Lớp 6

Lớp Trình bày (Web UI)

Bảng Kanban, Góc nhìn SAFe, Cổng Phê duyệt Cấp 3, Đồ thị Tài liệu HITL, Bản đồ Nhiệt Độ phủ, Phân tích Tác động.

Tổ chức Không gian Làm việc Thống nhất

Monorepo Đa ngôn ngữ: Go (go.work) + Rust (Cargo.toml workspace) + TypeScript (pnpm-workspace.yaml). Điều phối bởi Turborepo — không cần Bazel.

apps/ — Ứng dụng Web

website/ Showcase Next.js (Vercel) · webui/ Bảng điều khiển PM (RTM, góc nhìn SAFe)

cli/ — Công cụ CLI Cốt lõi

gmind/ Cổng Ngữ cảnh Go · beads_rust/ Trình theo dõi Rust · mcp_mail/ Hệ thống Khoá

packages/ — Thư viện Chia sẻ

design-system/ Token UI · fastcode/ Động cơ AST · core-types/ DTO Chia sẻ

/gmind/
├── apps/
│   ├── website/ // Showcase Vercel
│   └── webui/ // Bảng điều khiển React
├── cli/
│   ├── gmind/ // Go CLI
│   ├── beads_rust/ // Trình theo dõi Rust
│   └── mcp_mail/ // Hệ thống Khoá
├── packages/
│   ├── design-system/ // UI chia sẻ
│   ├── fastcode/ // Động cơ AST
│   └── core-types/ // DTO chia sẻ
├── .agents/
│   ├── skills/ // visual-explainer
│   └── workflows/ // gsafe-research
└── docs/
    ├── PRDs/ // Phân vùng theo hệ thống con
    └── researches/ // 15+ Spike