Sam Rolfe
449fdd02c5
- docs/hub-api.md: language decision (Go 1.25) with reason and the frozen v1 routes POST /ask, POST /approve, GET /health, including request/response schemas, bearer-token auth, timeouts, error shapes, logging, versioning, and a safety confirmation that no route is a high-consequence control. - Update README, hub_brief.md open items, and the outline docs so they no longer say the API is undecided or the language is open. Co-Authored-By: Paperclip <noreply@paperclip.ing>
1.8 KiB
1.8 KiB
Central AI Hub — AI Document Index
Target: AI Agents Writing Style: ASD-STE100 Simplified Technical English (
ste-writing).
Document Catalog (Inject Specific Document)
Read this index to inject the exact file you need. Do not search all files.
| Document Title | Path | Scope / Description |
|---|---|---|
| System Overview | docs/outline/01-system-overview.md |
Explains the Hub purpose, its five steps, and the destinations. |
| Configuration & Env | docs/outline/02-config-and-env.md |
Lists services, ports, env vars, and secret paths. |
| Code Structure Map | docs/outline/03-code-map.md |
Shows the planned folder layout and entry points. |
| AI Agent Runbook | docs/outline/04-agent-runbook.md |
Gives steps to build, test, and restart Hub work. |
| Ask Contract | docs/ask-contract.md |
The interface between the Hub and every data project. |
| Hub Inbound API | docs/hub-api.md |
The frozen v1 API from every way in to the Hub. |
| Design Brief | hub_brief.md |
The agreed design. This file is the source of truth. |
| Project Rules | AGENTS.md |
Mission, rules, build order, and project relations. |
System Summary
The Hub is one service. Every way in reaches every ability through it. The Hub does five steps: hear, understand, check, route, and answer. The Hub does not hold a personality or a memory. The Hub does not do the destination work.
Core Configuration
- Env File:
~/.config/environment.d/10-secrets.conf - Config Directory:
docs/ - Active Ports: Hub 8787 (
HUB_PORT, proposed default — confirm before deploy).
Agent Restart Steps
- Read the Document Catalog above. Inject only required files.
- Read
hub_brief.md. - Check git status:
git status. - Check recent commits:
git log -n 5 --oneline.