docs: sync consolidation and session starter
This commit is contained in:
36
docs/consolidation/README.md
Normal file
36
docs/consolidation/README.md
Normal 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
|
||||
```
|
||||
26
docs/consolidation/SOURCES.md
Normal file
26
docs/consolidation/SOURCES.md
Normal 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`.
|
||||
16
docs/consolidation/docs_registry_curated.csv
Normal file
16
docs/consolidation/docs_registry_curated.csv
Normal 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
|
||||
|
Reference in New Issue
Block a user