# SESSION STARTER (Documentation + Runtime Truth)

Date: 2026-02-16
Purpose: single context file to start any new session without losing architectural state.

## Canonical Repo

- Main working repo: `/Users/apple/github-projects/microdao-daarion`
- Runtime on NODE1: `/opt/microdao-daarion`

Important: keep docs and runtime aligned via explicit drift checks, not assumptions.

## Core Entry Documents

1. `PROJECT-MASTER-INDEX.md` (entry point to docs map)
2. `config/README.md` (how to add/modify agents)
3. `docs/NODA1-AGENT-ARCHITECTURE.md` (node1 architecture and agent wiring)
4. `NODA1-SAFE-DEPLOY.md` (safe deployment flow)
5. `docs/consolidation/README.md` (docs hub)
6. `docs/consolidation/docs_registry_curated.csv` (curated doc truth table)

## Session Bootstrap (Services + Docs)

1. Run integrations bootstrap report:
```bash
bash scripts/docs/session_bootstrap.sh
```
Output:
- `docs/consolidation/INTEGRATIONS_STATUS_LATEST.md`
- `docs/consolidation/INTEGRATIONS_STATUS_<timestamp>.md`

2. Dry-run docs sync to remotes:
```bash
bash scripts/docs/docs_sync.sh --dry-run
```

3. Apply docs sync (only after review):
```bash
bash scripts/docs/docs_sync.sh --apply --targets github,gitea
```

4. Service adapters (Jupyter + Pieces):
```bash
bash scripts/docs/services_sync.sh --dry-run
# apply mode:
bash scripts/docs/services_sync.sh --apply
```

5. Docs lint and standards:
```bash
bash scripts/docs/docs_lint.sh
```

6. Docs backup (explicit run):
```bash
bash scripts/docs/docs_backup.sh --dry-run
bash scripts/docs/docs_backup.sh --apply
```

7. Local scheduler (daily, no auto-push):
```bash
bash scripts/docs/install_local_cron.sh --schedule "17 9 * * *"
```

## Runtime-First Facts (must re-check each session)

1. NODE1 branch/SHA:
```bash
ssh root@<NODE1> "cd /opt/microdao-daarion && git rev-parse --abbrev-ref HEAD && git rev-parse HEAD"
```

2. Core health:
```bash
curl -sS http://127.0.0.1:9102/health
curl -sS http://127.0.0.1:9300/health
```

3. Canary suite:
```bash
cd /opt/microdao-daarion
./ops/canary_all.sh
./ops/canary_senpai_osr_guard.sh
```

4. Router endpoint contract:
- Active: `POST /v1/agents/{agent_id}/infer`
- Not active: `POST /route` (returns 404 on current runtime)

## NODE3/NODE4 Policy

- NODE3 and NODE4 remain part of target architecture.
- If currently unreachable, mark as `DEGRADED` (not removed).
- Re-enable dependent flows only after connectivity + health checks pass.

## Documentation Status Model

- `new-canonical`: active docs in canonical repo.
- `runtime-fact`: docs/snapshots that reflect current live runtime behavior.
- `legacy-worktree`: old but useful strategic docs in `.worktrees/*`.
- `legacy-desktop`: docs from old Desktop repo (`MicroDAO 3`).
- `needs-triage`: unresolved status.

## Governance Rule

No deployment/reconfiguration based only on docs text.
Always confirm against live runtime facts (health, canary, config hashes, active endpoints).
