docs: sync consolidation and session starter
This commit is contained in:
@@ -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:
|
||||
|
||||
@@ -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
|
||||
|
||||
@@ -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.
|
||||
|
||||
13
docs/consolidation/jupyter/JUPYTER_SYNC_LATEST.md
Normal file
13
docs/consolidation/jupyter/JUPYTER_SYNC_LATEST.md
Normal 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
|
||||
8
docs/consolidation/jupyter/notebooks_index_latest.csv
Normal file
8
docs/consolidation/jupyter/notebooks_index_latest.csv
Normal 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
|
||||
|
25
docs/consolidation/pieces/PIECES_SYNC_LATEST.md
Normal file
25
docs/consolidation/pieces/PIECES_SYNC_LATEST.md
Normal 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
|
||||
4
docs/consolidation/pieces/pieces_index_latest.csv
Normal file
4
docs/consolidation/pieces/pieces_index_latest.csv
Normal 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"
|
||||
|
71
docs/runbooks/DOCS_SERVICES_AUTOMATION_RUNBOOK.md
Normal file
71
docs/runbooks/DOCS_SERVICES_AUTOMATION_RUNBOOK.md
Normal 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`).
|
||||
Reference in New Issue
Block a user