bitflicker64 commented on code in PR #543:
URL: https://github.com/apache/hugegraph-doc/pull/543#discussion_r4418790288


##########
content/en/docs/quickstart/hugegraph-ai/ontogeny.md:
##########
@@ -0,0 +1,108 @@
+---
+title: "Ontogeny"
+linkTitle: "Ontogeny"
+weight: 7
+---
+
+**Ontogeny** is an evolving operational ontology platform for AI applications, 
located in the 
[HugeGraph-AI](https://github.com/apache/hugegraph-ai/tree/ontogeny) module.
+It models business semantics (entities, properties, relations) and operations 
(actions, functions, policies) as declarative, Git-native YAML specifications.
+These are exposed to applications and AI agents through a governed API, with 
optional projection to [Apache HugeGraph](https://github.com/apache/hugegraph) 
for deep graph queries.
+
+### Architecture Overview
+
+The following diagram illustrates core modules and operational flows:
+
+![Overall architecture 
board](/images/docs/hugegraph-ai/ontogeny-arch-board.png)
+
+The system consists of three architectural layers:
+- **Top Layer**: Core DSL definitions, where Action serves as the sole write 
gateway and EvalSuite provides quality evaluation.
+- **Middle Layer**: The online pipeline (modeling → exploration → execution → 
control → audit) and offline self-evolution (RSI) loop, with Agent operations 
unified under policy access control.
+- **Bottom Layer**: Platform runtime and cross-cutting invariants (clear 
ownership, single control gate, Git as single source of truth).
+
+## Key Features
+
+- **Declarative Git-Native Modeling**: Ontology definitions are managed in 
YAML and reviewed via Pull Requests, eliminating opaque UI configuration.
+- **Lightweight Single-Process Kernel**: `ontogeny serve` integrates registry, 
query engine, and Action runtime on SQLite or PostgreSQL.
+- **Agent Governance**: Exposes a governed MCP tool surface at `/mcp`. Agents 
and human users share unified policies, and writes support human approval gates.
+- **Deterministic Self-Evolution (RSI)**: Closed-loop cycle of observation → 
mutation (LLM-assisted DSL diffs) → selection (rule-based deterministic 
evaluations) → release.
+- **Immutable Audit Stream**: Every tool invocation and policy block is 
recorded for full traceability and replay.
+- **Bilingual Web Console**: Built with React 19, offering an interactive 
ontology canvas, graph explorer, action executor, audit viewer, and evolution 
panel.
+
+The ontology canvas provides a comprehensive view of domain objects, 
relations, actions, and functions, highlighting dependencies on hover:
+
+![Ontology definition 
canvas](/images/docs/hugegraph-ai/ontogeny-ontology-canvas.png)
+
+## Quick Start
+
+```bash {tab="Docker (Recommended)"}
+git clone -b ontogeny https://github.com/apache/hugegraph-ai.git
+cd hugegraph-ai/ontogeny
+
+# Start self-contained demo environment (SQLite + seeded data)
+docker compose up -d
+
+# Optional profiles:
+# docker compose --profile postgres up -d

Review Comment:
   Important: neither profile moves Ontogeny off SQLite: compose defaults 
`ONTOGENY_DB_DSN` to SQLite and the image installs only `.[mcp]` without 
`asyncpg`, and no `HUGEGRAPH_URL` reaches the container, so `storage_provider` 
stays `sqlite`. Say that each profile only starts the extra container and name 
the step that connects it, in EN and in CN, where line 44 reads as running on 
Postgres or HugeGraph.



-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: [email protected]

For queries about this service, please contact Infrastructure at:
[email protected]


---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]

Reply via email to