[{"data":1,"prerenderedAt":4},["ShallowReactive",2],{"readme:context-ontology-accelerator":3},"\u003Ch1>✦ Context Ontology Accelerator\u003C\u002Fh1>\n\u003Cp>An open-source semantic context layer for AWS that combines knowledge graphs, formal ontologies, and rule-based systems with modern AI — enabling agents to retrieve context, validate it against business logic, and determine correct actions.\u003C\u002Fp>\n\u003Ch2>Architecture\u003C\u002Fh2>\n\u003Cp>The system follows a \u003Cstrong>Scan → Model → Serve\u003C\u002Fstrong> workflow:\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Scan\u003C\u002Fstrong> — Connect data sources, discover schemas, enrich metadata, ingest unstructured documents\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Model\u003C\u002Fstrong> — Induce and manage ontologies, define metrics, build a unified semantic graph\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Serve\u003C\u002Fstrong> — Query via SPARQL federation (VKG), traverse the knowledge graph, serve context to AI agents via MCP\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cp>Access is governed by namespace isolation and role-based access control: namespace-scoped roles (owner, maintainer, data-steward, data-analyst) plus \u003Cstrong>platform-level roles\u003C\u002Fstrong> (\u003Ccode>platform-admin\u003C\u002Fcode>, \u003Ccode>platform-viewer\u003C\u002Fcode>) that apply across all namespaces. See the \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Faws\u002Fcontext-ontology-accelerator\u002Fblob\u002FHEAD\u002Fpackages\u002Fcontrol-plane\u002FREADME.md\" rel=\"nofollow ugc noopener\">control-plane docs\u003C\u002Fa> for the grants and authorization model.\u003C\u002Fp>\n\u003Ch2>Quick Start\u003C\u002Fh2>\n\u003Ch3>Prerequisites\u003C\u002Fh3>\n\u003Cul>\n\u003Cli>Python 3.12, Node.js 22+, Docker\u003C\u002Fli>\n\u003Cli>\u003Ca href=\"https:\u002F\u002Fpnpm.io\u002F\" rel=\"nofollow ugc noopener\">pnpm\u003C\u002Fa> (Node package manager — installed via \u003Ccode>mise\u003C\u002Fcode> or \u003Ccode>npm install -g pnpm\u003C\u002Fcode>)\u003C\u002Fli>\n\u003Cli>Java 17+ and Gradle (for Smithy codegen)\u003C\u002Fli>\n\u003Cli>\u003Ca href=\"https:\u002F\u002Fdocs.astral.sh\u002Fuv\u002F\" rel=\"nofollow ugc noopener\">uv\u003C\u002Fa> (Python package manager)\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch3>Setup\u003C\u002Fh3>\n\u003Cblockquote>\n\u003Cp>\u003Cstrong>Use a release, not the tip of \u003Ccode>main\u003C\u002Fcode>.\u003C\u002Fstrong> We recommend starting from a tagged\nrelease — \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Faws\u002Fcontext-ontology-accelerator\u002Freleases\" rel=\"nofollow ugc noopener\">github.com\u002Faws\u002Fcontext-ontology-accelerator\u002Freleases\u003C\u002Fa>.\n\u003Ccode>main\u003C\u002Fcode> tracks ongoing development.\u003C\u002Fp>\n\u003C\u002Fblockquote>\n\u003Cpre>\u003Ccode class=\"language-bash\"># Clone at the latest release tag (replace <tag> with a release from the link above)\ngit clone --branch <tag> https:\u002F\u002Fgithub.com\u002Faws\u002Fcontext-ontology-accelerator.git\ncd context-ontology-accelerator\n\nmake setup      # install Python + CDK TypeScript dependencies\nmake format     # auto-format code\nmake lint       # check linting\nmake test       # run unit tests\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>\u003Cstrong>Full developer guide:\u003C\u002Fstrong> \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Faws\u002Fcontext-ontology-accelerator\u002Fblob\u002FHEAD\u002Fexternal-docs\u002Fcontent\u002Fgetting-started.md\" rel=\"nofollow ugc noopener\">external-docs\u002Fcontent\u002Fgetting-started.md\u003C\u002Fa>\u003C\u002Fp>\n\u003Ch2>Repository Structure\u003C\u002Fh2>\n\u003Cpre>\u003Ccode>semantic-context\u002F\n├── models\u002F              # Smithy API models (source of truth for API contracts)\n├── smithy-generated\u002F    # Auto-generated from Smithy (OpenAPI, Python interfaces, TS client)\n├── infra\u002F               # AWS CDK (TypeScript) — foundation + per-service stacks\n├── packages\u002F\n│   ├── control-plane\u002F           # Control Plane APIs\n│   ├── data-layer\u002F              # Data Layer APIs (query, retrieval, traversal)\n│   ├── sources\u002F                 # Unified data source ingestion (database + documents)\n│   ├── ontology-engine\u002F         # Ontology induction, reasoning (HermiT\u002FELK)\n│   ├── metric-service\u002F          # Metric authoring and resolution\n│   ├── vkg\u002F                     # Virtual Knowledge Graph (Ontop)\n│   ├── mcp-server\u002F              # MCP tools for AI agents\n│   ├── context-manager\u002F         # Serve layer Context Manager (query orchestration, upstream clients)\n│   └── web-app\u002F                 # React + Cloudscape frontend\n├── libs\u002Fcommon\u002F         # Shared Python config, logging, exceptions\n├── libs\u002Fts-shared\u002F      # Shared TypeScript interfaces and constants\n├── scripts\u002F             # CI-agnostic build\u002Ftest\u002Fdeploy scripts\n└── external-docs\u002F       # Published documentation (getting-started, deployment guides)\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2>Tech Stack\u003C\u002Fh2>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Layer\u003C\u002Fth>\n\u003Cth>Technology\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>Languages\u003C\u002Ftd>\n\u003Ctd>Python 3.12, TypeScript\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>API Contracts\u003C\u002Ftd>\n\u003Ctd>Smithy → OpenAPI + Python interfaces + TypeScript client\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>IaC\u003C\u002Ftd>\n\u003Ctd>AWS CDK (TypeScript)\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>Frontend\u003C\u002Ftd>\n\u003Ctd>React + Cloudscape Design System\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>Package Management\u003C\u002Ftd>\n\u003Ctd>uv (Python), pnpm (TypeScript)\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>Monorepo Orchestration\u003C\u002Ftd>\n\u003Ctd>Nx\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n",1787445486863]