feat: PDD enhancement for #1120

[prompt-driven-github]

Summary

Adds budget control via issue comments for GitHub App-triggered PDD runs, allowing users to set total, per-node, and max budget caps and view current settings.

Closes #1120

Changes Made

Prompts Modified

• pdd/prompts/agentic_architecture_orchestrator_python.prompt - Added budget initialization and reporting
• pdd/prompts/agentic_bug_orchestrator_python.prompt - Added budget initialization and reporting
• pdd/prompts/agentic_change_orchestrator_python.prompt - Added budget initialization and reporting
• pdd/prompts/agentic_common_python.prompt - Added BudgetConfig and parsing logic
• pdd/prompts/agentic_split_orchestrator_python.prompt - Added budget initialization and reporting
• pdd/prompts/agentic_sync_python.prompt - Added budget initialization and reporting
• pdd/prompts/agentic_sync_runner_python.prompt - Added budget initialization and reporting
• pdd/prompts/agentic_test_orchestrator_python.prompt - Added budget initialization and reporting
• pdd/prompts/cli_python.prompt - Added budget command line arguments
• pdd/prompts/durable_sync_runner_python.prompt - Added budget initialization and reporting
• pdd/prompts/server/jobs_python.prompt - Added real-time budget enforcement monitoring
• pdd/prompts/server/models_python.prompt - Added budget fields to job models
• pdd/prompts/server/routes/commands_python.prompt - Added budget update endpoint
• pdd/prompts/track_cost_python.prompt - Added job-specific cost tracking

Documentation Updated

• README.md - Added budget control documentation
• docs/TUTORIALS.md - Added budget control examples
• docs/faq.md - Added budget control section
• docs/prompting_guide.md - Added budget control details
• docs/whitepaper.md - Added budget control architectural overview

⚠️ Manual Review Required

• None — Step 10 ASSOCIATED_DOCS_CONFLICTS, manual edit needed

Review Checklist

• Prompt syntax is valid
• PDD conventions followed
• Documentation is up to date

Next Steps After Merge

1. Regenerate code from modified prompts in dependency order:

   ./sync_order.sh

   Or manually:

   pdd sync track_cost
   pdd sync agentic_common
   pdd sync agentic_crash
   pdd sync architecture
   pdd sync ci_validation
   pdd sync agentic_architecture_orchestrator
   pdd sync agentic_test_generate
   pdd sync agentic_verify
   pdd sync agentic_update
   pdd sync agentic_test_orchestrator
   pdd sync cli
   pdd sync agentic_common_worktree
   pdd sync agentic_fix
   pdd sync git_update
   pdd sync agentic_split_orchestrator
   pdd sync duplicate_cli_guard
   pdd sync executor
   pdd sync fix_code_loop
   pdd sync fix_error_loop
   pdd sync fix_verification_errors_loop
   pdd sync agentic_split
   pdd sync sync_order
   pdd sync auto_deps_architecture
   pdd sync agentic_change
   pdd sync agentic_change_orchestrator
   pdd sync agentic_e2e_fix
   pdd sync agentic_e2e_fix_orchestrator
   pdd sync agentic_sync_runner
   pdd sync agentic_test
   pdd sync auth
   pdd sync commands
   pdd sync crash_main
   pdd sync files
   pdd sync fix
   pdd sync fix_verification_main
   pdd sync jobs
   pdd sync one_session_sync
   pdd sync utility
   pdd sync agentic_checkup_orchestrator
   pdd sync app
   pdd sync bug_main
   pdd sync durable_sync_runner
   pdd sync sync_main
   pdd sync __init__
   pdd sync agentic_sync
   pdd sync checkup
   pdd sync checkup_review_loop
   pdd sync ci_drift_heal
   pdd sync connect
   pdd sync generate
   pdd sync maintenance
   pdd sync update_main
   pdd sync agentic_checkup
   pdd sync modify
   pdd sync analysis
   pdd sync pin_example_hack
   pdd sync sync_orchestration
   pdd sync agentic_bug
   pdd sync agentic_bug_orchestrator
   pdd sync models
   pdd sync websocket
   

2. Run tests to verify functionality
3. Deploy if applicable

---

Created by pdd change workflow

[greptile-apps]

Your free trial has ended. If you'd like to continue receiving code reviews, you can add a payment method here.

[Serhan-Asad]

Closing because this run used the Gemini path. The work should be rerun cleanly with the intended Opus model.