File size: 4,434 Bytes
3bc7cb3 | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 | # TODO: Commit Briefing — MetaMetaMeta
Date: 2026-03-19
Branch: master
Last commit: 4b14a07 feat: add eval dashboard with E2-E7 results (84 runs, 7 experiments)
---
## Files to Commit
### 1. `visual_explainer_run_pipeline.html`
- 1656-line interactive HTML visualization of the run pipeline
- Standalone file, no build step required
- Category: visualization / explainer
### 2. `Visualisungen_improve/index.html`
- Improved dashboard HTML (replacement or iteration on existing eval dashboard)
- Category: visualization / dashboard
### 3. `Visualisungen_improve/data.json`
- Data file backing the improved dashboard
- Should be committed alongside `index.html` — they belong together
- Category: data / dashboard
### 4. `Visualisungen_improve/export_runs.py`
- Python script to export run data (presumably to data.json)
- Category: tooling / scripts
---
## Files to Ignore (Do NOT Commit)
### `agent_arena.db`
- SQLite binary database — runtime artifact, not source
- Binary files have no meaningful diffs in git
- Would bloat the repo history permanently
- Must be added to `.gitignore` before committing anything
---
## .gitignore Updates
Current `.gitignore` content:
```
.DS_Store
__pycache__/
*.pyc
.venv/
```
Add the following:
```
# Databases / runtime artifacts
*.db
*.sqlite
*.sqlite3
```
This covers `agent_arena.db` and any future SQLite files.
---
## Commit Strategy
Two commits. Reason: the pipeline explainer and the Visualisungen_improve work are separate concerns.
### Commit 1 — .gitignore update (do this first, always)
```
chore: ignore SQLite database files
```
Stage only: `.gitignore`
### Commit 2 — Pipeline visualizer
```
feat: add interactive run pipeline visual explainer
```
Stage only: `visual_explainer_run_pipeline.html`
### Commit 3 — Improved dashboard and tooling
```
feat: add improved eval dashboard with export script (Visualisungen_improve)
```
Stage: `Visualisungen_improve/index.html`, `Visualisungen_improve/data.json`, `Visualisungen_improve/export_runs.py`
Total: 3 commits.
---
## Exact Commands
Copy-paste ready. Run in order.
**Step 1 — Update .gitignore:**
```bash
# Edit .gitignore manually to add *.db lines, then:
git -C /home/smlflg/Projekte/MetaMetaMeta add .gitignore
git -C /home/smlflg/Projekte/MetaMetaMeta commit -m "chore: ignore SQLite database files"
```
**Step 2 — Verify db is now ignored:**
```bash
git -C /home/smlflg/Projekte/MetaMetaMeta status
# agent_arena.db should NOT appear in the output
```
**Step 3 — Commit pipeline explainer:**
```bash
git -C /home/smlflg/Projekte/MetaMetaMeta add visual_explainer_run_pipeline.html
git -C /home/smlflg/Projekte/MetaMetaMeta commit -m "feat: add interactive run pipeline visual explainer"
```
**Step 4 — Commit improved dashboard:**
```bash
git -C /home/smlflg/Projekte/MetaMetaMeta add Visualisungen_improve/index.html Visualisungen_improve/data.json Visualisungen_improve/export_runs.py
git -C /home/smlflg/Projekte/MetaMetaMeta commit -m "feat: add improved eval dashboard with export script (Visualisungen_improve)"
```
**Step 5 — Verify final state:**
```bash
git -C /home/smlflg/Projekte/MetaMetaMeta log --oneline -5
git -C /home/smlflg/Projekte/MetaMetaMeta status
```
Expected: clean working tree, 3 new commits on top of 4b14a07.
---
## Pre-commit Checks
Before running any commit command:
1. **agent_arena.db must not appear in `git status`** after .gitignore update. If it does, the .gitignore edit was not saved correctly.
2. **No accidental binary files** — run `git status` after each `git add` and read the output carefully. If anything unexpected appears, do not commit.
3. **HTML files open in browser** — optionally verify `visual_explainer_run_pipeline.html` and `Visualisungen_improve/index.html` open without errors before committing.
4. **export_runs.py is not sensitive** — confirm it contains no hardcoded credentials, API keys, or absolute paths that only work on this machine.
5. **data.json size** — if it is very large (>1MB), consider whether it belongs in git or should be regenerated from `export_runs.py` on demand.
---
## Decision Required Before Starting
- Is `Visualisungen_improve/data.json` small enough to commit? Check with:
```bash
ls -lh /home/smlflg/Projekte/MetaMetaMeta/Visualisungen_improve/data.json
```
If over 500KB, ask Samuel whether to gitignore it and regenerate from `export_runs.py` instead.
|