mirror of
https://github.com/fabro-sh/fabro.git
synced 2026-10-08 03:10:26 +00:00
Fabro
commit
a87582d3ff
2 changed files with 1084 additions and 0 deletions
296
graph.fabro
Normal file
296
graph.fabro
Normal file
|
|
@ -0,0 +1,296 @@
|
||||||
|
digraph Solitaire {
|
||||||
|
graph [
|
||||||
|
goal="Build a terminal-based Klondike solitaire game in Python with a curses TUI",
|
||||||
|
rankdir=LR,
|
||||||
|
default_max_retries=3,
|
||||||
|
retry_target="impl_setup",
|
||||||
|
fallback_retry_target="impl_logic"
|
||||||
|
]
|
||||||
|
|
||||||
|
start [shape=Mdiamond, label="Start"]
|
||||||
|
exit [shape=Msquare, label="Exit"]
|
||||||
|
|
||||||
|
expand_spec [
|
||||||
|
label="Expand Spec",
|
||||||
|
shape=box,
|
||||||
|
prompt="Goal: $goal
|
||||||
|
|
||||||
|
Create a detailed implementation spec for a Python Klondike solitaire TUI.
|
||||||
|
|
||||||
|
Hard requirements:
|
||||||
|
- Create the application under solitaire-app/.
|
||||||
|
- Use Python 3.11+ and the standard-library curses module for the playable UI.
|
||||||
|
- Implement draw-one Klondike with 7 tableau piles, 4 foundations, stock, and waste.
|
||||||
|
- Support keyboard-only play.
|
||||||
|
- Keep game rules testable without curses.
|
||||||
|
- Include a smoke mode so `python3 main.py --smoke` starts enough of the app to prove imports and setup without requiring an interactive terminal.
|
||||||
|
|
||||||
|
Write the spec to .ai/solitaire-spec.md.
|
||||||
|
Write status.json at workspace root: outcome=succeeded if the spec is complete, outcome=failed with failure_reason otherwise."
|
||||||
|
]
|
||||||
|
|
||||||
|
impl_setup [
|
||||||
|
label="Setup Project",
|
||||||
|
shape=box,
|
||||||
|
prompt="Read .ai/solitaire-spec.md.
|
||||||
|
|
||||||
|
Create the Python project skeleton under solitaire-app/:
|
||||||
|
- pyproject.toml with pytest configured
|
||||||
|
- main.py entrypoint
|
||||||
|
- src/solitaire_tui/ package
|
||||||
|
- tests/ directory
|
||||||
|
- README.md stub
|
||||||
|
|
||||||
|
Add minimal importable modules so the project compiles.
|
||||||
|
|
||||||
|
Run:
|
||||||
|
cd solitaire-app && python3 -m py_compile main.py src/solitaire_tui/*.py
|
||||||
|
|
||||||
|
Write status.json at workspace root: outcome=succeeded if the project skeleton exists and compiles, outcome=failed with failure_reason otherwise."
|
||||||
|
]
|
||||||
|
|
||||||
|
verify_setup [
|
||||||
|
label="Verify Setup",
|
||||||
|
shape=box,
|
||||||
|
class="verify",
|
||||||
|
prompt="Verify setup for the solitaire app.
|
||||||
|
|
||||||
|
Check:
|
||||||
|
1. solitaire-app/pyproject.toml exists
|
||||||
|
2. solitaire-app/main.py exists
|
||||||
|
3. solitaire-app/src/solitaire_tui exists
|
||||||
|
4. Python files compile
|
||||||
|
|
||||||
|
Run:
|
||||||
|
cd solitaire-app && python3 -m py_compile main.py src/solitaire_tui/*.py
|
||||||
|
|
||||||
|
Write findings to .ai/verify_setup.md.
|
||||||
|
Write status.json at workspace root: outcome=succeeded if all checks pass, outcome=failed with failure_reason otherwise."
|
||||||
|
]
|
||||||
|
|
||||||
|
check_setup [shape=diamond, label="Setup OK?"]
|
||||||
|
|
||||||
|
impl_data [
|
||||||
|
label="Data Structures",
|
||||||
|
shape=box,
|
||||||
|
prompt="Read .ai/solitaire-spec.md.
|
||||||
|
|
||||||
|
Implement core data structures under solitaire-app/src/solitaire_tui/:
|
||||||
|
- Card with rank, suit, face_up, color, display helpers
|
||||||
|
- Deck with standard 52-card creation and shuffle
|
||||||
|
- Pile types or clear pile abstractions for tableau, foundation, stock, and waste
|
||||||
|
- GameState container with initial deal
|
||||||
|
|
||||||
|
Add focused unit tests under solitaire-app/tests/.
|
||||||
|
|
||||||
|
Run:
|
||||||
|
cd solitaire-app && python3 -m pytest tests/ -v
|
||||||
|
|
||||||
|
Write status.json at workspace root: outcome=succeeded if tests pass and the data model is implemented, outcome=failed with failure_reason otherwise."
|
||||||
|
]
|
||||||
|
|
||||||
|
verify_data [
|
||||||
|
label="Verify Data",
|
||||||
|
shape=box,
|
||||||
|
class="verify",
|
||||||
|
prompt="Verify the solitaire data structures.
|
||||||
|
|
||||||
|
Run:
|
||||||
|
cd solitaire-app && python3 -m pytest tests/ -v && python3 -m py_compile main.py src/solitaire_tui/*.py
|
||||||
|
|
||||||
|
Check that Card, Deck, pile handling, and initial GameState/deal behavior are covered by tests.
|
||||||
|
|
||||||
|
Write findings to .ai/verify_data.md.
|
||||||
|
Write status.json at workspace root: outcome=succeeded if all checks pass, outcome=failed with failure_reason otherwise."
|
||||||
|
]
|
||||||
|
|
||||||
|
check_data [shape=diamond, label="Data OK?"]
|
||||||
|
|
||||||
|
impl_logic [
|
||||||
|
label="Game Logic",
|
||||||
|
shape=box,
|
||||||
|
class="hard",
|
||||||
|
max_retries=2,
|
||||||
|
prompt="Read .ai/solitaire-spec.md and the current solitaire-app implementation.
|
||||||
|
|
||||||
|
Implement complete draw-one Klondike game logic:
|
||||||
|
- Legal moves from waste/tableau to tableau
|
||||||
|
- Legal moves to foundation
|
||||||
|
- Moving face-up tableau runs
|
||||||
|
- Flipping newly exposed tableau cards
|
||||||
|
- Drawing from stock to waste
|
||||||
|
- Recycling waste into stock when stock is empty
|
||||||
|
- Undo for player actions
|
||||||
|
- Win detection when all foundations are complete
|
||||||
|
|
||||||
|
Add tests for legal moves, illegal moves, deal invariants, stock/waste behavior, undo, and win detection.
|
||||||
|
|
||||||
|
Run:
|
||||||
|
cd solitaire-app && python3 -m pytest tests/ -v
|
||||||
|
|
||||||
|
Write status.json at workspace root: outcome=succeeded if all tests pass and rules are implemented, outcome=failed with failure_reason otherwise."
|
||||||
|
]
|
||||||
|
|
||||||
|
verify_logic [
|
||||||
|
label="Verify Logic",
|
||||||
|
shape=box,
|
||||||
|
class="verify",
|
||||||
|
prompt="Verify Klondike game logic.
|
||||||
|
|
||||||
|
Run:
|
||||||
|
cd solitaire-app && python3 -m pytest tests/ -v
|
||||||
|
|
||||||
|
Check for coverage of:
|
||||||
|
- Deal invariants
|
||||||
|
- Tableau move legality
|
||||||
|
- Foundation move legality
|
||||||
|
- Stock/waste draw and recycle
|
||||||
|
- Undo
|
||||||
|
- Win detection
|
||||||
|
|
||||||
|
Write findings to .ai/verify_logic.md.
|
||||||
|
Write status.json at workspace root: outcome=succeeded if all checks pass, outcome=failed with failure_reason otherwise."
|
||||||
|
]
|
||||||
|
|
||||||
|
check_logic [shape=diamond, label="Logic OK?"]
|
||||||
|
|
||||||
|
impl_ui [
|
||||||
|
label="Terminal UI",
|
||||||
|
shape=box,
|
||||||
|
class="hard",
|
||||||
|
max_retries=2,
|
||||||
|
prompt="Read .ai/solitaire-spec.md and the game logic.
|
||||||
|
|
||||||
|
Implement the curses TUI:
|
||||||
|
- Board rendering for foundations, stock, waste, and 7 tableau piles
|
||||||
|
- Compact card labels with face-down cards hidden
|
||||||
|
- Keyboard navigation and selection
|
||||||
|
- Commands for draw, recycle, move to foundation, undo, help, new game, and quit
|
||||||
|
- Clear status/help messages
|
||||||
|
- Graceful handling for terminals that are too small
|
||||||
|
- `python3 main.py --smoke` non-interactive smoke path
|
||||||
|
|
||||||
|
Keep rendering helpers testable where practical and avoid coupling game rules to curses.
|
||||||
|
|
||||||
|
Run:
|
||||||
|
cd solitaire-app && python3 -m pytest tests/ -v && python3 -m py_compile main.py src/solitaire_tui/*.py && python3 main.py --smoke
|
||||||
|
|
||||||
|
Write status.json at workspace root: outcome=succeeded if tests pass, files compile, and smoke mode works, outcome=failed with failure_reason otherwise."
|
||||||
|
]
|
||||||
|
|
||||||
|
verify_ui [
|
||||||
|
label="Verify UI",
|
||||||
|
shape=box,
|
||||||
|
class="verify",
|
||||||
|
prompt="Verify the terminal UI.
|
||||||
|
|
||||||
|
Run:
|
||||||
|
cd solitaire-app && python3 -m pytest tests/ -v && python3 -m py_compile main.py src/solitaire_tui/*.py && python3 main.py --smoke
|
||||||
|
|
||||||
|
Check that:
|
||||||
|
- main.py can start smoke mode
|
||||||
|
- UI module imports without requiring an interactive terminal
|
||||||
|
- Board rendering helpers have tests or smoke coverage
|
||||||
|
- Controls are documented in README.md
|
||||||
|
|
||||||
|
Write findings to .ai/verify_ui.md.
|
||||||
|
Write status.json at workspace root: outcome=succeeded if all checks pass, outcome=failed with failure_reason otherwise."
|
||||||
|
]
|
||||||
|
|
||||||
|
check_ui [shape=diamond, label="UI OK?"]
|
||||||
|
|
||||||
|
impl_integration [
|
||||||
|
label="Integrate",
|
||||||
|
shape=box,
|
||||||
|
prompt="Finish the solitaire app.
|
||||||
|
|
||||||
|
Do the integration work:
|
||||||
|
- Wire main.py to start the curses game loop normally
|
||||||
|
- Keep --smoke non-interactive
|
||||||
|
- Add README.md run instructions and controls
|
||||||
|
- Add any missing tests needed for confidence
|
||||||
|
- Ensure no generated files are outside solitaire-app/ except .ai/ reports and root status.json
|
||||||
|
|
||||||
|
Run:
|
||||||
|
cd solitaire-app && python3 -m pytest tests/ -v && python3 main.py --smoke
|
||||||
|
|
||||||
|
Write status.json at workspace root: outcome=succeeded if the app is playable and tests pass, outcome=failed with failure_reason otherwise."
|
||||||
|
]
|
||||||
|
|
||||||
|
verify_integration [
|
||||||
|
label="Verify Integration",
|
||||||
|
shape=box,
|
||||||
|
class="verify",
|
||||||
|
prompt="Verify final integration.
|
||||||
|
|
||||||
|
Run:
|
||||||
|
cd solitaire-app && python3 -m pytest tests/ -v && python3 -m py_compile main.py src/solitaire_tui/*.py && python3 main.py --smoke
|
||||||
|
|
||||||
|
Check README.md includes setup, run, test, and controls instructions.
|
||||||
|
|
||||||
|
Write findings to .ai/verify_integration.md.
|
||||||
|
Write status.json at workspace root: outcome=succeeded if all checks pass, outcome=failed with failure_reason otherwise."
|
||||||
|
]
|
||||||
|
|
||||||
|
check_integration [shape=diamond, label="Integration OK?"]
|
||||||
|
|
||||||
|
review [
|
||||||
|
label="Final Review",
|
||||||
|
shape=box,
|
||||||
|
class="hard",
|
||||||
|
goal_gate=true,
|
||||||
|
prompt="Review the complete solitaire app against .ai/solitaire-spec.md.
|
||||||
|
|
||||||
|
Confirm:
|
||||||
|
- The app is in solitaire-app/
|
||||||
|
- It is Python 3.11+ and uses curses for the TUI
|
||||||
|
- Draw-one Klondike rules are implemented correctly
|
||||||
|
- Keyboard controls are usable and documented
|
||||||
|
- Tests pass
|
||||||
|
- Smoke mode works without an interactive terminal
|
||||||
|
|
||||||
|
Run:
|
||||||
|
cd solitaire-app && python3 -m pytest tests/ -v && python3 main.py --smoke
|
||||||
|
|
||||||
|
Write review to .ai/solitaire-review.md.
|
||||||
|
Write status.json at workspace root: outcome=succeeded if the app is complete and demo-ready, outcome=failed with specific missing or broken items."
|
||||||
|
]
|
||||||
|
|
||||||
|
check_review [shape=diamond, label="Review OK?"]
|
||||||
|
|
||||||
|
start -> expand_spec -> impl_setup -> verify_setup -> check_setup
|
||||||
|
|
||||||
|
check_setup -> impl_data [condition="outcome=succeeded"]
|
||||||
|
check_setup -> impl_setup [condition="outcome=failed", label="Retry"]
|
||||||
|
check_setup -> impl_setup [label="Fallback"]
|
||||||
|
|
||||||
|
impl_data -> verify_data -> check_data
|
||||||
|
|
||||||
|
check_data -> impl_logic [condition="outcome=succeeded"]
|
||||||
|
check_data -> impl_data [condition="outcome=failed", label="Retry"]
|
||||||
|
check_data -> impl_data [label="Fallback"]
|
||||||
|
|
||||||
|
impl_logic -> verify_logic -> check_logic
|
||||||
|
|
||||||
|
check_logic -> impl_ui [condition="outcome=succeeded"]
|
||||||
|
check_logic -> impl_logic [condition="outcome=failed", label="Retry"]
|
||||||
|
check_logic -> impl_logic [label="Fallback"]
|
||||||
|
|
||||||
|
impl_ui -> verify_ui -> check_ui
|
||||||
|
|
||||||
|
check_ui -> impl_integration [condition="outcome=succeeded"]
|
||||||
|
check_ui -> impl_ui [condition="outcome=failed", label="Retry"]
|
||||||
|
check_ui -> impl_ui [label="Fallback"]
|
||||||
|
|
||||||
|
impl_integration -> verify_integration -> check_integration
|
||||||
|
|
||||||
|
check_integration -> review [condition="outcome=succeeded"]
|
||||||
|
check_integration -> impl_integration [condition="outcome=failed", label="Retry"]
|
||||||
|
check_integration -> impl_integration [label="Fallback"]
|
||||||
|
|
||||||
|
review -> check_review
|
||||||
|
|
||||||
|
check_review -> exit [condition="outcome=succeeded"]
|
||||||
|
check_review -> impl_ui [condition="outcome=failed", label="Fix"]
|
||||||
|
check_review -> impl_ui [label="Fallback"]
|
||||||
|
}
|
||||||
788
run.json
Normal file
788
run.json
Normal file
File diff suppressed because one or more lines are too long
Loading…
Add table
Reference in a new issue