microdao-daarion/docs/SESSION_STARTER.md

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 scripts/session/preflight.sh --expected-root /Users/apple/github-projects/microdao-daarion

1. Run integrations bootstrap report:

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 scripts/docs/docs_sync.sh --dry-run

3. Apply docs sync (only after review):

bash scripts/docs/docs_sync.sh --apply --targets github,gitea

4. Service adapters (Jupyter + Pieces):

bash scripts/docs/services_sync.sh --dry-run
# apply mode:
bash scripts/docs/services_sync.sh --apply

5. Docs lint and standards:

bash scripts/docs/docs_lint.sh

6. Docs backup (explicit run):

bash scripts/docs/docs_backup.sh --dry-run
bash scripts/docs/docs_backup.sh --apply

7. Local scheduler (daily, no auto-push):

bash scripts/docs/install_local_cron.sh --schedule "17 9 * * *"

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

1. NODE1 branch/SHA:

ssh root@<NODE1> "cd /opt/microdao-daarion && git rev-parse --abbrev-ref HEAD && git rev-parse HEAD"

2. Core health:

curl -sS http://127.0.0.1:9102/health
curl -sS http://127.0.0.1:9300/health

3. Canary suite:

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).