sam/central_ai_llm_master
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Settle identity (single user), routing (rules + LLM + clarify), observability (capped log)

Browse Source
This commit is contained in:
Sam Rolfe
2026-10-10 15:58:01 +11:00
parent fb0210743f
commit 1f27c34e80
4 changed files with 90 additions and 15 deletions
Download Patch File Download Diff File Expand all files Collapse all files

16
docs/ask-contract.md
View File

@@ -23,13 +23,25 @@ own interface, or through an approval flow. Never through `/ask`.
## Endpoint
Every data project exposes two endpoints on its own port:
Every data project exposes three endpoints on its own port:
```
GET /health -> {"ok": true}
GET /capabilities -> the topics this project can answer
POST /ask -> answer a question about this project's data
```
## Capabilities (for routing)
The Hub reads this list to choose a project.
```json
{ "project": "email_agent", "topics": ["email", "inbox", "mail"], "people": ["sam"] }
```
Keep the topic list short and plain. The Hub uses these topics plus `routing.md`.
Do not put private data in this list.
### Request
```json
@@ -74,7 +86,7 @@ Never guess. Never invent. Say `reason` instead.
## Rules for the project
1. **Read only.** `/ask` never writes anything.
1. **Read only.** `/ask` never writes anything. `/capabilities` never writes.
2. **Answer for one person at most.** Check `asker` may see `person`.
3. **One short sentence.** No lists unless asked.
4. **Fast.** Answer in under 3 seconds, or return `answer: null`.