Add /ask contract; clarify peers, query vs control, identity gap
This commit is contained in:
@@ -18,6 +18,17 @@ way in, the phone app, would repeat the same work. The Hub stops this repeat.
|
||||
4. **Route** — send the request to one destination.
|
||||
5. **Answer** — return a short reply in the right shape.
|
||||
|
||||
When the question is about another project's data, step 4 asks that project
|
||||
through the `/ask` contract. See `docs/ask-contract.md`.
|
||||
|
||||
## Three Directions
|
||||
|
||||
Nothing here is ownership. These are directions of talk.
|
||||
|
||||
1. The Hub asks a project.
|
||||
2. A project tells the Hub.
|
||||
3. n8n triggers the project.
|
||||
|
||||
## Ways In
|
||||
|
||||
- Phone app (Kotlin) — wake word, voice, controls.
|
||||
@@ -26,17 +37,32 @@ way in, the phone app, would repeat the same work. The Hub stops this repeat.
|
||||
- dsh chat — per-person chat.
|
||||
- Console portal — web dashboard.
|
||||
|
||||
## Destinations
|
||||
## Peers and Destinations
|
||||
|
||||
| Destination | Job |
|
||||
Every other project is a peer. Each has its own folder, repo, port, and
|
||||
interface. Each works without the Hub.
|
||||
|
||||
| Peer | Talk direction |
|
||||
|---|---|
|
||||
| Home Assistant | Lights, switches, timers, calendar. |
|
||||
| Speakers (Jervis) | Speak and announce. |
|
||||
| Internet control | Parental limits on kids' devices. |
|
||||
| Artemis | Operate the phone screen. |
|
||||
| Paperclip | Slow, multi-step, recorded work. |
|
||||
| Web search | Tavily search. |
|
||||
| Apprise / NTFY | Notifications and email. |
|
||||
| Email agent | Hub asks it. It tells the Hub. n8n scans it. |
|
||||
| Compass / NHS | Hub asks it. It tells the Hub. n8n scans it. |
|
||||
| Internet control | Hub asks it. Control goes through its own apps. |
|
||||
| Artemis | Hub calls it to act. Nothing comes back. |
|
||||
| Home Assistant | Hub calls it to act. |
|
||||
| Speakers (Jervis) | Hub calls it to speak. |
|
||||
| Paperclip | Hub files jobs. The answer returns. |
|
||||
| Web search | Hub calls it. |
|
||||
| Apprise / NTFY | Hub calls it to notify. |
|
||||
|
||||
## Query, Command, or Control
|
||||
|
||||
| Kind | Path | Confirm |
|
||||
|---|---|---|
|
||||
| Query | Hub asks a project (`/ask`) | No |
|
||||
| Command | Hub calls Home Assistant | No |
|
||||
| Control | Admin app calls internet control | Yes, on the phone |
|
||||
|
||||
A high-consequence control does not route through the Hub.
|
||||
|
||||
## Reply Shapes
|
||||
|
||||
@@ -57,3 +83,4 @@ The Hub asks one question: does this need a decision, or does it need to happen?
|
||||
- Not a central brain. No single personality or memory.
|
||||
- Not Paperclip. The Hub does not wait minutes for an answer.
|
||||
- Not a destination. The Hub does not turn off the internet itself.
|
||||
- Not an owner. The other projects are peers, not sub-projects.
|
||||
|
||||
Reference in New Issue
Block a user