User prompt (VS Code Copilot)
        │
        ▼
  ontology-mcp  ──► Fuseki KG (local)  ──► SPARQL query
        │
        ▼
  JSON-LD descriptor
  (WHERE to query, WHAT to validate, HOW to route)
        │
        ▼
  Agent executes queries
  ├── SQL Server  (UM_Users, Um_Userpartnermapping, um_usermobileverificationstatus)
  ├── MongoDB     (users collection)
  └── New Relic   (only if all SHACL shapes pass)

java -version
# Expected: openjdk version "11.x.x" or higher

python --version
# Expected: Python 3.12.x or higher

cd c:\Ontology
python -m pip install -r requirements.txt

cd c:\Ontology
java -jar infra\fuseki\fuseki-server.jar --config infra\fuseki\config\login-kg.ttl

# Open a second terminal and run:
python -c "import requests; r = requests.get('http://localhost:3030/$/ping'); print('Fuseki UP:', r.status_code)"
# Expected: Fuseki UP: 200

cd c:\Ontology
$env:PYTHONIOENCODING = "utf-8"

# Load all 7 named graphs into Fuseki
python scripts/kg/load_kg.py --schema login --version 1.0.0

# Promote v1.0.0 as the active version
python scripts/kg/promote.py --schema login --version 1.0.0

✅ Promoted successfully. login current = v1.0.0

python -c "
import requests, json
r = requests.post('http://localhost:3030/login-kg/sparql',
    data={'query': 'SELECT (COUNT(*) AS ?n) WHERE { GRAPH <urn:kg:login:v1.0.0:ontology> { ?s ?p ?o } }'},
    headers={'Accept': 'application/sparql-results+json'})
print('Triples in ontology graph:', r.json()['results']['bindings'][0]['n']['value'])
"
# Expected: Triples in ontology graph: 949

{
  "servers": {
    "ontology-mcp": {
      "type": "stdio",
      "command": "python",
      "args": ["-m", "mcp_server.server"],
      "cwd": "c:\\Ontology",
      "env": {
        "PYTHONPATH": "c:\\Ontology\\src",
        "PYTHONIOENCODING": "utf-8"
      }
    }
  }
}

Why can't a user login? Use the ontology-mcp to get the diagnostic descriptor.

The user leosmab.admin cannot login.
First call resolve_intent with prompt "user cannot login" to get the descriptor,
then show me which tables to query and what to check.

"can't login"
"login failure"
"login issue"
"login not working"
"login problem"
"unable to login"
"user cannot login"
"user login failed"
"why can't {username} login"

c:\Ontology\
├── src/
│   └── mcp_server/                      # MCP server package (PYTHONPATH=src)
│       ├── server.py                    # MCP stdio entrypoint
│       ├── kg/sparql_client.py          # Fuseki SPARQL client
│       ├── registry/schema_registry.py  # reads registry.yaml
│       └── tools/
│           ├── resolve_intent.py
│           ├── get_descriptor.py
│           └── list_intents.py
│
├── ontology/
│   ├── schemas/
│   │   ├── registry.yaml                # schema manifest
│   │   └── login/v1.0.0/login.yaml      # LinkML source of truth
│   └── sparql/
│       ├── resolve_intent.sparql
│       ├── get_entity_descriptor.sparql
│       ├── list_intents.sparql
│       └── get_decision_rules.sparql
│
├── artifacts/login/v1.0.0/
│   ├── owl/login.owl.ttl                # OWL 2 DL (949 triples)
│   ├── shacl/login.shacl.ttl           # SHACL shapes (332 triples)
│   ├── skos/login.skos.ttl             # SKOS concept scheme (129 triples)
│   ├── rules/login.rules.ttl           # Decision rules (58 triples)
│   ├── descriptors/login.descriptors.json
│   └── jsonld/login.context.jsonld
│
├── scripts/
│   ├── generate/                        # artifact generation pipeline
│   └── kg/
│       ├── load_kg.py                   # load named graphs into Fuseki
│       └── promote.py                   # promote a version as current
│
├── infra/
│   └── fuseki/
│       ├── fuseki-server.jar            # Apache Jena Fuseki 6.1.0
│       ├── config/login-kg.ttl          # dataset config (TDB2)
│       └── data/                        # TDB2 persistent storage (gitignored)
│
├── config/settings.yaml                 # non-secret runtime config
├── .env.example                         # secrets template — copy to .env
├── .env                                 # local secrets — never committed
├── requirements.txt
└── README.md                            # this file

Every session:
  1. Start Fuseki          →  java -jar infra\fuseki\fuseki-server.jar --config infra\fuseki\config\login-kg.ttl
  2. Load KG (if needed)   →  python scripts/kg/load_kg.py --schema login --version 1.0.0
  3. Promote (if needed)   →  python scripts/kg/promote.py --schema login --version 1.0.0
  4. Open VS Code          →  Copilot Agent mode picks up ontology-mcp automatically

One-time setup:
  - pip install -r requirements.txt
  - Configure C:\Users\<you>\AppData\Roaming\Code\User\mcp.json  (PYTHONPATH: c:\\Ontology\\src)
  - Reload VS Code window