docs: sync consolidation and session starter

PROJECT-MASTER-INDEX.md

@@ -5,6 +5,14 @@
 
 ---
 
+## Session Start (Canonical)
+
+- Старт кожної нової сесії: `docs/SESSION_STARTER.md`
+- Консолідація та маркування старих/нових/фактичних доків: `docs/consolidation/README.md`
+- Керований список ключових документів і статусів: `docs/consolidation/docs_registry_curated.csv`
+
+---
+
 ## 🗂️ Де що лежить
 
 ### Основні репозиторії

docs/SESSION_STARTER.md

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

docs/consolidation/README.md

@@ -0,0 +1,36 @@
+# Docs Consolidation Hub
+
+Single entry point for documentation reconciliation across:
+- canonical repo docs
+- legacy repo copies
+- worktree docs
+- NODE1 runtime docs snapshot
+- local notebooks
+
+## Files
+
+- `docs_inventory.csv` — machine-readable inventory with classification.
+- `docs_inventory_summary.txt` — class-level counts.
+- `docs_registry_curated.csv` — manually curated truth table for key docs (startup + runtime + legacy refs).
+- `_node1_runtime_docs/` — runtime docs snapshot pulled from NODE1.
+
+## Classification
+
+- `runtime-fact` — observed in NODE1 runtime snapshot.
+- `new-canonical` — canonical docs in active repo (`docs/runbooks`, master index, safe deploy).
+- `legacy-worktree` — docs from `.worktrees/*`.
+- `legacy-desktop` — docs from `/Users/apple/Desktop/MicroDAO/MicroDAO 3`.
+- `needs-triage` — requires manual decision.
+
+## Rebuild inventory
+
+```bash
+python3 /Users/apple/github-projects/microdao-daarion/scripts/docs/build_docs_hub_inventory.py
+```
+
+## Service Automation
+
+```bash
+bash /Users/apple/github-projects/microdao-daarion/scripts/docs/session_bootstrap.sh
+bash /Users/apple/github-projects/microdao-daarion/scripts/docs/docs_sync.sh --dry-run
+```

docs/consolidation/SOURCES.md

@@ -0,0 +1,26 @@
+# Documentation Sources Map
+
+This file tracks where documentation is collected from for consolidation.
+
+## Primary
+- Canonical repo: `/Users/apple/github-projects/microdao-daarion`
+- Legacy repo: `/Users/apple/Desktop/MicroDAO/MicroDAO 3`
+- Worktrees:
+  - `/Users/apple/github-projects/microdao-daarion/.worktrees/origin-main`
+  - `/Users/apple/github-projects/microdao-daarion/.worktrees/docs-node1-sync`
+- NODE1 runtime snapshot mirror:
+  - `/Users/apple/github-projects/microdao-daarion/docs/consolidation/_node1_runtime_docs`
+- Local notebooks:
+  - `/Users/apple/notebooks`
+
+## Connectivity/Integrations (verified 2026-02-16)
+- GitHub CLI: authenticated (`gh auth status` -> account `IvanTytar`, scopes include `repo`)
+- Gitea web UI: reachable at `http://127.0.0.1:3000` (HTTP 200)
+- Jupyter CLI: not found in current PATH (`jupyter: command not found`), notebooks directory exists at `/Users/apple/notebooks`
+- Pieces: Cursor extension found (`meshintelligenttechnologiesinc.pieces-vscode-3.0.1-universal`)
+- NODE1 SSH: intermittent (periodic `connection refused`), use retry/backoff for snapshot refresh.
+- NODE3/NODE4: currently unreachable from this workstation and from NODE1.
+
+## Automation Scripts
+- `scripts/docs/session_bootstrap.sh` — refreshes integration status and writes `INTEGRATIONS_STATUS_LATEST.md`.
+- `scripts/docs/docs_sync.sh` — safe docs sync automation with `--dry-run` by default and explicit `--apply`.

docs/consolidation/docs_registry_curated.csv

@@ -0,0 +1,16 @@
+path,title,status,source,notes,last_verified
+/Users/apple/github-projects/microdao-daarion/docs/SESSION_STARTER.md,Session Starter,new-canonical,canonical-repo,Primary startup context for new sessions,2026-02-16
+/Users/apple/github-projects/microdao-daarion/PROJECT-MASTER-INDEX.md,Master Index,new-canonical,canonical-repo,Single entry point for docs navigation,2026-02-16
+/Users/apple/github-projects/microdao-daarion/config/README.md,Agent Registry README,new-canonical,canonical-repo,Canonical process for adding/modifying agents,2026-02-16
+/Users/apple/github-projects/microdao-daarion/docs/NODA1-AGENT-ARCHITECTURE.md,NODA1 Agent Architecture,new-canonical,canonical-repo,Architecture and wiring for NODE1 agents,2026-02-16
+/Users/apple/github-projects/microdao-daarion/NODA1-SAFE-DEPLOY.md,NODA1 Safe Deploy,new-canonical,canonical-repo,Safe deploy workflow and rollback gates,2026-02-16
+/Users/apple/github-projects/microdao-daarion/docs/runbooks/AGENT_REGISTRY_NODE1_DECISION_2026-02-16.md,Agent Registry Decision,runtime-fact,canonical-repo,Decision log aligned to live NODE1 runtime,2026-02-16
+/Users/apple/github-projects/microdao-daarion/docs/runbooks/NODE_ARCH_RECONCILIATION_PLAN_2026-02-16.md,Node Arch Reconciliation Plan,runtime-fact,canonical-repo,Runtime-first reconciliation plan across nodes,2026-02-16
+/Users/apple/github-projects/microdao-daarion/docs/consolidation/_node1_runtime_docs/PROJECT-MASTER-INDEX.md,Runtime Snapshot Master Index,runtime-fact,node1-snapshot,Snapshot from /opt/microdao-daarion,2026-02-16
+/Users/apple/github-projects/microdao-daarion/docs/consolidation/_node1_runtime_docs/config/README.md,Runtime Snapshot Config README,runtime-fact,node1-snapshot,Snapshot from /opt/microdao-daarion,2026-02-16
+/Users/apple/github-projects/microdao-daarion/docs/consolidation/_node1_runtime_docs/docs/NODA1-AGENT-ARCHITECTURE.md,Runtime Snapshot NODA1 Architecture,runtime-fact,node1-snapshot,Snapshot from /opt/microdao-daarion,2026-02-16
+/Users/apple/github-projects/microdao-daarion/.worktrees/origin-main/IMPLEMENTATION-STATUS.md,Implementation Status,legacy-worktree,worktree-origin-main,Legacy strategic doc kept for reference only,2026-02-16
+/Users/apple/github-projects/microdao-daarion/.worktrees/origin-main/ARCHITECTURE-150-NODES.md,Architecture 150 Nodes,legacy-worktree,worktree-origin-main,Legacy scale architecture reference,2026-02-16
+/Users/apple/github-projects/microdao-daarion/.worktrees/origin-main/infrastructure/auth/AUTH-IMPLEMENTATION-PLAN.md,Auth Implementation Plan,legacy-worktree,worktree-origin-main,Legacy auth rollout plan,2026-02-16
+/Users/apple/github-projects/microdao-daarion/.worktrees/origin-main/infrastructure/matrix-gateway/README.md,Matrix Gateway README,legacy-worktree,worktree-origin-main,Legacy matrix gateway reference,2026-02-16
+/Users/apple/Desktop/MicroDAO/MicroDAO 3/NODA1-CURRENT-STATUS-2026-01-26.md,NODA1 Current Status 2026-01-26,legacy-desktop,desktop-legacy,Old status snapshot from legacy repo,2026-02-16