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
novacode_cli/prime.py ADDED
@@ -0,0 +1,759 @@
1
+ """Session-scoped Deep Work checkpoints and observed execution evidence."""
2
+
3
+ from __future__ import annotations
4
+
5
+ import json
6
+ import time
7
+ import uuid
8
+ from contextvars import ContextVar
9
+ from copy import deepcopy
10
+ from dataclasses import dataclass, field
11
+ from pathlib import Path
12
+ from threading import RLock
13
+ from typing import TYPE_CHECKING, Any, Literal
14
+
15
+ from novacode_cli.prime_memory import (
16
+ DEPENDENCIES,
17
+ PrimeMemory,
18
+ continuation_context,
19
+ fingerprints,
20
+ freshness,
21
+ input_paths,
22
+ project_context,
23
+ safe_text,
24
+ sanitized,
25
+ session_directory,
26
+ )
27
+
28
+ if TYPE_CHECKING:
29
+ from collections.abc import Mapping
30
+
31
+ Phase = Literal["define", "investigate", "implement", "verify", "challenge", "deliver"]
32
+ PHASES: tuple[Phase, ...] = ("define", "investigate", "implement", "verify", "challenge", "deliver")
33
+ EXECUTION_TOOLS = frozenset({"shell", "execute", "execute_code", "run_tests", "run_pytest", "bash"})
34
+ MAX_TOOLS = 128
35
+ MAX_REPORT = 100_000
36
+ MAX_CRITERIA = 12
37
+ MAX_EVIDENCE = 8
38
+ MAX_CHECKS = 32
39
+ MAX_CHECK_RESULTS = 64
40
+ MAX_EXIT_CODE = 255
41
+ MAX_FACTORY_REPORT = 2_000_000
42
+ Record = dict[str, Any]
43
+
44
+
45
+ def text(value: str, limit: int = 2000) -> str:
46
+ """Require bounded notes without silently shortening evidence."""
47
+ if not isinstance(value, str) or not value.strip() or len(value) > limit:
48
+ msg = f"Use non-empty text of at most {limit} characters"
49
+ raise ValueError(msg)
50
+ return value
51
+
52
+
53
+ @dataclass
54
+ class PrimeRun:
55
+ """One foreground request; checkpoints never confer tool permissions."""
56
+
57
+ session: Any
58
+ goal: str
59
+ report: Record = field(init=False)
60
+ lock: Any = field(default_factory=RLock, repr=False)
61
+ memory: Any = field(init=False, default=None, repr=False)
62
+ observations: Record = field(default_factory=dict, repr=False)
63
+ starts: Record = field(default_factory=dict, repr=False)
64
+ sequence: int = 0
65
+
66
+ def __post_init__(self) -> None:
67
+ """Start a new record, leaving the original user message untouched."""
68
+ context = project_context(session_directory(self.session))
69
+ pending = getattr(self.session, "prime_pending", None)
70
+ previous = getattr(self.session, "prime_report", None)
71
+ if (
72
+ pending is None
73
+ and isinstance(previous, dict)
74
+ and previous.get("status")
75
+ in {
76
+ "paused",
77
+ "error",
78
+ "incomplete",
79
+ }
80
+ ):
81
+ pending = continuation_context(previous)
82
+ self.session.prime_pending = None
83
+ source_goal = pending.get("goal") if isinstance(pending, dict) else None
84
+ objective = (
85
+ source_goal if isinstance(source_goal, str) and source_goal.strip() else self.goal
86
+ )
87
+ self.report = {
88
+ **context,
89
+ "version": 1,
90
+ "id": uuid.uuid4().hex,
91
+ "thread": self.session.thread_id,
92
+ "goal": objective[:4000],
93
+ "request": self.goal[:4000],
94
+ "phase": "define",
95
+ "status": "running",
96
+ "criteria": [],
97
+ "checkpoints": [],
98
+ "tools": [],
99
+ "checks": [],
100
+ "evidence": [],
101
+ "files": [],
102
+ "dependencies": [],
103
+ "fingerprints": {},
104
+ "findings": [],
105
+ "questions": [],
106
+ "next_action": "Define completion criteria",
107
+ "recalled": [],
108
+ "parent_id": pending.get("id") if isinstance(pending, dict) else None,
109
+ "continuation": pending if isinstance(pending, dict) else None,
110
+ }
111
+ self.session.prime_report = deepcopy(self.report)
112
+ try:
113
+ self.memory = PrimeMemory(context)
114
+ except Exception: # noqa: BLE001 - Storage must not break authorized foreground work.
115
+ self.report["storage_error"] = (
116
+ "Prime storage unavailable; drafts may not survive restart"
117
+ )
118
+ self.publish()
119
+ if isinstance(pending, dict) and pending.get("files"):
120
+ try:
121
+ self.declare_inputs(pending["files"], pending.get("dependencies"))
122
+ except (ValueError, OSError):
123
+ self.report["continuation_warning"] = (
124
+ "Saved inputs unavailable; declare current workspace inputs"
125
+ )
126
+ self.publish()
127
+
128
+ def is_current(self) -> bool:
129
+ """Fence late results from cleared or superseded requests."""
130
+ saved = getattr(self.session, "prime_report", None)
131
+ return (
132
+ self.session.thread_id == self.report["thread"]
133
+ and isinstance(saved, dict)
134
+ and saved.get("id") == self.report["id"]
135
+ )
136
+
137
+ def publish(self) -> None:
138
+ """Replace the snapshot so UI/autosave readers never share mutable lists."""
139
+ if self.is_current():
140
+ snapshot = deepcopy(self.report)
141
+ # Full definitions and excerpts have their own records. Task/session
142
+ # snapshots retain IDs and results without multiplying captured output.
143
+ snapshot["checks"] = [
144
+ {
145
+ key: check[key]
146
+ for key in ("id", "purpose", "status", "finding", "criteria", "evidence_ids")
147
+ }
148
+ for check in self.report["checks"]
149
+ ]
150
+ snapshot["evidence"] = [
151
+ {
152
+ key: evidence[key]
153
+ for key in (
154
+ "id",
155
+ "run_id",
156
+ "check_id",
157
+ "tool_call_id",
158
+ "status",
159
+ "reason",
160
+ "finding",
161
+ "exit_code",
162
+ "observed_at",
163
+ )
164
+ }
165
+ for evidence in self.report["evidence"]
166
+ ]
167
+ self.session.prime_report = sanitized(snapshot)
168
+ self.persist("tasks", snapshot)
169
+
170
+ def persist(self, kind: str, record: Record) -> None:
171
+ """Storage failures degrade to visible local drafts without another provider request."""
172
+ if self.memory is not None:
173
+ try:
174
+ self.memory.save(kind, record)
175
+ except Exception: # noqa: BLE001 - Best-effort durable memory boundary.
176
+ self.report["storage_error"] = (
177
+ "Prime storage unavailable; drafts may not survive restart"
178
+ )
179
+ else:
180
+ return
181
+ self.report["storage_error"] = "Prime storage unavailable; drafts may not survive restart"
182
+ if self.is_current():
183
+ self.session.prime_report["storage_error"] = self.report["storage_error"]
184
+
185
+ def declare_inputs(self, files: list[str], dependencies: list[str] | None = None) -> None:
186
+ """Recall checks only after the agent has declared relevant file/dependency inputs."""
187
+ with self.lock:
188
+ root = self.report["root"]
189
+ declared = input_paths(root, files)
190
+ deps = input_paths(root, dependencies or self.report["dependencies"])
191
+ deps = sorted(set(deps) | {name for name in DEPENDENCIES if Path(root, name).is_file()})
192
+ self.report["files"] = declared
193
+ self.report["dependencies"] = deps
194
+ self.report["fingerprints"] = fingerprints(root, declared + deps)
195
+ if self.memory is not None:
196
+ try:
197
+ self.report["recalled"] = self.memory.recall(
198
+ declared,
199
+ deps,
200
+ exclude_run_id=self.report["id"],
201
+ )
202
+ except Exception: # noqa: BLE001 - Recall failure is context loss, not tool failure.
203
+ self.report["storage_error"] = "Prime recall unavailable"
204
+ self.publish()
205
+
206
+ def recall_context(self) -> str:
207
+ """Keep automatic recalled context within five summaries and 2,000 characters."""
208
+ return "\n".join(item["summary"] for item in self.report["recalled"][:5])[:2000]
209
+
210
+ def progress(self) -> Record:
211
+ """Expose immutable status and IDs without copying raw commands into event consumers."""
212
+ with self.lock:
213
+ checks = [
214
+ {key: check[key] for key in ("id", "status", "finding")}
215
+ for check in self.report["checks"]
216
+ ]
217
+ return {
218
+ "phase": self.report["phase"],
219
+ "status": self.report["status"],
220
+ "checks": checks,
221
+ "recalled_count": len(self.report["recalled"]),
222
+ "storage_error": self.report.get("storage_error"),
223
+ }
224
+
225
+ def define_check(
226
+ self,
227
+ *,
228
+ purpose: str,
229
+ command: str,
230
+ files: list[str],
231
+ criteria: list[int],
232
+ expected_exit: int = 0,
233
+ contains: list[str] | None = None,
234
+ dependencies: list[str] | None = None,
235
+ ) -> Record:
236
+ """Define immutable acceptance assertions before executing a command."""
237
+ text(purpose, 500)
238
+ text(command)
239
+ if not criteria or any(
240
+ type(i) is not int or not 0 <= i < len(self.report["criteria"]) for i in criteria
241
+ ):
242
+ msg = "Reference defined completion criteria by zero-based index"
243
+ raise ValueError(msg)
244
+ if type(expected_exit) is not int or abs(expected_exit) > MAX_EXIT_CODE:
245
+ msg = "Expected exit code must be an integer between -255 and 255"
246
+ raise ValueError(msg)
247
+ assertions = [text(item, 300) for item in (contains or [])]
248
+ if len(assertions) > MAX_EVIDENCE:
249
+ msg = "Use at most eight assertions and 32 checks per run"
250
+ raise ValueError(msg)
251
+ with self.lock:
252
+ if len(self.report["checks"]) >= MAX_CHECKS:
253
+ msg = "Use at most eight assertions and 32 checks per run"
254
+ raise ValueError(msg)
255
+ self.declare_inputs(sorted(set(self.report["files"] + files)), dependencies)
256
+ self.sequence += 1
257
+ check = {
258
+ "id": uuid.uuid4().hex,
259
+ "run_id": self.report["id"],
260
+ "version": 1,
261
+ "purpose": purpose,
262
+ "command": command,
263
+ "cwd": self.report["cwd"],
264
+ "criteria": criteria,
265
+ "expected_exit": expected_exit,
266
+ "contains": assertions,
267
+ "files": input_paths(self.report["root"], files),
268
+ "dependencies": self.report["dependencies"],
269
+ "defined_at": self.sequence,
270
+ "finding": "draft",
271
+ "status": "unverified",
272
+ "fingerprints": {},
273
+ "revision": self.report["revision"],
274
+ "evidence_ids": [],
275
+ }
276
+ self.report["checks"].append(check)
277
+ self.persist("checks", check)
278
+ self.publish()
279
+ return deepcopy(check)
280
+
281
+ def start_tool(self, call_id: str) -> None:
282
+ """Capture declared inputs before execution, including parallel tool calls."""
283
+ with self.lock:
284
+ self.sequence += 1
285
+ self.starts[call_id] = {
286
+ "sequence": self.sequence,
287
+ "fingerprints": fingerprints(
288
+ self.report["root"],
289
+ self.report["files"] + self.report["dependencies"],
290
+ ),
291
+ }
292
+
293
+ def owns(self, config: Mapping[str, Any]) -> bool:
294
+ """Reject inherited child/subgraph bindings and different conversation threads."""
295
+ values = config.get("configurable", {})
296
+ return (
297
+ self.is_current()
298
+ and values.get("thread_id") == self.report["thread"]
299
+ and "|" not in str(values.get("checkpoint_ns", ""))
300
+ )
301
+
302
+ def observe(
303
+ self,
304
+ call_id: str,
305
+ name: str,
306
+ status: str,
307
+ *,
308
+ execution: Record | None = None,
309
+ ) -> None:
310
+ """Record a tool's actual returned status, not a model's assertion of success."""
311
+ with self.lock:
312
+ if call_id not in self.starts:
313
+ self.start_tool(call_id)
314
+ if call_id in self.observations:
315
+ return
316
+ self.observations[call_id] = {
317
+ **self.starts.pop(call_id),
318
+ "execution": deepcopy(execution),
319
+ "name": name,
320
+ "observed_at": time.time_ns(),
321
+ }
322
+ while len(self.observations) > MAX_TOOLS:
323
+ del self.observations[next(iter(self.observations))]
324
+ self.report["tools"].append(
325
+ {"id": call_id, "name": name, "status": status, "phase": self.report["phase"]}
326
+ )
327
+ del self.report["tools"][:-MAX_TOOLS]
328
+ self.publish()
329
+
330
+ def record_check(self, check_id: str, tool_call_id: str) -> Record:
331
+ """Bind assertions to trusted structured results, never to model-authored summaries."""
332
+ with self.lock:
333
+ check = next((c for c in self.report["checks"] if c["id"] == check_id), None)
334
+ observation = self.observations.get(tool_call_id)
335
+ if check is None or observation is None:
336
+ msg = "Use a check and observed tool-call ID from this run"
337
+ raise ValueError(msg)
338
+ if observation["sequence"] <= check["defined_at"]:
339
+ msg = "Define the check before starting execution"
340
+ raise ValueError(msg)
341
+ execution = observation["execution"]
342
+ if isinstance(execution, dict) and (
343
+ execution.get("command") != check["command"]
344
+ or (execution.get("cwd") is not None and execution.get("cwd") != check["cwd"])
345
+ ):
346
+ msg = "Observed command and working directory must match the definition"
347
+ raise ValueError(msg)
348
+ status, reason = "unverified", "Structured completed execution metadata unavailable"
349
+ inputs = {
350
+ name: observation["fingerprints"].get(name)
351
+ for name in check["files"] + check["dependencies"]
352
+ }
353
+ if isinstance(execution, dict) and (
354
+ type(execution.get("exit_code")) is int
355
+ and execution.get("completed") is True
356
+ and execution.get("truncated") is False
357
+ and isinstance(execution.get("output"), str)
358
+ and execution.get("cwd") == check["cwd"]
359
+ and observation["name"] in EXECUTION_TOOLS
360
+ ):
361
+ if not inputs or any(value is None for value in inputs.values()):
362
+ reason = "Declared inputs unavailable"
363
+ elif freshness(self.report["root"], inputs) != "current":
364
+ reason = "Inputs changed during or after execution; rerun the check"
365
+ else:
366
+ passed = execution["exit_code"] == check["expected_exit"] and all(
367
+ literal in execution["output"] for literal in check["contains"]
368
+ )
369
+ status = "passed" if passed else "failed"
370
+ reason = (
371
+ "Assertions satisfied"
372
+ if passed
373
+ else "Exit code or literal assertion failed"
374
+ )
375
+ signature = (
376
+ check["command"],
377
+ check["files"],
378
+ check["dependencies"],
379
+ check["expected_exit"],
380
+ check["contains"],
381
+ )
382
+ candidates = list(self.report["evidence"])
383
+ if self.memory is not None:
384
+ try:
385
+ candidates += self.memory.records("evidence")
386
+ except Exception: # noqa: BLE001 - Promotion fails closed when history is unavailable.
387
+ self.report["storage_error"] = "Prime evidence history unavailable"
388
+ demonstrated = status == "passed" and any(
389
+ e.get("signature") == list(signature)
390
+ and e.get("status") == "failed"
391
+ and e.get("observed_at", observation["observed_at"]) < observation["observed_at"]
392
+ and any(
393
+ e.get("fingerprints", {}).get(name) != inputs.get(name)
394
+ for name in check["files"]
395
+ )
396
+ for e in candidates
397
+ )
398
+ evidence = {
399
+ "id": uuid.uuid4().hex,
400
+ "run_id": self.report["id"],
401
+ "check_id": check_id,
402
+ "tool_call_id": tool_call_id,
403
+ "status": status,
404
+ "reason": reason,
405
+ "finding": "demonstrated" if demonstrated else "draft",
406
+ "fingerprints": inputs,
407
+ "signature": list(signature),
408
+ "observed_at": observation["observed_at"],
409
+ "cwd": self.report["cwd"],
410
+ "revision": self.report["revision"],
411
+ "exit_code": execution.get("exit_code") if isinstance(execution, dict) else None,
412
+ "excerpt": safe_text(execution.get("output", ""))
413
+ if isinstance(execution, dict)
414
+ else "",
415
+ }
416
+ if len(self.report["evidence"]) >= MAX_CHECK_RESULTS:
417
+ msg = "Use at most 64 evidence records per run"
418
+ raise ValueError(msg)
419
+ self.report["evidence"].append(evidence)
420
+ check.update({key: evidence[key] for key in ("status", "finding", "fingerprints")})
421
+ check["evidence_ids"].append(evidence["id"])
422
+ self.persist("evidence", evidence)
423
+ self.persist("checks", check)
424
+ self.publish()
425
+ return deepcopy(evidence)
426
+
427
+ def refresh_checks(self) -> None:
428
+ """Invalidate stale passes after subsequent edits or missing environments."""
429
+ for check in self.report["checks"]:
430
+ state = freshness(self.report["root"], check.get("fingerprints", {}))
431
+ if check["status"] == "passed" and state != "current":
432
+ check["status"] = "unverified"
433
+ check["freshness"] = state
434
+ self.persist("checks", check)
435
+
436
+ def checkpoint( # noqa: PLR0912 - Validate phase invariants before committing one checkpoint.
437
+ self,
438
+ phase: Phase,
439
+ summary: str,
440
+ criteria: list[str] | None = None,
441
+ evidence: list[str] | None = None,
442
+ unverified_reason: str | None = None,
443
+ files: list[str] | None = None,
444
+ dependencies: list[str] | None = None,
445
+ questions: list[str] | None = None,
446
+ next_action: str | None = None,
447
+ ) -> Record:
448
+ """Advance in order; evidence references must resolve to this run's real results."""
449
+ text(summary)
450
+ if questions is not None:
451
+ if len(questions) > MAX_CRITERIA:
452
+ msg = "Use at most twelve unresolved questions"
453
+ raise ValueError(msg)
454
+ questions = [text(q, 300) for q in questions]
455
+ if next_action is not None:
456
+ text(next_action, 500)
457
+ if files is not None:
458
+ input_paths(self.report["root"], files)
459
+ input_paths(self.report["root"], dependencies or [])
460
+ with self.lock:
461
+ records = self.report["checkpoints"]
462
+ if len(records) >= len(PHASES) or phase != PHASES[len(records)]:
463
+ msg = "Record the current Prime phase in order; completed phases are immutable"
464
+ raise ValueError(msg)
465
+ if phase == "define":
466
+ if not criteria or len(criteria) > MAX_CRITERIA:
467
+ msg = "Define 1-12 concrete completion criteria before investigating"
468
+ raise ValueError(msg)
469
+ criteria = [text(item, 300) for item in criteria]
470
+ elif criteria:
471
+ msg = "Completion criteria are set during Define; new scope needs an owner decision"
472
+ raise ValueError(msg)
473
+ evidence = list(dict.fromkeys(evidence or []))
474
+ tools = {item["id"]: item for item in self.report["tools"]}
475
+ if len(evidence) > MAX_EVIDENCE or any(key not in tools for key in evidence):
476
+ msg = (
477
+ "Evidence must reference at most eight observed tool-call IDs from this request"
478
+ )
479
+ raise ValueError(msg)
480
+ if unverified_reason is not None:
481
+ text(unverified_reason)
482
+ if (
483
+ phase == "verify"
484
+ and not unverified_reason
485
+ and not any(
486
+ tools[key]["name"] in EXECUTION_TOOLS and tools[key]["status"] == "success"
487
+ for key in evidence
488
+ )
489
+ ):
490
+ msg = "Cite observed execution evidence or explain what could not be verified"
491
+ raise ValueError(msg)
492
+ record = {
493
+ "phase": phase,
494
+ "summary": summary,
495
+ "evidence": evidence,
496
+ "unverified_reason": unverified_reason,
497
+ }
498
+ records.append(record)
499
+ self.refresh_checks()
500
+ self.report["findings"] = [r["summary"] for r in records]
501
+ if questions is not None:
502
+ self.report["questions"] = questions
503
+ self.report["next_action"] = (
504
+ text(next_action, 500)
505
+ if next_action
506
+ else (PHASES[min(len(records), len(PHASES) - 1)])
507
+ )
508
+ if files is not None:
509
+ self.declare_inputs(files, dependencies)
510
+ self.report["fingerprints"] = fingerprints(
511
+ self.report["root"],
512
+ self.report["files"] + self.report["dependencies"],
513
+ )
514
+ self.report["revision"] = project_context(self.report["cwd"])["revision"]
515
+ if phase == "define":
516
+ self.report["criteria"] = criteria
517
+ self.report["phase"] = PHASES[min(len(records), len(PHASES) - 1)]
518
+ self.publish()
519
+ return deepcopy(record)
520
+
521
+ def finish(self, outcome: str) -> None:
522
+ """Cancellation/restart pauses work; missing milestones cannot become a success claim."""
523
+ with self.lock:
524
+ self.refresh_checks()
525
+ self.report["fingerprints"] = fingerprints(
526
+ self.report["root"],
527
+ self.report["files"] + self.report["dependencies"],
528
+ )
529
+ self.report["revision"] = project_context(self.report["cwd"])["revision"]
530
+ records = self.report["checkpoints"]
531
+ if outcome != "complete":
532
+ status = "error" if outcome == "error" else "paused"
533
+ elif len(records) != len(PHASES):
534
+ status = "incomplete"
535
+ else:
536
+ status = (
537
+ "delivered_with_limits"
538
+ if any(r["unverified_reason"] for r in records)
539
+ or any(c["status"] != "passed" for c in self.report["checks"])
540
+ or (
541
+ set(range(len(self.report["criteria"])))
542
+ - {
543
+ i
544
+ for c in self.report["checks"]
545
+ if c["status"] == "passed"
546
+ for i in c["criteria"]
547
+ }
548
+ )
549
+ else "delivered"
550
+ )
551
+ self.report["status"] = status
552
+ self.publish()
553
+
554
+
555
+ current_run: ContextVar[PrimeRun | None] = ContextVar("nova_prime_run", default=None)
556
+
557
+
558
+ def receipt(report: Record) -> str:
559
+ """Separate checkpoint assessments from observed facts in a compact delivery record."""
560
+ if report.get("version") == 2 and report.get("factory") is True: # noqa: PLR2004
561
+ from novacode_cli.commands.prime_handler import factory_receipt
562
+
563
+ return factory_receipt(report)
564
+ records = report.get("checkpoints", [])
565
+ lines = [
566
+ f"Prime Deep Work · {report.get('status', 'incomplete').replace('_', ' ')}",
567
+ f"Checkpoints: {len(records)}/{len(PHASES)}",
568
+ ]
569
+ if report.get("criteria"):
570
+ lines.append("Completion criteria: " + "; ".join(report["criteria"]))
571
+ covered = {
572
+ i
573
+ for c in report.get("checks", [])
574
+ if c.get("status") == "passed"
575
+ and freshness(
576
+ report.get("root", "."), c.get("fingerprints", report.get("fingerprints", {}))
577
+ )
578
+ == "current"
579
+ for i in c.get("criteria", [])
580
+ }
581
+ unmet = [criterion for i, criterion in enumerate(report["criteria"]) if i not in covered]
582
+ if unmet:
583
+ lines.append("Unverified criteria: " + "; ".join(unmet))
584
+ lines.extend(
585
+ f"Check {check['id']}: {check['status']} · {check['purpose']} · {check['finding']} · "
586
+ + freshness(
587
+ report.get("root", "."),
588
+ check.get("fingerprints", report.get("fingerprints", {})),
589
+ )
590
+ for check in report.get("checks", [])
591
+ )
592
+ lines.extend(
593
+ f"{evidence['status'].title()}: {evidence['reason']}"
594
+ for evidence in report.get("evidence", [])
595
+ if evidence["status"] != "passed"
596
+ )
597
+ if report.get("storage_error"):
598
+ lines.append(report["storage_error"])
599
+ for record in records:
600
+ if record["phase"] in {"verify", "challenge", "deliver"}:
601
+ lines.append(f"{record['phase'].title()} (agent assessment): {record['summary']}")
602
+ if record.get("unverified_reason"):
603
+ lines.append("Not verified: " + record["unverified_reason"])
604
+ lines.append(
605
+ f"Observed tool results: {len(report.get('tools', []))}. "
606
+ "A tool returning successfully does not by itself prove tests passed."
607
+ )
608
+ if len(records) < len(PHASES):
609
+ lines.append("Missing checkpoints: " + ", ".join(PHASES[len(records) :]))
610
+ return safe_text("\n".join(lines), MAX_REPORT)
611
+
612
+
613
+ def prime_payload(session: Any) -> Record | None: # noqa: ANN401 - Real and minimal session proxies.
614
+ """Save a mode and its thread-bound checkpoint snapshot with normal session metadata."""
615
+ report = getattr(session, "prime_report", None)
616
+ if not isinstance(report, dict) or report.get("thread") != getattr(session, "thread_id", None):
617
+ report = None
618
+ enabled = getattr(session, "prime_enabled", False) is True
619
+ pending = getattr(session, "prime_pending", None)
620
+ return (
621
+ {"enabled": enabled, "report": deepcopy(report), "pending": deepcopy(pending)}
622
+ if enabled or report
623
+ else None
624
+ )
625
+
626
+
627
+ def _valid_saved_records(report: Record) -> bool:
628
+ """Validate new optional collections while keeping the original session schema readable."""
629
+ if any(not isinstance(report.get(key, ""), str) for key in ("goal", "root", "cwd")):
630
+ return False
631
+ inputs = report.get("fingerprints", {})
632
+ if not isinstance(inputs, dict) or any(
633
+ not isinstance(key, str) or (value is not None and not isinstance(value, str))
634
+ for key, value in inputs.items()
635
+ ):
636
+ return False
637
+ fields = (
638
+ ("checks", MAX_CHECKS, ("id", "purpose", "status", "finding")),
639
+ (
640
+ "evidence",
641
+ MAX_CHECK_RESULTS,
642
+ ("id", "run_id", "check_id", "tool_call_id", "status", "reason", "finding"),
643
+ ),
644
+ ("recalled", 5, ("id", "summary")),
645
+ )
646
+ for name, limit, required in fields:
647
+ records = report.get(name, [])
648
+ if not isinstance(records, list) or len(records) > limit:
649
+ return False
650
+ if any(
651
+ not isinstance(item, dict)
652
+ or any(not isinstance(item.get(key), str) for key in required)
653
+ for item in records
654
+ ):
655
+ return False
656
+ if name in {"checks", "evidence"} and any(
657
+ item["status"] not in {"passed", "failed", "unverified"}
658
+ or item["finding"] not in {"draft", "demonstrated"}
659
+ for item in records
660
+ ):
661
+ return False
662
+ return all(
663
+ isinstance(c.get("criteria"), list)
664
+ and all(type(i) is int and 0 <= i < MAX_CRITERIA for i in c["criteria"])
665
+ for c in report.get("checks", [])
666
+ )
667
+
668
+
669
+ def restore_prime( # noqa: PLR0911 - Versioned session deserialization fails closed.
670
+ session: Any, # noqa: ANN401 - Session proxy boundary.
671
+ saved: object,
672
+ ) -> None:
673
+ """Old sessions default off; interrupted records stay paused with no automatic replay."""
674
+ session.prime_enabled = False
675
+ session.prime_report = None
676
+ session.prime_pending = None
677
+ session.prime_factory_resume = None
678
+ if not isinstance(saved, dict):
679
+ return
680
+ session.prime_enabled = saved.get("enabled") is True
681
+ report = saved.get("report")
682
+ if not isinstance(report, dict) or report.get("thread") != session.thread_id:
683
+ return
684
+ try:
685
+ encoded = json.dumps(report, ensure_ascii=False, allow_nan=False)
686
+ except (ValueError, TypeError):
687
+ return
688
+ if report.get("version") == 2 and report.get("factory") is True: # noqa: PLR2004
689
+ if (
690
+ len(encoded) > MAX_FACTORY_REPORT
691
+ or any(
692
+ not isinstance(report.get(key), str) for key in ("id", "goal", "stage", "status")
693
+ )
694
+ or any(not isinstance(report.get(key), list) for key in ("tasks", "sources", "checks"))
695
+ or any(
696
+ not isinstance(item, dict)
697
+ for key in ("tasks", "sources", "checks")
698
+ for item in report[key]
699
+ )
700
+ or not isinstance(report.get("budget"), dict)
701
+ or not isinstance(report.get("usage"), dict)
702
+ ):
703
+ return
704
+ status = report["status"] if report["status"] in {"published", "cancelled"} else "paused"
705
+ session.prime_report = {**deepcopy(report), "status": status, "approvals": {}}
706
+ return
707
+ if (
708
+ len(encoded) > MAX_REPORT
709
+ or not _valid_saved_records(report)
710
+ or not isinstance(report.get("status"), str)
711
+ or report.get("status")
712
+ not in {"running", "paused", "error", "incomplete", "delivered", "delivered_with_limits"}
713
+ or report.get("phase") not in PHASES
714
+ or not isinstance(report.get("checkpoints"), list)
715
+ or len(report["checkpoints"]) > len(PHASES)
716
+ or not isinstance(report.get("criteria"), list)
717
+ or len(report["criteria"]) > MAX_CRITERIA
718
+ or any(not isinstance(item, str) for item in report["criteria"])
719
+ or not isinstance(report.get("tools"), list)
720
+ or len(report["tools"]) > MAX_TOOLS
721
+ or any(
722
+ not isinstance(t, dict)
723
+ or not isinstance(t.get("id"), str)
724
+ or not isinstance(t.get("name"), str)
725
+ or not isinstance(t.get("status"), str)
726
+ or t.get("status") not in {"success", "error", "unknown"}
727
+ for t in report["tools"]
728
+ )
729
+ or any(
730
+ not isinstance(r, dict)
731
+ or r.get("phase") not in PHASES
732
+ or not isinstance(r.get("summary"), str)
733
+ or not isinstance(r.get("evidence"), list)
734
+ or any(not isinstance(key, str) for key in r["evidence"])
735
+ or (
736
+ r.get("unverified_reason") is not None
737
+ and not isinstance(r["unverified_reason"], str)
738
+ )
739
+ for r in report["checkpoints"]
740
+ )
741
+ or [r["phase"] for r in report["checkpoints"]] != list(PHASES[: len(report["checkpoints"])])
742
+ ):
743
+ return
744
+ records = report["checkpoints"]
745
+ if (
746
+ report["phase"] != PHASES[min(len(records), len(PHASES) - 1)]
747
+ or (records and not report["criteria"])
748
+ or (
749
+ report["status"] in {"delivered", "delivered_with_limits"}
750
+ and len(records) != len(PHASES)
751
+ )
752
+ ):
753
+ return
754
+ session.prime_report = deepcopy(report)
755
+ pending = saved.get("pending")
756
+ if isinstance(pending, dict) and pending.get("id") == report.get("id"):
757
+ session.prime_pending = deepcopy(pending)
758
+ if report.get("status") == "running":
759
+ session.prime_report["status"] = "paused"