docs: sync consolidation and session starter
This commit is contained in:
83
docs/SESSION_STARTER.md
Normal file
83
docs/SESSION_STARTER.md
Normal file
@@ -0,0 +1,83 @@
|
||||
# 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
|
||||
```
|
||||
|
||||
## 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).
|
||||
Reference in New Issue
Block a user