112 lines
3.0 KiB
Markdown
112 lines
3.0 KiB
Markdown
# 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)
|
|
|
|
0. Preflight (must pass before any task):
|
|
```bash
|
|
bash scripts/session/preflight.sh --expected-root /Users/apple/github-projects/microdao-daarion
|
|
```
|
|
|
|
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).
|