docs: sync consolidation and session starter

This commit is contained in:
Apple
2026-02-16 02:21:49 -08:00
parent fc2d86bd1b
commit 3146e74ce8
13 changed files with 813 additions and 58 deletions

View File

@@ -39,6 +39,13 @@ bash scripts/docs/docs_sync.sh --dry-run
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
```
## Runtime-First Facts (must re-check each session)
1. NODE1 branch/SHA:

View File

@@ -1,63 +1,31 @@
# Integrations Bootstrap Status
Generated: 2026-02-16 10:15:20 UTC
Generated: 2026-02-16 10:20:19 UTC
Repo:
Repo: /Users/apple/github-projects/microdao-daarion
## Gitea
- **gitea_http**: OK http_code=200 (http://127.0.0.1:3000)
- **gitea_git_remote**: OK gitea http://localhost:3000/daarion-admin/microdao-daarion.git;
- **gitea_http**: OK - http_code=200 (http://127.0.0.1:3000)
- **gitea_git_remote**: OK - gitea http://localhost:3000/daarion-admin/microdao-daarion.git;
## GitHub
- **gh_auth**: OK IvanTytar (keyring)
- **github_git_remote**: OK origin git@github.com:IvanTytar/microdao-daarion.git;
- **gh_auth**: OK - IvanTytar (keyring)
- **github_git_remote**: OK - origin git@github.com:IvanTytar/microdao-daarion.git;
## Jupyter
- **jupyter_cli**: DEGRADED jupyter not found in PATH
- **notebooks_dir**: OK /Users/apple/notebooks (ipynb_count=7)
- **jupyter_cli**: DEGRADED - jupyter not found in PATH
- **notebooks_dir**: OK - /Users/apple/notebooks (ipynb_count=7)
## Pieces
- **pieces_extension**: OK cursor extensions matched=1
- **pieces_data_dir**: INFO /Users/apple/Library/Application Support/Pieces not found
- **pieces_extension**: OK - cursor extensions matched=1
- **pieces_data_dir**: INFO - /Users/apple/Library/Application Support/Pieces not found
## Next
- Run docs sync dry-run: Detected remotes:
github: origin
gitea : gitea
Targets: github,gitea
Commit message: docs: sync consolidation and session starter
[dry-run] git add docs/SESSION_STARTER.md docs/consolidation/README.md docs/consolidation/SOURCES.md docs/consolidation/docs_registry_curated.csv PROJECT-MASTER-INDEX.md
[dry-run] git diff --cached --name-status
[dry-run] git push origin feat/md-pipeline-senpai-consumer
[dry-run] git push gitea feat/md-pipeline-senpai-consumer
Done.
- Apply sync to remotes: Detected remotes:
github: origin
gitea : gitea
Targets: github,gitea
Commit message: docs: sync consolidation and session starter
[feat/md-pipeline-senpai-consumer de3bd8c] docs: sync consolidation and session starter
Committer: Apple <apple@MacBook-Pro.local>
Your name and email address were configured automatically based
on your username and hostname. Please check that they are accurate.
You can suppress this message by setting them explicitly:
git config --global user.name "Your Name"
git config --global user.email you@example.com
After doing this, you may fix the identity used for this commit with:
git commit --amend --reset-author
5 files changed, 225 insertions(+), 3 deletions(-)
create mode 100644 docs/SESSION_STARTER.md
create mode 100644 docs/consolidation/README.md
create mode 100644 docs/consolidation/SOURCES.md
create mode 100644 docs/consolidation/docs_registry_curated.csv
Done.
- Run docs sync dry-run: bash scripts/docs/docs_sync.sh --dry-run
- Apply sync to remotes: bash scripts/docs/docs_sync.sh --apply --targets github,gitea

View File

@@ -24,3 +24,6 @@ This file tracks where documentation is collected from for consolidation.
## 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`.
- `scripts/docs/jupyter_sync.sh` — adapter for Jupyter server API status + notebooks index export.
- `scripts/docs/pieces_sync.sh` — adapter for Pieces local runtime/data index + optional API probe.
- `scripts/docs/services_sync.sh` — orchestrator for bootstrap + Jupyter + Pieces sync adapters.

View File

@@ -0,0 +1,13 @@
# Jupyter Sync Report
Generated: 2026-02-16 10:20:20 UTC
- jupyter_cmd: not-found
- server_count: 0
- api_ok: 0/0
- notebooks_dir: /Users/apple/notebooks
- notebooks_count: 7
## API Probes
- no active jupyter servers discovered

View File

@@ -0,0 +1,8 @@
path,size_bytes,mtime_epoch
"/Users/apple/notebooks/04_latency_profile.ipynb",31210,1760335066
"/Users/apple/notebooks/03_window_packing.ipynb",8762,1760334699
"/Users/apple/notebooks/02_reranker_ablation.ipynb",26615,1760334615
"/Users/apple/notebooks/05_groundedness_eval.ipynb",39210,1760335328
"/Users/apple/notebooks/hybrid-search-demo.ipynb",27580,1760307946
"/Users/apple/notebooks/01_retrieval_sanity.ipynb",16137,1760308259
"/Users/apple/notebooks/ai-stack-demo.ipynb",14607,1760307623
1 path size_bytes mtime_epoch
2 /Users/apple/notebooks/04_latency_profile.ipynb 31210 1760335066
3 /Users/apple/notebooks/03_window_packing.ipynb 8762 1760334699
4 /Users/apple/notebooks/02_reranker_ablation.ipynb 26615 1760334615
5 /Users/apple/notebooks/05_groundedness_eval.ipynb 39210 1760335328
6 /Users/apple/notebooks/hybrid-search-demo.ipynb 27580 1760307946
7 /Users/apple/notebooks/01_retrieval_sanity.ipynb 16137 1760308259
8 /Users/apple/notebooks/ai-stack-demo.ipynb 14607 1760307623

View File

@@ -0,0 +1,25 @@
# Pieces Sync Report
Generated: 2026-02-16 10:20:43 UTC
- pieces_extensions_count: 1
- pieces_data_dirs_count: 0
- pieces_process_count: 2
- api_probe_ok: 0/0
## Extensions
- /Users/apple/.cursor/extensions/meshintelligenttechnologiesinc.pieces-vscode-3.0.1-universal
## Data Dirs
- no pieces data directories found
## Processes
- 54969 /Applications/Pieces OS.app/Contents/MacOS/Pieces OS
- 55184 /Applications/Pieces.app/Contents/MacOS/Pieces
## API Probes
- no api probe ports supplied

View File

@@ -0,0 +1,4 @@
kind,path_or_process
extension,"/Users/apple/.cursor/extensions/meshintelligenttechnologiesinc.pieces-vscode-3.0.1-universal"
process,"54969 /Applications/Pieces OS.app/Contents/MacOS/Pieces OS"
process,"55184 /Applications/Pieces.app/Contents/MacOS/Pieces"
1 kind path_or_process
2 extension /Users/apple/.cursor/extensions/meshintelligenttechnologiesinc.pieces-vscode-3.0.1-universal
3 process 54969 /Applications/Pieces OS.app/Contents/MacOS/Pieces OS
4 process 55184 /Applications/Pieces.app/Contents/MacOS/Pieces

View File

@@ -0,0 +1,71 @@
# Docs Services Automation Runbook
Date: 2026-02-16
Scope: GitHub, Gitea, Jupyter, Pieces documentation integration workflow.
## Goal
Keep docs state synchronized with service reality and publish curated docs updates safely.
## 1) Refresh service status
```bash
cd /Users/apple/github-projects/microdao-daarion
bash scripts/docs/session_bootstrap.sh
```
Primary output:
- `docs/consolidation/INTEGRATIONS_STATUS_LATEST.md`
## 2) Run service adapters (Jupyter + Pieces)
```bash
cd /Users/apple/github-projects/microdao-daarion
bash scripts/docs/services_sync.sh --dry-run
```
Apply mode:
```bash
cd /Users/apple/github-projects/microdao-daarion
bash scripts/docs/services_sync.sh --apply
```
Optional local Pieces API probe:
```bash
cd /Users/apple/github-projects/microdao-daarion
bash scripts/docs/services_sync.sh --apply --probe-ports 39300,39301
```
Outputs:
- `docs/consolidation/jupyter/JUPYTER_SYNC_LATEST.md`
- `docs/consolidation/jupyter/notebooks_index_latest.csv`
- `docs/consolidation/pieces/PIECES_SYNC_LATEST.md`
- `docs/consolidation/pieces/pieces_index_latest.csv`
## 3) Review pending docs updates
```bash
cd /Users/apple/github-projects/microdao-daarion
git status --short
bash scripts/docs/docs_sync.sh --dry-run
```
## 4) Apply sync to remotes
```bash
cd /Users/apple/github-projects/microdao-daarion
bash scripts/docs/docs_sync.sh --apply --targets github,gitea
```
## Safety gates
- `docs_sync.sh` is dry-run by default.
- `--apply` refuses to proceed if staged non-doc files are present.
- Only curated doc paths are auto-staged by the script.
## Jupyter and Pieces notes
- `jupyter_sync.sh` probes active Jupyter servers via `/api/status` when servers are discovered.
- `pieces_sync.sh` captures local Pieces runtime markers and supports optional local API probes (`--probe-ports`).