docs: sync consolidation and session starter

This commit is contained in:
Apple
2026-02-16 02:15:20 -08:00
parent f82404dc36
commit 8ba71f240f
5 changed files with 169 additions and 0 deletions

View File

@@ -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
```

View File

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

View File

@@ -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
1 path title status source notes last_verified
2 /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
3 /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
4 /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
5 /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
6 /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
7 /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
8 /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
9 /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
10 /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
11 /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
12 /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
13 /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
14 /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
15 /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
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