# State Hub / operator delivery

**Status:** contract defined; optional distribution not fully wired  
**Related:** `docs/daily-brief-playbook.md`, `workplans/FI-WP-0002-activity-core-daily-research.md`

## Repo registration

| Field | Value |
| ----- | ----- |
| Hub domain | **agents** |
| Repo slug | `freedom-intelligence` |
| Classification | `.repo-classification.yaml` (primary `agents`, secondary `infotech`) |
| Sync | `statehub fix-consistency --repo freedom-intelligence` after workplan edits |

Workplans live in git; the hub indexes them after registration + fix-consistency.
Do not create workplans via hub `create_workplan` APIs.

---

## Required: completion evidence for daily rhythm

Every completed brief day (including “no material delta”) should post:

```yaml
event_type: fi_daily_brief
author: <agent-or-operator>
summary: "FI daily brief YYYY-MM-DD"
detail:
  repo: freedom-intelligence
  date: "YYYY-MM-DD"
  path: "briefs/YYYY/MM/YYYY-MM-DD.md"
  collection_candidates: 0
```

This is the **idempotence signal** for activity-core context query
`fi_brief_status` (FI-WP-0002-T03): `due=false` when an event exists for today
(Europe/Berlin) with `detail.repo=freedom-intelligence`.

Inbound automation uses `activity_task_spawn` from activity-core (state-hub sink).
See `activity-core/docs/task-emission-consumer-contract.md`.

---

## Optional: operator visibility

| Channel | Use |
| ------- | --- |
| **Progress event** (above) | Minimum — always for automation health |
| **Inbox message** | Only when high-priority collection candidates appear |
| **Wiki / Nextcloud** | Optional human mirror later |

---

## Non-goals

* Freedom Intelligence is **not** required to be a full State Hub domain yet
* Do not use `ISSUE_SINK_TYPE=rest` / Forgejo issues for this rhythm
* Do not register workplans by hand in the hub (`fix-consistency` after commit)

---

## Fallback without MCP

HTTP against State Hub API (workstation `http://127.0.0.1:8000` or remote
tunnel ports). Check health before declaring hub down.

---

## Pin log

| Date | Change |
| ---- | ------ |
| 2026-07-23 | Stub created |
| 2026-07-24 | `fi_daily_brief` contract + activity-core linkage documented |