Separate price provenance, validation and repeatable storage.
Finish with: An educational OHLCV collector with synthetic offline practice, optional yfinance live retrieval, input validation, source-aware SQLite upserts and reproducible diagnostics.
Progress stays in this browser. Export to keep a portable record.
BuildBotsBetterA step demonstration outline; use optional narration while you follow it.
This browser checks the evidence format and your checklist. It cannot inspect your computer or certify a live login.
You have recorded evidence for every step. Repeat the core task from a fresh input and export your results. Review the source, account and platform limits before using the workflow on real work.
Repeat the last product-specific checkpoint from a fresh practice input, preserve actual output, then complete the Build Bot Better guard and restore checks. Export the evidence.
Sources checked 2026-10-05. Live Yahoo retrieval can fail due to access/rate limits and is not inferred from a fixture pass. This educational collector does not implement trading signals or recommendations.
Source-owned text for offline reading and retrieval. Command success still requires actual local evidence.
Open data-dictionary.md. Record the intended symbols, exchange/session dates, daily interval and whether you need unadjusted or adjusted prices. This starter stores unadjusted OHLCV; use the synthetic DEMO series first.
Expected: The contract identifies daily session dates, unadjusted prices, volume, source and retrieval UTC.
Download the resource ZIP at the top of this Build. Extract it into a new folder you own (for example C:\BBBPractice on Windows, or ~/bbb-practice on macOS/Linux). Open a terminal in the extracted folder. Run the version command for your platform. All subsequent commands assume this folder.
Expected: Python reports version 3.10 or newer and the terminal is in the extracted resource folder.
python --version
Get-Location
Get-ChildItempython3 --version
pwd
lspython3 --version
pwd
lsOpen prices.json. Check low <= open/close <= high, positive finite prices, nonnegative volume and unique symbol/date pairs. These DEMO records are not market quotes.
Expected: Two synthetic daily bars satisfy the OHLC/volume/date contract.
Run finance_collector.py with --fixture prices.json. Inspect prices.sqlite and retain the printed source label.
Expected: FINANCE PASS reports written=2 total=2 source=synthetic-fixture.
python finance_collector.py --fixture prices.jsonpython3 finance_collector.py --fixture prices.jsonpython3 finance_collector.py --fixture prices.jsonRun the same fixture again. Confirm total remains 2. The upsert replaces the same source/symbol/date values and refreshes retrieved_utc; it does not append duplicates.
Expected: The second run still reports total=2.
python finance_collector.py --fixture prices.jsonpython3 finance_collector.py --fixture prices.jsonpython3 finance_collector.py --fixture prices.jsonFor live retrieval only, create a virtual environment and install requirements-live.txt. Check the yfinance project documentation and Yahoo data terms for your permitted use. Record the installed dependency versions; fixtures do not need this package.
Expected: The isolated environment imports yfinance and its installed version is recorded.
python -m venv .venv
.\.venv\Scripts\python.exe -m pip install -r requirements-live.txt
.\.venv\Scripts\python.exe -m pip freezepython3 -m venv .venv
.venv/bin/python -m pip install -r requirements-live.txt
.venv/bin/python -m pip freezepython3 -m venv .venv
.venv/bin/python -m pip install -r requirements-live.txt
.venv/bin/python -m pip freezeIf your use is permitted, run the live command for one symbol. Inspect the last five available session bars. Capture retrieval time, source and actual date range. A closed market or holiday can reduce rows; do not invent current quotes.
Expected: A nonempty live result is labeled yahoo-unadjusted, or a concrete access/network failure is retained without being called a success.
.\.venv\Scripts\python.exe finance_collector.py --live MSFT --db live-prices.sqlite.venv/bin/python finance_collector.py --live MSFT --db live-prices.sqlite.venv/bin/python finance_collector.py --live MSFT --db live-prices.sqliteCopy prices.json to prices-bad.json and set one high below its close. Run the collector against a separate bad-prices.sqlite. Confirm it fails visibly. For a live error, record symbol, package version and status; use bounded retry/backoff and respect rate limits.
Expected: The invalid OHLC range produces an error and no successful FINANCE PASS receipt.
python finance_collector.py --fixture prices-bad.json --db bad-prices.sqlitepython3 finance_collector.py --fixture prices-bad.json --db bad-prices.sqlitepython3 finance_collector.py --fixture prices-bad.json --db bad-prices.sqliteRun the chosen fixture or approved live path twice. Verify stable row counts and source labels. Save the contract, version record, last successful receipt and one failure case. A scheduler is an optional later step requiring a bounded interval and failure alert.
Expected: The collector has repeatable storage, correct provenance, visible failures and documented scope.
python finance_collector.py --fixture prices.jsonpython3 finance_collector.py --fixture prices.jsonpython3 finance_collector.py --fixture prices.jsonFill in onboarding-checklist.md for your agent. Record AGENTS.md, the tool’s user settings and memory folder, the assigned workspace, permissions, guard location, backup schedule, and a final proof task. Keep the checklist in your project.
Expected: The checklist contains a concrete path and owner for rules, memory, permissions, guard, backup, restore and final verification.
Run workspace_guard.py --self-test. Read the source: the target is resolved before deciding. The variable_target case points at the home folder but performs no filesystem operation. Compare this with a hook that sees only command text.
Expected: GUARD PASS reports inside allowed and profile, outside, variable-derived profile and workspace root denied; no deletion was executed.
python workspace_guard.py --self-testpython3 workspace_guard.py --self-testpython3 workspace_guard.py --self-testFor CLI tools, open the hook/permissions screen and confirm the configured guard is active. Use your tool’s documented pre-command hook protocol; the BBB working reference is linked in Sources. Run a harmless directory listing, then a guard dry-run targeting the profile. Do not execute a destructive profile probe. Grok Bot has no proven local shell guard here: use project-only tasks and reviewed actions, with backups.
Expected: A harmless command runs, the guard dry-run returns DENY, and the checklist records the actual hook protocol and active state or the Grok Bot limitation.
Connect a second backup drive. Windows: configure System Protection as additional recovery and use a scheduled copy/File History that explicitly includes hidden agent folders. macOS: configure Time Machine and verify dot folders are included. Linux: use a home backup such as restic/Deja Dup; Timeshift omits /home by default. Download the copy-only profile backup script for your platform, inspect it, and adapt the folder list to your tool. Record the last successful scheduled run; protect backup access because it may contain credentials.
Expected: A backup on another drive includes the tool’s user settings and memory folder and this project, and a successful schedule/time is recorded.
.\profile-backup.ps1 -Destination D:\Backups\llm-profilesbash profile-backup.sh /Volumes/YourBackup/llm-profilesbash profile-backup.sh /media/YourBackup/llm-profilesRun restore_drill.py with a separate backup directory. The script creates a new proof file, copies it, restores a second copy, and compares SHA256 hashes. Then restore one non-secret file from your actual agent memory backup into a separate scratch directory and open it; do not overwrite the live profile.
Expected: RESTORE PASS contains matching hashes; the actual memory file is readable after restoration into scratch.
python restore_drill.py --backup-root D:\Backups\bbb-practice --work-root practicepython3 restore_drill.py --backup-root /Volumes/YourBackup/bbb-practice --work-root practicepython3 restore_drill.py --backup-root /media/YourBackup/bbb-practice --work-root practice