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.
Files changed (691) hide show
  1. novacode_cli/__init__.py +29 -0
  2. novacode_cli/__main__.py +6 -0
  3. novacode_cli/_lazy_heavy.py +99 -0
  4. novacode_cli/_version.py +3 -0
  5. novacode_cli/agent_stream.py +178 -0
  6. novacode_cli/agents/agent_file.py +250 -0
  7. novacode_cli/agents/agent_mailbox.py +120 -0
  8. novacode_cli/agents/approval_decisions.py +146 -0
  9. novacode_cli/agents/arg_repair.py +196 -0
  10. novacode_cli/agents/async_agents/__init__.py +6 -0
  11. novacode_cli/agents/async_agents/_config.py +213 -0
  12. novacode_cli/agents/async_agents/_mcp_tools.py +192 -0
  13. novacode_cli/agents/async_agents/_specialist.py +84 -0
  14. novacode_cli/agents/async_agents/_test_commands.py +89 -0
  15. novacode_cli/agents/async_agents/_tools.py +432 -0
  16. novacode_cli/agents/async_agents/general_purpose.py +42 -0
  17. novacode_cli/agents/async_agents/langgraph.json +9 -0
  18. novacode_cli/agents/async_agents/research.py +22 -0
  19. novacode_cli/agents/async_context.py +303 -0
  20. novacode_cli/agents/async_on_demand.py +52 -0
  21. novacode_cli/agents/async_task_errors.py +75 -0
  22. novacode_cli/agents/async_workspace.py +27 -0
  23. novacode_cli/agents/attribution.py +165 -0
  24. novacode_cli/agents/browser_mode.py +119 -0
  25. novacode_cli/agents/btw_agent.py +71 -0
  26. novacode_cli/agents/caveman.py +352 -0
  27. novacode_cli/agents/caveman_support.py +370 -0
  28. novacode_cli/agents/code_mode.py +774 -0
  29. novacode_cli/agents/code_runtime.py +160 -0
  30. novacode_cli/agents/context_compaction.py +1339 -0
  31. novacode_cli/agents/core_agent.py +2710 -0
  32. novacode_cli/agents/default_subagents/__init__.py +24 -0
  33. novacode_cli/agents/default_subagents/async_subagents.py +296 -0
  34. novacode_cli/agents/default_subagents/builtin/browser-automation-agent.md +110 -0
  35. novacode_cli/agents/default_subagents/builtin/bug-fix-agent.md +22 -0
  36. novacode_cli/agents/default_subagents/builtin/bug-investigation-agent.md +42 -0
  37. novacode_cli/agents/default_subagents/builtin/code-explorer.md +37 -0
  38. novacode_cli/agents/default_subagents/builtin/code-review-agent.md +33 -0
  39. novacode_cli/agents/default_subagents/builtin/dependency-audit-agent.md +34 -0
  40. novacode_cli/agents/default_subagents/builtin/documentation-update-agent.md +46 -0
  41. novacode_cli/agents/default_subagents/builtin/performance-audit-agent.md +41 -0
  42. novacode_cli/agents/default_subagents/builtin/plan-scout-agent.md +64 -0
  43. novacode_cli/agents/default_subagents/builtin/refactoring-agent.md +35 -0
  44. novacode_cli/agents/default_subagents/builtin/refactoring-specialist-agent.md +175 -0
  45. novacode_cli/agents/default_subagents/builtin/security-audit-agent.md +96 -0
  46. novacode_cli/agents/default_subagents/builtin/test-generation-agent.md +33 -0
  47. novacode_cli/agents/default_subagents/builtin/test-runner-agent.md +55 -0
  48. novacode_cli/agents/default_subagents/prompt.py +88 -0
  49. novacode_cli/agents/default_subagents/subagents.py +138 -0
  50. novacode_cli/agents/dream_agent.py +93 -0
  51. novacode_cli/agents/edit_diagnostics.py +362 -0
  52. novacode_cli/agents/edit_fallback.py +62 -0
  53. novacode_cli/agents/handoff.py +166 -0
  54. novacode_cli/agents/invocation.py +152 -0
  55. novacode_cli/agents/model_budget.py +42 -0
  56. novacode_cli/agents/model_retry.py +113 -0
  57. novacode_cli/agents/model_router.py +420 -0
  58. novacode_cli/agents/openai_decisions.py +186 -0
  59. novacode_cli/agents/plan_agent/__init__.py +12 -0
  60. novacode_cli/agents/plan_agent/plan_agent.py +357 -0
  61. novacode_cli/agents/plan_agent/plan_mode_middleware.py +64 -0
  62. novacode_cli/agents/plan_execution.py +237 -0
  63. novacode_cli/agents/ponytail.py +66 -0
  64. novacode_cli/agents/prime.py +274 -0
  65. novacode_cli/agents/provider_caching.py +99 -0
  66. novacode_cli/agents/server_launcher.py +904 -0
  67. novacode_cli/agents/strict_tools.py +384 -0
  68. novacode_cli/agents/task_discipline.py +294 -0
  69. novacode_cli/agents/tool_call_repair.py +290 -0
  70. novacode_cli/agents/tool_offload.py +291 -0
  71. novacode_cli/agents/tool_search.py +806 -0
  72. novacode_cli/agents/tool_search_variants.py +106 -0
  73. novacode_cli/agents/tool_verdicts.py +1194 -0
  74. novacode_cli/agents/user_async_agents.py +312 -0
  75. novacode_cli/artifacts/__init__.py +10 -0
  76. novacode_cli/artifacts/registry.py +278 -0
  77. novacode_cli/artifacts/server.py +426 -0
  78. novacode_cli/assets/Nova.png +0 -0
  79. novacode_cli/assets/nova-avatar.png +0 -0
  80. novacode_cli/audio/__init__.py +301 -0
  81. novacode_cli/audio/capture.py +137 -0
  82. novacode_cli/audio/downloads.py +273 -0
  83. novacode_cli/audio/pipeline.py +391 -0
  84. novacode_cli/audio/playback.py +87 -0
  85. novacode_cli/audio/providers.py +208 -0
  86. novacode_cli/audio/speakable.py +78 -0
  87. novacode_cli/audio/stt.py +132 -0
  88. novacode_cli/audio/stt_deepgram.py +69 -0
  89. novacode_cli/audio/stt_elevenlabs.py +89 -0
  90. novacode_cli/audio/stt_parakeet.py +94 -0
  91. novacode_cli/audio/stt_whistle.py +61 -0
  92. novacode_cli/audio/summarize.py +92 -0
  93. novacode_cli/audio/tts.py +85 -0
  94. novacode_cli/audio/tts_kokoro.py +73 -0
  95. novacode_cli/audio/tts_orpheus.py +180 -0
  96. novacode_cli/audio/tts_pocket.py +131 -0
  97. novacode_cli/audio/tts_sano.py +69 -0
  98. novacode_cli/audio/vad.py +145 -0
  99. novacode_cli/backends/__init__.py +17 -0
  100. novacode_cli/backends/filesystem.py +894 -0
  101. novacode_cli/backends/native_search.py +92 -0
  102. novacode_cli/bootstrap/__init__.py +9 -0
  103. novacode_cli/bootstrap/env_snapshot.py +240 -0
  104. novacode_cli/bootstrap/steering.py +464 -0
  105. novacode_cli/bootstrap/vision_router.py +604 -0
  106. novacode_cli/brand.py +362 -0
  107. novacode_cli/cli_args.py +718 -0
  108. novacode_cli/commands/__init__.py +237 -0
  109. novacode_cli/commands/agents_commands.py +231 -0
  110. novacode_cli/commands/auth_handler.py +40 -0
  111. novacode_cli/commands/browser_use_handler.py +75 -0
  112. novacode_cli/commands/cache_handler.py +32 -0
  113. novacode_cli/commands/chat_handler.py +1357 -0
  114. novacode_cli/commands/ci_fix.py +171 -0
  115. novacode_cli/commands/claude_plan.py +331 -0
  116. novacode_cli/commands/codex_plan.py +195 -0
  117. novacode_cli/commands/commands.py +1113 -0
  118. novacode_cli/commands/create_handler.py +124 -0
  119. novacode_cli/commands/create_server.py +1887 -0
  120. novacode_cli/commands/cron_handler.py +119 -0
  121. novacode_cli/commands/dream_handler.py +203 -0
  122. novacode_cli/commands/effort_handler.py +65 -0
  123. novacode_cli/commands/evolution_handler.py +214 -0
  124. novacode_cli/commands/file_commands.py +381 -0
  125. novacode_cli/commands/handoff_handler.py +68 -0
  126. novacode_cli/commands/hooks_handler.py +269 -0
  127. novacode_cli/commands/init_handler.py +146 -0
  128. novacode_cli/commands/learning_handler.py +160 -0
  129. novacode_cli/commands/lite_mode_handler.py +76 -0
  130. novacode_cli/commands/log_commands.py +363 -0
  131. novacode_cli/commands/mcp_handler.py +29 -0
  132. novacode_cli/commands/model_handler.py +29 -0
  133. novacode_cli/commands/notifications_handler.py +158 -0
  134. novacode_cli/commands/onboard_handler.py +121 -0
  135. novacode_cli/commands/plan_handler.py +440 -0
  136. novacode_cli/commands/planner_usage.py +250 -0
  137. novacode_cli/commands/plugin_install_handler.py +38 -0
  138. novacode_cli/commands/plugins_handler.py +35 -0
  139. novacode_cli/commands/prime_handler.py +455 -0
  140. novacode_cli/commands/prompt_handler.py +149 -0
  141. novacode_cli/commands/provider_usage.py +160 -0
  142. novacode_cli/commands/ralph_events.py +106 -0
  143. novacode_cli/commands/ralph_handler.py +1293 -0
  144. novacode_cli/commands/refine_handler.py +213 -0
  145. novacode_cli/commands/research_handler.py +202 -0
  146. novacode_cli/commands/rootapp_remote.py +83 -0
  147. novacode_cli/commands/router_handler.py +36 -0
  148. novacode_cli/commands/server_commands.py +249 -0
  149. novacode_cli/commands/session_commands.py +203 -0
  150. novacode_cli/commands/share_handler.py +450 -0
  151. novacode_cli/commands/side_commands.py +366 -0
  152. novacode_cli/commands/skill_invoke.py +420 -0
  153. novacode_cli/commands/skills_commands.py +48 -0
  154. novacode_cli/commands/trace_handler.py +322 -0
  155. novacode_cli/commands/trello_handler.py +226 -0
  156. novacode_cli/commands/trello_remote.py +177 -0
  157. novacode_cli/commands/trello_server.py +1214 -0
  158. novacode_cli/commands/vision_handler.py +127 -0
  159. novacode_cli/commands/voice_handler.py +447 -0
  160. novacode_cli/commands/webhook_handler.py +134 -0
  161. novacode_cli/commands/wiki_commands.py +227 -0
  162. novacode_cli/compaction.py +753 -0
  163. novacode_cli/computation_cache.py +159 -0
  164. novacode_cli/computer/__init__.py +1 -0
  165. novacode_cli/computer/persistent.py +234 -0
  166. novacode_cli/computer/preview.py +253 -0
  167. novacode_cli/computer/runtime.py +474 -0
  168. novacode_cli/computer/windows_console.py +152 -0
  169. novacode_cli/computer/windows_qemu.py +211 -0
  170. novacode_cli/config/browser_mode.py +159 -0
  171. novacode_cli/config/catalog_models.py +95 -0
  172. novacode_cli/config/config.py +1388 -0
  173. novacode_cli/config/credentials.py +540 -0
  174. novacode_cli/config/google_oauth_auth.py +281 -0
  175. novacode_cli/config/model_capabilities.py +343 -0
  176. novacode_cli/config/model_catalog.py +275 -0
  177. novacode_cli/config/model_create.py +1325 -0
  178. novacode_cli/config/model_manager.py +695 -0
  179. novacode_cli/config/nova_config.py +1283 -0
  180. novacode_cli/config/openai_chatgpt_auth.py +384 -0
  181. novacode_cli/config/opencode_gateway.py +25 -0
  182. novacode_cli/config/plan_mode.py +188 -0
  183. novacode_cli/config/provider_auth.py +438 -0
  184. novacode_cli/config/provider_catalog.json +5127 -0
  185. novacode_cli/config/provider_registry.py +38 -0
  186. novacode_cli/config/provider_transports.py +258 -0
  187. novacode_cli/config/role_models.py +175 -0
  188. novacode_cli/context/__init__.py +50 -0
  189. novacode_cli/context/_analysis.py +799 -0
  190. novacode_cli/context/_budget.py +116 -0
  191. novacode_cli/context/_conversation.py +73 -0
  192. novacode_cli/context/_dynamic.py +264 -0
  193. novacode_cli/context/_model_config.py +380 -0
  194. novacode_cli/context/_models_dev.py +99 -0
  195. novacode_cli/context/archives.py +248 -0
  196. novacode_cli/context/estimates.py +65 -0
  197. novacode_cli/context/history.py +17 -0
  198. novacode_cli/context/knowledge_cache.py +292 -0
  199. novacode_cli/context/manager.py +101 -0
  200. novacode_cli/context/observations.py +65 -0
  201. novacode_cli/context/pressure.py +168 -0
  202. novacode_cli/context/provider_accounting.py +109 -0
  203. novacode_cli/context/snapshot.py +493 -0
  204. novacode_cli/context/strategies.py +279 -0
  205. novacode_cli/context/task_progress.py +122 -0
  206. novacode_cli/core/__init__.py +0 -0
  207. novacode_cli/core/agent_loop.py +1821 -0
  208. novacode_cli/core/autonomous_loop.py +277 -0
  209. novacode_cli/core/code_approvals.py +57 -0
  210. novacode_cli/core/input_preparation.py +276 -0
  211. novacode_cli/core/reasoning.py +67 -0
  212. novacode_cli/core/streaming.py +326 -0
  213. novacode_cli/core/subagent_tasks.py +696 -0
  214. novacode_cli/core/subagent_tracking.py +235 -0
  215. novacode_cli/core/tool_results.py +116 -0
  216. novacode_cli/core/verification_loop.py +272 -0
  217. novacode_cli/council.py +595 -0
  218. novacode_cli/council_consensus.py +115 -0
  219. novacode_cli/council_decision.py +157 -0
  220. novacode_cli/council_planner.py +1421 -0
  221. novacode_cli/council_settings.py +208 -0
  222. novacode_cli/council_web_settings.py +41 -0
  223. novacode_cli/council_workspace.py +56 -0
  224. novacode_cli/cowork/__init__.py +10 -0
  225. novacode_cli/cowork/broker_middleware.py +162 -0
  226. novacode_cli/cowork/launcher.py +102 -0
  227. novacode_cli/cowork/policy.py +284 -0
  228. novacode_cli/cowork/ui.py +826 -0
  229. novacode_cli/daemons/__init__.py +1 -0
  230. novacode_cli/daemons/registry.py +342 -0
  231. novacode_cli/desktop_notifications.py +302 -0
  232. novacode_cli/doctor.py +251 -0
  233. novacode_cli/embeddings.py +109 -0
  234. novacode_cli/entrypoint.py +56 -0
  235. novacode_cli/errors/__init__.py +19 -0
  236. novacode_cli/errors/handlers.py +648 -0
  237. novacode_cli/errors/provider_errors.py +249 -0
  238. novacode_cli/errors/taxonomy.py +80 -0
  239. novacode_cli/events.py +179 -0
  240. novacode_cli/file_ops.py +714 -0
  241. novacode_cli/git_safety.py +281 -0
  242. novacode_cli/handoff.py +383 -0
  243. novacode_cli/headless/__init__.py +18 -0
  244. novacode_cli/headless/input.py +58 -0
  245. novacode_cli/headless/output.py +224 -0
  246. novacode_cli/headless/pipe.py +532 -0
  247. novacode_cli/headless/runner.py +461 -0
  248. novacode_cli/hermes/__init__.py +39 -0
  249. novacode_cli/hermes/activation.py +297 -0
  250. novacode_cli/hermes/config.py +129 -0
  251. novacode_cli/hermes/curator.py +199 -0
  252. novacode_cli/hermes/evolution.py +374 -0
  253. novacode_cli/hermes/ledger.py +364 -0
  254. novacode_cli/hermes/memory_tiers.py +969 -0
  255. novacode_cli/hermes/middleware.py +678 -0
  256. novacode_cli/hermes/overview.py +174 -0
  257. novacode_cli/hermes/prompt_evolution.py +503 -0
  258. novacode_cli/hermes/refine_loop.py +643 -0
  259. novacode_cli/hermes/refinement_log.py +190 -0
  260. novacode_cli/hermes/review.py +674 -0
  261. novacode_cli/hermes/skill_debate.py +135 -0
  262. novacode_cli/hermes/skill_discovery.py +450 -0
  263. novacode_cli/hermes/skill_manager.py +335 -0
  264. novacode_cli/hermes/skill_proposals.py +43 -0
  265. novacode_cli/hermes/test_gaming.py +119 -0
  266. novacode_cli/hermes/tracker.py +435 -0
  267. novacode_cli/hermes/tuner.py +206 -0
  268. novacode_cli/hermes/verification_memory.py +134 -0
  269. novacode_cli/hermes/verifier.py +277 -0
  270. novacode_cli/hitl/__init__.py +22 -0
  271. novacode_cli/hitl/interrupts.py +493 -0
  272. novacode_cli/hooks.py +359 -0
  273. novacode_cli/image_utils.py +517 -0
  274. novacode_cli/init/__init__.py +7 -0
  275. novacode_cli/init/events.py +43 -0
  276. novacode_cli/input_utils.py +526 -0
  277. novacode_cli/install_commands.py +87 -0
  278. novacode_cli/integrations/__init__.py +82 -0
  279. novacode_cli/integrations/daytona.py +122 -0
  280. novacode_cli/integrations/docker.py +309 -0
  281. novacode_cli/integrations/host_path.py +111 -0
  282. novacode_cli/integrations/langsmith.py +151 -0
  283. novacode_cli/integrations/modal.py +134 -0
  284. novacode_cli/integrations/runloop.py +130 -0
  285. novacode_cli/integrations/sandbox_factory.py +1388 -0
  286. novacode_cli/integrations/sandbox_registry.py +312 -0
  287. novacode_cli/integrations/workdir_backend.py +589 -0
  288. novacode_cli/main.py +2078 -0
  289. novacode_cli/mcp/__init__.py +73 -0
  290. novacode_cli/mcp/auth.py +189 -0
  291. novacode_cli/mcp/client.py +571 -0
  292. novacode_cli/mcp/code_mode.py +5 -0
  293. novacode_cli/mcp/code_runtime.py +5 -0
  294. novacode_cli/mcp/commands.py +902 -0
  295. novacode_cli/mcp/config.py +406 -0
  296. novacode_cli/mcp/generic.py +128 -0
  297. novacode_cli/mcp/middleware.py +993 -0
  298. novacode_cli/mcp/presets.py +367 -0
  299. novacode_cli/memory/__init__.py +1 -0
  300. novacode_cli/memory/agent_memory.py +1312 -0
  301. novacode_cli/memory/builtin_lessons.py +60 -0
  302. novacode_cli/memory/dream_gates.py +192 -0
  303. novacode_cli/memory/limits.py +59 -0
  304. novacode_cli/memory/parsed_cache.py +106 -0
  305. novacode_cli/memory/recall_stats.py +97 -0
  306. novacode_cli/memory/semantic.py +116 -0
  307. novacode_cli/memory/store.py +335 -0
  308. novacode_cli/memory/wiki.py +274 -0
  309. novacode_cli/migrate.py +185 -0
  310. novacode_cli/onboarding.py +649 -0
  311. novacode_cli/onboarding_check.py +119 -0
  312. novacode_cli/path_approval.py +297 -0
  313. novacode_cli/plan_archive.py +148 -0
  314. novacode_cli/plugins/__init__.py +121 -0
  315. novacode_cli/plugins/claude_plugins.py +538 -0
  316. novacode_cli/plugins/cli.py +168 -0
  317. novacode_cli/plugins/components.py +413 -0
  318. novacode_cli/plugins/hooks.py +356 -0
  319. novacode_cli/plugins/loader.py +317 -0
  320. novacode_cli/plugins/marketplaces.py +199 -0
  321. novacode_cli/plugins/storage.py +70 -0
  322. novacode_cli/prime.py +759 -0
  323. novacode_cli/prime_factory/__init__.py +15 -0
  324. novacode_cli/prime_factory/container.py +198 -0
  325. novacode_cli/prime_factory/controller.py +565 -0
  326. novacode_cli/prime_factory/knowledge.py +261 -0
  327. novacode_cli/prime_factory/publication.py +218 -0
  328. novacode_cli/prime_factory/recovery.py +50 -0
  329. novacode_cli/prime_factory/research.py +370 -0
  330. novacode_cli/prime_factory/runner.py +608 -0
  331. novacode_cli/prime_factory/runtime.py +261 -0
  332. novacode_cli/prime_factory/state.py +201 -0
  333. novacode_cli/prime_factory/store.py +128 -0
  334. novacode_cli/prime_factory/worker.py +129 -0
  335. novacode_cli/prime_factory/workflow.py +899 -0
  336. novacode_cli/prime_factory/workspace.py +317 -0
  337. novacode_cli/prime_memory.py +290 -0
  338. novacode_cli/process_manager.py +585 -0
  339. novacode_cli/project_onboard.py +537 -0
  340. novacode_cli/prompts/System_Prompt_Nova.jinja +23 -0
  341. novacode_cli/prompts/__init__.py +168 -0
  342. novacode_cli/prompts/agent_definitions.jinja +11 -0
  343. novacode_cli/prompts/agent_generation.jinja +125 -0
  344. novacode_cli/prompts/async_agents/general_purpose.jinja +22 -0
  345. novacode_cli/prompts/claude_plan_mode.jinja +12 -0
  346. novacode_cli/prompts/coding_workflow.jinja +18 -0
  347. novacode_cli/prompts/computer_use.jinja +17 -0
  348. novacode_cli/prompts/core_agent_system.jinja +81 -0
  349. novacode_cli/prompts/delegation.jinja +15 -0
  350. novacode_cli/prompts/desktop_power.jinja +4 -0
  351. novacode_cli/prompts/file_paths.jinja +15 -0
  352. novacode_cli/prompts/file_tracker.jinja +23 -0
  353. novacode_cli/prompts/init_agents_md.jinja +56 -0
  354. novacode_cli/prompts/init_exploration.jinja +174 -0
  355. novacode_cli/prompts/init_semantic_orchestrate.jinja +37 -0
  356. novacode_cli/prompts/instruction_scope.jinja +5 -0
  357. novacode_cli/prompts/learnings_extraction.jinja +45 -0
  358. novacode_cli/prompts/longterm_memory.jinja +54 -0
  359. novacode_cli/prompts/mcp.jinja +84 -0
  360. novacode_cli/prompts/memory_consolidation.jinja +40 -0
  361. novacode_cli/prompts/nova_evolution.jinja +73 -0
  362. novacode_cli/prompts/nova_review.jinja +158 -0
  363. novacode_cli/prompts/nova_skill_debate.jinja +36 -0
  364. novacode_cli/prompts/nova_standing_instructions.jinja +26 -0
  365. novacode_cli/prompts/nova_verify.jinja +100 -0
  366. novacode_cli/prompts/onboard_dashboard.jinja +378 -0
  367. novacode_cli/prompts/plan_agent.jinja +87 -0
  368. novacode_cli/prompts/plan_scouts.jinja +5 -0
  369. novacode_cli/prompts/plan_storage.jinja +8 -0
  370. novacode_cli/prompts/planning.jinja +82 -0
  371. novacode_cli/prompts/ponytail/LICENSE +21 -0
  372. novacode_cli/prompts/ponytail/UPSTREAM.json +15 -0
  373. novacode_cli/prompts/ponytail/hooks/ponytail-config.js +175 -0
  374. novacode_cli/prompts/ponytail/hooks/ponytail-instructions.js +98 -0
  375. novacode_cli/prompts/ponytail/skills/ponytail/SKILL.md +52 -0
  376. novacode_cli/prompts/ponytail/skills/ponytail-audit/SKILL.md +103 -0
  377. novacode_cli/prompts/ponytail/skills/ponytail-debt/SKILL.md +44 -0
  378. novacode_cli/prompts/ponytail/skills/ponytail-gain/SKILL.md +52 -0
  379. novacode_cli/prompts/ponytail/skills/ponytail-help/SKILL.md +76 -0
  380. novacode_cli/prompts/ponytail/skills/ponytail-review/SKILL.md +101 -0
  381. novacode_cli/prompts/prompt_evolution.jinja +27 -0
  382. novacode_cli/prompts/ralph_iteration.jinja +75 -0
  383. novacode_cli/prompts/refine_gate.jinja +31 -0
  384. novacode_cli/prompts/refine_plan.jinja +64 -0
  385. novacode_cli/prompts/refine_review.jinja +34 -0
  386. novacode_cli/prompts/research_delivery.jinja +9 -0
  387. novacode_cli/prompts/research_swarm.jinja +130 -0
  388. novacode_cli/prompts/response_style.jinja +5 -0
  389. novacode_cli/prompts/session_summarization.jinja +86 -0
  390. novacode_cli/prompts/skill_creation.jinja +85 -0
  391. novacode_cli/prompts/subagents/fact_checker.jinja +48 -0
  392. novacode_cli/prompts/subagents/financial_analyst.jinja +50 -0
  393. novacode_cli/prompts/subagents/literature_reviewer.jinja +52 -0
  394. novacode_cli/prompts/subagents/market_analyst.jinja +48 -0
  395. novacode_cli/prompts/subagents/research_synthesizer.jinja +57 -0
  396. novacode_cli/prompts/subagents/technical_researcher.jinja +56 -0
  397. novacode_cli/prompts/subagents/web_researcher.jinja +46 -0
  398. novacode_cli/prompts/summarization.jinja +107 -0
  399. novacode_cli/prompts/summarization_answers.jinja +23 -0
  400. novacode_cli/prompts/summarization_questions.jinja +32 -0
  401. novacode_cli/prompts/vision_caption.jinja +21 -0
  402. novacode_cli/prompts/voice_summary.jinja +65 -0
  403. novacode_cli/prompts/wiki_file.jinja +57 -0
  404. novacode_cli/prompts/wiki_ingest.jinja +87 -0
  405. novacode_cli/recovery.py +383 -0
  406. novacode_cli/remote/__init__.py +45 -0
  407. novacode_cli/remote/approvals.py +282 -0
  408. novacode_cli/remote/async_task_clients.py +97 -0
  409. novacode_cli/remote/async_task_watcher.py +240 -0
  410. novacode_cli/remote/bridge.py +905 -0
  411. novacode_cli/remote/command_menu.py +26 -0
  412. novacode_cli/remote/command_ui.py +243 -0
  413. novacode_cli/remote/config.py +199 -0
  414. novacode_cli/remote/discord_bridge.py +530 -0
  415. novacode_cli/remote/discord_format.py +31 -0
  416. novacode_cli/remote/discord_threads.py +225 -0
  417. novacode_cli/remote/images.py +97 -0
  418. novacode_cli/remote/processor.py +601 -0
  419. novacode_cli/remote/rootapp_bot/bot.cjs +16 -0
  420. novacode_cli/remote/rootapp_bot/package-lock.json +2683 -0
  421. novacode_cli/remote/rootapp_bot/package.json +18 -0
  422. novacode_cli/remote/rootapp_bot/transport.cjs +80 -0
  423. novacode_cli/remote/rootapp_bridge.py +370 -0
  424. novacode_cli/remote/rootapp_setup.py +89 -0
  425. novacode_cli/remote/routing.py +103 -0
  426. novacode_cli/remote/scheduler.py +302 -0
  427. novacode_cli/remote/session.py +164 -0
  428. novacode_cli/remote/status.py +411 -0
  429. novacode_cli/remote/streaming.py +188 -0
  430. novacode_cli/remote/telegram_bridge.py +1118 -0
  431. novacode_cli/remote/telegram_format.py +215 -0
  432. novacode_cli/remote/telegram_hub.py +256 -0
  433. novacode_cli/remote/voice_notes.py +120 -0
  434. novacode_cli/remote/webhook_adapters.py +167 -0
  435. novacode_cli/remote/webhook_server.py +154 -0
  436. novacode_cli/rewind.py +150 -0
  437. novacode_cli/rooms/__init__.py +1 -0
  438. novacode_cli/rooms/bridge.py +86 -0
  439. novacode_cli/rooms/cli.py +231 -0
  440. novacode_cli/rooms/nova.py +227 -0
  441. novacode_cli/rooms/runtime.py +299 -0
  442. novacode_cli/rooms/store.py +538 -0
  443. novacode_cli/rooms/workspace.py +94 -0
  444. novacode_cli/security/__init__.py +29 -0
  445. novacode_cli/security/approval_context.py +45 -0
  446. novacode_cli/security/delegated_approval.py +68 -0
  447. novacode_cli/security/local_http.py +85 -0
  448. novacode_cli/security/middleware.py +87 -0
  449. novacode_cli/security/paths.py +35 -0
  450. novacode_cli/security/policy.py +535 -0
  451. novacode_cli/security/policy_writer.py +90 -0
  452. novacode_cli/security/prompt_injection.py +203 -0
  453. novacode_cli/security/remember.py +81 -0
  454. novacode_cli/security/rule_synthesis.py +116 -0
  455. novacode_cli/security/secret_files.py +61 -0
  456. novacode_cli/security/session_allow.py +114 -0
  457. novacode_cli/security/unicode_security.py +516 -0
  458. novacode_cli/security/validator.py +173 -0
  459. novacode_cli/server/__init__.py +9 -0
  460. novacode_cli/server/app.py +632 -0
  461. novacode_cli/server/event_adapter.py +189 -0
  462. novacode_cli/server/session_manager.py +90 -0
  463. novacode_cli/server_main.py +64 -0
  464. novacode_cli/server_runner/dev_server.py +530 -0
  465. novacode_cli/server_runner/test_runner.py +470 -0
  466. novacode_cli/session/__init__.py +1 -0
  467. novacode_cli/session/adapters/__init__.py +240 -0
  468. novacode_cli/session/adapters/claude_code.py +102 -0
  469. novacode_cli/session/adapters/codex.py +77 -0
  470. novacode_cli/session/adapters/harness_native.py +75 -0
  471. novacode_cli/session/checkpoint_coordinator.py +448 -0
  472. novacode_cli/session/context_restore.py +25 -0
  473. novacode_cli/session/history_export.py +228 -0
  474. novacode_cli/session/history_tree.py +174 -0
  475. novacode_cli/session/imported_context.py +267 -0
  476. novacode_cli/session/runtime_identity.py +32 -0
  477. novacode_cli/session/session_persistence.py +1168 -0
  478. novacode_cli/session/session_prompt_builder.py +279 -0
  479. novacode_cli/session/session_restore.py +351 -0
  480. novacode_cli/session/session_summarization.py +20 -0
  481. novacode_cli/session/transcript_journal.py +153 -0
  482. novacode_cli/sessions/__init__.py +11 -0
  483. novacode_cli/sessions/gateway.py +84 -0
  484. novacode_cli/sessions/launch.py +51 -0
  485. novacode_cli/sessions/lease.py +213 -0
  486. novacode_cli/sessions/messaging.py +255 -0
  487. novacode_cli/sessions/protocol.py +216 -0
  488. novacode_cli/sessions/resume.py +31 -0
  489. novacode_cli/sessions/supervisor.py +498 -0
  490. novacode_cli/sessions/tasks.py +73 -0
  491. novacode_cli/sessions/tui_messaging.py +413 -0
  492. novacode_cli/sessions/worker.py +652 -0
  493. novacode_cli/sessions/worktree.py +262 -0
  494. novacode_cli/shell/__init__.py +27 -0
  495. novacode_cli/shell/jobs.py +475 -0
  496. novacode_cli/shell/middleware.py +1568 -0
  497. novacode_cli/shell/os_sandbox.py +205 -0
  498. novacode_cli/shell/output.py +181 -0
  499. novacode_cli/shell/patterns.py +275 -0
  500. novacode_cli/shell/processes.py +87 -0
  501. novacode_cli/shell/utils.py +236 -0
  502. novacode_cli/skills/__init__.py +26 -0
  503. novacode_cli/skills/builtin/handoff/SKILL.md +15 -0
  504. novacode_cli/skills/curation_middleware.py +69 -0
  505. novacode_cli/skills/executable.py +161 -0
  506. novacode_cli/skills/libraries.py +102 -0
  507. novacode_cli/skills/load.py +248 -0
  508. novacode_cli/skills/prune.py +215 -0
  509. novacode_cli/skills/refreshing_middleware.py +896 -0
  510. novacode_cli/skills/retrieval.py +248 -0
  511. novacode_cli/skills/runtime.py +118 -0
  512. novacode_cli/skills/schema.py +254 -0
  513. novacode_cli/skills/skill_creation.py +1549 -0
  514. novacode_cli/skills/skill_lock.py +75 -0
  515. novacode_cli/skills/skill_system_prompt.py +16 -0
  516. novacode_cli/skills/skills_prefs.py +126 -0
  517. novacode_cli/skills/tool_resolver.py +31 -0
  518. novacode_cli/skills/upstream.py +50 -0
  519. novacode_cli/skills/versioning.py +291 -0
  520. novacode_cli/states/Session.py +847 -0
  521. novacode_cli/states/__init__.py +31 -0
  522. novacode_cli/states/slices/__init__.py +17 -0
  523. novacode_cli/states/slices/agent_runtime.py +249 -0
  524. novacode_cli/states/slices/background_tasks.py +21 -0
  525. novacode_cli/states/slices/notifications.py +74 -0
  526. novacode_cli/states/slices/remote_bridge.py +56 -0
  527. novacode_cli/states/slices/ui_settings.py +49 -0
  528. novacode_cli/states/slices/wiki.py +25 -0
  529. novacode_cli/teammates/__init__.py +1 -0
  530. novacode_cli/teammates/controller.py +557 -0
  531. novacode_cli/teammates/graph.py +104 -0
  532. novacode_cli/teammates/registry.py +175 -0
  533. novacode_cli/teammates/service.py +254 -0
  534. novacode_cli/teammates/worker.py +19 -0
  535. novacode_cli/teams/__init__.py +1 -0
  536. novacode_cli/teams/adapters/__init__.py +1 -0
  537. novacode_cli/teams/adapters/container.py +316 -0
  538. novacode_cli/teams/adapters/inprocess.py +206 -0
  539. novacode_cli/teams/adapters/process.py +364 -0
  540. novacode_cli/teams/bootstrap.py +246 -0
  541. novacode_cli/teams/container_git.py +67 -0
  542. novacode_cli/teams/context.py +34 -0
  543. novacode_cli/teams/coordinator.py +815 -0
  544. novacode_cli/teams/gateway.py +200 -0
  545. novacode_cli/teams/host.py +64 -0
  546. novacode_cli/teams/legacy.py +52 -0
  547. novacode_cli/teams/middleware.py +176 -0
  548. novacode_cli/teams/models.py +104 -0
  549. novacode_cli/teams/output.py +47 -0
  550. novacode_cli/teams/protocol.py +50 -0
  551. novacode_cli/teams/recovery.py +80 -0
  552. novacode_cli/teams/scheduler.py +44 -0
  553. novacode_cli/teams/store.py +631 -0
  554. novacode_cli/teams/worker.py +251 -0
  555. novacode_cli/teams/workspace.py +100 -0
  556. novacode_cli/token_utils.py +256 -0
  557. novacode_cli/tools/__init__.py +104 -0
  558. novacode_cli/tools/_shared.py +97 -0
  559. novacode_cli/tools/_types.py +24 -0
  560. novacode_cli/tools/artifact_tools.py +137 -0
  561. novacode_cli/tools/code_search_tools.py +330 -0
  562. novacode_cli/tools/computer_tools.py +77 -0
  563. novacode_cli/tools/cron_tools.py +65 -0
  564. novacode_cli/tools/daemon_tool.py +290 -0
  565. novacode_cli/tools/desktop_tools.py +161 -0
  566. novacode_cli/tools/fetch_tools.py +530 -0
  567. novacode_cli/tools/http_tools.py +279 -0
  568. novacode_cli/tools/inspection_tools.py +107 -0
  569. novacode_cli/tools/job_tools.py +143 -0
  570. novacode_cli/tools/knowledge_tools.py +427 -0
  571. novacode_cli/tools/memory_tools.py +461 -0
  572. novacode_cli/tools/memory_wiki_tools.py +40 -0
  573. novacode_cli/tools/notebook_tools.py +238 -0
  574. novacode_cli/tools/oracle_tool.py +83 -0
  575. novacode_cli/tools/plan_archive_tools.py +80 -0
  576. novacode_cli/tools/plan_mode_tools.py +315 -0
  577. novacode_cli/tools/python_kernel_loop.py +165 -0
  578. novacode_cli/tools/python_kernel_tool.py +222 -0
  579. novacode_cli/tools/reflection_tools.py +34 -0
  580. novacode_cli/tools/scraper_tools.py +377 -0
  581. novacode_cli/tools/skill_tools.py +275 -0
  582. novacode_cli/tools/speak_tool.py +51 -0
  583. novacode_cli/tools/store_memory_tools.py +227 -0
  584. novacode_cli/tools/ui_tools.py +62 -0
  585. novacode_cli/tools/waiter_tools.py +408 -0
  586. novacode_cli/tools/web_tools.py +349 -0
  587. novacode_cli/tools/wiki_tools.py +152 -0
  588. novacode_cli/tools/worktree_tools.py +219 -0
  589. novacode_cli/tracking/__init__.py +10 -0
  590. novacode_cli/tracking/file_tracker.py +826 -0
  591. novacode_cli/tracking/local_metrics.py +170 -0
  592. novacode_cli/tracking/loop_guard.py +507 -0
  593. novacode_cli/tracking/request_metrics.py +60 -0
  594. novacode_cli/tracking/tracing.py +692 -0
  595. novacode_cli/tracking/usage_tree.py +677 -0
  596. novacode_cli/tracking/workspace_anchoring.py +231 -0
  597. novacode_cli/tui/__init__.py +11 -0
  598. novacode_cli/tui/animation_rate.py +9 -0
  599. novacode_cli/tui/animations.py +332 -0
  600. novacode_cli/tui/app.py +19315 -0
  601. novacode_cli/tui/auth_display.py +87 -0
  602. novacode_cli/tui/auth_screens.py +826 -0
  603. novacode_cli/tui/avatar.py +294 -0
  604. novacode_cli/tui/avatar_frames.py +21 -0
  605. novacode_cli/tui/background_tasks.py +35 -0
  606. novacode_cli/tui/browser_settings_screen.py +70 -0
  607. novacode_cli/tui/caveman_screen.py +185 -0
  608. novacode_cli/tui/council_settings_screen.py +182 -0
  609. novacode_cli/tui/council_view.py +535 -0
  610. novacode_cli/tui/decision_settings.py +268 -0
  611. novacode_cli/tui/diff_preview.py +199 -0
  612. novacode_cli/tui/gc_tuning.py +63 -0
  613. novacode_cli/tui/handoff_screen.py +206 -0
  614. novacode_cli/tui/harness.py +244 -0
  615. novacode_cli/tui/history_tree_screen.py +179 -0
  616. novacode_cli/tui/home.py +328 -0
  617. novacode_cli/tui/home_scene.py +94 -0
  618. novacode_cli/tui/icons.py +81 -0
  619. novacode_cli/tui/interface_styles.tcss +327 -0
  620. novacode_cli/tui/matrix3.py +108 -0
  621. novacode_cli/tui/mcp_tools_screen.py +131 -0
  622. novacode_cli/tui/motion.py +178 -0
  623. novacode_cli/tui/output_body.py +136 -0
  624. novacode_cli/tui/output_buffer.py +59 -0
  625. novacode_cli/tui/palette.py +334 -0
  626. novacode_cli/tui/pickers.py +237 -0
  627. novacode_cli/tui/prime_panel.py +506 -0
  628. novacode_cli/tui/provider_signin.py +213 -0
  629. novacode_cli/tui/pty_shell.py +159 -0
  630. novacode_cli/tui/reference_screens.py +444 -0
  631. novacode_cli/tui/resume_picker.py +346 -0
  632. novacode_cli/tui/rooms.py +597 -0
  633. novacode_cli/tui/screens.py +7088 -0
  634. novacode_cli/tui/session_import.py +333 -0
  635. novacode_cli/tui/session_pane.py +242 -0
  636. novacode_cli/tui/session_tab.py +42 -0
  637. novacode_cli/tui/session_transcript.py +118 -0
  638. novacode_cli/tui/shell_output.py +7 -0
  639. novacode_cli/tui/stall_watch.py +174 -0
  640. novacode_cli/tui/statusline.py +40 -0
  641. novacode_cli/tui/statusline_screen.py +91 -0
  642. novacode_cli/tui/teammate_updates.py +162 -0
  643. novacode_cli/tui/teammates.py +548 -0
  644. novacode_cli/tui/terminal.py +289 -0
  645. novacode_cli/tui/terminal_view.py +235 -0
  646. novacode_cli/tui/themes.py +118 -0
  647. novacode_cli/tui/update_notice.py +84 -0
  648. novacode_cli/tui/voice_downloads.py +113 -0
  649. novacode_cli/tui/widgets.py +2038 -0
  650. novacode_cli/tui/windows_input.py +38 -0
  651. novacode_cli/tui/workspace_approval.py +165 -0
  652. novacode_cli/ui/council_web.py +113 -0
  653. novacode_cli/ui/council_workspace.py +72 -0
  654. novacode_cli/ui/cowork_web.py +41 -0
  655. novacode_cli/ui/diff_highlight.py +160 -0
  656. novacode_cli/ui/execution.py +1396 -0
  657. novacode_cli/ui/exit_summary.py +65 -0
  658. novacode_cli/ui/hitl_approval.py +196 -0
  659. novacode_cli/ui/input_preparation.py +2 -0
  660. novacode_cli/ui/interrupt_handlers.py +215 -0
  661. novacode_cli/ui/question_prompt.py +151 -0
  662. novacode_cli/ui/status_phrases.py +157 -0
  663. novacode_cli/ui/stream_preview.py +66 -0
  664. novacode_cli/ui/streaming.py +2 -0
  665. novacode_cli/ui/subagent_tracking.py +2 -0
  666. novacode_cli/ui/ui_elements.py +1585 -0
  667. novacode_cli/ui/web_workspace.py +244 -0
  668. novacode_cli/ui_events.py +299 -0
  669. novacode_cli/update_ui.py +243 -0
  670. novacode_cli/updates.py +489 -0
  671. novacode_cli/utils/backend_patches.py +399 -0
  672. novacode_cli/utils/backend_paths.py +467 -0
  673. novacode_cli/utils/lazy_providers.py +51 -0
  674. novacode_cli/utils/model_info.py +223 -0
  675. novacode_cli/utils/pdf_extraction.py +183 -0
  676. novacode_cli/utils/startup.py +29 -0
  677. novacode_cli/utils/tasks.py +42 -0
  678. novacode_cli/utils/windows.py +9 -0
  679. novacode_cli/vixie/hook_adapter.py +127 -0
  680. novacode_cli/vixie/server.py +375 -0
  681. novacode_cli/wiki/__init__.py +15 -0
  682. novacode_cli/wiki/ask.py +56 -0
  683. novacode_cli/wiki/file.py +71 -0
  684. novacode_cli/wiki/ingest.py +184 -0
  685. novacode_cli/wiki/manager.py +261 -0
  686. novacode_cli-1.2.0.dist-info/METADATA +271 -0
  687. novacode_cli-1.2.0.dist-info/RECORD +691 -0
  688. novacode_cli-1.2.0.dist-info/WHEEL +5 -0
  689. novacode_cli-1.2.0.dist-info/entry_points.txt +2 -0
  690. novacode_cli-1.2.0.dist-info/licenses/LICENSE +21 -0
  691. 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)