novacode-cli 1.2.0__py3-none-any.whl
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- novacode_cli/__init__.py +29 -0
- novacode_cli/__main__.py +6 -0
- novacode_cli/_lazy_heavy.py +99 -0
- novacode_cli/_version.py +3 -0
- novacode_cli/agent_stream.py +178 -0
- novacode_cli/agents/agent_file.py +250 -0
- novacode_cli/agents/agent_mailbox.py +120 -0
- novacode_cli/agents/approval_decisions.py +146 -0
- novacode_cli/agents/arg_repair.py +196 -0
- novacode_cli/agents/async_agents/__init__.py +6 -0
- novacode_cli/agents/async_agents/_config.py +213 -0
- novacode_cli/agents/async_agents/_mcp_tools.py +192 -0
- novacode_cli/agents/async_agents/_specialist.py +84 -0
- novacode_cli/agents/async_agents/_test_commands.py +89 -0
- novacode_cli/agents/async_agents/_tools.py +432 -0
- novacode_cli/agents/async_agents/general_purpose.py +42 -0
- novacode_cli/agents/async_agents/langgraph.json +9 -0
- novacode_cli/agents/async_agents/research.py +22 -0
- novacode_cli/agents/async_context.py +303 -0
- novacode_cli/agents/async_on_demand.py +52 -0
- novacode_cli/agents/async_task_errors.py +75 -0
- novacode_cli/agents/async_workspace.py +27 -0
- novacode_cli/agents/attribution.py +165 -0
- novacode_cli/agents/browser_mode.py +119 -0
- novacode_cli/agents/btw_agent.py +71 -0
- novacode_cli/agents/caveman.py +352 -0
- novacode_cli/agents/caveman_support.py +370 -0
- novacode_cli/agents/code_mode.py +774 -0
- novacode_cli/agents/code_runtime.py +160 -0
- novacode_cli/agents/context_compaction.py +1339 -0
- novacode_cli/agents/core_agent.py +2710 -0
- novacode_cli/agents/default_subagents/__init__.py +24 -0
- novacode_cli/agents/default_subagents/async_subagents.py +296 -0
- novacode_cli/agents/default_subagents/builtin/browser-automation-agent.md +110 -0
- novacode_cli/agents/default_subagents/builtin/bug-fix-agent.md +22 -0
- novacode_cli/agents/default_subagents/builtin/bug-investigation-agent.md +42 -0
- novacode_cli/agents/default_subagents/builtin/code-explorer.md +37 -0
- novacode_cli/agents/default_subagents/builtin/code-review-agent.md +33 -0
- novacode_cli/agents/default_subagents/builtin/dependency-audit-agent.md +34 -0
- novacode_cli/agents/default_subagents/builtin/documentation-update-agent.md +46 -0
- novacode_cli/agents/default_subagents/builtin/performance-audit-agent.md +41 -0
- novacode_cli/agents/default_subagents/builtin/plan-scout-agent.md +64 -0
- novacode_cli/agents/default_subagents/builtin/refactoring-agent.md +35 -0
- novacode_cli/agents/default_subagents/builtin/refactoring-specialist-agent.md +175 -0
- novacode_cli/agents/default_subagents/builtin/security-audit-agent.md +96 -0
- novacode_cli/agents/default_subagents/builtin/test-generation-agent.md +33 -0
- novacode_cli/agents/default_subagents/builtin/test-runner-agent.md +55 -0
- novacode_cli/agents/default_subagents/prompt.py +88 -0
- novacode_cli/agents/default_subagents/subagents.py +138 -0
- novacode_cli/agents/dream_agent.py +93 -0
- novacode_cli/agents/edit_diagnostics.py +362 -0
- novacode_cli/agents/edit_fallback.py +62 -0
- novacode_cli/agents/handoff.py +166 -0
- novacode_cli/agents/invocation.py +152 -0
- novacode_cli/agents/model_budget.py +42 -0
- novacode_cli/agents/model_retry.py +113 -0
- novacode_cli/agents/model_router.py +420 -0
- novacode_cli/agents/openai_decisions.py +186 -0
- novacode_cli/agents/plan_agent/__init__.py +12 -0
- novacode_cli/agents/plan_agent/plan_agent.py +357 -0
- novacode_cli/agents/plan_agent/plan_mode_middleware.py +64 -0
- novacode_cli/agents/plan_execution.py +237 -0
- novacode_cli/agents/ponytail.py +66 -0
- novacode_cli/agents/prime.py +274 -0
- novacode_cli/agents/provider_caching.py +99 -0
- novacode_cli/agents/server_launcher.py +904 -0
- novacode_cli/agents/strict_tools.py +384 -0
- novacode_cli/agents/task_discipline.py +294 -0
- novacode_cli/agents/tool_call_repair.py +290 -0
- novacode_cli/agents/tool_offload.py +291 -0
- novacode_cli/agents/tool_search.py +806 -0
- novacode_cli/agents/tool_search_variants.py +106 -0
- novacode_cli/agents/tool_verdicts.py +1194 -0
- novacode_cli/agents/user_async_agents.py +312 -0
- novacode_cli/artifacts/__init__.py +10 -0
- novacode_cli/artifacts/registry.py +278 -0
- novacode_cli/artifacts/server.py +426 -0
- novacode_cli/assets/Nova.png +0 -0
- novacode_cli/assets/nova-avatar.png +0 -0
- novacode_cli/audio/__init__.py +301 -0
- novacode_cli/audio/capture.py +137 -0
- novacode_cli/audio/downloads.py +273 -0
- novacode_cli/audio/pipeline.py +391 -0
- novacode_cli/audio/playback.py +87 -0
- novacode_cli/audio/providers.py +208 -0
- novacode_cli/audio/speakable.py +78 -0
- novacode_cli/audio/stt.py +132 -0
- novacode_cli/audio/stt_deepgram.py +69 -0
- novacode_cli/audio/stt_elevenlabs.py +89 -0
- novacode_cli/audio/stt_parakeet.py +94 -0
- novacode_cli/audio/stt_whistle.py +61 -0
- novacode_cli/audio/summarize.py +92 -0
- novacode_cli/audio/tts.py +85 -0
- novacode_cli/audio/tts_kokoro.py +73 -0
- novacode_cli/audio/tts_orpheus.py +180 -0
- novacode_cli/audio/tts_pocket.py +131 -0
- novacode_cli/audio/tts_sano.py +69 -0
- novacode_cli/audio/vad.py +145 -0
- novacode_cli/backends/__init__.py +17 -0
- novacode_cli/backends/filesystem.py +894 -0
- novacode_cli/backends/native_search.py +92 -0
- novacode_cli/bootstrap/__init__.py +9 -0
- novacode_cli/bootstrap/env_snapshot.py +240 -0
- novacode_cli/bootstrap/steering.py +464 -0
- novacode_cli/bootstrap/vision_router.py +604 -0
- novacode_cli/brand.py +362 -0
- novacode_cli/cli_args.py +718 -0
- novacode_cli/commands/__init__.py +237 -0
- novacode_cli/commands/agents_commands.py +231 -0
- novacode_cli/commands/auth_handler.py +40 -0
- novacode_cli/commands/browser_use_handler.py +75 -0
- novacode_cli/commands/cache_handler.py +32 -0
- novacode_cli/commands/chat_handler.py +1357 -0
- novacode_cli/commands/ci_fix.py +171 -0
- novacode_cli/commands/claude_plan.py +331 -0
- novacode_cli/commands/codex_plan.py +195 -0
- novacode_cli/commands/commands.py +1113 -0
- novacode_cli/commands/create_handler.py +124 -0
- novacode_cli/commands/create_server.py +1887 -0
- novacode_cli/commands/cron_handler.py +119 -0
- novacode_cli/commands/dream_handler.py +203 -0
- novacode_cli/commands/effort_handler.py +65 -0
- novacode_cli/commands/evolution_handler.py +214 -0
- novacode_cli/commands/file_commands.py +381 -0
- novacode_cli/commands/handoff_handler.py +68 -0
- novacode_cli/commands/hooks_handler.py +269 -0
- novacode_cli/commands/init_handler.py +146 -0
- novacode_cli/commands/learning_handler.py +160 -0
- novacode_cli/commands/lite_mode_handler.py +76 -0
- novacode_cli/commands/log_commands.py +363 -0
- novacode_cli/commands/mcp_handler.py +29 -0
- novacode_cli/commands/model_handler.py +29 -0
- novacode_cli/commands/notifications_handler.py +158 -0
- novacode_cli/commands/onboard_handler.py +121 -0
- novacode_cli/commands/plan_handler.py +440 -0
- novacode_cli/commands/planner_usage.py +250 -0
- novacode_cli/commands/plugin_install_handler.py +38 -0
- novacode_cli/commands/plugins_handler.py +35 -0
- novacode_cli/commands/prime_handler.py +455 -0
- novacode_cli/commands/prompt_handler.py +149 -0
- novacode_cli/commands/provider_usage.py +160 -0
- novacode_cli/commands/ralph_events.py +106 -0
- novacode_cli/commands/ralph_handler.py +1293 -0
- novacode_cli/commands/refine_handler.py +213 -0
- novacode_cli/commands/research_handler.py +202 -0
- novacode_cli/commands/rootapp_remote.py +83 -0
- novacode_cli/commands/router_handler.py +36 -0
- novacode_cli/commands/server_commands.py +249 -0
- novacode_cli/commands/session_commands.py +203 -0
- novacode_cli/commands/share_handler.py +450 -0
- novacode_cli/commands/side_commands.py +366 -0
- novacode_cli/commands/skill_invoke.py +420 -0
- novacode_cli/commands/skills_commands.py +48 -0
- novacode_cli/commands/trace_handler.py +322 -0
- novacode_cli/commands/trello_handler.py +226 -0
- novacode_cli/commands/trello_remote.py +177 -0
- novacode_cli/commands/trello_server.py +1214 -0
- novacode_cli/commands/vision_handler.py +127 -0
- novacode_cli/commands/voice_handler.py +447 -0
- novacode_cli/commands/webhook_handler.py +134 -0
- novacode_cli/commands/wiki_commands.py +227 -0
- novacode_cli/compaction.py +753 -0
- novacode_cli/computation_cache.py +159 -0
- novacode_cli/computer/__init__.py +1 -0
- novacode_cli/computer/persistent.py +234 -0
- novacode_cli/computer/preview.py +253 -0
- novacode_cli/computer/runtime.py +474 -0
- novacode_cli/computer/windows_console.py +152 -0
- novacode_cli/computer/windows_qemu.py +211 -0
- novacode_cli/config/browser_mode.py +159 -0
- novacode_cli/config/catalog_models.py +95 -0
- novacode_cli/config/config.py +1388 -0
- novacode_cli/config/credentials.py +540 -0
- novacode_cli/config/google_oauth_auth.py +281 -0
- novacode_cli/config/model_capabilities.py +343 -0
- novacode_cli/config/model_catalog.py +275 -0
- novacode_cli/config/model_create.py +1325 -0
- novacode_cli/config/model_manager.py +695 -0
- novacode_cli/config/nova_config.py +1283 -0
- novacode_cli/config/openai_chatgpt_auth.py +384 -0
- novacode_cli/config/opencode_gateway.py +25 -0
- novacode_cli/config/plan_mode.py +188 -0
- novacode_cli/config/provider_auth.py +438 -0
- novacode_cli/config/provider_catalog.json +5127 -0
- novacode_cli/config/provider_registry.py +38 -0
- novacode_cli/config/provider_transports.py +258 -0
- novacode_cli/config/role_models.py +175 -0
- novacode_cli/context/__init__.py +50 -0
- novacode_cli/context/_analysis.py +799 -0
- novacode_cli/context/_budget.py +116 -0
- novacode_cli/context/_conversation.py +73 -0
- novacode_cli/context/_dynamic.py +264 -0
- novacode_cli/context/_model_config.py +380 -0
- novacode_cli/context/_models_dev.py +99 -0
- novacode_cli/context/archives.py +248 -0
- novacode_cli/context/estimates.py +65 -0
- novacode_cli/context/history.py +17 -0
- novacode_cli/context/knowledge_cache.py +292 -0
- novacode_cli/context/manager.py +101 -0
- novacode_cli/context/observations.py +65 -0
- novacode_cli/context/pressure.py +168 -0
- novacode_cli/context/provider_accounting.py +109 -0
- novacode_cli/context/snapshot.py +493 -0
- novacode_cli/context/strategies.py +279 -0
- novacode_cli/context/task_progress.py +122 -0
- novacode_cli/core/__init__.py +0 -0
- novacode_cli/core/agent_loop.py +1821 -0
- novacode_cli/core/autonomous_loop.py +277 -0
- novacode_cli/core/code_approvals.py +57 -0
- novacode_cli/core/input_preparation.py +276 -0
- novacode_cli/core/reasoning.py +67 -0
- novacode_cli/core/streaming.py +326 -0
- novacode_cli/core/subagent_tasks.py +696 -0
- novacode_cli/core/subagent_tracking.py +235 -0
- novacode_cli/core/tool_results.py +116 -0
- novacode_cli/core/verification_loop.py +272 -0
- novacode_cli/council.py +595 -0
- novacode_cli/council_consensus.py +115 -0
- novacode_cli/council_decision.py +157 -0
- novacode_cli/council_planner.py +1421 -0
- novacode_cli/council_settings.py +208 -0
- novacode_cli/council_web_settings.py +41 -0
- novacode_cli/council_workspace.py +56 -0
- novacode_cli/cowork/__init__.py +10 -0
- novacode_cli/cowork/broker_middleware.py +162 -0
- novacode_cli/cowork/launcher.py +102 -0
- novacode_cli/cowork/policy.py +284 -0
- novacode_cli/cowork/ui.py +826 -0
- novacode_cli/daemons/__init__.py +1 -0
- novacode_cli/daemons/registry.py +342 -0
- novacode_cli/desktop_notifications.py +302 -0
- novacode_cli/doctor.py +251 -0
- novacode_cli/embeddings.py +109 -0
- novacode_cli/entrypoint.py +56 -0
- novacode_cli/errors/__init__.py +19 -0
- novacode_cli/errors/handlers.py +648 -0
- novacode_cli/errors/provider_errors.py +249 -0
- novacode_cli/errors/taxonomy.py +80 -0
- novacode_cli/events.py +179 -0
- novacode_cli/file_ops.py +714 -0
- novacode_cli/git_safety.py +281 -0
- novacode_cli/handoff.py +383 -0
- novacode_cli/headless/__init__.py +18 -0
- novacode_cli/headless/input.py +58 -0
- novacode_cli/headless/output.py +224 -0
- novacode_cli/headless/pipe.py +532 -0
- novacode_cli/headless/runner.py +461 -0
- novacode_cli/hermes/__init__.py +39 -0
- novacode_cli/hermes/activation.py +297 -0
- novacode_cli/hermes/config.py +129 -0
- novacode_cli/hermes/curator.py +199 -0
- novacode_cli/hermes/evolution.py +374 -0
- novacode_cli/hermes/ledger.py +364 -0
- novacode_cli/hermes/memory_tiers.py +969 -0
- novacode_cli/hermes/middleware.py +678 -0
- novacode_cli/hermes/overview.py +174 -0
- novacode_cli/hermes/prompt_evolution.py +503 -0
- novacode_cli/hermes/refine_loop.py +643 -0
- novacode_cli/hermes/refinement_log.py +190 -0
- novacode_cli/hermes/review.py +674 -0
- novacode_cli/hermes/skill_debate.py +135 -0
- novacode_cli/hermes/skill_discovery.py +450 -0
- novacode_cli/hermes/skill_manager.py +335 -0
- novacode_cli/hermes/skill_proposals.py +43 -0
- novacode_cli/hermes/test_gaming.py +119 -0
- novacode_cli/hermes/tracker.py +435 -0
- novacode_cli/hermes/tuner.py +206 -0
- novacode_cli/hermes/verification_memory.py +134 -0
- novacode_cli/hermes/verifier.py +277 -0
- novacode_cli/hitl/__init__.py +22 -0
- novacode_cli/hitl/interrupts.py +493 -0
- novacode_cli/hooks.py +359 -0
- novacode_cli/image_utils.py +517 -0
- novacode_cli/init/__init__.py +7 -0
- novacode_cli/init/events.py +43 -0
- novacode_cli/input_utils.py +526 -0
- novacode_cli/install_commands.py +87 -0
- novacode_cli/integrations/__init__.py +82 -0
- novacode_cli/integrations/daytona.py +122 -0
- novacode_cli/integrations/docker.py +309 -0
- novacode_cli/integrations/host_path.py +111 -0
- novacode_cli/integrations/langsmith.py +151 -0
- novacode_cli/integrations/modal.py +134 -0
- novacode_cli/integrations/runloop.py +130 -0
- novacode_cli/integrations/sandbox_factory.py +1388 -0
- novacode_cli/integrations/sandbox_registry.py +312 -0
- novacode_cli/integrations/workdir_backend.py +589 -0
- novacode_cli/main.py +2078 -0
- novacode_cli/mcp/__init__.py +73 -0
- novacode_cli/mcp/auth.py +189 -0
- novacode_cli/mcp/client.py +571 -0
- novacode_cli/mcp/code_mode.py +5 -0
- novacode_cli/mcp/code_runtime.py +5 -0
- novacode_cli/mcp/commands.py +902 -0
- novacode_cli/mcp/config.py +406 -0
- novacode_cli/mcp/generic.py +128 -0
- novacode_cli/mcp/middleware.py +993 -0
- novacode_cli/mcp/presets.py +367 -0
- novacode_cli/memory/__init__.py +1 -0
- novacode_cli/memory/agent_memory.py +1312 -0
- novacode_cli/memory/builtin_lessons.py +60 -0
- novacode_cli/memory/dream_gates.py +192 -0
- novacode_cli/memory/limits.py +59 -0
- novacode_cli/memory/parsed_cache.py +106 -0
- novacode_cli/memory/recall_stats.py +97 -0
- novacode_cli/memory/semantic.py +116 -0
- novacode_cli/memory/store.py +335 -0
- novacode_cli/memory/wiki.py +274 -0
- novacode_cli/migrate.py +185 -0
- novacode_cli/onboarding.py +649 -0
- novacode_cli/onboarding_check.py +119 -0
- novacode_cli/path_approval.py +297 -0
- novacode_cli/plan_archive.py +148 -0
- novacode_cli/plugins/__init__.py +121 -0
- novacode_cli/plugins/claude_plugins.py +538 -0
- novacode_cli/plugins/cli.py +168 -0
- novacode_cli/plugins/components.py +413 -0
- novacode_cli/plugins/hooks.py +356 -0
- novacode_cli/plugins/loader.py +317 -0
- novacode_cli/plugins/marketplaces.py +199 -0
- novacode_cli/plugins/storage.py +70 -0
- novacode_cli/prime.py +759 -0
- novacode_cli/prime_factory/__init__.py +15 -0
- novacode_cli/prime_factory/container.py +198 -0
- novacode_cli/prime_factory/controller.py +565 -0
- novacode_cli/prime_factory/knowledge.py +261 -0
- novacode_cli/prime_factory/publication.py +218 -0
- novacode_cli/prime_factory/recovery.py +50 -0
- novacode_cli/prime_factory/research.py +370 -0
- novacode_cli/prime_factory/runner.py +608 -0
- novacode_cli/prime_factory/runtime.py +261 -0
- novacode_cli/prime_factory/state.py +201 -0
- novacode_cli/prime_factory/store.py +128 -0
- novacode_cli/prime_factory/worker.py +129 -0
- novacode_cli/prime_factory/workflow.py +899 -0
- novacode_cli/prime_factory/workspace.py +317 -0
- novacode_cli/prime_memory.py +290 -0
- novacode_cli/process_manager.py +585 -0
- novacode_cli/project_onboard.py +537 -0
- novacode_cli/prompts/System_Prompt_Nova.jinja +23 -0
- novacode_cli/prompts/__init__.py +168 -0
- novacode_cli/prompts/agent_definitions.jinja +11 -0
- novacode_cli/prompts/agent_generation.jinja +125 -0
- novacode_cli/prompts/async_agents/general_purpose.jinja +22 -0
- novacode_cli/prompts/claude_plan_mode.jinja +12 -0
- novacode_cli/prompts/coding_workflow.jinja +18 -0
- novacode_cli/prompts/computer_use.jinja +17 -0
- novacode_cli/prompts/core_agent_system.jinja +81 -0
- novacode_cli/prompts/delegation.jinja +15 -0
- novacode_cli/prompts/desktop_power.jinja +4 -0
- novacode_cli/prompts/file_paths.jinja +15 -0
- novacode_cli/prompts/file_tracker.jinja +23 -0
- novacode_cli/prompts/init_agents_md.jinja +56 -0
- novacode_cli/prompts/init_exploration.jinja +174 -0
- novacode_cli/prompts/init_semantic_orchestrate.jinja +37 -0
- novacode_cli/prompts/instruction_scope.jinja +5 -0
- novacode_cli/prompts/learnings_extraction.jinja +45 -0
- novacode_cli/prompts/longterm_memory.jinja +54 -0
- novacode_cli/prompts/mcp.jinja +84 -0
- novacode_cli/prompts/memory_consolidation.jinja +40 -0
- novacode_cli/prompts/nova_evolution.jinja +73 -0
- novacode_cli/prompts/nova_review.jinja +158 -0
- novacode_cli/prompts/nova_skill_debate.jinja +36 -0
- novacode_cli/prompts/nova_standing_instructions.jinja +26 -0
- novacode_cli/prompts/nova_verify.jinja +100 -0
- novacode_cli/prompts/onboard_dashboard.jinja +378 -0
- novacode_cli/prompts/plan_agent.jinja +87 -0
- novacode_cli/prompts/plan_scouts.jinja +5 -0
- novacode_cli/prompts/plan_storage.jinja +8 -0
- novacode_cli/prompts/planning.jinja +82 -0
- novacode_cli/prompts/ponytail/LICENSE +21 -0
- novacode_cli/prompts/ponytail/UPSTREAM.json +15 -0
- novacode_cli/prompts/ponytail/hooks/ponytail-config.js +175 -0
- novacode_cli/prompts/ponytail/hooks/ponytail-instructions.js +98 -0
- novacode_cli/prompts/ponytail/skills/ponytail/SKILL.md +52 -0
- novacode_cli/prompts/ponytail/skills/ponytail-audit/SKILL.md +103 -0
- novacode_cli/prompts/ponytail/skills/ponytail-debt/SKILL.md +44 -0
- novacode_cli/prompts/ponytail/skills/ponytail-gain/SKILL.md +52 -0
- novacode_cli/prompts/ponytail/skills/ponytail-help/SKILL.md +76 -0
- novacode_cli/prompts/ponytail/skills/ponytail-review/SKILL.md +101 -0
- novacode_cli/prompts/prompt_evolution.jinja +27 -0
- novacode_cli/prompts/ralph_iteration.jinja +75 -0
- novacode_cli/prompts/refine_gate.jinja +31 -0
- novacode_cli/prompts/refine_plan.jinja +64 -0
- novacode_cli/prompts/refine_review.jinja +34 -0
- novacode_cli/prompts/research_delivery.jinja +9 -0
- novacode_cli/prompts/research_swarm.jinja +130 -0
- novacode_cli/prompts/response_style.jinja +5 -0
- novacode_cli/prompts/session_summarization.jinja +86 -0
- novacode_cli/prompts/skill_creation.jinja +85 -0
- novacode_cli/prompts/subagents/fact_checker.jinja +48 -0
- novacode_cli/prompts/subagents/financial_analyst.jinja +50 -0
- novacode_cli/prompts/subagents/literature_reviewer.jinja +52 -0
- novacode_cli/prompts/subagents/market_analyst.jinja +48 -0
- novacode_cli/prompts/subagents/research_synthesizer.jinja +57 -0
- novacode_cli/prompts/subagents/technical_researcher.jinja +56 -0
- novacode_cli/prompts/subagents/web_researcher.jinja +46 -0
- novacode_cli/prompts/summarization.jinja +107 -0
- novacode_cli/prompts/summarization_answers.jinja +23 -0
- novacode_cli/prompts/summarization_questions.jinja +32 -0
- novacode_cli/prompts/vision_caption.jinja +21 -0
- novacode_cli/prompts/voice_summary.jinja +65 -0
- novacode_cli/prompts/wiki_file.jinja +57 -0
- novacode_cli/prompts/wiki_ingest.jinja +87 -0
- novacode_cli/recovery.py +383 -0
- novacode_cli/remote/__init__.py +45 -0
- novacode_cli/remote/approvals.py +282 -0
- novacode_cli/remote/async_task_clients.py +97 -0
- novacode_cli/remote/async_task_watcher.py +240 -0
- novacode_cli/remote/bridge.py +905 -0
- novacode_cli/remote/command_menu.py +26 -0
- novacode_cli/remote/command_ui.py +243 -0
- novacode_cli/remote/config.py +199 -0
- novacode_cli/remote/discord_bridge.py +530 -0
- novacode_cli/remote/discord_format.py +31 -0
- novacode_cli/remote/discord_threads.py +225 -0
- novacode_cli/remote/images.py +97 -0
- novacode_cli/remote/processor.py +601 -0
- novacode_cli/remote/rootapp_bot/bot.cjs +16 -0
- novacode_cli/remote/rootapp_bot/package-lock.json +2683 -0
- novacode_cli/remote/rootapp_bot/package.json +18 -0
- novacode_cli/remote/rootapp_bot/transport.cjs +80 -0
- novacode_cli/remote/rootapp_bridge.py +370 -0
- novacode_cli/remote/rootapp_setup.py +89 -0
- novacode_cli/remote/routing.py +103 -0
- novacode_cli/remote/scheduler.py +302 -0
- novacode_cli/remote/session.py +164 -0
- novacode_cli/remote/status.py +411 -0
- novacode_cli/remote/streaming.py +188 -0
- novacode_cli/remote/telegram_bridge.py +1118 -0
- novacode_cli/remote/telegram_format.py +215 -0
- novacode_cli/remote/telegram_hub.py +256 -0
- novacode_cli/remote/voice_notes.py +120 -0
- novacode_cli/remote/webhook_adapters.py +167 -0
- novacode_cli/remote/webhook_server.py +154 -0
- novacode_cli/rewind.py +150 -0
- novacode_cli/rooms/__init__.py +1 -0
- novacode_cli/rooms/bridge.py +86 -0
- novacode_cli/rooms/cli.py +231 -0
- novacode_cli/rooms/nova.py +227 -0
- novacode_cli/rooms/runtime.py +299 -0
- novacode_cli/rooms/store.py +538 -0
- novacode_cli/rooms/workspace.py +94 -0
- novacode_cli/security/__init__.py +29 -0
- novacode_cli/security/approval_context.py +45 -0
- novacode_cli/security/delegated_approval.py +68 -0
- novacode_cli/security/local_http.py +85 -0
- novacode_cli/security/middleware.py +87 -0
- novacode_cli/security/paths.py +35 -0
- novacode_cli/security/policy.py +535 -0
- novacode_cli/security/policy_writer.py +90 -0
- novacode_cli/security/prompt_injection.py +203 -0
- novacode_cli/security/remember.py +81 -0
- novacode_cli/security/rule_synthesis.py +116 -0
- novacode_cli/security/secret_files.py +61 -0
- novacode_cli/security/session_allow.py +114 -0
- novacode_cli/security/unicode_security.py +516 -0
- novacode_cli/security/validator.py +173 -0
- novacode_cli/server/__init__.py +9 -0
- novacode_cli/server/app.py +632 -0
- novacode_cli/server/event_adapter.py +189 -0
- novacode_cli/server/session_manager.py +90 -0
- novacode_cli/server_main.py +64 -0
- novacode_cli/server_runner/dev_server.py +530 -0
- novacode_cli/server_runner/test_runner.py +470 -0
- novacode_cli/session/__init__.py +1 -0
- novacode_cli/session/adapters/__init__.py +240 -0
- novacode_cli/session/adapters/claude_code.py +102 -0
- novacode_cli/session/adapters/codex.py +77 -0
- novacode_cli/session/adapters/harness_native.py +75 -0
- novacode_cli/session/checkpoint_coordinator.py +448 -0
- novacode_cli/session/context_restore.py +25 -0
- novacode_cli/session/history_export.py +228 -0
- novacode_cli/session/history_tree.py +174 -0
- novacode_cli/session/imported_context.py +267 -0
- novacode_cli/session/runtime_identity.py +32 -0
- novacode_cli/session/session_persistence.py +1168 -0
- novacode_cli/session/session_prompt_builder.py +279 -0
- novacode_cli/session/session_restore.py +351 -0
- novacode_cli/session/session_summarization.py +20 -0
- novacode_cli/session/transcript_journal.py +153 -0
- novacode_cli/sessions/__init__.py +11 -0
- novacode_cli/sessions/gateway.py +84 -0
- novacode_cli/sessions/launch.py +51 -0
- novacode_cli/sessions/lease.py +213 -0
- novacode_cli/sessions/messaging.py +255 -0
- novacode_cli/sessions/protocol.py +216 -0
- novacode_cli/sessions/resume.py +31 -0
- novacode_cli/sessions/supervisor.py +498 -0
- novacode_cli/sessions/tasks.py +73 -0
- novacode_cli/sessions/tui_messaging.py +413 -0
- novacode_cli/sessions/worker.py +652 -0
- novacode_cli/sessions/worktree.py +262 -0
- novacode_cli/shell/__init__.py +27 -0
- novacode_cli/shell/jobs.py +475 -0
- novacode_cli/shell/middleware.py +1568 -0
- novacode_cli/shell/os_sandbox.py +205 -0
- novacode_cli/shell/output.py +181 -0
- novacode_cli/shell/patterns.py +275 -0
- novacode_cli/shell/processes.py +87 -0
- novacode_cli/shell/utils.py +236 -0
- novacode_cli/skills/__init__.py +26 -0
- novacode_cli/skills/builtin/handoff/SKILL.md +15 -0
- novacode_cli/skills/curation_middleware.py +69 -0
- novacode_cli/skills/executable.py +161 -0
- novacode_cli/skills/libraries.py +102 -0
- novacode_cli/skills/load.py +248 -0
- novacode_cli/skills/prune.py +215 -0
- novacode_cli/skills/refreshing_middleware.py +896 -0
- novacode_cli/skills/retrieval.py +248 -0
- novacode_cli/skills/runtime.py +118 -0
- novacode_cli/skills/schema.py +254 -0
- novacode_cli/skills/skill_creation.py +1549 -0
- novacode_cli/skills/skill_lock.py +75 -0
- novacode_cli/skills/skill_system_prompt.py +16 -0
- novacode_cli/skills/skills_prefs.py +126 -0
- novacode_cli/skills/tool_resolver.py +31 -0
- novacode_cli/skills/upstream.py +50 -0
- novacode_cli/skills/versioning.py +291 -0
- novacode_cli/states/Session.py +847 -0
- novacode_cli/states/__init__.py +31 -0
- novacode_cli/states/slices/__init__.py +17 -0
- novacode_cli/states/slices/agent_runtime.py +249 -0
- novacode_cli/states/slices/background_tasks.py +21 -0
- novacode_cli/states/slices/notifications.py +74 -0
- novacode_cli/states/slices/remote_bridge.py +56 -0
- novacode_cli/states/slices/ui_settings.py +49 -0
- novacode_cli/states/slices/wiki.py +25 -0
- novacode_cli/teammates/__init__.py +1 -0
- novacode_cli/teammates/controller.py +557 -0
- novacode_cli/teammates/graph.py +104 -0
- novacode_cli/teammates/registry.py +175 -0
- novacode_cli/teammates/service.py +254 -0
- novacode_cli/teammates/worker.py +19 -0
- novacode_cli/teams/__init__.py +1 -0
- novacode_cli/teams/adapters/__init__.py +1 -0
- novacode_cli/teams/adapters/container.py +316 -0
- novacode_cli/teams/adapters/inprocess.py +206 -0
- novacode_cli/teams/adapters/process.py +364 -0
- novacode_cli/teams/bootstrap.py +246 -0
- novacode_cli/teams/container_git.py +67 -0
- novacode_cli/teams/context.py +34 -0
- novacode_cli/teams/coordinator.py +815 -0
- novacode_cli/teams/gateway.py +200 -0
- novacode_cli/teams/host.py +64 -0
- novacode_cli/teams/legacy.py +52 -0
- novacode_cli/teams/middleware.py +176 -0
- novacode_cli/teams/models.py +104 -0
- novacode_cli/teams/output.py +47 -0
- novacode_cli/teams/protocol.py +50 -0
- novacode_cli/teams/recovery.py +80 -0
- novacode_cli/teams/scheduler.py +44 -0
- novacode_cli/teams/store.py +631 -0
- novacode_cli/teams/worker.py +251 -0
- novacode_cli/teams/workspace.py +100 -0
- novacode_cli/token_utils.py +256 -0
- novacode_cli/tools/__init__.py +104 -0
- novacode_cli/tools/_shared.py +97 -0
- novacode_cli/tools/_types.py +24 -0
- novacode_cli/tools/artifact_tools.py +137 -0
- novacode_cli/tools/code_search_tools.py +330 -0
- novacode_cli/tools/computer_tools.py +77 -0
- novacode_cli/tools/cron_tools.py +65 -0
- novacode_cli/tools/daemon_tool.py +290 -0
- novacode_cli/tools/desktop_tools.py +161 -0
- novacode_cli/tools/fetch_tools.py +530 -0
- novacode_cli/tools/http_tools.py +279 -0
- novacode_cli/tools/inspection_tools.py +107 -0
- novacode_cli/tools/job_tools.py +143 -0
- novacode_cli/tools/knowledge_tools.py +427 -0
- novacode_cli/tools/memory_tools.py +461 -0
- novacode_cli/tools/memory_wiki_tools.py +40 -0
- novacode_cli/tools/notebook_tools.py +238 -0
- novacode_cli/tools/oracle_tool.py +83 -0
- novacode_cli/tools/plan_archive_tools.py +80 -0
- novacode_cli/tools/plan_mode_tools.py +315 -0
- novacode_cli/tools/python_kernel_loop.py +165 -0
- novacode_cli/tools/python_kernel_tool.py +222 -0
- novacode_cli/tools/reflection_tools.py +34 -0
- novacode_cli/tools/scraper_tools.py +377 -0
- novacode_cli/tools/skill_tools.py +275 -0
- novacode_cli/tools/speak_tool.py +51 -0
- novacode_cli/tools/store_memory_tools.py +227 -0
- novacode_cli/tools/ui_tools.py +62 -0
- novacode_cli/tools/waiter_tools.py +408 -0
- novacode_cli/tools/web_tools.py +349 -0
- novacode_cli/tools/wiki_tools.py +152 -0
- novacode_cli/tools/worktree_tools.py +219 -0
- novacode_cli/tracking/__init__.py +10 -0
- novacode_cli/tracking/file_tracker.py +826 -0
- novacode_cli/tracking/local_metrics.py +170 -0
- novacode_cli/tracking/loop_guard.py +507 -0
- novacode_cli/tracking/request_metrics.py +60 -0
- novacode_cli/tracking/tracing.py +692 -0
- novacode_cli/tracking/usage_tree.py +677 -0
- novacode_cli/tracking/workspace_anchoring.py +231 -0
- novacode_cli/tui/__init__.py +11 -0
- novacode_cli/tui/animation_rate.py +9 -0
- novacode_cli/tui/animations.py +332 -0
- novacode_cli/tui/app.py +19315 -0
- novacode_cli/tui/auth_display.py +87 -0
- novacode_cli/tui/auth_screens.py +826 -0
- novacode_cli/tui/avatar.py +294 -0
- novacode_cli/tui/avatar_frames.py +21 -0
- novacode_cli/tui/background_tasks.py +35 -0
- novacode_cli/tui/browser_settings_screen.py +70 -0
- novacode_cli/tui/caveman_screen.py +185 -0
- novacode_cli/tui/council_settings_screen.py +182 -0
- novacode_cli/tui/council_view.py +535 -0
- novacode_cli/tui/decision_settings.py +268 -0
- novacode_cli/tui/diff_preview.py +199 -0
- novacode_cli/tui/gc_tuning.py +63 -0
- novacode_cli/tui/handoff_screen.py +206 -0
- novacode_cli/tui/harness.py +244 -0
- novacode_cli/tui/history_tree_screen.py +179 -0
- novacode_cli/tui/home.py +328 -0
- novacode_cli/tui/home_scene.py +94 -0
- novacode_cli/tui/icons.py +81 -0
- novacode_cli/tui/interface_styles.tcss +327 -0
- novacode_cli/tui/matrix3.py +108 -0
- novacode_cli/tui/mcp_tools_screen.py +131 -0
- novacode_cli/tui/motion.py +178 -0
- novacode_cli/tui/output_body.py +136 -0
- novacode_cli/tui/output_buffer.py +59 -0
- novacode_cli/tui/palette.py +334 -0
- novacode_cli/tui/pickers.py +237 -0
- novacode_cli/tui/prime_panel.py +506 -0
- novacode_cli/tui/provider_signin.py +213 -0
- novacode_cli/tui/pty_shell.py +159 -0
- novacode_cli/tui/reference_screens.py +444 -0
- novacode_cli/tui/resume_picker.py +346 -0
- novacode_cli/tui/rooms.py +597 -0
- novacode_cli/tui/screens.py +7088 -0
- novacode_cli/tui/session_import.py +333 -0
- novacode_cli/tui/session_pane.py +242 -0
- novacode_cli/tui/session_tab.py +42 -0
- novacode_cli/tui/session_transcript.py +118 -0
- novacode_cli/tui/shell_output.py +7 -0
- novacode_cli/tui/stall_watch.py +174 -0
- novacode_cli/tui/statusline.py +40 -0
- novacode_cli/tui/statusline_screen.py +91 -0
- novacode_cli/tui/teammate_updates.py +162 -0
- novacode_cli/tui/teammates.py +548 -0
- novacode_cli/tui/terminal.py +289 -0
- novacode_cli/tui/terminal_view.py +235 -0
- novacode_cli/tui/themes.py +118 -0
- novacode_cli/tui/update_notice.py +84 -0
- novacode_cli/tui/voice_downloads.py +113 -0
- novacode_cli/tui/widgets.py +2038 -0
- novacode_cli/tui/windows_input.py +38 -0
- novacode_cli/tui/workspace_approval.py +165 -0
- novacode_cli/ui/council_web.py +113 -0
- novacode_cli/ui/council_workspace.py +72 -0
- novacode_cli/ui/cowork_web.py +41 -0
- novacode_cli/ui/diff_highlight.py +160 -0
- novacode_cli/ui/execution.py +1396 -0
- novacode_cli/ui/exit_summary.py +65 -0
- novacode_cli/ui/hitl_approval.py +196 -0
- novacode_cli/ui/input_preparation.py +2 -0
- novacode_cli/ui/interrupt_handlers.py +215 -0
- novacode_cli/ui/question_prompt.py +151 -0
- novacode_cli/ui/status_phrases.py +157 -0
- novacode_cli/ui/stream_preview.py +66 -0
- novacode_cli/ui/streaming.py +2 -0
- novacode_cli/ui/subagent_tracking.py +2 -0
- novacode_cli/ui/ui_elements.py +1585 -0
- novacode_cli/ui/web_workspace.py +244 -0
- novacode_cli/ui_events.py +299 -0
- novacode_cli/update_ui.py +243 -0
- novacode_cli/updates.py +489 -0
- novacode_cli/utils/backend_patches.py +399 -0
- novacode_cli/utils/backend_paths.py +467 -0
- novacode_cli/utils/lazy_providers.py +51 -0
- novacode_cli/utils/model_info.py +223 -0
- novacode_cli/utils/pdf_extraction.py +183 -0
- novacode_cli/utils/startup.py +29 -0
- novacode_cli/utils/tasks.py +42 -0
- novacode_cli/utils/windows.py +9 -0
- novacode_cli/vixie/hook_adapter.py +127 -0
- novacode_cli/vixie/server.py +375 -0
- novacode_cli/wiki/__init__.py +15 -0
- novacode_cli/wiki/ask.py +56 -0
- novacode_cli/wiki/file.py +71 -0
- novacode_cli/wiki/ingest.py +184 -0
- novacode_cli/wiki/manager.py +261 -0
- novacode_cli-1.2.0.dist-info/METADATA +271 -0
- novacode_cli-1.2.0.dist-info/RECORD +691 -0
- novacode_cli-1.2.0.dist-info/WHEEL +5 -0
- novacode_cli-1.2.0.dist-info/entry_points.txt +2 -0
- novacode_cli-1.2.0.dist-info/licenses/LICENSE +21 -0
- novacode_cli-1.2.0.dist-info/top_level.txt +1 -0
|
@@ -0,0 +1,1293 @@
|
|
|
1
|
+
"""Handler for the /ralph command - autonomous looping mode.
|
|
2
|
+
|
|
3
|
+
UI is emitted through a small ``emit`` callback (a Rich-markup string sink) so
|
|
4
|
+
the same handler drives both the classic console REPL and the Textual TUI:
|
|
5
|
+
|
|
6
|
+
* CLI (default): :func:`_console_emit` renders the markup to the global console.
|
|
7
|
+
* TUI: ``tui/app.py`` passes a thread-safe emitter that logs each line as a
|
|
8
|
+
native widget (so foreground headers, the background progress, and
|
|
9
|
+
``/ralph --status`` all render in the TUI instead of being swallowed or
|
|
10
|
+
printed raw to stdout/stderr).
|
|
11
|
+
"""
|
|
12
|
+
|
|
13
|
+
from __future__ import annotations
|
|
14
|
+
|
|
15
|
+
import asyncio
|
|
16
|
+
import hashlib
|
|
17
|
+
import json
|
|
18
|
+
import logging
|
|
19
|
+
import os
|
|
20
|
+
import re
|
|
21
|
+
import shlex
|
|
22
|
+
import subprocess
|
|
23
|
+
import threading
|
|
24
|
+
import uuid
|
|
25
|
+
from collections.abc import Callable
|
|
26
|
+
from dataclasses import dataclass, field
|
|
27
|
+
from datetime import UTC, datetime
|
|
28
|
+
from pathlib import Path
|
|
29
|
+
from typing import Any
|
|
30
|
+
|
|
31
|
+
from rich.markup import escape
|
|
32
|
+
|
|
33
|
+
from novacode_cli.commands import ralph_events as rev
|
|
34
|
+
from novacode_cli.config.config import COLORS, console
|
|
35
|
+
from novacode_cli.prompts import render_template
|
|
36
|
+
from novacode_cli.states.Session import BackgroundRalphTask, RalphTaskStatus
|
|
37
|
+
from novacode_cli.ui.ui_elements import TokenTracker
|
|
38
|
+
|
|
39
|
+
logger = logging.getLogger(__name__)
|
|
40
|
+
|
|
41
|
+
# A UI sink: called with one Rich-markup string per line. "" means a blank line.
|
|
42
|
+
EmitFn = Callable[[str], None]
|
|
43
|
+
# A structured-progress sink (optional). Renderers that want native widgets pass
|
|
44
|
+
# one of these; when it is None the handler renders the markup ``emit`` fallback.
|
|
45
|
+
EventFn = rev.RalphEventFn
|
|
46
|
+
|
|
47
|
+
|
|
48
|
+
def _console_emit(message: str = "") -> None:
|
|
49
|
+
"""Default emitter (CLI): render a Rich-markup string to the console."""
|
|
50
|
+
console.print(message)
|
|
51
|
+
|
|
52
|
+
|
|
53
|
+
def _emit_event(
|
|
54
|
+
on_event: EventFn | None,
|
|
55
|
+
event: rev.RalphEvent,
|
|
56
|
+
fallback: Callable[[], None],
|
|
57
|
+
) -> None:
|
|
58
|
+
"""Send a structured event to ``on_event`` if present, else run ``fallback``.
|
|
59
|
+
|
|
60
|
+
Keeps the handler UI-agnostic: the TUI passes ``on_event`` and renders native
|
|
61
|
+
widgets; the CLI leaves it ``None`` and the markup ``fallback`` runs unchanged.
|
|
62
|
+
"""
|
|
63
|
+
if on_event is not None:
|
|
64
|
+
try:
|
|
65
|
+
on_event(event)
|
|
66
|
+
except Exception: # noqa: BLE001 - a renderer hiccup must not break the run
|
|
67
|
+
logger.debug("ralph on_event renderer failed", exc_info=True)
|
|
68
|
+
else:
|
|
69
|
+
fallback()
|
|
70
|
+
|
|
71
|
+
|
|
72
|
+
# Cross-iteration progress log. The agent reads it at the start of every
|
|
73
|
+
# iteration and appends what it implemented/learned at the end, so a Ralph run
|
|
74
|
+
# carries memory forward. POSIX path so the model never sees a backslashed form.
|
|
75
|
+
RALPH_PROGRESS_PATH = ".nova/ralph/progress.md"
|
|
76
|
+
|
|
77
|
+
|
|
78
|
+
def _ensure_ralph_dir() -> None:
|
|
79
|
+
"""Make sure .nova/ralph/ exists so progress.md has a home."""
|
|
80
|
+
try:
|
|
81
|
+
(Path(".nova") / "ralph").mkdir(parents=True, exist_ok=True)
|
|
82
|
+
except OSError:
|
|
83
|
+
pass
|
|
84
|
+
|
|
85
|
+
|
|
86
|
+
def _read_ralph_progress() -> str:
|
|
87
|
+
"""Return the current progress.md contents (bounded), or '' if absent."""
|
|
88
|
+
p = Path(".nova") / "ralph" / "progress.md"
|
|
89
|
+
try:
|
|
90
|
+
if p.exists():
|
|
91
|
+
text = p.read_text(encoding="utf-8", errors="replace").strip()
|
|
92
|
+
if len(text) > 6000:
|
|
93
|
+
text = "…(earlier progress trimmed)…\n" + text[-6000:]
|
|
94
|
+
return text
|
|
95
|
+
except Exception:
|
|
96
|
+
pass
|
|
97
|
+
return ""
|
|
98
|
+
|
|
99
|
+
|
|
100
|
+
# =============================================================================
|
|
101
|
+
# Smart-loop signals: checklist (completion), git fingerprint (stuck), verify
|
|
102
|
+
# =============================================================================
|
|
103
|
+
|
|
104
|
+
#: Structured completion signal. The agent maintains a markdown checklist here;
|
|
105
|
+
#: the loop stops early once every item is checked (instead of grinding through
|
|
106
|
+
#: all max_iterations). POSIX path so the model never sees a backslashed form.
|
|
107
|
+
RALPH_CHECKLIST_PATH = ".nova/ralph/checklist.md"
|
|
108
|
+
#: Opt-in verification command (one shell command). When present, the loop runs
|
|
109
|
+
#: it after each iteration and won't declare completion until it passes.
|
|
110
|
+
RALPH_VERIFY_PATH = ".nova/ralph/verify.txt"
|
|
111
|
+
#: Consecutive zero-change iterations tolerated before the loop calls it stuck.
|
|
112
|
+
_MAX_NO_CHANGE = 2
|
|
113
|
+
#: Max characters of verification output fed back into the next prompt.
|
|
114
|
+
_VERIFY_TAIL_CHARS = 1500
|
|
115
|
+
|
|
116
|
+
_CHECKLIST_RE = re.compile(r"^\s*[-*]\s*\[([ xX])\]\s+(.+?)\s*$")
|
|
117
|
+
|
|
118
|
+
|
|
119
|
+
@dataclass
|
|
120
|
+
class _ChecklistState:
|
|
121
|
+
"""Parsed Ralph checklist — the loop's structured completion signal."""
|
|
122
|
+
|
|
123
|
+
items: list[tuple[bool, str]] = field(default_factory=list)
|
|
124
|
+
|
|
125
|
+
@property
|
|
126
|
+
def total(self) -> int:
|
|
127
|
+
return len(self.items)
|
|
128
|
+
|
|
129
|
+
@property
|
|
130
|
+
def done(self) -> int:
|
|
131
|
+
return sum(1 for checked, _ in self.items if checked)
|
|
132
|
+
|
|
133
|
+
@property
|
|
134
|
+
def all_done(self) -> bool:
|
|
135
|
+
"""True only when there is at least one item and all are checked."""
|
|
136
|
+
return self.total > 0 and self.done == self.total
|
|
137
|
+
|
|
138
|
+
@property
|
|
139
|
+
def summary(self) -> str:
|
|
140
|
+
return f"{self.done}/{self.total} items complete" if self.total else "no checklist yet"
|
|
141
|
+
|
|
142
|
+
def remaining(self) -> list[str]:
|
|
143
|
+
return [text for checked, text in self.items if not checked]
|
|
144
|
+
|
|
145
|
+
|
|
146
|
+
def _read_checklist() -> _ChecklistState:
|
|
147
|
+
"""Parse ``.nova/ralph/checklist.md`` (empty state if absent/unreadable)."""
|
|
148
|
+
p = Path(".nova") / "ralph" / "checklist.md"
|
|
149
|
+
items: list[tuple[bool, str]] = []
|
|
150
|
+
try:
|
|
151
|
+
if p.exists():
|
|
152
|
+
for line in p.read_text(encoding="utf-8", errors="replace").splitlines():
|
|
153
|
+
m = _CHECKLIST_RE.match(line)
|
|
154
|
+
if m:
|
|
155
|
+
items.append((m.group(1).lower() == "x", m.group(2).strip()))
|
|
156
|
+
except OSError:
|
|
157
|
+
pass
|
|
158
|
+
return _ChecklistState(items)
|
|
159
|
+
|
|
160
|
+
|
|
161
|
+
def _git_change_signature(working_directory: str) -> str:
|
|
162
|
+
"""Fingerprint the working tree, to detect a no-progress iteration.
|
|
163
|
+
|
|
164
|
+
Combines ``git status --porcelain`` (new/untracked files) with ``git diff
|
|
165
|
+
HEAD`` (edits to already-dirty tracked files, which the status line alone
|
|
166
|
+
would miss). Returns ``""`` on any git failure — the caller treats an empty
|
|
167
|
+
signature as "changed" so a git hiccup never false-positives as stuck.
|
|
168
|
+
"""
|
|
169
|
+
chunks: list[str] = []
|
|
170
|
+
for args in (["status", "--porcelain"], ["diff", "HEAD"]):
|
|
171
|
+
try:
|
|
172
|
+
r = subprocess.run( # noqa: S603, S607 — fixed git command
|
|
173
|
+
["git", *args],
|
|
174
|
+
cwd=working_directory,
|
|
175
|
+
capture_output=True,
|
|
176
|
+
text=True,
|
|
177
|
+
timeout=8,
|
|
178
|
+
check=False,
|
|
179
|
+
)
|
|
180
|
+
except (subprocess.TimeoutExpired, FileNotFoundError, OSError):
|
|
181
|
+
return ""
|
|
182
|
+
if r.returncode != 0:
|
|
183
|
+
return ""
|
|
184
|
+
chunks.append(r.stdout)
|
|
185
|
+
return hashlib.sha256("\x00".join(chunks).encode("utf-8", "replace")).hexdigest()
|
|
186
|
+
|
|
187
|
+
|
|
188
|
+
def _read_verify_command(working_directory: str) -> str:
|
|
189
|
+
"""The opt-in verification command from ``.nova/ralph/verify.txt`` ('' if none)."""
|
|
190
|
+
cfg = Path(working_directory) / ".nova" / "ralph" / "verify.txt"
|
|
191
|
+
try:
|
|
192
|
+
if cfg.exists():
|
|
193
|
+
return cfg.read_text(encoding="utf-8", errors="replace").strip()
|
|
194
|
+
except OSError:
|
|
195
|
+
pass
|
|
196
|
+
return ""
|
|
197
|
+
|
|
198
|
+
|
|
199
|
+
@dataclass
|
|
200
|
+
class _VerifyResult:
|
|
201
|
+
"""Outcome of the opt-in per-iteration verification command."""
|
|
202
|
+
|
|
203
|
+
passed: bool
|
|
204
|
+
summary: str
|
|
205
|
+
|
|
206
|
+
|
|
207
|
+
def _run_verification(working_directory: str) -> _VerifyResult | None:
|
|
208
|
+
"""Run the opt-in verification command, or ``None`` if not configured.
|
|
209
|
+
|
|
210
|
+
The command lives in ``.nova/ralph/verify.txt`` (one shell command). Opt-in
|
|
211
|
+
by design: auto-running a whole test suite every iteration would be slow and
|
|
212
|
+
surprising. Best-effort — a missing/blank file, an unparseable command, or a
|
|
213
|
+
launch failure returns ``None`` (verification simply doesn't gate the loop).
|
|
214
|
+
"""
|
|
215
|
+
command = _read_verify_command(working_directory)
|
|
216
|
+
if not command:
|
|
217
|
+
return None
|
|
218
|
+
try:
|
|
219
|
+
argv = shlex.split(command, posix=os.name != "nt")
|
|
220
|
+
except ValueError:
|
|
221
|
+
argv = []
|
|
222
|
+
if not argv:
|
|
223
|
+
return None
|
|
224
|
+
try:
|
|
225
|
+
r = subprocess.run( # noqa: S603 — user's own opt-in verify command, by design
|
|
226
|
+
argv,
|
|
227
|
+
cwd=working_directory,
|
|
228
|
+
capture_output=True,
|
|
229
|
+
text=True,
|
|
230
|
+
timeout=600,
|
|
231
|
+
check=False,
|
|
232
|
+
)
|
|
233
|
+
except (subprocess.TimeoutExpired, FileNotFoundError, OSError) as e:
|
|
234
|
+
return _VerifyResult(passed=False, summary=f"verification could not run: {e}")
|
|
235
|
+
tail = (r.stdout + r.stderr).strip()
|
|
236
|
+
if len(tail) > _VERIFY_TAIL_CHARS:
|
|
237
|
+
tail = "…\n" + tail[-_VERIFY_TAIL_CHARS:]
|
|
238
|
+
return _VerifyResult(passed=r.returncode == 0, summary=tail or f"exit code {r.returncode}")
|
|
239
|
+
|
|
240
|
+
|
|
241
|
+
def _ralph_iteration_decision(
|
|
242
|
+
checklist: _ChecklistState,
|
|
243
|
+
no_change_streak: int,
|
|
244
|
+
verify: _VerifyResult | None,
|
|
245
|
+
max_no_change: int = _MAX_NO_CHANGE,
|
|
246
|
+
) -> tuple[str, str]:
|
|
247
|
+
"""Decide what to do after an iteration: ``continue`` / ``complete`` / ``stuck``.
|
|
248
|
+
|
|
249
|
+
Pure (no I/O) so the loop policy is unit-testable. Completion requires every
|
|
250
|
+
checklist item checked *and* verification passing (when configured). Stuck is
|
|
251
|
+
only declared when there's been no file change for ``max_no_change``
|
|
252
|
+
consecutive iterations and the work isn't actually finished.
|
|
253
|
+
|
|
254
|
+
Returns ``(decision, human_reason)``.
|
|
255
|
+
"""
|
|
256
|
+
verify_ok = verify is None or verify.passed
|
|
257
|
+
if checklist.all_done and verify_ok:
|
|
258
|
+
reason = f"all {checklist.total} checklist items complete"
|
|
259
|
+
if verify is not None:
|
|
260
|
+
reason += " and verification passed"
|
|
261
|
+
return "complete", reason
|
|
262
|
+
if no_change_streak >= max_no_change and not checklist.all_done:
|
|
263
|
+
return "stuck", f"no file changes for {no_change_streak} consecutive iterations"
|
|
264
|
+
return "continue", ""
|
|
265
|
+
|
|
266
|
+
|
|
267
|
+
def _read_checklist_md() -> str:
|
|
268
|
+
"""Raw checklist markdown for display in the prompt ('' if absent)."""
|
|
269
|
+
p = Path(".nova") / "ralph" / "checklist.md"
|
|
270
|
+
try:
|
|
271
|
+
if p.exists():
|
|
272
|
+
return p.read_text(encoding="utf-8", errors="replace").strip()
|
|
273
|
+
except OSError:
|
|
274
|
+
pass
|
|
275
|
+
return ""
|
|
276
|
+
|
|
277
|
+
|
|
278
|
+
def _ralph_render_extras(
|
|
279
|
+
no_change_streak: int, last_verify: _VerifyResult | None
|
|
280
|
+
) -> dict[str, Any]:
|
|
281
|
+
"""Template kwargs that carry the smart-loop state into the next iteration."""
|
|
282
|
+
checklist = _read_checklist()
|
|
283
|
+
return {
|
|
284
|
+
"checklist_path": RALPH_CHECKLIST_PATH,
|
|
285
|
+
"verify_path": RALPH_VERIFY_PATH,
|
|
286
|
+
"checklist_md": _read_checklist_md(),
|
|
287
|
+
"checklist_summary": checklist.summary,
|
|
288
|
+
"verify_summary": last_verify.summary if last_verify else "",
|
|
289
|
+
"verify_passed": last_verify.passed if last_verify else False,
|
|
290
|
+
"no_change_streak": no_change_streak,
|
|
291
|
+
}
|
|
292
|
+
|
|
293
|
+
|
|
294
|
+
def _ralph_evaluate(
|
|
295
|
+
working_directory: str, sig_before: str, no_change_streak: int
|
|
296
|
+
) -> tuple[str, str, int, _VerifyResult | None]:
|
|
297
|
+
"""Post-iteration evaluation shared by both loops.
|
|
298
|
+
|
|
299
|
+
Compares the working-tree fingerprint, runs verification, reads the
|
|
300
|
+
checklist, and returns ``(decision, reason, new_no_change_streak, verify)``.
|
|
301
|
+
An empty before/after signature (git unavailable) counts as "changed" so a
|
|
302
|
+
git failure never false-positives the stuck check.
|
|
303
|
+
"""
|
|
304
|
+
sig_after = _git_change_signature(working_directory)
|
|
305
|
+
changed = (not sig_before) or (not sig_after) or (sig_after != sig_before)
|
|
306
|
+
streak = 0 if changed else no_change_streak + 1
|
|
307
|
+
verify = _run_verification(working_directory)
|
|
308
|
+
checklist = _read_checklist()
|
|
309
|
+
decision, reason = _ralph_iteration_decision(checklist, streak, verify)
|
|
310
|
+
return decision, reason, streak, verify
|
|
311
|
+
|
|
312
|
+
|
|
313
|
+
# =============================================================================
|
|
314
|
+
# Ralph Checkpoint Management
|
|
315
|
+
# =============================================================================
|
|
316
|
+
|
|
317
|
+
|
|
318
|
+
def _get_checkpoint_path() -> Path:
|
|
319
|
+
"""Get the path to the ralph checkpoint file."""
|
|
320
|
+
home = Path.home()
|
|
321
|
+
return home / ".nova" / "ralph-checkpoint.json"
|
|
322
|
+
|
|
323
|
+
|
|
324
|
+
def _save_ralph_checkpoint(
|
|
325
|
+
task: str,
|
|
326
|
+
max_iterations: int,
|
|
327
|
+
completed_iterations: int,
|
|
328
|
+
working_directory: str,
|
|
329
|
+
notes: str = "",
|
|
330
|
+
) -> None:
|
|
331
|
+
"""Save ralph checkpoint to disk."""
|
|
332
|
+
checkpoint_path = _get_checkpoint_path()
|
|
333
|
+
checkpoint_path.parent.mkdir(parents=True, exist_ok=True)
|
|
334
|
+
|
|
335
|
+
checkpoint: dict[str, Any] = {
|
|
336
|
+
"task": task,
|
|
337
|
+
"max_iterations": max_iterations,
|
|
338
|
+
"completed_iterations": completed_iterations,
|
|
339
|
+
"timestamp": datetime.now(UTC).isoformat(),
|
|
340
|
+
"working_directory": working_directory,
|
|
341
|
+
"notes": notes,
|
|
342
|
+
}
|
|
343
|
+
|
|
344
|
+
# Track modified files via git
|
|
345
|
+
try:
|
|
346
|
+
result = subprocess.run(
|
|
347
|
+
["git", "status", "--porcelain"],
|
|
348
|
+
cwd=working_directory,
|
|
349
|
+
capture_output=True,
|
|
350
|
+
text=True,
|
|
351
|
+
timeout=5,
|
|
352
|
+
check=False,
|
|
353
|
+
)
|
|
354
|
+
if result.returncode == 0:
|
|
355
|
+
checkpoint["files_modified"] = [
|
|
356
|
+
line[3:] for line in result.stdout.strip().split("\n") if line
|
|
357
|
+
]
|
|
358
|
+
except (subprocess.TimeoutExpired, FileNotFoundError):
|
|
359
|
+
checkpoint["files_modified"] = []
|
|
360
|
+
|
|
361
|
+
with checkpoint_path.open("w") as f:
|
|
362
|
+
json.dump(checkpoint, f, indent=2)
|
|
363
|
+
|
|
364
|
+
|
|
365
|
+
def _load_ralph_checkpoint() -> dict[str, Any] | None:
|
|
366
|
+
"""Load ralph checkpoint from disk."""
|
|
367
|
+
checkpoint_path = _get_checkpoint_path()
|
|
368
|
+
if not checkpoint_path.exists():
|
|
369
|
+
return None
|
|
370
|
+
|
|
371
|
+
try:
|
|
372
|
+
with checkpoint_path.open("r") as f:
|
|
373
|
+
return json.load(f)
|
|
374
|
+
except (json.JSONDecodeError, OSError):
|
|
375
|
+
return None
|
|
376
|
+
|
|
377
|
+
|
|
378
|
+
def _clear_ralph_checkpoint() -> None:
|
|
379
|
+
"""Remove ralph checkpoint file."""
|
|
380
|
+
checkpoint_path = _get_checkpoint_path()
|
|
381
|
+
if checkpoint_path.exists():
|
|
382
|
+
checkpoint_path.unlink()
|
|
383
|
+
|
|
384
|
+
|
|
385
|
+
def _stop_and_save_all_ralph_tasks(session_state, emit: EmitFn = _console_emit) -> bool:
|
|
386
|
+
"""Stop all running Ralph background tasks and save their state.
|
|
387
|
+
|
|
388
|
+
Returns True if tasks were stopped and saved, False if none were running.
|
|
389
|
+
"""
|
|
390
|
+
if not session_state.background_ralph_tasks:
|
|
391
|
+
return False
|
|
392
|
+
|
|
393
|
+
running_tasks = [
|
|
394
|
+
task
|
|
395
|
+
for task in session_state.background_ralph_tasks.values()
|
|
396
|
+
if task.status == RalphTaskStatus.RUNNING
|
|
397
|
+
]
|
|
398
|
+
|
|
399
|
+
if not running_tasks:
|
|
400
|
+
return False
|
|
401
|
+
|
|
402
|
+
for task in running_tasks:
|
|
403
|
+
try:
|
|
404
|
+
# Completed iterations = current - 1 (we stop before this one finishes).
|
|
405
|
+
completed = max(0, task.iteration - 1)
|
|
406
|
+
_save_ralph_checkpoint(
|
|
407
|
+
task=task.task_description,
|
|
408
|
+
max_iterations=task.max_iterations,
|
|
409
|
+
completed_iterations=completed,
|
|
410
|
+
working_directory=task.working_directory,
|
|
411
|
+
notes=f"Stopped at iteration {task.iteration}. Resume with /ralph --resume",
|
|
412
|
+
)
|
|
413
|
+
task.status = RalphTaskStatus.CANCELLED
|
|
414
|
+
task.completed_at = datetime.now(UTC)
|
|
415
|
+
|
|
416
|
+
emit(f"[yellow]✓[/yellow] Saved Ralph checkpoint at iteration {task.iteration}")
|
|
417
|
+
emit("[dim] Resume later with: /ralph --resume[/dim]")
|
|
418
|
+
except Exception as e:
|
|
419
|
+
emit(f"[red]✗ Failed to save Ralph checkpoint: {escape(str(e))}[/red]")
|
|
420
|
+
|
|
421
|
+
return True
|
|
422
|
+
|
|
423
|
+
|
|
424
|
+
def _build_status_snapshot(session_state) -> rev.StatusSnapshot:
|
|
425
|
+
"""Collect background-task state into a plain, renderer-agnostic snapshot."""
|
|
426
|
+
rows: list[rev.RalphTaskRow] = []
|
|
427
|
+
running = completed = failed = 0
|
|
428
|
+
now = datetime.now(UTC)
|
|
429
|
+
for task_id, task in session_state.background_ralph_tasks.items():
|
|
430
|
+
if task.status == RalphTaskStatus.RUNNING:
|
|
431
|
+
status = "running"
|
|
432
|
+
running += 1
|
|
433
|
+
elapsed = (now - task.created_at).total_seconds()
|
|
434
|
+
elif task.status == RalphTaskStatus.COMPLETED:
|
|
435
|
+
status = "completed"
|
|
436
|
+
completed += 1
|
|
437
|
+
elapsed = (
|
|
438
|
+
(task.completed_at - task.created_at).total_seconds() if task.completed_at else 0
|
|
439
|
+
)
|
|
440
|
+
elif task.status == RalphTaskStatus.FAILED:
|
|
441
|
+
status = "failed"
|
|
442
|
+
failed += 1
|
|
443
|
+
elapsed = (
|
|
444
|
+
(task.completed_at - task.created_at).total_seconds() if task.completed_at else 0
|
|
445
|
+
)
|
|
446
|
+
else:
|
|
447
|
+
continue
|
|
448
|
+
rows.append(
|
|
449
|
+
rev.RalphTaskRow(
|
|
450
|
+
iteration=task.iteration,
|
|
451
|
+
max_iterations=task.max_iterations,
|
|
452
|
+
status=status,
|
|
453
|
+
task=task.task_description,
|
|
454
|
+
task_id=task_id,
|
|
455
|
+
elapsed=elapsed,
|
|
456
|
+
working_directory=task.working_directory,
|
|
457
|
+
error=task.error_message,
|
|
458
|
+
)
|
|
459
|
+
)
|
|
460
|
+
return rev.StatusSnapshot(
|
|
461
|
+
rows=rows,
|
|
462
|
+
running=running,
|
|
463
|
+
completed=completed,
|
|
464
|
+
failed=failed,
|
|
465
|
+
total=len(session_state.background_ralph_tasks),
|
|
466
|
+
)
|
|
467
|
+
|
|
468
|
+
|
|
469
|
+
async def handle_ralph_status(
|
|
470
|
+
session_state,
|
|
471
|
+
emit: EmitFn = _console_emit,
|
|
472
|
+
on_event: EventFn | None = None,
|
|
473
|
+
) -> bool:
|
|
474
|
+
"""Handle /ralph --status — show background task status (UI-agnostic)."""
|
|
475
|
+
if on_event is not None:
|
|
476
|
+
on_event(_build_status_snapshot(session_state))
|
|
477
|
+
return True
|
|
478
|
+
|
|
479
|
+
emit("")
|
|
480
|
+
emit("[bold]Ralph Background Tasks[/bold]")
|
|
481
|
+
|
|
482
|
+
if not session_state.background_ralph_tasks:
|
|
483
|
+
emit("[dim]No background Ralph tasks running.[/dim]")
|
|
484
|
+
emit("[dim]Note: tasks may take a moment to appear after being started.[/dim]")
|
|
485
|
+
emit("")
|
|
486
|
+
return True
|
|
487
|
+
|
|
488
|
+
running_tasks = []
|
|
489
|
+
completed_tasks = []
|
|
490
|
+
failed_tasks = []
|
|
491
|
+
for task_id, task in session_state.background_ralph_tasks.items():
|
|
492
|
+
if task.status == RalphTaskStatus.RUNNING:
|
|
493
|
+
running_tasks.append((task_id, task))
|
|
494
|
+
elif task.status == RalphTaskStatus.COMPLETED:
|
|
495
|
+
completed_tasks.append((task_id, task))
|
|
496
|
+
elif task.status == RalphTaskStatus.FAILED:
|
|
497
|
+
failed_tasks.append((task_id, task))
|
|
498
|
+
|
|
499
|
+
if running_tasks:
|
|
500
|
+
emit("")
|
|
501
|
+
emit("[bold cyan]Running:[/bold cyan]")
|
|
502
|
+
for task_id, task in running_tasks:
|
|
503
|
+
elapsed = (datetime.now(UTC) - task.created_at).total_seconds()
|
|
504
|
+
desc = task.task_description
|
|
505
|
+
desc = desc[:60] + "..." if len(desc) > 60 else desc
|
|
506
|
+
emit(f" ⏳ Iteration {task.iteration}/{task.max_iterations}")
|
|
507
|
+
emit(f" Task: {escape(desc)}")
|
|
508
|
+
emit(f" ID: {task_id}")
|
|
509
|
+
emit(f" Duration: {elapsed:.0f}s")
|
|
510
|
+
emit(f" Dir: {escape(task.working_directory)}")
|
|
511
|
+
|
|
512
|
+
if completed_tasks:
|
|
513
|
+
emit("")
|
|
514
|
+
emit("[bold green]Completed:[/bold green]")
|
|
515
|
+
for _task_id, task in completed_tasks:
|
|
516
|
+
elapsed = (
|
|
517
|
+
(task.completed_at - task.created_at).total_seconds() if task.completed_at else 0
|
|
518
|
+
)
|
|
519
|
+
emit(f" ✓ Iteration {task.iteration}/{task.max_iterations}")
|
|
520
|
+
emit(f" Duration: {elapsed:.0f}s")
|
|
521
|
+
|
|
522
|
+
if failed_tasks:
|
|
523
|
+
emit("")
|
|
524
|
+
emit("[bold red]Failed:[/bold red]")
|
|
525
|
+
for _task_id, task in failed_tasks:
|
|
526
|
+
emit(f" ✗ Iteration {task.iteration}/{task.max_iterations}")
|
|
527
|
+
if task.error_message:
|
|
528
|
+
msg = task.error_message
|
|
529
|
+
msg = msg[:80] + "..." if len(msg) > 80 else msg
|
|
530
|
+
emit(f" Error: {escape(msg)}")
|
|
531
|
+
|
|
532
|
+
emit("")
|
|
533
|
+
emit("[bold]Summary:[/bold]")
|
|
534
|
+
emit(f" Total: {len(session_state.background_ralph_tasks)} tasks")
|
|
535
|
+
emit(f" Running: {len(running_tasks)}")
|
|
536
|
+
emit(f" Completed: {len(completed_tasks)}")
|
|
537
|
+
emit(f" Failed: {len(failed_tasks)}")
|
|
538
|
+
emit("")
|
|
539
|
+
return True
|
|
540
|
+
|
|
541
|
+
|
|
542
|
+
def _run_background_ralph_in_thread(
|
|
543
|
+
task: str,
|
|
544
|
+
start_iteration: int,
|
|
545
|
+
max_iterations: int,
|
|
546
|
+
agent,
|
|
547
|
+
assistant_id: str,
|
|
548
|
+
session_state,
|
|
549
|
+
token_tracker: TokenTracker,
|
|
550
|
+
working_directory: str,
|
|
551
|
+
backend,
|
|
552
|
+
emit: EmitFn = _console_emit,
|
|
553
|
+
on_event: EventFn | None = None,
|
|
554
|
+
) -> None:
|
|
555
|
+
"""Run background Ralph iterations in a separate thread with its own loop."""
|
|
556
|
+
loop = None
|
|
557
|
+
try:
|
|
558
|
+
loop = asyncio.new_event_loop()
|
|
559
|
+
asyncio.set_event_loop(loop)
|
|
560
|
+
loop.run_until_complete(
|
|
561
|
+
_execute_all_ralph_iterations_background(
|
|
562
|
+
task=task,
|
|
563
|
+
start_iteration=start_iteration,
|
|
564
|
+
max_iterations=max_iterations,
|
|
565
|
+
agent=agent,
|
|
566
|
+
assistant_id=assistant_id,
|
|
567
|
+
session_state=session_state,
|
|
568
|
+
token_tracker=token_tracker,
|
|
569
|
+
working_directory=working_directory,
|
|
570
|
+
backend=backend,
|
|
571
|
+
emit=emit,
|
|
572
|
+
on_event=on_event,
|
|
573
|
+
)
|
|
574
|
+
)
|
|
575
|
+
except BaseException as e:
|
|
576
|
+
logger.exception("Background Ralph execution failed")
|
|
577
|
+
emit(f"[red]✗ Background Ralph execution failed: {escape(str(e))}[/red]")
|
|
578
|
+
finally:
|
|
579
|
+
if loop is not None:
|
|
580
|
+
try:
|
|
581
|
+
loop.close()
|
|
582
|
+
except Exception:
|
|
583
|
+
logger.exception("Failed to close background Ralph event loop")
|
|
584
|
+
|
|
585
|
+
|
|
586
|
+
async def _execute_all_ralph_iterations_background(
|
|
587
|
+
task: str,
|
|
588
|
+
start_iteration: int,
|
|
589
|
+
max_iterations: int,
|
|
590
|
+
agent,
|
|
591
|
+
assistant_id: str,
|
|
592
|
+
session_state,
|
|
593
|
+
token_tracker: TokenTracker,
|
|
594
|
+
working_directory: str,
|
|
595
|
+
backend,
|
|
596
|
+
emit: EmitFn = _console_emit,
|
|
597
|
+
on_event: EventFn | None = None,
|
|
598
|
+
) -> None:
|
|
599
|
+
"""Execute all Ralph iterations sequentially in the background (non-blocking).
|
|
600
|
+
|
|
601
|
+
Tool calls are auto-approved so the run never blocks on input. Progress is
|
|
602
|
+
surfaced via ``emit`` / ``on_event`` and a final notification; check anytime
|
|
603
|
+
with ``/ralph --status``.
|
|
604
|
+
"""
|
|
605
|
+
from novacode_cli.ui.execution import execute_task
|
|
606
|
+
|
|
607
|
+
def _hdr() -> None:
|
|
608
|
+
emit("")
|
|
609
|
+
emit("[bold]🚀 Ralph background execution started[/bold]")
|
|
610
|
+
desc = task[:70] + "..." if len(task) > 70 else task
|
|
611
|
+
emit(f"[dim]Task: {escape(desc)}[/dim]")
|
|
612
|
+
|
|
613
|
+
_emit_event(
|
|
614
|
+
on_event,
|
|
615
|
+
rev.RalphStarted(task=task, max_iterations=max_iterations, background=True),
|
|
616
|
+
_hdr,
|
|
617
|
+
)
|
|
618
|
+
|
|
619
|
+
original_auto_approve = session_state.auto_approve
|
|
620
|
+
session_state.auto_approve = True
|
|
621
|
+
|
|
622
|
+
# Ground the loop in the prior conversation (read once before iterating).
|
|
623
|
+
conversation_context = ""
|
|
624
|
+
try:
|
|
625
|
+
from novacode_cli.context import ContextManager
|
|
626
|
+
|
|
627
|
+
conversation_context = await ContextManager().digest(agent, session_state.thread_id)
|
|
628
|
+
except Exception:
|
|
629
|
+
conversation_context = ""
|
|
630
|
+
|
|
631
|
+
_ensure_ralph_dir()
|
|
632
|
+
iteration = start_iteration
|
|
633
|
+
# Smart-loop state, carried across iterations.
|
|
634
|
+
no_change_streak = 0
|
|
635
|
+
last_verify: _VerifyResult | None = None
|
|
636
|
+
sig_before = ""
|
|
637
|
+
|
|
638
|
+
try:
|
|
639
|
+
try:
|
|
640
|
+
while max_iterations == 0 or iteration <= max_iterations:
|
|
641
|
+
# Check for stop/checkpoint requests from TUI
|
|
642
|
+
if getattr(session_state, "_ralph_stop_requested", False):
|
|
643
|
+
session_state._ralph_stop_requested = False
|
|
644
|
+
break
|
|
645
|
+
|
|
646
|
+
if getattr(session_state, "_ralph_checkpoint_requested", False):
|
|
647
|
+
session_state._ralph_checkpoint_requested = False
|
|
648
|
+
_save_ralph_checkpoint(
|
|
649
|
+
task=task,
|
|
650
|
+
max_iterations=max_iterations,
|
|
651
|
+
completed_iterations=iteration - 1,
|
|
652
|
+
working_directory=working_directory,
|
|
653
|
+
notes="Checkpoint requested by user (background mode)",
|
|
654
|
+
)
|
|
655
|
+
emit(f"[green]✓ Saved Ralph checkpoint at iteration {iteration - 1}[/green]")
|
|
656
|
+
break
|
|
657
|
+
|
|
658
|
+
task_id = str(uuid.uuid4())
|
|
659
|
+
iters_str = f"{iteration}/{max_iterations}" if max_iterations > 0 else str(
|
|
660
|
+
iteration,
|
|
661
|
+
)
|
|
662
|
+
iter_display = iters_str
|
|
663
|
+
|
|
664
|
+
bg_task = BackgroundRalphTask(
|
|
665
|
+
task_id=task_id,
|
|
666
|
+
iteration=iteration,
|
|
667
|
+
max_iterations=max_iterations,
|
|
668
|
+
task_description=task,
|
|
669
|
+
working_directory=working_directory,
|
|
670
|
+
)
|
|
671
|
+
session_state.background_ralph_tasks[task_id] = bg_task
|
|
672
|
+
|
|
673
|
+
_emit_event(
|
|
674
|
+
on_event,
|
|
675
|
+
rev.IterationStarted(iteration=iteration, max_iterations=max_iterations),
|
|
676
|
+
lambda disp=iter_display, tid=task_id: emit(
|
|
677
|
+
f"[dim]\u2192 iteration {disp} started ({tid[:8]})[/dim]"
|
|
678
|
+
),
|
|
679
|
+
)
|
|
680
|
+
|
|
681
|
+
sig_before = _git_change_signature(working_directory)
|
|
682
|
+
prompt = render_template(
|
|
683
|
+
"ralph_iteration.jinja",
|
|
684
|
+
iteration_display=iter_display,
|
|
685
|
+
task=task,
|
|
686
|
+
conversation_context=conversation_context,
|
|
687
|
+
progress_notes=_read_ralph_progress(),
|
|
688
|
+
progress_path=RALPH_PROGRESS_PATH,
|
|
689
|
+
**_ralph_render_extras(no_change_streak, last_verify),
|
|
690
|
+
)
|
|
691
|
+
|
|
692
|
+
try:
|
|
693
|
+
await execute_task(
|
|
694
|
+
prompt,
|
|
695
|
+
agent,
|
|
696
|
+
"ralph", # display the agent as "Ralph"
|
|
697
|
+
session_state,
|
|
698
|
+
token_tracker,
|
|
699
|
+
backend=backend,
|
|
700
|
+
)
|
|
701
|
+
bg_task.status = RalphTaskStatus.COMPLETED
|
|
702
|
+
bg_task.completed_at = datetime.now(UTC)
|
|
703
|
+
elapsed = (bg_task.completed_at - bg_task.created_at).total_seconds()
|
|
704
|
+
_emit_event(
|
|
705
|
+
on_event,
|
|
706
|
+
rev.IterationFinished(
|
|
707
|
+
iteration=iteration,
|
|
708
|
+
max_iterations=max_iterations,
|
|
709
|
+
ok=True,
|
|
710
|
+
elapsed=elapsed,
|
|
711
|
+
),
|
|
712
|
+
lambda disp=iter_display, el=elapsed: emit(
|
|
713
|
+
f"[green]\u2713 iteration {disp} done[/green] [dim]({el:.1f}s)[/dim]"
|
|
714
|
+
),
|
|
715
|
+
)
|
|
716
|
+
except Exception as e:
|
|
717
|
+
bg_task.status = RalphTaskStatus.FAILED
|
|
718
|
+
bg_task.error_message = str(e)
|
|
719
|
+
bg_task.completed_at = datetime.now(UTC)
|
|
720
|
+
elapsed = (bg_task.completed_at - bg_task.created_at).total_seconds()
|
|
721
|
+
err = str(e)[:100] + "..." if len(str(e)) > 100 else str(e)
|
|
722
|
+
_emit_event(
|
|
723
|
+
on_event,
|
|
724
|
+
rev.IterationFinished(
|
|
725
|
+
iteration=iteration,
|
|
726
|
+
max_iterations=max_iterations,
|
|
727
|
+
ok=False,
|
|
728
|
+
elapsed=elapsed,
|
|
729
|
+
error=err,
|
|
730
|
+
),
|
|
731
|
+
lambda disp=iter_display, msg=err: emit(
|
|
732
|
+
f"[red]\u2717 iteration {disp} failed: {escape(msg)}[/red]"
|
|
733
|
+
),
|
|
734
|
+
)
|
|
735
|
+
|
|
736
|
+
iteration += 1
|
|
737
|
+
|
|
738
|
+
decision, decision_reason, no_change_streak, last_verify = _ralph_evaluate(
|
|
739
|
+
working_directory, sig_before, no_change_streak
|
|
740
|
+
)
|
|
741
|
+
if decision in ("complete", "stuck"):
|
|
742
|
+
style = "green" if decision == "complete" else "yellow"
|
|
743
|
+
label = "Task complete" if decision == "complete" else "Stopped — no progress"
|
|
744
|
+
emit(f"[{style}]{label}.[/{style}] [dim]{decision_reason}[/dim]")
|
|
745
|
+
_emit_event(
|
|
746
|
+
on_event,
|
|
747
|
+
rev.RalphFinished(
|
|
748
|
+
completed=iteration - 1, failed=0, total=iteration - 1, reason=decision
|
|
749
|
+
),
|
|
750
|
+
lambda: None,
|
|
751
|
+
)
|
|
752
|
+
break
|
|
753
|
+
except asyncio.CancelledError:
|
|
754
|
+
_save_ralph_checkpoint(
|
|
755
|
+
task=task,
|
|
756
|
+
max_iterations=max_iterations,
|
|
757
|
+
completed_iterations=iteration - 1,
|
|
758
|
+
working_directory=working_directory,
|
|
759
|
+
notes="Cancelled (background mode)",
|
|
760
|
+
)
|
|
761
|
+
iter_n = iteration - 1
|
|
762
|
+
emit(f"[yellow]\u2713 Saved checkpoint at iteration {iter_n} before cancel[/yellow]")
|
|
763
|
+
raise
|
|
764
|
+
finally:
|
|
765
|
+
total_tasks = len(session_state.background_ralph_tasks)
|
|
766
|
+
completed = sum(
|
|
767
|
+
1
|
|
768
|
+
for t in session_state.background_ralph_tasks.values()
|
|
769
|
+
if t.status == RalphTaskStatus.COMPLETED
|
|
770
|
+
)
|
|
771
|
+
failed = sum(
|
|
772
|
+
1
|
|
773
|
+
for t in session_state.background_ralph_tasks.values()
|
|
774
|
+
if t.status == RalphTaskStatus.FAILED
|
|
775
|
+
)
|
|
776
|
+
|
|
777
|
+
def _summary() -> None:
|
|
778
|
+
emit("")
|
|
779
|
+
emit(
|
|
780
|
+
f"[bold]📊 Ralph background summary[/bold] — "
|
|
781
|
+
f"{completed} completed, {failed} failed of {total_tasks} task(s)"
|
|
782
|
+
)
|
|
783
|
+
|
|
784
|
+
_emit_event(
|
|
785
|
+
on_event,
|
|
786
|
+
rev.RalphFinished(
|
|
787
|
+
completed=completed,
|
|
788
|
+
failed=failed,
|
|
789
|
+
total=total_tasks,
|
|
790
|
+
reason="background",
|
|
791
|
+
),
|
|
792
|
+
_summary,
|
|
793
|
+
)
|
|
794
|
+
|
|
795
|
+
try:
|
|
796
|
+
session_state.add_notification(
|
|
797
|
+
level="error" if failed and not completed else ("warning" if failed else "success"),
|
|
798
|
+
title="Ralph background run finished",
|
|
799
|
+
message=f"{completed} completed, {failed} failed of {total_tasks} task(s)",
|
|
800
|
+
source="ralph",
|
|
801
|
+
)
|
|
802
|
+
except Exception:
|
|
803
|
+
pass
|
|
804
|
+
|
|
805
|
+
session_state.auto_approve = original_auto_approve
|
|
806
|
+
|
|
807
|
+
|
|
808
|
+
def _print_ralph_usage(emit: EmitFn) -> None:
|
|
809
|
+
"""Emit the /ralph usage help."""
|
|
810
|
+
emit("")
|
|
811
|
+
emit("[yellow]Usage: /ralph <task> [--iterations N][/yellow]")
|
|
812
|
+
emit("[yellow] /ralph --resume[/yellow]")
|
|
813
|
+
emit("[yellow] /ralph --status[/yellow]")
|
|
814
|
+
emit("")
|
|
815
|
+
emit("[dim]Example: /ralph Fix the bug in auth.py --iterations 5[/dim]")
|
|
816
|
+
emit("[dim] /ralph Implement the feature described in issue #42[/dim]")
|
|
817
|
+
emit("[dim] /ralph --resume (continue from last checkpoint)[/dim]")
|
|
818
|
+
emit("[dim] /ralph --status (check running background tasks)[/dim]")
|
|
819
|
+
emit("")
|
|
820
|
+
emit("[bold]Options:[/bold]")
|
|
821
|
+
emit(" --iterations N, -i N Maximum number of iterations (default: 5)")
|
|
822
|
+
emit(" --background Run iterations in background (non-blocking)")
|
|
823
|
+
emit(" --resume Resume from last saved checkpoint")
|
|
824
|
+
emit(" --status Show status of background ralph tasks")
|
|
825
|
+
emit("")
|
|
826
|
+
emit("[dim]Ralph mode runs autonomously, making progress each iteration.[/dim]")
|
|
827
|
+
emit("[dim]Press Ctrl+C to choose: Stop, Finish iteration, Continue, or Checkpoint.[/dim]")
|
|
828
|
+
emit("")
|
|
829
|
+
|
|
830
|
+
|
|
831
|
+
def _emit_ralph_header(
|
|
832
|
+
emit: EmitFn,
|
|
833
|
+
*,
|
|
834
|
+
task: str,
|
|
835
|
+
max_iterations: int,
|
|
836
|
+
background_mode: bool,
|
|
837
|
+
resumed_from: int | None = None,
|
|
838
|
+
) -> None:
|
|
839
|
+
"""Emit the Ralph run header (replaces the old Rich Panel, works in both UIs)."""
|
|
840
|
+
title = "🔄 Ralph Mode (Resumed)" if resumed_from else "🔄 Ralph Mode"
|
|
841
|
+
iters = "Unlimited" if max_iterations == 0 else max_iterations
|
|
842
|
+
emit("")
|
|
843
|
+
emit(f"[bold {COLORS['primary']}]{title}[/bold {COLORS['primary']}]")
|
|
844
|
+
emit(f"[bold]Task:[/bold] {escape(task)}")
|
|
845
|
+
emit(f"[bold]Max Iterations:[/bold] {iters}")
|
|
846
|
+
if resumed_from:
|
|
847
|
+
emit(f"[bold]Resuming from:[/bold] Iteration {resumed_from}")
|
|
848
|
+
if background_mode:
|
|
849
|
+
emit("[bold]Mode:[/bold] Background (non-blocking)")
|
|
850
|
+
emit("")
|
|
851
|
+
if background_mode:
|
|
852
|
+
emit("[dim]Background mode enabled. Iterations will run asynchronously.[/dim]")
|
|
853
|
+
emit("[dim]Press Ctrl+C to stop at any time.[/dim]")
|
|
854
|
+
emit("")
|
|
855
|
+
|
|
856
|
+
|
|
857
|
+
async def handle_ralph_command(
|
|
858
|
+
agent,
|
|
859
|
+
session_state,
|
|
860
|
+
assistant_id: str,
|
|
861
|
+
token_tracker: TokenTracker,
|
|
862
|
+
cmd_args: str | list[str] | None,
|
|
863
|
+
execute_fn=None,
|
|
864
|
+
emit: EmitFn | None = None,
|
|
865
|
+
on_event: EventFn | None = None,
|
|
866
|
+
) -> bool:
|
|
867
|
+
"""Handle /ralph command - autonomous looping mode.
|
|
868
|
+
|
|
869
|
+
Usage:
|
|
870
|
+
/ralph <task> - Run autonomously (unlimited iterations)
|
|
871
|
+
/ralph <task> --iterations N - Run with max N iterations
|
|
872
|
+
/ralph <task> -i N - Shorthand for --iterations
|
|
873
|
+
/ralph <task> --background - Run iterations in background (non-blocking)
|
|
874
|
+
/ralph --resume - Resume from last checkpoint
|
|
875
|
+
/ralph --status - Show status of running background tasks
|
|
876
|
+
|
|
877
|
+
``emit`` is the markup UI sink (defaults to the console). ``on_event`` is an
|
|
878
|
+
optional structured-progress sink: when provided (the TUI passes one), the
|
|
879
|
+
run's milestones render as native widgets instead of the markup ``emit``
|
|
880
|
+
fallback. The CLI leaves it ``None`` and keeps its existing output.
|
|
881
|
+
"""
|
|
882
|
+
if emit is None:
|
|
883
|
+
emit = _console_emit
|
|
884
|
+
if execute_fn is None:
|
|
885
|
+
from novacode_cli.ui.execution import execute_task
|
|
886
|
+
|
|
887
|
+
execute_fn = execute_task
|
|
888
|
+
|
|
889
|
+
if not cmd_args:
|
|
890
|
+
_print_ralph_usage(emit)
|
|
891
|
+
return True
|
|
892
|
+
|
|
893
|
+
# Normalize args to a list.
|
|
894
|
+
if isinstance(cmd_args, str):
|
|
895
|
+
cmd_args = cmd_args.split()
|
|
896
|
+
elif not cmd_args:
|
|
897
|
+
cmd_args = []
|
|
898
|
+
|
|
899
|
+
# --status short-circuit.
|
|
900
|
+
if cmd_args and len(cmd_args) == 1 and cmd_args[0] == "--status":
|
|
901
|
+
return await handle_ralph_status(session_state, emit, on_event)
|
|
902
|
+
|
|
903
|
+
# Parse task, iterations, resume flag, and background mode.
|
|
904
|
+
max_iterations = 5
|
|
905
|
+
background_mode = False
|
|
906
|
+
resume_mode = False
|
|
907
|
+
task_parts: list[str] = []
|
|
908
|
+
i = 0
|
|
909
|
+
while i < len(cmd_args):
|
|
910
|
+
arg = cmd_args[i]
|
|
911
|
+
if arg == "--resume":
|
|
912
|
+
resume_mode = True
|
|
913
|
+
i += 1
|
|
914
|
+
continue
|
|
915
|
+
if arg == "--background":
|
|
916
|
+
background_mode = True
|
|
917
|
+
i += 1
|
|
918
|
+
continue
|
|
919
|
+
if arg in ("--iterations", "-i"):
|
|
920
|
+
if i + 1 < len(cmd_args) and cmd_args[i + 1].isdigit():
|
|
921
|
+
max_iterations = int(cmd_args[i + 1])
|
|
922
|
+
i += 2
|
|
923
|
+
continue
|
|
924
|
+
emit("")
|
|
925
|
+
emit("[red]Error: --iterations requires a number[/red]")
|
|
926
|
+
emit("[dim]Example: /ralph task --iterations 5[/dim]")
|
|
927
|
+
emit("")
|
|
928
|
+
return True
|
|
929
|
+
task_parts.append(arg)
|
|
930
|
+
i += 1
|
|
931
|
+
|
|
932
|
+
task = " ".join(task_parts)
|
|
933
|
+
|
|
934
|
+
# Resume mode.
|
|
935
|
+
if resume_mode:
|
|
936
|
+
checkpoint = _load_ralph_checkpoint()
|
|
937
|
+
if not checkpoint:
|
|
938
|
+
emit("")
|
|
939
|
+
emit("[red]No checkpoint found to resume.[/red]")
|
|
940
|
+
emit("[dim]Start a new ralph session first: /ralph <task>[/dim]")
|
|
941
|
+
emit("")
|
|
942
|
+
return True
|
|
943
|
+
|
|
944
|
+
task = checkpoint["task"]
|
|
945
|
+
max_iterations = checkpoint["max_iterations"]
|
|
946
|
+
start_iteration = checkpoint["completed_iterations"] + 1
|
|
947
|
+
working_directory = checkpoint.get("working_directory", os.getcwd())
|
|
948
|
+
|
|
949
|
+
_emit_event(
|
|
950
|
+
on_event,
|
|
951
|
+
rev.RalphStarted(
|
|
952
|
+
task=task,
|
|
953
|
+
max_iterations=max_iterations,
|
|
954
|
+
background=background_mode,
|
|
955
|
+
resumed_from=start_iteration,
|
|
956
|
+
),
|
|
957
|
+
lambda: _emit_ralph_header(
|
|
958
|
+
emit,
|
|
959
|
+
task=task,
|
|
960
|
+
max_iterations=max_iterations,
|
|
961
|
+
background_mode=background_mode,
|
|
962
|
+
resumed_from=start_iteration,
|
|
963
|
+
),
|
|
964
|
+
)
|
|
965
|
+
_clear_ralph_checkpoint()
|
|
966
|
+
else:
|
|
967
|
+
if not task:
|
|
968
|
+
emit("")
|
|
969
|
+
emit("[red]Error: No task specified[/red]")
|
|
970
|
+
emit("[dim]Usage: /ralph <task> [--iterations N][/dim]")
|
|
971
|
+
emit("[dim] /ralph --resume[/dim]")
|
|
972
|
+
emit("")
|
|
973
|
+
return True
|
|
974
|
+
|
|
975
|
+
start_iteration = 1
|
|
976
|
+
working_directory = os.getcwd()
|
|
977
|
+
_emit_event(
|
|
978
|
+
on_event,
|
|
979
|
+
rev.RalphStarted(
|
|
980
|
+
task=task,
|
|
981
|
+
max_iterations=max_iterations,
|
|
982
|
+
background=background_mode,
|
|
983
|
+
),
|
|
984
|
+
lambda: _emit_ralph_header(
|
|
985
|
+
emit,
|
|
986
|
+
task=task,
|
|
987
|
+
max_iterations=max_iterations,
|
|
988
|
+
background_mode=background_mode,
|
|
989
|
+
),
|
|
990
|
+
)
|
|
991
|
+
|
|
992
|
+
# Resolve backend from the agent.
|
|
993
|
+
backend = None
|
|
994
|
+
if hasattr(agent, "backend"):
|
|
995
|
+
backend = agent.backend
|
|
996
|
+
elif hasattr(agent, "graph") and hasattr(agent.graph, "backend"):
|
|
997
|
+
backend = agent.graph.backend
|
|
998
|
+
|
|
999
|
+
# Background mode: one thread runs all iterations sequentially.
|
|
1000
|
+
if background_mode:
|
|
1001
|
+
background_thread = threading.Thread(
|
|
1002
|
+
target=_run_background_ralph_in_thread,
|
|
1003
|
+
args=(
|
|
1004
|
+
task,
|
|
1005
|
+
start_iteration,
|
|
1006
|
+
max_iterations,
|
|
1007
|
+
agent,
|
|
1008
|
+
assistant_id,
|
|
1009
|
+
session_state,
|
|
1010
|
+
token_tracker,
|
|
1011
|
+
working_directory,
|
|
1012
|
+
backend,
|
|
1013
|
+
emit,
|
|
1014
|
+
on_event,
|
|
1015
|
+
),
|
|
1016
|
+
daemon=True,
|
|
1017
|
+
)
|
|
1018
|
+
if not hasattr(session_state, "_background_threads"):
|
|
1019
|
+
session_state._background_threads = []
|
|
1020
|
+
session_state._background_threads.append(background_thread)
|
|
1021
|
+
background_thread.start()
|
|
1022
|
+
|
|
1023
|
+
emit("")
|
|
1024
|
+
emit("[green]✓ Background execution started[/green]")
|
|
1025
|
+
emit("[dim]Iterations will progress asynchronously in the background.[/dim]")
|
|
1026
|
+
emit("[dim]Check progress with: /ralph --status[/dim]")
|
|
1027
|
+
emit("")
|
|
1028
|
+
return True
|
|
1029
|
+
|
|
1030
|
+
# Foreground mode: run iterations synchronously.
|
|
1031
|
+
stop_after_iteration = False
|
|
1032
|
+
interrupted = False
|
|
1033
|
+
|
|
1034
|
+
original_auto_approve = session_state.auto_approve
|
|
1035
|
+
session_state.auto_approve = True
|
|
1036
|
+
|
|
1037
|
+
# Ground the loop in the prior conversation (read once before iterating).
|
|
1038
|
+
conversation_context = ""
|
|
1039
|
+
try:
|
|
1040
|
+
from novacode_cli.context import ContextManager
|
|
1041
|
+
|
|
1042
|
+
conversation_context = await ContextManager().digest(agent, session_state.thread_id)
|
|
1043
|
+
except Exception:
|
|
1044
|
+
conversation_context = ""
|
|
1045
|
+
|
|
1046
|
+
_ensure_ralph_dir()
|
|
1047
|
+
iteration = start_iteration
|
|
1048
|
+
# Smart-loop state, carried across iterations.
|
|
1049
|
+
no_change_streak = 0
|
|
1050
|
+
last_verify: _VerifyResult | None = None
|
|
1051
|
+
sig_before = ""
|
|
1052
|
+
|
|
1053
|
+
try:
|
|
1054
|
+
try:
|
|
1055
|
+
while max_iterations == 0 or iteration <= max_iterations:
|
|
1056
|
+
if getattr(session_state, "_ralph_stop_requested", False):
|
|
1057
|
+
session_state._ralph_stop_requested = False
|
|
1058
|
+
done = iteration - 1
|
|
1059
|
+
|
|
1060
|
+
def _finished_stop(done: int = done) -> None:
|
|
1061
|
+
emit("")
|
|
1062
|
+
emit("[yellow]Ralph mode stopped by user.[/yellow]")
|
|
1063
|
+
emit(f"[dim]Completed {done} iteration(s).[/dim]")
|
|
1064
|
+
emit("")
|
|
1065
|
+
|
|
1066
|
+
_emit_event(
|
|
1067
|
+
on_event,
|
|
1068
|
+
rev.RalphFinished(completed=done, failed=0, total=done, reason="stopped"),
|
|
1069
|
+
_finished_stop,
|
|
1070
|
+
)
|
|
1071
|
+
return True
|
|
1072
|
+
|
|
1073
|
+
if getattr(session_state, "_ralph_checkpoint_requested", False):
|
|
1074
|
+
session_state._ralph_checkpoint_requested = False
|
|
1075
|
+
done = iteration - 1
|
|
1076
|
+
_save_ralph_checkpoint(
|
|
1077
|
+
task=task,
|
|
1078
|
+
max_iterations=max_iterations,
|
|
1079
|
+
completed_iterations=done,
|
|
1080
|
+
working_directory=working_directory,
|
|
1081
|
+
notes="Checkpoint requested by user",
|
|
1082
|
+
)
|
|
1083
|
+
|
|
1084
|
+
def _finished_checkpoint(done: int = done) -> None:
|
|
1085
|
+
emit("")
|
|
1086
|
+
emit(f"[green]✓ Saved Ralph checkpoint at iteration {done}[/green]")
|
|
1087
|
+
emit(f"[dim]Completed {done} iteration(s). Run stopped.[/dim]")
|
|
1088
|
+
emit("")
|
|
1089
|
+
|
|
1090
|
+
_emit_event(
|
|
1091
|
+
on_event,
|
|
1092
|
+
rev.RalphFinished(
|
|
1093
|
+
completed=done, failed=0, total=done, reason="checkpoint"
|
|
1094
|
+
),
|
|
1095
|
+
_finished_checkpoint,
|
|
1096
|
+
)
|
|
1097
|
+
return True
|
|
1098
|
+
|
|
1099
|
+
iters_str = f"{iteration}/{max_iterations}" if max_iterations > 0 else str(
|
|
1100
|
+
iteration,
|
|
1101
|
+
)
|
|
1102
|
+
iter_display = iters_str
|
|
1103
|
+
|
|
1104
|
+
def _banner(display: str = iter_display) -> None:
|
|
1105
|
+
emit("")
|
|
1106
|
+
emit(f"[bold cyan]{'─' * 50}[/bold cyan]")
|
|
1107
|
+
emit(f"[bold cyan]Iteration {display}[/bold cyan]")
|
|
1108
|
+
emit(f"[bold cyan]{'─' * 50}[/bold cyan]")
|
|
1109
|
+
emit("")
|
|
1110
|
+
|
|
1111
|
+
_emit_event(
|
|
1112
|
+
on_event,
|
|
1113
|
+
rev.IterationStarted(iteration=iteration, max_iterations=max_iterations),
|
|
1114
|
+
_banner,
|
|
1115
|
+
)
|
|
1116
|
+
iter_start = datetime.now(UTC)
|
|
1117
|
+
|
|
1118
|
+
sig_before = _git_change_signature(working_directory)
|
|
1119
|
+
prompt = render_template(
|
|
1120
|
+
"ralph_iteration.jinja",
|
|
1121
|
+
iteration_display=iter_display,
|
|
1122
|
+
task=task,
|
|
1123
|
+
conversation_context=conversation_context,
|
|
1124
|
+
progress_notes=_read_ralph_progress(),
|
|
1125
|
+
progress_path=RALPH_PROGRESS_PATH,
|
|
1126
|
+
**_ralph_render_extras(no_change_streak, last_verify),
|
|
1127
|
+
)
|
|
1128
|
+
|
|
1129
|
+
# The agent run streams natively through execute_fn.
|
|
1130
|
+
await execute_fn(
|
|
1131
|
+
prompt,
|
|
1132
|
+
agent,
|
|
1133
|
+
"ralph", # display the agent as "Ralph"
|
|
1134
|
+
session_state,
|
|
1135
|
+
token_tracker,
|
|
1136
|
+
backend=backend,
|
|
1137
|
+
)
|
|
1138
|
+
|
|
1139
|
+
# The iteration completed (a HITL interrupt would have broken the loop
|
|
1140
|
+
# before here). Report it; the trailing markup "Continuing…" line below
|
|
1141
|
+
# remains the CLI-only cue between iterations.
|
|
1142
|
+
elapsed = (datetime.now(UTC) - iter_start).total_seconds()
|
|
1143
|
+
_emit_event(
|
|
1144
|
+
on_event,
|
|
1145
|
+
rev.IterationFinished(
|
|
1146
|
+
iteration=iteration,
|
|
1147
|
+
max_iterations=max_iterations,
|
|
1148
|
+
ok=True,
|
|
1149
|
+
elapsed=elapsed,
|
|
1150
|
+
),
|
|
1151
|
+
lambda: None,
|
|
1152
|
+
)
|
|
1153
|
+
|
|
1154
|
+
iteration += 1
|
|
1155
|
+
|
|
1156
|
+
decision, decision_reason, no_change_streak, last_verify = _ralph_evaluate(
|
|
1157
|
+
working_directory, sig_before, no_change_streak
|
|
1158
|
+
)
|
|
1159
|
+
if decision in ("complete", "stuck"):
|
|
1160
|
+
done = iteration - 1
|
|
1161
|
+
|
|
1162
|
+
def _finished_smart(
|
|
1163
|
+
done: int = done,
|
|
1164
|
+
decision: str = decision,
|
|
1165
|
+
reason: str = decision_reason,
|
|
1166
|
+
) -> None:
|
|
1167
|
+
style = "green" if decision == "complete" else "yellow"
|
|
1168
|
+
label = (
|
|
1169
|
+
"Task complete"
|
|
1170
|
+
if decision == "complete"
|
|
1171
|
+
else "Ralph stopped — no progress"
|
|
1172
|
+
)
|
|
1173
|
+
emit("")
|
|
1174
|
+
emit(f"[{style}]{label}.[/{style}] [dim]{reason}[/dim]")
|
|
1175
|
+
emit(f"[dim]Completed {done} iteration(s).[/dim]")
|
|
1176
|
+
emit("")
|
|
1177
|
+
|
|
1178
|
+
_emit_event(
|
|
1179
|
+
on_event,
|
|
1180
|
+
rev.RalphFinished(
|
|
1181
|
+
completed=done, failed=0, total=done, reason=decision
|
|
1182
|
+
),
|
|
1183
|
+
_finished_smart,
|
|
1184
|
+
)
|
|
1185
|
+
return True
|
|
1186
|
+
|
|
1187
|
+
if stop_after_iteration:
|
|
1188
|
+
done = iteration - 1
|
|
1189
|
+
|
|
1190
|
+
def _finished_stop(done: int = done) -> None:
|
|
1191
|
+
emit("")
|
|
1192
|
+
emit("[green]Finished current iteration. Stopping as requested.[/green]")
|
|
1193
|
+
emit(f"[dim]Completed {done} iteration(s).[/dim]")
|
|
1194
|
+
emit("")
|
|
1195
|
+
|
|
1196
|
+
_emit_event(
|
|
1197
|
+
on_event,
|
|
1198
|
+
rev.RalphFinished(completed=done, failed=0, total=done, reason="finished"),
|
|
1199
|
+
_finished_stop,
|
|
1200
|
+
)
|
|
1201
|
+
return True
|
|
1202
|
+
|
|
1203
|
+
if (max_iterations == 0 or iteration <= max_iterations) and on_event is None:
|
|
1204
|
+
# CLI-only inter-iteration cue; the TUI shows it via the cards.
|
|
1205
|
+
emit("")
|
|
1206
|
+
emit(f"[dim]Completed iteration {iteration - 1}. Continuing...[/dim]")
|
|
1207
|
+
|
|
1208
|
+
except asyncio.CancelledError:
|
|
1209
|
+
done = iteration - 1
|
|
1210
|
+
|
|
1211
|
+
def _cancelled_stop(done: int = done) -> None:
|
|
1212
|
+
emit("")
|
|
1213
|
+
emit("[yellow]Ralph mode stopped by user.[/yellow]")
|
|
1214
|
+
emit(f"[dim]Completed {done} iteration(s).[/dim]")
|
|
1215
|
+
emit("")
|
|
1216
|
+
|
|
1217
|
+
_emit_event(
|
|
1218
|
+
on_event,
|
|
1219
|
+
rev.RalphFinished(completed=done, failed=0, total=done, reason="stopped"),
|
|
1220
|
+
_cancelled_stop,
|
|
1221
|
+
)
|
|
1222
|
+
return True
|
|
1223
|
+
except KeyboardInterrupt:
|
|
1224
|
+
if on_event is not None:
|
|
1225
|
+
done = iteration - 1
|
|
1226
|
+
|
|
1227
|
+
def _tui_stop(done: int = done) -> None:
|
|
1228
|
+
emit("")
|
|
1229
|
+
emit("[yellow]Ralph mode stopped by user.[/yellow]")
|
|
1230
|
+
emit(f"[dim]Completed {done} iteration(s).[/dim]")
|
|
1231
|
+
emit("")
|
|
1232
|
+
|
|
1233
|
+
_emit_event(
|
|
1234
|
+
on_event,
|
|
1235
|
+
rev.RalphFinished(completed=done, failed=0, total=done, reason="stopped"),
|
|
1236
|
+
_tui_stop,
|
|
1237
|
+
)
|
|
1238
|
+
return True
|
|
1239
|
+
interrupted = True
|
|
1240
|
+
|
|
1241
|
+
if interrupted:
|
|
1242
|
+
# The console REPL was removed and the TUI always passes ``on_event``
|
|
1243
|
+
# (handled above), so this path is unreachable in practice. Default to
|
|
1244
|
+
# a clean stop rather than prompting for an action.
|
|
1245
|
+
emit("")
|
|
1246
|
+
emit("[dim]Ralph mode stopped (no interactive UI available).[/dim]")
|
|
1247
|
+
emit(f"[dim]Completed {iteration - 1} iteration(s).[/dim]")
|
|
1248
|
+
emit("")
|
|
1249
|
+
return True
|
|
1250
|
+
|
|
1251
|
+
done = iteration - 1
|
|
1252
|
+
|
|
1253
|
+
def _finished_ok(done: int = done) -> None:
|
|
1254
|
+
emit("")
|
|
1255
|
+
emit(f"[green]Ralph mode completed after {done} iteration(s).[/green]")
|
|
1256
|
+
emit("")
|
|
1257
|
+
|
|
1258
|
+
_emit_event(
|
|
1259
|
+
on_event,
|
|
1260
|
+
rev.RalphFinished(completed=done, failed=0, total=done, reason="completed"),
|
|
1261
|
+
_finished_ok,
|
|
1262
|
+
)
|
|
1263
|
+
|
|
1264
|
+
try:
|
|
1265
|
+
session_state.add_notification(
|
|
1266
|
+
level="success",
|
|
1267
|
+
title="Ralph mode completed",
|
|
1268
|
+
message=f"{escape(task[:80])} — {iteration - 1} iteration(s)",
|
|
1269
|
+
source="ralph",
|
|
1270
|
+
)
|
|
1271
|
+
except Exception:
|
|
1272
|
+
pass
|
|
1273
|
+
|
|
1274
|
+
return True
|
|
1275
|
+
finally:
|
|
1276
|
+
session_state.auto_approve = original_auto_approve
|
|
1277
|
+
# Registry
|
|
1278
|
+
# ---------------------------------------------------------------------------
|
|
1279
|
+
|
|
1280
|
+
|
|
1281
|
+
def register_commands(registry) -> None:
|
|
1282
|
+
from novacode_cli.commands import CommandContext
|
|
1283
|
+
|
|
1284
|
+
async def _handle(ctx: CommandContext) -> bool:
|
|
1285
|
+
return await handle_ralph_command(
|
|
1286
|
+
ctx.agent,
|
|
1287
|
+
ctx.session_state,
|
|
1288
|
+
ctx.assistant_id,
|
|
1289
|
+
ctx.token_tracker,
|
|
1290
|
+
ctx.cmd_args,
|
|
1291
|
+
)
|
|
1292
|
+
|
|
1293
|
+
registry.register("ralph", _handle)
|