feat: add just command runner with shard benchmark and demo#42
Open
jeffrey-l-turner wants to merge 11 commits intodevfrom
Open
feat: add just command runner with shard benchmark and demo#42jeffrey-l-turner wants to merge 11 commits intodevfrom
jeffrey-l-turner wants to merge 11 commits intodevfrom
Conversation
- Merge 12 policy sections into CLAUDE.md (stigmergic collaboration, task claiming, PII guidelines, config conventions) - Add AGENTS.md (condensed from CLAUDE.md) and GEMINI.md (pointer to CLAUDE.md) - Add docs/ToDos.md, UserStories.md, Backlog.md, CompletedTasks.md templates
…e-rust - Add user story US-001: deploy Rust shard from standalone f1r3node-rust repo - Add EPOCH-001 with 4 tasks: services.yml, compose, shardctl support, docs - Bi-directional linking between US-001 and EPOCH-001 - Replace template placeholders with project-specific content
…pstream - services.yml: change URL to f1r3node-rust.git, branch dev, image f1r3node-rust - compose/f1r3node-rust.yml: align with upstream shard.yml (F1R3FLY_IMAGE env var, F1R3_* runtime tuning, --required-signatures, consistent YAML command format) - Mark TASK-001-1 and TASK-001-2 complete in ToDos.md
- Rename F1R3FLY_RUST_IMAGE env var to F1R3FLY_IMAGE across all compose files - Update default image to f1r3flyindustries/f1r3node-rust:latest everywhere - Update shardctl/node.py pull() and shardctl/cli.py test image references - Update README.md and integration-tests docs - Mark TASK-001-3 complete
- Update README and CLAUDE.md to note f1r3node-rust is a separate repo (not a branch) - Mark EPOCH-001 and all tasks complete - Check all US-001 acceptance criteria, set completed date
- Move EPOCH-001 (4 tasks) from ToDos.md to CompletedTasks.md - Move US-001 from Planned to Completed Stories - ToDos.md clean for new work
- README.md: reorder Quick Start and Node Commands to lead with Rust shard - README.md: mark Scala commands as deprecated, link to f1r3node-rust repo - CLAUDE.md: update Quick Reference to use f1r3node-rust commands
- US-002: Automated benchmark for f1r3node-rust shard only (not Scala/hybrid) - EPOCH-002: 6 tasks from branch merges through report generation - Prerequisite: merge all feature branches to main first
- Add justfile with 26 recipes: shard lifecycle, supporting services, benchmark, teardown - Add scripts/benchmark.sh: orchestrates full-stack benchmark (shard + f1r3drive + embers + f1r3sky) with deploy/propose cycles, timing metrics, and formatted report - Update docs/ToDos.md: mark TASK-002-1 complete, claim TASK-002-2 - Update README.md and CLAUDE.md with just commands and benchmark documentation
- Move completed EPOCH-002 (Automated Shard Benchmark and Demo) from ToDos.md to CompletedTasks.md - All 6 tasks marked complete (2026-03-27)
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
justfilewith 26 recipes for shard lifecycle, supporting services, benchmark, and teardownscripts/benchmark.sh— full-stack benchmark orchestrator (shard + f1r3drive + embers + f1r3sky)README.mdandCLAUDE.mdwithjustcommands and benchmark documentationdocs/CompletedTasks.mdKey Commands
just benchmark— Start shard, supporting services, run deploy/propose cycles, collect metrics, reportjust teardown— Bring down all services and print final reportjust up/just down/just status/just logs— Shard lifecyclejust up-embers/just up-f1r3sky/just up-monitoring— Supporting servicesMerge Order
This PR targets
dev. Merge sequence:feature/f1r3node-rust-integration-option→main) — Rust node integrationdev→main) — sync dev to mainfeature/just-shard-benchmark-demo→dev) — benchmark toolingdev→mainas usualTest Plan
just --listshows all 26 recipesbash -n scripts/benchmark.shpasses syntax checkruff checkandruff format --checkpasspytest test_internal.pypassesjust benchmarkruns successfully against live shard (manual verification)